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 特定的結構化查詢等專用指令。