@ds-hu/dsh-token-quota 2.4.1 → 2.5.0

package/CHANGELOG.md

@@ -6,6 +6,28 @@
 更早版本（v2.0.5 及以前）的变更记录在 [README](README.md) 的「vX.Y.Z 更新」小节与
 [docs/](docs/) 下的对应执行记录中，本文件自 2.1.0 起逐版本记录。
 
+## [2.5.0] - 2026-11-03
+
+### 变更
+
+- **今日行可切区间**：展开明细里的「Today」换成 `[Today ▾]` 选择器，可切「今天 / 近 7 天」；
+  token 数、归一比例与下面那条五分量分布条一起换成该区间的合计，图表固定 7 天不跟着变。
+  右侧文字不再重复区间名，只留数量。
+- **新增窗口估算**：同一行右侧给出各窗口（5h / 周 / 月）的 token 估算，可在「剩余」与「套餐总量」
+  之间切换；悬停给出取样区间、分子分母与 ±1pp 区间。
+- **估算按斜率折算**：每 1 个百分点的 token 量 = 取样内本地 token ÷ Δpp，剩余 = 斜率 × 剩余%，
+  总量 = 斜率 × 100%。此前除以累计已用%：月窗口比本地留存长时，分子只拿得到最近几天的 token，
+  3.23B 会推出 3.68B 的总量，而折线显示的是 3.23B 走了约 30pp。
+- 窗口长度由供应商声明（`entries[].windowMs`），宿主把小时桶折成 `estimate{from,to,tokens,dPct}`
+  随 `/state` 下发；取样左端取「窗口起点」与「本地留存边界」的较晚者，两端必须落在同一条折线段上。
+- 文案净增 5 键（158 → 163），测试的文案预算同步上调。
+
+### 修复
+
+- **图表柱值数字被折线压花**：柱值标签底下垫一层卡片底色，折线从数字背后穿过，数字不再被压线。
+- **估算显示「—」却无从判断**：门槛从「已用 < 5%」改为「取样 Δpp < 2」——低电平不是噪声源，
+  斜率才是；仍算不出来的窗口悬停提示「本地样本不足」，一个窗口都算不出来时整组不出现。
+
 ## [2.4.1] - 2026-11-01
 
 ### 变更

package/README.md

@@ -2,11 +2,18 @@
 
 DeepSeek Harness 用量监控插件。查看当前会话对应供应商的周期限额、账户余额、报告费用和今日 Token 用量，支持 Windows 桌面端与 Web 界面。
 
-当前版本：**v2.4.1**。要求 **DSH ≥ 0.1.7-rc.2**；真实桌面及 Web 验收环境为 **DSH 0.2.0-rc.2**。
+当前版本：**v2.5.0**。要求 **DSH ≥ 0.1.7-rc.2**；真实桌面及 Web 验收环境为 **DSH 0.2.0-rc.2**。
 
 Plugins 面板中显示为 **用量监控**（英文 **Usage monitor**）：图标是根目录 `icon.svg`，标题与一句话说明来自 `locale/zh.json` 与 `locale/en.json` 的 `meta`。
 
