DSH FeeDetail · DeepSeek Harness 会话费用明细

DeepSeek Harness（DSH）客户端插件：在会话统计行直接展示 DeepSeek API 费用明细——按 模型（deepseek-v4-flash / deepseek-v4-pro）× 计费时段（高峰/空闲）× 输入（缓存命中/未命中）/ 输出 分项列出，全部以连续文字内联显示，无需悬停、无需额外依赖。

效果

统计行（输入框下方）末尾展示各模型的实际 Token 用量及 DeepSeek 费用明细：

• 使用 DeepSeek 官方模型时：

  … | deepseek-v4-flash: 输入 38.1M tok · 输出 151K tok (缓存命中 95%) | 费用 ¥4.76（deepseek-v4-flash·空闲：命中 ¥3.483 / 未命中 ¥0.286 / 输出 ¥0.986 / 小计 ¥4.756）
  

• 使用第三方或自定义模型（如 Gemini、GPT、Claude 等）时：

  … | gemini-3.7-flash-high: 输入 52.3K tok · 输出 1.8K tok
  

• 同个会话混用多模型时：

  … | gemini-3.7-flash-high: 输入 15K tok · 输出 1.2K tok | deepseek-v4-flash: 输入 30K tok · 输出 2.5K tok (缓存命中 80%) | 费用 ¥0.05（deepseek-v4-flash·空闲：…）
  

• 分模型单独统计：精确按 message.source.model 单独记录并展示各被调用模型的输入/输出 Token 及缓存命中率

• 非 DeepSeek 官方 API 模型（如 Claude、GPT、Gemini、本地模型等）：单独记录并展示各自的 Token 用量，不参与 DeepSeek 费用计算与明细展示

• DeepSeek 官方 API 模型：按发生时刻区分高峰/空闲计费，高峰为**工作日（周一至周五）北京时间 09:00–12:00 与 14:00–18:00；工作日其余时间（12:00–14:00 及 18:00–次日 09:00）以及周末（周六、周日全天）**均为优惠/空闲时段（与 DeepSeek 官方计费窗口一致）

• 缓存写入按「缓存未命中」输入价计费（DeepSeek 提示词缓存计费惯例）

• 统计行自动换行，明细完整可见，不被省略号截断

计价表（yuan / 百万 tokens）

模型	时段	输入·缓存命中	输入·未命中	输出
deepseek-v4-flash	空闲	0.05	1.5	4.5
deepseek-v4-flash	高峰	0.10	3.0	9.0
deepseek-v4-pro	空闲	0.15	4.5	13.5
deepseek-v4-pro	高峰	0.30	9.0	27.0

工作原理

改动落在 DSH 运行环境（npm global / npx cache 中的 node_modules/@deepseek-ai/*）上，共 4 个文件：

文件	改动
@deepseek-ai/dsh-token-meter/lib/index.js	服务端 tokenUsage projection 累计费用明细（适配 SessionProjectionRegistry，stateVersion 3）
@deepseek-ai/dsh-token-meter/lib/types/usage-projection.js	projection 纯折叠实现（DEEPSEEK_RATES 费率表在此）
@deepseek-ai/dsh-client-connection/lib/client.js	客户端 fixture 对等实现（tokenUsageOf）
@deepseek-ai/dsh-client-ui-conversation/lib/client.js	StatsLine 内联费用明细文字 + 中英文案 + 换行样式

安装

跨平台（推荐 Node.js）

git clone https://github.com/darker2016/dsh-feedetail.git
cd dsh-feedetail
node install.mjs

Windows (PowerShell)

.\install.ps1

Linux / macOS (Bash)

./install.sh

脚本会自动检测本机全局 npm / npx 缓存路径并覆盖对应文件。安装完成后：

1. 重启 dsh web 服务（服务端 projection 改动需重启加载）
2. 浏览器硬刷新（Ctrl+Shift+R / Cmd+Shift+R）以加载更新后的前端 bundle

手动指定安装目录

# 指定 DSH_PKGS 环境变量指向 @deepseek-ai 目录
DSH_PKGS=/path/to/node_modules/@deepseek-ai node install.mjs

验证

# 折叠逻辑单元测试（费率、时段、替换语义）
node test-projection.mjs

# 用真实会话日志重放（.jsonl 或安装了 zstd CLI 的 .jsonl.zstd）
node replay-session.mjs [path/to/session.jsonl]

自定义费率

DeepSeek 调价或调整计费窗口后，修改 PEAK_WINDOWS（高峰窗口，分钟粒度）与 DEEPSEEK_RATES（费率表）常量：patch/@deepseek-ai/dsh-token-meter/lib/index.js 与 lib/types/usage-projection.js，以及客户端 fixture 中的 FIXTURE_PEAK_WINDOWS / FIXTURE_DEEPSEEK_RATES（dsh-client-connection/lib/client.js）。

版本兼容

已适配 @deepseek-ai/dsh 0.1.1-rc.2（采用新版 SessionProjectionRegistry 规范：stateSchema 与 wire: { viewSchema, view }）。

许可

本仓库中的补丁代码基于 MIT 许可的 DeepSeek Harness（https://github.com/deepseek-ai/deepseek-harness ）编译产物修改，整体遵循 MIT 许可（见 LICENSE）。