前言¶
在 DeepSeek Harness（DSH）里跑长对话、多轮工具调用时，模型用量往往只散落在会话日志里。想回答「今天烧了多少 Token、高峰/低谷价各算多少、和套餐额度比占了几成」，通常要自己对日志或控制台，和你在浏览器里实际看到的不一定一致。
下面介绍社区插件 dsh-token-workbench（维护者 dragonestdwolf）。它在本地读取 DSH 已有的 model-usage 记录，按日归档，并在 Composer 底栏与设置页两处给出统计与参考成本，分类属于 模型推理。SkillHub 目录页当前标注版本 v0.3.0（MIT 许可证；GitHub 星标 0）。
这是什么¶
dsh-token-workbench 是面向 DSH 的 Token 用量工作台：从会话日志收集调用级明细，结合 DeepSeek 官方价目（含高峰/低谷时段）换算参考费用，并在应用内展示趋势与热力图。
DSH 生态主张「一切皆插件」；SkillHub（https://www.skillhub.cn）是独立的社区目录，与 DeepSeek / 幻方无官方从属关系，本文安装与能力描述以该插件在目录同步的 README 为准。
核心功能¶
根据 README 与目录简介，已核实的能力包括：
-
调用级明细与按日存储
读取会话日志里已有的 model-usage 记录，维护按天的明细存储，并汇总为 Token 数、参考成本与调用次数。 -
Composer 底栏读数（composer dock readout）
在输入框上方展示「今日 Token、参考成本、今日套餐额度（plan credits）」等，便于对话过程中扫一眼。 -
设置页「Token 工作台」
提供总览卡片、套餐额度块（日/周/月 credits，含「口径」编辑）、按 provider 表格、7 天 / 30 天趋势图，以及滚动 6 个月热力图；支持按所选粒度分页浏览。 -
高峰 / 低谷参考计价
按 DeepSeek 官方价目计算参考费用（北京时 00:30–08:30 为低谷）。价目从 DeepSeek 定价页拉取并缓存；拉取失败时使用内置默认列表，界面会说明。 -
套餐额度本地估算
将本地 Token 量按你配置的口径换算为 plan credits（默认：1M tokens = 0.2 credits，上限 600 / 2500 / 6000，四个 usage bucket 均计入）。窗口为北京自然日 / 周（周一 00:00）/ 月。这是本地估算，供应商控制台仍是唯一权威；数据完整性取决于本机捕获到的、经去重后的调用日志。 -
统计通道（channel filter）
「口径」编辑器可限定统计通道：默认统计全部通道（providers: []），也可只勾选特定 gateway，避免多通道本地流量把套餐占比撑高。区块标题会标明「全部通道」或「仅 xxx」；底栏 credits 段与同一过滤规则一致。 -
隐私边界
统计均在本地完成，不上传用量；对外仅请求定价页数字（失败则用冻结默认）。不读取或存储凭证、Cookie、API Key。
宿主要求：README 写明需要 dsh ^0.2.1-rc.0，且启用 web（client） 平台。
安装与启用¶
官方 README 给出的安装方式如下（勿自行拼接未在文档出现的命令）：
# from the published package
dsh plugin --profile web add dsh-token-workbench
# or straight from the release tarball
dsh plugin --profile web add https://github.com/dragonestdwolf/dsh-token-workbench/releases/download/v0.1.0/dsh-token-workbench-0.1.0.tgz
说明这一步在做什么：dsh plugin 会把包装进当前 profile，并通过包内的 cordis.patch.yml（dsh.bundle.patch）把插件挂到该 profile 的层栈；裸 npm install 不会挂载 UI。安装后需要重启 DSH Web 应用。
SkillHub 目录页标注当前同步版本为 0.3.0；README 安装小节中的 tarball 示例仍指向 v0.1.0 包名。若你走 release tarball 路径，安装前应在 GitHub Releases 核对与目标版本一致的文件名。
典型用法¶
README 未给出单独的「一键脚本」，界面路径如下，可按顺序自检：
- 完成上述安装并重启
dsh web后，打开日常对话界面，在 Composer 底栏查看今日 Token、参考成本与 plan credits 读数。 - 进入 设置，打开 「Token 工作台」 页面：查看总览、按 provider 表格，以及 7 日 / 30 日趋势与六个月热力图。
- 若套餐占比与预期不符，在 「口径」 中调整换算参数，并用 统计通道 限定要计入的 provider，确认标题与底栏读数与过滤范围一致。
- 参考成本若显示使用默认定价，说明定价页拉取失败，可稍后重试或对照 DeepSeek 官方控制台。
适用场景与注意¶
适合谁
- 长期在 DSH Web 上开发智能体、需要把 Token 与参考成本留在同一界面的人。
- 需要区分高峰/低谷参考价、或要把本地用量映射到套餐 credits 占比的团队。
务必注意
- 插件以当前 dsh 进程权限运行，只能统计本机 DSH 已写入会话日志的调用；安装前请阅读源码与 MIT 许可证，确认可接受其本地读日志、请求定价页的行为。
- GitHub 仓库地址为 https://github.com/dragonestdwolf/dsh-token-workbench ；若仓库或 Release 暂时不可达，可先从 SkillHub 目录页获取同步说明：https://www.skillhub.cn/plugins/dragonestdwolf/dsh-token-workbench
结尾¶
经过上面的步骤，dsh-token-workbench 把 DSH 里已有的 usage 记录整理成调用级明细、参考成本与趋势视图，并放在 Composer 与设置页两处，减少反复对日志和外部控制台。
- 目录页：https://www.skillhub.cn/plugins/dragonestdwolf/dsh-token-workbench
- GitHub：https://github.com/dragonestdwolf/dsh-token-workbench
