中文 · English

dsh-receipt — 会话消费小票插件

为 DeepSeek Harness Web GUI 增加"小票"：在每个会话的头部栏放一个小票按钮， 点击弹出该会话的消费小票（收据样式），展示：

• 按模型明细：模型名称、调用次数、输入 / 缓存读 / 缓存写 / 输出 / 推理 token、小计费用；
• 合计：调用次数、token 合计、模型耗时、会话跨度；
• 金额：按模型定价表折算的费用（默认 ¥，货币符号可配置）；
• 出票时间：最后一条计入事件的时间。

数据由 host 端 receipt 会话投影单元从会话日志折叠（复用 assistant/message 的 usage 与模型来源），随 session/projection 帧实时刷新；界面只负责展示， 不发任何 RPC。

安装

推荐从 GitHub 安装（无需本地构建）：

# 从 DeepSeek Harness checkout 目录执行（web profile 与 GUI 所在 profile 一致时）
pnpm dsh plugin --profile web add github:bluechips-zhao/dsh-receipt

如果不熟悉命令行/安装，也可以直接把本仓库链接 https://github.com/bluechips-zhao/dsh-receipt 发给你的 AI 助手（如 DeepSeek Harness / 其他 AI）， 让它照着本 README 的安装步骤帮你自动执行 dsh plugin 安装命令即可。

安装后重启 GUI（小票按钮出现在会话头部右侧；打开会话后点击"小票"）。

发现更多插件

本插件通过 GitHub 的 dsh-plugin 主题标签 公开，可在该标签页浏览官方与社区插件仓库；如需可视化、应用商店式的浏览体验， 也可前往社区维护的 DSH-Plugin Hub（第三方站点，非 DeepSeek 官方运营）。

仓库提交了构建好的 lib/（exports 指向 lib/index.js 与 lib/client.js）， 因此用户安装的是开箱即用的产物，无需重复构建。若你把本仓库改名或移到别的 命名空间，请同步替换上面 github:bluechips-zhao/dsh-receipt 段。

依赖、权限与兼容性

