前言¶
用 DeepSeek Harness（DSH）跑 Web 端智能体时，账户余额是绕不开的一件事：余额见底，后续调用就会失败。要确认余额，通常得切出当前环境，打开 DeepSeek 平台后台登录查看，思路被打断。dsh-balance-display 把这一步搬进 Harness 界面：余额以面板形式常驻，随用随看。
下面介绍这个插件的功能、数据来源、安装方式和配置。
这是什么¶
dsh-balance-display 是由 Liu-ty 维护的 DeepSeek Harness 可安装 bundle，版本 0.1.0，MIT 许可证。它在一个可折叠的 shell.overlay 面板中显示当前 DeepSeek API 账户余额，数据来自官方余额接口，插件本身不存储任何余额值。
核心功能¶
- 以可折叠的
shell.overlay面板显示当前 DeepSeek API 账户余额； - CNY 与 USD 两行，每行包含 total、granted、topped-up 三项余额；
- 显示账户可用性与最近刷新时间；
- 支持折叠面板与手动刷新，自动刷新提供手动、1、5、15 分钟几档选择；
- 页面隐藏时暂停定期刷新，页面可见时恢复；
- 适配 Harness 明/暗主题 token，内置 zh-CN 与 en-US 语言字典；
- 错误状态明确：missing-credential、401、超时、网络、上游、无效响应各自有对应展示。
数据怎么来的¶
Host 每次刷新经 Harness credentials 服务解析 DEEPSEEK_API_KEY，然后调用官方接口 GET https://api.deepseek.com/user/balance。API key 不发送到浏览器，也不被本插件持久化、记录或写入快照。Host 响应使用 Cache-Control: no-store；DeepSeek 的非成功响应体不被转发或记录。
安装与启用¶
先确认环境满足三个条件：
1、带 Web profile 的 DeepSeek Harness，以及当前的 profile-bundle 系统；
2、Node.js ^22.19.0 || >=24.0.0；
3、实时余额读取需要 Harness credentials 中可用的 DEEPSEEK_API_KEY。没有凭据时插件仍会加载，并显示 missing-credential 状态。
推荐从固定的 v0.1.0 源码 tag 安装：
dsh plugin --profile web add github:Liu-ty/dsh-balance-display#v0.1.0
也支持本地检出安装与预构建发布 tarball 安装：
dsh plugin --profile web add F:\path\to\dsh-balance-display
dsh plugin --profile web add .\dsh-balance-display-0.1.0.tgz
安装后执行以下命令，先检查插入的配置，再启动验证：
dsh --profile web --dump-config
dsh --profile web
Git 安装的构建权限¶
Git 安装会拉取源码并运行本包的 prepare 构建。pnpm 可能拒绝安装，直到 profile 的 pnpm-workspace.yaml 显式包含：
allowBuilds:
dsh-balance-display: true
这一授权允许包代码在安装时于本机执行。授予前应先审查源码，并固定 tag 或 commit。如果不想授予构建权限，改用发布 tarball，其中已含预构建文件，无需该权限。
配置¶
bundle 会在配置中插入一行 Host/Client 条目：
- id: balance-display
name: dsh-balance-display
inject: [credentials, webServer]
config:
requestTimeoutMs: 10000
要修改超时，在 profile 或 home 的 cordis.patch.yml 中覆盖整行，把 requestTimeoutMs 改为正整数即可。自动刷新间隔与折叠状态是浏览器本地偏好；插件不存储任何余额值。
适用场景与注意事项¶
适合的人群：日常使用带 Web profile 的 DSH，希望在不离开当前界面的前提下掌握 DeepSeek API 余额的开发者。
使用前注意几点：
1、插件以当前 dsh 进程权限运行，安装前应检查源码与许可证（本项目为 MIT）；
2、Git 安装需要 pnpm 构建授权，授予前先审查源码并固定 tag 或 commit；
3、插件无模型可见输入，也没有 token 统计集成，不要把它当成成本核算工具；
4、无凭据时不会中断，面板会显示 missing-credential 状态，配置好凭据后即可正常读取。
小结¶
dsh-balance-display 解决的是一个具体的小问题：把查余额从切页登录变成界面里的一瞥。实现上走官方接口、凭据不进浏览器，MIT 许可，按需启用即可。
社区插件目录页面：https://www.skillhub.cn/plugins/Liu-ty/dsh-balance-display（独立站点，与 DeepSeek、幻方无官方从属关系）
源码仓库：https://github.com/Liu-ty/dsh-balance-display
