用途:当单台机器不够用时,用集群编排在多台 wsh 服务器之间分布工作负载,例如在大机器上跑构建、在隔离环境跑测试、在生产主机上部署,从单一 hub 管理整个服务器舰队。
概念:集群包含一个 hub 和若干 backend。用户只与 hub 交互,hub 负责路由、健康监控与结果聚合;backend 是普通 wsh 服务器。每台服务器有唯一 hostname 用于定位目标,backend 连接 hub 时自动获取 hostname。健康状态分为 healthy、connecting、unavailable,只有 healthy 的 backend 参与会话操作,hub 会自动重连。
主要能力:查看服务器列表;通过地址(需带 http:// 或 https:// 方案,可含路径前缀)添加 backend,可选 token;按 hostname 查询或移除服务器;等待 backend 转为 healthy 后再创建会话;在指定服务器上创建会话(不指定则在 hub 本地运行);基于标签跨服务器做扇出、查询与空闲等待;按服务器过滤会话列表;会话创建后发送输入、等待空闲、读取屏幕、终止等操作均由 hub 透明路由。
使用方式:先 list servers 发现集群;用 add server at address … 注册 backend,需要认证时附带 token;轮询列表等待其变为 healthy;再用 create session … on server … 创建远程会话,配合 tag 组织并行任务;通过 wait for idle、read screen 收集结果。若已有 wsh_* 工具(如 wsh_send_input、wsh_get_screen)应直接使用;否则勿猜测端点或 CLI 子命令,先加载完整 API 参考。
适用场景:需要特定硬件、特定网络或隔离环境的任务;超出单机容量的扩展;跨机器的构建—测试—部署流水线。
限制:分布会增加延迟与复杂度,单机可完成时应用多会话而非集群;backend 掉线时其会话在 hub 侧不可访问,会话列表会排除不可用 backend,hub 不迁移会话,需在其他 backend 重建;移除 backend 不会终止其上会话;需注意 token 认证、IP 访问控制(由运营方配置 blocklist/allowlist)、hostname 唯一性。该技能只描述领域模式与决策,不描述 API 调用方式。具体命令示例与计费信息暂未提供。