dsh-receipt：DeepSeek Harness 会话用量小票插件

前言¶

在使用 DeepSeek Harness 进行复杂开发或调试时，跟踪单个会话的 Token 消耗、模型调用频率以及实际产生的费用是刚需。原生界面通常只展示基础统计，难以满足对成本控制和模型分布的精细化分析需求。dsh-receipt 插件通过在会话头部增加“小票”入口，提供类似超市小票的概览与明细视图，帮助开发者直观掌握会话成本。

插件简介¶

插件名称：dsh-receipt
维护者：bluechips-zhao
核心价值：本地计算并展示当前会话（含子代理）的用量与费用，支持按模型、按层级拆解。

核心功能¶

插件主要提供以下视图与操作：

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

安装与启用¶

安装插件后需重启 GUI 才能加载新功能。

# 在 DeepSeek Harness web profile 目录下执行
pnpm dsh plugin --profile web add github:bluechips-zhao/dsh-receipt

启用步骤：
1. 安装完成后退出并重新启动 GUI。
2. 打开任意会话。
3. 在会话头部右侧点击“小票”按钮。
4. 点击“查看全部模型明细”可切换到逐模型视图。

配置与定价¶

插件内置了截至 2026-09-27 核对的 DeepSeek 官方定价（空闲时段），并支持分时计价（峰谷）。

定价配置¶

在 profile 的 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 }
    # 补充非内置的法定节假日日期
    offPeakDates: ['2026-10-01']

计价逻辑：本地基于配置定价表估算费用。未配置单价的模型会显示“未计价”。峰谷时段基于样本时间判定，内置默认倍率为 2。
推理 Token：属于输出 Token 的一部分，合计时不重复相加。
币种：默认为 CNY（¥），可在配置中修改。

权限与安全¶

插件运行在严格的只读权限范围内：
* 无外部依赖：不依赖外部服务，无网络请求，无命令执行。
* 数据权限：仅读取 host 端的 receipt 投影与 useSessions 行数据。
* 隔离性：不访问文件系统、不读取凭据、不启动子进程。

兼容性¶

Node.js：^22.19.0 || >=24
DSH 版本：已验证兼容 0.1.7-rc.2。

结尾¶

dsh-receipt 为 DeepSeek Harness 用户提供了本地化、实时的会话成本追踪能力，适合需要精细化控制模型调用与预算的开发场景。

GitHub 仓库：bluechips-zhao/dsh-receipt
社区目录：DSH-Plugin Hub