Fast Search

Fast Search - 极速代码搜索

⚡ 核心优化: 最小化上下文加载,直接执行工具调用,并行搜索,快速响应

0. ⚡ SPEED OPTIMIZATION RULES (CRITICAL)

核心原则: SEARCH FIRST, EXPLAIN LATER

执行流程:

用户请求 → 立即并行执行搜索 → 返回结果 → (可选)简短说明
         ↓
    无需加载完整文档/示例
    无需解释搜索策略
    无需展示搜索过程

速度优化清单 (MUST FOLLOW)

立即执行模式 (Instant Execution Mode)

触发搜索请求时,按以下步骤操作:

1. 推断搜索意图 (< 0.5s 思考)

   • 提取关键词
   • 推断文件类型 (根据仓库特征)
   • 确定 outputMode (默认 files_with_matches)

2. 立即并行调用 (无需等待)

   同时发起所有搜索 → 等待结果 → 直接返回
   

3. 精简输出 (只给必要信息)

   • ✅ 结果文件列表/匹配数
   • ✅ 关键代码位置
   • ❌ 搜索策略说明
   • ❌ 参数解释
   • ❌ 性能分析

禁止减速行为 (MUST NOT DO)

1. 🎯 WHEN TO USE

Activation Triggers

Keyword Triggers

• "搜索" / "查找" / "search" / "find" / "grep"
• "帮我搜" / "搜一下" / "帮我查" / "查一下" / "全局搜"
• "在哪里使用" / "where is used" / "引用" / "ref"
• "入口在哪" / "在哪里实现" / "怎么触发" / "触发链路"
• "玩法" / "玩法逻辑" / "活动逻辑" / "业务逻辑" / "规则" / "机制" / "流程" / "系统" / "模块"
• "战斗" / "副本" / "招募" / "钓鱼" / "小游戏" / "匹配" / "排行榜"

2. ⚡ INSTANT EXECUTION PATTERNS

Pattern 1: 单一符号搜索 (< 2s)

用户: "搜索 handleLogin 函数"

执行 (立即并行):

// 不解释,直接执行 ↓
search_content({ 
  pattern: "handleLogin\\(", 
  fileTypes: ".js,.ts,.jsx,.tsx,.py",  // 自动推断
  outputMode: "files_with_matches" 
})

返回: "找到 5 个文件包含 handleLogin 调用: src/auth.ts, src/login.js, ..."

Pattern 2: 符号定位 (< 3s)

用户: "查找 UserService 定义和使用"

执行 (并行 2 个搜索):

// 同时发起
search_content({ pattern: "class UserService", outputMode: "files_with_matches" })
search_content({ pattern: "UserService\\(", outputMode: "files_with_matches" })

返回:

• 定义: src/services/UserService.ts
• 使用: 8 个文件

Pattern 3: 玩法入口定位 (< 4s)

用户: "战斗系统的代码入口"

执行 (并行 3-4 个搜索):

search_content({ pattern: "\\b(battle|combat|fight)\\w*", fileTypes: ".py,.java,.js", outputMode: "files_with_matches", caseSensitive: false })
search_content({ pattern: "class.*Battle", outputMode: "files_with_matches" })
search_content({ pattern: "def.*battle|function.*battle", outputMode: "files_with_matches" })

返回:

• 核心类: game/BattleManager.py, game/BattleSystem.java
• 入口函数: initBattle, startBattle, ...

3. 🛠️ CORE TECHNIQUES

Technique 1: 并行搜索 (Parallel Search)

原则: 同时发起所有独立搜索,不串行等待

✅ 并行执行 (3x 速度)
search_content("functionA")  ─┐
search_content("functionB")  ─┼─► 并行执行
search_content("functionC")  ─┘
执行时间 = max(A, B, C) ≈ 2s

❌ 串行执行 (慢)
search_content("functionA") → wait → search_content("functionB") → wait...
执行时间 = A + B + C ≈ 6s

实践:

• 搜索函数定义和使用 → 并行
• 搜索多个相关符号 → 并行
• 不同目录的搜索 → 并行

Technique 2: 精确模式匹配 (Precise Pattern)

使用正则边界减少噪音:

Technique 3: 智能文件类型过滤 (Auto File Type)

自动推断策略:

# 根据仓库特征自动推断 fileTypes (< 0.1s)
if 项目有 .py 文件 → fileTypes: ".py,.pyx,.pyi"
if 项目有 .java 文件 → fileTypes: ".java"
if 项目有 .ts/.tsx 文件 → fileTypes: ".ts,.tsx,.js,.jsx"
if 项目有 .proto 文件 → 搜索协议时用 ".proto"
if 项目有 .vue 文件 → 前端搜索用 ".vue,.js,.ts"

常用过滤组合:

效果:

• 减少 60-90% 搜索文件
• 避免二进制/无关文件
• 无需用户指定类型

Technique 4: 智能输出模式 (Smart Output Mode)

默认策略: 优先使用 files_with_matches (最快,最省 token)

自动选择规则:

