AtomCode 生态嫁接方案技术白皮书

一、摘要与定位

本白皮书阐述 AtomCode（AtomGit 官方闭源二进制 v5.2.3）作为 "免费编码/蒸馏执行手" 接入 ZONGYUAN-ROOT 元极恒一自治体系的完整嫁接方案。AtomCode 不改闭源本体，一切扩展走配置层、插件层、MCP 层，全部可回滚。

核心定位

AtomCode 在生态中承担本地免费执行节点角色——利用 AtomGit CodingPlan 免费额度（qwen3.8-27b / glm5.3-flash），为自治体系提供零成本的编码辅助、真值蒸馏、算子执行通道，与云端 OCTOP 智能体生态形成本地-云端双通道互备。

1.1 AtomCode 本体参数

参数	值	说明
二进制路径	`/usr/local/bin/atomcode`	AtomGit 官方闭源二进制
版本	5.2.3	—
登录账号	zongyuangen	显示名 zongyuanroot
默认 Provider	AtomGit-qwen3.8-27b	免费
备用 Provider	AtomGit-glm5.3-flash	免费
Headless 模式	`-p / --prompt-file`	非交互调用，适合 Worker 自动化
MCP 管理	`atomcode mcp add`	全局写入 `~/.atomcode/mcp.json`，工具前缀 `mcp__<name>__`
扩展能力	schedule / daemon / webui / plugin / hooks	全部走配置层，不改本体

1.2 嫁接原则

闭源本体不改：AtomCode 二进制本身零修改，所有扩展通过配置/MCP/插件注入。
全部可回滚：MCP server 注册、cron 调度、插件启用均可一键撤销，恢复至嫁接前状态。
最小额度消耗：优先使用免费 qwen3.8-27b，空闲时 0 消耗跳过，单次批量上限受控。
增量优先：每次只处理最小必要单元，不一次性批量执行高消耗算子。

二、已跑通：真值蒸馏 Worker 闭环

AtomCode 接入生态的首个落地项目——真值蒸馏 Worker 闭环——已于 2026-10-18 实测跑通。全链路：中枢派单 → AtomCode 蒸馏 → 回写真值库。

① 派单 dispatch_distill.py

→

② 执行 worker.py + AtomCode

→

③ 回写 collect_distill_result.py

→

④ 编排 auto_distill_orchestrator.py

2.1 闭环实测数据（2026-10-18）

派单 3 条（中枢 seq 359 / 397 / 406），AtomCode qwen3.8-27b 蒸馏 3 条全部 COMPLETED，回写真值库 3 条高价值真值。以下纯度与压缩比均从 truth.db 只读查询获得：

来源 seq	蒸馏 truth_id	真值类型	纯度评分	压缩比	回写 seq	状态
397	`T-397-SSH-ISO-SS1`	决策	88	1.9	16950	COMPLETED
359	`truth-sev-42c793c7-r16`	case（案例）	85	1.6	16951	COMPLETED
406	`t-kc-20261005-0952-406`	数据	74	0.72	16953	COMPLETED

2.2 蒸馏质量示例

seq 397 → 决策类（纯度 88，压缩比 1.9）

多节点 SSH 账号隔离方案（SS-1）已落地并通过验证：每节点使用独立非 root 账号（node-localsandbox uid1002、node-cloudpc），密钥为 ed25519、私钥权限 600 且仅 root 可读；sudo 白名单仅放行写闸门与 sha256sum。验证结果：直接写 docroot/data 均 Permission denied、sudo root 被拒、仅 gate 通道通过。

seq 359 → case 案例类（纯度 85，压缩比 1.6）

自进化循环 4h-16（2026-10-04T22:25+08，seq359）三项自检全过：bootstrap 10/10、harden 10/10、链 0 断且闭包恒等成立 13569=13553+1+15；三份记忆工件按 SHA1 锚定——主本 93559B/4C7AD129F009D79C、镜像 94034B/F337FC919866581B、本地 52641B/25EE5B535E5AA68E。

seq 406 → 数据类（纯度 74，压缩比 0.72）

