case-matcher

name	case-matcher
description	基于特征包在案例库中做相似案例匹配。当用户描述现象（频段 + 场景 + 平台 + 幅度）且诊断流程尚未完成时触发，用于快速通道。

case-matcher · 案例匹配

何时使用

• diagnose-desense 工作流阶段二（模式匹配）
• 用户主动检索历史案例
• 整改方案设计阶段寻找同类案例参考

用法

# 伪代码
from tools.case_matcher import search
hits = search(feature_pack, top_k=5)
for h in hits:
    print(h.case_id, h.similarity, h.summary)

匹配逻辑

1. 关键字段粗筛：频段、平台系列、场景、超标量 ±3 dB 窗
2. 向量语义精排：对"现象描述"字段做 embedding + cosine 相似度
3. 返回 top-K + 置信度

当前状态

• Sprint 0：stub
• Sprint 1：粗筛可用（tools/case_keeper.py search --band --scenario）
• Sprint 2（已完成）：轻量向量检索（tools/case_vector_index.py，TF-IDF + 字符 bigram，无外部依赖）

调用方式

# 混合检索（向量 + 粗筛）
python3 tools/case_vector_index.py search "后摄 WiFi 2.4G 恶化" --band W24 --top-k 3

# 纯粗筛（无查询文本时）
python3 tools/case_keeper.py search --band W24 --scenario rc --degradation 5

索引维护

案例新增 / 修改后必须重建索引：

python3 tools/case_vector_index.py build

Hook on-knowledge-change.sh 在 knowledge/cases/ 变更时自动触发（Sprint 2 起）。