跳到主要内容

认证与配置

CLI 调用献丑 API 需要 Access Key 和项目 ID。登录后,点击头像菜单中的 Access Key,在弹窗中创建并复制完整 Access Key。

保存凭证

xianchou auth login --key <ACCESS_KEY> --project-id <PROJECT_ID>

可选参数:

参数说明
--key <key>必填,献丑 Access Key
--project-id <projectId>默认项目 ID
--api-url <url>API 地址,默认 https://api.xianchou.com
-o, --output <format>输出格式,支持 textjson,默认 text

凭证默认写入:

~/.xianchou/config.json

配置文件会以当前用户可读写的权限保存。

环境变量

也可以通过环境变量提供配置:

export XIANCHOU_ACCESS_KEY=<ACCESS_KEY>
export XIANCHOU_PROJECT_ID=<PROJECT_ID>
export XIANCHOU_API_URL=https://api.xianchou.com
export XIANCHOU_CONFIG_DIR=~/.xianchou

环境变量优先于配置文件,适合 CI、Agent 或临时脚本使用。

配置优先级

CLI 会按以下顺序解析配置:

  1. 命令参数,例如 --project-id
  2. 环境变量,例如 XIANCHOU_PROJECT_ID
  3. ~/.xianchou/config.json 中保存的值。
  4. 默认值,例如 https://api.xianchou.com