用途:CreatiBI 命令行工具的初始化与认证基础模块,用于首次配置应用凭证、完成登录授权、查看当前身份,以及处理权限不足或 Token 过期等问题。
安装:npm install -g @creatibi/cbi-cli@latest,支持 macOS、Linux、Windows 的 amd64/arm64。
主要能力与用法:
- 配置初始化:cbi config init 交互式初始化;cbi config init --new 强制覆盖已有配置;cbi config init --device 使用设备码模式,适合 VPS/服务器。回调模式会启动本地 8080 端口回调服务器并自动打开浏览器;设备码模式显示验证 URL 和验证码,轮询等待授权,有效期 15 分钟。前提是在 CreatiBI 开放平台创建应用,获取 client_id 和 client_secret。
- 查看配置:cbi config show,-v 显示登录凭证,--format json 输出 JSON。
- 登录授权:cbi auth login,需先完成 config init;支持授权码模式(桌面环境)与设备码模式(VPS/服务器),可用 cbi auth login --device 或设置环境变量 CBI_LOGIN_MODE=device。
- 身份与退出:cbi auth whoami 查看当前身份,-v 显示 token 信息;cbi auth logout 退出登录。
- 错误处理:遇到 permission denied 或 auth required 时,依次执行 cbi config show、cbi config init、cbi auth login、cbi auth whoami;Token 过期时重新执行 cbi auth login;配置异常时用 cbi config init --new 后重新登录。
配置存储于 ~/.cbi/config.json,包含 base_url、client_id、client_secret、api_key、refresh_token、token_expires_at 等字段。通用参数包括 --config <path>、-f/--format(json/table)、-v/--verbose。
限制:需先在开放平台创建应用获取凭证;回调模式依赖本地浏览器与 8080 端口;设备码模式需在浏览器手动确认授权。其他功能细节暂未提供。