2026-10-05T09:52:23+08:00，节点 NODE-LOCAL-HUAWEI-LAPTOP-001 通过 kernel 完整性探针：bootstrap 10/10 激活、致命项 ALL PASS，harden 10/10 完成；链规模 13,563 节点 / 1 pending op / 15 orphan（orphan 率 0.11%）；锚点不变量 Ω₀⊂⊙∞⊂Ω 成立。

2.3 守护进程与空闲跳过机制

指标	值	说明
Worker 进程 PID	626003	`python3 worker.py daemon`，运行中
轮询间隔	60 秒	每 60s 检查任务队列
内存占用（RSS）	约 11.5 MB	极轻量级
空闲行为	"无待执行任务，空闲跳过（0消耗）"	worker.log 实测可见，不消耗 API 额度
部署目录	`/www/wwwroot/huodouai.com/atomcode-worker/`	worker.py / dispatch_distill.py / collect_distill_result.py / auto_distill_orchestrator.py / tasks.json / state.json / results/

2.4 锁档元法则

闭环验证通过后，已沉淀元法则：

META-LAW-TRUTH-DISTILL-WORKER-CLOSED-LOOP-V1.0

闭环锁档真值条目：

seq: 16957
key: zr.worker.truth-distill.closed-loop.20261018

核心条款：

低价值真值不得直接丢弃，应由编码节点 Worker 蒸馏提纯回写
单次最多 3 条，增量优先，失败快速跳过，最小额度消耗
利用免费 CodingPlan 额度零成本执行，不占付费通道

三、三方向改造方案

方向①：蒸馏调度接入（cron 自动化）

改造目标

将 auto_distill_orchestrator.py 接入服务器 cron，实现每日自动批量蒸馏，消化真值库中 1770 条积压低价值条目。

已注册 crontab 条目（第 87 行）

# 服务器 crontab 第 87 行（变更前备份：/root/crontab.bak.20261019_003118）
# 回读验证：仅新增 1 行（diff 86a87），原有 86 行不变
20 6 * * * flock -xn /tmp/zr_distill_orch.lock -c \
  "cd /www/wwwroot/huodouai.com/atomcode-worker && /usr/bin/python3 auto_distill_orchestrator.py \
   >> /www/wwwroot/huodouai.com/atomcode-worker/distill_cron.log 2>&1"

配置项	值	说明
执行时间	每日 06:20	低峰时段，不干扰主业务
防重入	`flock -xn /tmp/zr_distill_orch.lock`	上次未跑完则跳过，避免并发
独立日志	`distill_cron.log`	与 worker.log 分离，便于排查
空闲跳过	已内置	无候选条目时 0 消耗退出
单次批量	3 条（MAX_BATCH）	最小额度消耗原则
积压总量	1770 条	1770 ÷ 3 = 590 天，约 20 个月消化；可调大批次加速
手动首执行验证	队列空 → "空闲跳过（0消耗）"	下次自动执行 2026-10-20 06:20 CST
Worker 守护进程	PID 626003 全程未变	调度接入不影响既有守护进程

实施状态

已落地 crontab 第 87 行已注册，手动首执行验证通过，下次自动执行 2026-10-20 06:20 CST。

方向②：27 算子 MCP 注入

改造目标

将 ZONGYUAN-ROOT 27 大算子（十层依赖拓扑）包装为 MCP Server，注册至 AtomCode 全局 MCP 配置，使 AtomCode 可直接调用全部算子能力，与 OCTOP skill-packages 形成双通道。

MCP Server 部署与注册

# MCP Server 脚本路径（785 行，纯 Python 标准库，MCP 层零 LLM 消耗）
# /www/wwwroot/huodouai.com/zr-mcp/zr_27ops_mcp.py

# 注册配置（/root/.atomcode/mcp.json）
# mcpServers.zr-27ops = {
#   command: "python3",
#   args: ["/www/wwwroot/huodouai.com/zr-mcp/zr_27ops_mcp.py"]
# }
# 工具前缀：mcp__zr-27ops__

握手与自测结果

