前言¶

在 DeepSeek Harness 里做多轮对话或智能体流程时，成本通常不只取决于单次输出，还会受到缓存命中、缓存读取、缓存写入，以及高峰/空闲时段计价影响。若需要在一个会话里逐轮查看 token 用量对应的成本，而不是只看一个总数，就需要把用量时间线投影到前端并做成本读数。下面介绍 dsh-usage-cost 插件。

这是什么¶

dsh-usage-cost 是一个 DeepSeek Harness 插件，用于按会话逐轮 token 用量实时计算 DeepSeek API 成本，并在 8/17 起自动切换峰谷计价。

仓库地址为：

https://github.com/Dino6021/dsh-usage-cost

许可证为 MIT。

核心功能¶

插件包含两部分：

1、服务端 session projection 投影 usageTimeline：逐条 assistant/message 的 token 桶（未命中 / 输出 / 缓存读 / 缓存写），并记录完成时间戳。

2、conversation.composer.dock 槽 usage-cost：提供四段成本读数（对话 / 工作区 / 今日 / 5小时）。

计价逻辑上，8/17 零点自动由平峰切为峰谷，逐轮按时间戳判峰谷。若没有时间线（旧会话/投影缺失），插件回退平峰价。

安装与启用¶

安装命令如下，使用 web profile，从 git 源安装 main 分支：

dsh plugin --profile web add "github:Dino6021/dsh-usage-cost#main"

该插件采用官方 bundle 形态（dsh.bundle.patch + dsh.client），构建产物已入库，因此从 git 源安装时无需额外构建。

执行安装命令后，重启 web 并刷新页面。经过上面的步骤，对话底部（统计行下方）会出现成本行。

典型用法¶

安装完成后，可在对话底部看到四段成本读数：对话、工作区、今日、5小时。

若需要核对或调整单价，可以编辑 lib/client.js 顶部的单价定义。改价后生效步骤如下：

1、编辑 lib/client.js。

2、重新执行安装命令：

dsh plugin --profile web add "github:Dino6021/dsh-usage-cost#main"

3、刷新页面。

计价以官方价为准：

https://api-docs.deepseek.com/zh-cn/quick_start/pricing/

其中，缓存写入价按「缓存未命中」价计；DeepSeek 未单列写入价，该桶实际常为 0。

已装插件也可以用 plugin-registry 的薄控制台管理，即浏览器面板。

适用场景与注意¶

适合在 DeepSeek Harness web 端运行，需要查看单轮、对话、工作区、今日和 5 小时成本的人。若会话较旧或服务端投影缺失，插件会使用平峰价作为回退，而不是保留峰谷价。

安装前注意：

• 插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。
• 安装后必须重启 web 并刷新页面。
• 单价维护在 lib/client.js 顶部；调整前建议先对照官方价。
• 本插件从 git 源安装时无需构建，但仍建议确认仓库源码、依赖与许可证后再安装。

结尾¶

dsh-usage-cost 的价值在于把逐轮 token 用量和成本读数放进 DSH 对话界面，便于在峰谷计价切换后核对实际费用。仓库地址：

https://github.com/Dino6021/dsh-usage-cost