SuperAPI AI 工具集

ccx-codebase-explorer

通用与其它

查看项目

更新于 10-15 20:13

技能介绍

用途:ccx 是 CocoIndex Code Plus 的客户端 CLI,用于理解与查找代码。它查询远程查询服务器已索引的代码库,覆盖语义搜索、AST 结构 grep、符号定义/引用、只读文件访问,以及(在启用时)带引用的书面回答。CLI 不持有索引,结果描述服务端索引快照,而非本地磁盘。

主要能力:

  • 语义搜索:ccx search "<代码做什么>",按概念而非精确语法查找,支持 --repo(可重复)、--git-ref、--lang、--path、-k/--top-k、--offset。
  • AST 结构 grep:ccx grep '<pattern>' -l <language>,按语法树匹配,忽略格式与注释;元变量包括 _、*、+、?、/re/、\NAME、{{ INNER }};支持 --path、-k/--limit、--offset。
  • 符号导航:ccx defs <Name> 查定义,ccx refs <Name> 查引用,支持 --role(call、import、type_use 等)、--kind、--lang、--path;覆盖 Python、TS/JS(含 TSX)、C/C++、C#、Rust。
  • 问答:ccx ask "<question>" 返回带引用的书面回答。
  • 仓库与 ref 作用域:自动按当前 git checkout 的 origin 远程识别仓库,可用 --repo 覆盖;--git-ref 可选,默认使用已索引的当前分支或默认分支;ccx repos 列出已索引仓库与 refs。

使用方式:在仓库 checkout 中运行,每条问题一条命令,例如 ccx defs <Name>、ccx refs <Name> --role call、ccx search "<what the code does>"、ccx grep '<pattern>' -l <language>、ccx ask "<question>"。defs 输出行末提供可直接粘贴的 uses: ccx refs PATH ENTITY_ID 命令。

适用场景:概念模糊的查找、结构形状匹配、跨文件符号定义与引用、未本地 checkout 的仓库、其他分支/标签、多仓库语料,以及需要书面引用解释的问题。

限制:索引 ref 是提交快照,未提交或未推送的改动可能导致路径与行号过期,新增符号可能缺失;本地文件读取与自索引提交后编辑/新增的文件仍应使用本地工具。语义搜索按相似度排序,命中不代表代码实际运行;结构 grep 空结果表示结构不匹配,需放宽模式。符号索引可能未构建、被跳过、部分解析或与 ref 索引头不一致,缺失符号不一定不存在。无全局“搜索一切”模式。其他语言需回退到 grep/search。具体收费、价格、平台与效果资料暂未提供。