前言¶

在 DeepSeek Harness（DSH）里跑长会话、多轮工具调用时，token 用量会分散在轮次与步数里，账户余额也不会按「这一轮对话」实时拆分。若要在界面上直接看到当前会话已产生多少人民币费用，并核对缓存命中、峰谷时段等明细，需要客户端侧根据 provider 上报的用量做本地计价。下面介绍社区插件 dsh-spend-pill（维护者 debug-null）：在 composer dock 增加费用 pill，按 DeepSeek 官方人民币峰谷价目估算，点击可展开明细；不联网、不落盘。

这是什么¶

dsh-spend-pill 是 DSH 的 Web 客户端插件（package.json 中 dsh.client.platform 为 web）。它在输入框下方的 composer dock 里，与系统自带的「轮次/步数」「缓存命中 / Token 用量」并列显示一个费用 pill（例如 ≈ ¥1.05）。金额由会话内 provider 上报的 token 用量推导，内置官方价目与 2026 年法定节假日日历；插件声明依赖 DSH >=0.2.1-rc.1 <0.3.0，许可证为 MIT。

核心功能¶

Composer 费用 pill 与明细弹层¶

• 有计费用量后，dock 行显示本次会话累计人民币估算值。
• 点击 pill 弹出明细：各模型及费用、未缓存输入 / 缓存命中输入 / 缓存写入 / 输出的 token 数与金额、高峰小计、空闲小计与合计；按 Esc 或点击弹层外部关闭。
• 会话尚未产生计费用量时，pill 不显示。

按请求时刻与模型计价¶

• 每次请求结算时，按该次请求的模型和请求发出时刻判定峰谷，再累加；中途切换模型、或一轮跨越 12:00 / 14:00 / 18:00 等边界，均可正确累加。
• 高峰（北京时间）：工作日 9:00–12:00、14:00–18:00；其余时间（含周末与法定节假日）按空闲价（高峰价的一半）。
• 内置 2026 年法定节假日（来源见 README 中的国务院办公厅通知链接）；节假日与周末均按空闲价，而非简单「工作日」判断。

内置价目与回退¶

官方价目为人民币 / 百万 tokens（详见 DeepSeek API 定价文档）：

旧模型 id deepseek-v4-flash、deepseek-v4-flash-vision-exp 按 deepseek-flash 计价。无内置价格的模型（第三方 provider、未来新模型）按 fallbackModel（默认 deepseek-flash）估算，弹层会标注「按 deepseek-flash 价格估算」。

数据与隐私¶

不发起网络请求，不保存任何数据；展示值为参考估算，不是账单，账户余额不在插件范围内。

安装与启用¶

插件尚未发布到 npm，需从 GitHub Release 安装预构建包。在终端执行：

dsh plugin --profile desktop add \
  https://github.com/debug-null/dsh-spend-pill/releases/latest/download/dsh-spend-pill.tgz

也可在 Web 界面 设置 → 插件 → 安装 bundle 中粘贴同一 URL。安装后刷新 Web 页面即可。

典型用法与可选配置¶

日常使用无需额外操作：会话产生用量后观察 dock 上的 pill，需要核对时点击查看明细。若一段会话内切换过模型，弹层会分模型列出费用；token 明细仍按桶汇总。

要在 profile 的 cordis.patch.yml 中覆盖价格、模型别名、回退模型或节假日表，可增加如下片段（prices、aliases 为在内置表上的增量覆盖；holidays 为整表替换，日期为北京时间 YYYY-MM-DD）：

- id: cost-pill
  name: dsh-spend-pill
  config:
    prices:
      my-model:
        peak: { cacheHit: 0.04, cacheMiss: 2, output: 8 }
        offPeak: { cacheHit: 0.02, cacheMiss: 1, output: 4 }
    aliases:
      my-legacy-model: my-model
    fallbackModel: deepseek-flash
    holidays: ['2027-01-01', '2027-02-05', '2027-02-06']

配置变更会改变投影的 stateVersion，已缓存的历史费用会按新配置重新计算。2027 年节假日安排公布后，可通过 holidays 整表替换内置日历。

适用场景与注意¶

适合在 DSH Web 桌面 profile 下开发、调试智能体时，快速感知当前会话的 token 成本结构（含峰谷与缓存分项）。插件以当前 DSH 进程权限运行，安装前请自行查看 源码与许可证；社区目录 SkillHub 插件页 与 GitHub 仓库由维护者发布，与 DeepSeek / 幻方无官方从属关系。

维护者还在掘金写了实现思路一文：给 DeepSeek Harness 写费用插件：把「这次会话花了多少钱」算准，需要了解计价折叠与测试覆盖时可对照仓库中的 lib/cost.js 与 test/cost.test.mjs。

结尾¶

dsh-spend-pill 把「这次会话花了多少钱」放到 composer dock 一行可见处，并按官方峰谷价与 2026 节假日规则本地估算。安装 Release bundle 并刷新页面后即可使用。

• 目录页：https://www.skillhub.cn/plugins/debug-null/dsh-spend-pill
• GitHub：https://github.com/debug-null/dsh-spend-pill