DeepSeek Harness (DSH) 的设置页目前缺乏对 Token 用量的可视化。zcode-usage-stats 是一个非官方插件，在设置页增加了一个统计面板，用于查看全历史会话的 Token 消耗情况。
插件定位¶
该插件由 Amer-CN 维护，属于社区插件，与 DeepSeek / ZCode 无关联。它采用纯本地扫描与渲染，数据不出本机。
核心功能¶
- 全历史会话本地扫描与聚合：读取本地会话文件，按天、按小时、按模型进行聚合。
- 日历点阵热力图：展示每日活跃度，支持每日/每周/累计分桶。
- 多模型用量趋势：折线图展示各模型的用量趋势，支持悬停查看分项。
- 刻度环仪表盘：展示模型用量占比。
- 自定义时间范围筛选：支持今天、昨天、近7天、近30天、本月、上月、全部及自定义区间。
- 深浅双主题支持：跟随 DSH 的深浅主题，满足 WCAG AA 对比度合规。
- 统计指标：累计 Token、单日峰值、最长会话时长、连续天数。
安装与启用¶
前置要求：已安装 @deepseek-ai/dsh（及 DSH 插件命令依赖的 pnpm）。
dsh plugin --profile web add zcode-usage-stats
安装后重启 DSH 进程，打开 设置 → 使用统计 即可看到统计页面。
使用方式¶
- 切换时间范围：顶部切换时间范围，’全部’选项显示所有历史数据。
- 查看趋势：趋势图悬停查看各模型分项，点击图例显隐对应模型。
- 刷新数据：点击’刷新’按钮强制重新扫描全部会话。
技术细节¶
- 零依赖图表：使用手写 SVG 绘制图表，无运行时图表库依赖。
- 双层缓存：采用内存 + 磁盘双层缓存（SWR），首屏加载不卡顿。
- 安全机制：
/api/usage-stats通过宿主信任栅栏鉴权。
注意事项¶
- 非官方插件：与 DeepSeek / ZCode 无关联。
- 数据安全：纯本地扫描、本地聚合、本地渲染，数据不出本机。
- 依赖版本：锁定
@deepseek-ai/dsh >= 0.1.0-rc.5。