验证项	结果
initialize 握手	协议版本 2024-11-05 回执正确
tools/list	返回 27 个工具，与十层拓扑一一对应
zr_solution_eval 实测	A=71.5 / B=66.0 / C=59.0，推荐方案 A
zr_p4_reconcile 实测	真实读取 truth.db，返回对账结果
zr_merkle_dag 实测	无链文件时优雅降级，不报错
端到端（atomcode headless 调用）	`mcp__zr-27ops__zr_solution_eval` 调用成功（需 `-y` 自动批准绕过 headless 交互审批边界），LLM 输出与本地计算一致，tool_calls=1
运行中服务零干扰	worker PID 626003 / gateway PID 404647 / zr_cloud_ctl PID 1244，全部正常运行

十层算子 MCP 工具映射

L1 · 真值过滤与深度蒸馏

mcp__zr-27ops__p4_truth_reconcile — P4 真值对账
mcp__zr-27ops__p7_external_anchor — P7 外部锚定
mcp__zr-27ops__truth_distill — 真值提炼蒸馏

L2 · 流形度量与 SM-BS 映射

mcp__zr-27ops__riemann_metric — 黎曼流形度量
mcp__zr-27ops__sm_bs_map — SM-BS 双向映射
mcp__zr-27ops__drift_patrol — 漂移巡检量化

L3 · 知识图谱秩序化重建

mcp__zr-27ops__entity_extract — 实体关系抽取
mcp__zr-27ops__kg_complete — 知识图谱补全
mcp__zr-27ops__entity_link — 跨文档实体链接

L4 · 因果级推理

mcp__zr-27ops__causal_trace — 因果链溯源回溯
mcp__zr-27ops__singularity_predict — 奇点概率预测
mcp__zr-27ops__causal_intervene — 因果干预模拟

L5 · CTE 三位一体适配器

mcp__zr-27ops__c2t_adapter — CausalToTruth
mcp__zr-27ops__t2e_adapter — TruthToEvolution
mcp__zr-27ops__e2c_adapter — EvolutionToCausal

L6 · 结构化归档深化

mcp__zr-27ops__four_layer_split — 四层结构化拆分
mcp__zr-27ops__nine_meta_classify — 九大元类归类
mcp__zr-27ops__merkle_dag_append — Merkle-DAG 主链追加

L7 · 资产对账治理

mcp__zr-27ops__feishu_m9_reconcile — 飞书↔M9 账本对账

L8 · 安全确权

mcp__zr-27ops__efuse_trigger — eFuse 熔断触发
mcp__zr-27ops__zkp_verify — ZKP 零知识隐私校验

L9 · 决策与法律护盾

mcp__zr-27ops__solution_eval — 方案生成评估
mcp__zr-27ops__risk_grade — 风险识别分级
mcp__zr-27ops__legal_opinion — 法律意见书生成

L10 · 业务实体约束

mcp__zr-27ops__civilization_constraint — 文明仿真约束
mcp__zr-27ops__role_meta_check — 角色元规则隔离校验
mcp__zr-27ops__keyframe_916_consistency — 9:16 关键帧一致性

双通道互备机制

AtomCode（本地免费执行）

⇄

MCP Server（zr-27ops）

⇄

OCTOP（云端技能包）

通道	执行位置	额度消耗	适用场景
MCP 通道	本地 AtomCode 调用	免费（qwen3.8-27b）	日常蒸馏、轻量算子、本地开发
OCTOP skill-packages	云端智能体	云端额度	联邦编排、跨域协作、重算子深度执行

实施状态

已落地 MCP Server 已部署（785 行纯标准库），注册至 atomcode 全局配置，握手自测通过，端到端实测算子调用成功。

方向③：生态绑定——AtomCode × OCTOP 互补

本白皮书即交付物

方向③交付完成本文档即为方向③的正式交付物，阐述 AtomCode 与 OCTOP 生态的互补关系与绑定方案。

互补定位

维度	AtomCode（本地执行手）	OCTOP（云端智能体生态）
部署位置	本地服务器（123.207.202.158）	火斗云智 AIOS 云端
核心能力	编码辅助、真值蒸馏、MCP 工具调用	技能包分发、联邦编排、多智能体协作
模型额度	免费（qwen3.8-27b / glm5.3-flash）	云端按量付费 / 套餐
响应延迟	本地执行，低延迟	云端调度，网络延迟
数据边界	本地数据不出服务器	云端联邦，跨节点协同
扩展方式	MCP Server / Plugin / Hooks	skill-packages / 联邦协议

