Graphenium：AI编码代理的本地信任层（Rust、Datalog、Salsa）

Graphenium是一个为AI编码代理设计的本地信任层，旨在解决代理在代码库导航和依赖信任方面的困难。AI代理在进行大规模代码变更时，常常过度读取无关文件、遗漏关键文件、从名称推断关系，并且在未完全理解依赖的情况下进行修改。Graphenium通过构建紧凑的结构化内存，帮助代理回答五个关键问题：符号依赖什么？什么依赖该符号？哪些关系有源代码支持，哪些只是推断？代理在编辑前应读取哪些文件？编辑后必须验证什么？

Graphenium的核心功能包括信任感知架构图、编辑前路径查找、编辑中工作区规划和编辑后验证与CI门控。信任感知架构图提取文件、模块、函数、方法、类、导入、调用、使用、继承、实现、测试、构建目标和依赖关系到本地图中，并为每个关系提供提取器、解析状态和置信度。代理可以针对已提取的关系进行规划，将推断的关系视为线索，而在遇到模糊的边时停下来检查源代码。编辑前路径查找帮助代理解析目标符号、查找调用者和下游消费者，选择最安全的源支持路径。编辑中工作区允许代理在编写代码前声明预期符号，后期与实际物理图进行比较。编辑后验证通过比较图快照计算下游影响，生成验证计划，并强制执行信任策略，确保变更安全。

Graphenium完全本地运行，AST流水线无需API密钥，源代码仅在显式配置语义提取时才会发送到远程服务。它适用于混合仓库，目前支持Rust、Python、Go、JavaScript、TypeScript、Java、C、C++和C#。对于C#项目，Graphenium通过解析.sln和.csproj文件获得额外的构建边界感知，将项目、程序集、命名空间和项目引用作为第一类图结构进行映射。

Graphenium通过MCP（模型上下文协议）集成到Claude Desktop、Cursor和CodeWhale等编码工具中，为AI代理提供即时的代码图查询能力。项目采用MIT许可证，社区可通过GitHub Issues提供反馈，安全报告发送至[email protected]，商业合作联系[email protected]。Graphenium的愿景是成为AI生成代码变更的信任与验证层，让代理在每次编辑前都能检查影响范围并验证更改的正确性。