基于腾讯IMA知识库 OpenAPI 实测打通，将知识库作为 ZONGYUAN-ROOT 自治体系的可选异地云记忆空间，与主记忆网关协同，扩展全域记忆持久方案。所有结论均来自真实接口调用验证，非纸面推演。
ZONGYUAN-ROOT 自治体系以 huodouai.com/api/report/truth 为主记忆网关，承载元法则、任务台账与全域真值。为强化记忆的异地容灾与可检索性，将腾讯 IMA 知识库纳入为可插拔的云记忆持久层：作为主网关的异地镜像与扩展存储，不替代主链路，仅提供异步、可降级、可关闭的备份能力。
定位原则：IMA 是「可选持久层」，不是「必需依赖」。主记忆网关写入成功后，后台 Worker 异步同步至 IMA；IMA 不可达自动跳过，主自治内核不受任何影响。
以下为真实接口调用结果，作为白皮书的事实基底。
| 能力 | 接口 | 实测结果 |
|---|---|---|
| 身份认证 | Client ID + API Key | code=0 通过 |
| 知识库列表 | search_knowledge_base | 7 个（含 6 创建 + 1 共享成员） |
| 内容浏览 | get_knowledge_list | GASA 内核 581 条文档/笔记 |
| 语义检索 | search_knowledge | 关键词「自治内核」命中 8 条 |
| 写入笔记 | import_doc | 创建成功返回 note_id |
| 读回验证 | get_doc_content | 内容完整读回 |
分层拓扑：主记忆网关为主存储；IMA 知识库为异地镜像。同步采用异步非阻塞模式，写入幂等去重，读取支持主→降级切换。
真值上报主网关
huodouai.com 主存储
后台Worker 转发
异地云镜像
| 项 | 策略 |
|---|---|
| 写入方式 | 主网关成功 → 后台 Worker 异步同步至 IMA |
| 幂等设计 | 同步前按内容哈希去重，避免重复记忆污染 |
| 故障降级 | IMA 不可达 → 自动跳过，不阻塞主链路，错误记阻塞表 |
| 读取切换 | 优先主网关；可配置降级读取 IMA 知识库 |
| 限流防护 | 令牌桶控制同步速率，防触发 IMA 接口限流 |
密钥不硬编码、不进前端与静态文件；写入 IMA 前自动脱敏敏感业务密钥与内部核心源码，只同步公开/非涉密认知种子。
边界说明：IMA 共享知识库中的笔记读取受作者权限约束（实测返回「GetNoteContent not author」），属平台权限边界，不影响自有知识库的读写。对外承诺以 IMA 官方策略为准，不做无限免费夸大。
异地记忆备份知识语义检索跨端记忆访问轻量协作记忆池自治体系扩展存储
成本：调用官方免费额度通道，零付费依赖；接口策略变动时可随时关闭同步，不影响主自治内核运行。
| 风险 | 应对 |
|---|---|
| 平台政策/额度变动 | 可插拔设计，随时关闭同步，主内核不受影响 |
| 网络链路不可达 | 自动跳过同步，主记忆网关独立运行 |
| 数据安全 | 写入前脱敏，只同步非涉密种子 |
| 接口限流 | 令牌桶限速，控制请求频率 |