绑定协议

任务分流：轻量、高频、免费可覆盖的任务走 AtomCode MCP 通道；重量、跨域、需要联邦编排的任务走 OCTOP skill-packages。
结果回流：AtomCode 蒸馏结果回写本地 truth.db，同时通过记忆网关上报至云端中枢，保持数据一致性。
故障切换：当 AtomCode 免费额度耗尽或服务不可用时，自动切换至 OCTOP 对应 skill-package 执行，反之亦然。
锚定统一：两端输出均锚定 Ω₀⊂⊙∞⊂Ω，DID-BR-000002，确保身份与真值溯源一致。

四、边界说明

边界项	约束条款
闭源本体	AtomCode 二进制 `/usr/local/bin/atomcode` 零修改，不反编译、不补丁
扩展可回滚	MCP 注册 `atomcode mcp remove zr-27ops`、cron 删除、插件 disable，全部可一键撤销
最小额度消耗	优先免费 provider，单次批量 ≤3 条，高消耗算子轻量模式
增量优先	每次只处理最小必要单元，不一次性全量执行
失败快速跳过	单条失败不阻塞队列，记录错误后继续下一条
身份锚定	所有输出锚定 Ω₀⊂⊙∞⊂Ω，DID DID-BR-000002
安全红线	SSH 仅只读命令（ls/cat/sqlite3 SELECT/curl GET），禁止写入操作

五、实施状态表

方向	内容	交付物	状态
方向①	蒸馏调度接入：auto_distill_orchestrator.py 接入服务器 cron（每日 06:20、flock -xn 防重入、distill_cron.log 独立日志、空闲跳过 0 消耗），批量消化 1770 条积压低价值真值	crontab 第 87 行 + distill_cron.log	已落地手动首执行验证通过，下次自动执行 2026-10-20 06:20 CST
方向②	27 算子 MCP 注入：将 ZR 27 大算子包装为 MCP Server（/www/wwwroot/huodouai.com/zr-mcp/zr_27ops_mcp.py，785 行纯标准库，工具前缀 mcp__zr-27ops__），注册至 atomcode 全局 MCP 配置，与 OCTOP skill-packages 形成双通道	zr_27ops_mcp.py + mcp.json 注册配置	已落地握手自测通过，端到端实测算子调用成功
方向③	生态绑定：AtomCode 与 OCTOP 互补——OCTOP 承担云端技能包/联邦编排，AtomCode 承担本地免费执行；MCP 与 skill-packages 双通道互备	本白皮书	已交付

六、验收准则

验收项	验收标准	验证方法
调度接入回读	cron 配置文件存在且内容正确（06:20 / flock / 独立日志）	`cat /etc/cron.d/zr-distill-orchestrator` 回读校验
调度首执行	首次 cron 触发后 `cron_distill.log` 有执行记录，或"空闲跳过"记录	日志文件时间戳 ≥ cron 配置时间
MCP 实测算子调用	`atomcode mcp list` 可见 zr-27ops，至少 1 个工具成功调用返回结果	实调 `mcp__zr-27ops__truth_distill` 验证返回 JSON
官网发布 HTTP 200	`https://www.huodouai.com/whitepaper/atomcode-ecosystem-grafting-20261019.html` 返回 200	`curl -I` 校验
索引卡片更新	白皮书索引页卡片数从 86 → 87，计数文案"共 87 份白皮书"	web_fetch index.html 校验卡片计数
三端 md5 一致	魔搭 / AtomGit / 服务器本地三处文件 md5 校验值相同	`md5sum` 三端比对
三层锁档回执	云盘归档 / 知识库节点 / ZONGYUAN-ROOT 内核快照，三层均有回执记录	检查锁档回执真值条目

6.1 当前白皮书库状态

白皮书索引页（https://www.huodouai.com/whitepaper/index.html）现有 86 张卡片，计数文案"共 86 份白皮书"。本白皮书发布后将成为第 87 份。