Kubo IPFS Cluster 部署 e2e / 演示 runbook

集群基础设施全链路实测：起栈(3 节点集群 + Caddy)→ 经 cluster 代理上传 → 三节点自动多副本 → 网关渲染 → /artifact 友好路径 → 停节点仍可读 → 收摊。全部用真实 curl / ipfs-cluster-ctl 断言，不靠"应该能跑"。

这是部署 e2e——验"集群本身对不对"。Agent 发布链路（:9097 token 写入口 + skills/publish-artifact/publish.sh + 默认过期）的独立 e2e 见 kubo-publish-e2e 技能 / make publish-e2e。

本项目已无 v1 单节点，统一到 Cluster；"单节点"= 跑 1 节点的集群（见 docs/MULTI_HOST_DEPLOYMENT.md §3.4）。本 runbook 针对单宿主机三容器试验形态（docker-compose.cluster.yml）。

约定与前置

REPO=$(git rev-parse --show-toplevel)
COMPOSE="docker compose -f docker-compose.cluster.yml"   # 单机 3 节点 + Caddy
PROXY=http://localhost:9095     # cluster IPFS 代理 —— Agent 上传打这里
GW=http://localhost:8080        # ipfs0 原生网关 —— /ipfs/<CID>
ART=http://localhost:8088       # Caddy 反代 —— /artifact/<CID>（重写到 /ipfs）
CTL="docker exec cl-cluster0 ipfs-cluster-ctl"           # 集群管理