前言¶
在 DeepSeek Harness（dsh）里长时间对话时，token 用量面板能看到本轮用了多少，但「这一问到底花了多少钱」往往要自己对照官方价目表和峰谷时段心算。账户里充值余额和礼金又分两条线，钱包总额也不直观。
dsh-cost-receipt 是社区维护的客户端插件（维护者 divineeagleblackhand），在每条助手回复下方追加一行角标：本轮问答的人民币花费，以及（在最新一轮）账户余额；鼠标悬停可看费用构成饼图。计价按该轮 token 用量与官方峰谷单价计算，算不出价会写明原因，不静默出错。
这是什么¶
一句话：dsh 的「费用小票」——每条回复下面一行钱数，悬停看构成，余额走宿主账号接口。
- 仓库：divineeagleblackhand/dsh-cost-receipt（MIT，当前 npm 版本 0.1.2）
- 分类：客户端（Web / 桌面均可）
- 依赖宿主：需要 dsh 0.2.0-rc.2 及以上提供的 turn-tail 数据与
accountRemote；升级 dsh 后角标消失时，优先核对版本兼容性。
插件自身不联网、不落盘、无运行时依赖；余额由 dsh 宿主通过 account/getBalance 查询（与账号设置页同一路径），不写 localStorage，不读 API Key 或配置文件。
界面上会看到什么¶
装好后，每条回复下方会出现类似一行文字（示例来自 README）：
本次问答花费 ¥0.165824 账户余额 ¥6.2164 礼金余额 ¥1.5366
含义简要说明：
- 本次问答花费：刚结束的这一问一答（一条用户消息 → 最终回复）按当时段定价算出的人民币金额。
- 账户余额：仅充值余额；礼金余额单独一项，两者相加才是钱包总额。没有礼金时第二项不显示。
- 余额只出现在对话最新一轮：历史轮次仍保留当时的「本轮花费」，但余额数字只在最新一轮有意义。
角标上的 HH:MM:SS 表示余额上次变化的时刻（宿主会缓存账号查询），不是「刚查过」的时间；悬停可看最后一次查询时刻，便于判断是读数陈旧还是余额未变。
核心功能¶
按「一问一答」计价¶
每条回复下面一行，对应刚才这一轮。历史轮次也会按该轮结束时刻所在的峰谷时段与当时内置单价重算，打开旧会话仍能看出各轮花了多少。
计价把 token 拆成四桶，分别乘单价后相加：
| 桶 | 说明 |
|---|---|
| 缓存命中输入 | 按官方「缓存命中」价 |
| 未缓存输入 | 按未命中输入价 |
| 缓存写入 | 按未命中输入计价（官方无单独缓存写入价） |
| 输出 | 按输出价 |
单价单位：人民币 / 百万 token，按模型分开，取自官方价目表（维护者在 client.js 顶部 PRICES 常量中维护）。
峰谷与节假日¶
- 高峰（空闲价之外）：北京时间周一至周五 9:00–12:00、14:00–18:00，不含法定节假日。
- 空闲：其余时段。
- 判定与系统时区无关；内置国务院 2026 年节假日安排（19 天）。未收录年份不再做节假日修正，不会故意给错价，只是不再按放假调峰谷。
已知边界：跨峰谷边界的整轮按该轮结束时刻定价，最坏偏差约 50%；整场对话累计只统计已加载进视图的轮次，超长会话分页时累计可能偏低。
悬停饼图¶
鼠标悬停角标时，本次问答与整场对话并排两个环，按花费占比绘制，而不是按 token 占比。README 说明：缓存命中 token 常占用量绝大多数，却可能只占较少花费，按 token 画环会几乎看不见分项。
算不出价时的提示¶
不会用错误模型单价硬套。角标会直接说明，例如：
未收录模型 xxx混用多模型（a + b）用量未标注模型
币种¶
仅支持人民币账户。检测到非人民币钱包时不显示任何金额，只提示「仅支持人民币账户」。
安装与启用¶
推荐从 npm 安装（名称短，可锁版本）：
dsh plugin --profile desktop add dsh-cost-receipt
或从 GitHub 仓库安装：
dsh plugin --profile desktop add https://github.com/divineeagleblackhand/dsh-cost-receipt
也可在 dsh 插件页的「添加插件」中粘贴上述任意一条地址。桌面版 profile 名为 desktop。
装完后刷新页面；若角标未出现，完全退出并重启桌面版。若直连 GitHub 困难，优先用 npm 命令。
典型用法¶
安装并刷新后无需额外配置：正常对话即可。每轮助手回复结束，角标自动出现。
开发或自维护单价表时，仓库提供：
npm test
测试从 client.js 切片执行真实计价逻辑，覆盖峰谷边界、节假日、饼图与角标同源、币种判定等。刷新内置节假日表（维护脚本，不随 npm 包发给用户）：
node tools/fetch-holidays.mjs <年份>
可再传入国务院通知原文 URL 做交叉校验。
隐私、联网与适用注意¶
插件代码不直接发起网络请求：client.js / index.js 中无 fetch、XMLHttpRequest、WebSocket；余额查询完全经由 dsh 宿主。宿主侧约每 30 秒查询一次账号（页面不可见时约每 3 分钟），走的是 dsh 自带账号能力，令牌留在宿主内。
插件只读取当前会话的 token 用量（与 dsh「本轮用量」面板同源），零存储、零凭据访问。
安装前建议：客户端插件在当前 dsh 进程权限下运行，安装前可浏览仓库源码与 MIT 许可证，确认符合你的使用环境。社区目录 skillhub.cn 与 dsh-plugin.org listing 独立于 DeepSeek / 幻方，并非官方应用商店。
适合需要在 Harness 里按轮看清人民币花费、并顺带盯充值/礼金余额的开发者；非 CNY 账户、或未满足 dsh 0.2.0-rc.2 依赖时，功能会受限或不可用。
结尾¶
dsh-cost-receipt 把官方峰谷价目、节假日与本轮 token 用量接到 UI 上，用一行角标回答「这一问花了多少」，并在最新一轮附上账户余额；悬停看花费构成，算不出价则明示原因。插件不自行联网、不落盘，余额与账号页同源。
