在 DeepSeek Harness (DSH) 的使用场景中，智能体开发者往往需要同时管理多个 AI 服务的订阅配额与账户余额。手动查看各平台的账户状态会打断工作流。dsh-ai-quota 插件提供了一站式的配额监控方案，将不同服务的状态整合到一个界面中。
这是一个由 Carrick-K7 维护的 DeepSeek Harness 插件，支持 Codex、Kimi、GLM Coding Plan、DeepSeek、302.AI 和 OpenCode Go。它通过统一的格式展示订阅窗口或余额信息，并提供自动刷新与可视化的管理功能。
核心功能¶
该插件提供以下能力：
- 模型工具
query_ai_quota：在任意智能体会话中调用该工具，即可获取配额摘要。 - 设置页面：在“AI Quota”设置页面中，按窗口展示使用情况条形图和余额，支持手动刷新。
- 每提供商可见性：设置页面的标题栏包含一个齿轮按钮，可打开二级设置，通过开关控制每个提供商的显示状态。
- Composer 芯片：在新建对话页面和会话中，根据当前选定的提供商路由（而非模型 ID）显示一行配额指示器。
- 自动刷新：支持可配置的自动刷新间隔，默认为 2 分钟，也可设置为 0 以禁用。
- 统一格式：不同提供商的数据被归一化为订阅窗口或余额条目，单个提供商的故障不会影响其他提供商的显示。
- 皮肤感知调色板：所有读数颜色使用 CSS 变量定义。加载特定主题（如 dsh-miku-skin）时，芯片和使用情况条形图会呈现相应的主题色。
- 无密钥泄露：插件设计保证 API 密钥和令牌绝不会出现在工具输出或日志中。
安装与启用¶
在终端中执行以下命令安装插件。该命令会自动将插件行追加到 dsh.profile.bundles，安装完成后请重启 dsh web。
dsh plugin --profile web add github:Carrick-K7/dsh-ai-quota
典型用法¶
安装完成后，可以通过以下方式使用：
- 会话查询：在任何智能体会话中，调用
query_ai_quota工具，即可获取当前所有提供商的配额摘要。 - 设置页面查看：在 DSH 的设置页面中找到“AI Quota”区域，可以手动刷新并查看各服务的余额和使用情况条形图。
- Composer 芯片查看：在新建聊天页面，根据当前选中的模型路由，芯片会自动显示对应提供商的配额状态。
- 提供商管理：在设置页面的“AI Quota”标题栏点击齿轮按钮，开启或关闭特定提供商的显示。
适用场景与注意¶
- 多服务管理：适合同时使用 Codex、Kimi、GLM、DeepSeek、302.AI 或 OpenCode Go 等多个服务的 DSH 用户。
- 本地凭证：Codex 和 Kimi 使用本地 CLI 登录状态，无需在插件中输入 API 密钥。
- 依赖要求：运行该插件需要宿主环境安装 React、Cordis 以及其他对等依赖项。
- 数据安全：插件通过 DSH 的凭证机制（
DEEPSEEK_API_KEY等）获取密钥，且绝不会将密钥写入输出或日志。
总结¶
dsh-ai-quota 通过工具、设置页面和 Composer 芯片三个维度，为 DSH 用户提供了直观、自动化的多平台配额管理能力。所有显示的余额数据均来自各服务官方接口，且遵循统一的格式与皮肤规范。
