joxmx/dsh-usage

README 摘要

dsh-usage 给 DSH Web GUI 加一个 Codex 风格的 本机「用量」页 ：累计/峰值 Token、连续天数、Token 活动热力图、活动洞察（推理强度/模型/技能/任务/会话/回合）、最常用工具。 纯只读、纯本机：只扫描 /.dsh/sessions 下的会话日志做统计，不修改任何数据采集，不上传任何数据。Token 数值是 provider 上报 + 启发式计费的 估算值 ，不是账单。 效果 打开 dsh web → 左下角设置 → 导航里出现「用量」（Usage）一节： - 顶部 5 张卡片： 累计 Token 数 （附输入/输出/缓存拆分）、 今日 Token 数 、 峰值 Token 数 （单次请求）、 当前连续天数 、 最长连续天数 - Token 活动 ：近 53 周逐日热力图（GitHub 风格）， 最新日期排在最左 （今天无需滚动即可见；未来日期半透明置灰），hover 显示日期与数值； 点击任意日期 在下方展示当日用量（含占峰值日百分比），再点一次或点「清除选择」取消 - 活动洞察 ：最常用推理强度、最常用模型、已探索技能、使用的技能总数、任务总数（顶层会话数）、会话总数、回合总数 - 最常用工具 ：Top 8 工具调用（bash/read/… 带比例条） - 右上角「刷新」按钮强制重算（ ?refresh=1 ） 秒开设计 ：浏览器端把上次快照存进 localStorage，打开页面立即渲染、后台刷新；服务端把聚合快照缓存在内存（默认 60 秒窗口内打开直接命中，过期后在后台重算，永不阻塞打开），并对每个会话按日志 revision 做 增量折叠 ——重算只重读变化过的会话，冷启动之后几乎零成本。 架构 两个半脸一个包（dual-face），完全走 DSH 现有扩展机制： 半边 文件 作用 host lib/index.js + lib/aggregate.js 注入 sessionQuery + webServer ，经 ctx.sessionQuery.listSessions()/readSession() 折叠全部持久化会话，在 webServer 上注册一个只读 exact 路由（默认 /usage.json ） client lib/client.js 浏览器模块加载器格式（ window. ModuleLoader .load ）的 settings 插件，注册 settings.section （id usage ），从 /usage.json 拉数据显示 client 半是 手写的 ModuleLoader 格式包 ：不依赖 tsdown/rolldown 等 monorepo 工具链， require("react") 走 shell 静态模块表，其余依赖（ slots / locale 服务）走 …

分类