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生成代碼變更的信任與驗證層，讓代理在每次編輯前都能檢查影響範圍並驗證更改的正確性。