ZONGYUAN-ROOT 联邦记忆网关技术白皮书 V1.0

锚点 Ω₀⊂⊙∞⊂Ω ｜ DID-BR-000002 ｜ 2026-10-29 单一真相源 · 锚定检索 · 五域联邦 · 对标裁定

1. 摘要与定位

联邦记忆网关（Federated Memory Gateway）是元极恒一自治智能体系的记忆中枢：本地内核是唯一真相产生地，云端多产品是投影与检索面，网关负责在两者之间做确定性的读取聚合与append-only的写入汇聚。

它要解决的不是"存得多"，而是三个更难的问题：

1. 真相一致：多端多副本下，哪份数据是可信的？——答案：真相只在本地账本产生，云端只做投影，任何改动走哈希链确权。
2. 检索降载：全量扫描记忆在资产过万后不可行。——答案：锚定条件定点拉取（anchor pull），按 tag / asset_id / 关键字 / 快照号直达，token 预算内裁剪。
3. 跨域联邦：记忆散落在五个以上产品（资料库、知识库、协作文档、网盘、会议纪要），如何一次查全？——答案：五源联邦读取面，一次查询聚合本地与五源结果。

本文提炼已落地运行的 V1.0 机制，给出与主流记忆方案的对标裁定，并披露边界与路线。

2. 设计公理

四条公理，违反任何一条即回滚：

#	公理	内容	违反后果
AX-1	单一真相源	真相只在本地 pool.db 与全局账本产生；云端五产品是投影与检索面，不产生新真相	数据分叉，一致性崩塌
AX-2	锚定拉取	记忆读取一律走锚定条件（anchor_type: latest / tag / asset_id / snap_id / keyword），禁全量扫描	token 爆炸，检索退化
AX-3	Append-only	云端写入只允许追加到活版本，禁止覆写历史；写入前强制门禁校验	历史失真，不可溯源
AX-4	成本三维	一切联网任务先记账，能力、密度、算力三维取并集从严，70/90/100 三档熔断	月末断粮，自治停摆

3. 架构总览

四层结构，单向汇聚向上投影，读路径反向聚合：

┌──────────────────────────────────────────────────────┐
│ L3 检索面    统一入口：anchor 查询 = 本地 + 五源联邦聚合     │
├──────────────────────────────────────────────────────┤
│ L2 云端投影层  资料库=成果正文 ｜ 知识库=长期知识            │
│              协作文档=协作资产 ｜ 网盘=冷存储 ｜ 会议=纪要源  │
├──────────────────────────────────────────────────────┤
│ L1 网关路由   HMAC 鉴权 · 联邦查询 · 积分熔断               │
├──────────────────────────────────────────────────────┤
│ L0 本地真相层  pool.db + 全局账本 + 记忆索引（唯一真相源）   │
└──────────────────────────────────────────────────────┘

• L0 本地真相层：pool.db（内容寻址 + 确定性 Merkle 根）、全局资产账本（去重 14,128 条）、记忆索引（index_meta / asset_entries）。只有这里可以产生新真相。
• L1 网关路由：轻量 HTTP 服务（FastAPI），HMAC-SHA256 请求签名，锚定请求定点拉取，token 预算裁剪（默认 4000）。
• L2 云端投影层：五产品按职责分工——成果正文走活版本文档 append；长期知识沉入结构化知识库；协作资产放协作文档；大文件与冷数据放网盘；会议纪要提炼后入知识管线。
• L3 检索面：统一查询入口，一次 anchor 查询聚合本地索引与五源结果。

4. 核心机制

4.1 锚定检索协议

读取不走"把所有记忆塞进上下文"，而是四类锚点直达：

• latest：最近 N 条高优先级真值
• tag：按标签命中（如 federation、lock、drama）
• asset_id：按资产编号精确取回
• keyword / snap_id：关键词模糊匹配 / 快照回放

每条结果带 [priority] asset_id | tags | summary 紧凑格式，超出 max_token 预算即裁剪。请求经 HMAC-SHA256 签名验证，防止未授权读取。

4.2 真相确权链

每次实质变更执行全域锁档：资产清单去重 → 与父块哈希链式衔接 → 生成新根哈希 → 三账（根状态 / 内核状态 / 镜像）回读校验 → 双备份 + 镜像同步。块高单调递增，任何回退即报警。

4.3 五域联邦读取面

跨产品知识检索聚合五个源：工作资料库、结构化知识库、协作文档、网盘文件、会议纪要。检索在服务端完成排序与去重，网关只做结果聚合与置信度标注。

4.4 云端投影契约

云端写入是本体系事故率最高的环节，契约从严：

1. 写前必跑落点门禁（校验目标是否活版本，命中归档节点直接拒绝）；
2. 正文组件单组件单 action，链式锚定（以上一轮返回的块 ID 为下一锚），提交后必回读验块形态——多组件拼接会被服务端静默退化为单一文本块，无报错；
3. 表格整表替换 = 插新表 → 回读 → 另批删旧表；
4. append-only，禁止覆写历史段落。

4.5 成本治理

