API 用量监控ninedaywoo-web/DSH-Plugin-API-Usage-Monitor

DSH API 用量监控

简体中文 | English

简体中文

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

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

DSH API Usage Monitor 主界面

它能做什么

| 功能 | 说明 |
| --- | --- |
| 余额血条 | 当前余额相对本管血量上限的比例；正常消费只扣血，不会莫名回满。 |
| 今日架势条 | 显示当天消费相对每日预算的比例；充值或刷新血条不会把它清零。 |
| 峰谷状态 | 峰段显示“梁子”，谷段显示“梁圣”，点击可展开价格时段与余额详情。 |
| 充值与刷新 | 点击血瓶后可前往 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.

DSH API Usage Monitor overview

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. |
| 每日姿态条 | 显示今日支出相对于每日预算的情况。充值或刷新 HP 不会清除它。 |
| 高峰/低谷状态 | 在高峰定价期间显示“Liangzi”，在低谷期间显示“Liangsheng”。点击可查看时段、余额、支出和定价档位详情。 |
| 充值与刷新 | 烧瓶图标会打开 DeepSeek 官方充值页面，或在充值后手动刷新满 HP 基线。 |
| 一键重启 | 从侧边栏重启当前 Harness，在 Windows 上使用最小化的 supervisor，在 macOS 上使用后台 supervisor。 |
| 持久状态 | 在 Harness 重启之间保留 HP 基线和今日使用状态。 |

充值与重启操作

高峰与低谷状态卡片

要求

- 已安装可用的 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 或配置你的 API 密钥。

从 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 中。

日常使用

- 点击烧瓶图标可显示 Official top-up 和 Refresh HP。
- 充值后，点击 Refresh HP。当前余额将成为新的满 HP 基线，而每日姿态条保持不变。
- 点击 Liangzi / Liangsheng 可打开高峰/低谷卡片，其中包含时段、余额、支出和定价档位详情。
- 点击圆形箭头可重启当前 Harness。页面会等待真正新的 Harness 实例后再重新连接。
- 拖动小组件可将其临时分离；双击可恢复其默认位置。

Windows 和 macOS

在 Windows 上，重启 supervisor 使用一个最小化的持久控制台，以防止反复弹出 PowerShell 窗口。在 macOS 上，它在后台运行，并将日志写入：

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

对于 macOS 真机验收，请验证安装、实时余额加载、一键重启、状态持久化以及无孤儿进程。

隐私与安全

- API 密钥由主机上的 Harness 解析，绝不会发送到浏览器。
- 插件直接从 DeepSeek 官方端点读取余额，不发送任何遥测数据。
- 重启端点仅接受来自本地回环接口的同源请求。
- 该包不包含安装脚本、API 密钥、对话或作者特定的余额状态。

卸载

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 许可证 发布。角色美术素材不在 MIT 许可证的覆盖范围内；请参阅 ASSET-NOTICE.md。