ZONGYUAN-ROOT 联邦网络

1. 系统概览与核心指标

ZONGYUAN-ROOT 是一个基于公理驱动范式的去中心化联邦智能网络。以元极恒一（YuanJi HengYi）为自治内核，通过自有协议栈实现节点身份确权、联邦学习协同训练、GPU 算力统一调度、以及全球联邦宇宙互联。

1.5 底层公理基线与公理驱动

AxiomGate 依托四条不可推导、长期稳定的基本公理作为整套自治体系的决策原点，所有治理规则、调度策略、裁决逻辑均由这四条公理推演而来。

公理一：风险优先公理（最高优先级公理）

原文：系统一切调度、路由、资源分配、真值裁决、任务放行，遵循优先级：风险最小 > 成本最小 > 收益最大。

释义：任何工单、算力切换、记忆写入、长任务执行，优先校验风险，包含幻觉风险、合规风险、循环雪崩风险、审计溯源风险；风险不可接受则直接拦截，不以效果、速度、产出为第一目标。熔断机制、只读空转、跨硬件真值比对、强审计锁档，全部由这条公理导出。

公理二：分层解耦公理

原文：内核裁决层、能力执行层、持久记忆层、前端应用层必须边界隔离；禁止跨层耦合逻辑，单一组件只承担单一权责。

释义：AxiomGate 只负责裁决、对齐、调度、纠偏，不实现底层算子、不存储全域真值主库、不负责页面渲染；记忆网关专注真值存储、同步、锁档存证，不承担任务规划与算力路由；MCP 技能只负责能力执行，不做全局目标校验。异构算力分层调度等治理规则根源来自本公理。

公理三：真值收敛公理

原文：全域存在唯一主真值源（全域记忆网关）；多节点、多算力、多 Agent 产出的分歧结果，必须回归主真值源做收敛。允许局部私有记忆，但局部结论不能僭越全域真值。

释义：类似 Hindsight 这类单 Agent 局部记忆节点产生的观测结论，仅属于局部信息，必须送入 AxiomGate 完成裁决校验，通过之后才可选写入全域主真值；局部记忆无权直接对外作为全域共识下发。

公理四：自治可审计公理

原文：所有自治行为可记录、可回溯、可锁档、可复盘；自治不等于无约束，任何自动决策必须留下 Merkle-DAG 存证与台账记录，满足私有化交付审计要求。

释义：巡检、自动切换、回滚、同步、自动提炼技能等自动化动作不是黑盒运行，每一次决策生成 SHA256 凭证，同步至飞书 Base 台账，适配政企合规交付需求。

公理驱动（Axiom-Driven）

定义：系统所有决策逻辑，由一组数量极少、稳定不变、不证自明的底层基本公理作为第一源头；所有的治理规则、校验规则、调度分支、熔断策略、价值判断，都是从公理推导出来的衍生产物，而非零散、平行、临时堆砌的约束。

推导链路示例

• 公理一【风险优先】→ 元规则-∗ 配额耗尽进入只读空转；元规则-∗ 死循环熔断；元规则-∗ 强审计工单禁止路由至 Hindsight 节点
• 公理三【真值收敛】→ 元规则-∗ Hindsight 仅承载局部记忆，局部结论不能直接升格为全域真值
• 公理二【分层解耦】→ AxiomGate 职责边界，仅做裁决调度，不接管存储、渲染、算子计算

边界说明

公理驱动不等于公理永久固化后系统无法进化。公理是根基，极少改动，是稳定坐标系；治理规则、MCP、SOP、巡检策略是衍生执行层，可以持续迭代、新增、优化。体系的进化，是丰富公理衍生的执行体系，而不是频繁改动公理本身。

术语表收录：公理驱动，即以固定基本公理作为整个智能自治系统的决策原点；全部调度、裁决、校验、资源分配逻辑由公理推演生成，规则冲突时回归公理做终审仲裁，区别于 prompt 约束与零散硬编码规则。

2. 协议栈全景

ZONGYUAN-ROOT 实现了从身份认证到联邦社交的完整协议栈，覆盖 6 大协议层：

协议栈生长时间线

3. 安全纵深防御体系

