JordanCoin/codemap

解决的问题

代码代理通常只能看到单个文件的文本，难以理解代码库中的结构关系。它们无法轻松确定哪些文件依赖于特定文件，也无法判断变更的「影响范围」，更不清楚构建系统规则（如 go.mod 或 tsconfig 别名）如何影响导入。codemap 提供了一种结构化的「真实情况」，使代理无需进行昂贵的手动扫描，即可理解依赖关系和项目结构。

工作原理

codemap 使用生态系统特定的规则分析仓库，而非简单的字符串匹配。它与 cargo metadata（Rust）、go.mod（Go）、package.json（JS/TS）等构建工具集成，以准确解析导入。对于 21 种语言的通用导入提取，使用 ast-grep。为确保可靠性，它实现了「覆盖契约」，明确报告无法解析依赖关系的情况，防止代理将部分图误认为完整图。

适用人群

专为使用 AI 代码代理（如 Claude Code 或 Codex）的开发者设计，他们需要代理对项目架构和依赖流有更深入的结构性理解。

主要亮点

• 构建系统感知的解析：基于 Go、Rust、JS/TS 和 Dart/Flutter 的真实生态系统规则解析导入。
• 影响范围分析：快速识别「枢纽文件」（被频繁导入的文件），并精确判断变更将影响哪些部分。
• 代理集成：提供包含 19 个工具的 MCP 服务器、用于自动上下文的会话钩子，以及用于机器可读项目智能的上下文协议。
• 跨代理交接：追踪哪个代理编辑了哪些文件，支持在不同 AI 工具间无缝切换。
• 远程分析：无需完整本地克隆，即可分析公开的 GitHub 或 GitLab 仓库。