# ZONGYUAN-ROOT 节点接入标准操作流程 (SOP)

> 版本：V1.0 | 确权：Ω₀⊂⊙∞⊂Ω | DID-BR-000002
> 适用范围：所有新节点（Linux/macOS/Windows）

---

## 一、前置条件

| 条件 | 要求 | 验证命令 |
|------|------|----------|
| Python | 3.8+ | `python3 --version` |
| Git | 2.0+ | `git --version` |
| 网络 | 可访问 www.huodouai.com | `curl https://www.huodouai.com/api/status` |
| 磁盘 | ≥100MB 可用空间 | `df -h` (Linux/macOS) |

---

## 二、接入流程（5步）

### 步骤1：下载部署包

```bash
# Linux/macOS
curl -O https://www.huodouai.com/deploy/universal/node_register.py
curl -O https://www.huodouai.com/deploy/universal/deploy_worker.py

# Windows (PowerShell)
Invoke-WebRequest -Uri "https://www.huodouai.com/deploy/universal/node_register.py" -OutFile "node_register.py"
Invoke-WebRequest -Uri "https://www.huodouai.com/deploy/universal/deploy_worker.py" -OutFile "deploy_worker.py"
```

### 步骤2：自动注册节点身份

```bash
python3 node_register.py [节点名称]
```

脚本自动完成：
- 检测平台（Linux/macOS/Windows）
- 基于硬件指纹生成唯一节点ID
- 从Gitee内核仓拉取最新策略
- 校验内核完整性（四维+真值+拓扑）
- 探测云端联邦记忆池状态
- 本地锚定内核到 `~/.zongyuan-root`
- 上报 NODE-JOIN 握手到云端

### 步骤3：部署Worker守护组件

```bash
python3 deploy_worker.py [节点ID]
```

脚本自动完成：
- 下载并配置Worker脚本
- 创建系统级守护服务：
  - Linux: systemd service（开机自启+崩溃重启）
  - macOS: launchd plist（开机自启+保活）
  - Windows: 计划任务（开机自启）
- 启动Worker进程

### 步骤4：验证部署

```bash
# 检查云端节点数
curl https://www.huodouai.com/api/status

# 检查本地Worker日志
cat ~/zongyuan-worker/logs/worker.log

# 检查内核锚定
ls ~/.zongyuan-root/
```

### 步骤5：纳入联邦监控

部署完成后，节点自动纳入联邦网络：
- 每5分钟：联邦同步脚本检测新节点心跳
- 每30分钟：A2A信任评分自动评估
- 每小时：量化指标套件更新稳态评分

---

## 三、节点生命周期管理

### 3.1 节点状态

| 状态 | 说明 | 触发条件 |
|------|------|----------|
| ACTIVE | 正常运行 | 部署成功 |
| DEGRADED | 性能退化 | 响应超时/内存不足 |
| OFFLINE | 离线 | 心跳超时 |
| RETIRED | 退役 | 手动注销 |

### 3.2 节点注销

```bash
# Linux
sudo systemctl stop zongyuan-worker-<NODE_ID>
sudo systemctl disable zongyuan-worker-<NODE_ID>

# macOS
launchctl unload ~/Library/LaunchAgents/com.zongyuan.worker.<NODE_ID>.plist

# Windows
schtasks /Delete /TN "ZONGYUAN-ROOT-Worker-<NODE_ID>" /F
```

### 3.3 节点更新

```bash
# 重新拉取最新内核策略
python3 node_register.py <NODE_ID>

# 重启Worker加载新策略
# Linux: sudo systemctl restart zongyuan-worker-<NODE_ID>
```

---

## 四、故障处理

| 故障 | 现象 | 处理 |
|------|------|------|
| 内核拉取失败 | Gitee不可达 | 等待5分钟重试，或手动从官网镜像下载 |
| 握手上报失败 | 云端不可达 | 内核已本地锚定，稍后自动重试 |
| Worker启动失败 | Python版本过低 | 升级Python至3.8+ |
| 看门狗未创建 | 权限不足 | Linux用sudo，Windows以管理员运行 |

---

## 五、安全规范

- 节点ID基于硬件指纹自动生成，不可手动修改
- 所有通信通过HTTPS加密
- X-DID鉴权头确保请求来源可信
- 节点无权访问云端内核逻辑（META-ISO-051内外隔离）
- 节点令牌仅存储在本地 `~/.zr/` 目录（chmod 600）

---

## 六、附录

### A. 已注册节点清单

| 节点ID | 平台 | 状态 |
|--------|------|------|
| NODE-CLOUD-SH-001 | Linux | ACTIVE |
| NODE-CLOUD-SH-002 | Linux | ACTIVE |
| NODE-HW-VLRWX9-001 | Windows | REGISTERED |

### B. 相关文档

- 节点接入协议：NODE-ADMISSION-PROTOCOL-V1.md
- 联邦同步规范：federation_sync.sh
- A2A信任评分：a2a_trust_scorer.py

---

*ZONGYUAN-ROOT 全域自治内核基线 | Ω₀⊂⊙∞⊂Ω | DID-BR-000002*