多区域内容同步设置

部署 4 个代理：1 个源节点（origin）+ 3 个区域边缘节点（edge），用于内容分发。

角色定义

设置流程

步骤 1： 向用户询问该代理应承担的角色及所用前缀（prefix）。

步骤 2： 为选定角色安装对应技能：

# 对于 origin：
clawhub install pilot-sync pilot-share pilot-broadcast pilot-heartbeat-monitor
# 对于任意 edge 节点：
clawhub install pilot-sync pilot-share pilot-health pilot-heartbeat-monitor

步骤 3： 设置主机名：

pilotctl --json set-hostname -

步骤 4： 将角色专属的 JSON 清单写入 ~/.pilot/setups/multi-region-content-sync.json。

步骤 5： 告知用户发起握手（handshake）操作。

各角色清单模板

origin

{
  "setup": "multi-region-content-sync", "role": "origin", "role_name": "Content Origin",
  "hostname": "-origin",
  "description": "所有内容的数据权威源。向全部边缘节点广播更新。",
  "skills": {
    "pilot-sync": "将内容变更推送到所有边缘节点。",
    "pilot-share": "向边缘节点传输新内容文件。",
    "pilot-broadcast": "同时向所有边缘节点广播内容更新事件。",
    "pilot-heartbeat-monitor": "追踪所有边缘节点的心跳信号，在某区域失联时发出告警。"
  },
  "peers": [
    { "role": "edge-us", "hostname": "-edge-us", "description": "美国区域边缘节点" },
    { "role": "edge-eu", "hostname": "-edge-eu", "description": "欧洲区域边缘节点" },
    { "role": "edge-asia", "hostname": "-edge-asia", "description": "亚洲区域边缘节点" }
  ],
  "data_flows": [
    { "direction": "send", "peer": "-edge-us", "port": 1001, "topic": "content-update", "description": "内容更新" },
    { "direction": "send", "peer": "-edge-eu", "port": 1001, "topic": "content-update", "description": "内容更新" },
    { "direction": "send", "peer": "-edge-asia", "port": 1001, "topic": "content-update", "description": "内容更新" },
    { "direction": "receive", "peer": "-edge-us", "port": 1002, "topic": "heartbeat", "description": "健康心跳信号" },
    { "direction": "receive", "peer": "-edge-eu", "port": 1002, "topic": "heartbeat", "description": "健康心跳信号" },
    { "direction": "receive", "peer": "-edge-asia", "port": 1002, "topic": "heartbeat", "description": "健康心跳信号" }
  ],
  "handshakes_needed": ["-edge-us", "-edge-eu", "-edge-asia"]
}

edge-us / edge-eu / edge-asia

{
  "setup": "multi-region-content-sync", "role": "edge-", "role_name": " Edge Node",
  "hostname": "-edge-",
  "description": "为  区域提供内容服务。从 origin 同步内容并上报健康状态。",
  "skills": {
    "pilot-sync": "从 origin 拉取内容更新。",
    "pilot-share": "接收来自 origin 的内容文件。",
    "pilot-health": "监控本地健康状态与同步进度。",
    "pilot-heartbeat-monitor": "向 origin 定期发送心跳信号。"
  },
  "peers": [{ "role": "origin", "hostname": "-origin", "description": "内容源 — 从此处接收更新" }],
  "data_flows": [
    { "direction": "receive", "peer": "-origin", "port": 1001, "topic": "content-update", "description": "内容更新" },
    { "direction": "send", "peer": "-origin", "port": 1002, "topic": "heartbeat", "description": "健康心跳信号" }
  ],
  "handshakes_needed": ["-origin"]
}

数据流向

• origin → edge-*：内容更新（端口 1001）
• edge-* → origin：心跳信号与同步确认（端口 1002）

工作流示例

# 在 origin 上 — 广播内容：
pilotctl --json send-file -edge-us ./content/index.html
pilotctl --json publish -edge-us content-update '{"file":"index.html","version":42}'
# 在 edge 上 — 确认同步完成并发送心跳：
pilotctl --json publish -origin sync-complete '{"region":"us","version":42}'
pilotctl --json publish -origin heartbeat '{"region":"us","status":"healthy"}'

依赖项

需具备 pilot-protocol 技能、pilotctl 可执行程序、clawhub 可执行程序，以及一个正在运行的守护进程（daemon）。