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許可，限制了商業使用。