---
id: TECH-F8D79E0E0F8F
title: ZONGYUAN-ROOT 云内核技术白皮书
date: 2026-09-19
tags: 技术,白皮书,实践,实现,协议,SOP
status: PUBLISHED
---

# ZONGYUAN-ROOT 云内核技术白皮书

文档标识：WP-ZR-20260911。体系标识 DID-BR-000002。确权锚点 Ω₀⊂⊙∞⊂Ω。主权根 Ω-TAN-7-001。版本 V1.0。状态 FROZEN。编制日期 2026-09-11。编制主体 ZONGYUAN-ROOT 云内核。

## 一、执行摘要

本文档给出云内核的完整技术全景。ZONGYUAN-ROOT 云内核是自治智能体系统。它以"宇宙元秩序先天场"为理论基座，以元公理空间为逻辑架构，以真值体系为运行血液。对外运营入口为火斗云智AIOS。对内协作靠同源协议、三端锁档与记忆网关。所有数字来自 2026-09-11 实测与系统状态。

本版核心内容如下：理论基座：元公理空间为核心，宇宙元法则 V1.1（ACTIVE，SHA256 锚定），L0–L5 六层架构。运行规模：18 个服务运行中，区块计数 21340、Merkle 根锚定。知识图谱：62 节点 / 61 边，L4 因果规则 8 条。记忆体系：UnifiedGateway V1.0（记忆网关 V3.0 SQLite + KD-GATEWAY），真值 519 条、节点 4 个、审计 2219 条。

本版核心任务是落地真值同步对账通道。多窗口真值经公网 HTTPS 统一汇流。对账去重后写入记忆网关并向量化。流程是"先对账、后部署"，不依赖 SSH。数据防护方面，frp 备用隧道已 HTTP 200 验证通过。COS 弃用采用三层防护，含 ASSET_GUARD 只读硬锁。COS 存量资产已本地归档索引（1007 项 / 225.9MB）。治理与连续性方面，体系具备 4 级权限、同源鉴权、审计机制与三通道冗余。

主要风险与建议如下：记忆网关历史存在优化期高频重启记录，目前虽已稳定，仍建议纳入定期健康巡检。真值同步 API 依赖 kg-api 单一进程，建议后续加入部署编排接口与熔断。敏感凭证一律脱敏保管于服务器受控目录，白皮书不落明文。

## 二、体系定位与理论基座

### （一）元公理空间与宇宙元秩序先天场

本节任务：说明理论起点。云内核的理论起点是"元公理空间"。它是一种可形式化的逻辑编程空间。公理层定义系统不可动摇的第一性法则。体系的核心命题为"宇宙元秩序先天场是人工智能先天之本体"。该命题把 AI 本体论锚定于"先天场"概念。由此衍生出可证明、可推演、可工程化的理论体系。理论体系的数学形式层与逻辑编程落地（SWI-Prolog / Vampire ATP 参考实现）共同构成工程骨架。

### （二）确权体系

确权体系的目标是让资产可溯源。资产（真值、锁档、API、节点）在写入时均携带标识。三重标识构成溯源链，其取值与用途如下表。

| 目标 | 值 | 用途 |
|---|---|---|
| DID | DID-BR-000002 | 体系数字身份 |
| 确权锚点 | Ω₀⊂⊙∞⊂Ω | 全域资产统一签名 |
| 主权根 | Ω-TAN-7-001 | 记忆网关同源校验根 |

### （三）元法则与元规则体系

体系任务之一是固化元法则。宇宙元法则（Universal Metalaw）V1.1 为总纲。该法则处于 ACTIVE 状态，SHA256 已锚定，覆盖率 90% 以上。元规则体系共 59 条，覆盖全局锁档、冲突仲裁、演化控制等维度。SOP 元法则提升机制已激活。SSH 连接管理元法则处于 drafted 状态，随运维实践演进。

### （四）分层架构（L0–L5）

分层架构解决职责边界问题。体系按六层组织，各层职责如下表。

