@deepseek-ai/dsh-usage-dashboard

DeepSeek Harness 的用量仪表盘插件：在 Web GUI 的设置弹窗里以「用量」小节呈现，按「今日 / 本周 / 本月」展示 Token 总量、估算花费、缓存命中占比、按模型分布、工具调用排行与全年活跃热力图。交互语言参考 TokenScope（hero 计数动画、双色缓存拆分条、堆叠柱状图、费用环图、sparkline 与 GitHub 风格热力图），视觉完全遵循 dsh 设置面板的设计语言：IconDataOutline16 图标、模块卡片（layer-1 表面 + 细边框 + 圆角）、14/22 正文字号与 --dsw-* 主题 token，深浅主题自动适配。

插件是双面（dual-half）包：Node 侧聚合 session/event 事件流并注册 GET /api/usage-dashboard 路由；浏览器侧通过 settings.section 插槽注册面板。遵循 dsh 客户端插件规范（dsh.client 清单、window.__ModuleLoader__ 闭包产物、CSS Modules + --dsw-* 主题 token、slots.inject 声明期注入）。

国际化：全部文案与时间轴标签跟随 harness 的语言设置（设置 → 通用 → 语言）实时切换中文/英文——词典注册在 usage 命名空间，宿主只下发语言无关的时间键（YYYY-MM-DD / YYYY-MM-DDTHH），刻度与悬停标签由客户端按当前语言格式化。

功能

区域	内容
头条	本时段总 Token（计数动画）、环比涨跌、估算花费；时段切换器右侧提供截图按钮（TokenScope 同款：modern-screenshot 2x 光栅化整段面板，按当前主题底色导出 PNG 下载，截图按钮自身被过滤，toast 反馈）
缓存拆分	已缓存 / 新输入 双色占比条 + 命中率；蓝色系双色调（TokenScope 同构：深=已缓存、浅=其余）
趋势图	按小时（今日）/ 按天（本周、本月）的堆叠柱状图，悬停提示；横轴沿用 TokenScope 刻度约定：今日每 4 小时一个刻度（04/08/…，跳过 0 点）、本周逐日标注周一周日（英文 MonSun）、本月只标 1 日与每 5 日
模型分布	Token 份额排行（最大余数法保证占比合计 100.0%）与花费环图；无价格模型仅统计 Token 并在脚注注明。颜色遵循「用量越多颜色越深」：排行第 1 最深品牌蓝，逐级变浅
迷你指标	请求数、会话数、花费趋势 sparkline
工具调用	按调用次数的排行（默认前 5，可展开）
热力图	每日活跃度热图：与 TokenScope 同口径 —— 约 26 周、周日对齐开头，四等分色阶（f<0.25/0.5/0.75 分档），悬停提示与 Less/More 图例；月份标注与文案随语言切换

数据口径

• 来源：session/event 事件流。仅折叠 assistant/message 的最终 usage（流式 assistant/chunk 的 usage 采样是该步的预览，不重复计数）；无效 usage（缺失或非有限数的 input/output）跳过。
• 时间：按宿主进程本地时间落桶（天桶 + 最近 48 小时的小时桶），与用户看到的日历一致。本周为自然周（周一月末），环比基期为上一自然周/自然月，与 TokenScope 口径一致。