deepseekplugins

DeepSeek Harness 插件

dsh-usage-statistics-panel

DSH web plugin: a usage statistics panel with per-day token trend, GitHub-style activity heatmap, cache hit-rate curve and per-model breakdown, replicating the reasonix usage stats feature.（英文原文）

界面增强
跳到安装方式

来源信息

GitHub 仓库
HaoyueQin/dsh-usage-statistics-panel
最近更新
2026年8月22日
分类
界面增强
GitHub stars
1
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt，让 Agent 读 GitHub 仓库和源码；需要自己装时再切到命令。

复制这段 Prompt，发给 DSH、Codex 或其他 Agent，让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码，然后用清楚、直接的方式回答以下问题，帮助我判断它是否适合我的需求：

1. 这个插件是什么，解决什么问题；
2. 适合哪些用户和典型使用场景；
3. 安装后如何使用，并给出一个最小使用示例；
4. 有哪些已知限制，以及隐私、安全、兼容性或维护风险；
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明，不要猜测或照抄 README。

GitHub：https://github.com/HaoyueQin/dsh-usage-statistics-panel
插件名：dsh-usage-statistics-panel
作者：HaoyueQin

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器4 个文件
README.md来源说明 · 只读预览
README 语言

DSH Usage Statistics Panel

English | 中文

!npm version !npm downloads !License !TypeScript !dsh-plugin

DSH web 插件的用量统计面板：按天 Token 趋势、GitHub 风格活跃热力图、缓存命中率曲线、按模型用量拆分（环形图 + 列表），在设置页新增一个"使用统计"页面。

所有图表均为手绘 SVG，不依赖图表库；配色使用 GitHub Primer 的 data-viz 双套色板（前 5 名模型各取一个等级色，其余归入灰色 "Other" 桶），并随 DSH 主题自适应。

预览

![面板概览：汇总卡片、活跃热力图与按天 Token 趋势](docs/images/panel-overview.png)

![模型用量：环形图、列表与趋势图](docs/images/model-usage.png)

功能

  • 时间范围：最近 7 / 14 / 30 / 90 天，或自定义起止日期
  • 汇总卡片：Token 用量、会话数量（完成的 turn）、请求数量、活跃天数、平均缓存命中率、最常用模型
  • 26 周活跃热力图：每日 token 用量的 GitHub 风格色阶，悬停查看当天明细
  • 按天 Token 趋势：堆叠柱状图叠加平滑的缓存命中率曲线（Catmull-Rom 样条），悬停查看各模型拆分
  • 模型用量：环形图 + 列表，前 5 名模型分色，其余折叠为可展开的 "Other" 明细
  • 历史回扫：首次启用时枚举并回放既有会话日志；对挂载后才首次观测到的活跃会话，其挂载前的历史会在下一次启动时按事件序号边界回放补全，从安装日起尽量还原历史用量
  • 本地持久化：数据写入 $DSH_HOME/storages/usage_history.json（storage-domain），纯本地、无外部依赖

安装

dsh plugin --profile <name> add dsh-usage-statistics-panel@latest

装完硬刷新浏览器（Cmd/Ctrl+Shift+R）：client 半的改动 DSH 会热加载，无需重启；仅 host 半（采集/存储/路由）更新时需要重启 DSH。

插件挂载后，在 Web UI 的设置页左侧导航会出现"使用统计"页面。

数据来源

面板的数据采集是观测式的：插件订阅会话事件流（session/event）中的 assistant/message 与 assistant/chunk，提取 provider 上报的 token 用量（输入 / 输出 / 缓存读 / 缓存写），在单个会话内按 (turn, step) 去重（同一调用只计一次、保留先到的样本——两个官方适配器对流式采样与最终上报的数值完全一致；并发会话各自独立计数、互不吞样本）。模型归因优先取消息自带的 source（每次调用各自标注），缺失时回退到会话的路由折叠（request/context 事件或会话的 requestContext()），宿主重启后也不会落入 "(unknown)" 桶。首次启用时还会回扫既有会话日志补齐历史。

> 提示：Token 用量从插件启用（含回扫）之日起累计；更早的会话日志若无 provider 上报的用量数据，则无法回溯。

Token 口径：汇总卡片与趋势图的 Token 总量为服务商总口径——未缓存输入 + 输出 + 缓存读 + 缓存写，与服务商账单面板一致（DeepSeek 会把 prompt 拆成输入/缓存读两个不相交的桶，简单相加会漏掉占大头的缓存部分）。平均缓存命中率只以输入侧（命中 + 未命中）为分母，命中率卡片下方同时展示缓存命中的绝对 token 量；两个口径互不混用。

重建统计：POST /usage/api/reset（与面板同源信任围栏保护）清空本地统计并按当前归因规则全量重放会话日志——用于历史数据损坏或归因规则升级后的重建。仍在进行中的会话以其重置时刻的日志长度为界：界内由重放重建、界外继续由实时采集，恰好各计一次。

开发

pnpm install
pnpm typecheck   # tsc --noEmit
pnpm test        # vitest
pnpm build       # tsc declarations + tsdown (host ESM + 双通道 client bundle)

设计与实现

  • Host 半（src/）：collector（事件订阅 + 回扫折叠）、store（usage_history storage-domain）、query（范围聚合，翻译自 reasonix 的 query.go）、routes（/usage/api fenced JSON 路由，信任围栏与 /api 网关一致）
  • Client 半（src/client/）：UsageStatsPanel.tsx（手绘 SVG 图表，移植自 reasonix 面板 + Primer 配色）、locales（en / zh / zh-TW）、api（/usage/api fetch 封装）
  • 双通道打包：lib/client.js（官方 profile 通道，bundle id = 包名）与 lib/client-registry.js（插件注册表通道，bundle id = manifest id）。harness 0.1.x 官方加载链只消费前者；后者为外部 registry 通道预留，当前无消费者
  • 详细设计见 [docs/design.md](docs/design.md)

致谢

本面板是对 reasonix 用量统计功能的复刻移植：作者曾为 DeepSeek-Reasonix 实现并贡献了该功能（PR #7238、#7503），本插件按 DSH 的插件规范将其移植到 DeepSeek Harness，前端图表大比例复用原实现，数据层则基于 DSH 的会话日志与 storage-domain 重新实现。

License

MIT

返回搜索打开 GitHub 仓库

更多相关插件

查看分类