前言¶

DeepSeek Harness（DSH）采用插件化架构，开发者在使用过程中常需实时掌握账户余额与当前会话的开销。dsh-balance-hud 旨在为此提供直观的监控界面，通过 HUD（平视显示器）的形式，在 Web GUI 右下角常驻显示关键财务信息。

插件简介¶

dsh-balance-hud 是一个位于 DSH Web GUI 右下角的 HUD 组件。它由维护者 LinHyu-2006 开发，采用 MIT 许可证。该插件的主要功能是显示 DeepSeek 账户余额（含充值与赠送）以及当前会话的实际与估算花费，并提供预算与峰时警告机制。

核心功能¶

1. 常驻显示：始终在 DSH 界面右下角显示 HUD。
2. 余额与花费：
   • 显示账户总余额（充值余额 + 赠送余额）。
   • 显示当前会话花费，包含基于官方价格表的估算值和基于余额减少的实际值。
3. 预算管理：支持设置会话预算与每日预算，并在接近阈值时发出提醒。
4. 峰时警告：支持根据配置的时间提前（5-30分钟）发出峰时/谷时切换警告。
5. 价格同步：提供可选的官方价格同步功能，确保估算数据的准确性。

安装与启用¶

安装过程由插件自带的脚本处理，无需手动拼接命令。

Windows 系统：

tools\install.cmd

macOS / Linux 系统：

sh tools/install.sh

安装脚本会自动查找并使用 DSH 内置的 Node 运行环境，若机器上没有 Node 也会给出提示。

安装完成后，必须重启 DSH 才能使插件生效。DSH 不支持热重载插件，仅刷新页面无法激活新安装的插件。

配置与使用¶

1. 配置参数：
   进入 DSH 的 设置 -> 通用 -> 余额与花费 HUD。在此处可以配置计价模型（如 deepseek-flash）、自动同步价格的间隔、前后台刷新间隔、预算阈值、峰时提醒提前量等参数。
2. 测试插件：
   在安装后或修改配置前，可运行以下命令进行离线测试：

    node tools/smoke.mjs

技术细节与注意¶

1. 安全性与隐私：
   • 插件不触碰 API 密钥。
   • 在未开启“价格同步”功能前，插件不会发起任何网络请求。
2. 数据管理：
   • 会话记录按会话 ID（Session ID）管理。刷新页面或切换会话不会丢失或覆盖其他会话的记录。
   • 外部充值或赠送过期回退，不影响当前会话的花费统计。
3. 系统要求：
   • 需要安装的 DSH 版本范围：>=0.1.7-rc.1 <0.2.0-0 或 >=0.2.0-rc.1 <0.3.0-0。

结语¶

dsh-balance-hud 为 DSH 用户提供了精细化的成本控制与预算管理能力。通过常驻 HUD，开发者可以直观地监控资源消耗。若需要了解更多或查看源码，可访问其社区目录或GitHub 仓库。