[Plugin] dsh-usage：DeepSeek 账户全量用量 + 余额面板（走平台官方接口）

[Huasecc]

[Plugin] dsh-usage —— DeepSeek 账户全量用量 + 余额面板（走平台官方接口）

dsh-usage：在 DSH Web GUI 直接查看你的 DeepSeek 账户真实用量与余额——数据来自 DeepSeek 平台官方用量接口（platform.deepseek.com/api/v0/usage/by_api_key/{amount,cost}），不是本机日志估算。

与现有插件的区别

现有 dsh 用量插件（dsh-usage-stats、dsh-token-usage-dashboard 等）大多从本机会话日志聚合——只能看到你这台 DSH 产生的用量。dsh-usage 走平台官方接口，看到的是账户全量数据：网页控制台、手机 App、其他客户端的调用都算在内，与平台用量页（platform.deepseek.com/usage）完全一致。

	dsh-usage	日志聚合派
数据来源	DeepSeek 平台官方 API	本机 DSH 会话日志
覆盖范围	账户全量（所有客户端）	仅本机 DSH
令牌	一次性粘贴平台令牌（已持久化，重启免重复）	无需
安装	dsh plugin add git 源	npx 安装器

两者可以共存：想要账户真实花费看 dsh-usage；只看本机 DSH 消耗选日志派。

功能

• 余额：自动读取 DSH 凭证 DEEPSEEK_API_KEY（或设置页手动 Key），显示总额/充值/赠送
• Token 用量：缓存命中/未命中/输出 Token、费用，24 小时 / 7 天 / 30 天 / 90 天范围切换，堆叠柱状图 + 明细表
• 模型工具：注册 deepseek_usage_query，模型可以直接查询余额与用量
• 令牌持久化：保存到 ~/.dsh/dsh-usage-token，重启自动读取

安装

dsh plugin --profile web add "github:Huasecc/dsh-usage#main"

重启 web 生效。首次使用需按 README 在设置页粘贴一次平台会话令牌（F12 控制台 JSON.parse(localStorage.getItem('userToken')).value）。

链接

• GitHub: https://github.com/Huasecc/dsh-usage
• 许可: MIT

提示：平台用量接口需要网页控制台会话令牌（不是 API Key）；令牌仅保存在本地，分发包不含任何密钥。

[Huasecc]

面板实测截图（余额 ¥34.15 + 账户全量 Token 用量明细）：

配置平台会话令牌后，面板正常拉取 DeepSeek 官方接口的账户全量数据（缓存命中/未命中/输出 Token、费用，24h–90d 范围可切换），令牌持久化到 ~/.dsh/dsh-usage-token，重启后自动读取无需重新获取。

安装：dsh plugin --profile web add "github:Huasecc/dsh-usage#main"