语义搜索:
  - 自然语言查询代码
  - 理解代码意图而非仅匹配关键词
  - 跨文件关联分析

代码理解:
  - 找到相关函数/类
  - 识别使用模式
  - 追踪依赖关系

Research 阶段 (优先):
  - 理解现有代码结构
  - 查找相关实现
  - 识别修改影响范围

Execute 阶段:
  - 查找类似实现参考
  - 确认命名一致性

// 基础搜索
sou_search({
  query: "用户认证相关的函数",
  scope: "src/",
  limit: 10
})

// 带过滤搜索
sou_search({
  query: "处理 JWT token 的代码",
  scope: "src/auth/",
  file_types: [".ts", ".js"],
  limit: 5
})

// 查找登录相关代码
sou_search({
  query: "用户登录验证逻辑"
})

// 结果示例:
// [
//   { file: "src/auth/login.ts", line: 45, content: "async function validateLogin..." },
//   { file: "src/middleware/auth.ts", line: 12, content: "export const authMiddleware..." }
// ]

// 查找某个函数的使用
sou_search({
  query: "调用 validateUser 函数的地方"
})

// 查找类似的错误处理
sou_search({
  query: "API 错误响应处理模式"
})

好的查询:
  - "处理用户认证的函数"
  - "数据库连接配置"
  - "React 组件的状态管理"

差的查询:
  - "function" (太泛)
  - "const a = 1" (太具体)
  - "代码" (无意义)

sou 优势:
  - 理解语义，不只是文本匹配
  - 找到相关但用词不同的代码
  - 更智能的排序

grep 优势:
  - 精确匹配
  - 更快（无需向量计算）
  - 支持正则表达式

建议: 先用 sou 探索，再用 grep 精确定位

# orchestrator.yaml
mcp_tools:
  recommended:
    - name: sou
      purpose: "语义搜索"
      fallback: "grep/ripgrep"

# 使用 ripgrep
rg "pattern" --type ts

# 使用 grep
grep -r "pattern" src/ --include="*.ts"