Show HN: Forensic-deepdive——面向AI代理的程式碼知識圖譜與MCP伺服器

Forensic-deepdive 是一款專為AI編碼代理設計的程式碼知識圖譜與MCP（Model Context Protocol）伺服器工具。它能夠深入分析任意程式碼庫，構建一個持久化的嵌入式圖譜，其中包含檔案、符號、模組、提交、作者、端點以及資料庫表等節點，並透過多種關係邊（如定義、成員、匯入、呼叫、擴充套件、實現等）將它們連線起來。每條邊都帶有置信度標籤（EXTRACTED、INFERRED或AMBIGUOUS），確保透明度。特別地，它透過一個統一的端點節點，將五種跨邊界協議（HTTP、MCP工具、登錄檔分發、gRPC、訊息/AMQP）整合在一起，使得前端呼叫能夠一路解析到後端處理器。

該工具提供了9個複合MCP工具，包括impact（影響範圍分析）、context（上下文查詢）、archaeology（Git歷史考古）、flow（資料流分析）、query（圖查詢）、trace（跨棧追蹤）等，可被Claude Code、Cursor、Codex、Continue、Cline、Windsurf等任何支援MCP的代理使用。每次分析後，它會在 /docs/codebase/ 目錄下生成5份持久的Markdown文件：MAP.md（程式碼結構地圖）、HOTPATHS.md（依賴熱點，附置信度混合列）、ARCHAEOLOGY.md（程式碼演變歷史）、MENTAL_MODEL.md（新手上手指南）和AGENT_BRIEF.md（AI代理的規則摘要）。此外，它還會在目標倉庫中注入10個整合檔案，包括編輯器規則檔案、Claude技能清單等，且不會覆蓋已有檔案。

Forensic-deepdive 還擁有一個代理洞察層，允許代理記錄和回憶驗證過的學習內容，支援本地JSON檔案或可選的圖資料庫後端。它支援離線執行，無需任何LLM或網路連線，所有分析均基於靜態程式碼和Git歷史。目前版本為v0.8.0，已釋出在PyPI上，可透過 uv tool install forensic-deepdive 一鍵安裝。該工具已在多個真實倉庫（如Apache Superset、wagtail、spring-petclinic等）中經過測試，但作者坦誠地指出，它目前是一個輔助分析工具，尚不能證明能顯著加速代理解決實際問題的能力，這一評估留待後續版本。與同類工具相比，Forensic-deepdive 採用Apache-2.0許可，而其主要競爭對手GitNexus使用PolyForm Noncommercial許可，限制了商業使用。