DeepSeek Harness Plugin: Display Sub2API Balance and Usage Details in the Left Sidebar

DeepSeek Harness (DSH) 采用“一切皆插件”的架构。dsh-sub2api-usage 插件将 Sub2API 的余额和用量信息集成到 DSH 的左侧边栏中，无需在浏览器中打开站点即可查看。它支持多种查询模式，且所有请求由宿主进程发出，站点无需配置 CORS。

功能概览¶

该插件在左侧边栏提供常驻的余额小条，点击可打开包含详细数据的面板。

1. 侧边栏展示：在左侧边栏底部显示余额摘要（如 $12.34 用量），带状态圆点。余额低于阈值时显示黄点，未配置时显示红点。
2. 详细面板：点开小条或图标可查看完整用量面板，包括钱包余额、剩余额度、订阅周期、按小时/按天用量趋势折线图、模型用量及限流窗口。
3. 自定义接口：查询接口的每一部分（服务地址、模式、路径、JSON 指针）均可自定义。
4. 查询模式：支持多种认证方式，包括站点 Key、管理员 Key、账号密码登录以及完全自定义的请求。
5. 数据可视化与导出：支持按小时或按天切换趋势图，支持导出 CSV 或 JSON 数据。
6. 实时刷新：后台按间隔自动刷新余额（默认 120 秒）。

安装与前置条件¶

前置条件：
* DeepSeek Harness (DSH) 环境，且命令行中包含 dsh。
* Node.js 版本 ≥ 18。

安装：

dsh plugin --profile desktop add github:aming1029/dsh-sub2api-usage

安装完成后，插件管理器会即时生效，无需重启应用。

配置与使用¶

1. 打开 DSH 客户端，在侧边栏底部找到余额小条或图标区的「Sub2API 用量」。
2. 点击进入面板，切换到「设置」选项卡。
3. 在「查询接口」部分配置服务地址和凭证。
4. 选择合适的查询模式并保存，点击「测试连接」可验证配置是否正确。

支持的查询模式：
* 站点 Key：适用于查询特定 Key 的余额和用量。
* 管理员：使用管理员 API Key，可查询指定用户或用户列表的余额、冻结余额、充值总额等。
* 账号密码：使用邮箱和密码登录，查询当前登录账号的信息。
* 自定义请求：手动指定请求方法、路径、请求头和请求体。

高级特性与注意事项¶

• 小时数据采样：对于仅返回按天数据的接口，插件会利用后台采样逻辑在本地计算小时级用量，保留最近 14 天数据。
• 宿主发起请求：所有对上游站点的请求均由 DSH 的宿主进程（Node.js 侧）发出，页面端不会直接请求站点接口。这意味着站点无需开启 CORS，且凭证不会出现在页面代码中。
• 配置持久化：设置项（包括刷新间隔、默认视图、统计区间等）会保存到配置文件中。

结语¶

该插件为使用 Sub2API 的开发者提供了一个集成在 DeepSeek Harness 中的实时监控面板。所有功能均由宿主侧处理，保障了数据获取的稳定性和隐私安全。

• GitHub 仓库：https://github.com/aming1029/dsh-sub2api-usage
• 插件目录：https://www.skillhub.cn/plugins/aming1029/dsh-sub2api-usage