• 外部依赖：无外部服务、无网络请求、无命令执行。运行期只读 host 侧的 receipt 投影与 useSessions 行数据；依赖全部走 peer / profile fallback （$DSH_HOME/profiles/node_modules），不复制 Cordis / React / schemastery 的运行时身份。
• 权限：运行时代码（lib/index.js、lib/client.js）只注册一个投影单元与两个 slot 座位——不访问文件系统、不读取凭据、不启动子进程。host 半 inject 仅 sessionProjections；client 半 inject 仅 sessions / slots / locale。
• 构建期信号：仓库内 tsdown.config.ts 用 node:fs 读取/校验产物、 scripts/* 读取若干环境变量，这些属于构建与自检工具链，不随包分发 （files 只含 lib/ 与文档）。静态扫描若把它们计为权限信号，属构建面而非运行面。
• 兼容性：Node.js ^22.19.0 || >=24；DSH 逐版本声明见 package.json 的 dsh.compatibility.dshReleases（当前在 0.1.5-rc.1 上完成宿主半的 typecheck 与 投影折叠自检；客户端半要求界面包与宿主安装在同一版本线上）。
• 已知边界：费用是按配置定价表做的本地估算，非账单口径；定价表未声明的模型 以"未计价"展示；峰谷时段按样本事件时间（本机时钟）判定。

构建（维护者）

只有插件作者/维护者需要构建；普通用户直接安装 lib/ 产物即可。

前置：本机有 DeepSeek Harness checkout，且已 pnpm install 构建过 （node_modules/.bin/tsc、tsdown 可用）。本插件的构建依赖该 checkout 的 harness 平台模块表与 lightningcss，因此需在本仓库内建立两个 junction：

# 在 dsh-receipt 目录内，按你本机布局调整目标路径
New-Item -ItemType Junction -Path node_modules -Target "$env:USERPROFILE\.dsh\profiles\node_modules"
New-Item -ItemType Junction -Path harness     -Target "<你的 DeepSeek Harness checkout 路径>"

然后：

pnpm run build      # tsc host + client 类型检查与产物，tsdown 出 lib/index.js + lib/client.js

产物契约：lib/index.js（host 插件入口）、lib/client.js（browser bundle， window.__ModuleLoader__.load 包装）、lib/types/**（类型）。构建目标是把 lib/ 更新到与 src/ 一致；改动 src/ 后请在发布前重新构建并提交 lib/。

配置（定价）

插件内置 DeepSeek 官方定价页公开的单价的空闲（谷底）时段价——当前在售的 deepseek-flash（V4.1-Flash）与 deepseek-v4-pro，以及历史经典模型；其余模型显示 "未计价"、费用记 0。分时（峰谷）计价由折叠按样本时间自动处理（见下节）。要覆盖默认价， 在 profile 的 cordis.patch.yml 里对 dsh-receipt 行覆盖 config（整段替换）：

# 在你的 profile 的 cordis.patch.yml 中（如 <DSH_HOME>/profiles/web/cordis.patch.yml）
- id: dsh-receipt
  config:
    currency: ¥
    pricing:
      # 下列三项已内置，此处仅作覆盖示例；单位 ¥/1M tokens，写空闲（谷底）时段价
      deepseek-flash: { input: 1, cacheRead: 0.02, output: 4 }
      deepseek-v4-pro: { input: 4.5, cacheRead: 0.15, output: 13.5 }
      deepseek-chat: { input: 2, cacheRead: 0.5, output: 8 }

• 单价单位：每 1M token 的货币额；字段：input / cacheRead / cacheWrite / output / reasoning，缺省按 0 计。
• 键优先精确模型 id，其次 provider/model 复合键，再次同价别名基准模型 （本插件不做跨 provider 冲突合并）。
• 同价别名：已下线的旧名 deepseek-v4-flash、deepseek-v4-flash-vision-exp 仍可调用，由 DeepSeek-V4.1-Flash 提供服务并按 Flash 价格计费，故内置 PRICING_ALIASES 把它们映射到 deepseek-flash；若单独配置旧名，则以它自己的价格为准。
• currency 只影响展示符号；改配置由 profile 配置 HMR 实时生效，无需重启。

分时（峰谷）定价说明（官方定价页）

DeepSeek 现行模型采用分时计价。官方模型 & 价格页脚注(3) 定义：

• 高峰时段：北京时间周一至周五 9:00–12:00、14:00–18:00（共两个窗口）。
• 空闲时段：上述高峰窗口之外的时间，含周六、周日全天。
• 空闲时段价格为高峰时段价格的一半（即高峰 = 空闲 ×2，对应内置 peakMultiplier: 2）。

模型	时段	输入(缓存未命中)	输入(缓存命中)	输出
deepseek-flash（V4.1-Flash）	空闲（含周末全天）	¥1	¥0.02	¥4
deepseek-flash	工作日高峰 9:00–12:00、14:00–18:00	¥2.0	¥0.04	¥8.0
deepseek-v4-pro（V4-Pro-0813）	空闲（含周末全天）	¥4.5	¥0.15	¥13.5
deepseek-v4-pro	工作日高峰 9:00–12:00、14:00–18:00	¥9.0	¥0.30	¥27.0

小票按 step 样本时间折叠峰谷：内置默认价写的是空闲时段价，落在工作日高峰窗口的样本 按 peakMultiplier（默认 2）计，周末全天按谷底价计。因此小票金额本身就是分时精确的， 无需再手动乘 2；要改窗口或倍率，配置 peakHours / peakMultiplier 即可。

命名与下线提醒（官方定价页脚注 1、2）：新模型名请用 deepseek-flash；旧名 deepseek-v4-flash、deepseek-v4-flash-vision-exp 仍可调用，但由 V4.1-Flash 提供服务 并按 Flash 价计费（已内置别名）。北京时间 2026-09-14 12:00 起、至 V4.1 Pro 上线前， deepseek-v4-pro 的请求将全部路由到 V4.1-Flash 并按 Flash 价格计费——该日期之后 若你仍在使用 deepseek-v4-pro 这个名字，实际账单会低于小票按 V4-Pro 单价算出的金额； 此时可把该条目改成 Flash 价，或删掉它让内置别名生效。

验证

# 投影折叠逻辑单元断言（无依赖脚本，node 原生 type-stripping）
node --experimental-strip-types scripts/verify-projection.ts

# GUI 端到端检查（可选：需要本地 3080 的 dsh web 已启动，且装有 playwright chromium；
# 路径经环境变量配置，见 scripts/gui-check.mjs 顶部注释）
$env:RECEIPT_PLAYWRIGHT = '<DSH 仓库>/node_modules/.pnpm/playwright@<ver>/node_modules/playwright/index.js'
$env:RECEIPT_CHROMIUM    = '<本机 chromium.exe 路径>'
node scripts/gui-check.mjs

# 确认配置层已入组合
pnpm dsh --profile web --dump-config | findstr dsh-receipt

实现说明

• host 半：src/projection.ts 的 receipt 投影单元——纯同步折叠，state 为纯 JSON（可持久化缓存），view 按注册时捕获的定价表现算费用；替换语义与 tokenUsage 一致（同一 step 的相邻样本整步替换，不重复计数；用量随 assistant/message 一同落地，当前事件映射里已无 assistant/chunk）。
• client 半：conversation.session.header.actions 的"小票"按钮 + shell.overlay 的小票弹层；打开状态经插件内模块级 store 协调， 数据读 useSessions 行上的 projectionValues.receipt（实时帧驱动）。
• 依赖全部走 peer / profile fallback（$DSH_HOME/profiles/node_modules）， 不复制 Cordis / React / schemastery 运行时身份。