DeepSeek Harness 的插件生态强调“一切皆插件”。在使用 Web 客户端时，频繁查看账户余额、今日消耗和剩余 Token 是常见需求。本插件通过在界面左下角悬浮展示，将关键数据浓缩在视觉重心区域，方便实时监控。
这是 DeepSeek Harness Web 客户端的悬浮窗插件，由 yhPrime 维护。它不直接获取数据，而是依赖 dsh-cost-meter 提供的账本，在界面左下角渲染余额血条、估算剩余 token 环和今日消耗横条。
核心功能¶
- 余额血条（红色）：直观展示账户余额。
- 剩余 token 环（蓝色）：根据余额和当前模型单价估算剩余可用 token。
- 今日消耗横条：展示今日输入/输出/缓存的累计消耗。
- 自动刷新与适配：每 60 秒轮询刷新；支持亮/暗/跟随系统主题，自动读取语义色；侧边栏收窄（rail 模式）时自动隐藏。
安装与启用¶
在安装本插件前，必须确保以下环境已就绪：
- DeepSeek Harness 版本 >= 0.1.0-rc.5。
- dsh-cost-meter 插件已安装并启用（版本 v1.3.1+）。
确认环境无误后，使用以下命令安装：
dsh plugin --profile web add /path/to/dsh-balance-floating
安装完成后刷新或重启 Harness，在侧边栏左下角即可看到悬浮窗。
典型用法¶
- 查看详情：将鼠标悬停在圆环或横条上，可查看总额/赠送/充值、估算依据（输入/输出/缓存分项）及调用次数。
- 主题切换：在设置 → 外观中切换主题，悬浮窗配色会自动跟随。
- 空间管理：当侧边栏收窄（rail 模式）时，悬浮窗会自动隐藏，避免挤占内容区域。
配置说明¶
本插件暂无可视化设置页。若需调整刻度或权重，需直接编辑源码中的 lib/client.js。
| 常量 | 默认值 | 含义 |
|---|---|---|
BALANCE_CAP |
100 |
决定血条满血时的额度（¥）。 |
BLEND_INPUT / BLEND_OUTPUT |
0.7 / 0.3 |
决定剩余 token 估算时的输入未命中/输出单价混合权重。 |
注意事项¶
- 依赖强制：本插件不记账、不联网，必须依赖
dsh-cost-meter获取数据。 - 手动配置：修改刻度需直接编辑 JS 文件，无 UI 入口。
- 开源协议：MIT License，源码托管于 GitHub。
