前言¶
日常用 DeepSeek Harness（DSH）跑对话时，余额和 token 消耗往往要打开「设置 → 账号与余额」或自己翻日志才能对齐。计价还有峰谷时段差异，高峰单价会翻倍，单靠账单页也不总能一眼看出「今天大概花了多少」。社区插件 dsh-caption-balance 把账户余额、本机会话推算的今日花费，以及当前峰/谷提示嵌进桌面端标题栏（「应用 / 编辑」菜单右侧），悬停可看明细，点击可立即刷新。
下面按定位、功能、安装配置与注意事项说明用法，事实以 GitHub 仓库 README 为准。
这是什么¶
dsh-caption-balance 由 resnowh 维护，分类为 DSH 客户端插件（package.json 中 dsh.client.platform 为 web）。它在 Harness 界面里渲染一行实时读数：默认落在桌面端标题栏，也可改到会话标题栏或侧边栏底部。
余额走官方账号服务（与「设置 → 账号与余额」同源，插件不接触凭证）；今日花费由本机 $DSH_HOME/sessions 下会话日志统计 token，再按 profile 里配置的价目表折算，并附带当前计价时段的单字提示（峰/谷）。
核心功能¶
标题栏典型展示形如：
应用 编辑 ¥61.05 · ¥4.04 谷
已核实的能力包括：
- 账户余额：通过宿主侧
deepseekAccount.getBalance读取，带超时与缓存（默认balanceRefreshSeconds: 180）。 - 今日花费：解析会话日志
session*.jsonl.zstd中assistant/message的data.usage，按models下「元 / 百万 tokens」的空闲价计算；高峰按peakMultiplier（默认 2）倍计。 - 峰 / 谷：北京时间工作日 9:00–12:00、14:00–18:00 为
峰（×2），其余为谷；高峰时「峰」字可呈琥珀色。 - 低余额提示：低于
lowBalanceThreshold时余额可变琥珀/红色，或选gradient在两端颜色间过渡。 - 悬停明细：赠送余额、今日/本月 token 与花费、当前时段、更新时间等。
- 刷新：点击立即刷新；默认每
refreshSeconds（30）秒轮询，且刷新时数字等宽、小数默认可缩小一号以减少跳动。 - 显示项与位置：余额、今日花费、峰谷单字可分别开关；
position支持auto/caption（桌面标题栏）/header（会话标题栏）/sidebar。
宿主提供本机可用的 GET /api/dsh-caption-balance/summary；客户端按 display.position 注入到标题栏菜单、会话 utilities 或侧边栏底部。
环境与安装¶
要求 DeepSeek Harness 0.2.2-rc.1 及以上（package.json 中 engines.dsh 为 >=0.2.2-rc.1 <0.3.0-0）。当前包版本 0.5.1，许可证 MIT。
图形界面¶
侧栏 插件 → 添加插件（或「安装第三方插件」），粘贴仓库地址：
https://github.com/resnowh/dsh-caption-balance
安装后点「立即启用」，重启应用生效（桌面版无刷新页面快捷键）。
命令行¶
dsh plugin --profile desktop add github:resnowh/dsh-caption-balance
--profile 换成你要安装的 profile 名（桌面端默认 desktop）。
安装后同样需要重启应用。插件需声明 dsh.bundle.patch 才能被 dsh plugin add 识别，本仓库已包含 cordis.patch.yml。
配置¶
Profile 中的 YAML¶
在 profile 的 cordis.patch.yml 里，dsh-caption-balance 条目下的 config 可写默认值，例如：
- id: dsh-caption-balance
name: dsh-caption-balance
config:
currency: CNY
refreshSeconds: 30
balanceRefreshSeconds: 180
display:
position: auto
showBalance: true
showToday: true
showPhase: true
lowBalanceThreshold: 10
lowBalanceStyle: warn
models:
deepseek-flash:
cacheHit: 0.02
cacheMiss: 1
output: 4
价格单位为「元 / 百万 tokens」，填空闲时段单价；未配置单价的模型仍统计 token，但不计入花费。官方调价后需自行更新 models 与 aliases。
设置界面（无需改 YAML）¶
- 设置 → 余额显示
- 插件页 → 余额显示 → 配置区
两处是同一表单。保存后立即生效，用户覆盖写入 ~/.dsh/plugin-data/dsh-caption-balance/settings.json，优先于 profile 默认值。点「恢复默认」等价于删该文件并回到部署默认。
改 profile 里 YAML 后需重启；仅通过设置页修改则不必重启。
典型用法¶
- 装好插件并登录 DeepSeek 账号，重启 DSH 后看标题栏是否出现
¥余额 · ¥今日花费与「峰/谷」。 - 悬停读数查看赠送余额、本月累计与更新时间；花费偏高时对照明细里的 token 分项。
- 若余额经常偏低，在设置里把
lowBalanceThreshold调高，或lowBalanceStyle设为danger/gradient。 - macOS 桌面端或
dsh web无 Windows 那排标题栏菜单时，将display.position设为header或sidebar（auto会自动落到会话标题栏）。
适用场景与注意¶
适合谁：长期在 DSH 桌面端对话、希望随时看到余额和本机日志推算的今日花费、并关心峰谷计价的用户。
安全与权限：插件随当前 DSH 进程在本地运行；余额接口与设置页同源，但花费统计会读会话目录。安装前宜浏览 源码 与 MIT 许可证，确认符合你的环境策略。
已知限制（README 载明）：
- 标题栏
caption位置仅 Windows 桌面端可用。 - 今日/本月按宿主本机时区划分日历日；峰谷按北京时间；法定节假日未单独建模。
- 花费为价目表参考值，不是官方账单。
- 依赖桌面 preload 标题栏 DOM，DSH 大版本升级后挂载点可能变化。
社区目录（如 SkillHub 插件页）与 GitHub 为独立生态入口，与 DeepSeek / 幻方无官方从属关系；安装方式以仓库说明为准。
结尾¶
dsh-caption-balance 把余额、今日花费和峰谷提示收进标题栏一行，减少反复进设置页的开销。需要图形安装或二次开发时，可查阅目录页与仓库：
