中文 · English

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

为 DeepSeek Harness 的会话头部增加“小票”按钮，点击后从右上角打开紧凑的会话用量面板：

• 概览：主会话与所有层级子代理的预估总费用、各自小计、模型调用、token 总量、缓存命中率、平均每次费用；
• 费用与用量分布：四色 token 结构、最多五个模型的金额 / Token 占比切换、模型耗时和会话跨度；
• 逐模型明细：展开查看调用次数、各类 token 和已计算费用；推理 token 已含在输出中；
• 子代理费用：按下派层级展开，分别查看本代理费用和含所有后代的分支费用；支持名称 / 会话 ID 搜索，同级代理每次加载 20 个，逐个查看调用量与模型小计。
• 实用操作：复制文本摘要，键盘与窄屏可用，适配深浅主题和减少动画设置。

界面效果

以下截图来自本地交互预览，数值和会话名称均为演示数据，不是实际账单或桌面版运行截图。打开任一会话后，在会话头部右侧点击“小票”；点击“查看全部模型明细”可切换到逐模型视图。

深色概览	浅色概览	逐模型明细

含子代理的总费用	子代理逐项费用

子代理页默认显示顶层代理；点击箭头逐层展开，搜索时自动显示匹配代理的上级路径。层级缩进最多四档，实际层数仍在每行显示，方便定位深层代理。

缓存命中率按 缓存命中输入 / (普通输入 + 缓存命中输入) 计算。缺少单价时，面板显示 “已知部分费用”和可计算的模型小计，不把未计价用量误写成完整费用。金额默认以 ¥ 展示， 货币符号可配置；最后更新时间是最近一条计入事件的时间。

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

deepseek-harness-usage-dashboard 提供 DeepSeek 平台账户级余额与扣费视图，其模型分布可按金额 / Token 切换；小票借鉴了 这个切换方式。两者口径不同：小票计算当前会话及其子代理中已记录的用量，无法替代跨会话、 跨客户端的官方账单，也不需要平台登录态。该仪表盘使用的平台用量接口未公开， 其可用性取决于 DeepSeek 平台接口状态。

合计按会话树中的独立用量投影相加；子代理继承的父会话日志不重复计费。若某个子代理暂无用量投影或存在未配置单价的模型，面板会把合计标为“已知部分费用”。币种不同的子代理单独展示，不并入合计。

安装

推荐从 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（小票按钮出现在会话头部右侧；打开会话后点击“小票”）。桌面版和 Web 版使用不同 profile；请把插件安装到实际运行的 profile。更新本地链接插件后，也需要重启 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.7-rc.2 的验证结果见下方「验证」，不能仅凭版本号推断兼容。
• 已知边界：费用是按配置定价表做的本地估算，非账单口径；定价表未声明的模型 以"未计价"展示；峰谷时段按样本事件时间（本机时钟）判定。

构建（维护者）

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

前置：本机有对应 DSH tag 的 checkout；本插件的构建从该 checkout 读取 harness 平台模块表。依赖由本仓库的锁文件安装：

# 在 dsh-receipt 目录内，按你本机布局调整目标路径
New-Item -ItemType Junction -Path harness     -Target "<你的 DeepSeek Harness checkout 路径>"
pnpm install --frozen-lockfile

然后：

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/。

配置（定价）

插件内置截至 2026-09-27 核对的 DeepSeek 官方定价页的空闲时段价—— deepseek-flash（V4.1-Flash）与 deepseek-v4-pro（V4-Pro-0813）。官网未列出的历史模型显示 "未计价"、费用记 0。分时（峰谷）计价由折叠按样本时间自动处理（见下节）。

截至该次核对，官方当前模型表列出上述两个现行模型。deepseek-v4-flash 与 deepseek-v4-flash-vision-exp 是仍可调用的旧名，实际按 Flash 价计；会话明细仍保留 日志里的原始模型名。第三方 provider 若使用相同模型 ID，也会命中全局默认价； 若其中转价不同，请用 provider/model 复合键覆盖，其他历史模型不会自动计价。 本地 profile 若配置了 pricing，该配置会覆盖内置表，升级插件后也应重新核对。

要覆盖默认价，在 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 }
    # 2026 年已公布假期内置；后续年度按官方安排补充北京时间日期
    offPeakDates: ['2027-10-01']

• 单价单位：每 1M token 的货币额；字段：input / cacheRead / cacheWrite / output / reasoning。有用量的桶缺少单价时，该模型标为「未计价」，合计只包含可计算部分。 官方当前定价页未单列缓存写入价，内置表不猜测 cacheWrite；如适配器报告此用量，请按实际计费规则配置。
• 键优先 provider/model 复合键，其次模型 id，再次同价别名基准模型 （本插件不做跨 provider 冲突合并）。
• 官网不再列出的 deepseek-chat、deepseek-reasoner 不内置历史价格；若需估算旧会话， 请自行配置对应使用时段的价格。当前价套到历史用量上也只是估算，不代表原始账单。
• reasoningTokens 属于 outputTokens，小票展示推理明细，但合计 token 不重复相加。 自定义 reasoning 单价会替换对应的输出部分；未配置则全部按 output 计价。
• 同价别名：已下线的旧名 deepseek-v4-flash、deepseek-v4-flash-vision-exp 仍可调用，由 DeepSeek-V4.1-Flash 提供服务并按 Flash 价格计费，故内置 PRICING_ALIASES 把它们映射到 deepseek-flash；若单独配置旧名，则以它自己的价格为准。
• currency 只影响展示符号；改配置由 profile 配置 HMR 实时生效，无需重启。

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

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

• 高峰时段：北京时间周一至周五且非中国法定节假日 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）计；周六、周日即使调休上班，也全天按谷底价计。 已内置国务院办公厅公布的 2026 年放假调休日期； 后续年度的安排不会自动更新，请按官方安排在 offPeakDates 补充北京时间日期 （YYYY-MM-DD），否则这些日期可能被高估。 要改窗口或倍率，配置 peakHours / peakMultiplier 即可。插件使用 assistant/message 的落地时间近似计费时间，也无法覆盖未落地的调用；金额始终是本地估算，以实际账单为准。

命名与下线提醒（官方定价页脚注 1）：新模型名请用 deepseek-flash；旧名 deepseek-v4-flash、deepseek-v4-flash-vision-exp 仍可调用，但由 V4.1-Flash 提供服务 并按 Flash 价计费（已内置别名）。当前官方定价表单列 deepseek-v4-pro， 本插件据此保留其独立价格。价格可能变动，请以官方定价页为准。

验证

已在隔离的 dsh-v0.1.7-rc.2 环境中完成 pnpm test、pnpm typecheck、 pnpm build、profile 插件安装、--dump-config 组合与 Web 宿主启动。 HTTP 未携带该隔离环境的访问令牌时返回预期的 401。新版面板已用演示投影数据做 深色主题与窄屏视觉检查，并完成类型检查与构建；尚未验证 DSH 浏览器内的小票按钮、 真实 provider 事件与实际账单一致性。

# 投影折叠逻辑单元断言
pnpm test

# 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 运行时身份。