前言¶
DeepSeek Harness 的插件生态允许对客户端功能进行扩展。对于开发者而言，追踪 token 用量以评估成本或资源使用情况是一个常见需求。dsh-token-stat 是一个插件，用于统计使用 DSH 以来累计 token 用量，并按模型 / 日期区分明细；它提供可视化看板，且数据保存目录可在设置页在线更改。
核心功能¶
该插件具备以下核心能力：
- 累计统计：统计累计 token 用量，包含输入、缓存读取、缓存写入、输出和总计。
- 明细查询：按模型和日期区分明细。
- 可视化看板：在设置页查看包含可视化 SVG 图表（环形图、堆叠柱状图、排行）的看板。
- 数据管理：数据保存目录可在设置页在线更改。
- 零依赖：零运行时依赖，无需构建或授权。
安装¶
通过 CLI 命令安装插件，无需额外构建步骤：
dsh plugin --profile <profile> add https://github.com/Anna-la/token-stat
安装后，插件将自动扫描 <DSH_HOME>/sessions 下的全部历史会话并开始累计。
使用方法¶
- 设置页查看：打开「设置 → 插件 → 可配置」，找到「Token 用量统计」卡片点击展开。卡片内展示累计总量、按模型/日期的明细表以及元信息。
- 查看可视化图表：在卡片展开后，点击「可视化」可查看手写的 SVG 图表（模型用量占比环形图、每日用量堆叠柱状图、模型用量横向排行）。
- 数据目录管理：在卡片中修改「数据保存目录」并保存，可在线更改数据存储位置。
- 重新扫描：点击卡片内的「重新扫描」按钮，可从磁盘全量重新折叠历史会话。
- 对话框查询：在对话框里问「查一下 token 用量统计」，模型会调用插件的工具返回报告文本。
统计口径与数据说明¶
- 数据来源：数据来自会话日志中供应商上报的精确 usage。
- 去重规则：同一
(turn, step)步内的重试/重复上报只计最后一次采样。 - 数据隔离：报告默认写入
~/.dsh-token-stat，完全位于DSH_HOME之外。官方对profiles/storages/sessions等目录的任何清理、重装都不会误删本插件的数据。 - 报告文件：生成
report.md、report.json和archive.json三个文件。 - 工具调用：支持工具调用查询统计。
注意事项¶
- 安全性：API
/api/token-stat/stats仅限回环地址可访问，外部请求一律 403。 - 依赖情况：零第三方依赖，图表为手写 SVG。
- 卸载后保留：卸载插件后，历史报告文件仍保留在默认目录。
- 只读操作：插件只读会话日志，不修改任何会话数据。
