一句話說清楚

Codegraph 是一個基於本地知識圖譜的程式碼結構探索工具。

v1.5.0 更新重點

CodeGraph v1.5.0 將解析核心改為原生 Rust engine，涵蓋 20 種常見語言；沒有預編譯核心或個別檔案解析失敗時，會自動回退到舊引擎，並維持相同圖譜結果。大型專案的解析、參照解析與動態分派分析也改為自適應並行，watcher 會在約 300ms 靜默窗口後只同步實際變更的路徑。需要排查相容性時，可用 CODEGRAPH_KERNEL=0 關閉原生核心。¹

它的核心哲學是：利用代碼實體之間的呼叫鏈結與依賴拓撲，取代傳統 grep 的字串搜尋與人工查閱。 它專門設計了單一工具呼叫 codegraph_explore，讓 AI 代理能夠在一次請求中，同時獲取某個 Symbol 的原始碼實作、被呼叫關係（Inbound）以及調用依賴（Outbound），徹底解決 AI 在大型專案中「迷失上下文」的痛點。

為什麼傳統的 grep 搜尋無法滿足 AI 協作？

當我們與 AI（如 Claude Code）一起處理複雜的代碼庫時，AI 經常需要對程式碼進行探索。然而，使用 ripgrep 或 find 等字串工具進行搜尋，有著明顯的局限：

1. 盲目地多輪工具呼叫 (Tool Call Bloat)： AI 為了查明一個方法的呼叫鏈，必須先 grep 該名稱。若發現它在三個檔案中被使用，AI 又必須分別呼叫三次 read_file 讀取這三個檔案的內容。接著它可能又需要追蹤上游，這會導致工具呼叫次數呈線性增長，極大地降低了任務執行效率並耗費昂貴的 API Token。
2. 無法追蹤動態分派與跨語言邊界： 在複雜專案中（如 React Native 橋接、介面多型分派、微服務路由），Grep 只認字串。它無法理解「JavaScript 端調用的 BluetoothModule，其實對應到 iOS Swift 中的 CBCentralManager 實作」，導致 AI 常給出風馬牛不相及的重構建議。

核心創新：單一工具呼叫 (codegraph_explore)

Codegraph 的強大之處在於，它將「搜尋、定位、關係分析、程式碼讀取」四個傳統步驟，收縮到了單一工具呼叫中。

當 AI 調用 codegraph_explore 時，Codegraph 本地解析器會立刻在 AST 圖譜中尋找該 Symbol，並以結構化格式回傳完備的上下文：

               ┌─────────────────────────┐
               │    Inbound Callers      │  <-- 誰呼叫了我 (上游影響範圍)
               └────────────┬────────────┘
                            │
                            ▼
               ┌─────────────────────────┐
               │   Symbol Definition     │  <-- 我的原始碼與起止行數
               └────────────┬────────────┘
                            │
                            ▼
               ┌─────────────────────────┐
               │  Outbound Dependencies  │  <-- 我呼叫了誰 (下游依賴)
               └─────────────────────────┘

• 入站呼叫鏈 (Inbound Callers)：清晰列出所有呼叫了當前 Symbol 的檔案與函式。這能讓 AI 在改動前立刻做「影響範圍評估（Impact Analysis）」。
• Symbol 定義 (Definition)：精確回傳該 Symbol 的 Verbatim 原始碼片段。
• 出站相依性 (Outbound Dependencies)：列出該 Symbol 內部所呼叫的底層核心函式，免去了 AI 為了看懂邏輯而去遍歷下游檔案的需要。

根據實測，這種單一呼叫模式可以為 AI 協作減少 58% 以上的工具呼叫次數，提升 22% 的響應速度。

框架感知與跨語言橋接

Codegraph 不僅能解析多種主流程式語言的語意，還特別具備以下進階感知能力：

1. 17+ 種主流 Web 框架路由解析

Codegraph 能自動識別諸如 Express、Django、FastAPI、Next.js 等框架的路由配置。 當 AI 探索一個 HTTP Endpoint（如 GET /api/users）時，Codegraph 能直接關聯到處理該請求的 Controller 函數，建立起「網路路由與實作程式碼」的直接鏈結。

2. 跨語言橋接追蹤 (Cross-Language Bridging)

在 React Native、Expo 或 Flutter 等跨平台開發環境中，Codegraph 能夠讀取 React Native Bridge 的宣告，自動將 JS 端的 NativeModules.Bluetooth 連結到 iOS Objective-C/Swift 或 Android Java/Kotlin 的對應 Native 模組，跨越語言邊界梳理代碼網。

在下一章 [本地初始化與圖譜同步] 中，我們將說明如何在你的本機專案中初始化 Codegraph，並設定檔案監聽以保持圖譜的最新狀態。