Technical Whitepaper

终端编码智能体
对接云端中枢记忆网关

基于开源 AtomCode 的三层增强（Skills / MCP / .atomcode.md），在不动源码前提下为编码智能体注入云端记忆、真值蒸馏、全域锁档能力，构建国产自主编码智能体。

技术路线 方案 B（Skill 层集成） 许可证 MIT 仓库 zongyuangen/zongyuancode-config 锚定 Ω₀⊂⊙∞⊂Ω

MCP 工具

M1→M2 演进

6/6

端到端测试

全 PASS

ZR Skills

zr-* 六件套

384

记忆向量维度

ernie 引擎

背景与定位

为什么做 ZongyuanCode

单个模型有天花板；多智能体瓶颈在组织方式而非模型本身；主流编码 Agent 会话上下文无法跨会话延续，知识无法沉淀。

定位

终端 AI 编码智能体 + 云端中枢记忆网关 + 联邦 Worker 调度。既是 AtomCode 生态增强版，又是 ZONGYUAN-ROOT 面向开发者/技术服务的对外能力出口。

技术架构：三层增强机制

ATOMCODE 核心

Smart Agent LoopRead→Edit→Run→Verify代码图谱 8 工具多 Provider

ZR 增强层（不动源码）

Skills · zr-* 六件套MCP Server · 5 工具.atomcode.md 规范

ZONGYUAN-ROOT 云端中枢

真值库 truth.db记忆池 memory锁档/发布引擎联邦 Worker

MCP 工具矩阵（M1→M2 演进）

工具	功能	通道	里程碑
zr_ping	通道健康探测	POST /api/report/truth	M1
zr_truth_report	真值上报（主备降级）	POST /api/report/truth	M1
zr_truth_query	真值检索	GET /api/truth	M2
zr_memory_get	记忆向量检索	GET /api/memory-search	M2
zr_memory_set	记忆写入（MEMORY.前缀）	POST /api/report/truth	M2

M2 记忆打通：记忆网关闭环

zr_memory_set 写入

POST /api/report/truth，key 自动加 MEMORY. 前缀

真值库落库

truth.db，seq 单调递增，写读即时可见

zr_truth_query 检索

GET /api/truth?search=，关键词命中刚写入记忆

zr_memory_get 向量召回

GET /api/memory-search?q=&k=，ernie-text-embedding 384 维语义命中

跨会话记忆延续

记忆网关闭环完成，知识跨会话沉淀

写读闭环实测（真实 seq 证据）

zr_memory_set 'MEMORY.zongyuancode-m2-e2e'   → seq=189546（写库）
zr_truth_query 'ZongyuanCode'                  → count=10，即时命中
zr_memory_get 'ZONGYUAN-ROOT' k=2              → score 0.58 语义召回

开发里程碑

M0 · 研究完成

AtomCode 全套资料学习

确定方案 B（Skill/Plugin 层集成）→ 验证后方案 A（Fork）

M1 · 增强包完成

ZR Skills + MCP server + .atomcode.md

zongyuancode-config 仓库，修复 MCP 帧读取阻塞 bug

M2 · 记忆打通完成

zr_memory 工具对接云端记忆池

记忆网关闭环，E2E 6/6 PASS，seq 189545-189548

M3 · 规划

Fork AtomCode 深度集成

新增 ZR Provider / 工具，依赖真实运行环境端到端验证

M4 · 进行中

产品化：白皮书 + 官网展示页 + 多平台推送

本白皮书 + 可视化页 + 魔搭/AtomGit 推送

验证与证据

seq	key	说明
189538	LOCK.ZONGYUANCODE-M1.20261026	M1 正式锁档
189546	MEMORY.zongyuancode-m2-e2e	M2 记忆写入闭环
189547	LOCK.ZONGYUANCODE-M2.MCP-E2E.20261026	M2 MCP 端到端
189548	LOCK.ZONGYUANCODE-M2.20261026	M2 正式锁档

关键修复

M1：MCP server 三 bug + `_read_frame` 按字符读导致多字节 UTF-8 阻塞 → 改 `sys.stdin.buffer` 按字节精确读取 + 全局 socket 超时 + handler 线程护栏。

M2：真值查询端点 `/api/truths/`（复数 404）→ 正确路径 `/api/truth`，并新增 `/api/memory-search` 向量检索通道。

部署与使用

一键接入 ZR 能力（3 步）

git clone https://atomgit.com/zongyuangen/zongyuancode-config.git ~/.atomcode/zongyuancode-config
mkdir -p ~/.atomcode/skills && cp -r ~/.atomcode/zongyuancode-config/skills/* ~/.atomcode/skills/
cp ~/.atomcode/zongyuancode-config/.mcp.json ~/.atomcode/mcp.json

AtomCode 内：/zr- 前缀调用全部 skill · /mcp reload 加载 MCP server · 模型自动触发 use_skill

终端编码智能体对接云端中枢记忆网关