@loommii/dsh-provider-usage 0.6.1 → 0.7.0

package/README.md

@@ -1,6 +1,6 @@
 # dsh-provider-usage — DSH「用量中心」
 
-> 当前版本 **v0.6.1** · npm `@loommii/dsh-provider-usage` · [更新历史](docs/CHANGELOG.md)
+> 当前版本 **v0.7.0** · npm `@loommii/dsh-provider-usage` · [更新历史](docs/CHANGELOG.md)
 
 DSH Web GUI 插件 **「用量中心」**：一个常驻右下角的用量卡片，实时显示你的 AI 服务用量 / 余额，不用再打开网页查；附带本地 Token 统计页，不联网也能看自己今天用了多少。
 
@@ -19,14 +19,14 @@ DSH Web GUI 插件 **「用量中心」**：一个常驻右下角的用量卡片
 |---|---|
 | OpenCode Go（订阅） | 5 小时 / 7 天 / 月度三个窗口的已用百分比 + 进度条 + 重置倒计时 |
 | DeepSeek（余额） | 账户余额（CNY） |
-| Command Code（订阅+余额，自定义） | 5 小时 / 周 / 月窗口使用量 + 月度剩余额度（USD），主数字为月已用百分比 |
+| Command Code（订阅+余额，自定义） | 5 小时 / 周 / 月窗口使用量 + 月度剩余额度（USD），主数字为本月剩余百分比（3 位小数向下取整） |
 
 ## 功能
 
 - **常驻用量卡片**：右下角悬浮，一眼看到剩余量；可随意拖动，位置自动记住
 - **自动刷新**：每 30s 自动更新；想看最新数据点卡片上的 ↻ 立即重新查询
 - **多实例**：可以同时配置多个提供方（如多个 OpenCode Go 账号），点卡片 logo / 名称切换查看
-- **本地 Token 统计**：自读本机 `$DSH_HOME/sessions` 会话文件，按天聚合今天的 Token 用量（总量 + 按模型汇总），**只读本地、不联网**；数据落盘 `$DSH_HOME/provider-usage/daily-stats/`，历史天封存只算今天
+- **本地 Token 统计**：自读本机 `$DSH_HOME/sessions` 会话文件，按天聚合今天的 Token 用量（按提供方分类 + 按模型汇总，汇总表跟随所选提供方），**只读本地、不联网**；数据落盘 `$DSH_HOME/provider-usage/daily-stats/`，历史天封存只算今天；设置页可一键重置统计缓存（不影响会话记录）
 - **状态提示**：正常 / 未更新 / 注意 / 错误，请求中显示「查询中」动画
 - **Key 安全**：密钥只在 DSH 进程内解析使用，界面上一律打码显示；自定义 Key 可加密保存在本机（AES-256 加密），不落明文
 

package/docs/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## v0.7.0（2026-09-01）
+
+### 小功能
+- **Command Code 卡片主数字改为「本月剩余百分比」**：原大数字为月已用百分比（整数、四舍五入），现改为月剩余百分比，保留 3 位小数向下取整（如 62.9432148907/70 = 89.91887…% → 显示 89.918%）；标签「已用（每月）」→「剩余（每月）」
+  - host：`monthly` 新增 `remainingPct` 字段（剩余/总额 ×100，钳 [0,100] 后 `floor` 到 3 位小数）；`usedPct` 保留（月窗口行仍显示已用口径）
+  - client：大数字读 `remainingPct`；连旧版服务端（无该字段）时按 `100 − usedPct` 同公式兜底；降级（无计划/未知计划）仍显示 `--`
+  - 回归：场景 20b/20c/20d 补断言，新增场景 20g（向下取整边界：1/70 → 1.428 非 1.429、69.999/70 → 99.998、满额 100、用完 0、超额钳 0）
+- **用量统计页新增「重置统计」按钮**：「刷新」旁两段式确认（4s 未确认自动解除）后删除按天物化的派生缓存（天文件/游标/哨兵）并清空 30s 查询缓存，下次查询自动从会话原文全量重算；**会话原文只读不动**；天文件损坏 / 迁移异常 / 想强制重建时的自助兜底；新端点 `POST /api/provider-usage/reset-local-stats`（仅回环，POST-only）
+
+### 修复
+- **用量统计页「按模型汇总」不随提供方选择切换（恒显示全部提供方的合并数据）**：chips/totals 按 `provider` 过滤，但 `byModel` 恒为全量聚合，且扁平 `{ 模型: 计数 }` 结构无提供方维度、服务端无法过滤
+  - host：`byModel` 升级为按提供方嵌套 `{ 提供方: { 模型: 计数 } }`（新会话折叠与天文件落盘同步新形态）；响应按选中提供方过滤模型汇总，与 chips/totals 语义对齐；选中提供方恒返回嵌套形态（无数据 = 空对象）
+  - 存储迁移（验收回归修复）：天文件格式升为 v2（`DAILY_VERSION = 2`）；v0.6.1 旧扁平天文件按 deps 重折恢复真实提供方归属（会话文件仍是事实源，重写为嵌套形态）；deps 缺失无法重折时才兜底迁入 `unknown` 桶；`.backfilled` 哨兵按版本判定，v1 哨兵触发一次性全量重折
+  - client：按选中提供方渲染模型表；「全部」时同名模型跨提供方合并求和展示；按响应形态自动判别、兼容 v0.6.1 旧服务端（无提供方维度时行为同旧版）
+  - 回归：host 场景 35（跨提供方同名模型、切换提供方模型表跟随）、场景 36a/36b（旧扁平天文件重折恢复归属 / 无 deps 兜底 unknown）、场景 37（v1 哨兵触发一次性全量重折）、场景 38（重置统计：清缓存重建 + 会话原文完好）
+- 重置统计未清空天文件内存缓存（`dayCache`）：重置后立即重查仍以旧天数据做种子，导致「重置对损坏天文件无效」且旧数字残留；现删盘上文件时一并清空（host 场景 39：投毒天文件在重置后从会话原文重建）
+- 重置交互：确认重置后旧数据仍展示到新查询完成（沿用静默刷新策略，与「清空 → 重建」的用户预期相悖）；现确认后立即清空展示进入「查询中」重建态。重置完成提示语此前无清除路径会常驻页面；现查询完成后自动消失
+- 测试：user-agent 断言由硬编码 0.6.0 改为动态读取 `package.json` 版本（v0.6.1 升版时漏改，main 上存量失败）
+
 ## v0.6.1（2026-08-31）
 
 ### 修复

package/lib/client.js

