前言¶
DeepSeek Harness (DSH) Web GUI 是一个基于浏览器和 Node.js 的集成环境，常用于智能体开发和模型调用测试。在日常使用中，精确掌握每日的 Token 消耗量对于控制成本、排查异常高耗以及优化 Prompt 至关重要。目前 DSH 原生界面缺乏可视化统计功能，手动统计或依赖外部脚本操作繁琐。面向这一场景，dsh-plugin-token-heatmap 插件提供了一个直观的解决方案。
插件概览¶
这是一个面向 DeepSeek Harness Web GUI 的每日 Token 用量热力图插件。它通过悬浮窗的形式展示历史与实时用量，帮助用户快速识别使用模式。
- 维护者: P-CAmilE
- 许可证: MIT
核心功能¶
该插件主要提供以下能力：
- 双数据视图：悬浮窗内支持在「全局」（所有会话合计）与「当前会话」之间切换查看。
- 历史回填：首次安装时，插件会自动扫描所有历史会话日志，将过去的数据计入热力图。
- 实时更新：窗口可见时，系统每 3 秒轮询一次数据。数据携带版本号，仅当数值变化时触发更新。
- 可视化展示：采用 5 级蓝色色阶（最深色为
#396BE2），根据非零天数的四分位进行分档。支持竖向网格，展示 12 个月窗口，包含「回到最新」的快捷操作。 - 交互与记忆：支持拖动悬浮窗，窗口位置会被记录在
localStorage中。支持显隐控制，并适配 DSH 的深浅主题。 - 汇总统计：提供今日、本周、本月及 12 个月合计数据。鼠标悬停可查看输入、输出、缓存读写等分项详情。
安装与启用¶
在终端中执行以下命令安装插件：
dsh plugin --profile web add dsh-plugin-token-heatmap
安装完成后，重启 DSH Web，右下角会出现一个方形图标，即表示插件已启用。
典型用法¶
- 查看数据：点击右下角的方形图标，悬浮窗会显示当前的 Token 用量热力图。
- 切换视图：在悬浮窗顶部点击，在「全局」和「当前会话」之间切换数据源。
- 浏览历史：热力图默认展示最新一周，向下滚动可查看更早的 12 个月数据。
- 查看详情：鼠标悬停在某个色块上，可查看该日的详细用量统计。
环境与注意事项¶
- 运行环境：插件依赖
@deepseek-ai/*运行时（私有包），仅能在 DSH 环境内安装和使用。 - 开发依赖：本地构建需要 Node.js >= 20 和 pnpm。
- 数据存储：插件的持久化数据存储在宿主端的
$DSH_HOME/token-heatmap/目录（即~/.dsh/token-heatmap/）。 - 容错机制：如果文件损坏，插件会从空状态启动并告警，不会导致 DSH 进程崩溃。
- 权限范围：插件以当前 DSH 进程的权限运行，建议在安装前查看源码与许可证。
结语¶
dsh-plugin-token-heatmap 为 DSH Web 用户提供了一个轻量级的 Token 追踪工具。通过可视化的色阶和实时更新机制，可以更直观地管理开发成本。更多细节与源码，可参考其 GitHub 仓库。
