前言¶
DeepSeek Harness 的会话日志里记录了每条模型回复的输入、输出、缓存读写，但默认没有可视化入口。开发者往往要打开日志文件或依赖供应商后台才能知道「今天花了多少」「哪些渠道最多」。dsh-token-dashboard 在左侧栏新增一个「Token 用量」入口，把本机日志聚合成一个看板：按天、按供应商渠道、按会话统计 Token 消耗，且所有数据只读本地，不上报、不联网、不填 API Key。
它是什么¶
dsh-token-dashboard 是一个 DeepSeek Harness 插件，由维护者 zhujiuyi 开发，分类为客户端插件。它读取本机 Harness 的会话日志，生成每日消耗、供应商渠道分摊和会话排行三个视图，并在侧栏以看板形式展示。版本 0.1.1，采用 MIT 许可证。
核心功能¶
- 每日消耗热力图：展示每个自然日 00:00–24:00 的 Token 消耗；支持切换「每天 / 每周 / 累计总量」三种着色方式，显示近 12 个月数据。
- 供应商渠道统计：展示当前 profile 配置的供应商，以及日志中曾出现过的渠道（即使后来被删掉，历史也保留）。周期可选「今天 / 近 7 天 / 近 30 天 / 全部」，支持点图例隐藏/显示单个渠道，并给出用量、日均、单日峰值和占比。
- 会话消耗排行：列出每个会话的 Token 用量，包含已归档与已删除的会话。子代理（subagent）的消耗并入父会话（行内标注「含 N 个子代理」）。支持按「Token 用量」或「最后活跃」排序，按状态筛选，以及按标题、会话 id、渠道名搜索。
- 概览指标：累计 Tokens、单日峰值、最长任务用时、最长连续天数、当前连续天数。
安装与启用¶
插件安装后，左侧栏会在「插件市场」和「自动化任务」之间新增一行「Token 用量」。安装方式如下：
方式一：插件市场（推荐）¶
打开 DeepSeek Harness → 插件 → 搜索 dsh-token-dashboard → 安装。
方式二：从本地目录安装¶
如果已 clone 仓库：
- 打开 DSH → 插件 → 安装
- 选择「本地目录」，填入仓库所在目录（例如
E:\dsh-plugin\dsh-tokenDashboard） - 安装完成后，侧栏出现「Token 用量」
新装的插件若侧栏未立即出现，重启一次 DeepSeek Harness 即可。
方式三：npm¶
dsh plugin add @zhujiuyi/dsh-token-dashboard
典型用法¶
- 查看每日消耗：点击侧栏「Token 用量」，顶部展示累计用量概览，下方为每日热力图，可切换「每天 / 每周 / 累计总量」。
- 分析供应商渠道：在「按供应商渠道」视图选择周期（如「今天」），观察一天中各时段的 Token 燃烧情况。点击图例可隐藏/显示某渠道，柱状图会自动重绘。
- 会话排行与筛选：在「按会话」视图，按用量或最后活跃排序，使用搜索框过滤标题、会话 id 或渠道名，通过状态筛选查看进行中、已归档或已删除的会话。
- 刷新与主题：点击顶部「刷新」丢弃缓存并重新读取日志；页面默认每 60 秒自动刷新（后台不刷新，切回前台时刷新）。亮色/暗色主题跟随 DSH 自身设置。
数字统计口径¶
- 用量：会话日志里每条模型回复的
输入（未命中缓存）+ 输出 + 缓存读取 + 缓存写入。 - 渠道归属：按日志顺序取当时生效的路由；会话中途切换供应商时，按实际发生顺序分别计入。
- 一天：本机时区的自然日 00:00–24:00。
- 时间范围：统计全部历史；页面上的「今天 / 近 7 天 / 近 30 天 / 全部」只是视图筛选，不改变底层数据。
- 子代理：按父会话关系合并，父会话日志缺失时子代理单独成行并标记。
- 状态：进行中 / 已归档 / 已删除（日志仍在，但会话已从列表删除）。
常见问题¶
- 和供应商后台账单对不上？ 看板统计的是 Harness 记录的 Token 数量，不是金额；供应商账单通常按缓存命中折扣、阶梯价折算，两者口径不同，看板回答的是「在哪里、何时、花了多少 Token」。
- 为什么有「已删除」会话？ 会话从侧栏删除后，日志文件仍保留在磁盘上，为不丢失历史用量，看板仍统计并标记为「已删除」。
- 为什么「当前连续天数」在半夜不归零？ 若当天尚未使用，连续天数以昨天为锚继续计算，不会在 00:00 闪成 0，等当天第一次对话后自然延续。
- 数据是否上传？ 不会。插件只读本地 Harness 目录下的会话日志和会话列表，不发起任何网络请求，也不写入 Harness 数据。
- 支持哪些版本？ 需要带
sidebar.panellist插槽的 DSH（即左侧栏有「插件」「插件市场」的版本）。Node.js ≥ 20。
适用场景与注意¶
- 适合需要精细化查看每日 Token 消耗、渠道分摊与会话成本的开发者。
- 插件以当前 DSH 进程权限运行，安装前建议查看源码与许可证。
- 依赖本地日志，确保 Harness 会话日志未被清理。
短结尾¶
dsh-token-dashboard 用极简的方式把本机日志转化为可视化看板，帮助开发者掌握 Token 消耗的分布与趋势。插件目录与源码见下方链接。
- 目录页：https://www.skillhub.cn/plugins/zhujiuyi/dsh-tokenDashBoard
- GitHub：https://github.com/zhujiuyi/dsh-tokenDashBoard
