前言¶

在 DSH 的插件化方式下，Web 对话视图可以通过独立包扩展功能。如果你已经在用 DSH Web 对话，想要在同一页面查看某次、若干次或全部历史对话的 token 用量，而不只是看单次消息的零散信息，@az7627/dsh-token-usage 提供的是一个用量统计抽屉：分时段堆叠柱状图，加上精确到个位的总计和每对话明细。

这是什么¶

• 插件名：@az7627/dsh-token-usage
• 维护者：az7627
• 定位：DeepSeek Harness 插件，用于在 Web 对话视图统计 token 用量
• 许可证：MIT
• 资料明确 package.json version 为 0.1.1
• 仓库：https://github.com/az7627/dsh-token-usage

它的核心数据来自会话日志重放（/usage RPC 通道），因此历史对话装上后即可看到数据。

核心功能¶

1、入口：会话头右缘「用量统计」按钮，点击后打开右侧抽屉。

2、对话选择：支持多选，默认当前对话 / 全选 / 仅当前。

3、时间粒度：15 分钟 / 1 小时 / 1 天；范围：近 7 天 / 近 30 天 / 全部。

4、用量分桶：

• 缓存输入：cacheReadTokens
• 输入：inputTokens + cacheWriteTokens
• 输出：outputTokens

5、展示：ECharts 堆叠柱状图，按本地时区日历对齐；tooltip 精确到个位；提供总计与每对话明细。

安装与启用¶

先执行安装命令。这里使用 npm 包名，包名带作用域；无作用域的 dsh-token-usage 已被他人占用。

npx @deepseek-ai/dsh plugin --profile web add @az7627/dsh-token-usage

安装后重启 dsh web：

npx @deepseek-ai/dsh web

更新时重新执行上面的 add 命令，pnpm 会装最新版。

卸载：

npx @deepseek-ai/dsh plugin --profile web remove @az7627/dsh-token-usage

典型用法¶

安装并重启后，打开 DSH Web 对话视图，在会话头右缘点击「用量统计」。先选择要统计的对话，再选择分度和范围，然后查看堆叠柱状图、tooltip、总计以及每对话明细。

如果要在本地开发该插件，可以改用本目录绝对路径安装：

npx @deepseek-ai/dsh plugin --profile web add <本目录的绝对路径>

修改源码后执行构建，再重启 dsh web：

pnpm run build
npx @deepseek-ai/dsh web

这一步无需重新执行 add。

本地开发的常用命令：

pnpm install
pnpm run build
pnpm test

适用场景与注意¶

适合在 DSH Web 中需要核对 token 用量的人：比如查看近 7 天 / 近 30 天 / 全部历史对话，比较 15 分钟 / 1 小时 / 1 天粒度，核对缓存输入、输入、输出三类桶，以及精确到个位的总计。

安装前注意：

• 插件会加载到当前 dsh 环境中运行；安装前应检查源码与许可证。该项目许可证为 MIT。
• 注意 npm 包名作用域，避免误装无作用域名称。
• 依赖说明：zod 运行期；echarts 打进浏览器 bundle。
• peerDependencies 包含多个 @deepseek-ai/dsh-* 包，以及 react 和 react-dom ^18.2.0。
• 类型检查依赖同目录下 deepseek-harness 源码树里已构建的 lib/types；这是仅编译期引用，运行期全部由 dsh 安装提供。

结尾¶

@az7627/dsh-token-usage 的价值比较直接：在 DSH Web 对话视图中把 token 用量按时间、按对话、按输入输出分桶展示出来，并且历史对话装上即可查看。

仓库：https://github.com/az7627/dsh-token-usage。

目录页：已核实资料未提供固定 URL；如通过 DSH 插件目录查找，请以目录页实际展示为准。DSH 插件目录是独立社区站点，与 DeepSeek / 幻方无官方从属关系。