前言¶
DeepSeek Harness（DSH）的生态强调“一切皆插件”。在本地调试或使用过程中，查看 Token 消耗和模型调用情况是常见需求。dsh-plugin-token-usage 是一个由 Hjay1101 维护的客户端插件，它直接读取本地会话日志，将数据转化为 GitHub 风格的热力图，并提供按粒度的模型拆分视图。
核心功能¶
该插件提供以下能力：
- GitHub 风格热力图：展示最近 30 天的 Token 使用情况，采用“周日优先”的列布局排列，今日数据会被高亮轮廓显示。零使用天数会被填充为空。
- 多粒度切换：支持按“天 / 周 / 月”切换视图，颜色刻度会根据当前粒度范围自动重新归一化。
- 交互详情：鼠标悬停单元格时，会显示当日的 Token 数量、请求数和缓存命中率。
- 模型拆分表格：根据当前粒度聚合模型数据，提供窗口内的精确聚合（基于会话×天和模型×天的二级映射），并支持过滤掉仅产生请求但无实际 Token 的模型。
- 侧边栏徽章：鼠标悬停侧边栏图标时，显示“今日使用量”，并在后台进行静默轮询（30 秒间隔），数据在午夜自动滚动。
- 命令行工具：通过模型工具
usage_report在对话中直接查询 Token 使用情况。 - 主题适配：所有颜色均映射到 DSH 的主题变量，支持深色和浅色模式自动切换。
安装与启用¶
安装前请确保当前 DSH 架构版本不低于 0.1.2-rc.1。
- 执行安装命令：
dsh plugin --profile web add dsh-plugin-token-usage
插件包自带 `cordis.patch.yml`，安装后会自动挂载。
使用方式¶
- Web 界面：在侧边栏设置行点击柱状图图标，即可打开 Token 使用量模态框。
- 对话调用：在聊天中指示 Agent 调用
usage_report模型工具（例如使用refresh参数强制刷新或top参数限制显示行数）。
注意事项¶
- 本地化与隐私：插件仅对
~/.dsh/sessions/**下的日志文件进行只读解析（支持流式 zstd 解压）。不发送任何网络请求，不收集遥测数据，也不进行任何写入操作。 - 环境依赖：运行需要本地环境具备 React 18.2.0 及 DeepSeek 相关的 Cordis 和 Schemastery 依赖。
结语¶
这是一个纯本地、只读的 Token 分析工具，适合需要详细追踪模型调用成本的 DSH 用户。
