前言¶
DeepSeek Harness（DSH）输入框旁的 token 胶囊可以打开「Token 用量」弹窗，里面会汇总缓存命中比例、未缓存输入、缓存读取和输出等 token 数。这些数字对排查上下文占用很有用，但弹窗本身不会把四个数折算成人民币，也不会说明当前是按高峰还是空闲价计价、距离时段切换还有多久。若你关心单场会话的大致花费，或需要在高峰/空闲切换前调整用法，只能自己对照官方价目表心算。dsh-cost-row 是 Song2012 维护的客户端插件，在不动宿主代码的前提下，往同一弹窗末尾追加费用估算、计价时段和切换倒计时三行，计价规则对齐 DeepSeek 官方文档。
这是什么¶
插件仓库：song2012/dsh-cost-row，社区目录页：skillhub.cn 条目。当前 package.json 版本为 0.1.0，许可证 MIT。它只运行在 DSH Desktop 的 Web 前端：用 MutationObserver 监听页面，在发现带 data-session-stats-usage 的用量定义列表后，读取已有 <dt>/<dd> 数值，计算金额并追加 DOM，样式继承弹窗自带的定义列表。
弹窗里会多出什么¶
装好后，Token 用量弹窗在原有行之下大致会多出：
Token 用量 22,465,609 tok
缓存命中 98%
未缓存输入 499,056 tok
缓存读取 21,861,632 tok
输出 104,921 tok
费用 ≈ ¥2.71 ← 新增
计价时段 高峰 ← 新增
切换时间 今天 18:00 · 剩 1:12:34 ← 新增，每秒走字
「费用」是按官方价目表对弹窗里四个 token 分量加权求和的结果。「计价时段」表示当前按高峰还是空闲单价。「切换时间」是当前计价时段的结束时刻（今天 / 明天 / 周几 + 钟点）和剩余倒计时；弹窗保持打开时每秒刷新，便于判断何时进入或退出高峰。
计算口径¶
价目来源：DeepSeek 官方 pricing 文档，单位：人民币 / 百万 tokens。
| deepseek-flash | deepseek-v4-pro | |
|---|---|---|
| 输入·缓存命中（空闲 / 高峰） | 0.02 / 0.04 | 0.15 / 0.30 |
| 输入·缓存未命中（空闲 / 高峰） | 1 / 2 | 4.5 / 9 |
| 输出（空闲 / 高峰） | 4 / 8 | 13.5 / 27 |
峰谷判定（README 说明，只依赖绝对时间，不受本机时区影响）：
- 北京时间周一至周五 09:00–12:00、14:00–18:00 为高峰；
- 其余时段（含周末）为空闲，空闲价 = 高峰价的一半。
公式：
未缓存输入 × 未命中价 + 缓存读取 × 命中价 + 缓存写入 × 未命中价 + 输出 × 输出价
官方表未单独列出缓存写入价，插件按未命中输入价计缓存写入。金额一般保留两位小数；不足 1 分时保留四位。
模型单价取自输入框旁模型选择器当前的 data-model-id：ID 含 flash 用 Flash 表，含 v4-pro 用 Pro 表；不在价目表内的 ID（例如部分第三方模型 ID）按 Flash 价兜底，费用行 tooltip 会标注「未在价目表内」。
安装与启用¶
先把插件目录放到本机可访问路径，再执行 README 中的安装命令（路径需换成你的绝对路径）：
dsh plugin --profile desktop add link:/absolute/path/to/dsh-cost-row
安装完成后重启 DSH Desktop（宿主在启动时读取 profile）。重启后点击输入框旁的 token 胶囊打开弹窗，应能看到「费用」等新增行。
卸载：
dsh plugin --profile desktop remove dsh-cost-row
典型用法¶
没有单独的配置文件或 CLI 子命令：启用插件并重启 Desktop 后，用法就是平时查看 Token 用量弹窗。
- 在 DSH Desktop 中照常对话，需要看消耗时点 token 胶囊。
- 对照「费用」行了解当前会话的估算人民币成本。
- 看「计价时段」与「切换时间」，判断是否处于高峰以及距离下一时段还有多久。
若中途在模型选择器里切换模型，费用行会跟随当前 data-model-id 的单价；弹窗里的 token 仍是整场会话汇总，中途换模型时全部 token 会按当前模型计价，可能出现高估或低估（README「已知限制」中已说明）。
适用场景与注意¶
适合：长期在 DSH Desktop 里跑 agent、希望在同一块 UI 里同时看到 token 分项与大致账单，并关心峰谷计价的开发者。
限制（均来自 README，安装前建议通读）：
- 整场会话按一个模型计价，中途换模型时估算可能偏差。
- 法定节假日与调休未纳入峰谷逻辑，仅按周一至周五钟点判高峰，调休日可能按高峰价高估（约 2 倍）。
- 依赖
dl[data-session-stats-usage]与模型选择器data-model-id两个 DOM 锚点；上游改结构时，费用行可能静默不显示或退回 Flash 价，弹窗本体不受影响。
DSH 生态强调「一切皆插件」；SkillHub 等目录由社区维护，与 DeepSeek / 幻方无官方从属关系。客户端插件在本机 DSH 进程权限下运行，安装前应自行查看仓库源码与 MIT 许可证。
结尾¶
dsh-cost-row 把官方价目表与峰谷规则接到现有 Token 用量弹窗上，补费用、时段和倒计时三行，纯浏览器侧注入，不改宿主。需要细节、Issue 或自行构建时，见 GitHub：https://github.com/Song2012/dsh-cost-row；目录介绍见 https://www.skillhub.cn/plugins/Song2012/dsh-cost-row。
