case-matcher

# case-matcher · 案例匹配 ## 何时使用 - `diagnose-desense` 工作流阶段二（模式匹配） - 用户主动检索历史案例 - 整改方案设计阶段寻找同类案例参考 ## 用法 ```python # 伪代码 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，无外部依赖） ## 调用方式 ```bash # 混合检索（向量 + 粗筛） 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 ``` ## 索引维护 案例新增 / 修改后必须重建索引： ```bash python3 tools/case_vector_index.py build ``` Hook `on-knowledge-change.sh` 在 `knowledge/cases/` 变更时自动触发（Sprint 2 起）。