前言¶
DeepSeek Harness（DSH）采用「一切皆插件」的架构。在 Web GUI 开发与调试过程中，开发者需要直观地掌握 Token 消耗情况。内置的 Wallet 插件虽然记录了本地账本，但缺乏可视化界面。dsh-token-stats 插件旨在解决这一问题，它直接读取 Wallet 插件已有的 365 天本地账本，在界面内提供可视化的 Token 统计面板。
插件定位¶
这是一个运行在 DeepSeek Harness Web GUI 客户端的仪表盘插件。它不进行额外的数据收集，完全依赖 Wallet 插件生成的数据文件。插件本身是纯前端展示组件，不涉及复杂的后端逻辑。
核心功能¶
- 侧边栏入口：在左侧边栏注册 “Token Statistics” 入口，点击后在中间列以全宽模式展示仪表盘，兼容展开与收起侧边栏两种状态。
- 汇总卡片：展示今日、本周、本月、累计四个维度的 Token 使用量与费用（如有定价数据）。
- 堆叠柱状图：纯 SVG 绘制，按模型着色。支持按日（30 天）、周（12 周）、月（12 月）切换，鼠标悬停可查看各模型详情。
- 模型明细表：列出每个模型的输入 Token、输出 Token、缓存读取 Token、总量及占比条，并按总量排序。
- 多语言支持：内置英语、越南语、中文、日语四种语言。仪表盘头部提供语言切换器，选择结果会被本地记住。
- 自动刷新：面板打开期间每 30 秒自动刷新数据，并提供手动刷新按钮。
- 零依赖：无构建步骤，主程序为纯 ESM Node 环境，客户端为预打包的 CJS 模块。
安装与启用¶
安装命令如下：
dsh plugin --profile web add dsh-token-stats
安装完成后，重启 dsh web（或通过市场的「一键重启」功能重启），在左侧边栏即可看到 Token Statistics 入口。
使用方法¶
- 在左侧边栏点击 Token Statistics 打开仪表盘。
- 在仪表盘头部点击语言图标，选择所需语言（支持英语、越南语、中文、日语）。
- 查看顶部的汇总卡片了解总体消耗。
- 使用图表下方的标签页切换日/周/月视图，或查看模型明细表。
注意事项与适用场景¶
- 版本要求：插件依赖 DSH 的侧边栏 DOM 结构，要求 DSH 版本至少为
0.1.1-rc.2。 - 只读模式：插件仅从 Wallet 插件读取数据，不会向账本写入任何内容。
- 数据展示限制：对于没有定价信息的模型，面板仅显示 Token 数量，不显示费用金额。
结语¶
dsh-token-stats 是一个轻量级的 Token 统计工具，适合需要在 DeepSeek Harness Web 界面内快速查看使用量与成本分布的开发者。其数据源与 Wallet 插件完全打通，避免了重复数据采集的开销。
