DSH（DeepSeek Harness）插件生态强调“一切皆插件”。在开发智能体或调用 API 时，最常见的问题之一是消耗不可见：账号余额剩多少、今日用了多少、会不会突然超额。现有的做法要么依赖网页端手动刷新，要么缺乏对消耗上限的主动拦截。dsh-balance-monitor 将这些数据直接接入 DSH 左侧工作栏，提供整页面板与侧边栏小组件。
插件概况¶
这是一个 DS H 插件，目标是在左侧任务栏实时显示 API 账户余额。它支持多平台余额检测、峰谷计价、会话与每日消耗统计，并提供可配置的消耗上限。插件适配 Web 端与桌面端，代码运行在同一份逻辑上。作者为 ConTr0L0，类别为联网工具，采用 MIT 许可证。
核心能力¶
-
左侧栏整页面板与小组件
- 插件会在左侧栏新增“余额监控”入口（排在插件/使用统计之间）。
- 点击该入口，会在主区整页渲染完整面板，包含余额、统计图表、上限设置等。
- 侧边栏底部小组件实时显示账户余额、今日消耗、上限进度与峰谷状态。
-
多平台余额检测
- 支持的平台包括 DeepSeek 官方（账号登录或 API Key）、智谱 GLM、OpenRouter 和 Tavily。
- DeepSeek 官方支持通过已登录账号读取（Platform 钱包：充值 + 赠金），无需 API Key。
- 设置中可选择余额来源优先级：自动（账号优先，未登录回退 API Key）、仅账号登录、仅 API Key。
-
峰谷计价与自动同步
- 插件内置 DeepSeek 官方规则：北京时间周一至周五 9:00-12:00、14:00-18:00 为高峰；周末及中国法定节假日全天为谷时（谷时半价）。
- 价目表由插件自动从 DeepSeek 官方文档同步并每日验证，无需手动配置。
- 请求按实际发生时间计算价格，同步失败时回退到内置默认价目。
-
消耗统计与图表
- 支持近 7 天消耗柱状图、每日 Token 堆叠图（7/14/30 天，可按模型筛选）。
- 提供消耗热力图（30 天/90 天/一年），按计价金额着色，悬停查看金额与 Token。
- 展示全部会话消耗列表，按最近排序。
-
消耗上限与拦截
- 支持三类消耗上限：每日金额、累计金额、LLM 请求次数。
- 可配置超限行为：仅提醒 或 提醒并终止。
- 选择“提醒并终止”时，服务端会在后续 LLM 请求发生时进行拦截并返回明确报错。
安装与启用¶
安装前需确认 DSH 版本不低于 0.2.0-rc.2。安装后必须完全退出并重启 DSH（桌面端需从托盘 Quit，浏览器版需刷新页面）。
安装命令¶
dsh plugin --profile web add github:ConTr0L0/dsh-balance-monitor
桌面端注意事项¶
桌面端使用保留的 desktop profile，CLI 命令无法直接管理。请通过 DSH 应用内的 插件页 → Add plugin → 填写本地目录路径 进行安装。
典型用法¶
- 打开面板：在左侧栏点击“余额监控”打开完整面板。
- 配置 Key：在面板中填写各平台的 API Key（支持掩码显示，值不经过客户端）。
- 调整刷新：选择刷新频率（5s / 30s / 60s）。
- 设置上限：进入设置页，配置三类消耗上限及超限行为。
- 查看详情：点击侧边栏小组件或面板中的余额数字，可切换平台并查看详细的消耗图表与列表。
计费与数据说明¶
- 数据来源：DSH 会话日志（
session.l.zstd等）。插件按assistant/message的唯一message.id去重后再计费。 - 计算逻辑：每次 LLM 请求根据输入/输出/缓存命中分别计价。价格根据请求时间判断是否为高峰，高峰按原价，谷时（周末/节假日）乘以 0.5。
- 模型与供应商：收录 DSH 日志中所有供应商的 usage。DeepSeek 官方按官方价目计费，其他供应商仅统计 Token。
- 价目同步：插件每日自动验证并更新价目表（源：DeepSeek 官方文档页）。
技术与架构¶
- 服务端：位于
lib/index.js，负责会话日志解析、余额轮询、上限拦截。 - RPC 通道：位于
lib/rpc.js，通过POST /dsh-balance-monitor/<endpoint>前缀路由提供服务，带 Host/Origin 校验。 - 客户端：位于
lib/client.js，注册了sidebar.panellist、main和sidebar.footer.action三个插槽。 - 存储：状态存储于
$DSH_HOME/storages/dsh-balance-monitor/state.json，偏好存储于prefs.json，均为原子写入。
生态背景¶
DSH 理念为“一切皆插件”。本插件收录于社区目录，与 DeepSeek 官方无从属关系。安装前建议检查源码与许可证。
参考链接¶
- GitHub 仓库：https://github.com/ConTr0L0/dsh-balance-monitor
- 社区目录：https://www.skillhub.cn/plugins/ConTr0L0/dsh-balance-monitor
