配置

August 24, 2026 · View on GitHub

插件配置项与默认值(Schemastery schema 定义在 src/config.ts):

配置项类型默认值说明
apiKeyEnvstringCOMMANDCODE_API_KEY凭据引用名(环境变量 / credentials ref)
apiKeystring组合配置字面量 API Key(优先)
apiBasestringhttps://api.commandcode.aiCommand Code API 地址
pollIntervalMsnumber60000轮询间隔(ms)
errorBackoffMsnumber15000失败后退避间隔(ms)
requestTimeoutMsnumber15000单请求超时(ms)
accountConcurrencynumber1每轮多账户并发抓取数(保守默认 1)
accountsarray[]额外账户列表
activeAccountstring固定活动账户 slot id(预留,尚未参与运行时选择)
enableSessionCostbooleantrue是否启用每轮消耗聚合
enableRoutesbooleantrue是否注册 webServer JSON 路由
storagePathstring可选状态持久化路径(尚未实现,预留)

示例

- insert:
    - id: commandcode-usage-monitor
      name: dsh-commandcode-usage-monitor
      config:
        apiKeyEnv: COMMANDCODE_API_KEY
        apiBase: https://api.commandcode.ai
        pollIntervalMs: 60000
        errorBackoffMs: 15000
        requestTimeoutMs: 15000
        accountConcurrency: 1
        enableSessionCost: true
        enableRoutes: true

多账户

config:
  accounts:
    - label: Account A
      apiKeyEnv: COMMANDCODE_API_KEY
    - label: Account B
      apiKeyEnv: COMMANDCODE_API_KEY_2

API Key 解析顺序

  1. config.apiKey(组合配置字面量)
  2. ctx.credentials 服务(若 profile 提供)
  3. 启动环境变量(apiKeyEnv 指定的名字)
  4. 官方 CLI 登录文件 ~/.commandcode/auth.json

实现见 src/credentials.ts