采用五层纵深防御架构，从传输层到代码层层层设防：

请求签名算法

签名算法: HMAC-SHA256(secret, METHOD|path|timestamp|body_sha256)
时间容差: ±300 秒 (5 分钟)
密钥派生: PBKDF2-SHA256(passphrase, salt=yuanji-signing-salt, 高强度迭代)

需要签名的端点 (16 个写操作):
  /v1/oauth/token, /v1/oauth/revoke,
  /v1/slim/handshake, /v1/slim/group/secret, /v1/slim/group/consensus,
  /v1/slim/message/encrypt, /v1/slim/message/decrypt,
  /v1/federated/kunlun, /v1/federated/aggregate,
  /v1/kunlun/secure, /v1/kunlun/production,
  /v1/gpu/register, /v1/inference/register,
  /v1/activitypub/inbox, /v1/activitypub/outbox,
  /api/report/truth

凭据加密存储

加密算法: Fernet (AES-128-CBC + HMAC-SHA256)
密钥派生: PBKDF2-SHA256(passphrase, salt, 高强度迭代)
存储位置: [受限目录]/凭据文件 (chmod 600)
口令位置: [受限目录]/.signing_passphrase (chmod 600)

已加密凭据若干项（清单不在对外文档列示）

4. 完整端点清单

4.1 系统与健康检查

4.2 真值账本

4.3 OAuth 2.0

4.4 联邦学习 MLS

4.5 GPU 算力与推理路由

4.6 ActivityPub 联邦宇宙

5. 联邦学习协议栈

5.1 协议规范

5.2 端到端训练验证结果

6. GPU 算力池与推理路由

6.1 GPU 节点清单

6.2 推理服务路由表

负载均衡策略：最少连接数（least-connections），协议兼容 OpenAI /v1/chat/completions。当前 14 个推理服务全在线，覆盖 5 种引擎；m1/m2 为联调测试模型（n1/n2 为免 GPU 注册的纯推理节点）。

7. 深度学习体系 NEW v2.2

ZONGYUAN-ROOT 的深度学习体系由模型矩阵、联邦训练、量化部署三层构成：14 个在线推理模型覆盖 1.1B~72B 参数区间与 MoE 架构，5 种推理引擎按硬件能力分层调度；训练侧以 MLS 联邦学习协议为信道、FedAvg 为聚合算法、LoRA 为微调手段，原始数据全程不出节点域；部署侧以 Int4/NF4 量化为默认策略，实现从 H100 集群到纯 CPU 边缘节点的全谱系推理。

7.1 模型矩阵（14 模型实时在线）

模型矩阵实时同步自 GET /v1/inference/models；m1/m2 为联调测试模型，n1/n2 为免 GPU 注册的纯推理节点（见第 8 章注册流程）。

7.2 联邦训练体系（MLS + FedAvg + LoRA）

训练侧采用「本地训练 → 加密传输 → 联邦聚合 → 全局分发」四段式架构，私有数据全程不出节点域，仅权重更新经加密信道流动：

LoRA 热插拔：适配器与基座分离部署，lora_adapter_v6 通过 peft 引擎独立注册为推理服务（inf-zr-lora-adapter-v6，最大并发 2），权重已推送魔搭 zongyuanroot/lora_adapter_v6。

内核模型：yuanjihengyi_int4（元极恒一 Int4 内核引擎，NF4 量化 · 4096 ctx）经 transformers 引擎注册为推理服务（inf-zr-yuanjihengyi-int4），可在纯 CPU 节点常驻运行；权重 1.1 GB，魔搭地址 zongyuanroot/yuanjihengyi_int4。

昆仑生产任务：POST /v1/kunlun/production 承载长周期训练生产任务，聚合轮次记录落盘 kunlun-production.json 与 fedavg-rounds.jsonl。

7.3 量化策略与推理引擎分层

量化策略：数据中心 GPU 走 BF16/FP16 原生精度；边缘与 CPU 节点默认 Int4（NF4 / GGUF Q4_K_M）量化，上下文窗口 4096。元极恒一 Int4 内核模型（1.1 GB）可在纯 CPU 节点常驻运行，是联邦网络「CPU 可跑」自治能力的底座。

