前言¶

在 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。