defendend/Claude-ast-index-search

解决的问题

在大型多语言代码库中，简单的文本搜索（如 grep）速度太慢或不够精确。该工具允许开发者和 AI 代理通过精确的结构元素（如类、函数、依赖项）进行导航，而无需阅读整个文件或猜测符号的定义位置。

工作原理

该工具为项目的抽象语法树（AST）构建本地 SQLite 索引。通过解析代码结构，它映射出符号、引用、导入、模块和继承模式。用户可以通过 CLI 查询此索引，直接跳转到定义位置，查找符号的所有使用情况，或映射模块之间的依赖路径。

适用人群

• 开发者：在大型仓库（尤其是单体仓库）中工作，需要快速、结构化的代码导航。
• AI 编码代理（如 Claude Code、Cursor 或 Gemini）：需要紧凑、可解析的结构化上下文，而非原始文件转储，以节省 token 并提高准确性。

主要亮点

• 广泛的语言支持：支持 Kotlin、Java、Swift、Rust、TypeScript、Python、Go、C# 等多种语言。
• 代理优化：通过提供代码的结构化片段而非整个文件，将代理的 token 使用量减少 40–50%。
• 高性能：在查找导入、依赖项和类方面，相比 grep 有显著提速（某些基准测试中最高快 260 倍）。
• 深度集成：提供适用于 Claude Code、Cursor、Codex 和 Gemini CLI 的插件和技能。
• 高级分析：包含模块依赖路由、XML/资源使用分析以及 iOS 特定的结构化查询等专用命令。