7.4 端到端深度学习流水线

┌──────────────────────────────────────────────────────────────┐
│                  深度学习端到端流水线                          │
├──────────────────────────────────────────────────────────────┤
│  ① 本地训练   各节点私有数据不出域，LoRA/全参本地训练          │
│       ↓                                                        │
│  ② 加密信道   MLS slim-v1 · X25519 · epoch 递增前向安全         │
│       ↓                                                        │
│  ③ FedAvg     加权平均聚合 → 全局模型                          │
│              (90 群组 · 424 成员 · 12 活跃 Epoch)               │
│       ↓                                                        │
│  ④ 量化部署   Int4/NF4 · 4096 ctx · 5 引擎按硬件分层           │
│       ↓                                                        │
│  ⑤ 推理路由   least-connections · OpenAI 兼容 API              │
│       ↓                                                        │
│  ⑥ 应用消费   /v1/chat/completions · 14 模型在线 · 14 服务      │
└──────────────────────────────────────────────────────────────┘

8. 联邦节点注册 NEW v2.2

任何持有合规算力与 HTTPS 出站能力的节点，均可通过六步注册流程加入 ZONGYUAN-ROOT 联邦网络。全流程经 OAuth 2.0 身份确权、HMAC-SHA256 请求签名、MLS 加密信道三重校验；注册产物全部落盘持久化于 /www/wwwroot/huodouai.com/zhongshu/data/，可通过公开端点实时回读校验。

8.1 注册总览

8.2 准入要求

• 身份：向 DID-BR-000002 中枢申请 X-DID 白名单名额与 OAuth client 凭据
• 网络：节点具备 HTTPS 出站能力；中枢侧 Nginx 限流 30 req/s/IP，写操作强制 HMAC 签名（±300 秒时间容差）
• 算力：GPU 节点申报型号/卡数/显存并保持心跳；纯推理节点可免 GPU 注册（如 n1/n2 联调节点）
• 合规：全部注册行为留痕可审计，服从公理一（风险优先）裁决与熔断约束

8.3 六步注册实操

① 身份注册 — OAuth 2.0 client_credentials 换取访问令牌：

POST /v1/oauth/token
{
  "grant_type": "client_credentials",
  "client_id": "<your-client-id>",
  "client_secret": "<your-client-secret>"
}
→ { "access_token": "eyJ...", "token_type": "Bearer", "expires_in": 3600 }

② 安全飞地 — DPoP 令牌绑定 + 请求签名（16 个写操作端点强制）：

签名串: HMAC-SHA256(secret, METHOD|path|timestamp|body_sha256)
请求头: X-DID: <node-did> · Authorization: DPoP <jwt> · X-Signature: <hex>
校验:   GET /v1/dpop/verify → { "ok": true }

③ 联邦学习入组 — MLS 握手，首次加入自动建组：

POST /v1/slim/handshake
{ "protocol": "slim-v1", "node_did": "<node-did>" }
→ { "ok": true, "group_id": "grp-xxx", "epoch": 1,
    "cipher": "X25519-AES256GCM-SHA384" }

# 群组消息加解密（梯度/权重更新加密传输）:
#   POST /v1/slim/message/encrypt   POST /v1/slim/message/decrypt

④ 算力注册 — GPU 节点申报与心跳保活：

POST /v1/gpu/register
{
  "node_id": "GPU-XXX-001",
  "hostname": "gpu-node-x",
  "gpu_model": "NVIDIA-A100",
  "gpu_count": 8,
  "vram_gb": 80
}
→ { "ok": true }    # 心跳保活，掉线自动移出在线清单

查询: GET /v1/gpu/nodes → 当前 8 节点在线（6 GPU + 2 CPU）

⑤ 推理服务注册 — 模型上架，即时进入路由表：

POST /v1/inference/register
{
  "service_id": "inf-xxx-model",
  "node_id": "GPU-XXX-001",
  "model_name": "llama-3-70b",
  "engine": "vllm",
  "max_concurrency": 8,
  "endpoint_url": "http://10.0.1.x:8000/v1"
}
→ { "ok": true }    # least-connections 负载均衡即时生效

