前言¶

日常用 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 后需重启；仅通过设置页修改则不必重启。

典型用法¶

1. 装好插件并登录 DeepSeek 账号，重启 DSH 后看标题栏是否出现 ¥余额 · ¥今日花费 与「峰/谷」。
2. 悬停读数查看赠送余额、本月累计与更新时间；花费偏高时对照明细里的 token 分项。
3. 若余额经常偏低，在设置里把 lowBalanceThreshold 调高，或 lowBalanceStyle 设为 danger / gradient。
4. macOS 桌面端或 dsh web 无 Windows 那排标题栏菜单时，将 display.position 设为 header 或 sidebar（auto 会自动落到会话标题栏）。

适用场景与注意¶

适合谁：长期在 DSH 桌面端对话、希望随时看到余额和本机日志推算的今日花费、并关心峰谷计价的用户。

安全与权限：插件随当前 DSH 进程在本地运行；余额接口与设置页同源，但花费统计会读会话目录。安装前宜浏览 源码 与 MIT 许可证，确认符合你的环境策略。

已知限制（README 载明）：

• 标题栏 caption 位置仅 Windows 桌面端可用。
• 今日/本月按宿主本机时区划分日历日；峰谷按北京时间；法定节假日未单独建模。
• 花费为价目表参考值，不是官方账单。
• 依赖桌面 preload 标题栏 DOM，DSH 大版本升级后挂载点可能变化。

社区目录（如 SkillHub 插件页）与 GitHub 为独立生态入口，与 DeepSeek / 幻方无官方从属关系；安装方式以仓库说明为准。

结尾¶

dsh-caption-balance 把余额、今日花费和峰谷提示收进标题栏一行，减少反复进设置页的开销。需要图形安装或二次开发时，可查阅目录页与仓库：

• 目录页：https://www.skillhub.cn/plugins/resnowh/dsh-caption-balance
• GitHub：https://github.com/resnowh/dsh-caption-balance