用量统计面板 rongyishuaige7/dsh-stats

补丁版本，2026-10-23。只修正确性：没有新功能，不改定价目录，不改 peer 范围，不加新依赖。 · 变更内容 0.5.0 发布了一个大版本 UI。这个补丁是对插件数据路径、定价引擎和客户端状态做了一轮完整审查的结果，拆成一个个小修复，每个都单独测过。自 v0.5.0 以来共 95 个提交；每个确认的缺陷都在 tests/regression/ 下配了回归测试。 聚合与时间边界 · 活动跨过午夜的一次会话不再在两天窗口里丢 token，UTC 时段归到包含它的本地日期。之前的时段循环用 slot * 30min 来定日期，非 UTC 时区的本地傍晚可能落到错误的日期上。 · updatedAt 现在取真实时间戳的最大值，不再用 max(...) || null，所以唯一时间戳是 0 的会话也能保留它。 · 时间戳无效或越界不再中断整个导出或整个聚合，降级为空字段。 · 一个会话读不出来不再让整个聚合失败：该会话标记为不可用并给出警告，其余数据照常加载。 定价 · DeepSeek 旧版高峰费率现在排除北京周末，符合分时规则。之前周六上午按高峰计费。 · contextOver512k: false 会被尊重，不再当成「未知」。 · providerId 比较不区分大小写，DeepSeek 和 deepseek 不再解析成不同规则（也不再报不支持）。 · 历史 USD 总额按它自己用量当天的汇率行换算，不再用最新一行；日期会贯穿合并和传输载荷。 · 日历校验拒绝不存在的日期（2026-02-30），空目录直接拒绝，不再校验通过。 · tierMultipliers 为假值时不再绕过校验，倍率为 1 也不再显示成额外定价条件。 · 汇总里混有免费行和未定价行时不再报免费。 状态、缓存与版本 · 路由行命中缓存后仍保持顺序；之前更新过的行会被插到过期位置。 · 设置读取失败时定价存储保留之前的设置，精确恢复固定的目录版本，返回历史记录的副本而不是内部数组。 · 投影缓存行的身份（id、cwd、createdAt）或生命周期与会话头不匹配时会被拒绝。 · 警告对象不再把内部计数字段泄漏到 RPC 载荷里。 空值与原型安全 · 以用户数据为键的查找（__proto__、constructor）在项目筛选、余额标签、路由缓存和趋势序列里改用自有属性检查。 · null 的项目、会话、窗口和余额条目跳过而不是抛错，空字符串余额当作「未上报」而不是「无效」。 客户端行为 · 余额提醒铃铛重新出现（之前被一个真值判断 bug 压掉了），提醒输入框在外部改动后不再保留旧值。 · 过期的 resetsAt 不再显示成「即将重置」。 · 会话表的「sessions」列按真实值排序；模型占比环、热力图图例和平均线与实际绘制一致。 · 日模式按钮恢复你离开的那一天，不再写入 null，所以从概览 → 全部 → 日切换不再重置到最新一天。 · 关闭定价抽屉后焦点回到触发按钮，Tab 键停留在模态抽屉内。 · 宿主提供会话级权威成本时 CSV 导出用它，会话在汇总列和明细行里不再显示两个不同金额。 有意保持原样 发布审查时驳回了一条审查发现，因为提议的改动与已有且写明的约定冲突： · 子代理分组标题继续显示项目级子代理数。按页计数会让同一个标题在翻页时变化，并破坏浏览器 fixture 基线。 · 兼容性 与 0.5.0 一致：相同的 peer 范围，相同的 engines.dsh（>=0.1.0-rc.6 <0.3.0），相同的签名目录。唯一的传输改动是成本总额上一个可选定价字段；旧载荷仍然有效，schema 仍拒绝未知字段。 | Harness | 验证 | | --- | --- | | 0.2.1-rc.2 | 隔离的真实模块契约：在 Node 22.22.0 上 6/6 项检查通过 | | 更早的行 | 未变，见 docs/compatibility.md | · 验证 · 完整测试套件：652 个测试 / 152 个文件在默认时区和 TZ=UTC 下通过（0.5.0 时是 505；125 个回归测试）。 · 浏览器 fixture：50 个检查组 / 80 张截图，0 控制台错误，0 运行时异常，0 失败请求，覆盖 1440/390/320 px，包括本版本新增的保存前预览提示。 · 0.2.1-rc.2 上的真实 Harness 契约：TYPERT 清单、JSONL 持久化、带 fork 排除的投影初始化/恢复/检查点、聚合传输 schema 和实时 snapshotEvents 一致性。 · 签名目录 2026101824：900 条规则，已用固定公钥验证。 · 全新构建与提交的 lib/* 一

1.0 之前的功能版本，2026-10-21。 · 亮点 · 支持 DSH 0.2.1-rc.2：peer 范围、隔离的 Harness 契约矩阵和兼容性文档现在都包含 0.2.1-rc.2。契约冒烟测试同时接受 0.2.0（默认导出）和 0.2.1（apply 对象）两种插件导出形式。 · 官方新模型接入：30 分钟定价工作流会抓取 OpenAI、Anthropic 和 Google 官方页面。标准价格明确的新文本模型会作为估算规则追加，带 [provisional] 标注并自动签名。已有模型的价格变动、已退役或受限模型、非文本模型和身份不明确的模型仍留作待审候选。 · 最长已知模型回退：global:...-sg 这类路由后缀可以通过最长已知别名解析，而不再变成待计价；估算价格绝不会被当作精确价格展示。 · 最新目录覆盖：GPT-6.1 Sol、Claude Opus 5.5 和 Gemini 4 Argon 规则，外加当前 Anthropic 和 Google 模型的临时官方覆盖。 · 项目概览重做（0.5.0）：成本优先的 KPI 行、Token 结构图例、活跃时段条、带吸顶表头的七列项目表、可记住隐藏状态的筛选菜单，以及可展开的项目/会话详情。面板高度固定，概览和时间线共用一个主体滚动区。表头、状态横幅和定价抽屉保持原位。Esc 先关闭最上层（筛选、菜单、抽屉），再关闭面板。 · 定价设置抽屉（0.5.0）：原来的长定价页换成 560px 的三段式抽屉（窄屏下占满面板宽度）：模型、自定义规则、更新与版本。模型按 25 组一页，支持已用/全部筛选、搜索、平铺/阶梯摘要和完整规则详情；自定义规则采用列表/编辑器分栏，含条件、两层草稿、待移除/撤销、预览失效和固定操作底栏。更新与版本分开显示当前目录、检查/同步时间、自动更新草稿和每次 5 个的目录快照。恢复快照会将其固定并暂停自动更新，同时保留自定义规则；取消固定需要先预览保存，且不会触发刷新。模型历史费率与整目录快照保持区分。见 docs/pricing-settings-0.5.0.md。 · 时间线重做（0.5.0）：日视图现在用项目泳道置于半小时成本/token 条之上，带键盘可达的半小时详情浮层和可展开的会话行。全部视图是日历矩阵，每页 30 天，按强度/项目着色，含空闲行、周间隔、时段分布和每日条。时间线没有内部视口；面板保持单一主体滚动。 · 余额页重做（0.5.0）：所有已连接账户现在按紧急程度排成一个列表，不再用服务商下拉框。摘要条按币种汇总可用余额，突出最紧张的配额，并统计需要关注的账户数。每行显示余额明细或剩余配额条，可链接到服务商控制台，并支持仅存于浏览器的单账户提醒行。首次加载用统计/服务商骨架屏；单个账户失败时留在自己那行，整次查询失败则移到表头并显示重试横幅。 · 响应式细节：320/390/640 布局把会话时间、轮次/步数、LLM 和工具耗时、缓存命中、输入/输出和模型放在一行不截断的元信息里；宽行每列都不裁切。 · 趋势重做（0.5.0）：趋势标签页现在提供 7/30/90 天范围和成本/token 切换，含摘要条、每日条、固定 26 周热力图，以及模型环形图和可排序表格。点击柱子或热力格会在概览中打开那一天，页面跟随项目筛选。 · 仓库入口：面板标题（「DSH 用量」/「DSH Usage」）现在是链接，指向 <，在新窗口打开并带 noopener noreferrer。它键盘可达，保留对话框的无障碍名称，定价抽屉打开时不可达。 · README 和双语指南：README 现在并排介绍桌面端和 Web 安装，详细的安装、定价、账户、数据状态和导出内容移到 docs/usage-guide.md 和 docs/usage-guide.en.md。README.zh.md 保留为指引页。 · 趋势页（0.5.0） · 范围：最近 7、30 或 90 天，始终截止今天。范围驱动摘要条、每日条和模型部分；热力图固定 26 周，并在自己的标题里注明。 · 指标：成本或 token。切换会改变柱子、热力深浅、模型占比和环形图。 · 26 周热力图：每天一格，按活跃日的四分位着色，旁边显示活跃天数、当前连续和最长连续。 · 跳转日期：点击柱子或热力格会在概览中打开那一天，并把焦点移到概览标签页。 · 项目筛选：隐藏的项目在这里被排除，与概览和时间线完全一致，隐藏状态在三个页面间共享。 · 当前连续：现在指延续到今天或昨天的连续，所以上个月就断掉的连续不再算作当前。之前的「当前连续」从最近一个活跃日往回数。 · 兼容性 | Harness | 验证 | | --- | --- | | 0.1.3-alpha.2 到 0.2.0-rc.2