dsh-plugin-provider-quota

4. 配置 Provider

可以通过 DSH Web 的模型设置添加 Provider 和凭据，也可以编辑 $DSH_HOME/settings.yaml。以下示例同时配置 Kimi 和 Codex：

llm-pi-ai:
  providers:
    kimi-coding:
      apiKeyEnv: KIMI_API_KEY
    openai-codex:
      apiKeyEnv: CODEX_OAUTH_ACCESS_TOKEN

apiKeyEnv 是 DSH 的凭据引用，不是要写入 settings.yaml 的密钥明文。只需保留实际使用的 Provider：

• Kimi：确保 KIMI_API_KEY 能由 DSH credentials 服务或进程环境解析。
• Codex：先安装并登录 dsh-plugin-llm-codex，由它维护 CODEX_OAUTH_ACCESS_TOKEN；本插件只读取消费该令牌，不参与令牌生命周期。
• DeepSeek：无需在 llm-pi-ai.providers 中配置 —— 路由 deepseek-official 由 DSH 自带的 dsh-llm-deepseek 插件注册，默认读取 DEEPSEEK_API_KEY 凭据；本插件调用 GET /user/balance 只读展示余额，不消耗余额。如需覆盖凭据引用，可在 llm-deepseek 命名空间设置 apiKeyEnv。

使用方式

• 将鼠标悬停在读数上，可查看各额度窗口的剩余、已用和重置时间。
• 点击读数，可展开 Provider 详情浮层（渲染在 shell.overlay 图层，侧边栏收起为窄栏时同样可用）。
• 点击详情底部的“刷新”，可绕过 Host 缓存执行全量刷新。
• 一轮响应完成或被中断后，插件会自动静默刷新一次额度。