用途：为 Rust 代码库加入快速混合搜索（词法+语义），以毫秒级返回带源码定位的排序结果，既可作为 crate 内的库调用，也可作为面向智能体的 CLI。
主要能力：词法引擎对 {path, lang, symbol, body} 建全文索引，采用代码感知分词（拆分 camelCase/snake_case，同时保留完整标识符）；语义引擎在索引时按符号或窗口切块并一次性生成向量，存入 ANN 结构；两路结果用 RRF 或加权分数融合，默认 RRF。索引持久化到磁盘（如 target/.search-index/）并加入 gitignore，按内容哈希（blake3）增量重建，而非 mtime。每条命中必须携带 path:line 与非空 snippet。
使用方式：先阅读技能文件并扫描目标 crate 布局，运行 bash {baseDir}/scripts/validate.sh 校验结构，编写 SEARCH-INTEGRATION-PLAN.md，再按方法论实现模块。查询 API 定义统一 trait CodeSearch，含 Hit{path,line,snippet,score} 与 SearchOpts{limit,mode}，mode 支持 lexical|semantic|hybrid。CLI 以 NDJSON 输出，支持 --json、--limit N、--mode；退出码 0 正常、2 用法错误、3 索引缺失或损坏、4 嵌入模型不可用。
适用场景：智能体定位代码、重构范围界定、精确标识符与语义意图混合检索。
限制：需固定嵌入模型与维度，变更会使向量库失效；需处理冷启动索引成本与索引体积；语义/混合模式依赖嵌入模型可用性。具体实现细节与命令以技能文档为准。