@@ -62,7 +62,7 @@ window.__ModuleLoader__.load({
     if (typeof document !== 'undefined' && document.querySelector('style[data-plugin-css="' + styleId + '"]') === null) {
       var css = [
         // 官方「模型」设置页完整样式（1:1 注入，dsh-client-ui-settings-models 同款）
-        ".zGbnIq_section{max-width:720px;color:var(--dsw-alias-label-primary);flex-direction:column;gap:12px;display:flex}.zGbnIq_title{color:var(--dsw-alias-label-primary);margin:0;font-size:16px;font-weight:500;line-height:24px}.zGbnIq_intro{color:var(--dsw-alias-label-tertiary);margin:0;font-size:14px;line-height:22px}.zGbnIq_notice{color:var(--dsw-alias-state-warn-label);margin:0;font-size:12px;line-height:18px}.zGbnIq_savedNotice{color:var(--dsw-alias-state-success-primary);margin:0;font-size:12px;line-height:18px}.zGbnIq_rows{flex-direction:column;gap:8px;margin:12px 0 0;padding:0;list-style:none;display:flex}.zGbnIq_rowCard{border:1px solid var(--dsw-alias-border-l2);border-radius:12px;flex-direction:column;gap:12px;padding:12px 14px;display:flex}.zGbnIq_rowHead{align-items:center;gap:10px;display:flex}.zGbnIq_rowIdentity{align-items:center;gap:6px;min-width:0;display:inline-flex}.zGbnIq_rowName{color:var(--dsw-alias-label-primary);font-size:14px;font-weight:500;line-height:22px}.zGbnIq_rowTag{border:1px solid var(--dsw-alias-border-l3);color:var(--dsw-alias-label-secondary);border-radius:4px;flex:none;padding:1px 6px;font-size:11px;line-height:16px}.zGbnIq_credentialDot{box-sizing:border-box;border-radius:50%;flex:none;width:8px;height:8px;display:inline-block}.zGbnIq_credentialDotConfigured{background:var(--dsw-alias-state-success-primary)}.zGbnIq_credentialDotMissing{background:var(--dsw-alias-state-error-primary)}.zGbnIq_rowActions{align-items:center;gap:4px;margin-left:auto;display:inline-flex}.zGbnIq_primaryButton,.zGbnIq_secondaryButton,.zGbnIq_addButton{box-sizing:border-box;height:36px;font:inherit;cursor:pointer;border:none;border-radius:18px;justify-content:center;align-items:center;gap:4px;padding:0 14px;font-size:14px;line-height:22px;display:inline-flex}.zGbnIq_primaryButton{background:var(--dsw-alias-button-primary-fill);color:var(--dsw-alias-label-primary-foreground)}.zGbnIq_primaryButton:hover:not(:disabled){background:var(--dsw-alias-button-primary-hover)}.zGbnIq_secondaryButton,.zGbnIq_addButton{border:1px solid var(--dsw-alias-border-l2);color:var(--dsw-alias-label-primary);background:0 0}.zGbnIq_secondaryButton:hover:not(:disabled),.zGbnIq_addButton:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover)}.zGbnIq_secondaryButton:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover-solid)}.zGbnIq_dangerButton{box-sizing:border-box;height:36px;color:var(--dsw-alias-state-error-primary);font:inherit;cursor:pointer;background:0 0;border:none;border-radius:18px;justify-content:center;align-items:center;padding:0 14px;font-size:14px;line-height:22px;display:inline-flex}.zGbnIq_dangerButton:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover-danger)}.zGbnIq_rowActions .zGbnIq_secondaryButton,.zGbnIq_rowActions .zGbnIq_dangerButton{border-radius:14px;height:28px;padding:0 10px;font-size:12px;line-height:18px}.zGbnIq_primaryButton:disabled,.zGbnIq_secondaryButton:disabled,.zGbnIq_dangerButton:disabled,.zGbnIq_addButton:disabled,.zGbnIq_linkButton:disabled,.zGbnIq_addModelButton:disabled{opacity:.4;cursor:default}.zGbnIq_primaryButton:focus-visible,.zGbnIq_secondaryButton:focus-visible,.zGbnIq_dangerButton:focus-visible,.zGbnIq_addButton:focus-visible,.zGbnIq_linkButton:focus-visible,.zGbnIq_addModelButton:focus-visible,.zGbnIq_iconButton:focus-visible,.zGbnIq_customizedSummary:focus-visible{box-shadow:0 0 0 2px var(--dsw-alias-border-l3);outline:none}.zGbnIq_editor{background:var(--dsw-alias-bg-module-platform);border-radius:12px;flex-direction:column;gap:14px;padding:14px 16px;display:flex}.zGbnIq_editorHeader{align-items:baseline;gap:8px;display:flex}.zGbnIq_editorTitle{color:var(--dsw-alias-label-primary);font-size:14px;font-weight:500;line-height:22px}.zGbnIq_editorRoute{color:var(--dsw-alias-label-tertiary);font-size:12px;line-height:18px}.zGbnIq_field{flex-direction:column;gap:6px;display:flex}.zGbnIq_fieldLabel{color:var(--dsw-alias-label-secondary);align-items:center;gap:10px;font-size:12px;font-weight:500;line-height:18px;display:inline-flex}.zGbnIq_linkButton{box-sizing:border-box;height:28px;color:var(--dsw-alias-label-tertiary);font:inherit;cursor:pointer;background:0 0;border:none;border-radius:14px;align-items:center;padding:0 10px;font-size:12px;line-height:18px;display:inline-flex}.zGbnIq_linkButton:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-secondary)}.zGbnIq_advancedHint{color:var(--dsw-alias-label-tertiary);margin:0;font-size:12px;line-height:18px}.zGbnIq_editorActions{justify-content:flex-end;gap:8px;display:flex}.zGbnIq_addBlock{flex-direction:column;gap:12px;display:flex}.zGbnIq_addActions{flex-wrap:wrap;gap:10px;display:flex}.zGbnIq_addButton{border:1px dashed var(--dsw-alias-border-l3);border-radius:12px;flex:1 1 0;gap:6px;min-width:180px;height:44px}.zGbnIq_addCard,.zGbnIq_setupCard{background:var(--dsw-alias-bg-module-platform);border-radius:12px;flex-direction:column;gap:14px;padding:14px 16px;list-style:none;display:flex}.zGbnIq_addCard .zGbnIq_editor,.zGbnIq_setupCard .zGbnIq_editor{background:0 0;padding:0}.zGbnIq_customized{border-top:1px solid var(--dsw-alias-border-l2);padding-top:10px}.zGbnIq_customizedSummary{cursor:pointer;width:fit-content;color:var(--dsw-alias-label-secondary);border-radius:6px;align-items:center;gap:6px;margin-left:-4px;padding:2px 4px;font-size:12px;font-weight:500;line-height:18px;list-style:none;display:flex}.zGbnIq_customizedSummary::-webkit-details-marker{display:none}.zGbnIq_customizedSummary:before{content:\"\";border-bottom:1.5px solid;border-right:1.5px solid;width:5px;height:5px;transition:transform .12s;transform:rotate(-45deg)translate(-1px,-1px)}.zGbnIq_customized[open]>.zGbnIq_customizedSummary:before{transform:rotate(45deg)translate(-1px,-1px)}.zGbnIq_customizedSummary:hover{color:var(--dsw-alias-label-primary)}.zGbnIq_customizedBody{flex-direction:column;gap:12px;padding-top:12px;display:flex}.zGbnIq_modelCatalog{border-top:1px solid var(--dsw-alias-border-l2);flex-direction:column;gap:10px;padding-top:12px;display:flex}.zGbnIq_modelCatalogHeading{flex-direction:column;gap:2px;display:flex}.zGbnIq_modelCatalogTitle{color:var(--dsw-alias-label-secondary);font-size:12px;font-weight:500;line-height:18px}.zGbnIq_modelListHead{justify-content:space-between;align-items:flex-start;gap:12px;display:flex}.zGbnIq_modelEntry{border:1px solid var(--dsw-alias-border-l2);border-radius:8px;padding:6px}.zGbnIq_iconButton{box-sizing:border-box;width:28px;height:28px;color:var(--dsw-alias-label-tertiary);cursor:pointer;background:0 0;border:none;border-radius:6px;justify-content:center;align-items:center;display:inline-flex}.zGbnIq_iconButton:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-primary)}.zGbnIq_iconButton:disabled{cursor:default;opacity:.4}.zGbnIq_iconButtonDanger:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover-danger);color:var(--dsw-alias-state-error-primary)}.zGbnIq_modelAdvanced{grid-template-columns:repeat(auto-fit,minmax(160px,1fr));gap:8px;padding:8px 4px 2px;display:grid}.zGbnIq_modelField{flex-direction:column;gap:4px;display:flex}.zGbnIq_modelFieldLabel{color:var(--dsw-alias-label-tertiary);font-size:12px;line-height:18px}.zGbnIq_modelEmpty{border:1px dashed var(--dsw-alias-border-l3);text-align:center;border-radius:8px;padding:12px}.zGbnIq_addModelButton{box-sizing:border-box;border:1px solid var(--dsw-alias-border-l2);height:28px;color:var(--dsw-alias-label-primary);font:inherit;cursor:pointer;background:0 0;border-radius:14px;align-self:flex-start;align-items:center;gap:4px;padding:0 10px;font-size:12px;line-height:18px;display:inline-flex}.zGbnIq_addModelButton:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover)}.zGbnIq_input{box-sizing:border-box;border:1px solid var(--dsw-alias-border-l2);width:100%;height:32px;font:inherit;background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-primary);border-radius:8px;padding:0 10px;font-size:14px;line-height:22px}select.zGbnIq_input{cursor:pointer;max-width:240px}.zGbnIq_input:focus{border-color:var(--dsw-alias-brand-primary);outline:none}.zGbnIq_input::placeholder{color:var(--dsw-alias-label-dimmed)}.zGbnIq_input:disabled{opacity:.6;cursor:default}.zGbnIq_selectInput{appearance:none;background-image:url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='12' height='12' viewBox='0 0 12 12' fill='none'%3E%3Cpath d='M3 4.5L6 7.5L9 4.5' stroke='%2381858C' stroke-width='1.5' stroke-linecap='round' stroke-linejoin='round'/%3E%3C/svg%3E\");background-position:right 12px center;background-repeat:no-repeat;background-size:12px 12px;padding-right:32px}.zGbnIq_error{color:var(--dsw-alias-state-error-primary);margin:0;font-size:12px;line-height:18px}.zGbnIq_deleteDialog{width:min(480px,100%)}.zGbnIq_deleteConfirm:not(:disabled){border-color:var(--dsw-alias-state-error-primary);color:var(--dsw-alias-state-error-primary)}.zGbnIq_deleteConfirm:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover-danger)}.zGbnIq_hiddenLabel{clip:rect(0 0 0 0);white-space:nowrap;width:1px;height:1px;position:absolute;overflow:hidden}@media (prefers-reduced-motion:reduce){.zGbnIq_customizedSummary:before{transition:none}}.zGbnIq_fetchDialog{--dsh-scrollbar-thumb:var(--dsw-alias-scrollbar-bg-l2);--dsh-scrollbar-thumb-hover:var(--dsw-alias-scrollbar-hover-l2);max-width:520px}.zGbnIq_candidateActions{justify-content:flex-end;margin-bottom:6px;display:flex}.zGbnIq_candidateList{flex-direction:column;gap:2px;max-height:320px;margin:0;padding:0;list-style:none;display:flex;overflow-y:auto}.zGbnIq_candidate{border-radius:6px}.zGbnIq_candidateLabel{cursor:pointer;align-items:center;gap:8px;padding:6px 8px;display:flex}.zGbnIq_candidateId{font-family:var(--ds-font-family-code);overflow-wrap:anywhere;flex:auto;font-size:13px}",
+        ".zGbnIq_section{max-width:720px;color:var(--dsw-alias-label-primary);flex-direction:column;gap:12px;display:flex}.zGbnIq_title{color:var(--dsw-alias-label-primary);margin:0;font-size:16px;font-weight:500;line-height:24px}.zGbnIq_intro{color:var(--dsw-alias-label-tertiary);margin:0;font-size:14px;line-height:22px}.zGbnIq_notice{color:var(--dsw-alias-state-warn-label);margin:0;font-size:12px;line-height:18px}.zGbnIq_savedNotice{color:var(--dsw-alias-state-success-primary);margin:0;font-size:12px;line-height:18px}.zGbnIq_rows{flex-direction:column;gap:8px;margin:12px 0 0;padding:0;list-style:none;display:flex}.zGbnIq_rowCard{border:1px solid var(--dsw-alias-border-l2);border-radius:12px;flex-direction:column;gap:12px;padding:12px 14px;display:flex}.zGbnIq_rowHead{align-items:center;gap:10px;display:flex}.zGbnIq_rowIdentity{align-items:center;gap:6px;min-width:0;display:inline-flex}.zGbnIq_rowName{color:var(--dsw-alias-label-primary);font-size:14px;font-weight:500;line-height:22px}.zGbnIq_rowTag{border:1px solid var(--dsw-alias-border-l3);color:var(--dsw-alias-label-secondary);border-radius:4px;flex:none;padding:1px 6px;font-size:11px;line-height:16px}.zGbnIq_credentialDot{box-sizing:border-box;border-radius:50%;flex:none;width:8px;height:8px;display:inline-block}.zGbnIq_credentialDotConfigured{background:var(--dsw-alias-state-success-primary)}.zGbnIq_credentialDotMissing{background:var(--dsw-alias-state-error-primary)}.zGbnIq_rowActions{align-items:center;gap:4px;margin-left:auto;display:inline-flex}.zGbnIq_primaryButton,.zGbnIq_secondaryButton,.zGbnIq_addButton{box-sizing:border-box;height:36px;font:inherit;cursor:pointer;border:none;border-radius:18px;justify-content:center;align-items:center;gap:4px;padding:0 14px;font-size:14px;line-height:22px;display:inline-flex}.zGbnIq_primaryButton{background:var(--dsw-alias-button-primary-fill);color:var(--dsw-alias-label-primary-foreground)}.zGbnIq_primaryButton:hover:not(:disabled){background:var(--dsw-alias-button-primary-hover)}.zGbnIq_secondaryButton,.zGbnIq_addButton{border:1px solid var(--dsw-alias-border-l2);color:var(--dsw-alias-label-primary);background:0 0}.zGbnIq_secondaryButton:hover:not(:disabled),.zGbnIq_addButton:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover)}.zGbnIq_secondaryButton:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover-solid)}.zGbnIq_dangerButton{box-sizing:border-box;height:36px;color:var(--dsw-alias-state-error-primary);font:inherit;cursor:pointer;background:0 0;border:none;border-radius:18px;justify-content:center;align-items:center;padding:0 14px;font-size:14px;line-height:22px;display:inline-flex}.zGbnIq_dangerButton:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover-danger)}.zGbnIq_rowActions .zGbnIq_secondaryButton,.zGbnIq_rowActions .zGbnIq_dangerButton{border-radius:14px;height:28px;padding:0 10px;font-size:12px;line-height:18px}.zGbnIq_primaryButton:disabled,.zGbnIq_secondaryButton:disabled,.zGbnIq_dangerButton:disabled,.zGbnIq_addButton:disabled,.zGbnIq_linkButton:disabled,.zGbnIq_addModelButton:disabled{opacity:.4;cursor:default}.zGbnIq_primaryButton:focus-visible,.zGbnIq_secondaryButton:focus-visible,.zGbnIq_dangerButton:focus-visible,.zGbnIq_addButton:focus-visible,.zGbnIq_linkButton:focus-visible,.zGbnIq_addModelButton:focus-visible,.zGbnIq_iconButton:focus-visible,.zGbnIq_customizedSummary:focus-visible{box-shadow:0 0 0 2px var(--dsw-alias-border-l3);outline:none}.zGbnIq_editor{background:var(--dsw-alias-bg-module-platform);border-radius:12px;flex-direction:column;gap:14px;padding:14px 16px;display:flex}.zGbnIq_editorHeader{align-items:baseline;gap:8px;display:flex}.zGbnIq_editorTitle{color:var(--dsw-alias-label-primary);font-size:14px;font-weight:500;line-height:22px}.zGbnIq_editorRoute{color:var(--dsw-alias-label-tertiary);font-size:12px;line-height:18px}.zGbnIq_field{flex-direction:column;gap:6px;display:flex}.zGbnIq_fieldLabel{color:var(--dsw-alias-label-secondary);align-items:center;gap:10px;font-size:12px;font-weight:500;line-height:18px;display:inline-flex}.zGbnIq_linkButton{box-sizing:border-box;height:28px;color:var(--dsw-alias-label-tertiary);font:inherit;cursor:pointer;background:0 0;border:none;border-radius:14px;align-items:center;padding:0 10px;font-size:12px;line-height:18px;display:inline-flex}.zGbnIq_linkButton:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-secondary)}.zGbnIq_dangerButton{box-sizing:border-box;height:28px;color:var(--dsw-alias-state-warn-label);font:inherit;cursor:pointer;background:0 0;border:1px solid transparent;border-radius:14px;align-items:center;padding:0 10px;font-size:12px;line-height:18px;display:inline-flex;transition:border-color .15s,color .15s,background .15s}.zGbnIq_dangerButton:hover:not(:disabled){color:var(--dsw-alias-state-danger-primary,var(--dsw-alias-state-warn-label))}.zGbnIq_dangerButton:focus-visible{box-shadow:0 0 0 2px var(--dsw-alias-border-l3);outline:none}.zGbnIq_dangerButton:disabled{opacity:.6;cursor:default}.zGbnIq_dangerButton[data-arm=true]{color:var(--dsw-alias-state-danger-primary,#e5484d);border-color:var(--dsw-alias-state-danger-primary,#e5484d);background:color-mix(in srgb,var(--dsw-alias-state-danger-primary,#e5484d) 8%,transparent)}.zGbnIq_advancedHint{color:var(--dsw-alias-label-tertiary);margin:0;font-size:12px;line-height:18px}.zGbnIq_editorActions{justify-content:flex-end;gap:8px;display:flex}.zGbnIq_addBlock{flex-direction:column;gap:12px;display:flex}.zGbnIq_addActions{flex-wrap:wrap;gap:10px;display:flex}.zGbnIq_addButton{border:1px dashed var(--dsw-alias-border-l3);border-radius:12px;flex:1 1 0;gap:6px;min-width:180px;height:44px}.zGbnIq_addCard,.zGbnIq_setupCard{background:var(--dsw-alias-bg-module-platform);border-radius:12px;flex-direction:column;gap:14px;padding:14px 16px;list-style:none;display:flex}.zGbnIq_addCard .zGbnIq_editor,.zGbnIq_setupCard .zGbnIq_editor{background:0 0;padding:0}.zGbnIq_customized{border-top:1px solid var(--dsw-alias-border-l2);padding-top:10px}.zGbnIq_customizedSummary{cursor:pointer;width:fit-content;color:var(--dsw-alias-label-secondary);border-radius:6px;align-items:center;gap:6px;margin-left:-4px;padding:2px 4px;font-size:12px;font-weight:500;line-height:18px;list-style:none;display:flex}.zGbnIq_customizedSummary::-webkit-details-marker{display:none}.zGbnIq_customizedSummary:before{content:\"\";border-bottom:1.5px solid;border-right:1.5px solid;width:5px;height:5px;transition:transform .12s;transform:rotate(-45deg)translate(-1px,-1px)}.zGbnIq_customized[open]>.zGbnIq_customizedSummary:before{transform:rotate(45deg)translate(-1px,-1px)}.zGbnIq_customizedSummary:hover{color:var(--dsw-alias-label-primary)}.zGbnIq_customizedBody{flex-direction:column;gap:12px;padding-top:12px;display:flex}.zGbnIq_modelCatalog{border-top:1px solid var(--dsw-alias-border-l2);flex-direction:column;gap:10px;padding-top:12px;display:flex}.zGbnIq_modelCatalogHeading{flex-direction:column;gap:2px;display:flex}.zGbnIq_modelCatalogTitle{color:var(--dsw-alias-label-secondary);font-size:12px;font-weight:500;line-height:18px}.zGbnIq_modelListHead{justify-content:space-between;align-items:flex-start;gap:12px;display:flex}.zGbnIq_modelEntry{border:1px solid var(--dsw-alias-border-l2);border-radius:8px;padding:6px}.zGbnIq_iconButton{box-sizing:border-box;width:28px;height:28px;color:var(--dsw-alias-label-tertiary);cursor:pointer;background:0 0;border:none;border-radius:6px;justify-content:center;align-items:center;display:inline-flex}.zGbnIq_iconButton:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-primary)}.zGbnIq_iconButton:disabled{cursor:default;opacity:.4}.zGbnIq_iconButtonDanger:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover-danger);color:var(--dsw-alias-state-error-primary)}.zGbnIq_modelAdvanced{grid-template-columns:repeat(auto-fit,minmax(160px,1fr));gap:8px;padding:8px 4px 2px;display:grid}.zGbnIq_modelField{flex-direction:column;gap:4px;display:flex}.zGbnIq_modelFieldLabel{color:var(--dsw-alias-label-tertiary);font-size:12px;line-height:18px}.zGbnIq_modelEmpty{border:1px dashed var(--dsw-alias-border-l3);text-align:center;border-radius:8px;padding:12px}.zGbnIq_addModelButton{box-sizing:border-box;border:1px solid var(--dsw-alias-border-l2);height:28px;color:var(--dsw-alias-label-primary);font:inherit;cursor:pointer;background:0 0;border-radius:14px;align-self:flex-start;align-items:center;gap:4px;padding:0 10px;font-size:12px;line-height:18px;display:inline-flex}.zGbnIq_addModelButton:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover)}.zGbnIq_input{box-sizing:border-box;border:1px solid var(--dsw-alias-border-l2);width:100%;height:32px;font:inherit;background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-primary);border-radius:8px;padding:0 10px;font-size:14px;line-height:22px}select.zGbnIq_input{cursor:pointer;max-width:240px}.zGbnIq_input:focus{border-color:var(--dsw-alias-brand-primary);outline:none}.zGbnIq_input::placeholder{color:var(--dsw-alias-label-dimmed)}.zGbnIq_input:disabled{opacity:.6;cursor:default}.zGbnIq_selectInput{appearance:none;background-image:url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='12' height='12' viewBox='0 0 12 12' fill='none'%3E%3Cpath d='M3 4.5L6 7.5L9 4.5' stroke='%2381858C' stroke-width='1.5' stroke-linecap='round' stroke-linejoin='round'/%3E%3C/svg%3E\");background-position:right 12px center;background-repeat:no-repeat;background-size:12px 12px;padding-right:32px}.zGbnIq_error{color:var(--dsw-alias-state-error-primary);margin:0;font-size:12px;line-height:18px}.zGbnIq_deleteDialog{width:min(480px,100%)}.zGbnIq_deleteConfirm:not(:disabled){border-color:var(--dsw-alias-state-error-primary);color:var(--dsw-alias-state-error-primary)}.zGbnIq_deleteConfirm:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover-danger)}.zGbnIq_hiddenLabel{clip:rect(0 0 0 0);white-space:nowrap;width:1px;height:1px;position:absolute;overflow:hidden}@media (prefers-reduced-motion:reduce){.zGbnIq_customizedSummary:before{transition:none}}.zGbnIq_fetchDialog{--dsh-scrollbar-thumb:var(--dsw-alias-scrollbar-bg-l2);--dsh-scrollbar-thumb-hover:var(--dsw-alias-scrollbar-hover-l2);max-width:520px}.zGbnIq_candidateActions{justify-content:flex-end;margin-bottom:6px;display:flex}.zGbnIq_candidateList{flex-direction:column;gap:2px;max-height:320px;margin:0;padding:0;list-style:none;display:flex;overflow-y:auto}.zGbnIq_candidate{border-radius:6px}.zGbnIq_candidateLabel{cursor:pointer;align-items:center;gap:8px;padding:6px 8px;display:flex}.zGbnIq_candidateId{font-family:var(--ds-font-family-code);overflow-wrap:anywhere;flex:auto;font-size:13px}",
         // 官方「插件」设置页二级菜单样式（1:1 注入，dsh-client-ui-settings-plugins PluginsSettingsSection 同款）
         ".pbvGtq_section{max-width:760px;color:var(--dsw-alias-label-primary);flex-direction:column;gap:12px;display:flex}.pbvGtq_heading{margin:0;font-size:18px;font-weight:600}.pbvGtq_intro{color:var(--dsw-alias-label-tertiary);margin:0;font-size:13px}.pbvGtq_tabs{border-bottom:1px solid var(--dsw-alias-border-l2);align-items:flex-end;gap:22px;margin-top:2px;display:flex}.pbvGtq_tab{color:var(--dsw-alias-label-tertiary);font:inherit;cursor:pointer;background:0 0;border:0;padding:7px 1px 9px;font-size:13px;line-height:20px;position:relative}.pbvGtq_tab:hover,.pbvGtq_tab[data-active=true]{color:var(--dsw-alias-label-primary)}.pbvGtq_tab[data-active=true]:after,.pbvGtq_tab:focus-visible:after{background:var(--dsw-alias-label-primary);content:\"\";border-radius:2px 2px 0 0;height:2px;position:absolute;bottom:-1px;left:0;right:0}.pbvGtq_tab:focus-visible{outline:2px solid var(--dsw-alias-state-business-primary);outline-offset:2px;color:var(--dsw-alias-label-primary);border-radius:2px}.pbvGtq_panel{min-width:0;padding-top:2px}",
         // 用量统计页样式
@@ -406,10 +406,18 @@ window.__ModuleLoader__.load({
         var warn = data.isValid === false && data.invalidMessage
           ? React.createElement('div', { className: 'dsh-pu-error' }, data.invalidMessage)
           : null;
-        // Command Code 混合卡：主数字 = 月已用百分比，副行 = 已用/总额 + 剩余额度
+        // Command Code 混合卡：主数字 = 月剩余百分比（3 位小数向下取整），副行 = 已用/总额 + 剩余额度
         var cc = null;
         if (isCommandCode) {
-          var usedPct = data.monthly && data.monthly.usedPct;
+          var monthlyInfo = data.monthly || null;
+          // 新服务端直接给 remainingPct；旧服务端只有 usedPct → 按 100−usedPct 兜底（与 host 公式数学等价）
+          var remainPct = monthlyInfo
+            ? (monthlyInfo.remainingPct !== undefined && monthlyInfo.remainingPct !== null
+              ? monthlyInfo.remainingPct
+              : (monthlyInfo.usedPct === undefined || monthlyInfo.usedPct === null
+                ? null
+                : Math.floor(Math.max(0, Math.min(100, 100 - monthlyInfo.usedPct)) * 1000) / 1000))
+            : null;
           var usedStr = data.used === null ? '--' : Number(data.used).toFixed(2);
           var quotaStr = data.totalQuota === null ? '--' : Number(data.totalQuota).toFixed(2);
           var remainStr = data.remaining === null ? '--' : Number(data.remaining).toFixed(2);
@@ -421,8 +429,8 @@ window.__ModuleLoader__.load({
         var extra = null;
         body = React.createElement('div', null,
           React.createElement('div', { className: 'dsh-pu-remain' },
-            React.createElement('span', { className: 'dsh-pu-remain-big' }, isCommandCode ? (usedPct === null ? '--' : Math.round(usedPct) + '%') : main),
-            React.createElement('span', { className: 'dsh-pu-remain-label' }, isCommandCode ? ' ' + zh.used + '（' + zh.monthly + '）' : ' ' + mainLabel)),
+            React.createElement('span', { className: 'dsh-pu-remain-big' }, isCommandCode ? (remainPct === null ? '--' : remainPct.toFixed(3) + '%') : main),
+            React.createElement('span', { className: 'dsh-pu-remain-label' }, isCommandCode ? ' ' + zh.remaining + '（' + zh.monthly + '）' : ' ' + mainLabel)),
           warn,
           cc,
           winRows,
@@ -542,6 +550,9 @@ window.__ModuleLoader__.load({
       var [provider, setProvider] = useState(''); // '' = 全部
       var [range, setRange] = useState('1'); // 默认近 1 天；'0'=全部 / '1'=近1天 / '7'=近7天 / '30'=近30天
       var dataRef = useRef(null); // 轮询静默刷新判定用（避免闭包陈旧）
+      var [resetState, setResetState] = useState('idle'); // 重置统计：idle → arm（待确认）→ busy → idle
+      var [resetMsg, setResetMsg] = useState(null);
+      var resetTimerRef = useRef(null); // 两段式确认的 4s 自动解除
       function setDataBoth(v) { dataRef.current = v; setData(v); }
       function load(force) {
         // 自然日语义：近 1 天 = 今天 00:00 起；近 7/30 天 = 今天 + 前 N-1 个完整自然日（0 点边界）
@@ -560,7 +571,20 @@ window.__ModuleLoader__.load({
             else { setErr('无法读取本地用量统计'); }
           })
           .catch(function () { setErr('读取失败'); })
-          .finally(function () { setLoading(false); });
+          .finally(function () { setLoading(false); setResetMsg(null); });
+      }
+      function doReset() {
+        if (resetState === 'busy') return;
+        setResetState('busy'); setResetMsg(null);
+        setDataBoth(null); setLoading(true); // 重置语义：立即清空旧数据展示，进入「查询中」重建态
+        fetch('/api/provider-usage/reset-local-stats', { method: 'POST', headers: { accept: 'application/json' } })
+          .then(function (r) { return r.json().catch(function () { return null; }); })
+          .then(function (j) {
+            if (j && j.ok) setResetMsg('已重置（清除 ' + (j.removed || 0) + ' 个缓存文件），正在重新统计…');
+            else setResetMsg('重置失败' + (j && j.error && j.error.message ? '：' + j.error.message : ''));
+          })
+          .catch(function () { setResetMsg('重置失败：网络错误'); })
+          .finally(function () { setResetState('idle'); load(true); });
       }
       useEffect(function () { if (active) load(false); }, [active, provider, range]);
       useEffect(function () {
@@ -574,7 +598,42 @@ window.__ModuleLoader__.load({
       var provs = data && Array.isArray(data.providers) ? data.providers.slice() : [];
       provs.sort();
       var byModel = (data && data.byModel && typeof data.byModel === 'object') ? data.byModel : {};
-      var modelNames = Object.keys(byModel).sort();
+      // 形态判别：v0.7.0 = 嵌套 { 提供方: { 模型: 计数 } }（顶层值无 requests 数字）；
+      // v0.6.1 旧服务端 = 扁平 { 模型: 计数 }（顶层值直接是计数条目）。
+      function byModelShape(m) {
+        for (var k in m) {
+          if (!Object.prototype.hasOwnProperty.call(m, k)) continue;
+          var v = m[k];
+          if (v && typeof v === 'object') return (typeof v.requests === 'number') ? 'flat' : 'nested';
+        }
+        return 'flat'; // 空对象：无模型行，形态无影响
+      }
+      var modelShape = byModelShape(byModel);
+      var modelData = {}; // 模型名 -> 计数条目（已按当前提供方选择过滤/合并）
+      if (modelShape === 'nested') {
+        if (provider === '') {
+          // 全部：同名模型跨提供方合并求和（unknown 桶=旧归属缺失事件，一并计入）
+          var merged = {};
+          for (var pk in byModel) {
+            if (!Object.prototype.hasOwnProperty.call(byModel, pk)) continue;
+            var bucket = byModel[pk];
+            if (!bucket || typeof bucket !== 'object' || typeof bucket.requests === 'number') continue;
+            for (var mk in bucket) {
+              if (!Object.prototype.hasOwnProperty.call(bucket, mk)) continue;
+              var e = bucket[mk], g = merged[mk];
+              if (!g) g = merged[mk] = { requests: 0, inputTokens: 0, outputTokens: 0, cacheReadTokens: 0 };
+              g.requests += e.requests || 0; g.inputTokens += e.inputTokens || 0;
+              g.outputTokens += e.outputTokens || 0; g.cacheReadTokens += e.cacheReadTokens || 0;
+            }
+          }
+          modelData = merged;
+        } else {
+          modelData = (byModel[provider] && typeof byModel[provider] === 'object' && typeof byModel[provider].requests !== 'number') ? byModel[provider] : {};
+        }
+      } else {
+        modelData = byModel; // v0.6.1 旧服务端：无提供方维度，行为同旧版
+      }
+      var modelNames = Object.keys(modelData).sort();
       // ── 按模型汇总表 ──
       function ModelNameCell(props) {
         var name = props.name;
@@ -637,25 +696,37 @@ window.__ModuleLoader__.load({
       }
 
       var modelRows = modelNames.map(function (mn) {
-        var md = byModel[mn];
+        var md = modelData[mn] || { requests: 0, inputTokens: 0, outputTokens: 0, cacheReadTokens: 0 };
         var hit = (md.inputTokens + md.cacheReadTokens) > 0 ? md.cacheReadTokens / (md.inputTokens + md.cacheReadTokens) : 0;
         return { name: mn, requests: md.requests, inputTokens: md.inputTokens, outputTokens: md.outputTokens, cacheReadTokens: md.cacheReadTokens, hitRate: fmtPct(hit) };
       });
 
       return React.createElement("div", null,
         React.createElement("div", null,
-          React.createElement("p", { className: "zGbnIq_intro", style: { margin: "0 0 8px" } }, "统计 DSH 会话日志中的 Token 用量（本机解析；历史按天存储，只算当天）。" + (data && data.days ? " 已聚合 " + data.days + " 天数据。" : "")),
+          React.createElement("p", { className: "zGbnIq_intro", style: { margin: "0 0 8px" } }, "统计 DSH 会话日志中的 Token 用量（本机解析；历史按天存储，只算当天；下方汇总跟随所选提供方）。" + (data && data.days ? " 已聚合 " + data.days + " 天数据。" : "")),
           React.createElement("div", { className: "zGbnIq_rowHead", style: { marginBottom: "4px" } },
             React.createElement("select", { className: "zGbnIq_input zGbnIq_selectInput", style: { width: "auto" }, value: range, onChange: function (e) { setRange(e.target.value); } },
               React.createElement("option", { value: "1" }, "近 1 天"),
               React.createElement("option", { value: "7" }, "近 7 天"),
               React.createElement("option", { value: "30" }, "近 30 天"),
               React.createElement("option", { value: "0" }, "全部时间")),
-            React.createElement("button", { type: "button", className: "zGbnIq_linkButton", onClick: function () { load(true); } }, "刷新"))),
+            React.createElement("button", { type: "button", className: "zGbnIq_linkButton", onClick: function () { load(true); } }, "刷新"),
+            React.createElement("button", {
+              type: "button",
+              className: "zGbnIq_dangerButton",
+              "data-arm": resetState === 'arm' ? "true" : undefined,
+              disabled: resetState === 'busy',
+              "aria-label": resetState === 'arm' ? "再次点击确认重置本地统计" : "重置本地统计（清除按天缓存并重新统计，不影响会话记录）",
+              onClick: function () {
+                if (resetState === 'arm') { doReset(); }
+                else { setResetState('arm'); setResetMsg(null); window.clearTimeout(resetTimerRef.current); resetTimerRef.current = window.setTimeout(function () { setResetState('idle'); }, 4000); }
+              },
+            }, resetState === 'arm' ? "确认重置？" : resetState === 'busy' ? "重置中…" : "重置统计"))),
         loading ? React.createElement("div", null,
           React.createElement("div", { className: "zGbnIq_progress" }, React.createElement("i", null)),
           React.createElement("p", { className: "zGbnIq_advancedHint" }, "查询中…")) : null,
         err ? React.createElement("p", { className: "zGbnIq_error" }, err) : null,
+        resetMsg ? React.createElement("p", { className: "zGbnIq_advancedHint" }, resetMsg) : null,
         total ? React.createElement("div", null,
           React.createElement("div", { className: "zGbnIq_chips" }, chips),
           stats,
@@ -663,7 +734,8 @@ window.__ModuleLoader__.load({
             React.createElement("div", { className: "zGbnIq_modelCatalogHeading" },
               React.createElement("span", { className: "zGbnIq_modelCatalogTitle" }, "按模型汇总")),
             React.createElement(ModelSummaryTable, { rows: modelRows }))) : null,
-        !total && !loading && !err && data ? React.createElement("div", { className: "zGbnIq_modelEmpty" }, "没有匹配的 DSH 会话。") : null);
+        !total && !loading && !err && data ? React.createElement("div", { className: "zGbnIq_modelEmpty" }, "没有匹配的 DSH 会话。") : null,
+        total && modelRows.length === 0 ? React.createElement("div", { className: "zGbnIq_modelEmpty" }, total.requests > 0 ? "旧版本统计的用量暂无模型归属明细。" : "该时间范围内没有此提供方的模型用量。") : null);
     }
     // 提供方状态归一：dot 颜色/标签/可点击性/展开内容都从这里出,6 个 if-else 收敛为 1 个表
     // level: 'ok' 绿 / 'err' 红 / 'loading' 脉冲灰 / 'unknown' 静默灰

package/lib/daily-stats.js

@@ -8,7 +8,9 @@ import { promises as fs } from 'node:fs'
 import { init as zstdInit, decompress as zstdWasmDec } from '@bokuweb/zstd-wasm'
 import { decompress as zstdFzDec } from 'fzstd'
 
-export const DAILY_VERSION = 1
+// v2（v0.7.0）：byModel 升级为按提供方嵌套 { 提供方: { 模型: 计数 } }；v1 为扁平 { 模型: 计数 }。
+// .backfilled 哨兵按版本判定：v1 哨兵会触发一次性全量重折（从会话文件恢复提供方归属）。
+export const DAILY_VERSION = 2
 
 /** 本地时区日期键：YYYY-MM-DD。 */
 export function dayKey(ms) {
@@ -152,7 +154,8 @@ export function parseEvents(text) {
 /** 把事件流中落在 [dayStart, dayEnd) 的 assistant/message 记账折叠成按天 totals。
  * 归属：message.source.provider/model，缺失回退 request/header；targetProvider 为空 = 全部 provider；
  * 事件 time 缺失按当天计入（宽松）。返回 { byProvider, byModel }，键值含
- * { requests, inputTokens, outputTokens, cacheReadTokens }。 */
+ * { requests, inputTokens, outputTokens, cacheReadTokens }；
+ * byModel 为按提供方嵌套：{ <provider>: { <model>: e } }（v0.7.0 起，支持按提供方过滤模型汇总）。 */
 /** 内部：把一条记账累加到 byProvider/byModel 桶。 */
 function bump(map, key, usage) {
   let e = map[key]
@@ -203,13 +206,16 @@ export function foldEventsByDay(events, dayStart, dayEnd, targetProvider) {
     const guess = stepGuess(data, headerProvider, headerModel)
     if (target !== null && guess.stepProvider !== target) continue
     bump(byProvider, guess.stepProvider || 'unknown', usage)
-    bump(byModel, guess.stepModel || 'unknown', usage)
+    const provKey = guess.stepProvider || 'unknown'
+    if (!byModel[provKey]) byModel[provKey] = {}
+    bump(byModel[provKey], guess.stepModel || 'unknown', usage)
   }
   return { byProvider, byModel }
 }
 
 /** 把事件流按天分组折叠（首次全量回填用）：返回 { <YYYY-MM-DD>: { byProvider, byModel },
- * unknown: {...} }——time 缺失的事件归 unknown 桶。targetProvider 为空 = 全部 provider。 */
+ * unknown: {...} }——time 缺失的事件归 unknown 桶。targetProvider 为空 = 全部 provider。
+ * byModel 按提供方嵌套（v0.7.0 起，见 foldEventsByDay）。 */
 export function foldEventsByDays(events, targetProvider) {
   const target = (typeof targetProvider === 'string' && targetProvider.trim() !== '') ? targetProvider.trim() : null
   const days = {}
@@ -236,14 +242,29 @@ export function foldEventsByDays(events, targetProvider) {
     let bucket = days[key]
     if (!bucket) { bucket = { byProvider: {}, byModel: {} }; days[key] = bucket }
     bump(bucket.byProvider, guess.stepProvider || 'unknown', usage)
-    bump(bucket.byModel, guess.stepModel || 'unknown', usage)
+    const provKey = guess.stepProvider || 'unknown'
+    if (!bucket.byModel[provKey]) bucket.byModel[provKey] = {}
+    bump(bucket.byModel[provKey], guess.stepModel || 'unknown', usage)
   }
   return days
 }
 
-/** 把 src 的 byProvider/byModel 累加进 dst（同键相加）。 */
+/** 判断 byModel 是否为 v1 扁平形态（顶层直接是计数条目，无提供方层）。 */
+export function isFlatByModel(map) {
+  for (const k of Object.keys(map || {})) {
+    const v = map[k]
+    if (v && typeof v === 'object' && typeof v.requests === 'number') return true
+  }
+  return false
+}
+
+/** 把 src 的 byProvider/byModel 累加进 dst（同键相加）。
+ * byModel 兼容 v0.6.1 扁平形态（{ <model>: e }，双向）：src 顶层条目并入 unknown 提供方桶，
+ * dst 顶层条目迁移到 unknown 桶后再合并（旧天文件被今天的重算复写时保持形态一致）。 */
 export function mergeTotals(dst, src) {
   if (!src) return
+  if (!dst.byProvider || typeof dst.byProvider !== 'object') dst.byProvider = {}
+  if (!dst.byModel || typeof dst.byModel !== 'object') dst.byModel = {}
   function mergeInto(map, srcMap) {
     for (const k of Object.keys(srcMap || {})) {
       const s = srcMap[k], t = map[k] || (map[k] = { requests: 0, inputTokens: 0, outputTokens: 0, cacheReadTokens: 0 })
@@ -254,7 +275,21 @@ export function mergeTotals(dst, src) {
     }
   }
   mergeInto(dst.byProvider, src.byProvider)
-  mergeInto(dst.byModel, src.byModel)
+  if (isFlatByModel(dst.byModel)) {
+    const legacy = dst.byModel
+    dst.byModel = {}
+    mergeInto(dst.byModel.unknown || (dst.byModel.unknown = {}), legacy)
+  }
+  for (const prov of Object.keys(src.byModel || {})) {
+    const bucket = src.byModel[prov]
+    if (!bucket || typeof bucket !== 'object') continue
+    if (typeof bucket.requests === 'number') { mergeInto(dst.byModel.unknown || (dst.byModel.unknown = {}), { [prov]: bucket }); continue }
+    if (!dst.byModel[prov] || typeof dst.byModel[prov] !== 'object' || typeof dst.byModel[prov].requests === 'number') {
+      const legacy = dst.byModel[prov] && typeof dst.byModel[prov] === 'object' ? dst.byModel[prov] : null
+      dst.byModel[prov] = legacy ? { unknown: legacy } : {}
+    }
+    mergeInto(dst.byModel[prov], bucket)
+  }
 }
 
 /** 读某天文件；损坏/缺失返回 null。 */
@@ -289,15 +324,38 @@ export async function saveCursors(dir, cursors) {
   await fs.rename(tmp, join(dir, 'cursors.json'))
 }
 
-/** 回填哨兵：标记"全量历史回填已完成"（防止无历史数据时每次请求都重扫）。 */
+/** 回填哨兵：标记"全量历史回填已完成且天文件为当前格式"（防止每次请求都重扫）。
+ * v0.7.0 起（DAILY_VERSION=2）按哨兵内容版本判定：旧版写的 version 1 哨兵视为未完成，
+ * 触发一次性全量重折，把 v1 扁平 byModel 天文件重算成嵌套形态（会话文件仍是事实源）。 */
 export async function hasBackfilled(dir) {
-  try { await fs.access(join(dir, '.backfilled')); return true } catch { return false }
+  try {
+    const raw = await fs.readFile(join(dir, '.backfilled'), 'utf8')
+    const j = JSON.parse(raw)
+    return !!(j && typeof j === 'object' && Number(j.version) >= DAILY_VERSION)
+  } catch { return false }
 }
 export async function writeBackfilled(dir) {
   await fs.mkdir(dir, { recursive: true, mode: 0o700 })
   await fs.writeFile(join(dir, '.backfilled'), JSON.stringify({ version: DAILY_VERSION, at: Date.now() }) + '\n', { mode: 0o600 })
 }
 
+/** 重置本地统计：删除全部派生数据（天文件/游标/回填哨兵/格式标记），不触碰会话原文。
+ * 下一次 local-usage 查询会自动从会话文件重新全量回填。返回删除的天文件数。 */
+export async function resetDailyStats(dir) {
+  let removed = 0
+  let names
+  try { names = await fs.readdir(dir) } catch { return 0 }
+  for (const n of names) {
+    if (n === 'cursors.json' || n === '.backfilled' || n === '.format' || /^\.\d{4}-\d{2}-\d{2}\.tmp-/.test(n)) {
+      try { await fs.rm(join(dir, n)); removed++; continue } catch { /* ignore */ }
+    }
+    if (/^\d{4}-\d{2}-\d{2}\.json$/.test(n)) {
+      try { await fs.rm(join(dir, n)); removed++ } catch { /* ignore */ }
+    }
+  }
+  return removed
+}
+
 /** 校验 deps（path -> mtime）：返回变化的与缺失的路径。 */
 export async function validateDeps(deps) {
   const changed = []

package/lib/index.js

@@ -4,7 +4,7 @@
 //   balance-json（余额型）  ：DeepSeek     {{baseUrl}}/user/balance    → balance_infos[]
 // 凭证链 per provider：DSH 设置 provider.apiKeyEnv → 凭证服务 → 环境变量。
 // 路由：/api/provider-usage/opencode-go（兼容旧版）、/api/provider-usage/query?provider=<id>、
-//       /api/provider-usage/templates / credentials / dsh-providers / credential-refs（仅回环）。
+//       /api/provider-usage/templates / credentials / dsh-providers / credential-refs / reset-local-stats（仅回环）。
 // 本地 Token 统计（v0.5.0）：/api/provider-usage/local-usage（累计+按模型汇总，按天物化存储），
 //       数据源 = 自读 $DSH_HOME/sessions 会话文件（fzstd 解压，assistant/message 事件 data.usage），只读、不联网；
 //       存储 = $DSH_HOME/provider-usage/daily-stats/YYYY-MM-DD.json：历史天封存（deps mtime 校验），只算今天。
@@ -20,8 +20,8 @@ export const name = 'provider-usage'
 
 /** 插件版本单一来源：package.json（UA 标识用；bundle 内嵌等读不到时回退字面量）。 */
 const PLUGIN_VERSION = (() => {
-  try { return JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8')).version || '0.6.0' }
-  catch { return '0.6.0' }
+  try { return JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8')).version || '0.7.0' }
+  catch { return '0.7.0' }
 })()
 const USER_AGENT = 'dsh-provider-usage/' + PLUGIN_VERSION
 
@@ -298,6 +298,15 @@ function commandcodeMonthlyUsedPct(totalQuota, monthlyCredits) {
   return Math.max(0, Math.min(100, ((totalQuota - remaining) / totalQuota) * 100))
 }
 
+/** 月剩余百分比：钳制 [0,100] 后保留 3 位小数向下取整（如 89.918878… → 89.918）；无法推算返回 null。 */
+function commandcodeMonthlyRemainingPct(totalQuota, monthlyCredits) {
+  if (totalQuota === null || totalQuota === undefined || !(totalQuota > 0)) return null
+  const remaining = Number(monthlyCredits)
+  if (!Number.isFinite(remaining)) return null
+  const pct = Math.max(0, Math.min(100, (remaining / totalQuota) * 100))
+  return Math.floor(pct * 1000) / 1000
+}
+
 /** 把 credits + subscriptions 两个端点的响应换算成混合模型（订阅使用量 + 剩余额度）。 */
 function parseCommandCodeCredits(creditsBody, subBody) {
   let credits = creditsBody
@@ -334,6 +343,7 @@ function parseCommandCodeCredits(creditsBody, subBody) {
     ? subData.currentPeriodEnd : null
 
   const monthlyUsedPct = commandcodeMonthlyUsedPct(totalQuota, monthlyCredits)
+  const monthlyRemainingPct = commandcodeMonthlyRemainingPct(totalQuota, monthlyCredits)
   const monthlyUsed = (monthlyUsedPct === null || totalQuota === null) ? null
     : Math.max(0, totalQuota - monthlyCredits)
 
@@ -367,7 +377,7 @@ function parseCommandCodeCredits(creditsBody, subBody) {
       fiveHour: windowOf(fiveHourUsed, fiveHourCap, fiveHourResetAt),
       weekly: windowOf(weeklyUsed, weeklyCap, weeklyResetAt),
     },
-    monthly: { usedPct: monthlyUsedPct, used: monthlyUsed, totalQuota, remaining: monthlyCredits, resetsAt: nextResetAt },
+    monthly: { usedPct: monthlyUsedPct, remainingPct: monthlyRemainingPct, used: monthlyUsed, totalQuota, remaining: monthlyCredits, resetsAt: nextResetAt },
     cards: null,
     isValid: true,
     invalidMessage: null,
@@ -696,7 +706,7 @@ export function apply(ctx, rawConfig) {
     if (state.lastGood) {
       return { ...state.lastGood.payload, cached: true, stale: true, ok: false, error: { type, message, httpStatus: null } }
     }
-    return { ok: false, error: { type, message, httpStatus: null }, provider: null, detected: true, days: 0, scanned: 0, totals: null, byModel: null, providers: [], fetchedAt: null, cached: false, stale: false, snapshots: (state.snapshots || []).slice(), parseVersion: LOCAL_PARSE_VERSION }
+    return { ok: false, error: { type, message, httpStatus: null }, provider: null, detected: true, days: 0, scanned: 0, totals: null, byModel: { unknown: {} }, providers: [], fetchedAt: null, cached: false, stale: false, snapshots: (state.snapshots || []).slice(), parseVersion: LOCAL_PARSE_VERSION }
   }
 
   /** 校验待查天的 deps：unique 路径并行 stat，按天判定 mtime 变化/缺失，必要时重算该天并刷新缓存。 */
@@ -723,7 +733,15 @@ export function apply(ctx, rawConfig) {
         if (c.missing) missing.push(p)
         else if (Math.abs(c.currentMtime - Number(data.deps[p])) > 1) changed.push(p)
       }
-      if (changed.length > 0 || missing.length > 0) {
+      // v1 扁平 byModel（v0.6.1 落盘）：deps 仍全部指向存在的会话文件 → 重折恢复提供方归属（一次性，重写为 v2 嵌套）
+      let flatLegacy = daily.isFlatByModel(data.byModel || {}) && Object.keys(data.deps || {}).length > 0
+      if (flatLegacy) {
+        for (const p of Object.keys(data.deps)) {
+          const c = current.get(p)
+          if (!c || c.missing) { flatLegacy = false; break }
+        }
+      }
+      if (changed.length > 0 || missing.length > 0 || flatLegacy) {
         const repaired = await recomputeDay(day, data.deps || {})
         data.byProvider = repaired.byProvider
         data.byModel = repaired.byModel
@@ -799,19 +817,22 @@ export function apply(ctx, rawConfig) {
     const files = await daily.scanSessionFiles(config.sessionsDir, config.maxSessions, todayStart - 3600000)
     const cursors = await daily.loadCursors(config.dailyDir)
     // 今天 totals = 上次累积的天文件 + 本轮新增帧（文件 mtime 未变则完全跳过）
+    // 例外：天文件还是 v0.6.1 的扁平 byModel（无提供方维度）→ 不种子、当天全量重折（v2 嵌套），
+    // 游标一并重置，避免旧扁平数据进 unknown 桶 / 增量与重折双计
     const prevDay = await cachedDay(toDay)
-    const out = prevDay ? {
+    const prevFlat = !!(prevDay && daily.isFlatByModel(prevDay.byModel || {}))
+    const out = prevDay && !prevFlat ? {
       byProvider: JSON.parse(JSON.stringify(prevDay.byProvider || {})),
       byModel: JSON.parse(JSON.stringify(prevDay.byModel || {})),
     } : { byProvider: {}, byModel: {} }
-    const deps = prevDay && prevDay.deps ? { ...prevDay.deps } : {}
-    let anyWork = false
+    const deps = prevDay && prevDay.deps && !prevFlat ? { ...prevDay.deps } : {}
+    let anyWork = prevFlat
     for (const f of files) {
       deps[f.path] = f.mtimeMs
       const cur = cursors[f.path]
-      if (cur && cur.mtimeMs === f.mtimeMs) continue // 文件无新写入：本轮零成本跳过
+      if (!prevFlat && cur && cur.mtimeMs === f.mtimeMs) continue // 文件无新写入：本轮零成本跳过
       anyWork = true
-      if (cur && typeof cur.offset === 'number') {
+      if (!prevFlat && cur && typeof cur.offset === 'number') {
         const inc = await daily.readSessionFileFrom(f.path, cur.offset)
         if (inc.changed && inc.text) {
           daily.mergeTotals(out, daily.foldEventsByDay(daily.parseEvents(inc.text), todayStart, todayEnd, null))
@@ -840,6 +861,18 @@ export function apply(ctx, rawConfig) {
     return { toDay, out, scanned: files.length }
   }
 
+  /** 按提供方过滤嵌套 byModel（v0.6.1 扁平旧数据已由 mergeTotals 迁到 unknown 桶）。
+   * pick 为空 = 全部提供方（原样返回嵌套形态）；选中提供方无数据 = 空对象。
+   * 恒返回嵌套形态（选中时只含该提供方键），客户端据此统一判别新旧服务端。 */
+  function filterModelByProvider(byModel, pick) {
+    const src = byModel && typeof byModel === 'object' ? byModel : {}
+    if (!pick) return src
+    const out = {}
+    const inner = src[pick]
+    if (inner && typeof inner === 'object' && typeof inner.requests !== 'number') out[pick] = inner
+    return out
+  }
+
   async function doLocalUsage(target, since, key, state) {
     let st
     try { st = await fsStat(config.sessionsDir) } catch { return localFail(state, 'no-sessions', '未找到 DSH 会话目录：' + config.sessionsDir) }
@@ -858,12 +891,15 @@ export function apply(ctx, rawConfig) {
       await backfillAll(nowMs)
       await daily.writeBackfilled(config.dailyDir)
     }
+    // agg = 全量聚合（providers/totals 用）；modelAgg = 模型维度聚合（按提供方嵌套，v0.7.0）
     const agg = { byProvider: {}, byModel: {} }
+    const modelAgg = { byModel: {} }
     const dayCount = new Set()
     dayCount.add(toDay)
     // 今天：只算今天变过的文件
     const today = await computeToday(nowMs)
     daily.mergeTotals(agg, today.out)
+    daily.mergeTotals(modelAgg, { byModel: today.out.byModel || {} })
     // 历史天：读天文件（内存缓存；5 分钟周期内只校验一次 deps；mtime 变化才重算该天）
     const existing = await daily.listDayFiles(config.dailyDir)
     const pending = []
@@ -883,14 +919,16 @@ export function apply(ctx, rawConfig) {
     for (const day of Object.keys(dayData)) {
       const data = dayData[day]
       daily.mergeTotals(agg, { byProvider: data.byProvider || {}, byModel: data.byModel || {} })
+      daily.mergeTotals(modelAgg, { byModel: data.byModel || {} })
       dayCount.add(day)
     }
     // unknown 桶（time 缺失事件）：并入聚合（不占天数）
     const unknownData = await cachedDay('unknown')
     if (unknownData) {
       daily.mergeTotals(agg, { byProvider: unknownData.byProvider || {}, byModel: unknownData.byModel || {} })
+      daily.mergeTotals(modelAgg, { byModel: unknownData.byModel || {} })
     }
-    // 组装响应（chips 只过滤 totals；byModel 恒为全量）
+    // 组装响应（chips/totals/byModel 均按选中提供方过滤；v0.7.0 起 byModel 按提供方嵌套可过滤）
     const providers = Object.keys(agg.byProvider).sort()
     const pick = target ? (agg.byProvider[target] || null) : null
     const t = pick || { requests: 0, inputTokens: 0, outputTokens: 0, cacheReadTokens: 0 }
@@ -917,7 +955,7 @@ export function apply(ctx, rawConfig) {
           ? t.cacheReadTokens / (t.inputTokens + t.cacheReadTokens)
           : 0,
       },
-      byModel: agg.byModel || null,
+      byModel: filterModelByProvider(modelAgg.byModel, target || null),
       providers,
       fetchedAt: Date.now(), cached: false, stale: false,
       snapshots: (state.snapshots || []).slice(),
@@ -928,6 +966,18 @@ export function apply(ctx, rawConfig) {
     return payload
   }
 
+  /** 重置本地统计：删派生天文件/游标/哨兵（会话原文只读不动），清空 30s 缓存与去重态。 */
+  async function resetLocalUsage() {
+    const st = await fsStat(config.sessionsDir).then(() => true, () => false)
+    if (!st) return { ok: false, error: { type: 'no-sessions', message: '未找到 DSH 会话目录：' + config.sessionsDir, httpStatus: null } }
+    const removed = await daily.resetDailyStats(config.dailyDir)
+    dayCache.clear() // 天文件内存缓存一并清除：否则重查会用旧天数据做种子，重置对损坏天文件无效
+    for (const [k, s] of states) {
+      if (k.startsWith('local|')) { s.lastGood = null; s.fetching = null; s.validatedDays = new Set(); s.depsCheckAt = 0 }
+    }
+    return { ok: true, removed }
+  }
+
   async function localUsage(params) {
     const target = (params && typeof params.provider === 'string' && params.provider.trim() !== '') ? params.provider.trim() : null
     const since = (params && typeof params.since === 'string' && Number(params.since) > 0) ? Number(params.since) : 0
@@ -1018,6 +1068,12 @@ export function apply(ctx, rawConfig) {
         path: '/api/provider-usage/local-usage',
         handler: jsonRoute((req) => localUsage(queryParamsFromUrl(req))),
       }),
+      // 重置本地统计：删除按天物化的派生数据（天文件/游标/哨兵），下次查询自动全量重算；会话原文只读不动
+      ctx.webServer.register({
+        kind: 'exact',
+        path: '/api/provider-usage/reset-local-stats',
+        handler: jsonRoute(() => resetLocalUsage(), true),
+      }),
 
       // 适配器清单（不含任何 secret；客户端据此渲染"添加供应商"选项）
       ctx.webServer.register({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loommii/dsh-provider-usage",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "description": "DSH 插件（用量中心）：常驻用量卡片 · 多提供方用量/余额查询（OpenCode Go 订阅 + DeepSeek 余额 + Command Code 订阅/余额，对齐 cc-switch 查询语义）",
   "type": "module",
   "main": "lib/index.js",