資料不出機器。沒有 API key、沒有外部服務，只有 SQLite 資料庫（.codegraph/codegraph.db）。抽取是確定的——由 AST 決定，不是 LLM 摘要。
CodeGraph 收集匿名使用統計——哪些工具與指令被用、哪些語言被索引——用來決定語言/agent 支援要投哪。**絕不**含任何程式碼、路徑、檔名、符號名、查詢或 IP；使用量在本機聚合為每日總數後才送出，ingest 端點是 repo 內公開程式碼（telemetry-worker/）並強制文件欄位清單。安裝器會先問；任何時候可關：
codegraph telemetry off # 或：CODEGRAPH_TELEMETRY=0，或 DO_NOT_TRACK=1TELEMETRY.md 列出每個欄位、off-switches 與完整資料處理故事。
每個 artifact 都由公開 Release workflow（.github/workflows/release.yml）建與發——不是從筆電——並帶密碼學證明：
npm audit signaturesSHA256SUMS）帶簽署的 build attestation（SLSA v1.0 Build Level 2）。驗證：
gh attestation verify codegraph-darwin-arm64.tar.gz -R colbymchenry/codegraph2026 年 7 月之前發行的版本先於此 pipeline，不帶 attestation。
| 平台 | 架構 | 安裝 |
|---|---|---|
| Windows | x64、arm64 | PowerShell installer 或 npm |
| macOS | x64、arm64 | shell installer 或 npm |
| Linux | x64、arm64 | shell installer 或 npm |
| 症狀 | 解法 |
|---|---|
| 「CodeGraph not initialized」 | 先在專案目錄跑 codegraph init。 |
| 索引很慢 | 確認 node_modules 與其他大目錄被排除；用 --quiet 減輸出。 |
MCP database is locked | 新版用 node:sqlite WAL，並行讀不阻塞寫。老（pre-0.9）安裝重裝；status 顯示非 wal 時把專案移到本機磁碟。 |
| MCP server 連不上 | agent 自己啟動 server；確認專案已 init + 已索引（codegraph status）且路徑正確；重跑 codegraph install 重寫設定。 |
Transport closed | 多半是 WSL2 + Windows 磁碟路徑的 local socket 不穩；設 CODEGRAPH_NO_DAEMON=1，或把專案移到 Linux-native 檔案系統。 |
| 缺少符號 | 等 auto-sync（幾秒）；或手動 codegraph sync。確認語言受支援、不在 gitignore / 預設排除目錄。 |
| Windows / WSL 共用 checkout | 別讓兩邊共用同一 .codegraph/；用 CODEGRAPH_DIR=.codegraph-win 給 Windows，WSL 留預設。 |