Ychris12138/dsh-usage-stats
Provider balances, subscription quotas, and token-usage analytics for the DeepSeek Harness Web GUI (dsh web).
已收录
65
Usage
Bundle 已验证
预览
功能介绍
多供应商用量看板:按供应商/模型统计 Token 与日期下钻,统一展示账户余额,并追踪 OpenCode Go / Z.ai 订阅额度。
适合
- 希望在一个看板中按日期、供应商和模型拆分 Token 用量的 DSH Web 用户。
- 需要将受支持供应商的账户余额、编程套餐订阅额度与本地用量统一监控的团队。
- 需要日期下钻、缓存命中分析、后台账户刷新和供应商状态,并使用中英双语界面的运维人员。
不适合
- 仅使用 TUI 或 headless 的部署;已说明的界面依赖 DSH Web profile。
- 希望所有供应商都能显示余额的用户;没有公开账户接口的供应商仍可统计 Token,但账户监控会显示不支持。
- 无法在 DSH 预发布客户端、Cordis 或持久化接口变化时同步适配的环境。
README
dsh-usage-stats
为 DeepSeek Harness 网页端提供多供应商账户监测与 Token 用量分析。
Provider balances, subscription quotas, and token-usage analytics for the DeepSeek Harness Web GUI (dsh web).
展示图使用脱敏演示数据;插件不会把 API Key、Cookie、管理 PAT 或上游原始响应发送到浏览器。
一眼看懂 / At a glance
| 能力 | 说明 | |
|---|---|---|
| 💳 | 统一账户卡片 | API 供应商显示余额,Token Plan 显示分窗口额度;面板一次只呈现当前供应商 |
| 📊 | Token 用量分析 | 今日、本月、累计、缓存命中率、月历热图,以及按日期/供应商/模型下钻 |
| 🔄 | 后台监测 | 服务端启动即刷新,之后每五分钟更新全部已配置账户与本地 Token 聚合 |
| 🧩 | 可扩展适配器 | 支持 New API、Sub2API、通用余额模板,以及声明式 JSON Pointer 自定义查询 |
| 🔒 | 本机安全边界 | 五个端点仅接受回环 GET;凭据只在服务端解析并发往校验后的供应商地址 |
界面支持中文和英文。浏览器只请求当前选择的 provider;后台刷新与面板是否打开无关。手动刷新会更新用量、供应商列表,并强制刷新当前账户,不会批量强制请求其他供应商。
快速安装 / Quick start
需要 DeepSeek Harness web profile(@deepseek-ai/dsh >= 0.1.0-rc.6)。
dsh plugin --profile web add "github:Ychris12138/dsh-usage-stats"
然后重启已经运行的 dsh web,并在浏览器中硬刷新。侧边栏底部会出现“用量/余额”(Usage/Balance)入口。
插件市场 GUI 安装(DSH Community Market,Path A 标准来源)
本仓库按 DSH Community Market 目录 adapter 指南 的标准来源(Path A) 接入,无需修改 Market 代码。内置两份目录数据:
-
catalog/catalog-source.json— 来源 manifest(catalog-source.schema.jsonv1.0.0) -
catalog/v1/plugins.json— 标准 provider page(catalog-provider-page.schema.jsonv1.0.0)
使用前提(重要):市场托管安装只接受 npm registry 的精确稳定版本,git 条目仅可浏览。dsh-usage-stats 这个 npm 名已被其他项目占用,因此目录条目身份使用 @ychris12138/dsh-usage-stats(当前可用)。要启用 GUI「安装」按钮,需先发布:
- 仓库包身份已统一为
@ychris12138/dsh-usage-stats;每次发版需同步package.json/package-lock.json/catalog/v1/plugins.json的版本。 - 发布 scoped 公共包:
npm publish --access public。 - 把
catalog/v1/plugins.json内容发布到https://ychris12138.github.io/dsh-usage-stats/v1/plugins(GitHub Pages,manifest 与 endpoint 必须同源、HTTPS 443、无凭据)。 - 在 DSH 插件市场 → 来源管理 → 添加来源,粘贴 manifest URL:
https://ychris12138.github.io/dsh-usage-stats/catalog-source.json,选择后即可走「可恢复安装边界」GUI 安装。
若最终包名不同,请同步修改
catalog-source.json的providerId/transport.endpoint与catalog/v1/plugins.json的身份字段。发布前目录条目可浏览但安装保持禁用(fail-closed,属预期)。
升级或卸载:
dsh plugin --profile web update dsh-usage-stats
dsh plugin --profile web remove dsh-usage-stats
常见问题常见问题
在启用了 DSH 的终端中执行已验证命令 dsh plugin --profile default add github:Ychris12138/dsh-usage-stats。命令会解析公开 package 元数据,并保持插件与本页展示的目录身份一致。
兼容性以页面上展示的 bundle 与 profile 状态为准。如果某个 profile 尚未检测到,请先保持禁用,并在生产启用前阅读仓库文档。
GitHub 链接和 activity 元数据是 release 与维护状态的来源。新版本发布后重新查看本页,确认目录已经观察到最新版本。