READMESource: main@81fe7de6
仿zcode的使用统计（zcode-usage-stats）
在 DeepSeek Harness（DSH）设置页提供的 Token 用量统计插件：扫描全历史会话，聚合每天 / 每小时 / 每个模型的 Token 用量，并以「按天 / 按小时趋势图」「模型用量仪表盘」「活跃热力图」展示。
特性
- 多种时间范围：今天、昨天、最近 7 天、最近 30 天、本月、上月、自定义区间（自研日期选择器，年 / 月 / 日均可点选，起止自动校验防倒序）。
- 单日窗口自动切换按小时：选择今天 / 昨天 / 单日自定义时，趋势图横轴从「天」自动变为「小时」。
- 多模型面积趋势图：Catmull-Rom 平滑曲线 + 参考线 + 数据点吸附提示，图例可显隐单系列；曲线裁剪保证不越坐标轴。
- 模型用量仪表盘：环形占比 + 图例，窗口口径统一。
- 活跃热力图：GitHub 风格，按窗口日折叠列，hover 放大 + tooltip。
- 深浅主题跟随：颜色与 DSH 主题（
<body data-ds-dark-theme>）联动切换，不写死。 - 性能：磁盘 + 内存双层缓存，过期后后台刷新（SWR），首屏秒开；并发有限池扫描 + 超时保护。
安装
先确保已安装 @deepseek-ai/dsh（以及 pnpm，DSH 插件命令依赖）：
dsh plugin --profile web add zcode-usage-stats
或从 GitHub 源码安装：
dsh plugin --profile web add github:<你的用户名>/zcode-usage-stats
安装后重启 DSH 进程，打开 设置 → 使用统计 即可看到统计页面。
使用
- 顶部切换时间范围，或点击「自定义」弹出日期选择卡片选择起止日期。
- 趋势图可悬停查看参考线联动数据，点击图例项显隐对应模型。
- 「刷新」强制重新扫描全量会话。
兼容性
- 针对 DSH 开发者预览版开发，锁定
@deepseek-ai/dsh的>=0.1.0-rc.5。 - 依赖 DSH 宿主提供的
sessionPersistence、webServer服务，以及客户端运行时的@deepseek-ai/dsh-client-runtime、@deepseek-ai/dsh-client-ui-slots。
数据口径
- token 用量：以
assistant/message事件携带的全量usage为准（去除重复计数）。 - turns：以
step/end事件按新 turn 计数。 - 未知模型归并为
other。
许可
MIT
No comments yet. Be the first to write one.