DeepSeek Harness (DSH) 采用插件化架构，允许用户在 Web UI 中扩展功能。在使用 CLIProxyAPI (CPA) 等代理进行开发或调试时，直观地查看当前模型或账户的剩余配额并不直观。dsh-client-ui-cpa-quota 插件通过在模型选择器旁提供可视化环，解决了这一痛点。
插件介绍¶
- 名称：dsh-client-ui-cpa-quota
- 所有者：wkscc310
- 类别：联网工具
- 许可：MIT
核心功能¶
该插件在浏览器端运行，利用 DSH 提供商的配置自动发现模型和接口地址，无需维护额外的模型列表。
- 自动发现与识别：读取 DSH providers 中的 models 和 baseURL 值。插件会对每个 baseURL 进行指纹识别，确认为 CLIProxyAPI，避免在普通 OpenAI 兼容端点上显示空环。
- 多实例与账户支持：支持多个 CLIProxyAPI 实例和账户。悬停工具提示会根据选定的模型进行过滤，而设置面板始终显示所有账户的配额。
- 配额窗口逻辑：配额窗口按 5小时 → 周 → 月 → 日 排序，环显示会优先使用第一个可用的窗口。
- 上游查询：支持通过上游配额 API 查询 Codex、Claude、Antigravity、Gemini CLI、Kimi 和 xAI/Grok 的配额。对于其他 CPA 提供商，插件仍会显示账户状态和近期活动。
- 使用中检测：插件通过 CPA 的每请求使用队列构建本地 7 天账本。在刷新周期内，悬停工具提示会显示实际为选定模型提供服务的账户（按最后使用时间排序，并带有使用中标记和请求数/令牌数统计），其余账户折叠至“Other accounts”。
- 稳定性与容错：账户探针运行在有界池中，具备每请求超时机制，防止单个上游挂起阻塞整个刷新周期。插件会保留刷新失败前的最后成功快照，并在 DSH 屏幕重挂载时重用环。
- 视觉反馈：配额颜色根据剩余量变化：绿色（≥20%）、琥珀色（<20%）、红色（耗尽/错误）、灰色（加载中或缺少管理密钥）。
安装与启用¶
通过官方命令行工具安装并激活插件：
dsh plugin --profile web add dsh-client-ui-cpa-quota
安装完成后，重启 DSH Web 主机，然后在界面中打开：
* 设置 → 插件 → CliProxyAPI Quota。
在展开的设置卡片中，为每个实例粘贴管理密钥。
配置与注意事项¶
- 密钥存储：在设置卡片中输入的密钥存储在当前浏览器的
localStorage中。如果通过 YAML 管理密钥，则存储在 YAML 文件中。浏览器设置卡片会覆盖 YAML 配置。 - 刷新间隔：
refreshMinutes会被限制在至少一分钟。 - 安全性：切勿将管理密钥提交到公开仓库。
依赖与限制¶
- DSH 版本：插件要求当前插件契约使用 DSH Web profile（已验证版本：0.1.1-rc.2, 0.1.2-rc.1, 0.1.5-rc.2, 0.1.6-alpha.1）。
- 网络依赖：需要可访问的 CLIProxyAPI 实例，且该实例的管理 API 已启用。
- 注册范围：该插件仅在 Web UI 中注册。
总结¶
dsh-client-ui-cpa-quota 为 DSH Web UI 提供了一个轻量级的配额监控方案，适合需要同时管理多个 CLIProxyAPI 实例和账户的用户，能够快速定位当前可用资源。
