前言¶
在 DeepSeek Harness (DSH) 的开发场景中，开发者通常需要在多个 AI 服务提供商之间切换，管理各自的订阅配额。手动查看不同服务的剩余额度往往打断工作流。dsh-subscription-overlay 插件旨在解决这一问题，它通过一个可切换的 Web 覆盖层，聚合了 Claude、Codex 和 OpenCode Go 的实时配额，同时针对没有公开配额接口的 CommandCode 进行本地可用性探测和消耗记录。
插件简介¶
这是一个由 ajceee 维护的 DSH Web 插件，遵循 MIT 许可证。它通过 DSH 的 Web 插件机制注入界面，提供悬浮窗和设置面板，用于统一展示服务状态和本地消耗数据。
核心功能¶
1. 订阅额度聚合与展示¶
插件聚合了四个提供商的数据：
* Claude、Codex、OpenCode Go：显示实时使用情况条和重置时间。
* CommandCode：由于该服务没有配额端点，插件仅显示探测状态（在线/离线 + 延迟）和本地消耗记录，不会生成虚构的百分比条。
2. 浮层与交互¶
- 悬浮窗：默认显示为可拖拽的“药丸”或“圆环”模式，带有未读或状态变化的徽章。
- 热键切换：使用
Ctrl+Shift+S可隐藏或显示浮层。 - 面板操作：点击浮层可打开 4 提供商面板，点击刷新按钮可强制重新获取数据。
3. 本地消耗追踪¶
提供本地月度消耗账本，记录已使用的 Token 数量，并支持设置月度预算（以 Token 为单位）。当预算大于 0 时，会计算并显示预算占用百分比。
4. 设置与控制¶
- 全局与单项开关：支持独立开关每个提供商的数据展示。
- 轮询与告警：设置轮询间隔（1-60 分钟）和告警阈值（1-100%）。
- HTTP API：提供同源 API 接口，支持通过 POST 请求进行状态刷新、CommandCode 探测、设置更新及账本追加。
安装与配置¶
前置要求：
* DSH 版本 0.1.5-rc.1 或更高。
* Node.js 版本 20+。
安装步骤：
1. 克隆或获取插件源码到本地目录（例如 C:/Projects/dsh-subscription-overlay）。
2. 执行以下命令安装插件：
dsh plugin --profile web add C:/Projects/dsh-subscription-overlay
- 重要：安装后必须重启 DSH Web 进程，以使
bundle-list更改生效。
使用方式¶
- 显示/隐藏：安装成功后，右下角会出现订阅额度浮层。按下
Ctrl+Shift+S可快速切换其显示状态。 - 查看详情：点击浮层打开面板，查看各服务的具体剩余额度。
- 刷新数据：点击浮层或面板内的刷新按钮，可强制重新从 OAuth/Session 源获取数据。
- CommandCode 探测：在 CommandCode 卡片中，点击“探测”按钮重新检查服务的可用性。
- 管理消耗：在设置中配置月度预算，或查看“本月消耗”面板以了解月度累计 Token 使用量。
注意事项¶
- CommandCode 限制：该服务无配额端点，面板仅展示探测结果和本地记录，不显示百分比（除非设置了月度预算）。
- 凭证管理：插件不会在设置中存储 API Key，所有凭据通过 DSH 的凭证域解析，并支持环境变量或会话文件作为回退。
- 权限与重启：插件以当前 DSH 进程的权限运行，请确保安装前已检查源码与许可证。安装后务必重启服务以加载新插件。
