前言¶
调用 DeepSeek API 时，有几件事要反复人工确认：余额还剩多少、今天已经花了多少、现在是不是峰段计价。官方平台能查到这些数据，但需要切出开发环境单独去看。dsh-plugin-api-usage-monitor 把这三件事搬进 DeepSeek Harness 的 Web 侧边栏。下面介绍它的功能、安装与日常用法。
这是什么¶
dsh-plugin-api-usage-monitor（版本 1.9.0-rc.4）是一个为 DeepSeek Harness Web 侧边栏设计的 API 用量、余额与费用监控插件，由 ninedaywoo-web 维护。它把 API 余额做成血条，把当天消耗做成架势条，并用「梁子 / 梁圣」提示峰谷时段。
需要先说明两点：这是非官方社区插件，与 DeepSeek 官方无隶属或背书关系；文档截图中的金额为演示数据。代码采用 MIT License。
核心功能¶
插件提供的能力如下：
- 余额血条：显示当前余额相对满血上限的比例，正常消费只扣血，不会莫名回满
- 今日架势条：显示当天消费相对每日预算的比例，充值或刷新血条不会清零
- 峰谷状态：峰段显示「梁子」，谷段显示「梁圣」，点击可展开价格时段、倒计时、余额与计价分桶详情
- 充值与刷新：点击血瓶前往 DeepSeek 官方充值页，充值完成后可手动刷新血条上限
- 一键重启：从侧边栏重启当前 Harness，Windows 使用最小化监督终端，macOS 使用后台监督器
- 状态持久化：重启 Harness 后保留血条基准和当天消费状态
- API 用量、每日费用与 token 跟踪
- 状态栏可拖动临时移位，双击归位
安装与启用¶
先确认使用条件：
- 已配置
DEEPSEEK_API_KEY且能正常运行的 DeepSeek Harness（0.1.0-rc.6或兼容版本） - Node.js
^22.19.0或>=24.0.0
插件不负责安装 Harness，也不会替 Harness 配置 API Key。
然后从 GitHub 的 Releases 页面下载最新的 dsh-plugin-api-usage-monitor-*.tgz，运行下面的命令完成安装，把路径换成你下载的文件：
dsh plugin --profile web add "/absolute/path/to/dsh-plugin-api-usage-monitor-1.9.0-rc.4.tgz"
这条命令把插件加入 web profile。接着运行：
dsh web
启动或重启 Web profile 后，刷新 Harness 网页即可看到侧边栏组件。插件会保留在 web profile 中，之后不需要每次重新安装。
平台支持方面：Windows 10/11 已完成隔离安装测试；macOS 为候选支持，仍需真机验收。macOS 的重启监督器在后台运行，监督日志写入 $DSH_HOME/logs/dsh-balance-bar-supervisor.log。
典型用法¶
经过上面的步骤，插件已经在侧边栏运行，日常操作集中在组件本身：
1、点击血瓶，展开「前往官方充值」和「刷新血条」两个操作。充值完成后点击「刷新血条」，当前余额会成为新的满血上限，今日架势条不会清零。
2、点击「梁子 / 梁圣」，查看当前峰谷状态、倒计时、余额、今日消费和计价分桶。
3、点击圆形箭头，重启当前 Harness。网页会等待新的 Harness 实例真正启动后再恢复。
4、拖动状态栏可以临时移位，双击归位。
其中 Windows 的重启监督器使用一个最小化常驻终端，目的是避免周期性弹出 PowerShell 窗口。
状态存储与卸载¶
插件自己的血条状态存储于 $DSH_HOME/storages/balance-bar-day.json，这也是重启 Harness 后状态能保留的原因。卸载命令如下：
dsh plugin --profile web remove dsh-plugin-api-usage-monitor
卸载不会删除 Harness 会话。如需完全清理，可在 Harness 停止后手动删除上述状态文件。
隐私与安全¶
- API Key 只由 Harness 凭据模块在宿主端读取，不发送到浏览器
- 插件直接向 DeepSeek 官方余额接口读取余额，不上传遥测数据
- 重启接口只接受本机环回地址发出的同源请求
- 安装包不含安装脚本
适用场景与注意¶
它适合这样一类 DSH 用户：同时跑多个会话、关心峰谷计价和每日预算，希望余额扣减在写代码时一眼可见，而不是每次都切去官方平台查账。
安装前注意两点。第一，插件以当前 dsh 进程权限运行，安装前应检查源码与许可证：仓库提供 npm test、npm run preflight、npm pack --dry-run 三条命令用于开发与验证，代码采用 MIT License，但角色图片不在 MIT 授权范围内，详见仓库中的 ASSET-NOTICE.md。第二，macOS 支持尚未完成真机验收，目前以 Windows 10/11 的测试结论为准。
小结¶
dsh-plugin-api-usage-monitor 把余额、每日消费和峰谷时段做成一眼可读的血条与架势条，配合充值跳转和一键重启，减少了在官方平台和开发环境之间的来回切换。DSH 的理念是「一切皆插件」，这类侧边栏组件是社区在补齐使用体验上的一个例子。
- GitHub 仓库：https://github.com/ninedaywoo-web/DSH-Plugin-API-Usage-Monitor
- 社区目录页（独立站点，与 DeepSeek / 幻方无官方从属关系）：https://www.skillhub.cn/plugins/ninedaywoo-web/DSH-Plugin-API-Usage-Monitor
