workspace versions
workspace versions 请求 Workflow Server，返回指定 workflow 的远程版本列表。它常用于确认 latest 指向、发布结果和版本在线状态。
命令格式
参数
| 参数 | 说明 |
|---|---|
<workflow> | 远程 workflow 名称。 |
API
| 步骤 | Endpoint |
|---|---|
| 查询版本 | GET /api/workflows/{workflow}/versions |
输出
| 情况 | 输出 |
|---|---|
| 查询成功 | server versions API JSON。 |
| workflow 不存在 | server 返回错误 JSON，退出码为 1。 |
| 未登录 | 输出错误信息，退出码为 1。 |
示例
常见用途
| 场景 | 说明 |
|---|---|
| 发布后确认 | 查看新版本是否生成。 |
| 运行指定版本 | 从 status: "online" 的版本中复制版本号给 run --target。 |
| 下载指定版本 | 从列表中复制版本号给 download --target。 |
版本状态
返回的每个版本包含status、activation、online、runnable 和 latest 字段。preparing 表示发布流程正在准备依赖和 runtime，latest 暂不切换；online 可以运行、Embed 或 Webhook 访问；offline 仍保留数据库和对象存储备份，但运行入口会拒绝访问。管理端可以重新上线离线版本，手动上线的版本不会被默认“最近 3 个自动在线版本”策略自动下线。