indexion grep 提供 KGF 感知的 token 模式搜索、结构查询与向量相似度搜索,适合按结构而非纯文本检索代码。
用途:查找特定代码模式(如嵌套 for 循环、无文档的 pub fn)、定位某函数的引用位置、查找所有 pub struct,或按自然语言描述做语义搜索。官方建议用它替代手工 grep/ripgrep,也可替代 Explore 智能体做定向代码库查询。
主要能力:
- token 模式搜索,模式由空格分隔的 token 匹配器组成,KGF 别名自动解析,如 pub 映射为 KW_pub。示例:indexion grep "pub fn *" src/、indexion grep "for ... for" src/、indexion grep "fn Ident:sort" src/、indexion grep "!pub fn" src/。
- 模式语法:pub 匹配关键字;KW_fn 精确匹配 token 类型;Ident:foo 按类型与文本匹配;* 匹配任意单个 token;... 匹配零或多个 token(非贪婪);!pub 为否定;括号、箭头等标点有别名。别名由 KGF 规范自动生成,适用于所有 KGF 支持的语言。
- 语义查询:--semantic=proxy 查代理函数,--semantic=long:30 查长函数,--semantic=short:3 查短函数,--semantic=params-gte:4 查参数较多的函数,--semantic=name:sort 按名称子串查找,--undocumented 或 --semantic=undocumented 查无文档的 pub 声明。
- 向量相似度搜索:基于 TF-IDF 嵌入,用 --semantic="similar:..." 按自然语言描述查找,结果按余弦相似度排序;描述性短语效果更好。
- 输出控制:--files 仅显示文件路径,--count 显示每文件匹配数,--context=N 显示上下文行,--include / --exclude 按 glob 筛选文件。
相关命令:explore 用于文件级相似度矩阵;plan refactor 生成重构计划;plan unwrap 做代理函数检测与自动修复;digest query 提供基于用途的函数索引。grep --semantic=proxy 与 plan unwrap 在检测上重叠,但后者可自动修复;grep --semantic=similar 与 digest query 重叠,但无需构建步骤,digest 更适合大型代码库的重复查询。
典型用法(写代码后自查):查找潜在 O(n²) 嵌套循环、检查未文档化的公开 API、查找可解包的代理函数、查找过长函数、按相似度定位重构目标、在移动类型前追踪所有引用、跨库查找与排序相关的函数、验证重构后是否残留孤儿引用。
限制:资料未提供安装方式、许可证、性能数据、支持语言清单及具体定价信息,暂未提供。alias 非硬编码,依赖 KGF 规范目录(默认 kgfs,可用 --specs-dir 指定)。