前言¶

DeepSeek Harness（DSH）的理念之一是「一切皆插件」。在实际运行智能体时，一个常见问题是：多个模型、多个 provider、main 会话和 subagent 会话混在一起时，token 用量、缓存命中率和单次会话消耗分散在会话日志里，不容易一眼看清。

dsh-usage-panel 是一个 DSH 插件，在 web GUI 的设置页「消耗统计」中提供 Token 用量面板，用于查看累计用量、时间趋势、模型分布、provider 分布和高 token 会话。下面介绍它的功能、安装方式和适用注意。

插件定位¶

dsh-usage-panel 的仓库位于 AlfredChaos/dsh-usage-panel，许可证为 MIT。

它面向使用 DSH web profile 的用户，在设置页展示 Token 用量 KPI、半年活跃贡献热力图、按模型堆叠柱状图与模型环形图。数据来自 Host 投影聚合与只读重算会话日志，插件不会向会话日志写回数据。

核心功能¶

累计用量与缓存命中率¶

累计总用量包括：

• 计费输入 token；
• 计费输出 token；
• 会话数；
• 最常用模型占比。

缓存命中率按以下公式展示：

cache read ÷ (uncached input + cache read + cache write)

活跃热力图与每日趋势¶

近六个月活跃热力图使用 GitHub 贡献式布局，按 UTC 天分桶。

按模型堆叠的每日柱状图可切换最近 7、14、30 天，用于观察模型维度的 token 用量变化。

会话、provider 与模型分布¶

面板会列出 Top 10 token 最多会话，并标注 main 或 subagent。

当存在多 provider 路由时，会显示按 provider 的 token 横向条形图。

模型环形图展示模型占比，并列出 Top 5 模型，附带每模型缓存命中率。

导出与刷新¶

插件支持导出：

• 完整 JSON；
• 每日 CSV；
• 按模型 CSV。

CSV 导出会做公式注入防护，并按 RFC 4180、UTF-8 BOM 输出。

插件加载后开始首次扫描。payload 新鲜期为 10 分钟；过期 payload 会带 stale 标志并后台刷新。浏览器会在 localStorage 中保留最后一次成功 payload。

安装与启用¶

先安装插件，再重启 DSH web profile，最后打开设置页。

从 npm 安装：

dsh plugin --profile web add dsh-usage-panel

也可以从 GitHub 或本地目录安装：

dsh plugin --profile web add github:AlfredChaos/dsh-usage-panel
dsh plugin --profile web add ./dsh-usage-panel

安装后重启 DSH web profile：

dsh --profile web

然后打开 Settings → Usage，中文界面为「消耗统计」。

npm 包提供预构建的 lib/ 文件，且无安装脚本。该插件开发对应 DeepSeek Harness 0.1.0-rc.6，peerDependencies 包含：

"@deepseek-ai/cordis": "^4.0.1",
"react": "^18.3.1"

如果之后需要移除：

dsh plugin --profile web remove dsh-usage-panel

典型用法¶

1、安装后打开「消耗统计」，先查看累计总用量、缓存命中率和最常用模型占比。

2、在每日柱状图切换最近 7、14、30 天，观察模型维度的 token 用量变化。

3、查看 Top 10 会话，确认高 token 会话是 main 还是 subagent。

4、如果使用了多个 provider，查看 provider 横向条形图，确认 token 分布。

5、需要归档或离线分析时，导出完整 JSON、每日 CSV 和按模型 CSV。

适用场景与注意¶

适合：

• 使用 DSH web profile 的开发者；
• 需要观察多模型、多 provider 路由下 token 消耗的用户；
• 需要检查缓存命中率、模型占比和高消耗会话的运维或工程师。

注意：

• 插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。
• 统计日桶与导出使用 UTC 日历日。
• 插件是只读聚合，不向会话日志写回数据。
• payload 新鲜期为 10 分钟，过期会带 stale 标志并后台刷新。

结尾¶

dsh-usage-panel 的价值是把分散在会话日志里的 token 用量、缓存命中率和模型分布整理成设置页里的可视化面板，便于在 DSH 智能体运行过程中快速定位高消耗会话和模型差异。

参考链接：

• GitHub：https://github.com/AlfredChaos/dsh-usage-panel
• 社区目录页（独立站点，与 DeepSeek / 幻方无官方从属关系）：https://www.skillhub.cn/plugins/AlfredChaos/dsh-usage-panel