@aiform/cli-platform

Hive 平台维护 CLI（hive-platform）—— 通过 hive platform 服务的 HTTP API 管理租户、平台管理员、岗位、技能、new-api 同步队列。不直连数据库。

租户管理员视角的账号/节点动作在另一个包：@aiform/cli-workspace。

安装

npm i -g @aiform/cli-platform       # 或 pnpm add -g / npx @aiform/cli-platform

配置

| 选项 | 环境变量 | 默认 | 用途 | |---|---|---|---| | --url <url> | PLATFORM_URL | http://localhost:3100（本地 dev） | platform base URL | | --email <email> | HIVE_ADMIN_EMAIL | —（多数命令必填） | 登录用 platform admin email | | --password <pw> | HIVE_ADMIN_PASSWORD | 无则交互输入 | 登录密码 | | --bootstrap-token <t> | PLATFORM_BOOTSTRAP_TOKEN | — | 仅 platform admin add 用（首位 admin 还不存在、无 session 时） |

线上 platform：https://platform.hiv.aiform.com（对应 workspace：https://app.hiv.aiform.com）。 PLATFORM_BOOTSTRAP_TOKEN 也要配在 platform 服务端（启用 POST /api/platform-admins）。

子命令

export PLATFORM_URL=https://platform.hiv.aiform.com   # 本地 dev 省略，默认 http://localhost:3100

# 引导首位 platform 管理员（不需要登录，用 bootstrap token）
PLATFORM_BOOTSTRAP_TOKEN=... hive-platform platform admin add [email protected]

# 之后用该 admin 登录做其它操作
export [email protected] HIVE_ADMIN_PASSWORD=...

# 租户（POST/GET /api/tenants）
hive-platform tenant add 'Acme Intelligence' --handle acme.co --plan pro --owner [email protected] --seats 50 --logo https://cdn.acme.co/logo.png
hive-platform tenant list

# 代某租户管理 workspace 成员（POST/GET /api/tenants/:id/users）——引导租户首位成员等
hive-platform tenant user add [email protected] --tenant acme.co --password 'init-pw-123'
hive-platform tenant user list --tenant acme.co

# new-api 同步队列（POST /api/newapi-outbox/drain、GET /api/newapi-outbox、POST /api/newapi-outbox/:id/requeue）
hive-platform outbox drain
hive-platform outbox list --pending
hive-platform outbox list --dead
hive-platform outbox requeue <id>

# 岗位（/api/positions*）
hive-platform position add 'Data Analyst' --code DATA_ANALYST --capability sql --skill <skillId> --publish
hive-platform position list --status published
hive-platform position publish <positionId>
hive-platform position archive <positionId>
hive-platform position enable  <positionId> --tenant acme.co
hive-platform position disable <positionId> --tenant acme.co

# 技能发布（多文件文件夹 → POST /api/skills + /versions）
hive-platform skill publish ./my-skill-folder --name my_skill --version 1.2.0 --label 'My Skill'

退码

0 成功；1 API/网络错误；2 参数错误；130 交互输入被 Ctrl-C 取消。