Arslan-jh/deepseek-harness-usage
DeepSeek 插件,用于管理账户余额及有证据限额的每日人民币消费
项目介绍Project Overview
这是一个 DSH Web 插件,在对话输入区下方显示 DeepSeek 今日估算消费和账户总余额,每 3 分钟自动刷新,并可识别充值、校准今日消费。适合想快速了解“今天用了多少额度”而不打开控制台时使用。注意:无平台 token 时,今日消费由余额差估算,不是官方账单明细;同账户其他客户端的消耗也会计入余额变化。
This is a DSH Web plugin that shows estimated DeepSeek spending for today and the current account balance below the chat input, refreshing every 3 minutes. It detects top-ups and supports manual calibration. Use it when you want a quick answer to “how much credit have I used today?” without opening the console. Caveat: without a platform token, today’s spend is estimated from balance changes, not official billing details, and usage by other clients on the same account is included.
请帮我了解并安装插件:【deepseek-harness-usage】【https://github.com/Arslan-jh/deepseek-harness-usage】
把上面这条消息直接发给当前会话里的 DSH,让它帮你了解并安装。安装命令不一定准确,发给 DSH 更稳。Send this message to DSH in your current session. CLI install commands may not be accurate across systems — DSH will figure it out for you.
或使用命令行安装(适合开发者)Or use CLI install (for developers)
命令行安装CLI Install
dsh plugin --profile web add github:Arslan-jh/deepseek-harness-usage
把 Arslan-jh/deepseek-harness-usage 加入你的 DSH 配置(web profile)即可启用。
READMEREADME
DeepSeek Harness Usage
在 DeepSeek Harness 对话框下方,直接显示:今天大约花了多少钱,以及账户还剩多少钱。
不需要打开控制台,也不需要手工记余额。插件每 3 分钟自动更新。

图中是示例数据。
≈表示今日消费是估算值;总余额来自 DeepSeek 官方余额接口。
它能做什么
| 显示项 | 含义 |
|---|---|
| 今日消费 | 从当天账户余额变化估算出的人民币消费额 |
| 总余额 | DeepSeek 账户当前可用余额 |
| 充值识别 | 充值或赠送额度增加时,不会把当天消费错误清零 |
| 自动刷新 | DSH 宿主和浏览器每 3 分钟更新一次 |
这个插件适合回答一个很直接的问题:我今天用了多少 DeepSeek 额度?
它不是 Token 分析仪表盘,也不展示每个会话、模型或工具的详细消耗。
安装
dsh plugin --profile web add github:Arslan-jh/deepseek-harness-usage
dsh --profile web
如果你的电脑只通过 npx 使用 DSH:
npx @deepseek-ai/dsh plugin --profile web add github:Arslan-jh/deepseek-harness-usage
npx @deepseek-ai/dsh --profile web
然后刷新 DSH Web,打开一个已有会话。用量行会出现在对话输入区下方。
插件使用 DSH 已配置的 DEEPSEEK_API_KEY,不需要在网页里再次填写 API Key。
设置
进入 设置 → 通用设置 → DeepSeek 用量显示:

- 今日消费校准:如果官网显示的今日消费与估算值不同,可以输入官网数字重新校准。
- 平台 token:可选的实验功能。它尝试读取 DeepSeek 官网页面使用的内部用量接口。
- 删除:随时清除已经保存的平台 token,恢复余额差估算。
平台 token 不是必需项。内部接口不是公开 API,可能随官网更新失效;失败时插件会显示警告,但不会影响总余额查询。
数字是怎么算出来的
总余额
直接调用 DeepSeek 的公开余额接口,所以这是账户级余额。
今日消费
默认计算方式可以简单理解为:
今日消费 ≈ 今日开始时的余额 + 今日充值/赠送 - 当前余额
插件会在本机保存当天的余额基线。每天第一次运行时,还会读取当天本机 DSH 会话的 Token 记录,补上午夜到第一次余额采样之间可能遗漏的消费。
需要知道的边界
≈很重要:没有平台 token 时,今日消费是账户余额差估算,不是官方账单明细。- 如果同一个 DeepSeek 账户还被其他电脑或应用使用,它们造成的消费也会反映在余额变化中。
- 本机日志只用于补齐当天第一次采样前的空白,不会假装知道其他客户端的逐请求明细。
- 内置价格只采用有公开依据的固定单价;没有公开文档支持的未来价格或峰谷规则不会写进代码。
官方参考:
隐私与权限
插件会:
- 通过 DSH 凭据服务读取
DEEPSEEK_API_KEY; - 访问
api.deepseek.com查询余额; - 读取本机 DSH 会话统计,用于当天第一次启动时的日志回放;
- 写入
$DSH_HOME/storages/deepseek-usage-day.json保存当天余额基线。
只有在你主动配置时,插件才会保存并使用 DEEPSEEK_PLATFORM_TOKEN。
插件不会把 API Key 或平台 token 返回给浏览器,也不包含遥测。配置接口仅接受同源 JSON 请求,并限制请求正文大小。
常见问题
为什么今日消费前面有 ≈?
因为这个数字默认根据余额变化推算。总余额是官方接口数据,但今日消费不是官方账单明细。
为什么空白新会话里没有显示?
用量行挂在会话统计区域。打开已有会话,或在新会话发送第一条消息后即可看到。
可以使用无 scope 的 npm 包名安装吗?
不可以。本项目的包标识是 @arslan-jh/deepseek-harness-usage,目前请使用 README 中的 GitHub 安装命令。
卸载
dsh plugin --profile web remove @arslan-jh/deepseek-harness-usage
开发
要求 Node.js 22+,当前面向 DeepSeek Harness 0.1.0-rc.6 的 Web profile。
npm install
npm run check
npm test
npm pack --dry-run
仓库暂时采用 GitHub 源安装并保留 private: true,防止误发布到无 scope 的公共 npm 包名。
nexu-io/open-design
freestylefly/awesome-gpt-image-2
anywhere-labs/dsh-desktop
walkinglabs/learn-harness-engineering
awesome-dsh-plugin/awesome-dsh-plugin
MemTensor/MemOS