-[GitHub 下载](https://github.com/shxtmaker/dsh-token-quota/releases/latest) · [问题反馈](https://github.com/shxtmaker/dsh-token-quota/issues)
+[npm](https://www.npmjs.com/package/@ds-hu/dsh-token-quota) · [问题反馈](https://github.com/ds-hu/dsh-usage-monitor/issues)
+
+## v2.5.0 更新
+
+- 展开行的「Today」换成选择器：可切「今天 / 近 7 天」，token 数、归一比例与五分量分布条一起换成该区间的合计；图表固定 7 天，不跟着变。
+- 同一行右侧给出各窗口的 token 估算（5h / 周 / 月），可在「剩余」与「套餐总量」之间切换；悬停显示取样区间、分子分母与 ±1pp 区间。
+- 估算按取样内的斜率折算（本地 token ÷ Δpp），不再除以累计已用%：月窗口比本地留存长时，旧算法只拿得到最近几天的 token，会把总量算成一半。
+- 修复图表柱值数字被折线压花：数字底下垫一层卡片底色，折线从数字背后穿过。
 
 ## v2.4.1 更新
 
@@ -85,7 +92,7 @@ Plugins 面板中显示为 **用量监控**（英文 **Usage monitor**）：图
 
 ## 安装
 
-插件有两个来源：npm 包 **`@ds-hu/dsh-token-quota`**，或 Release 里的安装包 **`dsh-token-quota-2.4.0.tgz`**（源码包为 `dsh-token-quota-2.4.0-source.tar.gz`）。插件包不包含 DeepSeek Harness；首次安装可能需要联网下载依赖。
+插件从 npm 安装：**`@ds-hu/dsh-token-quota`**。离线部署时可以在源码目录 `npm pack` 打出 `ds-hu-dsh-token-quota-2.5.0.tgz`，用压缩包安装。插件包不包含 DeepSeek Harness；首次安装可能需要联网下载依赖。
 
 ### Windows 桌面端
 
@@ -93,15 +100,15 @@ Plugins 面板中显示为 **用量监控**（英文 **Usage monitor**）：图
 
 ```powershell
 $desktopCli = 'D:\AI\DeepSeek- Harness\resources\runtime\cli\bin\dsh.cmd'
-$archivePath = (Resolve-Path './dsh-token-quota-2.4.0.tgz').Path
-& $desktopCli plugin --profile desktop add "file:$archivePath"
+& $desktopCli plugin --profile desktop add @ds-hu/dsh-token-quota
 & $desktopCli plugin --profile desktop list --depth 0
 ```
 
-插件已在 npm 上，用一条命令安装即可，不必先下载压缩包：
+离线安装时把包名换成压缩包路径：
 
 ```powershell
-& $desktopCli plugin --profile desktop add @ds-hu/dsh-token-quota
+$archivePath = (Resolve-Path './ds-hu-dsh-token-quota-2.5.0.tgz').Path
+& $desktopCli plugin --profile desktop add "file:$archivePath"
 ```
 
 重新打开桌面应用，展开左侧栏即可看到用量组件；也可从「设置 → 用量监控」进入。安装到 `web` profile 的插件不会自动出现在桌面端。桌面侧栏收起后组件随侧栏隐藏，展开后恢复。
@@ -117,19 +124,19 @@ dsh plugin --profile web add @ds-hu/dsh-token-quota
 dsh --profile web
 ```
 
-从 Release 的压缩包安装：
+离线安装（先 `npm pack` 得到压缩包）：
 
 Linux / macOS：
 
 ```bash
-dsh plugin --profile web add "file:$(pwd)/dsh-token-quota-2.4.0.tgz"
+dsh plugin --profile web add "file:$(pwd)/ds-hu-dsh-token-quota-2.5.0.tgz"
 dsh --profile web
 ```
 
 Windows PowerShell：
 
 ```powershell
-$archivePath = (Resolve-Path './dsh-token-quota-2.4.0.tgz').Path
+$archivePath = (Resolve-Path './ds-hu-dsh-token-quota-2.5.0.tgz').Path
 dsh plugin --profile web add "file:$archivePath"
 dsh --profile web
 ```
@@ -141,8 +148,8 @@ dsh --profile web
 ### 从源码安装
 
 ```bash
-git clone https://github.com/shxtmaker/dsh-token-quota.git
-cd dsh-token-quota
+git clone https://github.com/ds-hu/dsh-usage-monitor.git
+cd dsh-usage-monitor
 npm ci
 dsh plugin --profile web add "link:$(pwd)"
 dsh --profile web
@@ -262,14 +269,20 @@ npm pack
 真实宿主验收使用独立数据目录与 profile，不修改日常配置：
 
 ```powershell
-npm run test:desktop -- --app 'C:/path/DeepSeek Harness.exe' --package 'C:/path/dsh-token-quota-2.4.0.tgz' --output '.scratch/desktop-v2-check'
-node scripts/verify-web.mjs --app 'C:/path/DeepSeek Harness.exe' --package 'C:/path/dsh-token-quota-2.4.0.tgz' --output '.scratch/web-v2-check'
+npm run test:desktop -- --app 'C:/path/DeepSeek Harness.exe' --package 'C:/path/ds-hu-dsh-token-quota-2.5.0.tgz' --output '.scratch/desktop-v2-check'
+node scripts/verify-web.mjs --app 'C:/path/DeepSeek Harness.exe' --package 'C:/path/ds-hu-dsh-token-quota-2.5.0.tgz' --output '.scratch/web-v2-check'
 npm run test:lifecycle -- --app 'C:/path/DeepSeek Harness.exe' --output '.scratch/lifecycle-v2-check'
 ```
 
 输出目录需为未使用过的目录。供应商解析测试使用模拟响应；真实 Desktop 与 Web 验收检查安装、界面、配置持久化和重新扫描，不发送聊天消息或配置真实供应商密钥。
 
-[桌面兼容性说明](docs/windows-desktop-adaptation.md) · [单一面板重构记录](docs/single-panel-refactor-execution.md) · [ADR-0002](docs/adr/0002-single-monitor-surface.md) · [侧栏与设置实施记录](docs/sidebar-settings-iteration-plan.md)
+[桌面兼容性说明](docs/windows-desktop-adaptation.md) · [单一面板重构记录](docs/single-panel-refactor-execution.md) · [ADR-0002](docs/adr/0002-single-monitor-surface.md) · [侧栏与设置实施记录](docs/sidebar-settings-iteration-plan.md) · [v2.5.0 发布记录](docs/v2.5.0-release-execution.md)
+
+## 来源与致谢
+
+本仓库是 [shxtmaker/dsh-token-quota](https://github.com/shxtmaker/dsh-token-quota) 的 fork，在 npm 上以
+`@ds-hu/dsh-token-quota` 发布。插件 id、设置命名空间、数据目录与各家供应商的查询规则都沿用上游，
+行为变更逐条记在 [CHANGELOG](CHANGELOG.md)。上游没有 npm 包，需要它的原始版本请用上游的 Releases。
 
 ## 许可证
 

package/lib/client.js

@@ -2,7 +2,7 @@
 // 展示控制器统一请求与会话订阅；面板草稿独立于展示缓存与本地偏好。
 (function () {
   window.__ModuleLoader__.load({
-    id: "dsh-token-quota",
+    id: "@ds-hu/dsh-token-quota",
     factory: (require) => {
       var module = { exports: {} };
       var exports = module.exports;
@@ -1174,6 +1174,16 @@
         const todayNumber = typeof sup.todayTokens === "number" ? sup.todayTokens : 0;
         const error = String(sup.error?.message || sup.error?.code || "");
         const detailId = `qm-detail-${sup.id}`;
+        // 今日行与五分量分布条共用一份口径：切到「近 7 天」时两处一起换，图表固定 7 天不跟着变。
+        // 估算口径（剩余/总量）只影响读数本身，不重新取数。
+        const [range, setRange] = React.useState("today");
+        const [estMode, setEstMode] = React.useState("left");
+        const days = Array.isArray(sup.usageDays) ? sup.usageDays : [];
+        const week = range === "7d";
+        const scopedUsage = week ? sumUsageOf(days) : sup.todayUsage;
+        const scopedTokens = week
+          ? days.reduce((sum, day) => sum + (Number(day?.total) || 0), 0)
+          : todayNumber;
         return h("article", { className: `qm-row${expanded ? " open" : ""}`, "data-supplier": sup.id },
           h("button", { type: "button", className: "qm-row-head", "data-qm-row": "", "aria-expanded": expanded, "aria-controls": detailId, onClick: onToggle },
             h("span", { className: `qm-dot ${stateClass(sup)}` }),
@@ -1188,8 +1198,11 @@
               error.length > 180 ? h("details", null, h("summary", null, t("errorDetails")), h("p", null, error)) : null) : null,
             sup.lastSuccessAt ? h("div", { className: "qm-data-time" }, `${t("lastSuccess")} ${new Date(sup.lastSuccessAt).toLocaleString()}`) : null,
             h(MetricTable, { supplier: sup, t }),
-            h(TodayLine, { sup, t }),
-            h(UsageSplit, { usage: sup.todayUsage, t }),
+            h(TodayLine, {
+              sup, t, tokens: scopedTokens, usage: scopedUsage,
+              range, onRange: setRange, mode: estMode, onMode: setEstMode,
+            }),
+            h(UsageSplit, { usage: scopedUsage, t }),
             h(SeasonBlock, { season, split: sup.seasonSplit, t }),
             h("div", { className: "qm-row-actions" }, h("button", { type: "button", onClick: () => onEdit(sup.id) }, t("openPage"))),
             Array.isArray(sup.usageDays) && sup.usageDays.length
@@ -1210,14 +1223,77 @@
                   h("td", { key: column.key, className: column.key === "used" ? `qm-tone ${row.tone}` : column.key === "value" ? "qm-num" : "" }, row[column.key] ?? "—"))))))));
       }
 
-      function TodayLine({ sup, t }) {
-        const total = fmtBig(typeof sup.todayTokens === "number" ? sup.todayTokens : 0);
-        const ratio = usageRatioOf(sup.todayUsage);
+      /**
+       * 今日行：区间选择器 + 数量 + 归一比例 + 窗口估算。
+       * 「Today」两个字换成选择器后，同一行读作「哪个区间、多少 token、什么比例、各窗口还能用多少」。
+       */
+      function TodayLine({ sup, t, tokens, usage, range, onRange, mode, onMode }) {
+        const total = fmtBig(tokens || 0);
+        const ratio = usageRatioOf(usage);
         const detailText = ratio ? t("ratioAria", { hit: fmtBig(ratio.hitValue), miss: fmtBig(ratio.missValue), out: fmtBig(ratio.outValue) }) : "";
+        // 区间已经由左边的选择器说清楚了，这里不再重复「Today / 近 7 天」，只留数量。
+        const text = `${total} tokens`;
         return h("div", { className: "qm-today-line" },
-          h("span", { className: "qm-today-text" }, t("today", { n: total })),
+          h("span", { className: "qm-range" },
+            h("select", {
+              value: range, "aria-label": t("rangeLabel"),
+              onChange: (ev) => onRange(ev.target.value === "7d" ? "7d" : "today"),
+            },
+              h("option", { value: "today" }, t("todayLabel")),
+              h("option", { value: "7d" }, t("range7d")))),
+          h("span", { className: "qm-today-text" }, text),
           ratio ? h("span", { className: "qm-ratio", title: detailText },
-            h("b", { className: "r-hit" }, ratio.hit), " : ", h("b", { className: "r-miss" }, ratio.miss), " : ", h("b", { className: "r-out" }, ratio.out)) : null);
+            h("b", { className: "r-hit" }, ratio.hit), " : ", h("b", { className: "r-miss" }, ratio.miss), " : ", h("b", { className: "r-out" }, ratio.out)) : null,
+          h(EstimateGroup, { sup, t, mode, onMode }));
+      }
+
+      /**
+       * 窗口估算：同一段折线里「本地 token ÷ Δpp」得到每 1 个百分点值多少 token，
+       * 再按当前电平换算成剩余（Left）或窗口总量（Total）。
+       * 分母是 Δpp 而不是已用% —— 窗口比本地留存长时，分子只覆盖最近几天，
+       * 除以累计百分比会把总量算成一半（3B 降 50pp 应得 6B，不是 3B ÷ 90%）。
+       * title 里给出取样区间、分子分母与 ±1pp 的区间，好让人对着图核账。
+       */
+      function EstimateGroup({ sup, t, mode, onMode }) {
+        const entries = (Array.isArray(sup.entries) ? sup.entries : [])
+          .filter((entry) => entry && entry.kind === "win" && Number.isFinite(Number(entry.pct)));
+        if (!entries.length) return null;
+        const kind = mode === "left" ? t("estLeft") : t("estTotal");
+        const chips = [];
+        let estimable = 0;
+        for (const entry of entries) {
+          const label = entry.short || entry.name || entry.key;
+          const pct = Math.min(100, Math.max(0, Number(entry.pct)));
+          const est = entry.estimate;
+          const tokens = Number(est?.tokens);
+          const dPct = Number(est?.dPct);
+          // 不到两个百分点（整数上报）就是噪声，宁可给「—」
+          if (!(tokens > 0) || !(dPct >= 2)) {
+            chips.push(h("span", { key: entry.key, className: "qm-est-q is-off", title: t("estNoData") }, `${label} —`));
+            continue;
+          }
+          estimable++;
+          // 剩余看还占多少个百分点，总量看满 100 个百分点
+          const level = mode === "left" ? Math.max(0, 100 - pct) : 100;
+          const at = (delta) => (tokens / delta) * level;
+          const main = at(dPct);
+          const spanMs = Math.max(0, Number(est.to) - Number(est.from));
+          const span = spanMs >= 48 * 3600_000
+            ? `${Math.round(spanMs / 86400_000)}d`
+            : `${Math.max(1, Math.round(spanMs / 3600_000))}h`;
+          const title = `${label} ${kind} ≈${fmtBig(Math.round(main))}\n`
+            + `${span}: ${fmtBig(tokens)} ÷ Δ${dPct}pp\n`
+            + `Δ${dPct}pp ±1pp → ${fmtBig(Math.round(at(dPct + 1)))}–${fmtBig(Math.round(at(dPct - 1)))}`;
+          chips.push(h("span", { key: entry.key, className: "qm-est-q", title },
+            `${label} `, h("b", null, `≈${fmtBig(Math.round(main))}`)));
+        }
+        // 一个窗口都算不出来时整组不出现：不拿一排「—」占掉今日行
+        if (!estimable) return null;
+        return h("span", { className: "qm-est" },
+          h("span", { className: "qm-est-seg", role: "group" },
+            h("button", { type: "button", "aria-pressed": mode === "left", onClick: () => onMode("left") }, t("estLeft")),
+            h("button", { type: "button", "aria-pressed": mode === "total", onClick: () => onMode("total") }, t("estTotal"))),
+          chips);
       }
 
       /** 五分量分布：条与图例一一对应；今日比例只取前三项，写缓存与未细分在这里出现。 */
