在 DeepSeek Harness (DSH) 的 Web profile 中，开发者通常需要监控 token 消耗和模型使用情况。现有的界面可能缺乏针对峰谷分时计费的直观展示，以及跨会话的详细历史分析。dsh-usage-dashboard 插件在输入框下方增加了一个峰谷计费坞，展开后提供完整的用量分析仪表盘。
功能说明¶
该插件由 woosh2010 维护，用于解决 DSH Web profile 中用量统计不直观、缺少峰谷计费坞以及跨会话历史管理的问题。
峰谷分时计费¶
支持北京时间峰时（工作日 9:00–12:00 / 14:00–18:00）与谷时（半价）。自 2026-08-23 起生效，周末（周六、周日）全天按谷时计费，历史账单自动重算。坞上实时显示当前时段、进度条、距下次调价倒计时（周末显示“周末谷时”徽章）以及会话累计 / 本轮成本与账户余额（60 秒自动刷新）。
历史落盘¶
每一步的 token / 成本 / 模型 / 峰谷信息自动写入 ~/.dsh/storages/usage-history.l，软上限 4 万条自动裁旧，支持跨会话与跨重启。
全局筛选与仪表盘¶
面板顶部提供全局筛选，包括时间范围（今天 / 7 天 / 30 天 / 90 天 / 全部）、会话范围（全部会话 / 本会话）和模型筛选。所有图表与统计卡实时联动。
统计卡展示：成本（含峰/谷拆分）、Tokens（含输入/输出）、轮次（含峰/谷）、缓存命中率、谷时节省、单步均值。
分析图表包括：成本趋势折线、分时分布柱状图、Token 结构环形图、模型分布条形图、峰谷对比与谷时节省。
按日期查看¶
点击成本趋势图上的任意一天，可下钻查看当日统计卡、模型分布、峰谷对比、Token 结构、最近记录，以及额外的 24 小时分时分布和当日会话排行。
最近记录¶
默认显示最近 20 轮的全部步骤，按轮分组，轮标题带模型徽章、峰谷与成本，支持展开/收起。按日期视图显示当日全部轮次（最多 60 轮），跨会话时轮标题带会话标签。
交互关闭¶
面板通过 React portal 渲染，点击面板外任意位置或按 Esc 关闭。
安装与启用¶
需要 DeepSeek Harness 0.1.1-rc.1 的 web profile，且系统需安装 pnpm（dsh plugin 会把参数原样转发给 pnpm）。
执行以下命令一键安装：
dsh plugin --profile web add https://github.com/woosh2010/dsh-usage-dashboard/releases/latest/download/deepseek-ai-dsh-client-ui-usage.tgz
安装完成后重启 dsh web 并刷新浏览器即可使用。
验证与常见问题¶
部署后可运行验证脚本：
node verify.mjs
注意事项：
1. 余额显示需要在模型设置页配置过 DeepSeek API Key（未配置时余额显示“—”，其余功能不受影响）。
2. 历史存储路径为 ~/.dsh/storages/usage-history.l。
3. 从旧版手动安装（源码复制进 web/packages/）升级可能导致 declares no dsh.bundle 错误，需清理旧版残留。
