Make0209/dsh-usage-stats

README excerpt

dsh-usage-stats DeepSeek Harness 插件：GitHub 风格用量热力图 + Token / 缓存命中 / 账户余额看板 + 工作区别名管理。 - 热力图 ：53 周 GitHub 绿，每完成一个回合点亮；悬停按工作区显示次数明细与当日 Token - 统计卡片 ：总花费 Token（分项）、缓存命中率、账户余额（DeepSeek 官方接口）、总使用次数、连续使用、各工作区 Token 进度条 - 工作区别名 ：头部「✎ 工作区别名」管理，持久化保存（ $DSH HOME/storages 的 KV 单元 usage-stats-aliases ） - 时间范围切换（近 30 天 / 近 90 天 / 全部）、动画、亮暗主题自适应 效果截图 安装 本插件是标准的 DSH 社区插件包（声明 dsh.bundle manifest + web client 半），数据全部来自持久化会话日志，安装后自动回填历史。 方式一：官方插件命令（推荐） 安装后刷新页面即可，无需手动改配置、无需重启。 方式二：手动注册（本地包） 1. 把本目录放入任意位置，并在 $DSH HOME/profiles/node modules/ 下创建指向本目录的符号链接（Windows 用 junction）： 2. 在 $DSH HOME/profiles/web/cordis.patch.yml 添加一行： 用户 patch 层会被热重载：保存后刷新页面即可。 架构 - Host 半 （ lib/index.js ）：扫描持久化会话日志聚合用量（ turn/end + assistant/message.usage ），监听 session/event 实时折叠；通过 webServer 服务注册数据路由： - GET /api/usage-stats — 统计快照 - GET /api/usage-stats/balance?force=1 — 账户余额（复用 llm-deepseek 的 API Key 配置） - POST /api/usage-stats/alias — 设置工作区别名 - Client 半 （ lib/client.js ）： window. ModuleLoader 工厂格式的浏览器 bundle，注册设置面板「用量统计」页（ settings.section 槽位）。 数据说明 - 使用次数与 Token 全部来自 DSH 持久化会话日志，插件激活时会自动回填全部历史，插件卸载/重启后数据不丢 - 余额查询走 DeepSeek 官方 /user/balance 接口；未配置 API Key 时卡片显示引导文案 - 仅统计能归属到已注册工作区（按会话 cwd 匹配）的会话 开发 - 修改 lib/index.js / lib/cli…

Category