前言¶

在 DeepSeek Harness（DSH）里跑长会话时，token 会涨，钱也会花，但界面往往只给用量投影，不给「按官方规则算出来的本会话花了多少钱」，也不把 DeepSeek 账户余额贴在输入框旁边。自己对照价格页心算，跨高峰与空闲时段时更容易估偏——官方口径是空闲价为高峰价的一半，且计价窗口按北京时间工作日 9:00–12:00、14:00–18:00 划分，节假日另有规则。

dsh-peak-usage（GitHub 仓库名 dsh-plugin-usage，npm 包名 dsh-peak-usage）是维护者 Mirfakk 发布的独立第三方客户端插件，面向 DSH 的 web profile。装上之后，对话输入框下方（conversation.composer.dock 槽位）会多一行实时读数，例如：

高峰 | 本次消费 ¥0.1043 | tokens 100.0k↑ / 4.5k↓ | 缓存命中 88% | 余额 ¥18.32

分别对应：当前峰/谷时段、本会话消费金额、本会话 token 用量（含缓存命中比例）、DeepSeek 账户余额。金额按 DeepSeek 官方峰谷分时定价，对会话日志逐请求用各样本的 event.time 判定时段后折叠计费，而不是用「当前时段单价 × 全部 token」。余额通过官方 GET /user/balance 读取，API Key 仅在宿主进程内通过 ctx.credentials.resolve('DEEPSEEK_API_KEY') 解析，不出宿主。

插件与 DeepSeek 官方、与社区桌面端 DeepSeek-Harness-Desktop 作者均无隶属或背书关系；目录页见 SkillHub，源码见 GitHub。

这是什么¶

• 定位：DSH web profile 的额度面板插件（分类：客户端）。
• 维护者：Mirfakk。
• 版本（package.json）：1.1.0，MIT 许可证。
• 验证环境（README 自述）：官方 @deepseek-ai/dsh 0.1.1-rc.2；社区打包桌面端 DSH Desktop 0.2.18。harness 仍为 -rc 预发布，插件依赖部分内部约定，升级 harness 后可能需要适配。

零 npm 依赖、零构建步骤；lib/client.js 即为浏览器侧最终产物，安装本质是拷贝文件并写入 Cordis 补丁。

核心功能¶

界面读数¶

浏览器侧订阅框架投影 tokenUsage，并在用量变化时同源请求宿主注册的 summary 路由（默认 /plugin/dsh-peak-usage/summary），与 15s 保活兜底配合，在输入框 dock 渲染一行状态。

峰谷分时计价¶

内置官方价表（README 核对于 2026-09-21，来源为 DeepSeek 定价文档），装完即可计费，无需手抄单价。支持模型别名（例如 harness 默认名 deepseek-v4-flash 映射为价表中的 deepseek-flash）。鼠标悬停金额可看高峰/空闲分项。

法定节假日需自行在配置中填写 pricing.schedule.holidays（YYYY-MM-DD 数组）；默认为空时，节假日会按普通工作日规则计价，平日账不受影响。

余额刷新¶

三层机制：后台按 pollIntervalMs（默认 15s）保活；token 投影变化时带 ?fresh=1 触发刷新；强制刷新后 settleDelayMs（默认 3s）再补刷一次。宿主侧 minRefreshIntervalMs（默认 3s）节流，避免频繁打官方余额接口。响应带 fetchedAt / ageMs；过久未更新会在余额旁显示 ?，失败时保留上次成功读数并在 tooltip 说明原因。

配置与关闭计价¶

在 $DSH_HOME/profiles/web/cordis.patch.yml 中调整 dsh-peak-usage 段。Web profile 禁用 HMR，改配置后需重启 DSH 进程并刷新页面。将 pricing.enabled 设为 false 可只显示 token 与余额、不算金额。其余常用项包括 credentialsRef、baseURL、各 pricing.* 刷新与价表覆盖字段，详见仓库 README「配置」一节。

安装与启用¶

npm 包名是 dsh-peak-usage（与 GitHub 仓库名 dsh-plugin-usage 不同；npm 上的 dsh-plugin-usage 已被其他插件占用）。

插件市场（推荐）¶

DSH Desktop 可在 设置 → 插件 中打开 cordis.run 市场，搜索 dsh-peak-usage 安装。

命令行等价做法：

dsh plugin web add dsh-peak-usage

从文件安装（sideload）¶

需生成 .tgz（桌面端不接受 .zip）。在仓库根目录执行：

bash pack.sh

得到 dist/dsh-peak-usage-<版本>.tgz 后，在应用内使用「从文件安装」并传入绝对路径的 tgz。

手动安装到 DSH 用户目录¶

插件只修改 $DSH_HOME（环境变量 → macOS 桌面端 ~/Library/Application Support/com.yeagoo.dsh-desktop/harness → 命令行 ~/.dsh），不修改应用本体。获取源码后在仓库根目录执行：

bash install.sh

脚本会将包拷入 profile 的 node_modules、写入 cordis.patch.yml 并做静态自检。完成后重启 DSH Desktop（或 web 进程），刷新页面；可选执行仓库内的 bash verify.sh 做在线自检（需克隆完整仓库，测试脚本不随 npm 包发布）。

典型用法¶

1. 安装并重启、刷新后，打开任意会话，在输入框下方即可看到峰/谷标签、本会话消费、token 与余额。
2. 若需国庆等假期按「全天空闲」计价，在 cordis.patch.yml 中补充 holidays，例如：

        pricing:
          schedule:
            holidays: ['2026-10-01', '2026-10-02', '2026-10-03', '2026-10-04',
                       '2026-10-05', '2026-10-06', '2026-10-07']

3. 只关心用量与余额、不需要金额时，将 pricing.enabled 设为 false。

4. 维护者建议在改 harness 版本后于克隆的仓库中运行 npm test（97 项离线断言）与 bash verify.sh，确认内部约定未变。

适用场景与注意¶

适合谁：长期在 DSH web 界面开发或调试智能体、需要对照官方峰谷规则看本会话成本、并顺带盯 DeepSeek 余额的开发者。任何能跑 dsh web 的环境理论上可用；README 明确开发与验证路径包含 DSH Desktop 0.2.18。

权限与安全：插件以当前 dsh 进程权限运行，会使用配置的 API Key 请求 api.deepseek.com。安装前应阅读 源码与 LICENSE，确认符合你的安全策略。社区目录 SkillHub 与 DeepSeek / 幻方无官方从属关系，不是官方应用商店。

兼容性：依赖 Session.events、usage 事件形状、conversation.composer.dock 槽位等 harness 内部约定；README 列出了敏感度表，harness 升级后若读数异常，应对照仓库测试与 verify.sh 排查。

结尾¶

dsh-peak-usage 把官方峰谷计价、逐请求会话折叠和余额拉取收到输入框下方一行读数里，减少对照价格页心算的成本。需要安装或配置细节时，以仓库 README 为准。

• 目录页：https://www.skillhub.cn/plugins/Mirfakk/dsh-plugin-usage
• GitHub：https://github.com/Mirfakk/dsh-plugin-usage