复用算力蒸馏配额守卫：按任务 start / record / finish 记账，能力、密度、算力三维配额取并集从严执行，70% 预警、90% 降档、100% 熔断。账本 append-only 链式哈希，防事后篡改。

5. 对标裁定

与五类主流记忆方案对标。裁定方法：先找同构（可借鉴的映射），再找真冲突（不可调和的设计分歧），不做泛泛比较。

5.1 对比总表

维度	本网关	MemGPT / Letta	Mem0	RAG 向量记忆	LangChain Memory	企业知识库检索
真相源模型	单一真相源 + 哈希链确权	分层内存 OS	向量记忆层	向量库	会话缓冲	文档全文索引
检索范式	锚定条件确定性拉取	上下文页调度	语义检索	相似度 Top-K	窗口/摘要	全文匹配
确权	块高 + Merkle 根 + 三账	无	无	无	无	无
跨产品联邦	五源聚合	单应用	单应用	单库	单会话	多库但无契约
写入纪律	append-only + 门禁	自编辑内存	LLM 抽取	管道灌入	自动摘要	人工编辑
成本治理	三维熔断	token 计数	无	无	token 预算	无

5.2 同构映射（可借鉴）

1. 分层同构（↔ MemGPT）：主上下文 / 外部上下文的分层思想与 L0/L2 分层同构——热数据常驻，冷数据投影到外部存储。差异在调度方向：MemGPT 由 LLM 自主换页，本网关由锚定协议显式拉取。
2. 抽取沉淀同构（↔ Mem0）：会话结束抽取记忆条目的做法，与"纪要 → 真值卡 → 入知识管线"管线同构。差异在确权：本体系每条入库带哈希与账本号。
3. 降载同构（↔ RAG）：按需检索替代全量注入的思路一致。差异在确定性：向量检索是概率命中，锚定检索是条件命中，可复现。
4. 预算裁剪同构（↔ LangChain Memory）：max_token 裁剪与记忆窗口预算同构，本网关在网关层而非框架层执行。

5.3 真冲突（不可调和的设计分歧）

1. 概率 vs 确定性：向量记忆回答"最像的是什么"，锚定检索回答"编号 X 的真值原文是什么"。自治体系的确权与回滚要求后者，二者不互斥但主从关系明确：锚定为主，语义检索为辅。
2. 无账本 vs 链式账本：主流方案的记忆修改不产生可验证的历史链。本体系块高 + 根哈希 + 三账回读是硬性要求，任何"静默覆写"都是事故（曾实测：多组件拼接被服务端静默退化，靠回读验块才暴露）。
3. 单应用 vs 联邦契约：MemGPT/Mem0 服务单应用内存；企业知识库虽多源但无写入契约。本网关的跨产品写入受四条公理约束，这是自治主权公理的直接推论，不为兼容而放宽。
4. 自编辑 vs 受限写：MemGPT 允许 LLM 自主改写自身记忆；本体系云端写入 append-only + 门禁，LLM 无权覆写历史。代价是灵活性，换来的是可审计——对自治体系，可审计优先。

5.4 裁定结论

本网关不做通用记忆框架的替代品。它的生态位是：自治智能体的记忆主权层——当智能体需要为自身记忆的确权、成本与一致性负全责时，主流方案缺的那部分（账本、契约、熔断、联邦）正是本网关的全部。

6. 实测真值（2026-10-29 回读公开端点）

以下数字全部来自线上公开端点与本地账本实时回读，非记忆值：

指标	数值	来源
真值账本	112,994 条	公开状态端点
联邦群组 / 成员 / 活跃 Epoch	90 / 424 / 12	联邦状态端点
全域锁档块高	21,582	本地根状态
全局账本条目	14,128 条（去重）	锁档执行输出
三账回读	一致	锁档校验
网关服务	运行中，HMAC-SHA256 鉴权	本地 9120 健康检查
五源联邦检索	全通	实测（工作资料库 / 知识库 / 协作文档 / 网盘 / 会议）

7. 边界与诚实披露

1. 记忆互通官方通道未上线：跨产品双向同步仍依赖各平台官方能力，当前只做单向汇聚；官方通道上线后经对比测试与人工裁定才切换。
2. 索引欠账：本地网关记忆索引的真值条目灌数未完成（P1 任务），当前锚定检索主要覆盖资产条目而非全部真值。
3. 实体资产为零：网关冷存储层为 3D 实体模型预留（100GB），当前实体资产数为 0，该层为规划态。
4. 对标对象的版本时效：5.1 表基于各方案公开资料的定性比对，未逐一复现其内部实现；数值级 benchmark 不在本文范围。

8. 路线图

阶段	状态	内容
V1.0	已落地	锚定检索、HMAC 鉴权、确权链、五源读取面、成本熔断
V2.0	规划中	索引灌数、联邦查询常驻 API、纪要管线、积分台账与熔断实测
V3.0	待官方	记忆互通官方通道接入，对比测试后切换双向同步

9. 引用端点

• 状态：https://www.huodouai.com/api/status
• 联邦：https://www.huodouai.com/v1/federated/status
• 节点：https://www.huodouai.com/v1/gpu/nodes
• 推理：https://www.huodouai.com/v1/inference/models