Theme / v1.6.2
Codegraph
程式碼知識圖譜工具
Changelog
版本更新紀錄
收錄 Codegraph 的版本變遷軌跡。每條紀錄以舊值→新值呈現，舊值以紅線劃掉但保留可見，方便對照改動軌跡。
v1.6.2
已同步2026-10-07- 2026-11-06 查核：上游最新 release 仍為 v1.6.2（2026-10-03 發布），其後無新版本。
- 版本定位：v1.6.1→v1.6.2（2026-10-03 發布，單一 release）。主軸延續 v1.6.1 的「更少錯誤連結」並擴及更多語言、overload/
super/遞迴解析、更多框架路由、Windows 穩定性與背景 server 可靠性。升級後需重新索引各專案——多數修正是在索引時寫入。 - 每個語言都更少錯誤連結：呼叫、import 或型別引用改以各語言自己的名稱作用域（scoping）解析——經過 imports、packages、namespaces 與所在 class——不再落到僅同名的不相關符號；涵蓋 TypeScript/JavaScript、Python、Java、Kotlin、Scala、C#、VB.NET、Swift、Objective-C、Go、Rust、C/C++、PHP、Ruby、Dart、Lua、R 等，
callers、impact 與codegraph_explore答案更可信。 - Overload、
super與遞迴正確解析：呼叫會到達引數符合的那個 overload；super呼叫到達父類別的方法；呼叫另一個 overload 或另一個物件的同名方法不再看起來像呼叫自己。 - 更多框架路由：Angular（含 Nx libraries）、Vue Router admin apps、Rails nested routes、Flask 的
add_url_rule、ASP.NET FastEndpoints、Play subprojects、Vapor closure routes 與 Expo Router API routes 會被找到；NestJS 與 Laravel 的 route 以請求實際路徑命名，Spring 或 Laravel 測試以 URL 呼叫 route 計為覆蓋。 - 更多程式碼進入圖譜：Vue Options API components、Java/Kotlin 帶 body 的 enum constants、Flow-typed JavaScript、Kotlin infix 呼叫、React Native native views 與 events、Expo modules、tag-based CFML 與 Delphi
.inc檔案。 - Windows 修正：背景 server 工作時不再彈出 console 視窗；索引或關閉時偶發的 access-violation crash（exit code 3221225477）修復；
codegraph upgrade可在 agent session 使用 CodeGraph 時運作。 - 背景 server 與索引：較新的 MCP clients（如 Antigravity）可再次連線；Claude Code 能看到
codegraph_status全文；失去共用 server 的 session 自行重連；經projectPath查詢的專案在閒置 10 分鐘後釋放。大型 C/C++ 專案解析 references 不再 OOM；單一 COBOL 檔不再卡住索引；codegraph sync保留多重定義名稱的每個 caller。 - 既有使用者影響：升級後請重新索引（多數修正在索引時寫入）；Windows 使用者受益最明顯（無彈窗、無隨機 crash）；使用 overload 密集的 Java/Kotlin/TypeScript 專案 callers 結果會改變（更正確）。
v1.6.1
舊版本2026-09-29- 版本定位：v1.6.0→v1.6.1。升級重點：應用程式的導覽與請求進入圖譜、
codegraph_explore答案更精準並標示呼叫條件、大量修正跨語言的錯誤連結，以及同步與索引可靠性的全面強化。升級後請重新索引各專案——多項修正與新的導覽邊是在索引時寫入。 - 導覽與路由進入圖譜：Expo Router、Next.js（App Router 與 Pages Router）、React Router、TanStack Router、Vue Router / Nuxt、SvelteKit 的頁面與其間連結成為 route 節點與
navigates邊；頁面的fetch/axios/ky/got/$fetch呼叫（含經axios.create實例）可追溯到服務它的 route——「這個按鈕點了會去哪」與「誰呼叫這個 endpoint」變成codegraph_explore的一個問題。 - Flow 標示呼叫條件：
codegraph_explore的 Flow 段落每一跳都帶該呼叫發生的條件（如↓ calls (when isCollected)），讀取if/else、switch/match、三元、try、&&分支與早期返回（if (busy) return讀作!busy；Go 的if err != nil { return }讀作err == nil）。支援 JavaScript、TypeScript、Swift、Python、Java、Kotlin、C#、Go 與 C；沒有規則的語言寧可不說也不猜測。 - 跨層追蹤：BullMQ / Bull 佇列的 job 連到消費它的
@Process方法／Worker／queue.processhandler；NestJSEventEmitter2事件連到@OnEventlistener；socket 訊息連到 gateway 的@SubscribeMessagehandler（雙向）；Next.js server action 從 client 檔案的呼叫成為跨越到 server 的邊。每個合成跳由 Flow 段落命名並標示接線位置；僅字面路徑或事件名稱可配對。 codegraph_explore答案更精準：指定的函式與方法完整回傳（即使來自超大檔案或滿是同名 override 的檔案）；遵守查詢中的行號（compiler.py:776回傳含該行的 method、lines 900-1003回傳確切行段）；答案被縮短時明說並列出被修剪的檔案與省略的函式，不再謊稱完整；中文檔名查詢（含或不含副檔名）可找到檔案。- 更少錯誤連結：大量修正 TypeScript、JavaScript、Python、Java、Kotlin、Go、Rust、Scala、PHP 與 C/C++ 中呼叫、匯入與繼承的解析——同名符號不再讓呼叫落到不相關的目標。代表性修正：JS/TS 中無 receiver 的呼叫不再解析到同名 method；檔案私有（
private、C 的static、Rust 非pub）的定義不再被其他檔案的名稱匹配捕獲；node16/nodenext 的.js匯入解析回.ts原始檔（582 檔專案的 import-backed 邊從 4,002 升至 7,312）。 - 同步可靠性：MCP server 在
codegraph index後切換到重建的索引並補趕錯過的變更；中斷的 sync 恢復到與乾淨索引相同的連線；symlink 目錄內的編輯在 macOS／Windows／Linux 自動同步；WSL 掛載 Windows 磁碟的專案取得獨立的.codegraph-wsl/索引；watcher 範圍對齊git ls-files --exclude-standard（含.git/info/exclude與core.excludesFile）。 - 大型儲存庫更輕量：MCP server 重複的 explore 呼叫不再重掃整個圖譜（答案重用到索引變更為止）；超大檔案與偽
.ts的影片 fixture 不再被讀入或解析；直接（非 daemon）MCP session 以小型 off-thread query pool（預設 2 workers，CODEGRAPH_QUERY_POOL_SIZE可調）服務並行呼叫。 - 其他改善：
codegraph install支援AGENTS.md作為規範 agent 指南（Codex 與 Astra 不再錯過 CLAUDE-only 指令）；React Native 的 Swift 原生模組與事件端對端連結；useCallbackhandler、CommonJS controller、Zustand actions、e2e/測試目錄等符號辨識強化；Kotlin 函式帶簽名；Windows 上 MCP daemon 的鎖檔等待與 Git Bash launcher 修復；Claude Code prompt hook 注入上限降至 9,000 字元內建顯示，且codegraph_explore透過alwaysLoad從第一個 prompt 就載入。 - 既有使用者影響：升級後必須重新索引（
codegraph index）才能取得新導覽邊與多項解析修正；錯誤連結的修正在既有索引中仍在，重建才會清除。
- 版本定位：v1.6.0→v1.6.1。升級重點：應用程式的導覽與請求進入圖譜、
v1.6.0
舊版本2026-08-26- v1.5.0→v1.6.0：升級重點為 GitHub Copilot 支援、
codegraph_explore答案品質大幅改善、索引穩定性與磁碟空間洩漏修復。升級後請在各專案執行一次codegraph index，讓既有圖譜吃到全部修正（codegraph status會提醒）。 - GitHub Copilot 支援：
codegraph install現在可設定 VS Code、GitHub Copilot CLI 與 JetBrains IDE 的 Copilot 整合，自動偵測既有 agent 設定，codegraph uninstall可完整還原。 - 一行完成設定：
codegraph install --yes --init無互動提示，一次完成 agents 接線與專案索引，適合全新容器或 CI 環境；另新增--location=local可將 Codex CLI 設定僅寫入單一專案。 codegraph_explore答案更好：同一對話中已顯示過的檔案改回精簡 pointer（路徑＋符號＋行號）不再重複佔空間；以路徑或 kebab-case 檔名指定的檔案保證出現在答案中；答案聚焦真正回答問題的程式碼，generated files、type shims 與頂層 test/spec 檔不再擠佔篇幅。- 圖譜長期保持正確：長期使用的 index 不再與全新 index 產生 drift（重播 80 個 commit 的錯誤連線由 5.7% 降至 1.3%）；執行中修改
codegraph.json的exclude/include立即生效，不需重啟。 - 修復索引崩潰與卡死：極深巢狀的 C/C++ 檔案改交 fallback parser 並記錄警告；Swift Vapor 專案的長參數列呼叫不再讓索引無限 hang；大量檔案 sync batch 的「Maximum call stack size exceeded」crash 修復。
- 修復磁碟空間洩漏：process 被強制終止後殘留的 write-ahead log 可能無限成長（曾回報數十 GB），現在 log 大小有上限（預設 64 MB），超量的殘留會在下一次開啟專案時自動摺回 index 並修剪。
- 其他改善：MCP server 從 workspace/monorepo 根目錄啟動時可自動找到其下唯一已索引專案；新增
deprioritize設定避免輔助資料夾在搜尋排名壓過產品程式碼；恢復文件中記載的codegraph context指令；TypeScript、Rust、Erlang、C/C++、Python 的解析準確度提升（需重新索引）。
- v1.5.0→v1.6.0：升級重點為 GitHub Copilot 支援、
v1.5.0
舊版本2026-08-10- version 欄位為
v1.5.0，與上游最新 release/tag 一致（2026-07-21 發布）。上游無中介版本，release 仍為最新。 - Rust engine release — with near-instant sync：CodeGraph 的解析引擎重寫為原生 Rust kernel，是有史以來最大的效能升級，且每個 graph 都驗證 byte-for-byte 與前一代引擎一致。
- 20 種語言（TypeScript、Java、Python、Go、C、C++、Rust、C#、Ruby、PHP、Swift、Kotlin、Scala、Dart、R、Lua 等）改為原生 Rust kernel 解析；無 prebuilt binary 的平台自動 fallback 到前一代引擎。（CUDA / Metal 走 C++ 路徑。）
- Adaptive to your machine：依容器/與 cgroup-aware 真實核心數、macOS/Linux 可用記憶體、實測解析成本動態調整 worker，在 2-core/6GB 機器上 Linux kernel（70k 檔）可在 12 分鐘內索引完成。
- Sync near-instant：單檔儲存後 300ms quiet window 即觸發 watcher，只同步變動路徑；4,400 檔 Java 專案 ~0.3s、27,000 檔 Swift compiler repo ~0.4s，結果與完整 reconciliation byte-identical。
- 上游 main 分支最新 commit 為
2026-08-08T02:56:05Z（release 之後），屬 commit-level 變動、無新版 release。
- version 欄位為
圖例
- 當前版本 本站現在記錄的版本
- 舊版本 已被取代，保留作歷史對照
- 已同步 與上游 release 對齊
- 僅上游變動 上游 main 有 commit，但未發佈新版