Cranot/roam-code

它解决了什么问题

Roam-code 提供一个本地代码库智能层给 AI 编码代理，以减少代码库导航与理解所需的回合次数、代币数量与成本。它通过在代理开始编辑前提供预先解析的代码图事实，防止代理执行昂贵且重复的搜索操作（例如多次 grep）。

工作原理

Roam-code 将本地仓库索引为以 SQLite 为后端的符号、调用、导入与 Git 历史图，支持 28 种语言。它使用「任务编译器」识别代理提出问题的类型，并将答案（例如调用者列表、过滤后的 Git 历史）直接注入提示中。

此外，它实现了一个验证循环，在每次编辑后运行，以检查命名约定违规、导入幻觉、语法错误、复杂度、机密泄漏与算法模式。它可以作为 MCP 服务器集成到 Claude Code、Cursor 与 Continue 等工具。

适用对象

使用 AI 编码代理的开发者，想在降低 LLM 成本与延迟的同时，确保变更安全且可合并，并通过本地、无凭证的分析完成。

亮点

• Task Compiler: 预先解析仓库事实，以减少代理回合（在某些基准测试中降低高达 83%）和输入代币。
• Local-First: 不需要 API 密钥或云端登录；源代码解析和索引全部在本机上完成。
• Tamper-Evident Evidence: 生成已签名的 ChangeEvidence 包，记录变更的上下文、风险与验证。
• Verification Gate: 编辑后自动检查幻觉、机密和结构性问题。
• Broad Language Support: 使用 SQLite 后端的代码图，支持 28 种语言。