前言¶

在 DSH 里跑长对话时，余额和当日消耗往往要切到账户页或另开工具才能看清。浮动小部件能解决问题，但容易挡界面、占点击区域，还带角色动画和菜单。若你只需要「一眼看到数字、不干扰操作」，侧栏底部一行纯文本往往更合适。下面介绍社区插件 dsh-balance-plain（维护者 zeenhuang9-boop，分类：客户端）：把 DeepSeek 余额相关读数嵌进 DSH 侧栏 footer，无鲸鱼、无按压、无音效、无菜单，整层 pointer-events: none。

这是什么¶

dsh-balance-plain 是 DSH 插件，当前版本 0.5.0（见仓库 package.json），按 MIT 许可发布。

一句话定位：在 DSH 侧栏最下方（工作区列表下面、用户名上方）显示一行纯文本，内容包括余额、今日已用、峰谷倒计时、每轮消耗与余额预警；读数作为侧栏 DOM 的一部分插入，不是屏幕坐标上的浮动层。打开左下角账户菜单时，同一读数会临时改出现在菜单里「账户用量，点击刷新」上方。

数据与账本写在 ~/.dsh/.dshw-*.json；服务端仍提供 /dsh-whale/* 路由（与 dsh-whale-widget 同源设计），前端只消费其中部分路由，但本仓库不含鲸鱼图片或音效。

侧栏里长什么样¶

侧栏 footer 自带上分隔线，读数行示例形态如下（README 示意）：

team-project
  · 整理发布清单
docs-site
────────────────────────   ← footer 自带的上分隔线
余额 ¥8.46 · 今日 ¥3.61 · 谷 16h34m
示例账号（账号行）

视觉上无背景板、无边框、无阴影、无图标，文字颜色继承侧栏主题。侧栏收起时读数随 footer 一起消失；找不到侧栏 footer 时不显示，也不回退到浮动层。

核心功能¶

以下能力均来自仓库 README，按模块说明。

余额¶

请求 https://api.deepseek.com/user/balance，默认 10 秒刷新一轮；每轮对话结束会再补刷一次。连续失败 3 次后自动退到 60 秒间隔。每次请求带 refresh=1 以绕过服务端约 25 秒缓存。优先使用 API key，没有则走 DSH 账号登录态。

今日已用¶

通过余额观测账本文件 .dshw-usage.json 累计；充值与赠金单独记账，不冲抵消费。观测间隔为 10 秒。

峰谷标识与倒计时¶

工作日 9–12、14–18 为峰，其余为谷；周末全天按谷价。读数后会跟下一个切换点的倒计时。

每轮消耗¶

按上一轮真实 usage 与峰谷价换算；一轮结束后在余额行上方显示一小行纯文字。开关与关闭延迟在 .dsh-size.json 的 turnCostOn、turnCostCloseMs。

余额预警¶

余额低于阈值时提醒一次，回到阈值以上后重新武装。阈值在 .dshw-usage.json 的 settings.alert.below。

相对 whale 类插件去掉的内容¶

鲸鱼角色、按压弹窗、拖拽吸附、点击泡泡、音效与音效组、角色/图片/音频管理、主菜单及子面板，以及任何鼠标与触摸事件处理。

安装与启用¶

插件以 DSH 进程权限运行，安装前建议浏览 GitHub 仓库 源码与 LICENSE。

Web profile（推荐）¶

官方 README 给出的安装命令如下：

dsh plugin --profile web add https://github.com/zeenhuang9-boop/dsh-balance-plain

不要与 dsh-whale-widget 同时安装：两者注册同一组 /dsh-whale/* 路由、读写同一账本，并都会注入前端脚本。若曾安装 whale 插件，先卸载：

dsh plugin --profile web remove dsh-whale-widget

桌面端（Electron）¶

桌面端 profile 由 Electron 独占，CLI 会拒绝 dsh plugin --profile desktop；桌面安装方式以 DSH 自身插件管理为准，仓库说明未验证桌面一键安装。重载界面可点标题栏右上角 ⟳ 或按 Ctrl+R。

典型用法与配置¶

安装并重载 DSH 后，侧栏 footer 应出现读数行；无需额外菜单操作即可周期性刷新余额与今日消耗。

需要调整预警或每轮消耗展示时，编辑用户目录下的 JSON（路径以 README 为准）：

• 余额预警阈值：.dshw-usage.json → settings.alert.below
• 每轮消耗开关与自动关闭时间：.dsh-size.json → turnCostOn、turnCostCloseMs

开发者在本地调试 UI 时，可打开仓库内 tools/preview.html：用查询参数 ?s=normal|alert|peak|error 切换场景，&turn=1 模拟一轮结束，&dark=1 深色背景，&collapse=1 模拟侧栏收起；页面提供 window.__snapNow() 返回布局快照 JSON。

适用场景与注意¶

适合谁：长期在 DSH Web 或已支持插件的桌面环境里对话、希望余额信息常驻侧栏又不占交互区域的开发者。

结构与主题依赖：读数插在 footer 内 settings-area；启用 dsh-claude-style 主题时用 data-dsh-claude-part~="settings-area" 定位，主题关闭时退回 class（footArea / sidebarCol）。DSH 大改侧栏 DOM 时需要插件重新适配。

账户菜单行：依赖 [role=button]、文案「账户用量」、尺寸与左下角位置等多重判定；大版本改菜单结构时可能只剩侧栏常驻，不会报错。

平台：README 写明仅在 Windows 11 + DSH 桌面版实测；macOS / Linux 未验证。

生态说明：DSH 社区插件目录（如 SkillHub 条目）为独立站点，与 DeepSeek / 幻方无官方从属关系；安装命令与行为以 GitHub README 为准。

结尾¶

dsh-balance-plain 把 DeepSeek 余额、今日消耗、峰谷倒计时、每轮消耗和余额预警收成侧栏 footer 一行纯文本，刻意去掉浮动层与交互，适合「只看数、不点 widget」的工作流。

• 目录页：https://www.skillhub.cn/plugins/zeenhuang9-boop/dsh-balance-plain
• GitHub：https://github.com/zeenhuang9-boop/dsh-balance-plain