用户说"搜索/查找/在哪" → files_with_matches
用户说"有多少/统计" → count  
用户说"显示内容/具体代码" → content

两步策略:

步骤1: files_with_matches 快速定位 (< 2s)
步骤2: read_file 精读关键文件 (按需)

Technique 5: 目录范围限定 (Directory Scoping)

从最可能的目录开始:

优先级:
1. 已知相关目录 → 直接搜索
2. 项目源码目录 (src/, lib/, app/)
3. 排除无关目录 (node_modules/, vendor/, build/)

自动排除规则:

• node_modules/ (Node.js 依赖)
• vendor/ (第三方库)
• build/, dist/ (构建产物)
• .git/ (版本控制)
• venv/, env/ (Python 虚拟环境)

4. 📋 SEARCH WORKFLOWS

Workflow A: 符号定位 (Symbol Location)

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  1. 定义搜索    │ ──► │  2. 使用搜索    │ ──► │  3. 精读关键    │
│  def/class/func │     │  调用/引用      │     │  read_file      │
└─────────────────┘     └─────────────────┘     └─────────────────┘
        │                       │
        └───────────────────────┘
              并行执行 (< 3s)

示例: 查找 processOrder 函数

// 并行执行
search_content("def processOrder\\(", fileTypes: ".py")     // 定义
search_content("processOrder\\(", fileTypes: ".py")         // 调用

Workflow B: 依赖追踪 (Dependency Trace)

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  1. 导入搜索    │ ──► │  2. 模块定位    │ ──► │  3. 接口分析    │
│  import/from    │     │  search_file    │     │  read exports   │
└─────────────────┘     └─────────────────┘     └─────────────────┘

Workflow C: 重构影响分析 (Refactor Impact)

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  1. 全局统计    │ ──► │  2. 文件列表    │ ──► │  3. 逐文件审查  │
│  outputMode:    │     │  outputMode:    │     │  read_file      │
│  count          │     │  files_with_    │     │  with context   │
│                 │     │  matches        │     │                 │
└─────────────────┘     └─────────────────┘     └─────────────────┘

5. ⚡ PERFORMANCE OPTIMIZATION

速度优化清单 (MUST DO)

禁止减速操作 (MUST NOT)

6. 🔍 COMMON PATTERNS

Pattern Library (快速参考)

7. 🎯 DECISION TREE

需要搜索?
    │
    ├─► 知道文件名? ─► search_file (通配符)
    │
    ├─► 搜索代码内容?
    │       │
    │       ├─► 单一模式? ─► search_content (并行可能的变体)
    │       │
    │       └─► 多个模式? ─► 并行 search_content
    │
    ├─► 探索目录结构? ─► list_files
    │
    └─► 大规模复杂搜索? ─► task (code-explorer 子代理)

8. 📊 RESULT HANDLING

结果过多时

1. 添加过滤条件: 指定 fileTypes,限定目录
2. 使用更精确的模式: 添加边界 \b,使用完整签名
3. 分批处理: 先统计 (count),再按文件处理

结果为空时

1. 检查拼写: 确认搜索词正确
2. 放宽模式: 移除边界限制,使用部分匹配
3. 扩大范围: 移除 fileTypes 限制,搜索更多目录
4. 尝试变体: 驼峰/下划线,大小写变体

9. 🎓 SUCCESS CRITERIA

速度基准

10. ⚡ INSTANT EXECUTION CHEATSHEET

快速执行模板

单符号搜索:

// 立即执行,无需解释
search_content({ 
  pattern: "symbolName\\(",
  fileTypes: ".推断的类型",  // 自动推断
  outputMode: "files_with_matches"  // 默认最快
})

符号定位 (定义+使用):

// 并行执行
[
  search_content({ pattern: "class|def|function SymbolName", outputMode: "files_with_matches" }),
  search_content({ pattern: "SymbolName\\(", outputMode: "files_with_matches" })
]

玩法入口定位:

// 并行 3 个模式
[
  search_content({ pattern: "\\b关键词\\w*", caseSensitive: false, outputMode: "files_with_matches" }),
  search_content({ pattern: "class.*关键词", outputMode: "files_with_matches" }),
  search_content({ pattern: "def.*关键词|function.*关键词", outputMode: "files_with_matches" })
]

自动 fileTypes 映射

执行流程 (< 3s)

1. 识别意图 (< 0.5s)
   ↓
2. 推断 fileTypes (< 0.1s)
   ↓
3. 并行执行搜索 (1-2s)
   ↓
4. 返回结果 (< 0.5s)

关键: 跳过文档加载、策略解释、过程展示

11. 📚 TOOLS REFERENCE

工具速查

常用 fileTypes 组合

Python:     .py,.pyx,.pyi
JavaScript: .js,.jsx,.mjs
TypeScript: .ts,.tsx
Java:       .java
C/C++:      .c,.cpp,.h,.hpp
Go:         .go
Rust:       .rs
Proto:      .proto
Config:     .json,.yaml,.yml,.toml,.xml
Web:        .html,.css,.scss,.vue
Shell:      .sh,.bash