DeepSeek Harness (DSH) 采用了插件化架构，允许开发者通过扩展功能来增强工作流。在长期使用 DSH 进行开发或调试时，追踪 Token 消耗、估算费用以及分析模型性能是常见需求。dsh-token-usage 插件旨在解决这一问题，它通过监听 DSH 的会话日志，为用户构建了一个可视化的统计面板。
核心功能¶
该插件主要提供以下统计维度：
- 实时与历史回放：实时监听所有会话的事件流，并在启动时回放全部历史会话日志。这意味着统计包含安装插件前的历史用量，且重启服务不丢失数据。
- 概览面板：展示今日、本周、本月的 Token 总量及费用估算，并细分为输入、输出、缓存命中等类别。
- 任务统计：分析本周任务，包括思考时长（通过
reasoning-delta片段计算）、总任务时长、任务数及步骤数。 - 排行榜：
- 任务 Top 3：本周 Token 消耗最高的任务。
- 模型排行：本周各模型的 Token 消耗占比、进度条及费用。
- 项目统计：按工作区（会话 cwd）分组的用量，支持切换本周/全部视图。
- 图表展示：近 14 天的堆叠柱状图，鼠标悬停可查看当日明细。
- 价格设置：支持 DeepSeek 官网的峰谷计价规则（高峰时段价格翻倍），并支持一键从官网获取最新定价。
安装与启用¶
在安装前，请确保已安装 DeepSeek Harness (DSH)、git 与 pnpm。
一键安装¶
使用官方提供的安装脚本：
bash -c "$(curl -fsSL https://raw.githubusercontent.com/KeFan-J/dsh-token-usage/main/install.sh)"
脚本会自动克隆仓库、安装依赖并将插件挂载到 DSH web profile。安装完成后，执行以下步骤启用插件：
- 重启 DSH 服务：
npx @deepseek-ai/dsh web
- 在浏览器中强制刷新页面（
Cmd+Shift+R）。 - 打开设置（齿轮图标），在设置列表中找到并点击「Token 用量」。
手动安装¶
如果需要自定义安装路径，可使用以下命令：
git clone https://github.com/KeFan-J/dsh-token-usage.git
cd dsh-token-usage
pnpm install
dsh plugin --profile web add "link:$(pwd)"
# 重启 DSH + 强制刷新浏览器
实现原理¶
- Host 端：监听全局
session/event事件流，启动时回放日志。通过sessionId:seq去重以防止重复计算。根据生效的定价规则（含峰谷）计算费用，并提供 JSON API 路由。 - 浏览器端：在 DSH 的设置槽位中注册页面，样式使用
--dsw-*主题变量以适配亮/暗模式。 - 挂载方式：通过
cordis.patch.yml以裸插件行挂载到 DSH profile 的 bundle 层，无需修改 DSH 源码。
数据与隐私¶
- 本地存储：所有数据仅存本地，用量来源于 DSH 自身的持久化会话日志，费用在本地计算，不上传任何遥测数据。
- 对外请求：插件唯一的对外请求是「从官网获取最新价格」按钮，该操作仅读取 DeepSeek 公开定价页面的内容。
许可证¶
MIT
