企业官网建设流程全解析

CLODEx Evidence Graph Memory深度解析：带溯源的AI长期记忆如何实现0%过期注入与79.5% token节省

【免费下载链接】clodex-ideLocal-first, zero-trust agentic IDE for verifiable autonomous software development.项目地址: https://gitcode.com/gh_mirrors/cl/clodex-ide

CLODEx 是一款 local-first、零信任的 AI 智能体 IDE（agentic IDE），其 Evidence Graph Memory（证据图谱记忆）系统让 AI 拥有带溯源的长期记忆：每一次被记住的事实都能追溯到原始事件，过期的代码证据会被自动拦截，从而在评测中实现0% 过期注入与79.5% 的 token 节省。本文带你快速看懂这套机制的原理、架构与实测数据。

CLODEx 工作区界面：AI 长期记忆运行的 agentic IDE 环境

AI 长期记忆为什么这么难？

大多数 AI 助手的"记忆"只有两种形态，且都有硬伤：

• 无损归档：完整任务历史存成 Markdown / JSONL，但模型不会主动去查；
• 有损简报：旧上下文被压缩成一段 LLM 生成的摘要，细节会丢、还会过时。

长任务的痛点更明显：几百轮对话之后，模型可能把已经改过的旧代码、已经被推翻的旧决策当成事实继续引用——这就是"过期注入"。

CLODEx 的解法很直接：不做第二个工作区快照，不删掉任何现有能力，而是在两者之上加一层"带溯源的检索"。官方设计文档见 evidence-graph-memory.md。

工作原理：8 步证据流水线

整个数据流是一条确定性流水线，每一步都可以单独开关：

agent 事件 -> 受保护的只追加事件账本 -> 确定性提取"声明（claims）"+ 溯源 -> 词汇 + 结构化检索 -> 影子模式 Context Pack -> 过期与矛盾检查 -> 受保护的提示词注入 -> 可选的语义检索与重排

几个关键设计点：

1. 事件账本（Event Ledger）：用户约束、文件操作、测试/类型检查结果、工具失败、压缩完成等 17 类事件被记录进 SQLite 只追加账本，且账本本身对提示词"惰性"——记了不等于会被注入。
2. 确定性声明提取：不调用 LLM，用确定性规则从事件里提取"声明"（claim）及其证据链，保证结果可复现。
3. 指纹防过期：文件字节和符号体都有独立的 SHA-256 指纹；代码证据在注入前必须通过 CodeGraph 刷新（5 秒整体时限、3 秒子进程超时），任何超时、文件缺失、指纹变化都直接拒绝（fail-closed）。
4. 真值生命周期：supersedes、invalidates、contradicts等关系让"新决策自动顶替旧决策"，多个相互矛盾且无法裁决的声明会被标记为conflicted而不是硬塞给模型。

安全不变式：注入前先过 8 道门

CLODEx 的记忆注入是"模型可见、失败即关闭"的。任何一步证明不了，就回退到现有的压缩历史记忆：

• ✅ 仓库 / 脏补丁身份可证明是当前的
• ✅ 事件溯源链完整、声明已解析出真值
• ✅ 代码指纹为最新
• ✅ 检索质量达标、渲染后 token 不超预算
• ✅ 任务/工作区标识不明文入索引，跨工作区检索默认拒绝
• ✅ 检索到的声明文本被转义并标记为无指令权限的历史数据（防提示词注入）
• ✅ 遥测只记录查询哈希、策略哈希，绝不回传原始检索内容

存储实现与迁移脚本位于 evidence-memory/，包含 schema.sql 及 v002–v005 共 5 个增量迁移。

实测数据：0% 过期注入与 79.5% token 节省

这是官方验证快照（2026-07-12）的核心数字：

这些数字不是"跑一次就过"：评测套件是确定性 fixture（不调用模型），可通过pnpm --dir apps/browser eval:evidence-memory-quality复现，报告只含聚合计数与策略哈希，不含任何提示词或事实内容。相关脚本见 run-evidence-memory-quality-evaluation.ts。

灰度发布与"影子模式"：先观察，再注入

CLODEx 没有一步到位全量开启，而是拆成了 5 个独立的功能开关（见 feature-gates.ts）：

• 🌑evidence-memory-shadow：影子账本——记录并对比，但不改提示词
• 🔍evidence-memory-inspector：任务级检查器 UI（查看采纳/拒绝/消费的决策）
• 💉evidence-memory-prompt-injection：真正的提示词注入（默认关闭）
• 🧬evidence-memory-hybrid-retrieval：本地嵌入 + 混合排序
• 🤖evidence-memory-model-summaries：后台脱敏摘要

发布渠道策略是dev → canary-100，生产通道只允许shadow → canary-5 → canary-25 → canary-100逐级推进，且每次晋级都需要Ed25519 签名的晋级证据（绑定精确提交、质量产物字节哈希、回放集哈希，48 小时有效期）。

还有一个自动熔断器：配对观察 ≥20 条后，一旦召回率跌破 95%、过期泄漏超 1%、p95 超 250 ms，注入立即禁用；紧急开关CLODEX_DISABLE_EVIDENCE_MEMORY_INJECTION=1一键止血。

用户视角：如何在界面里查看记忆

启用检查器后，设置页中的 Memory Inspector 面板（源码见 evidence-memory-inspector-panel.tsx）提供：

• 📊 任务级证据统计、声明搜索与详情（含溯源事件、生命周期关系、指纹）
• ⚖️ 冲突裁决与撤销
• 📤 导出为带权限保护的解密 JSON（从不一整库拷贝）
• ♻️ 按任务一键重置（单事务清除，连同索引）

总结

Evidence Graph Memory 给 AI IDE 的记忆系统立了三个标杆：可溯源（每条声明都能查回原始事件）、防过期（指纹 + CodeGraph 刷新，0% 过期注入）、省 token（79.5% 节省而非无限塞上下文）。配合影子模式、签名晋级与熔断器，它证明了"带溯源的 AI 长期记忆"可以工程化落地，而不只是一句营销词。

想动手体验？克隆仓库https://gitcode.com/gh_mirrors/cl/clodex-ide后在 dev 渠道打开evidence-memory-inspector开关，即可在真实任务上观察记忆被采纳与拒绝的全过程。

【免费下载链接】clodex-ideLocal-first, zero-trust agentic IDE for verifiable autonomous software development.项目地址: https://gitcode.com/gh_mirrors/cl/clodex-ide