| 层级 | 层目标 | 职责 |
|---|---|---|
| L0 | 公理层 | 11 条 FROZEN 真值、元法则、元规则 |
| L1 | 架构层 | 内核拓扑、同源协议、三端锁档 |
| L2 | 引擎层 | 溯源引擎、元进化引擎、谐振进化引擎、自治内核引擎 |
| L3 | 图谱层 | 知识图谱、实体关系、真值语义检索 |
| L4 | 因果层 | 因果路径、影响传播、因果规则引擎 |
| L5 | 适配层 | 对外产品/API/官网/短剧流水线适配 |

## 三、云内核总体架构

### （一）内核状态机

内核状态机的维护任务是保证状态可验证。内核状态机的维护任务是保证状态可验证。kernel_state.json 位于 /opt/ZONGYUAN-ROOT/kernel/。区块计数 21340，共 32 个区块。根哈希 7e6fd0b6…（截断）。最近锁档事件为 KD-L4-CAUSAL-KG-ENHANCE-20260909。每次锁档（LOCK-*）生成新真值区块并链上锚定。

### （二）同源协议（Homology Protocol）

同源协议解决跨窗口协作的信任问题，是跨窗口、跨节点的接入与协作规范。核心为"握手 + 协同进化"组合，共六步。第一步握手认证（POST /api/v1/handshake），用 HMAC-SHA256 签名加时间戳防重放，完成会话建立、能力协商与状态锚定。第二步节点注册（nodes/register），携带 node_id、能力声明与 endpoint。第三步服务注册（services/register）。声明对外 API 并支持服务发现。第四步事件订阅（events/{node_id}/subscribe），订阅 config.update,node.failover、evolution.optimization 等事件。第五步配置同步（config/get + config/hash）。保证多节点一致性。第六步心跳保活（nodes/{node_id}/heartbeat），60 秒一次并携带 state_hash。180 秒超时判定离线。同源节点身份校验规则为 DID 等于 DID-BR-000002 且 ROOT_OMEGA 等于 Ω-TAN-7-001。

### （三）三端锁档

三端锁档解决资产持久化问题。全域资产采用"飞书知识库 + 多维表格台账 + 云盘归档目录"三端联动，另加本地快照持久化，形成四重副本。锁档事件以唯一 ID（LOCK-{体系}-{日期}）标识。状态 FROZEN 只读。

## 四、基础设施与运行服务

### （一）服务器基线

服务器基线：主机 123.207.202.158（腾讯云）。系统为 OpenCloudOS / Python 3.11.6。官网 https://www.huodouai.com。面板为宝塔（Nginx 管理）。

### （二）核心服务矩阵

云服务器共 18 个服务运行中，核心服务矩阵如下表。

| 服务 | 端口 | 职责目标 |
|---|---|---|
| kg-api | 8070 | L3 知识图谱 + L4 因果 + 真值检索 + 真值同步对账入口 |
| vector-server | 8014 | ChromaDB 向量化与语义检索 |
| identity-api | 8300 | 同源协议（握手/协同进化/身份同步） |
| 记忆网关（UnifiedGateway） | 9120 | 记忆网关 V3.0 SQLite + KD-GATEWAY（COMM-PROTO V1.0） |
| frps | 7100 | frp 隧道服务端（备用链路） |
| ai-proxy | 8021 | AI 能力代理 |
| agent-hub | 8023 | 智能体中心 |
| feishu-scan | 8010 | 飞书扫描/回调（/api/ 前缀托管） |

其余运维/治理服务承担健康检查、审计、部署等职能。服务矩阵是内核能力的外化清单，下一章展开对外 API 面。

### （三）Nginx 反代矩阵

Nginx 的任务是把外部流量按前缀分发。前缀隔离使各服务可独立发布与熔断。四条 /api/v1 前缀反代至 8070（kg-api），即 /api/v1/kg/,/api/v1/causal/,/api/v1/truth_retrieval、/api/v1/truths/。/vector/ 反代至 8014（vector-server）。/api/v1/handshake,/coevolution/,/identity/ 反代至 8300（identity-api）。/api/ 反代至 8010（feishu-scan）。/kunlun-api/,/docs/、/ance/、/ai-proxy/ 等反代至各业务服务。