@@ -1695,6 +1771,11 @@
           todayShort: "今日 {n}",
           statsWindow: "近 {n} 天",
           remainLabel: "剩余 {n}%",
+          rangeLabel: "统计区间",
+          range7d: "近 7 天",
+          estLeft: "剩余",
+          estTotal: "套餐总量",
+          estNoData: "本地样本不足",
           ratioAria: "缓存命中 {hit} · 缓存未命中 {miss} · 输出 {out}",
           cacheHit: "缓存命中",
           cacheMiss: "缓存未命中",
@@ -1861,6 +1942,11 @@
           todayShort: "Today {n}",
           statsWindow: "Last {n} days",
           remainLabel: "{n}% left",
+          rangeLabel: "Range",
+          range7d: "Last 7 days",
+          estLeft: "Left",
+          estTotal: "Total",
+          estNoData: "Not enough local samples",
           ratioAria: "Cache hits {hit} · cache misses {miss} · output {out}",
           cacheHit: "Cache hits",
           cacheMiss: "Cache misses",
@@ -1978,6 +2064,26 @@ div:has(> div[data-slot="sidebar.footer.action"] > [data-qm-linerow]){flex-wrap:
 .qm-today-line{display:flex;align-items:baseline;flex-wrap:wrap;gap:2px 10px;margin:8px 10px 6px;
   color:var(--dsw-alias-label-secondary,#a9b2c5);font-size:11px;font-variant-numeric:tabular-nums;}
 .qm-today-text{flex:none;}
+/* 区间选择器（今天 / 近 7 天）：替代原来的「今日」二字，一次点击换口径 */
+.qm-card .qm-range{position:relative;display:inline-flex;align-items:center;flex:none;}
+.qm-card .qm-range select{font:inherit;font-size:11px;line-height:15px;padding:1px 16px 1px 6px;appearance:none;
+  color:var(--dsw-alias-label-primary,#dbe2ee);background:var(--dsw-alias-bg-base,#0b0e13);
+  border:1px solid var(--dsw-alias-border-l2,#363d4d);border-radius:6px;cursor:pointer;}
+.qm-range::after{content:"▾";position:absolute;right:5px;top:50%;transform:translateY(-50%);font-size:8px;
+  color:var(--dsw-alias-label-tertiary,#8b94a8);pointer-events:none;}
+/* 窗口估算：Left/Total 两段式 + 三个读数；窄栏自己折行，不去挤比例数字 */
+.qm-est{display:inline-flex;flex-wrap:wrap;align-items:baseline;gap:2px 8px;margin-left:auto;
+  font-size:11px;color:var(--dsw-alias-label-secondary,#a9b2c5);min-width:0;}
+.qm-est-seg{display:inline-flex;flex:none;border:1px solid var(--dsw-alias-border-l2,#363d4d);
+  border-radius:6px;overflow:hidden;}
+.qm-card .qm-est-seg button{font:inherit;font-size:10px;line-height:15px;padding:1px 6px;border:0;border-radius:0;
+  background:none;color:var(--dsw-alias-label-tertiary,#8b94a8);cursor:pointer;}
+.qm-card .qm-est-seg button+button{border-left:1px solid var(--dsw-alias-border-l2,#363d4d);}
+.qm-card .qm-est-seg button[aria-pressed=true]{background:var(--dsw-alias-interactive-bg-hover,#20283a);
+  color:var(--dsw-alias-label-primary,#dbe2ee);}
+.qm-est-q{white-space:nowrap;color:var(--dsw-alias-label-secondary,#a9b2c5);}
+.qm-est-q b{font-weight:600;color:var(--dsw-alias-label-primary,#dbe2ee);font-variant-numeric:tabular-nums;}
+.qm-est-q.is-off{color:var(--dsw-alias-label-tertiary,#5c6577);}
 /* 分布条：详情行只有一条五段条（命中/未命中/输出/写缓存/未细分）；段宽 = 分量占比 */
 .qm-split-bar{display:inline-flex;flex:1 1 64px;min-width:48px;height:5px;border-radius:2.5px;overflow:hidden;
   background:var(--dsw-alias-border-l1,#1d2330);}
@@ -2005,8 +2111,11 @@ div:has(> div[data-slot="sidebar.footer.action"] > [data-qm-linerow]){flex-wrap:
 .qm-chart-plot svg{display:block;width:100%;height:100%;overflow:visible;}
 /* 柱值标签：按绘图区百分比定位，文字本身不参与 svg 的横向拉伸 */
 .qm-chart-labels{position:absolute;inset:0;pointer-events:none;}
+/* 柱值标签：按绘图区百分比定位，文字本身不参与 svg 的横向拉伸。
+   标签不可透明：底下一层卡片底色把折线挡开，数字才不会被线压花（标签层在 SVG 之上）。 */
 .qm-chart-value{position:absolute;transform:translateX(-50%);font-size:10px;line-height:1;white-space:nowrap;
-  font-variant-numeric:tabular-nums;color:var(--dsw-alias-label-secondary,#a9b2c5);pointer-events:none;}
+  font-variant-numeric:tabular-nums;color:var(--dsw-alias-label-secondary,#a9b2c5);pointer-events:none;
+  padding:1px 3px;border-radius:3px;background:var(--dsw-alias-bg-layer-2,#151922);}
 .qm-chart-bar{fill:var(--dsw-alias-state-business-primary,#4f8cff);fill-opacity:.32;}
 .qm-chart-grid{stroke:var(--dsw-alias-border-l2,#363d4d);stroke-width:1;stroke-dasharray:3 3;vector-effect:non-scaling-stroke;}
 .qm-chart-axis{stroke:var(--dsw-alias-border-l2,#363d4d);stroke-width:1;vector-effect:non-scaling-stroke;}

package/lib/index.js

@@ -34,7 +34,8 @@ import { createUsageRecorder } from "./usage.js";
 import { createRouteResolver } from "./routes.js";
 import { autoFillPatch, DSH_ROUTE_MAP, detectHarnessSuppliers, resolveCredentialRef } from "./detect.js";
 import { PROVIDERS, SUPPLIER_IDS } from "./providers.js";
-import { sumDayTokens, splitDayTokens, dayUsageHistory, dshHome, acquireUsageStore, migrateUsageDir, quotaFilePath } from "./storage.js";
+import { sumDayTokens, splitDayTokens, dayUsageHistory, dshHome, acquireUsageStore, migrateUsageDir,
+  quotaFilePath, hourTimeMs, totalOf } from "./storage.js";
 import { acquireQuotaStore, clipSamples, downsampleSamples, QUOTA_RETENTION_DAYS, QUOTA_SEND_POINTS } from "./quota-history.js";
 import { describeSeason, normalizeHolidays, validateHolidayOverride, tierOfHour } from "./season.js";
 
@@ -351,6 +352,61 @@ export function apply(ctx, config) {
     return { currentIds, todayOf, splitOf, daysOf, historyDays, trafficStale, holidays, now };
   }
 
+  /**
+   * 窗口估算的取样：同一段折线里，两条额度采样之间本地烧掉多少 token、百分比走了多少点。
+   *
+   * 分母必须是 Δpp（斜率），不能是「已用%」（电平）：窗口起点若早于本地留存，分子只有最近几天，
+   * 除以累计百分比会把总量算成一半（3B 降 50pp 应该推出 6B，而不是 3B ÷ 90%）。
+   * 两端必须落在同一条折线段上（中间有重置就取最后一次之后），左端再从本地还留着的小时桶起算。
+   * 窗口长度由供应商声明（entries[].windowMs）；没声明就没有估算。
+   * @returns {{from:number,to:number,tokens:number,dPct:number}|null}
+   */
+  function estimateOf(id, entry, now = Date.now()) {
+    const windowMs = Number(entry?.windowMs);
+    const resetAt = Number(entry?.resetAt);
+    if (!Number.isFinite(windowMs) || windowMs <= 0 || !Number.isFinite(resetAt)) return null;
+    const samples = (quotaStore?.store.quota?.[id]?.[entry.key] || [])
+      .filter((pair) => Array.isArray(pair) && Number.isFinite(pair[0]) && Number.isFinite(pair[1]));
+    if (samples.length < 2) return null;
+    // 只取当前窗口这一段：额度在窗口内只升不降，最后一个回落点之前是上一轮
+    let start = 0;
+    for (let i = 1; i < samples.length; i++) if (samples[i][1] < samples[i - 1][1]) start = i;
+    const current = samples.slice(start);
+    if (current.length < 2) return null;
+    // 分子只能覆盖本地还留着的桶：左端取「窗口起点」与「留存起点」里较晚的那个
+    const retentionMs = Math.max(1, Math.floor(runtime.config.retentionDays || 7)) * 86400_000;
+    const from = Math.max(resetAt - windowMs, now - retentionMs);
+    const first = current.find(([at]) => at >= from);
+    if (!first) return null;
+    const last = current[current.length - 1];
+    const dPct = Math.round((last[1] - first[1]) * 10) / 10;
+    // 少于两点百分比（整数上报）或不到一小时，斜率就是噪声
+    if (!(dPct >= 2) || last[0] - first[0] < 3600_000) return null;
+    const hours = runtime.usageBuckets[id];
+    if (!hours) return null;
+    let tokens = 0;
+    for (const [key, breakdown] of Object.entries(hours)) {
+      const at = hourTimeMs(key);
+      // 小时桶覆盖 [at, at+1h)：与取样区间有重叠就整段计入（边界那一小时会略微多算）
+      if (at + 3600_000 > first[0] && at <= last[0]) tokens += totalOf(breakdown);
+    }
+    if (tokens <= 0) return null;
+    return { from: first[0], to: last[0], tokens, dPct };
+  }
+
+  /** 给窗口类限额项挂上 estimate；其它类型（余额、报告）原样返回。 */
+  function withEstimate(id, last) {
+    if (!Array.isArray(last?.entries) || !last.entries.length) return last;
+    return {
+      ...last,
+      entries: last.entries.map((entry) => {
+        if (entry?.kind !== "win") return entry;
+        const estimate = estimateOf(id, entry);
+        return estimate === null ? entry : { ...entry, estimate };
+      }),
+    };
+  }
+
   // ---------- 「当前在用」供应商（小组件紧凑条主显示） ----------
   // 语义（用户选定）：最近一次真实 LLM 调用命中的供应商 + 模型名。
   // 只统计能映射到插件供应商的 route（session/event 已把 route/model 折叠进各 routeSeen 表）；
@@ -614,7 +670,7 @@ export function apply(ctx, config) {
             needs: (meta.needs || []).map((n) => ({ key: n.key, label: n.label, secret: !!n.secret })),
           },
           ...(s.last
-            ? s.last
+            ? withEstimate(id, s.last)
             : { state: "off", error: { code: "no-run", message: "尚未取数" }, headline: { kind: "amt", amt: "—" } }),
           // 成功数据时间独立于 fetchedAt；失败尝试只更新状态，不能冒充新数据。
           ...(s.lastSuccessAt != null ? { lastSuccessAt: s.lastSuccessAt } : {}),

package/lib/providers.js

@@ -786,7 +786,13 @@ async function queryOpenCode(cfg) {
       const body = await httpJson(`${server}/zen/go/v1/usage`, { key: cfg.apiKey });
       const usage = body?.usage;
       if (usage && typeof usage === "object") {
-        for (const [field, label, short] of [["rolling", "5h 滚动", "5h"], ["weekly", "周用量", "周"], ["monthly", "月用量", "月"]]) {
+        // windowMs：窗口长度，供宿主把本地小时桶折成「这个窗口里烧了多少 token」。
+        // 只在这里声明，因为只有供应商自己知道窗口多长；缺它的限额项不会得到估算。
+        for (const [field, label, short, windowMs] of [
+          ["rolling", "5h 滚动", "5h", 5 * 3600_000],
+          ["weekly", "周用量", "周", 7 * 86400_000],
+          ["monthly", "月用量", "月", 30 * 86400_000],
+        ]) {
           const w = usage[field];
           if (!w || typeof w !== "object") continue;
           const pct = parseNumber(w.percent);
@@ -796,6 +802,7 @@ async function queryOpenCode(cfg) {
             key: `window.${field}`,
             short,
             kind: "win",
+            windowMs,
             limit: "—",
             used: pct === null ? "—" : `${pct}%`,
             remain: pct === null ? "—" : `${Math.max(0, 100 - pct)}%`,
@@ -925,9 +932,9 @@ async function queryCommandCode(cfg) {
     let tightest = null;
 
     const windowLimits = creditsBody?.windowLimits;
-    for (const [field, label, slot, short] of [
-      ["fiveHour", "5h 窗口", "window.5h", "5h"],
-      ["weekly", "周窗口", "window.weekly", "周"],
+    for (const [field, label, slot, short, windowMs] of [
+      ["fiveHour", "5h 窗口", "window.5h", "5h", 5 * 3600_000],
+      ["weekly", "周窗口", "window.weekly", "周", 7 * 86400_000],
     ]) {
       const w = windowLimits?.[field];
       if (!w || typeof w !== "object") continue;
@@ -948,6 +955,7 @@ async function queryCommandCode(cfg) {
         key: slot,
         short,
         kind: "win",
+        windowMs,
         limit: formatMoney(cap, "USD"),
         used: used === null ? "—" : formatMoney(used, "USD"),
         remain: remain === null ? "—" : formatMoney(remain, "USD"),
@@ -982,6 +990,10 @@ async function queryCommandCode(cfg) {
           key: "window.monthly",
           short: "月",
           kind: "win",
+          // 订阅周期就是窗口：起止都给了才声明长度，只有结束时刻就留空（估算宁可不给）
+          windowMs: periodEnd && periodStart && !Number.isNaN(periodStart.getTime())
+            ? Math.max(0, periodEnd.getTime() - periodStart.getTime())
+            : null,
           limit: formatMoney(planLimit, "USD"),
           used: formatMoney(used, "USD"),
           remain: formatMoney(remaining, "USD"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ds-hu/dsh-token-quota",
-  "version": "2.4.1",
+  "version": "2.5.0",
   "description": "DeepSeek Harness 用量监控：官方侧栏完整／紧凑卡片与单一面板的概览、供应商配置，按当前会话显示周期限额、逐币种余额与报告用量费用；保留凭据类别隔离、自动识别普通 API Key 与本地今日用量统计。",
   "icon": "./icon.svg",
   "author": "shxtmaker <https://github.com/shxtmaker>",

package/test/browser/interactions.spec.mjs

@@ -352,12 +352,18 @@ test("expanding a supplier shows token bars and remaining-quota lines in one cha
   await mkdir(statsDirectory, { recursive: true });
   await page.screenshot({ path: resolve(statsDirectory, "stats-combined-chart.png"), fullPage: true });
 
-  // 线上的形状不给数字：悬停把那一刻的读数放进浮层（最近一次采样，不插值），并落一条十字线
+  // 线上的形状不给数字：悬停把那一刻的读数放进浮层（最近一次采样，不插值），并落一条十字线。
+  // 落点取最后一根柱（今天）的中心，而不是「绘图区宽度的 94%」：横轴终点是此刻，6% ≈ 10 小时，
+  // 凌晨跑的 CI 会因此退回昨天（UTC 03:02 那次落到 10-31 18:12，浮层里没有 token 行）。
+  // 柱的坐标本身就是「今天」，与运行时刻无关。
   await plot.scrollIntoViewIfNeeded();
-  const box = await plot.boundingBox();
-  await page.mouse.move(box.x + box.width * 0.94, box.y + box.height / 2);
+  const todayLabel = dayLabels(7).at(-1).slice(5);
+  const lastBar = await plot.locator("rect.qm-chart-bar").last().boundingBox();
+  const plotBox = await plot.boundingBox();
+  await page.mouse.move(lastBar.x + lastBar.width / 2, plotBox.y + plotBox.height / 2);
   const tip = row.locator(".qm-chart-tip");
   await expect(tip).toBeVisible();
+  await expect(tip).toContainText(todayLabel);
   await expect(tip).toContainText("剩余");
   await expect(tip).toContainText("3.15M token");
   await expect(plot.locator(".qm-chart-cursor")).toHaveCount(1);

package/test/client.mjs

@@ -5,10 +5,11 @@ import vm from "node:vm";
 import React from "react";
 import { create, act } from "react-test-renderer";
 
+const manifest = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
 const source = readFileSync(new URL("../lib/client.js", import.meta.url), "utf8");
 /** 使用实际无构建客户端与真实 React，仅替换宿主槽位、网络、时钟和本地存储。 */
 function client(fetch, { storage = new Map(), search = "", clock = null, mobile = false } = {}) {
-  let plugin, dictionary;
+  let plugin, dictionary, registeredId;
   const locales = {};
   const slots = {}, timers = [], listeners = {}, cleanups = [];
   const subscribe = (type, fn) => (listeners[type] ||= new Set()).add(fn);
@@ -21,7 +22,7 @@ function client(fetch, { storage = new Map(), search = "", clock = null, mobile
     body: {}, visibilityState: "visible", addEventListener: subscribe, removeEventListener: unsubscribe,
   };
   const window = {
-    __ModuleLoader__: { load({ factory }) { plugin = factory((id) => id === "react" ? React : { createPortal: (child) => child }); } },
+    __ModuleLoader__: { load({ id, factory }) { registeredId = id; plugin = factory((id) => id === "react" ? React : { createPortal: (child) => child }); } },
     location: { search }, addEventListener: subscribe, removeEventListener: unsubscribe,
     localStorage: { getItem: (key) => storage.get(key) ?? null, setItem: (key, value) => storage.set(key, value) },
     // 视口断点替身：mobile 决定 matchMedia 的结果，宿主浏览器才有真实实现。
@@ -50,7 +51,7 @@ function client(fetch, { storage = new Map(), search = "", clock = null, mobile
     inject(name, fn) { return fn(); }, register(descriptor, component) { slots[descriptor.name ?? descriptor.key] = component; },
   } });
   const t = (key, params = {}) => String(dictionary[key] ?? key).replace(/\{(\w+)\}/g, (_, k) => params[k] ?? `{${k}}`);
-  return { Footer: slots["sidebar.footer.action"], Page: slots["settings.section"], t, locales, timers, storage, helpers: plugin.__test, setNow: context.__setNow };
+  return { registeredId, Footer: slots["sidebar.footer.action"], Page: slots["settings.section"], t, locales, timers, storage, helpers: plugin.__test, setNow: context.__setNow };
 }
 const textOf = (node) => {
   const walk = (child) => Array.isArray(child) ? child.map(walk).join("") : typeof child === "string" || typeof child === "number" ? String(child) : child?.children ? walk(child.children) : "";
@@ -82,6 +83,13 @@ const response = (data) => ({ ok: true, status: 200, json: async () => data });
 const payload = (name, suppliers = []) => ({ ok: true, traffic: { channelAlive: true }, suppliers, active: { supplierId: suppliers[0]?.id, name, model: "model", at: Date.now() } });
 const supplier = (entries, extra = {}) => ({ id: "opencode", name: "OpenCode", current: true, added: true, enabled: true, state: "ok", todayTokens: 0, entries, ...extra });
 
+// 包名与产物里注册的 id 必须逐字符一致：DSH 浏览器半身按包名请求 <pkg>/client，
+// 注册成别的名字时整条 entry 静默不激活，页面只报 loaded without registering。
+test("the bundle registers itself under the package name", async () => {
+  const host = client(async () => response(payload("A")));
+  assert.equal(host.registeredId, manifest.name);
+});
+
 for (const wide of [true, false]) test(`${wide ? "expanded" : "rail"} sidebar opens the single monitor panel`, async () => {
   const host = client(async () => response(payload("A")));
   let tree;
@@ -358,7 +366,7 @@ test("the card draws one bar per watched limit with its own countdown and no tod
     // 今日用量搬进详情弹窗的供应商栏
     await open(tree);
     await expand(tree, "opencode");
-    assert.match(textOf(rowOf(tree, "opencode").findByProps({ className: "qm-today-line" })), /今日用量 1\.24M tokens/);
+    assert.match(textOf(rowOf(tree, "opencode").findByProps({ className: "qm-today-line" })), /1\.24M tokens/);
   } finally { await act(async () => tree?.unmount()); }
 });
 
@@ -395,7 +403,7 @@ test("details show the colored ratio next to today's total, and only when compon
     await open(tree);
     await expand(tree, "opencode");
     const line = rowOf(tree, "opencode").findByProps({ className: "qm-today-line" });
-    assert.match(textOf(line), /今日用量 3\.15M tokens/, "总量仍按供应商口径");
+    assert.match(textOf(line), /3\.15M tokens/, "总量仍按供应商口径；区间由选择器表达");
     assert.match(textOf(line), /30\.0 : 1\.00 : 0\.150/, "比例挨着总量：命中 : 未命中 : 输出，未命中 = 1");
     // 三个数字分别着段色，与下方五段条的前三段一一对应
     const ratio = line.findByProps({ className: "qm-ratio" });
@@ -410,13 +418,83 @@ test("details show the colored ratio next to today's total, and only when compon
     await open(tree);
     await expand(tree, "opencode");
     const bare = rowOf(tree, "opencode").findByProps({ className: "qm-today-line" });
-    assert.match(textOf(bare), /今日用量 500 tokens/);
+    assert.match(textOf(bare), /500 tokens/);
     assert.equal(withClass(bare, "qm-split-bar").length, 0);
     assert.equal(withClass(rowOf(tree, "opencode"), "qm-split-bar").length, 0);
     assert.equal(bare.findAllByProps({ className: "qm-ratio" }).length, 0);
   } finally { await act(async () => tree?.unmount()); }
 });
 
+test("the today line switches range and derives each window's token estimate", async () => {
+  const usageDays = [
+    { day: "2026-10-26", inputTokens: 10, outputTokens: 1, cacheReadTokens: 100, cacheWriteTokens: 0, unsplitTokens: 0, total: 111 },
+    { day: "2026-10-27", inputTokens: 100, outputTokens: 16, cacheReadTokens: 3_000, cacheWriteTokens: 40, unsplitTokens: 0, total: 3_155_000 },
+  ];
+  const hour = 3600_000;
+  const at = Date.now();
+  const estimate = (tokens, dPct, hours) => ({ from: at - hours * hour, to: at - hour, tokens, dPct });
+  const entries = [
+    // 每 1pp = 34M ÷ 20 = 1.7M：剩余 64pp ⇒ ≈109M，满 100pp ⇒ ≈170M
+    { name: "5h 滚动", key: "window.5h", short: "5h", kind: "win", pct: 36, estimate: estimate(34_000_000, 20, 5) },
+    { name: "周用量", key: "window.weekly", short: "周", kind: "win", pct: 53, estimate: estimate(2_500_000_000, 30, 72) },
+    { name: "月用量", key: "window.monthly", short: "月", kind: "win", pct: 89, estimate: estimate(3_150_000_000, 30, 96) },
+    // 只走了 1pp：整数百分比的舍入误差撑不起斜率，宁可给「—」
+    { name: "新窗口", key: "window.tiny", short: "新", kind: "win", pct: 2, estimate: estimate(9_000_000, 1, 3) },
+  ];
+  const state = payload("OpenCode", [supplier(entries, {
+    todayTokens: 382_000_000,
+    todayUsage: { inputTokens: 100, outputTokens: 16, cacheReadTokens: 3_000, cacheWriteTokens: 40, unsplitTokens: 0 },
+    usageDays,
+  })]);
+  const host = client(async () => response(state));
+  let tree;
+  try {
+    tree = await mount(host);
+    await open(tree);
+    await expand(tree, "opencode");
+    const today = rowOf(tree, "opencode").findByProps({ className: "qm-today-line" });
+
+    // 「Today」两个字换成了选择器，右边的文字不再重复区间名
+    const range = today.findByType("select");
+    assert.deepEqual(range.findAllByType("option").map((node) => node.props.value), ["today", "7d"]);
+    assert.equal(range.props.value, "today");
+    assert.equal(textOf(today.findByProps({ className: "qm-today-text" })), "382M tokens");
+
+    // 估算按斜率折算：34M ÷ Δ20pp = 1.7M/pp，剩余 64pp ⇒ ≈109M
+    const chips = withClass(today, "qm-est-q");
+    assert.deepEqual(chips.map(textOf), ["5h ≈109M", "周 ≈3.92B", "月 ≈1.16B", "新 —"]);
+    assert.match(chips[0].props.title, /4h: 34\.0M ÷ Δ20pp/, "title 里给出取样区间与分子分母");
+    assert.match(chips[0].props.title, /Δ20pp ±1pp → 104M–115M/);
+    assert.equal(chips[3].props.title, "本地样本不足");
+
+    // 切到套餐总量：同一份斜率，按满 100pp 折算
+    const [left, total] = today.findAllByProps({ className: "qm-est-seg" })[0].findAllByType("button");
+    assert.equal(left.props["aria-pressed"], true);
+    await act(async () => total.props.onClick());
+    const totals = withClass(today, "qm-est-q").map(textOf);
+    assert.deepEqual(totals, ["5h ≈170M", "周 ≈8.33B", "月 ≈10.5B", "新 —"]);
+
+    // 切到近 7 天：数量、比例、五分量条一起换，估算仍按窗口（不随区间变）
+    await act(async () => range.props.onChange({ target: { value: "7d" } }));
+    const line7d = rowOf(tree, "opencode").findByProps({ className: "qm-today-line" });
+    assert.equal(textOf(line7d.findByProps({ className: "qm-today-text" })), "3.16M tokens");
+    assert.match(textOf(line7d.findByProps({ className: "qm-ratio" })), /28\.2 : 1\.00 : 0\.155/);
+    assert.deepEqual(withClass(line7d, "qm-est-q").map(textOf), totals);
+
+    // 没有本地用量 → 不给估算（不编 0，也不编比例）
+    const bare = client(async () => response(payload("OpenCode", [supplier(
+      [{ name: "周用量", key: "window.weekly", short: "周", kind: "win", pct: 40 }],
+      { todayTokens: 500 })])));
+    let bareTree;
+    try {
+      bareTree = await mount(bare);
+      await open(bareTree);
+      await expand(bareTree, "opencode");
+      assert.equal(rowOf(bareTree, "opencode").findAllByProps({ className: "qm-est" }).length, 0);
+    } finally { await act(async () => bareTree?.unmount()); }
+  } finally { await act(async () => tree?.unmount()); }
+});
+
 test("expanding a supplier shows today's ratio, the five-part split and one combined chart", async () => {
   const start = (day) => new Date(...day.split("-").map((part, i) => (i === 1 ? Number(part) - 1 : Number(part)))).getTime();
   const usageDays = [

package/test/copy.mjs

@@ -42,6 +42,8 @@ test("removed surfaces and long explanatory paragraphs stay out of the dictionar
 });
 
 test("locale stays within the copy budget", () => {
-  assert.ok(zh.size <= 160, `中文词典 ${zh.size} 键，超出预算`);
-  assert.ok(en.size <= 160, `英文词典 ${en.size} 键，超出预算`);
+  // 160 → 163：今日行的区间选择器（rangeLabel、range7d）、估算口径切换（estLeft、estTotal）
+  // 与「样本不足」的悬停说明（estNoData）共五条；七天的句子、算式与区间都由数字拼出来，没有另开键。
+  assert.ok(zh.size <= 163, `中文词典 ${zh.size} 键，超出预算`);
+  assert.ok(en.size <= 163, `英文词典 ${en.size} 键，超出预算`);
 });

package/test/runtime.mjs

@@ -7,7 +7,7 @@ import { apply, Config } from "../lib/index.js";
 import { createCtx } from "./harness.mjs";
 import { PROVIDERS } from "../lib/providers.js";
 import * as season from "../lib/season.js";
-import { dayLabelOf } from "../lib/storage.js";
+import { dayLabelOf, hourKeyOf } from "../lib/storage.js";
 
 test("plugin instances do not share traffic and dispose releases event handlers", async () => {
   const originalHome = process.env.DSH_HOME;
@@ -322,6 +322,61 @@ test("a successful query appends a quota sample, and an unchanged value does not
   assert.deepEqual(saved.suppliers.opencode["window.rolling"].map(([, pct]) => pct), [12, 40]);
 });
 
+test("窗口估算按 Δpp 取样：分子只覆盖本地还留着的桶，左端落在窗口起点", async (t) => {
+  const previousHome = process.env.DSH_HOME;
+  const previousFetch = globalThis.fetch;
+  const home = mkdtempSync(join(tmpdir(), "qm-window-est-"));
+  process.env.DSH_HOME = home;
+  const now = Date.now();
+  const hour = 3600_000;
+  mkdirSync(join(home, "dsh-token-quota"), { recursive: true });
+  writeFileSync(join(home, "dsh-token-quota", "usage.json"), JSON.stringify({
+    version: 2,
+    buckets: { opencode: {
+      [hourKeyOf(new Date(now - 2 * hour))]: { inputTokens: 100 },
+      [hourKeyOf(new Date(now - 20 * hour))]: { inputTokens: 500 },
+      [hourKeyOf(new Date(now - 100 * hour))]: { inputTokens: 9_999 },
+    } },
+  }), "utf8");
+  // 额度折线：rolling 只记了本窗口的 30→40；weekly 从 40 小时前的 0 一路涨到 14
+  writeFileSync(join(home, "dsh-token-quota", "quota.json"), JSON.stringify({
+    version: 1,
+    suppliers: { opencode: {
+      "window.rolling": [[now - 3 * hour, 30], [now - hour, 40]],
+      "window.weekly": [[now - 40 * hour, 0], [now - 3 * hour, 10], [now - hour, 14]],
+    } },
+  }), "utf8");
+  globalThis.fetch = async (url) => {
+    if (!String(url).includes("/zen/go/v1/usage")) return { ok: false, status: 401, text: async () => "" };
+    return {
+      ok: true, status: 200, text: async () => JSON.stringify({ usage: {
+        // rolling：重置在 2 小时后、窗口 5h ⇒ 左缘 now−3h，与第一条采样对齐
+        rolling: { percent: 40, resetsAt: new Date(now + 2 * hour).toISOString() },
+        // weekly：重置在 4 天后、窗口 7d ⇒ 左缘 now−3d，样本从 40 小时前开始算
+        weekly: { percent: 14, resetsAt: new Date(now + 4 * 86400_000).toISOString() },
+      } }),
+    };
+  };
+  const harness = createCtx({ schema: Config, config: { suppliers: { opencode: { enabled: true, apiKey: "sk-test" } } } });
+  const dispose = apply(harness.ctx, harness.configRef);
+  t.after(() => {
+    dispose();
+    globalThis.fetch = previousFetch;
+    if (previousHome === undefined) delete process.env.DSH_HOME;
+    else process.env.DSH_HOME = previousHome;
+    rmSync(home, { recursive: true, force: true });
+  });
+
+  await harness.call("/api/dsh-token-quota/refresh", {});
+  const opencode = (await harness.call("/api/dsh-token-quota/state")).suppliers.find((s) => s.id === "opencode");
+  const byKey = Object.fromEntries(opencode.entries.map((entry) => [entry.key, entry]));
+  assert.equal(byKey["window.rolling"].windowMs, 5 * 3600_000, "窗口长度由供应商声明");
+  // 5h：取样 = [now−3h, now−1h]，只有 2 小时前那一桶（100）落在里面
+  assert.deepEqual(byKey["window.rolling"].estimate, { from: now - 3 * hour, to: now - hour, tokens: 100, dPct: 10 });
+  // 周：取样从 40 小时前开始，2 小时前与 20 小时前两桶都算（600），100 小时前那桶在左缘之外
+  assert.deepEqual(byKey["window.weekly"].estimate, { from: now - 40 * hour, to: now - hour, tokens: 600, dPct: 14 });
+});
+
 test("a retried attempt adds to the same step instead of replacing it", async (t) => {
   const previousHome = process.env.DSH_HOME;
   const home = mkdtempSync(join(tmpdir(), "qm-retry-"));