前言¶
在使用 DeepSeek Harness (DSH) 进行开发时，追踪每条请求的 Token 消耗、计算实际费用以及监控供应商配额是控制成本的核心环节。现有的统计方式往往不够直观。dsh-token-usage 插件通过在 Web UI 中直接嵌入可视化图表与数据面板，将原本分散的用量信息聚合展示，解决了开发者无法实时掌握资源消耗的问题。
插件简介¶
这是一个面向客户端的 DSH 插件，由开发者 LaoYueHanNi 维护。其核心作用是在 Web UI 中实时显示模型 Token 的用量与费用，提供趋势图表、历史回填、按模型定价明细以及供应商配额显示功能。
核心功能¶
- 实时记录：自动记录每次请求的 Token 数量、费用、使用的模型以及所属会话，包括上下文压缩调用。
- Web 统计页面：在设置中提供汇总卡片、每日总 Token 折线图、按模型/会话的明细表，支持通过日期范围和模型进行筛选。
- 会话用量标签页：在对话面板中新增“用量”视图，展示成功率、成本、缓存命中率等六项核心指标。
- 定价与配额：提供按模型定价的详细查看入口，并在输入栏按钮中直接显示当前供应商的剩余配额。
- 历史回填：首次启动时会自动同步安装前的历史请求记录。
安装与启用¶
由于仓库已停止提供预构建输出，请通过 npm 进行安装。
dsh plugin --profile web add @laoyuehanni/dsh-token-usage
安装完成后，在 Web UI 侧边栏的齿轮图标处进入 设置，即可看到 Token Usage 页面。
使用示例¶
进入 Token Usage 页面后，可以通过过滤器按日期范围和模型筛选数据。点击模型名称上的费率按钮可以查看完整的定价表；在输入栏左侧点击按钮可以查看当前供应商的剩余配额。
注意事项¶
- 升级旧版需注意：如果从旧版（<= 0.3.7，包名
dsh-token-usage）升级，直接更新会导致插件无法加载。需要先移除旧包名，再重新添加。 - 定价文件失效：手动编辑的
pricing.json在升级后会被静默忽略，费率表每次启动从云端同步。 - 数据目录可配置：数据目录默认为
~/.dsh/token-usage/，可在 Web 设置卡片中修改为绝对路径，保存后历史数据会自动迁移。 - 安装源变更：不再支持 GitHub 直接安装，必须使用 npm 包名。
总结¶
dsh-token-usage 插件为 DSH 用户提供了直观的成本与配额管理入口，适合需要精细化监控资源消耗的开发场景。
