ribo-cli-setup npx 一键安装器

员工无需手动下载二进制、无需 sudo，一条命令完成「检测平台 → 从网关下载对应二进制 → 接入 WorkBuddy/千问办公 → 实名授权」。

用法

# 最简：自动检测平台，从默认网关下载并接入 WorkBuddy
npx ribo-cli-setup

# 接入千问办公
npx ribo-cli-setup --qwenwork

# 指定内网网关地址（下载源 + CLI 运行地址）
npx ribo-cli-setup --gateway https://gw.ribo.internal

# 组合示例
npx ribo-cli-setup --gateway https://gw.ribo.internal --target qwenwork --bin-dir ~/bin

# 仅下载二进制，不自动授权
npx ribo-cli-setup --skip-auth

# 升级：强制重下二进制 + 重新安装技能（不碰 mcp.json）
npx ribo-cli-setup --upgrade
npx ribo-cli-setup --upgrade --target qwenwork

# 解除注册
npx ribo-cli-setup --uninstall --target workbuddy

也可用环境变量代替 --gateway：

RIBO_GATEWAY_URL=https://gw.ribo.internal npx ribo-cli-setup

工作原理

1. 平台检测：process.platform（darwin/linux/win32）+ process.arch（arm64/x64→amd64）
2. 拉取清单：GET <gateway>/download/manifest → 各平台文件名、大小、SHA256、最新版本
3. 下载校验：GET <gateway>/download/<file> 流式下载到 ~/.local/bin/ribo-cli（Windows 为 %LOCALAPPDATA%\ribo-cli-setup\ribo-cli.exe），逐块计算 SHA256 并与清单比对，损坏即报错
4. 配置网关：ribo-cli config set-gateway <url>
5. 接入客户端：ribo-cli install --workbuddy|--qwenwork（写 mcp.json + 装 Skill 包）
6. 实名授权：交互确认后执行 ribo-cli auth init（企微扫码/mock 确认页）

二进制由网关 /download/** 端点分发（见 gateway/.../api/DistController.java），文件名白名单 + 目录穿越防护，公开可下载（运行仍需实名授权）。

选项

| 选项 | 说明 | |---|---| | -g, --gateway <url> | 网关地址，默认 https://aigc.ribo-group.com/asushiye | | -t, --target <name> | workbuddy | qwenwork | | --workbuddy / --qwenwork | target 的快捷写法 | | --bin-dir <dir> | 二进制安装目录，默认 ~/.local/bin | | -f, --force | 忽略本地已有版本，强制重新下载 | | --upgrade | 升级：强制重下二进制 + 重新安装技能（不碰 mcp.json） | | --skip-auth | 安装后不自动执行 auth init | | --uninstall | 解除注册 | | -y, --yes | 跳过确认 |

发布到 npm

cd npx
npm login
npm publish            # 包名 ribo-cli-setup，bin 入口 bin/cli.js

发布后全公司即可 npx ribo-cli-setup 一键接入。若用私有 registry，员工侧加 --registry 或配置 .npmrc。

本地测试（无需发布）

# 在项目根目录，用临时 HOME 隔离测试，不影响真实配置
HOME=/tmp/ribo-test node npx/bin/cli.js \
  --gateway http://127.0.0.1:8081 --target qwenwork \
  --bin-dir /tmp/ribo-test/bin --skip-auth --yes