前言¶

在 DeepSeek Harness（DSH）里跑智能体时，模型调用会不断发生，但 harness 本身并不长期保存「每次用了多少 token、按官方价应花多少钱」。要去官方控制台对账，又要面对峰谷时段、缓存命中分项等规则，和本地会话里看到的调用并不总是一一对应。

下面介绍社区插件 dsh-token-plugin（README 中亦称 dsh-usage-plugin）：在每次经 harness 转发的调用上记录 token 与缓存命中，并按 DeepSeek 公开价（含峰谷）估算费用，在 Web UI 里集中查看、筛选与导出。该仓库由 realhenrylan 维护，fork 自 feiyang-dev/dsh-usage-plugin，以 MIT 许可证发布；npm 包名为 dsh-token-plugin，当前资料中版本为 2.1.0，要求 Node.js ≥ 18。在 SkillHub 上归类为 admin-security（社区目录站点，与 DeepSeek / 幻方无官方从属关系）。

这是什么¶

一句话：DSH 生态里的 Host + Client 一体用量与消耗统计插件——host 侧（lib/index.js）负责记录、计费与导出，client 侧（lib/client.js）提供浏览器面板，经 /usage/api 与 host 通信。安装并在 DSH 中启用后，Web UI 顶部在「对话」「轨迹」之后会出现 「用量与消耗」 标签页。

核心功能¶

以下能力均来自项目 README 与 package.json 说明，按面板模块归纳。

用量与消耗概览¶

记录每次调用的 token 分项（输入未命中、缓存命中、缓存写入、输出、推理、结束原因等），并按 DeepSeek 峰谷/基础价计算费用：工作日高峰按北京时间 9:00–12:00、14:00–18:00；自 2026-08-23 起周末全天按空闲价；自 2026-09-10 12:00（北京时间）起适用 V4.1 Flash 调价后的峰谷表（例如 deepseek-flash 空闲价缓存命中 0.02 / 输入 1 / 输出 4 元，高峰为两倍）。模型名取自请求参数；无官方价的模型按 0 计消耗。

概览提供按模型表、按 API 服务商 × 模型明细，以及日期筛选（今天 / 近 7 天 / 近 30 天 / 全部与自定义区间）。

用量日历与调用明细¶

按月热力图（按费用或调用数着色），可点选某日查看明细与高峰/空闲拆分；明细列表最新在前，支持快捷与自定义日期筛选，分页每页 100 条。

价格表与计费通道¶

面板内展示并编辑 DeepSeek 官方价表，持久化到数据目录下的 pricing.json，可恢复默认。支持为订阅制 Coding Plan 登记计费通道（内置 OpenCode Go、Command Code GOAT 等默认条目），新调用按 Provider ID 精确匹配自动标注。

导出、导入与持久化¶

支持 CSV、JSON、PNG 长图导出（默认按最新在前，最多约 2000 条并有超出提示），可选目录并在导出后打开所在文件夹；JSON/CSV 可合并导入并按时间去重。

自 v1.9.2 起，记录写在固定专用数据目录（如 Windows %LOCALAPPDATA%\dsh-usage-plugin\dsh-usage\usage-records.json），可通过环境变量 DSH_USAGE_DATA_DIR 覆盖；上限约 100000 条。面板会说明本地统计与官方后台可能存在的差异（中断调用、其他 API Key 的调用等）。

平台与界面¶

支持 Windows / macOS / Linux；界面语言跟随 DSH「通用设置 → 语言」。内部/占位调用（如 dsh2shell-*、fake 模型）单独归在「工具调用（内部）」分组，不计入模型消耗明细。

安装与启用¶

官方 README 给出的常用方式如下。安装后需重启 DSH 服务。

从 GitHub 仓库安装：

dsh plugin --profile web add github:realhenrylan/dsh-token-plugin

从 npm 安装已发布包：

dsh plugin --profile web add dsh-token-plugin

也可在本地对仓库执行 npm pack 后安装生成的 dsh-token-plugin-<版本>.tgz（文件名以 npm pack 输出为准）。桌面端若提供推荐列表，由对应维护方单独管理，与上述命令等价目标均为把 bundle 装入 profile。

卸载示例：

dsh plugin --profile web remove dsh-token-plugin

若 dsh plugin 提示缺少 pnpm，可先执行 npm install -g pnpm；连不上 npm 官方源时可配置镜像后再安装（README 故障排查一节有说明）。

典型用法¶

1. 按上一节命令为 web profile 安装插件并重启 DSH。
2. 在浏览器打开 DSH Web UI，进入 「用量与消耗」 标签。
3. 正常进行对话与模型调用；面板会实时累积记录。
4. 在概览或日历中按日期筛选，查看按模型、高峰/空闲拆分的费用。
5. 需要留档时，在面板中选择 CSV、JSON 或 PNG 导出到本机目录；需要合并历史文件时使用导入功能。

价格或与官方账单不一致时，可先阅读面板顶部关于「本地捕获」与官方后台差异的说明，再按需导出官方月度账单 CSV 对比。

适用场景与注意¶

适合谁： 长期在 DSH 里调试智能体、希望在本机掌握 token 与预估费用、并要做峰谷口径汇总或导出的开发者。

权限与安全： 插件以当前 DSH 进程权限运行，会读写本机数据目录、可能调用系统目录选择与「在文件管理器中显示」等能力。安装前应自行审阅 GitHub 仓库 源码与 MIT 许可证；社区目录页的 admin-security 分类仅作归类参考，不替代你自己的安全评估。

生态背景： DSH 采用「一切皆插件」的扩展方式；SkillHub 是独立的社区插件目录，并非官方应用商店。

结尾¶

dsh-token-plugin 把「每次调用的 token / 缓存命中 / 峰谷费用」收敛到 harness 自带 UI，并支持导出与持久化，适合作为本地用量台账。更多信息见社区目录 realhenrylan/dsh-token-plugin 与源码仓库 github.com/realhenrylan/dsh-token-plugin。