前言¶
用 DeepSeek Harness（DSH）跑智能体时，Token 会分散在各会话日志里。想看清「今天用了多少」「哪个模型占大头」「哪条会话最费 Token」，往往要手动翻日志或自己写脚本。下面介绍社区插件 dsh-usage-stats（维护者 aooyoo，分类：客户端）：在 DSH 左侧栏增加入口，把本机所有会话日志里的用量折叠成每日、按模型、按会话三个视角，且不发任何外网请求。
这是什么¶
dsh-usage-stats 是非官方社区插件，面向 DeepSeek Harness 的 Web 界面。它在「插件」「定时任务」之后增加侧栏图标，点开即主面板；数据只来自本机会话日志中 assistant/message 事件里 provider 上报的 usage，不做价格估算。
- 目录页：https://www.skillhub.cn/plugins/aooyoo/dsh-usage-stats
- 源码与说明：https://github.com/aooyoo/dsh-usage-stats
- 许可证：MIT（
package.json版本 1.0.0）
核心功能¶
经 README 核实，插件提供以下能力：
- 总览卡片：总 Token、输入、输出、缓存命中、请求次数、会话数；时间范围可切换近 7 / 30 / 90 天或全部。
- 每日用量柱状图：悬停查看当天 Token 与请求数。
- 按模型明细：请求数、输入、输出、缓存读、合计。
- 按会话明细：会话标题、工作目录、请求数、四个分量、合计、最近活动时间；运行中的会话带标记。
- 界面跟随宿主：中英文随界面语言，明暗主题用宿主主题变量；零 npm 依赖、无构建步骤，纯 ESM，页面自带 React。
统计口径要点：四个分量为输入、输出、缓存读、缓存写，合计为四者之和；只统计上报了 usage 的请求（被取消且无 usage 的步骤不计）；一次请求归属到所在会话的本机时区那一天。
安装与启用¶
插件以 DSH Settings → Plugins 安装 bundle 为准；装完后刷新页面，侧栏会出现新图标，插件行 id 为 usage-stats。
两种入口（摘自 README）：
- 本地目录（已验证）：将仓库放到本地，安装时指向仓库根目录（仓库根目录即插件包本身）。
- 包名：若你的 DSH 版本支持按 npm spec 安装，直接填
dsh-usage-stats。
兼容性：package.json 声明 engines.dsh: >=0.2.1-rc.5，面向 DeepSeek Harness 0.2.1-rc.5 开发与验证；不满足的版本会被插件管理器拦下。
首次打开面板需读取全部会话日志；README 记载本机 214 个会话实测约 5–15 秒（显示「正在读取会话日志…」），之后 30 秒内复用缓存为毫秒级。
配置¶
行配置写在 cordis.patch.yml（或你 profile 的补丁层）里，例如：
- insert:
- id: usage-stats
name: dsh-usage-stats
config:
cacheMs: 30000
maxSessions: 400
allowPlainRoute: false
diagnostics: true
| 字段 | 默认 | 含义 |
|---|---|---|
cacheMs |
30000 |
整份快照的缓存时长；面板「刷新」会强制重算 |
maxSessions |
400 |
参与统计的会话上限，按最近活动取 |
allowPlainRoute |
false |
是否在认证路由不可用时额外注册未认证路由 /usage-stats.json（见隐私说明） |
diagnostics |
true |
激活失败时是否在系统临时目录写诊断文件 |
典型用法¶
- 按上文安装并刷新 DSH Web 界面。
- 点击侧栏用量统计图标，等待首次日志折叠完成（会话多时可稍等）。
- 在总览卡片切换 7 / 30 / 90 天或全部，查看每日柱状图与按模型、按会话表格。
- 需要强制重算时，使用面板上的「刷新」（会绕过
cacheMs缓存）。
面板数据默认经需登录 cookie 的认证路由 /api/usage.stats 提供；未认证的 /usage-stats.json 仅在 allowPlainRoute: true 时注册，一般不建议开启。
隐私、性能与限制¶
隐私：只读本机 DSH 会话日志，无遥测、无上报、无外链。激活失败且 diagnostics: true 时，可能在系统临时目录写入 dsh-usage-stats-activation.json（含阶段、错误、堆栈），用于排查；可设 diagnostics: false 关闭。
性能：单会话按最近更新时间增量复用；整份快照按 cacheMs 共享；读取并发上限 4。
已知限制：无按工作区筛选、无费用估算、无导出；会话很多时首次打开偏慢；扩展点属 DSH 内部接口，宿主升级后面板可能需重新确认插件是否激活成功。
适用场景与注意¶
适合需要在 DSH 浏览器 Web GUI 内快速审视 Token 消耗、对比模型与会话占用的开发者。插件在本机 DSH 进程权限下读日志并提供本地 HTTP 数据；安装前应自行查看源码与 MIT 许可证，确认符合你的环境策略。
DSH 生态强调「一切皆插件」；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系，本插件亦未获官方背书。
结尾¶
dsh-usage-stats 把分散在会话日志里的 Token 用量收成侧栏里的总览、每日与明细视图，本地计算、零外联。进一步了解可访问 SkillHub 目录页 与 GitHub 仓库。
