用途:作为 VPS 智能体环境的公共入口,负责路由与排序,覆盖全新安装、向已有 VPS 添加项目、hex-relay 生命周期、诊断以及集群 plan/apply。它不内联详细安装工作,而是委派给专用运行时工作器并消费其机器可读摘要。
主要能力:按 mode 分类操作(auto、fresh_install、add_project、relay_redeploy、diagnose、fleet_plan、fleet_apply);先做主机发现(SSH 连通性、用户、包、Node/nvm、claude、codex、技能目录、agent-update.timer、服务单元与端口冲突);再依次调用 ln-031 主机运行时、ln-032 项目运行时、ln-033 hex-relay 生命周期、ln-034 环境诊断;最后汇总子摘要。
使用方式:通过 Skill 调用子工作器,例如 Skill(skill: "ln-031-vps-host-runtime", args: "mode={install_or_reconcile|verify_or_update|verify_only} environment_id={environment_id} runId=${childRunId} summaryArtifactPath=${childSummaryArtifactPath}"),并读取子摘要产物。支持 dry_run、registry_path(默认 /etc/agent-fleet/environments)、environment_id、plan_artifact_path、repair_scope 等参数。
适用场景:Ubuntu 24.04(apt + systemd,已在 Contabo、Hetzner、DigitalOcean 测试)上的 VPS 智能体环境引导与运维。
限制:v1 仅支持 push-over-SSH,无持续守护进程/协调器;fleet_apply 不是持续协调器,需在重新检查实时状态后应用已批准计划;仓库 ops/environments 仅为模板,真实集群成员存于 VPS 的 /etc/agent-fleet/environments;注册表文件只能包含密钥引用而非值;项目单元、端口、状态目录和 Telegram bot token 必须按环境唯一;主机引导不可盲目跳过,已有主机须走 verify_or_update。