前言¶
在 DeepSeek Harness（DSH）里跑多模型、多会话时，token 消耗分散在会话日志里，内置能力若只给单次请求或单会话视图，很难回答「最近一个月各模型各占多少」「哪天用得最猛」「连续用了几天」这类问题。社区插件 dsh-usage-dashboard（维护者 bzhao0110，分类：客户端）在 Harness 设置 → Token 统计 中提供 zcode 风格的用量面板：指标卡、活动热力图、按模型的每日趋势与占比，且不估算费用，只统计 token。
这是什么¶
dsh-usage-dashboard 是 DSH 的 Token 用量统计客户端插件。服务端注册名为 tokenStats 的会话投影，客户端通过设置页的 settings.section 槽位注入 UI，聚合全部会话的 projectionValues.tokenStats 后渲染面板。图表零运行时依赖，全部手写 SVG。
核心功能¶
下面介绍面板里已文档化的能力（均以 README 为准）。
指标卡（5 张）¶
- 累计 Token
- 单日峰值
- 最长会话时长
- 当前连续使用天数
- 最长连续使用天数
Token 活动热力图¶
53 周、GitHub 风格布局；可在「每日」与「累计」两种视图间切换。
每日 Token 趋势¶
近 7 日或近 30 日，按模型分系列的折线图。
模型用量环形图¶
展示各模型占比，并附带明细列表。
统计原理与口径¶
先做事件折叠，再做按天、按模型累计：
- 服务端通过
ctx.sessionProjections.register注册tokenStats投影。 - 折叠
request/header、step/start、assistant usage、step/end、compaction/summary等事件，按 天 × 模型 累计 token。 - Harness 在会话首次被触碰时会回放持久化日志，因此历史会话同样会被统计。
口径说明（与内置 tokenUsage 投影一致，README 称已对 19 个真实会话逐一对账验证）：
- token 总量 = input + cacheRead + cacheWrite + output
- 同一 (turn, step) 的多次 usage 上报只计最新一次（流式 chunk 替换语义）
- 不估算费用
注意： 投影是按需折叠的，只有被打开过的会话才有数据。若要一次性回填全部历史，见下文「历史数据回填」。
安装与启用¶
插件以当前 DSH 进程权限运行；安装前建议阅读 GitHub 仓库 源码与 MIT 许可证。DSH 生态强调「一切皆插件」；SkillHub 目录页 为社区站点，与 DeepSeek / 幻方无官方从属关系。
npm（推荐）¶
dsh plugin --profile web add dsh-usage-dashboard
桌面版可在 设置 → 插件 → Add plugin 中，将 npm 包名填为 dsh-usage-dashboard。
从源码 / 本地开发¶
web / tui profile：
dsh plugin --profile web add /path/to/dsh-usage-dashboard
desktop profile 暂无插件页安装入口，需手动修改 ~/.dsh/profiles/desktop/package.json：在 dependencies 增加 "dsh-usage-dashboard": "file:/path/to/dsh-usage-dashboard"，并在 dsh.profile.bundles 增加 "dsh-usage-dashboard"，然后安装并重启应用：
cd ~/.dsh/profiles/desktop && npx pnpm@11.9.0 install
完成后重启 DeepSeek Harness 应用。
从 GitHub¶
dsh plugin add github:bzhao0110/dsh-usage-dashboard
README 说明：git 方式安装的是源码，可能需要在 profile 的 pnpm-workspace 里授权构建脚本；优先推荐 npm 安装。
典型用法¶
查看面板¶
安装并重启 Harness 后，打开 设置 → Token 统计，即可查看指标卡、热力图、趋势与环形图。
历史数据回填¶
若需要全部历史会话进入统计，在插件仓库目录执行：
node tools/backfill.mjs --dry # 预览
node tools/backfill.mjs # 写入 projcache（自动跳过活跃会话）
回填后重启 Harness，设置面板会显示全部历史统计。
适用场景与注意¶
适合谁： 长期在 DSH 中使用多模型、多会话，需要总览 token 用量、活动节奏与模型占比的开发者。
兼容性（README）： peer 依赖接受 DSH 0.1.0-rc.6 起的 0.1 线与 0.2 线全部版本（含 rc）；0.3.0 及以后未经测试。当前 npm 包版本为 0.1.0。
客户端平台： package.json 中 dsh.client.platform 为 web，并注入 @deepseek-ai/dsh-client-ui-settings。
结尾¶
dsh-usage-dashboard 把分散在会话日志里的 token 事件收成 天 × 模型 的投影，再在设置页用 SVG 面板呈现，适合需要用量总览而非账单估算的场景。更多信息见 SkillHub 目录 与 GitHub：bzhao0110/dsh-usage-dashboard。
