前言¶

DeepSeek Harness（DSH）的日常使用会产生大量会话日志，开发者往往需要了解不同模型在一段时间内的 token 消耗分布与活跃度。已有的做法要么依赖外部统计平台，要么需要自行编写脚本解析本地日志。DSH 0.2.x 引入了 sessionQuery 服务，用于在宿主层读取会话数据。利用这一能力，可以在 DSH 的设置面板中直接展示统计视图，避免将日志上传到第三方。

下面介绍 dsh-strength-meter，一个 DSH Web 插件，用于在设置页按模型统计 token 用量，并展示环形图、热力图与趋势。

是什么¶

dsh-strength-meter 是一个 DSH 插件（dsh-strength-meter 2.0.0），为 DeepSeek Harness 0.2.1-rc.2（Desktop 或 dsh web）提供本地 token 用量统计视图。它通过 sessionQuery 服务从当前进程的本地会话日志中折叠数据，不进行任何上传。视图包含指标卡片、按模型的环形图、15 周活动热力图以及每日 token 趋势。插件层为宿主路由 + 设置客户端视图。

核心功能¶

• 本地折叠：从本地会话日志折叠 token 用量，不依赖投影，不向外上传数据。
• 指标卡片：显示总 token、会话数、消息数、活跃天数与连续天数。
• 按模型环形图：展示各模型的 token 占比。
• 15 周活动热力图：以周为单位，展示会话/消息的活跃度。
• 每日 token 趋势：按天展示 token 消耗趋势。
• 时间范围选择：支持“最近 7 天”或“最近 30 天”。
• 刷新机制：首次折叠会话时并发度为 4，后续请求在持久化版本未变化时复用折叠结果；点击刷新按钮可绕过 15 秒响应缓存。

安装与启用¶

插件需要以宿主权限运行，安装前请检查源码与许可证（MIT）。

插件管理器（桌面）¶

将此文件夹作为 bundle 安装，并在插件列表中启用 dsh-strength-meter。

CLI¶

dsh plugin --profile <profile> add /absolute/path/to/dsh-strength-meter

手动安装¶

1. 将包链接到 profile 的 node_modules。
2. 在 cordis.patch.yml 中添加：

- insert:
    - id: dsh-strength-meter
      name: 'dsh-strength-meter'

3. 重载页面。不修改 Harness 文件。

典型用法¶

安装完成后，在 DSH 界面中打开 Settings → Usage stats（该部分位于内置设置之后）。默认展示最近 7 天的数据，可切换到最近 30 天。点击刷新按钮可绕过 15 秒响应缓存。首次加载会对整个语料库进行折叠，后续加载会复用已折叠结果。

API 路由¶

插件提供以下宿主路由：

GET /plugins/dsh-strength-meter/usage.json?days=7|30&force=1

返回负载包含：

• total：总 token 数
• models[]：各模型数据
• sessions：会话数
• messages：消息数
• activeDays：活跃天数
• streak：连续天数
• topModel：消耗最高的模型
• byDay[]：每日 token 趋势
• heatmap[][]：15 周活动热力图
• debug：调试信息（corpus/folded/cached/errors）

适用场景与注意¶

• 适合需要快速了解本地模型使用情况的 DSH 0.2.x 用户。
• 插件以当前 DSH 进程权限运行，建议在确认源码与许可证后再安装。
• 一次请求最多折叠 400 个会话，超过时仅处理前 400 个。
• 响应缓存为 15 秒，点击刷新可强制更新。

短结尾¶

dsh-strength-meter 在 DSH 设置面板中提供本地、可视化的模型用量统计，无需外部依赖与数据上传，适合 0.2.x 版本的用户在桌面端或 Web 端使用。

• 目录页：https://www.skillhub.cn/plugins/chou109/dsh-strength-meter
• GitHub：https://github.com/chou109/dsh-strength-meter