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