Ychris12138/dsh-usage-stats
373最近提交 2026年8月15日
dsh-usage-stats DSH 插件
dsh-usage-stats 提供统一账户卡片显示余额或订阅额度，以及 Token 用量分析，包括每日、每月、累计统计、缓存命中率和月历热图。后台每五分钟自动刷新，支持 New API、Sub2API、通用余额模板和声明式 JSON Pointer 自定义查询等多种适配器。
如何安装 dsh-usage-stats DSH 插件
dsh plugin --profile web add "github:Ychris12138/dsh-usage-stats复制不会执行命令。安装 dsh-usage-stats DSH 插件前请核对仓库和版本。
dsh-usage-stats DSH 插件数据来源
dsh-usage-stats DSH 插件快照日期：2026年8月16日
discovered
dsh-usage-stats DSH 插件能做什么
- 统一账户卡片：显示供应商余额或 Token Plan 额度，并标注正常/警告/严重状态。
- Token 用量分析：按日、月、累计统计，缓存命中率，月历热图可下钻到日期、供应商和模型。
- 后台监测：服务端启动后每五分钟刷新所有已配置账户和本地 Token 聚合，与面板是否打开无关。
- 可扩展适配器：支持 New API、Sub2API、通用余额模板，以及声明式 JSON Pointer 自定义查询。
- 本机安全边界：五个端点仅接受回环 GET 请求；凭据不会发送到浏览器。
dsh-usage-stats DSH 插件适合哪些场景
- 在 DSH 网页侧边栏直接查看各 API 供应商（如 DeepSeek、OpenRouter、Moonshot）的余额。
- 按供应商和模型追踪 Token 消耗，支持月度、每日明细。
- 通过警告和严重阈值设置低余额或额度预警。
- 通过声明式适配器集成自定义供应商账户查询，无需编写代码。
- 使用离线测试和实时会话比对验证 Token 用量数据正确性。
dsh-usage-stats DSH 插件适合谁
- 运行 DeepSeek Harness 并需要管理多个 API 供应商账户的开发者。
- 需要自动化 Token 用量跟踪和余额监控以控制成本的运维团队。
dsh-usage-stats DSH 插件的限制
- 需要 DeepSeek Harness `web` profile，且 `@deepseek-ai/dsh` 版本 >= 0.1.0-rc.6。
- 凭据（API Key 等）必须预先在 `~/.dsh/.credentials.yaml` 中配置；安装器不会创建或修改该文件。
- 没有公开账户接口的供应商无法显示余额，卡片会显示“不支持”。
- 所有插件端点仅限回环访问；不建议通过反向代理暴露，除非额外增加认证。
dsh-usage-stats DSH 插件的仓库 README 摘录
以下文字摘自 dsh-usage-stats DSH 插件的上游仓库 Ychris12138/dsh-usage-stats 的 README，版权归原作者，仅作引用。
为 [DeepSeek Harness](https://github.com/deepseek-ai/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`）。 ```bash dsh plugin --profile web add "github:Ychris12138/dsh-usage-stats" ``` 然后重启已经运行的 `dsh web`，并在浏览器中硬刷新。侧边栏底部会出现“用量/余额”（Usage/Balance）入口。 升级或卸载： ```bash dsh plugin --profile web update dsh-usage-stats dsh plugin --profile web remove dsh-usage-stats ``` <details> <summary><strong>兼容安装器：无法使用 dsh plugin 时展开</strong></
阅读完整 README仓库许可: MIT
dsh-usage-stats DSH 插件常见问题
如何安装 dsh-usage-stats？
在终端中运行 `dsh plugin --profile web add "github:Ychris12138/dsh-usage-stats"`。确保你的 DeepSeek Harness web profile 版本 >= 0.1.0-rc.6。然后重启 `dsh web` 并硬刷新浏览器。插件会在侧边栏底部显示“用量/余额”入口。
如何配置不同供应商的 API Key？
在 `~/.dsh/.credentials.yaml` 中添加所需凭据。例如，DeepSeek 使用 `DEEPSEEK_API_KEY: sk-your-key`，OpenRouter 使用 `OPENROUTER_MANAGEMENT_KEY: sk-or-v1-...`，Z.ai 使用 `ZAI_API_KEY: your-key` 等。插件会自动读取。请勿将真实密钥提交到 Git 或公开分享。
为什么有些供应商看不到余额？
没有公开账户接口的供应商会在余额卡片上显示“不支持”。Token 用量统计仍然正常。如果你认为某个供应商应被支持，可以使用 `declarative` 适配器添加自定义 monitor，通过 JSON Pointer 提取余额。
我的 API Key 安全吗？插件会发送 Key 到浏览器吗？
不会。API Key、Cookie 和管理令牌仅在服务端解析，不会包含在浏览器响应、插件缓存或日志中。插件端点限制为回环 GET 请求。凭据仅在域名验证后发送到已验证的供应商地址。
插件多久刷新一次账户数据？
后台监测每五分钟刷新所有已配置的账户和本地 Token 聚合，与面板是否打开无关。你也可以在面板中点击刷新按钮手动刷新，这会更新 Token、供应商列表，并强制刷新当前账户。