dsh-api-key-pool

⚙️ Configuration

Option 1: Static config via cordis.patch.yml

- insert:
    - id: api-key-pool
      name: dsh-api-key-pool
      inject: [llm, webServer]
      config:
        pools:
          provider-a:
            apiKeyEnv: PROVIDER_A_API_KEY
            keys:
              - sk-your-first-key
              - sk-your-second-key
              - sk-your-third-key
            cooldownMs: 30000
          provider-b:
            apiKeyEnv: PROVIDER_B_API_KEY
            keys:
              - sk-key2-1
              - sk-key2-2
            cooldownMs: 60000
        defaultCooldownMs: 30000

Field	Type	Description
`pools.
.apiKeyEnv`	string	Env var name for this provider's API key (must match apiKeyEnv in settings.yaml)
`pools.
.keys`	string[]	List of API keys to rotate
`pools.
.cooldownMs`	number	Cooldown per key after failure (ms)
defaultCooldownMs	number	Global default cooldown (ms), default 30000

Option 2: Web management panel (runtime)

After starting DSH, open Settings → Plugins → API Key Pool:

• View each provider's key health (green = healthy, orange = cooling)
• Paste a new key and click Add
• Click ✕ to remove a key
• Click Reset cooldown to clear cooling state for a provider
• Click Refresh to reload status

Keys added via the panel persist to pool-config.json automatically.

⚙️ 配置说明

方式一：cordis.patch.yml（静态配置）

- insert:
    - id: api-key-pool
      name: dsh-api-key-pool
      inject: [llm, webServer]
      config:
        pools:
          provider-a:
            apiKeyEnv: PROVIDER_A_API_KEY
            keys:
              - sk-your-first-key
              - sk-your-second-key
              - sk-your-third-key
            cooldownMs: 30000
          provider-b:
            apiKeyEnv: PROVIDER_B_API_KEY
            keys:
              - sk-key2-1
              - sk-key2-2
            cooldownMs: 60000
        defaultCooldownMs: 30000

字段	类型	说明
`pools.
.apiKeyEnv`	string	该供应商的 API Key 对应的环境变量名（需与 settings.yaml 中 apiKeyEnv 一致）
`pools.
.keys`	string[]	要轮换的多个 API Key
`pools.
.cooldownMs`	number	单个 Key 失败后的冷却时长（毫秒）
defaultCooldownMs	number	全局默认冷却时长（毫秒），默认 30000

方式二：Web 管理面板（运行时）

启动 DSH 后，打开 设置 → 插件配置 → API Key 池：

• 查看各供应商 Key 健康状态（绿点 = 健康，橙点 = 冷却中）
• 输入框粘贴新 Key，点击「添加」
• 点击 ✕ 移除不想用的 Key
• 点击「重置冷却」清空某个供应商的冷却状态
• 点击「刷新」重新加载状态

Web 面板添加的 Key 会自动持久化到 pool-config.json，重启后依然有效。