前言¶
在 DSH（DeepSeek Harness）里使用 DeepSeek 做会话时，账户余额和本会话消费金额通常不会直接显示在操作界面上。dsh-deepseek-balance 是一个 DSH 插件，把 DeepSeek 官方账户余额和本次会话消费金额常驻显示在 Web 输入框下方，并每 15 秒刷新。
DSH 的插件生态强调「一切皆插件」，社区目录是独立站点；本文只基于已核实资料介绍这个插件，不把它写成 DeepSeek 官方应用。
这是什么¶
仓库地址：
https://github.com/CN-Leo/dsh-deepseek-balance
一句话定位：DeepSeek 账户余额实时显示插件（DeepSeek Harness / DSH）。
已核实资料中的许可证为：
MIT
已核实资料中的 package.json 版本号为：
0.2.3
它解决的主要问题有两个：
1、在 DSH Web 中快速看到 DeepSeek 官方账户余额。
2、按 DeepSeek 官网定价规则，估算并显示当前会话已经消费了多少金额。
核心功能¶
下面介绍已核实的插件能力。
插件会在 DSH Web 输入框下方（conversation.composer.dock）常驻显示余额信息。
conversation.composer.dock
显示内容包括余额和本会话消费金额。示例格式如下：
DeepSeek 余额 ¥71.33 ｜ 本会话 ¥4.85
核心能力如下：
1、每 15 秒自动刷新余额和本会话消费金额。
2、按 DeepSeek 官网最新定价实时计算本次会话消费金额。
3、从官方接口获取余额数据：
GET https://api.deepseek.com/user/balance
4、API Key 由 Host 端从 DSH 凭据库解析，不进入浏览器。
5、支持通过环境变量或 $DSH_HOME/.credentials.yaml 配置 DEEPSEEK_API_KEY。
6、悬停余额条可查看余额明细、按模型 token 用量、当前时段和会话消费金额。
7、按 deepseek-v4-flash / deepseek-v4-pro 分模型计价，并区分高峰/空闲时段。
安装与启用¶
下面介绍安装步骤。
如果使用 Git 仓库地址安装，已核实资料中的命令如下，其中仓库地址保留占位符：
dsh plugin add https://github.com/<你的用户名>/dsh-deepseek-balance
如果插件源码在本地目录，也可以使用本地路径安装：
dsh plugin add /path/to/dsh-deepseek-balance
安装后需要重启 dsh web。当前进程不会热加载新插件。
安装后重启 dsh web
配置 DEEPSEEK_API_KEY 是必需步骤。可以通过环境变量配置，也可以写入 $DSH_HOME/.credentials.yaml：
DEEPSEEK_API_KEY: sk-xxxxxxxxxxxxxxxx
配置后无需重启插件。每次请求都会重新解析凭据。
系统侧需要 curl。Windows 自带 curl.exe；其他平台需要 PATH 中有 curl。
curl
典型用法¶
安装并配置完成后，在 DSH Web 会话界面中可以看到余额条。
余额条显示在会话输入框下方，示例如下：
DeepSeek 余额 ¥71.33 ｜ 本会话 ¥4.85
悬停余额条时，可查看更完整的明细。已核实资料中提到的内容包括：
各币种余额、账户可用状态、按模型分列 token 用量、当前时段、本次会话消费金额
本会话消费金额会按会话实际使用的模型分模型计价。已核实的计价范围是 deepseek-v4-flash / deepseek-v4-pro，并区分高峰/空闲时段。
以下情况需要注意：
1、非 DeepSeek 模型不套用 DeepSeek 价格表、不计入消费金额。
2、缓存写入按缓存未命中输入价计。
适用场景与注意¶
这个插件适合在 DSH Web 中使用 DeepSeek 账户、并希望直接看到余额和本会话消费的开发者或智能体流程使用者。
使用前的注意事项如下：
1、插件会在 Host 端解析 DEEPSEEK_API_KEY，并以当前 dsh 进程权限运行相关子进程。安装前应检查仓库源码、许可证和依赖。
2、API Key 只存在于 Host 进程的 curl 子进程参数中，浏览器端只能拿到余额 JSON。
3、Host 依赖：credentials、subprocess、sandboxPolicy、webServer。
4、Client 依赖：slots 服务、react。
5、系统需要 curl。
卸载¶
如果不再使用该插件，可以使用下面的命令移除：
dsh plugin remove dsh-deepseek-balance
链接¶
GitHub 仓库：
https://github.com/CN-Leo/dsh-deepseek-balance
目录页 URL 未在本次已核实资料中给出，请以实际 DSH 社区目录站点为准。
