Repository navigation
Releases: axuan-1314/dsh-usage-stats
Releases · axuan-1314/dsh-usage-stats
Release list
v0.2.0
首个公开版本。
DSH 官方桌面版设置页新增「使用统计」分区。
- 面板:五格摘要条(累计 Token / 单日峰值 / 最长聊天时长 / 当前连续天数 / 最长连续天数)、52 周 Token 热力图(每日·每周·累计三档)、今日·近 7 日·近 30 日趋势折线、模型用量环形图;统一悬停卡片、键盘可达、60 秒静默轮询与热力图按需刷新。
- 采集:订阅宿主
session/event,按官方 tokenUsage 投影折叠语义逐事件产出净增量。 - 历史回填:多帧 zstd 会话文件逐帧解压,fork 会话按内核继承标记剪切前缀去重;增量幂等,已记账会话秒级跳过。
- 存储:全部落在
~/.dsh/usage-stats/(在插件包目录之外,卸载 / 重装不影响数据):按月轮转的记录流水(唯一真源)、日聚合缓存、回填游标、单写者锁。 - 只读 API:摘要 / 热力图 / 趋势 / 模型四条 GET 与
POST /backfill走内核 webServer 同源反代;抢不到写锁的实例降级为只读镜像,API 照常。 - 零运行时依赖、全本地零上传。
安装:
dsh plugin --profile desktop add https://github.com/axuan-1314/dsh-usage-stats/archive/refs/tags/v0.2.0.tar.gz