前言¶
在 DeepSeek Harness（DSH）的 Web 会话里，一个很常见的问题是：今天大概用了多少额度，账户里还剩多少。已有做法通常是打开控制台、查余额接口，或手工记录余额变化。
下面介绍一个 DSH Web 插件：arslan-jh/deepseek-harness-usage。它会在对话输入区下方显示今日消费和总余额，并把今日消费明确标记为估算值。
这是什么¶
这是一个由 Arslan-jh 维护的 DeepSeek Harness Web 插件，License 为 MIT。当前资料标注其面向 DeepSeek Harness 0.1.0-rc.6 的 Web profile，并要求 Node.js 22+。
它解决的是账户级用量可见性：在 DSH Web 会话中直接回答“我今天用了多少 DeepSeek 额度，账户还剩多少”。它不展示每个会话、模型或工具的逐请求消耗，也不替代 Token 分析仪表盘。
核心功能¶
- 今日消费：从当天账户余额变化估算出的人民币消费额，界面上用
≈表示。 - 总余额：来自 DeepSeek 官方余额接口的账户级可用余额。
- 充值识别：充值或赠送额度增加时，不会把当天消费错误清零。
- 自动刷新：DSH 宿主和浏览器每 3 分钟更新一次。
- 复用 DSH 凭据：使用 DSH 已配置的
DEEPSEEK_API_KEY，不需要在网页里再次填写 API Key。 - 今日消费校准：可输入官网数字重新校准。
- 平台 token：可选实验功能，尝试读取 DeepSeek 官网页面使用的内部用量接口。
- 删除平台 token：随时清除已保存的平台 token，恢复余额差估算。
- 余额查询：直接调用 DeepSeek 公开余额接口查询账户级余额。
- 日志补齐：读取本机 DSH 会话的 Token 记录，补上午夜到第一次余额采样之间可能遗漏的消费。
安装与启用¶
如果本机已使用 dsh 命令，执行：
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。打开一个已有会话，或在新会话发送第一条消息后，用量行会出现在对话输入区下方。
设置与校准¶
进入：
设置 → 通用设置 → DeepSeek 用量显示
可配置项包括：
- 今日消费校准：如果官网显示的今日消费与插件估算值不同，可以输入官网数字重新校准。
- 平台 token：可选实验功能。它会尝试读取 DeepSeek 官网页面使用的内部用量接口。
- 删除：随时清除已经保存的平台 token，恢复余额差估算。
平台 token 不是必需项。资料说明内部接口不是公开 API，可能随官网更新失效；失败时插件会显示警告，但不会影响总余额查询。
今日消费怎么估算¶
总余额直接调用 DeepSeek 的公开余额接口，因此是账户级余额。
今日消费默认可以理解为：
今日消费 ≈ 今日开始时的余额 + 今日充值/赠送 - 当前余额
插件会写入：
$DSH_HOME/storages/deepseek-usage-day.json
用于保存当天余额基线。每天第一次运行时，还会读取本机 DSH 会话的 Token 记录，补上午夜到第一次余额采样之间可能遗漏的消费。
内置价格只采用有公开依据的固定单价；没有公开文档支持的未来价格或峰谷规则不会写进代码。
使用边界¶
≈很重要：今日消费是估算值，不是官方账单明细。- 如果同一个 DeepSeek 账户还被其他电脑或应用使用，它们造成的消费也会反映在余额变化中。
- 本机日志只用于补齐当天第一次采样前的空白，不会假装知道其他客户端的逐请求明细。
- 本项目的包标识是
@arslan-jh/deepseek-harness-usage；目前请使用 README 中的 GitHub 安装命令。
隐私与权限¶
插件会执行以下操作：
- 通过 DSH 凭据服务读取
DEEPSEEK_API_KEY。 - 访问
api.deepseek.com查询余额。 - 读取本机 DSH 会话统计，用于当天第一次启动时的日志回放。
- 写入
$DSH_HOME/storages/deepseek-usage-day.json保存当天余额基线。 - 只有主动配置时，才保存并使用
DEEPSEEK_PLATFORM_TOKEN。
资料说明插件不会把 API Key 或平台 token 返回给浏览器，也不包含遥测；配置接口仅接受同源 JSON 请求，并限制请求正文大小。
安装前注意¶
这个插件会读取本机 DSH 会话统计，并通过 DSH 凭据服务访问 DEEPSEEK_API_KEY。它由 DSH 宿主加载，可以视为以当前 dsh 进程权限运行的本地扩展。安装前建议先检查 GitHub 仓库源码、package.json、依赖和 MIT 许可证，确认符合本机使用要求。
卸载¶
dsh plugin --profile web remove @arslan-jh/deepseek-harness-usage
相关链接¶
- GitHub 仓库：https://github.com/Arslan-jh/deepseek-harness-usage
- 社区目录线索：https://www.skillhub.cn/plugins/Arslan-jh/deepseek-harness-usage。该 URL 来自插件线索，未作为已抓取资料确认；社区目录不代表 DeepSeek 或幻方官方应用商店。
