前言¶
DeepSeek Harness (DSH) 记录本地会话日志，但原生界面缺乏对用量数据的统计展示。dsh-token-dashboard 插件旨在解决这个问题。它读取本地会话日志，复刻 Codex 的版式，提供累计 token、活动热力图和模型洞察等数据。
核心功能¶
- 五个累计数字：累计 Token 数、Token 使用峰值、最长任务用时、最长连续天数、当前连续天数。
- 一年活动热力图：显示全年的活动情况，支持日/周/累计总量三种模式，悬停可查看具体数值。
- 洞察：统计最常用的推理强度、按 Token 排名的模型、已探索技能数、技能总数、总会话数、总轮次以及缓存命中率。
- 最常使用：列出调用最多的技能与次数。
- 中英双语：跟随 DSH 界面语言，数字与时长格式（如
3.7亿、46分59秒）也会随之改变。 - 只读、零成本：插件只读取
$DSH_HOME/sessions下的日志，不写盘、不联网、不调用模型。 - 无运行时依赖：宿主侧仅依赖
node:*，浏览器侧从 DSH shell 的模块表获取 UI 组件。
安装与启用¶
该插件依赖 DSH 0.2.x 和 Node.js ≥ 22.18。
桌面应用（Electron）：
dsh plugin --profile desktop add @etheslay/dsh-token-dashboard --registry=https://registry.npmjs.org/
dsh web：
dsh plugin --profile web add @etheslay/dsh-token-dashboard --registry=https://registry.npmjs.org/
安装完成后重启 DSH，进入 设置 → 用量 即可查看面板。
验证与排查¶
安装完成后，可以通过访问健康检查端点确认插件是否正常加载：
# 将 <你的 DSH 端口> 替换为实际端口
curl http://127.0.0.1:<你的 DSH 端口>/dsh-token-dashboard/api/health
若在设置中未看到入口，请检查 profile 是否正确（桌面应用为 desktop），并运行 dsh --profile desktop --dump-config 确认配置中是否包含该插件。
注意事项¶
- 只读与隐私：插件不写入任何数据，不联网，也不编造 DSH 量不出来的指标（如额度、套餐等）。
- 卸载清理：卸载时需同时删除 profile
package.json中的dsh.profile.bundles条目，插件本身不保留用户数据。 - 版本要求：请确保运行环境满足 DSH 0.2.x 和 Node ≥ 22.18。
结语¶
dsh-token-dashboard 为 DSH 用户提供了本地、安全且零成本的用量分析工具。它复刻了 Codex 的统计风格，但数据完全基于 DSH 实际的会话日志。
- GitHub 仓库：https://github.com/Etheslay/dsh-token-dashboard
- 插件目录：https://www.skillhub.cn/plugins/Etheslay/dsh-token-dashboard
