Query Rewrite — RAG 检索预处理层

目的： 在多轮对话场景中，将模糊、代词指代或包含多重意图的查询改写为结构化的搜索关键词，以提升 RAG 的召回率。

核心能力：

• ✅ 快速检测：判断查询是否需要改写
• ✅ 6 种改写模式：自动识别并执行
• ✅ 双路径搜索：原始查询 + 改写后查询同时检索
• ✅ 去重与结果合并

🧠 改写检查清单

在调用任何检索工具（memory_search、wiki_search）或向量搜索前，请根据以下清单逐项检查当前查询：

📋 6 种改写模式

完整模板与示例请参见：references/rewrite-patterns.md

多模式优先级

当一个查询触发多个模式时，按以下顺序执行：

反问句(5) → 代词消解(3) → 多意图分解(4) → 上下文提取(1) → 比较歧义消除(2) → 条件提取(6)

🔄 执行流程

用户查询
    │
    ▼
┌─────────────────┐
│ 检查清单        │ ← 逐项比对，耗时不超过 0.5 秒
└───────┬─────────┘
        │
   ┌────┴────┐
   │ 是否改写？│
   └────┬────┘
        │
   ┌────┴────────────────┐
   │ 是                  │ 否
   ▼                     ▼
┌──────────┐      ┌──────────┐
│ 执行改写  │      │ 直接搜索  │
│ 输出 1-N  │      │ 原始查询  │
│ 查询      │      └──────────┘
└────┬─────┘
     │
     ▼
┌────────────────────────────┐
│ 搜索：原始 + 改写后查询     │
│ memory_search(原始)         │
│ memory_search(改写_1)       │
│ memory_search(改写_2)...    │
└────────────┬───────────────┘
             │
             ▼
┌────────────────────────────┐
│ 合并 & 去重（降低得分）     │
│ 为每条结果标注来源          │
└────────────────────────────┘

⚠️ 关键规则

1. 零改写原则 —— 无需改写时，直接搜索
2. 意图保真 —— 改写不得改变用户原始意图，仅补充上下文
3. 上下文范围 —— 默认从最近 2-3 轮对话中提取实体
4. 改写增强而非替代 —— 原始查询始终参与检索
5. 优雅降级 —— 若无法确定参考内容或意图，仍使用原始查询搜索，并标记 rewrite_skipped: true

📝 使用示例

示例 1：正常改写流程

上下文：用户之前问过 "iPhone 15 Pro 有哪些颜色？"
当前查询："保修多久？"
↓ 检查清单：语义不完整 → 模式 1
↓ 改写：提取实体 "iPhone 15 Pro" → "iPhone 15 Pro 保修期"
↓ 搜索：memory_search("保修多久？") + memory_search("iPhone 15 Pro 保修期")
↓ 合并、去重、返回结果

示例 2：多意图分解

上下文：（无）
当前查询："涂层机价格？保修？能定制吗？"
↓ 检查清单：多个问题 → 模式 4
↓ 改写：
  - "涂层机价格"
  - "涂层机保修"
  - "涂层机定制支持"
↓ 搜索：共 4 次（1 次原始 + 3 次改写）→ 合并、去重

示例 3：无需改写

上下文：（无）
当前查询："企业级 CRM 系统架构设计文档"
↓ 检查清单：全部不满足 → 直接搜索
↓ memory_search("企业级 CRM 系统架构设计文档")

📎 资源

• 改写模式参考：references/rewrite-patterns.md

📝 更新日志