前言¶
DSH (DeepSeek Harness) 插件化系统允许通过插件扩展功能。常规的用量统计插件通常基于本机会话日志，无法覆盖网页端、手机 App 或其他客户端产生的调用。dsh-usage 插件通过直接调用 DeepSeek 平台官方接口，在 DSH Web GUI 中展示账户的全量余额与 Token 用量。
核心功能¶
- 余额：自动读取 DSH 凭证，调用
api.deepseek.com/user/balance接口，显示总额、充值及赠送余额。 - Token 用量（账户全量）：调用平台官方
api/v0/usage/by_api_key/{amount,cost}接口，显示缓存命中/未命中/输出 Token 及对应费用。 - 时间范围：支持 24 小时、7 天、30 天、90 天切换，提供堆叠柱状图与明细表。
- 模型工具：注册
deepseek_usage_query模型工具，大模型可直接查询余额与用量。 - 令牌持久化：令牌保存至
~/.dsh/dsh-usage-token，重启 DSH 后自动读取，无需重复配置。
安装与启用¶
在终端执行以下命令完成安装：
dsh plugin --profile web add "github:Huasecc/dsh-usage#main"
安装完成后，重启 Web 配置生效。
首次配置：获取平台令牌¶
插件需获取 DeepSeek 平台会话令牌才能访问数据。首次使用时需按以下步骤操作：
1. 浏览器登录 https://platform.deepseek.com/usage。
2. 按 F12 打开控制台，执行以下代码获取令牌：
JSON.parse(localStorage.getItem('userToken')).value
- 将输出的令牌粘贴到插件的设置页「平台用量访问令牌」中并保存。
工作原理与注意事项¶
- 数据来源：数据来源于 DeepSeek 平台官方接口，包含账户全量数据（网页、手机、其他客户端），不限于本机会话。
- 令牌类型：需要的是网页控制台会话令牌（
localStorage的userToken），而非 API Key。 - 依赖环境：由于
platform.deepseek.com部署了 WAF，请求需携带浏览器头（UA/Accept/Origin/Referer）以绕过拦截。 - 安全说明：插件仅读取你自己的 DSH 凭证和平台令牌，分发包内不含任何密钥。
总结¶
该插件解决了 DSH 环境下查看全量账户用量的问题，适合需要统一监控所有渠道消耗的用户。如需查看账户真实花费，建议安装使用。