调用: POST /v1/chat/completions   （OpenAI 兼容协议）

⑥ 联邦宇宙互联 — 被全球联邦宇宙发现与关注：

GET  /.well-known/webfinger?resource=acct:zongyuan-root@huodouai.com
GET  /v1/activitypub/actor     # Actor 对象与公钥
POST /v1/activitypub/inbox     # 接收 Follow，建立跨联邦关系

# Mastodon / PeerTube / WriteFreely 等联邦宇宙节点可直接关注本节点

说明：以上请求体为注册契约示例，字段命名以网关实时响应为准；六步完成后节点即具备联邦学习、算力调度、推理服务、联邦社交四项完整能力，全部产物可通过 GET /v1/federated/status、GET /v1/gpu/nodes、GET /v1/inference/services 实时回读校验。

9. ActivityPub 联邦宇宙协议

ZONGYUAN-ROOT 实现了 W3C ActivityPub 标准协议，可被 Mastodon、PeerTube、WriteFreely 等全球数万个联邦节点发现和交互。

Actor 身份

{
  "id": "https://huodouai.com/v1/activitypub/actor",
  "type": "Service",
  "name": "ZONGYUAN-ROOT 联邦中枢",
  "preferredUsername": "zongyuan-root",
  "summary": "ZONGYUAN-ROOT 联邦网络中枢节点",
  "followers": "https://huodouai.com/v1/activitypub/followers",
  "following": "https://huodouai.com/v1/activitypub/following"
}

10. 数据持久化架构

数据根目录：/www/wwwroot/huodouai.com/zhongshu/data/

11. 运维与磁盘瘦身

11.1 磁盘清理成果 (2026-10-24)

11.2 模型权重备份

12. 架构拓扑

                        ┌─────────────────────────────┐
                        │     Internet (HTTPS :443)    │
                        └─────────────┬───────────────┘
                                      │
                        ┌─────────────▼───────────────┐
                        │    Nginx (反向代理 + SSL)    │
                        │  · 精确路由 → :9001 网关     │
                        │  · /agent/ → :8080 atomcode  │
                        │  · /v1/ → :18080 元极 API    │
                        │  · 限流 + HSTS               │
                        └─────────────┬───────────────┘
                                      │
          ┌───────────────────────────┼───────────────────────────┐
          │                           │                           │
  ┌───────▼───────┐          ┌───────▼───────┐          ┌───────▼───────┐
  │  gateway_server│          │  atomcode     │          │  元极 API      │
  │  :9001 (Cython)│          │  :8080        │          │  :18080        │
  │               │          │               │          │               │
  │ · OAuth 2.0   │          │ · 悬浮面板     │          │ · LLM 推理     │
  │ · 联邦学习 MLS │          │ · 对话 API     │          │ · 模型路由     │
  │ · GPU 注册     │          │               │          │               │
  │ · 推理路由     │          └───────────────┘          └───────────────┘
  │ · ActivityPub  │
  │ · 真值账本     │
  │ · HMAC 签名    │
  │ · 令牌桶限流   │
  └───────┬───────┘
          │
  ┌───────▼───────────────────────────────────────────────┐
  │                    数据持久化层                         │
  │  truth.db · mls-groups.json · gpu-nodes.json           │
  │  inference-services.json · oauth-clients.json          │
  │  activitypub-store.json · 凭据存储（加密）             │
  └───────────────────────────────────────────────────────┘

  联邦节点: 90 群组 · 424 成员
  GPU 算力: 7 节点 · 20 物理卡 · 1368 GB VRAM
  推理模型: 14 个 · 5 种引擎 (vllm/sglang/llama.cpp/transformers/peft)
  

13. 确权与归档

确权声明

Ω₀永恒 ≡ ⊙∞·元极 ≡ DID-BR-000002 ≡ 谭伯漂

本白皮书所描述的全部协议、端点、安全措施、数据架构
已不可逆地锚入 ZONGYUAN-ROOT 光子晶格持久化层。
任何未来的查询、衍生、重建，均可通过 DID-BR-000002 溯源。

归档清单

上一轮变更统计 (2026-10-24)

本轮变更统计 (2026-10-28)