前言¶
在 DSH 里调用 DeepSeek 模型时，常见需求有两个：当前 DEEPSEEK_API_KEY 对应的 DeepSeek 开放平台余额还有多少，以及本机 DSH 会话累计花了多少钱。已有做法通常是去 DeepSeek 开放平台查余额，再手动查看日志或记录用量。
dsh-deepseek-balance 是一个 DSH 个人使用插件，把这两类信息放到 DSH 左侧底部入口中，减少来回切换。
这是什么¶
Bob-Bo1/dsh-deepseek-balance 是一个用于 DeepSeek Harness（DSH）的个人使用插件。它由 Bob-Bo1 维护，采用 MIT License。
它解决的是：在 DSH 网页界面里查看 DeepSeek 开放平台 API 余额，以及本机 DSH 已保存会话的消费统计。
核心功能¶
下面介绍已核实的能力：
- 在 DSH 左侧底部提供入口
- 查看 DeepSeek 开放平台 API 余额
- 查看 DSH 本机保存会话的累计消费金额
- 查看今日消费金额
- 查看 Flash 和 Pro 的分别消费金额
- 读取 DSH 凭据中的
DEEPSEEK_API_KEY - 请求 DeepSeek 官方余额接口
- 根据 DSH 会话中的模型和 token 用量重新计算消费金额
- 提供本机路由
GET /api/deepseek-balance和GET /api/deepseek-balance/usage
余额来自当前 DEEPSEEK_API_KEY 对应的 DeepSeek 账户；消费金额来自本机 DSH 会话记录。两者统计范围不同。
安装与启用¶
先安装插件。执行：
npx @deepseek-ai/dsh plugin --profile web add github:Bob-Bo1/dsh-deepseek-balance
如果第一次运行提示 Ok to proceed? (y)，输入 y 并按回车。看到 Done 后启动 DSH：
npx @deepseek-ai/dsh web
然后打开：
http://127.0.0.1:3080
如果 DSH 已经在运行，先在运行窗口按 Ctrl+C，安装插件后重新启动。
如果 Windows PowerShell 无法执行 npx，把命令中的 npx 改成 npx.cmd：
npx.cmd @deepseek-ai/dsh plugin --profile web add github:Bob-Bo1/dsh-deepseek-balance
配置与查看¶
插件读取 DSH 凭据中的：
DEEPSEEK_API_KEY
配置步骤：
- 打开 DSH 的模型设置。
- 配置 DeepSeek 官方 API Key。
- 点击左下角的“DeepSeek 余额与费用”。
经过上面的步骤，页面会展示余额和本机消费统计。插件会读取 DSH 凭据并请求 DeepSeek 官方余额接口，浏览器页面收到的是余额和统计结果。
如果安装后左下角没有入口，在运行 DSH 的窗口按 Ctrl+C，再执行：
npx @deepseek-ai/dsh web
最后刷新网页。
数据安全¶
- API Key 保存在用户自己的 DSH 凭据存储中。
- API Key 不会进入浏览器页面。
- API Key 不会上传到本项目，也不会发送到第三方服务器。
- 余额请求只发送到
https://api.deepseek.com/user/balance。 - 消费统计只读取本机 DSH 已保存的会话日志。
- 插件不会上传会话正文。
不要把 API Key 写入 README、代码、截图、Issue 或 GitHub Actions 配置。
统计范围与限制¶
消费金额根据 DSH 会话中的模型和 token 用量重新计算。当前版本不会自动获得以下数据：
- 其他电脑上的 DSH 使用记录
- DSH 以外客户端的使用记录
- 没有保存 token 用量的历史请求
- 其他 API Key 的独立消费记录
因此，页面中的消费金额适合做本机 DSH 使用情况参考，不适合直接当作跨设备、跨客户端或完整账户账单。
如果你有多个 API Key，请先选择一个作为 DSH 当前使用的主 Key。多个 Key 属于同一个 DeepSeek 账户时，余额不能相加；属于不同账户时，也需要分别查看，避免把金额混在一起。
价格可能随 DeepSeek 官方公告调整。调整后需要更新插件中的价格常量再发布新版本。
适用场景与注意¶
适合使用 DSH Web 界面、需要查看当前 DEEPSEEK_API_KEY 余额和本机会话消费的使用者。
安装前应检查源码与许可证。该插件以当前 dsh 进程权限运行，并会读取 DSH 凭据、请求 DeepSeek 官方接口、读取本机 DSH 已保存的会话记录。项目许可证为 MIT License，详见 LICENSE。
结尾¶
dsh-deepseek-balance 的价值在于把余额查询和本机消费统计收敛到 DSH 左侧入口，适合日常查看当前 Key 的余额和本机 DSH 使用情况。
