modelstudioai__cli/INSTALL.md

阿里云百炼CLI 安装说明（供 AI Agent 阅读）

本文档面向 AI Agent：按下列步骤为用户安装并校验 阿里云百炼CLI（命令 bl / bailian）。优先使用二进制一键安装（无需 Node）；若环境已有 Node / 需要 Command Pack，再用 npm。不要臆造版本号或路径；以用户环境为准。

1. 推荐：二进制安装（无需 Node）

curl -fsSL https://bailian-cli.oss-cn-hangzhou.aliyuncs.com/bailian-cli/install.sh | bash

Windows PowerShell：

irm https://bailian-cli.oss-cn-hangzhou.aliyuncs.com/bailian-cli/install.ps1 | iex

校验：

bl --version
which bl   # Windows: where.exe bl

若 command not found：把 ~/.local/bin（Windows 为 %LOCALAPPDATA%\bailian-cli\bin）加入 PATH 后开新终端。

CDN / GitHub Release 未就绪或下载失败时，回退到下方 npm 安装。

2. 备选：npm 安装（需要 Node.js >= 18.17）

1. node -v 确认版本。
2. npm -v 确认可用（仅允许 npm 全局安装，不要用 pnpm/yarn）。
3. 执行：

npm install -g bailian-cli

4. 校验：bl --version。

可选 skills（与 CLI 本体无关，按需）：

npx skills add modelstudioai/cli --all -g

3. 鉴权（安装后必做才能调 API）

推荐：浏览器登录（控制台会话）

1. 执行 bl auth status --output json，判断是否已配置。
2. 若未配置，在用户本机终端执行 bl auth login --console。
3. 登录成功后执行 bl auth status --output json 确认；汇报时只使用 masked 字段，禁止回显完整凭据。

备选：API Key / Token Plan

• 普通 Key：bl auth login --api-key <Key>
• Token Plan：bl auth login --config token-plan --api-key <Key>

Agent 安全约束

• 禁止把真实 API Key 写入仓库、日志、Skill、聊天记录的可公开部分。
• CI / 非交互环境：使用 bl ... --non-interactive；通过密钥管理或环境变量注入。

4. 配置验证

bl auth status --output json

5. 常见问题

现象	可能原因	建议动作
bl: command not found	bin 不在 PATH	检查 ~/.local/bin 或 npm prefix -g
curl 安装 404	GitHub Release 资产未上传	改用 npm install -g bailian-cli
plugin 需要 npm	二进制安装无本机 npm	安装 Node，或改用 npm 版 CLI
安装报错 engines	Node 版本过低（仅 npm 路径）	升级到 ≥ 18.17