前言¶
用 DeepSeek Harness(DSH)跑长会话时,界面里通常能看到 token 用量,但很难直接对照 DeepSeek 官方价目表心算「这一轮、整段对话大概花了多少钱」。官方账单在控制台,和当前聊天窗口不同步;自己按百万 token 单价手算,还要区分高峰/空闲、缓存命中与未命中,容易算错或懒得算。
下面介绍社区客户端插件 dsh-xixi-cost(维护者 xixi0v0):在 DSH Web GUI 两处现有用量信息旁,按 DeepSeek 公开价目表给出人民币参考估算,并可点开明细。金额非官方扣费,实际以 DeepSeek 账单为准。
这是什么¶
dsh-xixi-cost 是 DSH 的客户端类插件(纯前端 bundle,无第三方依赖)。它在 Web 界面里:
- 在每轮助手回复底部操作行,紧贴「用量 X tok」右侧显示本轮花费,例如
≈¥0.042。 - 在输入框下方统计行,紧跟「用量 X tok · 缓存命中」显示整个会话花费,例如
≈¥0.42。
两处均可点击,弹出与官方「用量」胶囊同风格的小面板;点面板外或按 Esc 关闭。
插件在 SkillHub 目录 收录,源码与说明见 GitHub:xixi0v0/dsh-xixi-cost。许可证 MIT,当前包版本 0.1.2(见仓库 package.json)。这是个人开源项目,与 DeepSeek 官方无从属关系。
核心功能¶
界面上的两处标签¶
每轮完成且能拿到 turn-tail.tokenUsage 时,在 [复制][反馈][分支] 一行中,顺序为 [用量][本轮花费][时间]。输入框下方统计行中,会话花费注册在 conversation.composer.dock 插槽,order: 2,紧跟官方 usage(order 1)右侧。
价目与分桶逻辑¶
价目取自 DeepSeek 官方文档 Pricing(README 注明 2026-11-03 读取),单位:人民币 / 百万 tokens。插件内置表涵盖 deepseek-flash 与 deepseek-v4-pro 在高峰、空闲下的缓存命中输入、未命中输入与输出单价;思考(reasoning)token 计入输出。高峰为北京时间周一至周五 09:00–12:00、14:00–18:00(README 说明不含法定节假日单独判断);其余为空闲,价格为高峰一半。
单轮费用用聊天快照里该轮已算好的 turn-tail.tokenUsage 分桶,按本轮结束时刻的价目与路由计价。会话合计不依赖分页快照求和,而是通过宿主会话投影 xixiCost 折叠整份已提交会话日志,按「模型 + 每轮结束时段」累加;进行中的本轮放在 active,客户端按当前时段补价。弹层可展示缓存命中/未命中输入、输出(含思考)各多少 token、对应金额,以及进行中本轮的补差说明。
实现要点(便于排查)¶
- 宿主侧:
lib/projection.js注册投影,只读日志、不改会话事件。 - 客户端:
lib/client.js乘价目表并注册两个插槽;明细用react-domportal 挂到document.body;样式使用--dsw-*主题变量。 - 认不出价目的路由或未知模型:该轮不显示逐轮标签,也不计入会话金额与明细分桶,避免错误数字。
- Search / Fetch 等官方单独计费的请求费(README 写 5 元 / 1000 次)不计入。
安装与启用¶
需要较新的 DSH 桌面版(Web GUI)。安装后须重启一次 DSH(启动时读取组合清单)。本机需能访问 GitHub,并安装 Git(否则可能出现 ERR_PNPM_GIT_RESOLVE_FAILED)。将下面命令里的 desktop 换成你实际使用的 profile 名。
从 GitHub 安装:
dsh plugin --profile desktop add github:xixi0v0/dsh-xixi-cost
建议锁定 commit,避免上游变动:
dsh plugin --profile desktop add github:xixi0v0/dsh-xixi-cost#<完整 commit 哈希>
若曾安装旧包名 dsh-turn-cost,请先移除再装,否则会出现两份标签:
dsh plugin --profile desktop remove dsh-turn-cost
卸载与升级:
dsh plugin --profile desktop remove dsh-xixi-cost
dsh plugin --profile desktop add github:xixi0v0/dsh-xixi-cost
插件以当前 DSH 进程权限运行;安装前可在 GitHub 查看源码与 MIT 许可证,自行判断是否信任。
典型界面效果¶
README 中的示意(数值仅为示例):
DeepSeek 回复……
[复制] [反馈] [分支] 用量 443.7k tok ≈¥0.042 10:34
┌ 输入框 ──────────────────────────────────┐
│ … │
└──────────────────────────────────────────┘
12 轮 · 45 步 · 18.2 tok/s 443.7k tok · 缓存命中 91% ≈¥0.42 ◔82%
点击会话花费胶囊后,面板示例字段包括:整个会话花费、模型、高峰/空闲单价说明、缓存命中与未命中输入、输出(含思考)token 与金额、进行中本轮、合计及「按全量会话日志逐轮累计」的说明文字。
适用场景与注意¶
适合谁:长期在 DSH Web GUI 里开发或调试智能体、希望对照 token 用量快速感知人民币量级、又不愿每次去控制台对账的用户。
务必知晓的限制(均来自 README「已知限制」):
- 所有金额为价目表 + token 用量的估算,实际扣费以 DeepSeek 官方账单为准。
- 法定节假日未单独区分,节假日当天高峰时段可能略高估(最多约一倍)。
- 每轮跨高峰/空闲边界时,以本轮结束时刻计价,属于近似。
- 会话合计与聊天窗口当前加载多少轮无关;进行中本轮在用量样本到达前可能短暂滞后。
- 简洁(compact)模式下官方可能不显示 token 用量,本插件仍会显示花费标签。
- 依赖 DSH 客户端插槽与
sessionProjections;DSH 大版本若内部结构变化,最坏情况是标签不显示,不应导致聊天界面报错。
DSH 生态理念是「一切皆插件」;SkillHub 等社区目录为独立站点,与 DeepSeek / 幻方无官方从属关系,本插件亦非官方出品。
结尾¶
dsh-xixi-cost 把 DeepSeek 公开价目与 DSH 已有 token 分桶接到 Web GUI 两处用量旁,方便在本地会话里做花费量级参考。需要安装命令、价目表字段与投影实现细节时,以仓库 README 为准。