前言¶
用 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 为准。
