前言¶
用 DeepSeek Harness（DSH）跑 Web GUI 时，对话和页面状态占满注意力，余额却要去别处查。DeepSeek 的 /user/balance 需要 Bearer 密钥，浏览器直连还会被 CORS 拦住，把 Key 写进前端也不合适。下面介绍社区插件 dsh-plugin-balance-float（仓库 Yochor-Debug/dsh-float）：在 Harness Web 每个 index.html 上注入一个可拖拽的悬浮胶囊，同源代理拉余额，不占会话上下文。
这是什么¶
dsh-plugin-balance-float（npm 包名，当前版本 1.1.1，MIT）由 Yochor-Debug 维护，面向已启用 DSH Web profile 的开发者。它在页面一角显示剩余余额与峰/谷计费提示，点击展开明细，双击或面板内按钮可立即刷新；Host 侧提供 GET /x-balance-float 代理，浏览器只访问同源路径，密钥不出现在任何响应里。
核心功能¶
展示与交互¶
- 随页面出现、随页面消失：Host 注入到每次渲染的
index.html，不绑定某次会话，也不消耗对话上下文。 - 收起：余额 + 状态点（绿 / 琥珀 / 红 表示健康 / 偏低 / 耗尽），旁侧小标显示当前小时按 峰 或 谷 计价；
▼提示可展开。悬停不弹层，只有点击才打开详情。 - 展开：总额、赠送与充值余额、最近刷新时间；再次点击胶囊或点空白处关闭。
- 双击（收起或展开均可）立即刷新，↻ 图标旋转作反馈；展开面板里的 ↻ 同理。
- 每 5 秒自动轮询；标签页隐藏时暂停，重新可见时在首帧补一次。
- 可拖拽，限制在视口内，位置写入
localStorage，跟随系统浅色/深色主题。 - 组件在 closed shadow root 中，不在 SPA 的 React 树里，与主应用样式互不影响。
峰 / 谷 小标¶
按 DeepSeek 官方定价说明：峰时为 UTC 周一到周五 01:00–04:00、06:00–10:00（北京时间工作日约 09:00–12:00、14:00–18:00）；其余为谷时，周末全天为谷时。浏览器按 UTC 计算，与机器时区无关，每 5 秒刷新时重算。中国大陆法定节假日未建模：法定工作日放假时，小标可能仍显示「峰」，而实际按谷计费；tooltip 中会说明这一点。
Host 如何读密钥¶
每次请求按顺序解析（不做长期缓存）：
- 环境变量
DEEPSEEK_API_KEY - Harness 凭证服务
ctx.credentials.resolve('DEEPSEEK_API_KEY') - 回退读取
$DSH_HOME/.credentials.yaml
安装与启用¶
环境要求：DeepSeek Harness >= 0.1.5-rc.2（profile bundle 机制）、Node.js >= 18，且本机已配置 DeepSeek API Key（环境变量或 $DSH_HOME/.credentials.yaml 中的 refs.DEEPSEEK_API_KEY）。
安装（命令来自官方 README）：
dsh plugin --profile web add dsh-plugin-balance-float
安装后需 重启 dsh web 再刷新页面。运行中的 dsh 在启动时一次性合成 profile 列表，新装插件不会被已启动进程自动加载。
卸载：
dsh plugin --profile web remove dsh-plugin-balance-float
在 Settings → 插件 → 插件列表 → 全局插件 中可与其他全局插件一样启用或禁用。
典型用法¶
- 按上文安装并重启
dsh web，打开 Web GUI，角落应出现余额胶囊。 - 单击查看总额、分项余额与刷新时间；双击胶囊或点面板 ↻ 强制刷新。
- 拖动到不挡操作的位置，位置会记住。
- 开发插件包本身时，可用仓库内校验脚本（需本地已起 Web 服务时测峰/谷边界）：
node tools/verify-package.mjs
node tools/verify-tariff.mjs http://127.0.0.1:3931/
Host 每次渲染 index 会重读 lib/client.js；若从 GitHub/npm 安装，改 widget 需发布并重新安装；link: 安装则改工作区后刷新页面即可。
适用场景与注意¶
适合：长期在 DSH Web GUI 里调试、跑智能体，希望一眼看到余额和当前峰/谷，又不想把 API Key 暴露给浏览器的人。
注意：
- 插件以当前 dsh 进程权限 运行，安装前请自行查看 源码 与 MIT 许可证。
- 余额数据来自 DeepSeek 接口，受其缓存与上报延迟影响；多币种账户仅显示 DeepSeek 返回的第一种货币。
- 社区目录 SkillHub 插件页 与 DeepSeek / 幻方无官方从属关系；DSH 生态是「一切皆插件」，本包是 Web profile 上的一层 patch，不是官方应用商店内置功能。
结尾¶
dsh-plugin-balance-float 用 Host 代理 + 悬浮 UI，把 DeepSeek 余额和峰/谷提示放进 Web GUI 角落，点击展开、双击刷新，不碰会话上下文。需要时可从 SkillHub 目录页或 GitHub 仓库获取包信息与文档（含 README.zh.md）。
- 目录页：https://www.skillhub.cn/plugins/Yochor-Debug/dsh-float
- GitHub：https://github.com/Yochor-Debug/dsh-float