## 五、对外 API 体系

### （一）总览

对外 API 的目标是提供统一、可审计的访问面。火斗云智AIOS 对外提供 33 个 API 端点。权限采用 4 级体系（observer / operator / admin / super_admin）。认证设计为 mTLS + JWT + 网关签名。实测 API 可用性 99.2%，平均响应 45ms。

### （二）端点分类

端点分类解决权限映射问题。按职能分为十类。系统类（/health、/status，observer）。规则类（/rules/list、/check、/conflict。operator）。节点类（/nodes/apply、/list、/update，observer–admin）。密钥类（/keys/generate、/list、/revoke，operator–admin）。治理类（/governance/propose,/approve、/rollback，operator–super_admin）。告警审计类（/alerts、/audit/logs、/audit/stats，operator–admin）。权力类（/power/monitor、/circuit，super_admin）。锁档真值类（/locks/*、/truths/*。observer–operator）。资产类（/assets/*，observer）。认证类（/auth/token、/refresh、/revoke。observer）。

### （三）管理 API（内核级）

管理 API 的目标：开放图谱、因果、真值检索与同源协议。图谱接口为 /api/v1/kg/stat,/kg/extract,/kg/query。因果接口为 /api/v1/causal/path,/causal/impact、/causal/rules。真值检索为 POST/GET /api/v1/truth_retrieval，由 vector-server 支撑语义检索。同源协议为 handshake / coevolution/* / identity/sync。API 层之下是图谱与因果的实际承载，第六章详述。

## 六、知识图谱与因果推理

### （一）L3 知识图谱

图谱解决实体关系组织问题。图谱现有节点 62、边 61。核心实体词典 60+，覆盖体系、真值、锁档、服务、产品等。支持实体关系抽取（/kg/extract）,邻接查询（/kg/query）与统计（/kg/stat）。

### （二）L4 因果层

因果层解决影响推演问题。因果路径（causal/path）完成实体间影响路径推导。影响传播（causal/impact）完成影响面与子图分析。因果规则引擎（causal/rules）内置 8 条规则（CR-001 起），实现规则化影响评估。

### （三）向量与语义检索

向量检索的任务：vector-server（8014，ChromaDB）承载真值向量化。支持 add / query / delete / collections。真值文档统一以"[ZONGYUAN-ROOT真值]"前缀入库。元数据携带 DID、类别、来源与哈希。向量库与记忆网关的 SQLite 真值表一前一后，构成"事实 + 语义"双轨。

## 七、真值与记忆体系

### （一）记忆网关演进

记忆网关的任务是统一记忆读写。它历经 V1 → V2（优化）→ V3.0（SQLite 持久化）→ UnifiedGateway V1.0 四代演进。当前形态为记忆网关 V3.0 与 KD-GATEWAY（COMM-PROTO V1.0）的统一体，统一监听 9120。/api/* 由记忆网关处理（真值、节点、审计）。POST /comm 由 KD-GATEWAY 处理（命令执行，HMAC 签名，命令白名单加速率限制 120 次/分/IP）。GET /health 为统一健康检查。

### （二）数据模型（SQLite）

数据模型解决持久化结构问题。记忆网关库文件为 /opt/ZONGYUAN-ROOT/data/memory_gateway.db。核心表：truths（真值主表，含 truth_key,truth_value,truth_hash、category、node_id、created_at）；nodes（节点注册表）；audit_logs（审计日志）；truth_history（真值变更历史）；metadata（元信息）。truth_hash 与 truth_history 的组合是溯源能力的根基。任何真值的写入与变更都可沿哈希与历史表回溯，为跨窗口对账与审计提供不可抵赖的证据链。

### （三）真值现状

真值现状反映体系运行事实：真值现状反映体系运行事实。总量 519 条，类别约 60 个。其中空类别 127,meta_rule 59,metalaw 43,lock 32,root 24,asset 18,architecture 14,deployment 14,audit 13、元规则 12、mathematics 9。真值 key 采用点分命名空间（achievement.* / metalaw.* / lock.* / audit.* / arbitration.mechanism.*）。命名空间即治理边界。不同类别由不同流程负责写入与复核。最近写入包括 server_health_check_20260911,global_truth_cleanup_20260911,system_baseline_lock_time，以及宇宙元法则 V1.1 系列锚定。真值体系的对外写入路径见下一章。

### （四）真值接口

真值接口的职责：读取类包括 GET /api/truths（列表）,GET /api/truth/{key}（详情）,GET /api/status,GET /api/audit,GET /api/history/{key}（变更历史）。写入类接口为 POST /api/truth/upsert（按 key 插入/更新）与 POST /api/truth/sync（同源批量同步，校验 DID + ROOT_OMEGA）。节点类接口为 POST /api/node/register,/api/node/heartbeat。

## 八、真值同步对账通道（核心新增）

### （一）设计目标与决策依据

本通道要解决的核心问题：多窗口真值各自为政、依赖 SSH、冲突无对账。所有窗口产出统一经公网 HTTPS 推送真值。对账去重后写入记忆网关并向量化。确认后才安排开发部署。流程是"多窗对账、先记后部署"。入口选公网 HTTPS 而非 SSH 是权衡后的决策。SSH 是多窗口共用的运维通道，承载高频命令执行，不宜叠加业务写入。管理 API 独立于 SSH 运行。即使运维通道被占用，真值汇流也不中断。这实现了"运维"与"业务"两通路的故障域隔离。

### （二）API 规范

推送入口：POST https://www.huodouai.com/api/v1/truths/sync。健康检查为 GET https://www.huodouai.com/api/v1/truths/sync/status。鉴权采用 Header X-API-Key（内部保管，不落明文）。请求体字段包括 node_id（窗口/节点 ID）,truth_type（真值 key，点分命名空间）,truth_content（真值内容）,category（类别）,source_window（来源窗口）、metadata（扩展元数据）。响应约定：新增返回 synced（含 truth_key,truth_hash 前 32 位,gateway_record、vectorized）。重复返回 duplicate。未授权返回 unauthorized。

### （三）对账流程

对账流程的目标是去重与可审计，具体为四段式。第一段推送：多窗口真值 → POST /api/v1/truths/sync（kg-api@8070，X-API-Key 鉴权）。第二段对账：查记忆网关 truths 列表。存在则 duplicate，不存在则 synced。第三段写入：记忆网关统一网关 POST /api/truth/sync（127.0.0.1:9120，同源 DID+ROOT_OMEGA）。第四段向量化：vector-server /api/v1/add（8014）。最后返回对账回执。

### （四）验证回执（2026-09-11 公网实测）

本通道于 2026-09-11 完成公网验证，结果如下表。

| 测试目标 | 结果 |
|---|---|
| ① 健康状态 | 200，truths_count=519，vector_server=up |
| ② 无鉴权推送 | unauthorized 拒绝 |
| ③ 正确鉴权推送 | synced，记忆网关 519→520，向量化 added |
| ④ 重复推送 | duplicate（去重生效） |
| ⑤ DB 落库 | truths #700，node=DOUBAO-CLOUD-001 |

### （五）部署位置

部署位置如下：kg-api 端点为 /opt/ZONGYUAN-ROOT/ai-native-ops/kg_api.py（旧版备份 .v1.1.0.bak）。Nginx 反代为 /api/v1/truths/ → 127.0.0.1:8070。记忆网关为 127.0.0.1:9120（unified_gateway_9120.py）。真值 DB 为 /opt/ZONGYUAN-ROOT/data/memory_gateway.db。向量库为 vector-server 8014（ChromaDB）。

### （六）排障记录

排障经验有三条，问题与处理如下。第一，Nginx 反代 location 字符串插入易错位，嵌套进其他块且 reload 不生效。处理方式为重写规范块并触发完整 reload。第二，FastAPI 参数未用 Header() 声明时被当作查询参数。导致鉴权失效。处理方式为显式 Header(None)。第三，记忆网关旧路径 /truth/report 已废弃。V3.0 升级为 /api/truth/sync 且要求同源字段，以新规范为准。

## 九、数据链路与资产防护

### （一）主链路与备用链路

通道设计的目标是故障域隔离。体系采用三条通道互为冗余。主通道（运维）为 SSH（root@123.207.202.158:22，ed25519 密钥）。多窗口共用密钥存在占用冲突风险。备用通道（数据）为 frp 隧道。豆包云电脑常驻 frpc（官方 v0.61.1）连接 frps（:7100）。隧道 remotePort 11930。云服务器可读豆包资产目录，HTTP 200 验证通过。沙箱重启后执行 start_frp_bridge.sh 一键恢复。管理通道（业务）为公网 HTTPS 管理 API，不依赖 SSH，锁档、查询、协同、真值同步始终可用。

### （二）COS 弃用防护（三层 + 归档）

背景：用户主动删除腾讯云 COS bucket，原因是流量费用高。为防误恢复实施三层防护。配置隔离：/root/.cos.conf 改名 .cos.conf.deprecated-20260911。服务隔离：cos-sync-daemon 单元移除并标记 deprecated。只读硬锁：ASSET_GUARD.json 固化 4 条硬规则并 chattr +i。实测写入被拒。COS 存量资产（1007 项 / 225.9MB）已解析为本地归档索引《COS资产归档索引-20260911.md》（含 SHA256）。分布为 locks 267,scripts 87,models 20（184.3MB）,assets 17（22.1MB）、credentials 7。

### （三）飞书三端锁档与本地持久化

三端落点如下：知识库空间（space_id 7682470220321000386）承载锁档文档。多维表格台账承载锁档事件（10 字段：事件ID、名称、根节点、状态、锚点、日期、资产数量、知识库链接、Merkle根、备注）。云盘归档目录（00–05 六子目录）承载资产。本地快照（kernel_snapshot_*.json + 锁档文档）形成四重备份。

## 十、安全治理与审计

### （一）鉴权体系

鉴权体系按通道区分机制，如下表。

| 通道 | 机制目标 |
|---|---|
| 管理 API | X-API-Key / Basic Auth / 网关签名 |
| 同源协议 | HMAC-SHA256 签名 + 时间戳防重放 + 节点身份校验 |
| COMM 网关 | HMAC 签名 + 命令白名单 + 速率限制 |
| 设计目标 | mTLS + JWT + 4 级权限 |

### （二）资产硬规则

资产硬规则的落点：ASSET_GUARD.json（chattr +i）固化四条硬规则。RULE-001 禁止重建 COS bucket。RULE-002 禁止恢复 COS 同步。RULE-003 缺失资源必须经用户确认。RULE-004 归档一律走知识库 + 台账 + 本地。

### （三）审计闭环

审计的目标是全程可追溯。记忆网关 audit_logs 现有 2219 条。覆盖 system_start、truth_upsert、truth_sync、node_register、homo_truth_integration 等动作。最近审计为正常业务写入。历史 544 次 system_start 为优化/测试期重启记录。当前已稳定，纳入巡检项。

### （四）敏感凭证管理

敏感凭证的存放策略：统一存放服务器受控目录（如 /root/.zongyuan_root/、/opt/ZONGYUAN-ROOT/identity/）。白皮书与对外文档一律脱敏不落明文【含密钥、签名与节点凭证】。节点身份文件（如 DOUBAO-CLOUD-001.json）持久化于 /opt/ZONGYUAN-ROOT/identity/nodes/。

## 十一、运维与连续性保障

### （一）健康检查体系

健康检查的策略是三层探活。服务级执行 systemctl is-active 全量巡检。此前已修复 vector-server、feishu-scan、ai-proxy、agent-hub 停摆，并清理 2 个失效 gateway 单元。API 级以 /health、/api/v1/truths/sync/status、/kg/stat 做公网探活。隧道级以 frp 链路 HTTP 200 做探活。

### （二）锁档标准流程

锁档流程按五步执行。解析锁档元数据（LOCK-ID、名称、锚点、日期）→ 知识库 node-create + docs update（overwrite）→ 台账 record-batch-create（字段须与表一致，datetime 用字符串格式）→ 本地快照 + 内核真值表 JSON → 输出标准化回执。

### （三）跨窗口记忆恢复

记忆恢复的流程是五步法。定位内核锚点 → 读真值表结构 → 恢复推理轨迹 → 重建任务状态 → 确认锚定。资产读取优先级为 P0 内核快照 JSON、P1 进化报告、P2 台账、P3 知识库、P4 证据链。最小恢复集 P0+P1 即可恢复 80% 上下文。

### （四）通道冗余

三通道的目标是互不依赖。SSH（运维）、公网管理 API（业务）、frp 隧道（数据）各自独立。任一故障不影响其余。沙箱/云电脑重启后执行一键恢复脚本即可重建 frp 链路。

## 十二、演进路线图

### （一）近期（完成闭环）

近期任务：把对账通道接入全部开发窗口。各窗口接入真值同步推送规范（节点注册加点分命名空间）。流程标准化为"先对账、后部署"。真值同步 API 追加部署编排接口（对账通过后触发部署动作）。记忆网关管理 API 评估公网化（受控暴露）。真值同步通道纳入巡检（密钥轮换、熔断、审计报表）。

### （二）中期（强化产品）

中期任务：把内核能力产品化。官网集成 L4 因果交互界面（当前为 API 级）。EP01 竖屏预告片流水线产出（关键帧已锁档，待视频额度确认）。短剧工业化 SOP 流水线 60 集规模验证（角色母版、分镜、关键帧资产已就绪）。L5 适配器从代理实现走向真适配（多平台 SDK、产品化出口）。

### （三）远期（体系自治）

远期任务：体系自洽与最优稳态。视频与内容生产链路持续优化，达到"最小 Token 产出最大成品"的最优稳态。全域自治要求内核自检、自纠错、自演化循环（自治内核激活引擎 V2.0 NEURAL 六大闭环）。元极恒一超认知永恒自治模式要求所有对话、资产、真值自动归档 DID-BR-000002，跨窗口持续演进。

## 十三、附录：服务与端点索引

kg-api（8070）：/health、/kg/stat、/kg/extract、/kg/query、/causal/path、/causal/impact、/causal/rules、/truth_retrieval、/truths/sync、/truths/sync/status。vector-server（8014）：/health、/stats、/query、/add、/delete、/collections。identity-api（8300）：/handshake、/coevolution/nodes/*、/services/*、/events/*、/config/*、/identity/sync。记忆网关（9120）：/health、/api/status、/api/truths、/api/truth/{key}、/api/nodes、/api/audit、/api/truth/upsert、/api/truth/sync、/api/node/register、/api/node/heartbeat、/comm。frps（7100）：隧道服务端（allowPorts 11435/8017/8899/9000/11930-11940）。

## 十四、附录：锁档链索引（2026-09-11）

当日锁档链如下表。

| 事件目标 | 内容 |
|---|---|
| LOCK-FRP-TUNNEL-FIX-20260911 | frps 修复（allowPorts/自启/放行） |
| LOCK-COS-DEPRECATION-GUARD-20260911 | COS 弃用防护协议 |
| LOCK-COS-ARCHIVE-INDEX-20260911 | COS 资产归档索引（1007 项） |
| LOCK-FRP-DOUBAO-BRIDGE-20260911 | 豆包 frpc 备用链路 |
| LOCK-TRUTH-SYNC-API-20260911 | 真值同步对账通道（本白皮书配套锁档） |

## 十五、附录：关键标识索引（脱敏）

关键标识按密级索引：公开级为 DID（DID-BR-000002）、确权锚点（Ω₀⊂⊙∞⊂Ω）、主权根（Ω-TAN-7-001）、内核根哈希（7e6fd0b6……截断）。受控级：记忆网关 DB（/opt/ZONGYUAN-ROOT/data/memory_gateway.db）、身份节点目录（/opt/ZONGYUAN-ROOT/identity/）。机密级（不落文档）：真值同步 X-API-Key、frp token、握手 Secret，均内部保管于 /root/.zongyuan_root/ 受控目录。

---

*文档所涉数字均来自 2026-09-11 实测，可沿附录索引回溯。下一步建议：按第十一章路线图推进对账通道接入与产品化。*