Fiennes4590/dsh-token-usage-calendar

README excerpt

DSH Token 用量日历 一个为 DeepSeek Harness（DSH） 编写的动态 Cordis 插件 。它直接读取 DSH 持久化会话日志中的真实模型 usage ，按日、周、月展示 Token 用量，并提供模型维度明细、热力颜色自定义和深色模式适配。 本项目不是通用浏览器统计脚本，也不会生成模拟数据；数据来源是当前 DSH 实例的真实会话事件。 功能 - 按日查看 ：标准月历，日期格为正方形；使用越多颜色越深。 - 按周查看 ：按周聚合，并用 7 天迷你柱状图展示分布。 - 按月查看 ：展示全年 12 个月汇总和相对用量。 - 悬停明细 ：显示未缓存输入、缓存读取、缓存写入、输出、调用次数和总量。 - 模型明细 ：按提供方与模型汇总当前时间范围的数据。 - 自定义热力颜色 ：提供 6 种预设色和原生取色器。 - 中文界面 ：插件中的可见文案均为中文。 - 深色模式 ：使用 DSH 官方 --dsw-alias- 主题 Token，自动跟随系统主题。 - 自绘设置图标 ：16×16 日历与热力格 SVG，不使用 Emoji。 数据口径 插件读取 sessionQuery 提供的持久化会话事件： - assistant/message.data.usage ：优先采用模型调用的最终用量； - assistant/chunk 中的 usage ：作为流式阶段样本；同一 turn:step 的最终消息会替换它，避免重复计算； - compaction/summary.data.usage ：计入上下文压缩产生的模型调用； - 分叉会话中 SessionHeader.seedLength 之前的继承事件会跳过，避免父会话前缀被重复统计。 总 Token 使用互斥桶求和： reasoningTokens 已包含在提供方的输出统计中，因此只展示或留存，不再次加进总量。 DSH 要求 运行时需要以下 DSH 能力： - Host Service： sessionQuery - Client Service： slots - Client Slot： settings.section - 可选 Client Slot： settings.section.icon - Dynamic Cordis Builtins： harness 、 host 、 React 、 styles 如果当前 DSH 尚未提供 settings.section.icon ，统计页面仍可运行，但导航会使用设置外壳的默认图标。当前版本的 DeepSeek Harness 可通过 keyed settings.section.icon Slot 显示仓库内的自绘图标。 使用方法 1. 校验与生成 Package 只需要 Node.js 20 或更高版本，无第三方依赖： 生成文件： 它的结构…

Category