跳到主要内容

配置说明

路径​

环境路径
macOS / Linux~/.kuaimai-cli/config.yaml
Windows%USERPROFILE%\.kuaimai-cli\config.yaml

同目录还有 registry/registry.json 缓存。配置权限建议 0600；不加密，勿提交 Git。

常用命令​

kuaimai-cli config init
kuaimai-cli config get --output json              # 默认脱敏
kuaimai-cli config get --reveal --output json     # 显示原文，慎用
kuaimai-cli config set <key> <value>

示例：

kuaimai-cli config set "domains.供应链.url" "https://scm3.superboss.cc/"
kuaimai-cli config set shortcuts.erp-item.api_url "https://erp1.superboss.cc/"
kuaimai-cli config set api.gateway_url "https://open-cli.kuaimai.com"

优先级与范围​

  • 业务请求使用本地配置中的网关、domains.*.url、shortcuts.*.api_url
  • web call 的 targetHost：本地 domains 优先，否则 registry baseUrl
  • 不支持多公司 / 多账号 / 多环境切换（单机单套 auth.system + auth.open）
  • 环境变量：如 KUAIMAI_CLI_SKIP_REGISTRY_SYNC=1、安装相关的 KUAIMAI_CLI_PREFER_MIRROR 等（以帮助与安装文档为准）

鉴权字段由 auth login / auth logout 维护，一般不要手改密钥。更完整的迁移说明见仓库文档 docs/本地配置与升级迁移.md。