@aiform/cli-workspace

Hive 租户管理员 CLI（hive-workspace）—— 以租户 admin/owner 身份登录 hive workspace 服务的 HTTP API，管理账号与节点。不直连数据库。

平台维护动作（建租户 / 平台管理员 / 岗位 / 技能 / new-api 同步）在另一个包：@aiform/cli-platform。

安装

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

配置

| 选项 | 环境变量 | 默认 | |---|---|---| | --url <url> | WORKSPACE_URL | http://localhost:3000（本地 dev） | | --email <email> | HIVE_WS_EMAIL | —（必填） | | --password <pw> | HIVE_WS_PASSWORD | 无则交互输入 |

线上 workspace：https://app.hiv.aiform.com

export WORKSPACE_URL=https://app.hiv.aiform.com
export [email protected]
export HIVE_WS_PASSWORD='...'

子命令

# 在当前登录管理员所属租户下新增成员（POST /api/members）
hive-workspace user add [email protected] --slug maya --role member
hive-workspace user add [email protected] --password 'init-pw-123'   # 不传 --password 则交互输入

# 列出当前租户成员
hive-workspace user list

# 创建工作区（POST /api/workspaces）—— 默认 node；--type app 建出站-only App（需 admin）
hive-workspace workspace add prod-edge                  # node：含子域名 + 6 位激活码
hive-workspace workspace add my-app --type app          # app：无子域名/无隧道，仅出站接入

# 当前登录账号自己的节点（GET /api/nodes、DELETE /api/nodes/:id）
hive-workspace nodes list
hive-workspace nodes revoke <nodeId>      # 服务端会重写 chisel-authfile + reload

注意：nodes 子命令操作的是当前登录账号自己的节点（API 是用户级作用域）；user add 只能加 admin/member，owner 易主走 workspace UI。租户的首位成员一般由平台侧创建（hive-platform tenant user add 或 platform UI）。

workspace add 输出 activationCode（1h 内有效，仅此一次）：node 同时给 subdomain/relayPort；app 给 API Base URL，由 App 端用激活码换取长期 token（App 不暴露公网、仅出站调 /api/wb/*）。--type app 需以租户 admin 登录（否则服务端 403）。

退码

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