DSH-Plugin-API-Usage-Monitor

简体中文 | English

简体中文

一个为 DeepSeek Harness Web 侧边栏设计的 API 用量、余额与费用监控插件：把 API 余额做成血条，把当天消耗做成架势条，并用“梁子 / 梁圣”提示峰谷时段。

非官方社区插件，与 DeepSeek 官方无隶属或背书关系。截图中的金额为演示数据。

它能做什么

功能	说明
余额血条	当前余额相对本管血量上限的比例；正常消费只扣血，不会莫名回满。
今日架势条	显示当天消费相对每日预算的比例；充值或刷新血条不会把它清零。
峰谷状态	峰段显示“梁子”，谷段显示“梁圣”，点击可展开价格时段与余额详情。
充值与刷新	点击血瓶后可前往 DeepSeek 官方充值页，充值完成后可手动刷新血条上限。
一键重启	从侧边栏重启当前 Harness；Windows 使用最小化监督终端，macOS 使用后台监督器。
状态持久化	重启 Harness 后保留血条基准和当天消费状态。

使用条件

• 已经能够正常运行的 DeepSeek Harness，且已配置 DEEPSEEK_API_KEY
• DeepSeek Harness 0.1.0-rc.6 或兼容版本
• Node.js ^22.19.0 或 >=24.0.0
• Windows 10/11 已完成隔离安装测试；macOS 为候选支持，仍需真机验收

插件不负责安装 Harness，也不会替 Harness 配置 API Key。

从 GitHub 安装

1. 在 GitHub 的 Releases 页面下载最新的 dsh-plugin-api-usage-monitor-*.tgz。
2. 在终端运行下面的命令，把路径换成你刚下载的文件：

dsh plugin --profile web add "/absolute/path/to/dsh-plugin-api-usage-monitor-1.9.0-rc.4.tgz"

3. 启动或重启 Web profile：

dsh web

4. 刷新 Harness 网页。插件会保留在 web profile 中，不需要每次重新安装。

日常使用

• 点击血瓶：展开“前往官方充值”和“刷新血条”两个操作。
• 充值完成后：点击“刷新血条”，当前余额会成为新的满血上限；今日架势条不会清零。
• 点击“梁子 / 梁圣”：查看当前峰谷状态、倒计时、余额、今日消费和计价分桶。
• 点击圆形箭头：重启当前 Harness。网页会等待新的 Harness 实例真正启动后再恢复。
• 拖动状态栏：可把它临时放到页面其他位置；双击可归位。

Windows 与 macOS

Windows 的重启监督器使用一个最小化常驻终端，以避免周期性弹出 PowerShell 窗口。macOS 不显示常驻终端，监督日志写入：

$DSH_HOME/logs/dsh-balance-bar-supervisor.log

macOS 真机验收请重点检查：安装、余额读取、点击重启、重启后的状态保留，以及是否出现残留进程。

隐私与安全

• API Key 只由 Harness 的凭据模块在宿主端读取，不会发送到浏览器。
• 插件直接向 DeepSeek 官方余额接口读取余额，不上传遥测数据。
• 重启接口只接受本机环回地址发出的同源请求。
• 安装包不含安装脚本，也不包含作者电脑上的 API Key、会话或余额状态。

卸载

dsh plugin --profile web remove dsh-plugin-api-usage-monitor

卸载不会删除 Harness 会话。插件自己的血条状态位于：

$DSH_HOME/storages/balance-bar-day.json

如需完全清理，可在 Harness 停止后手动删除该文件。

开发与验证

npm test
npm run preflight
npm pack --dry-run

当前自动化测试覆盖余额扣减、手动充值刷新、跨日状态、价格策略、重复重启、崩溃恢复、随机端口和 Windows/macOS 启动方式。

许可证与素材

代码使用 MIT License。角色图片不包含在 MIT 授权范围内，详见 ASSET-NOTICE.md。

---

English

A DeepSeek Harness plugin for API balance monitoring, daily cost and token tracking, peak/off-peak pricing indicators, recharge refresh, and one-click restart. Its game-style interface turns your API balance into an HP bar and today's spend into a posture bar.

This is an unofficial community plugin and is not affiliated with or endorsed by DeepSeek. Amounts shown in screenshots are demo data.

Features

Feature	What it does
Balance HP bar	Shows the current balance relative to the confirmed full-HP baseline. Normal spending lowers HP without unexpectedly resetting it.
Daily posture bar	Shows today's spend relative to the daily budget. Recharging or refreshing HP does not clear it.
Peak/off-peak status	Displays “Liangzi” during peak pricing and “Liangsheng” off peak. Click it for timing, balance, spend, and pricing-bucket details.
Recharge and refresh	The flask opens DeepSeek's official top-up page or manually refreshes the full-HP baseline after a recharge.
One-click restart	Restarts the current Harness from the sidebar, using a minimized supervisor on Windows and a background supervisor on macOS.
Persistent state	Preserves the HP baseline and today's usage state across Harness restarts.

Requirements

• A working DeepSeek Harness installation with DEEPSEEK_API_KEY already configured
• DeepSeek Harness 0.1.0-rc.6 or a compatible release
• Node.js ^22.19.0 or >=24.0.0
• Windows 10/11 has passed an isolated install test; macOS support is a release candidate pending real-device verification

This plugin does not install Harness or configure your API key.

Install from GitHub

1. Download the latest dsh-plugin-api-usage-monitor-*.tgz from GitHub Releases.
2. Run the following command and replace the example with the downloaded file path:

dsh plugin --profile web add "/absolute/path/to/dsh-plugin-api-usage-monitor-1.9.0-rc.4.tgz"

3. Start or restart the web profile:

dsh web

4. Refresh the Harness page. The plugin remains installed in the web profile across future launches.

Everyday use

• Click the flask to reveal Official top-up and Refresh HP.
• After recharging, click Refresh HP. The current balance becomes the new full-HP baseline, while the daily posture bar remains intact.
• Click Liangzi / Liangsheng to open the peak/off-peak card with timing, balance, spend, and pricing-bucket details.
• Click the circular arrow to restart the current Harness. The page waits for a genuinely new Harness instance before reconnecting.
• Drag the widget to detach it temporarily; double-click it to restore its default position.

Windows and macOS

On Windows, the restart supervisor uses one minimized persistent console to prevent recurring PowerShell pop-ups. On macOS, it runs in the background and writes logs to:

$DSH_HOME/logs/dsh-balance-bar-supervisor.log

For real-device macOS acceptance, verify installation, live balance loading, one-click restart, state persistence, and the absence of orphan processes.

Privacy and security

• The API key is resolved by Harness on the host and is never sent to the browser.
• The plugin reads the balance directly from DeepSeek's official endpoint and sends no telemetry.
• The restart endpoint accepts only same-origin requests from the local loopback interface.
• The package contains no install scripts, API keys, conversations, or author-specific balance state.

Uninstall

dsh plugin --profile web remove dsh-plugin-api-usage-monitor

Uninstalling does not remove Harness conversations. The plugin's own meter state is stored at:

$DSH_HOME/storages/balance-bar-day.json

Stop Harness and delete that file manually only if you want a complete state reset.

Development and verification

npm test
npm run preflight
npm pack --dry-run

The automated suite covers spending, manual recharge refresh, day rollover, pricing policies, duplicate restarts, crash recovery, ephemeral ports, and Windows/macOS launch behavior.

License and artwork

Source code is released under the MIT License. Character artwork is not covered by the MIT license; see ASSET-NOTICE.md.