前言¶
DeepSeek Harness（dsh）把模型适配、工具注册、会话日志和智能体循环都做成插件，官方仓库的定位是「一切皆插件」。日常在 Web 界面里跑任务时，额度却往往还要另开浏览器去看：余额够不够、这一段会话烧掉了多少 token、低余额时有没有提醒，这些信息不在默认界面里。
社区维护的 dsh-balance-plugin 把余额、充值入口和用量统计挂回输入框附近。本文按插件目录页、GitHub 仓库 README 与 package.json 核对后整理：它是什么、能做什么、怎么装、用时要注意什么。社区插件目录是独立站点，与 DeepSeek / 幻方没有官方从属关系，不能当成官方应用商店。
这是什么¶
dsh-balance-plugin 是一款面向 DeepSeek Harness Web 界面的界面增强插件，由 Francis-Xavier-code 维护，仓库许可证为 MIT，当前版本号为 1.0.0。package.json 里把客户端平台标成 web，也就是挂在网页界面上，而不是 headless 进程。
目录页的定位是：DeepSeek 余额监控与用量统计（DSH 动态 Cordis 插件），覆盖余额监控、官方充值入口、用量统计和第三方插件管理。仓库 README 写得更具体：它会并行查询人民币 / 美元双余额池，自动读取本机已配置的 DEEPSEEK_API_KEY，并在输入工具栏右侧放三个入口。
GitHub 仓库在本文核对时为 31 星；社区目录页当时显示 8 星，星标以仓库页面为准。
核心功能¶
余额监控与低余额告警¶
插件会查询 DeepSeek API 余额。README 给出的实现路径是：宿主进程里用 curl 访问 api.deepseek.com/user/balance，带 Bearer 鉴权。支持人民币、美元两套余额，也可以加多个账户并行查询。
启动时如果检测到 DSH 凭据里的 DEEPSEEK_API_KEY，会自动建一个「自动读取 · DSH 凭据」账户，不必再手填一遍 Key。也可以继续添加账户：每个账户可以有名称和 API Key，Key 可以写成明文，也可以写成 $env:DEEPSEEK_API_KEY 这种环境变量引用。
低余额阈值按币种分开，默认人民币 10 元、美元 2 美元，可改。低于阈值时，输入框下方的余额条会整条变红。刷新间隔可在 30 秒到 30 分钟之间选，默认 5 分钟；点「保存配置」会立刻刷一次。
README 对 Key 的说明是：只留在本机插件进程内存里，不上传给第三方，界面只显示脱敏后的值。这是仓库自己的安全承诺，安装前仍应自己看源码。
官方充值入口¶
余额面板提供一键跳转，目标是官方充值页 platform.deepseek.com/top_up，另外还有用量详情页链接。输入框下方的常驻余额条同样带充值链接。
Miyu 风格用量统计¶
用量页按仓库说明，对照 Miyu WebUI 用量页 来做，包含：
- 区间切换和统计卡片
- GitHub 贡献图风格的用量日历
- 三段堆叠趋势柱状图
- 模型消耗环形图和明细表
- 最近 50 条调用记录
图表配色沿用 Miyu 的蓝 / 金 / 玫瑰 / 紫，以及蓝紫热力色阶，并适配深色 / 浅色主题。
性能指标单独列了一组：轮次、步骤、LLM 耗时、工具调用耗时、平均首 token 延迟、tok/s、缓存命中率。用量数据来自实时会话 / 事件监听，启动时还会扫描近 90 天历史并按 seq 去重。FAQ 写明：平均首 token 只统计插件运行之后捕获到的流式数据，装上之前的历史不会补上这一项。
第三方插件管理¶
第三个入口列出非 @deepseek-ai 的非官方 Web 插件，字段包括包名、本地路径、Bundle rev、依赖，并提供「打开目录」定位源码。对经常装社区插件、需要核对本地文件的人比较有用。
模型工具 query_api_quota¶
插件会注册工具 query_api_quota。对话里直接问「DeepSeek 还剩多少余额」这类问题，模型可以调这个工具拿到余额摘要，不必自己去点面板。
安装与启用¶
前置条件是本机已经安装并正在运行 DeepSeek Harness。API Key 可选：没有 Key 就查不了余额；如果本机已经配好 DEEPSEEK_API_KEY，插件启动时会自动读，不必再输入。Key 可到 platform.deepseek.com 申请。
社区目录页给出的安装命令如下，在 DeepSeek Harness 终端里运行：
dsh plugin add github:Francis-Xavier-code/dsh-balance-plugin
需要可复现安装时，目录页要求固定 commit 哈希：
dsh plugin add github:Francis-Xavier-code/dsh-balance-plugin#commit
把 #commit 换成实际提交哈希。
仓库 README 的手动安装更完整，明确写了 --profile web，并且要往 ~/.dsh/cordis.patch.yml 追加插件行：
# 1. 用 github: 源安装依赖（不要用裸包名，见下文）
dsh plugin --profile web add github:Francis-Xavier-code/dsh-balance-plugin
# 2. 若 ~/.dsh/cordis.patch.yml 里还没有，追加：
# - insert:
# - id: dsh-balance-plugin
# name: 'dsh-balance-plugin'
# 3. 重启 DeepSeek Harness
README 还提供一键脚本，流程是：装依赖 → 写 compose patch → 提示重启：
curl -fsSL https://raw.githubusercontent.com/Francis-Xavier-code/dsh-balance-plugin/main/install.sh | bash
管道执行远程脚本等于在本机跑外来代码。目录页也写了：插件以当前 dsh 进程的权限运行，安装时可能执行代码。安装前应检查源代码仓库和许可证；要用脚本的话，先打开 install.sh 看过再执行。指定其他 profile 时，README 写可用 DSH_PROFILE=。
不要写成 dsh plugin add dsh-balance-plugin。README 的 FAQ 说明：npm 上已有第三方占用的同名包 dsh-balance-plugin@0.1.0，裸包名会装错。必须用 github:Francis-Xavier-code/dsh-balance-plugin 或上面的安装脚本。
装完后重启 DeepSeek Harness。入口出现在输入框右侧，分别是钱包、用量、插件三个图标；输入框下方会多一条常驻余额条。
卸载对应一键脚本是：
curl -fsSL https://raw.githubusercontent.com/Francis-Xavier-code/dsh-balance-plugin/main/uninstall.sh | bash
手动卸载：
dsh plugin --profile web rm dsh-balance-plugin
同时还要从 ~/.dsh/cordis.patch.yml 里删掉对应两行，然后重启。
典型用法¶
安装重启后，按入口使用：
- 点输入工具栏右侧的钱包图标，打开余额监控面板：看余额表、设低余额阈值、加账户、改刷新间隔，并从这里进官方充值页。
- 看输入框下方的常驻余额条：实时汇总、手动刷新、充值链接；低余额时整条变红。
- 点柱状图图标，打开用量统计：切时间范围、看日历和趋势、核对模型消耗和最近调用。
- 点四宫格图标，打开第三方插件列表，必要时用「打开目录」定位本地源码。
- 在对话里问余额，让模型调用
query_api_quota。
面板都是居中浮层，点遮罩或「关闭」退出。
余额查询失败时，面板会给出原因，README 列了几类：未配置 Key（API Key not configured）、环境变量不存在（Environment variable xxx not set）、Key 无效（401）。按提示补 Key 或检查凭据即可。
如果用量页没有历史：插件启动时只扫近 90 天的会话事件；更早的记录不在范围内。平均首 token 还要求插件当时已经在跑，并捕获到流式数据。
适用场景与注意事项¶
比较适合这些情况：
- 主要在 DSH Web 界面里跑 DeepSeek 官方 API，希望余额一直可见
- 需要人民币 / 美元双余额、多账户，或低余额变色提醒
- 想按 Miyu 那套用量页看日历、模型和调用明细
- 对话中途想让模型直接查余额
- 需要浏览本机已装的非官方 Web 插件路径
使用前有几件事需要接受：
DeepSeek Harness 官方仓库写明项目仍处于开发者预览，可能出现破坏兼容性的变更。社区插件同样会跟着 Cordis 插件机制和 Web UI 槽位变化。
入口不在侧边栏底部。FAQ 说明：DSH 侧边栏底部槽位被官方 Cordis 面板插件占用，本插件入口固定在输入工具栏右侧，不依赖那个槽位。找不到按钮时，先看输入框右边，而不是侧栏最下方。
手动配置的账户 Key 在重启后会重置；自动读取的 DEEPSEEK_API_KEY 账户不用重配，重启后会自己恢复。如果依赖多账户明文 Key，重启后要再填一次。
插件以当前 dsh 进程权限运行，能读本机凭据、发网络请求、改 compose patch。安装前应阅读仓库源码和 MIT 许可证，确认 github:Francis-Xavier-code/dsh-balance-plugin 指向的就是你要装的那份，而不是 npm 上的同名包。
余额查询会访问 api.deepseek.com。网络或 Key 权限有问题时，面板查不到余额是预期行为，不是界面坏了。
小结¶
dsh-balance-plugin 把 DeepSeek API 的余额、官方充值入口、用量统计和第三方插件目录，接到 DSH 网页输入框旁边，并额外提供 query_api_quota 给模型调用。它解决的是「一边跑智能体、一边看不见额度」这件事，并不改 Harness 核心。
安装用目录页的 github: 源，或 README 里带 --profile web 和 compose patch 的步骤；不要用裸包名。装前检查源码和许可证，装后重启，从输入框右侧三个图标进入。
目录页：https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-balance-plugin/
GitHub：https://github.com/Francis-Xavier-code/dsh-balance-plugin
