cortico-world-workbuddy 0.1.5 → 0.1.6

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # 更新日志
 
+## 0.1.6
+
+新增「用量」面板与真实的时段优惠计算（只在本机验证，未发布）。
+
+- **优惠来自 `/v3/config`**：改用应用身份 UA（`WorkBuddy/5.8.3 … CLI/2.161.0`）拉取目录，
+  同时拿到 `modelPromotions` / `modelTiers`。用 CLI 身份只能读到精简后的目录，
+  促销与档位字段整个缺失——这是之前倍率「永远显示原价」的根因。
+- **新增 `src/promo.js`**：解析 `schedule`（`timezone` / `validFrom` / `validUntil` / 跨零点的 `daily`
+  时段、`dailyUnusable`）、`discount`（`discountedCredits` 就是生效倍率本身，不是相对系数）、
+  `badge`（含 `display:"activeOnly"`）与 `priority`；按优先级选出此刻生效的那条。
+  `priceViewOf(model, now)` 给出 `{base, effective, promoId, badge, windowText, hoverText, isFree}`。
+- **新增「用量」面板**（`world:workbuddy` 第 4 个页签）：区间概览（今天 / 近 7 天 / 近 30 天）、
+  按模型聚合、积分包明细、限时优惠清单、最近调用明细；带「刷新余额」与「清空本地账本」。
+- **新增 `src/usage.js`**：每次 `wb_chat` 往 `<dataDir>/workbuddy-usage.jsonl` 记一行
+  （tokens 来自 SSE 的 `usage`，积分来自 `usage.credit` 即上游真实扣费，倍率记当时生效值），
+  读的时候裁掉 90 天以前的行；余额快照另存 `workbuddy-balance.json`。
+- `fetchCredits` 现在返回 `{total, used, packages[]}`（逐包剩余 / 已用 / 周期），
+  `wb_credits` 一并打印「本周期已用」。
+- `wb_chat` 回执补充「用量：输入 N tok / 输出 N tok / 缓存命中 N tok / 共 N tok / 本次消耗积分 N（N ms）」。
+- `wb_list_models` 标注此刻生效倍率（含原价对比、时段）与优惠徽标；`wb_select_model` 提示此刻倍率。
+- 环境提示词新增 `{{workbuddy.todayCredit}}` / `{{workbuddy.todayTokens}}`，并在倍率旁说明已含生效中的限时优惠。
+- 详情页徽标增加「今日积分」。
+- 仓库补 `package-lock.json`（锁定 esbuild 0.24.2），CI 改为 `npm ci`：`dist` 的构建产物必须逐字节稳定，否则「dist 未同步」的检查会误报。
+
 ## 0.1.5
 
 发布前收尾：停用 / 卸载彻底不留痕，并把元数据指向真实仓库。

package/README.md

@@ -139,18 +139,38 @@ Coopanion (Coo)
 
 | 面板 | 内容 |
 |---|---|
-| 模型目录 | 刷新目录；逐模型一行：名称/id、**默认积分倍率**（x0 标「免费」）、上下文、推理档、「选用」按钮 |
+| 模型目录 | 刷新目录；逐模型一行：名称/id、**此刻倍率**（含限时折扣时显示 `x0.5 ← x0.79 23:00–07:50`，x0 标「免费」）、上下文、推理档、「选用」按钮 |
 | 账号 | 登录态来源（本机发现 / 手动）、掩码 token、积分余额查询、重新检测、手动 token 存取 |
 | 是否启用 WorkBuddy | 「中转站优先」开关 + 主进程状态，与开始页按钮同步 |
+| 用量 | 区间概览（今天 / 近 7 天 / 近 30 天）、按模型聚合、积分包明细、限时优惠清单、最近调用；带「刷新余额」「清空本地账本」 |
+
+### 倍率与限时优惠怎么算
+
+- 目录来自 `GET /v3/config`（应用身份 UA）：一次同时拿到 `models`、`modelPromotions`、`modelTiers`。
+  用 CLI 身份只能读到精简目录，促销字段会整段缺失——这是「倍率永远显示原价」的根因。
+- 一条促销的生效条件是 `schedule`：`timezone`（默认按条目给的时区算）、`validFrom`/`validUntil`、
+  `daily` 时段（支持 `23:00`→`07:50` 这类跨零点窗口）。命中的条目按 `priority` 取最高；平手时促销优先于档位。
+- `discount.discountedCredits`（如 `0.50x`）**就是生效倍率本身**，不是相对原价的系数。
+  `displayMode: "replace"` 直接替换显示，`"strikethrough"` 表示「划线原价 + 新价」并排。
+- `badge.display: "activeOnly"` 的徽标只在生效时段出现（如「限时免费」试用）。
+
+### 用量统计口径
+
+- 每次 `wb_chat` 记一行到 `%APPDATA%\..\Coopanion\data\home\companion\data\workbuddy-usage.jsonl`
+  （实机路径；实际就是 `ctx.dataDir`）：`ts/model/region/ok/promptTokens/completionTokens/totalTokens/cachedTokens/reasoningTokens/credit/multiplier/promoId/source/durationMs`。
+- `credit` 取 SSE 最后一段的 `usage.credit`，即**上游真实扣费**；倍率 0.11 的模型单次请求不足 1 分时上游就是 0，这里照抄不折算。
+- 积分包余额另存 `workbuddy-balance.json`（`POST /v2/billing/meter/get-user-resource` 的 `*Precise` 字段求和），
+  面板上的「刷新余额」会重取一次。
+- 账本只保留 90 天，读的时候顺带裁掉；「清空本地账本」会把它清成空文件，服务端数据不受影响。
 
 ## 工具（给 Coo / 模型调用）
 
 | 工具 | 作用 |
 |---|---|
-| `wb_list_models` | 列出目录中全部模型及各自默认积分倍率（只读） |
-| `wb_select_model` | 按 id 选择 `wb_chat` 的默认模型，持久化 |
-| `wb_chat` | 用选中模型回答一个单轮问题（**真实消耗积分**，需主进程在跑） |
-| `wb_credits` | 只读查询积分余额（需主进程在跑） |
+| `wb_list_models` | 列出目录中全部模型及**此刻倍率**（含限时优惠与时段），并单列优惠清单（只读） |
+| `wb_select_model` | 按 id 选择 `wb_chat` 的默认模型，持久化；提示此刻倍率 |
+| `wb_chat` | 用选中模型回答一个单轮问题（**真实消耗积分**，需主进程在跑）；回执附输入/输出/缓存 token 与本次积分 |
+| `wb_credits` | 只读查询积分余额与本周期已用（需主进程在跑） |
 
 ## 配置（`worlds.workbuddy.*`）
 

package/describe.json

@@ -98,5 +98,5 @@
       }
     }
   ],
-  "envPrompt": "## WorkBuddy bridge\n\nThis machine has a WorkBuddy desktop sign-in bridged in (region: {{workbuddy.region}}; signed in: {{workbuddy.authed}}).\nThe model catalog holds {{workbuddy.catalogSize}} models. The currently selected model is `{{workbuddy.model}}` with default credit multiplier {{workbuddy.multiplier}}.\nWorkBuddy desktop main process: {{workbuddy.process}}. Relay-first switch: {{workbuddy.priority}}.\n\n- Use `wb_list_models` to see every model with its multiplier before choosing; prefer low-multiplier models for casual tasks.\n- Use `wb_select_model` when the user asks to switch the WorkBuddy model.\n- `wb_chat` only works while the WorkBuddy desktop main process is running; otherwise it returns「未检测到 WorkBuddy 主进程」. Every call spends the user's own credits at that model's multiplier.\n- `wb_credits` is read-only and costs nothing (also requires the desktop process).\n\n### Relay first: {{workbuddy.priority}}\n\n- Switch `on` **and** process `running`: every user turn that expects a conversational answer (question, chat, writing, reasoning, rewrite, translation, summary) must be answered by a WorkBuddy model first — call `wb_chat` (omit `model` to use `{{workbuddy.model}}`), then speak the returned answer back in your own voice and name the model that answered. Only fall back to your own model if the call fails.\n- Switch `off` (default): do not call `wb_chat`; answer with your own model. If the user explicitly asks for WorkBuddy, `wb_chat` is still allowed — the desktop process must be running.\n- Tool errors and empty answers are not a reason to flip the switch; just say what happened.\n"
+  "envPrompt": "## WorkBuddy bridge\n\nThis machine has a WorkBuddy desktop sign-in bridged in (region: {{workbuddy.region}}; signed in: {{workbuddy.authed}}).\nThe model catalog holds {{workbuddy.catalogSize}} models. The currently selected model is `{{workbuddy.model}}` with default credit multiplier {{workbuddy.multiplier}}.\nWorkBuddy desktop main process: {{workbuddy.process}}. Relay-first switch: {{workbuddy.priority}}.\nSpent today through the bridge: {{workbuddy.todayCredit}} credits / {{workbuddy.todayTokens}} tokens (locally recorded).\nThe multiplier above already includes any time-limited discount or free window that is active right now; `wb_list_models` also marks which offers are active and their hours.\n\n- Use `wb_list_models` to see every model with its multiplier before choosing; prefer low-multiplier models for casual tasks.\n- Use `wb_select_model` when the user asks to switch the WorkBuddy model.\n- `wb_chat` only works while the WorkBuddy desktop main process is running; otherwise it returns「未检测到 WorkBuddy 主进程」. Every call spends the user's own credits at that model's multiplier.\n- `wb_credits` is read-only and costs nothing (also requires the desktop process).\n\n### Relay first: {{workbuddy.priority}}\n\n- Switch `on` **and** process `running`: every user turn that expects a conversational answer (question, chat, writing, reasoning, rewrite, translation, summary) must be answered by a WorkBuddy model first — call `wb_chat` (omit `model` to use `{{workbuddy.model}}`), then speak the returned answer back in your own voice and name the model that answered. Only fall back to your own model if the call fails.\n- Switch `off` (default): do not call `wb_chat`; answer with your own model. If the user explicitly asks for WorkBuddy, `wb_chat` is still allowed — the desktop process must be running.\n- Tool errors and empty answers are not a reason to flip the switch; just say what happened.\n"
 }

package/dist/webui.js

@@ -48,7 +48,36 @@ var TEXT = {
     repair: "\u91CD\u65B0\u6CE8\u5165\u5F00\u59CB\u9875\u6309\u94AE",
     repairing: "\u6B63\u5728\u91CD\u65B0\u6CE8\u5165\u2026",
     repaired: "\u5DF2\u4FEE\u590D\uFF0C\u91CD\u65B0\u6253\u5F00\u63A7\u5236\u53F0\u5373\u53EF\u770B\u5230\u6309\u94AE",
-    repairFail: "\u4FEE\u590D\u5931\u8D25"
+    repairFail: "\u4FEE\u590D\u5931\u8D25",
+    usageTitle: "\u7528\u91CF",
+    usageDesc: "\u672C\u673A\u8BB0\u8D26\u7684\u8C03\u7528\u7528\u91CF\u4E0E WorkBuddy \u79EF\u5206\u5305\u4F59\u989D\u3002\u79EF\u5206\u53D6\u4E0A\u6E38\u6BCF\u6B21\u8C03\u7528\u56DE\u4F20\u7684\u771F\u5B9E\u6263\u8D39\uFF08\u53EF\u80FD\u4E3A 0\uFF09\uFF0C\u500D\u7387\u6309\u76EE\u5F55 + \u9650\u65F6\u4F18\u60E0\u5B9E\u65F6\u8BA1\u7B97\u3002",
+    usageRefresh: "\u5237\u65B0\u4F59\u989D",
+    usageClear: "\u6E05\u7A7A\u672C\u5730\u8D26\u672C",
+    usageCleared: "\u672C\u5730\u8D26\u672C\u5DF2\u6E05\u7A7A",
+    metricCalls: "\u8C03\u7528",
+    metricCredit: "\u79EF\u5206",
+    metricInput: "\u8F93\u5165 tok",
+    metricOutput: "\u8F93\u51FA tok",
+    spanToday: "\u4ECA\u5929",
+    spanWeek: "\u8FD1 7 \u5929",
+    spanMonth: "\u8FD1 30 \u5929",
+    byModel: "\u6309\u6A21\u578B",
+    balanceTitle: "\u79EF\u5206\u5305\u4F59\u989D",
+    colPkgName: "\u79EF\u5206\u5305",
+    colPkgRemain: "\u5269\u4F59",
+    colPkgUsed: "\u5DF2\u7528",
+    colPkgCycle: "\u5468\u671F",
+    promosTitle: "\u9650\u65F6\u4F18\u60E0 / \u514D\u8D39",
+    promoActive: "\u751F\u6548\u4E2D",
+    promoSoon: "\u672A\u751F\u6548",
+    recentTitle: "\u6700\u8FD1\u8C03\u7528",
+    colTime: "\u65F6\u95F4",
+    colTokens: "token",
+    colDuration: "\u8017\u65F6",
+    noData: "\u6682\u65E0\u6570\u636E",
+    totalCredit: "\u5408\u8BA1\u79EF\u5206",
+    todayCredit: "\u4ECA\u65E5\u79EF\u5206",
+    todayTokens: "\u4ECA\u65E5 token"
   },
   en: {
     refresh: "Refresh from WorkBuddy",
@@ -98,16 +127,55 @@ var TEXT = {
     repair: "Re-inject the home button",
     repairing: "Re-injecting\u2026",
     repaired: "Fixed. Reopen the console to see the button",
-    repairFail: "Repair failed"
+    repairFail: "Repair failed",
+    usageTitle: "Usage",
+    usageDesc: "Locally recorded call usage plus the WorkBuddy credit balance. Credits come from the per-call figure the upstream returns (may be 0); multipliers combine the catalog with time-limited offers in real time.",
+    usageRefresh: "Refresh balance",
+    usageClear: "Clear local ledger",
+    usageCleared: "Local ledger cleared",
+    metricCalls: "Calls",
+    metricCredit: "Credits",
+    metricInput: "Input tok",
+    metricOutput: "Output tok",
+    spanToday: "Today",
+    spanWeek: "Last 7 days",
+    spanMonth: "Last 30 days",
+    byModel: "By model",
+    balanceTitle: "Credit packages",
+    colPkgName: "Package",
+    colPkgRemain: "Remaining",
+    colPkgUsed: "Used",
+    colPkgCycle: "Cycle",
+    promosTitle: "Limited-time offers / free",
+    promoActive: "active",
+    promoSoon: "scheduled",
+    recentTitle: "Recent calls",
+    colTime: "Time",
+    colTokens: "tokens",
+    colDuration: "Latency",
+    noData: "No data",
+    totalCredit: "Total credits",
+    todayCredit: "Credits today",
+    todayTokens: "Tokens today"
   }
 };
 function strings(ctx) {
   return TEXT[ctx.language === "en" ? "en" : "zh"];
 }
 function fmtMultiplier(m, s) {
-  if (typeof m.creditMultiplier !== "number") return { text: "\u2014", free: false };
-  if (m.creditMultiplier === 0) return { text: `x0 \xB7 ${s.multiplierFree}`, free: true };
-  return { text: `x${m.creditMultiplier}`, free: false };
+  const price = m?.price;
+  const base = typeof price?.base === "number" ? price.base : typeof m?.creditMultiplier === "number" ? m.creditMultiplier : null;
+  const eff = typeof price?.effective === "number" ? price.effective : base;
+  if (base === null) return { text: "\u2014", free: false, promo: "" };
+  if (eff === 0) return { text: `x0 \xB7 ${s.multiplierFree}${price?.windowText ? ` ${price.windowText}` : ""}`, free: true, promo: price?.badge ?? "" };
+  if (typeof eff === "number" && eff < base) {
+    return {
+      text: `x${eff} \u2190 x${base}${price?.windowText ? ` ${price.windowText}` : ""}`,
+      free: false,
+      promo: price?.badge ?? ""
+    };
+  }
+  return { text: `x${base}`, free: false, promo: price?.badge ?? "" };
 }
 function fmtTs(ms, s) {
   if (!ms) return s.notRefreshed;
@@ -157,6 +225,7 @@ function mountModels(ctx) {
       nameCell.append(sub);
       if (m.description) nameCell.title = m.description;
       const mulPill = ui.pill(mul.text, mul.free ? "on" : "plain");
+      if (mul.promo) mulPill.title = mul.promo;
       const btn = ui.button(isCurrent ? s.selected : s.select, {
         size: "sm",
         variant: isCurrent ? "plain" : "primary",
@@ -387,11 +456,168 @@ function mountPriority(ctx) {
     statusLine.textContent = String(err?.message ?? err);
   });
 }
+function fmtNum(n) {
+  if (typeof n !== "number" || !Number.isFinite(n)) return "\u2014";
+  return String(Math.round(n * 100) / 100);
+}
+function mountUsage(ctx) {
+  const s = strings(ctx);
+  const { ui } = ctx;
+  const sheet = ui.sheet({ title: `${s.usageTitle} \xB7 WorkBuddy`, desc: s.usageDesc });
+  ctx.root.append(sheet.el);
+  const bar = ui.rowbar();
+  const refreshBtn = ui.button(s.usageRefresh, { variant: "primary", size: "sm" });
+  const clearBtn = ui.button(s.usageClear, { variant: "plain", size: "sm" });
+  const todayChip = ui.chip("", "accent");
+  const balanceChip = ui.chip("", "plain");
+  bar.append(refreshBtn, clearBtn, todayChip, balanceChip);
+  sheet.body.append(bar);
+  const errLine = ui.msgline();
+  sheet.body.append(errLine);
+  const overview = ui.table({
+    head: ["", s.metricCalls, s.metricCredit, s.metricInput, s.metricOutput],
+    maxHeight: "220px"
+  });
+  sheet.body.append(overview.el);
+  const modelSection = ui.section(s.byModel);
+  const modelTable = ui.table({
+    head: [s.colModel, s.metricCalls, s.metricCredit, s.metricInput, s.metricOutput],
+    maxHeight: "260px"
+  });
+  modelSection.append(modelTable.el);
+  sheet.body.append(modelSection);
+  const pkgSection = ui.section(s.balanceTitle);
+  const pkgTable = ui.table({
+    head: [s.colPkgName, s.colPkgRemain, s.colPkgUsed, s.colPkgCycle],
+    maxHeight: "220px"
+  });
+  pkgSection.append(pkgTable.el);
+  sheet.body.append(pkgSection);
+  const promoSection = ui.section(s.promosTitle);
+  const promoWrap = ui.h("div");
+  promoSection.append(promoWrap);
+  sheet.body.append(promoSection);
+  const recentSection = ui.section(s.recentTitle);
+  const recentTable = ui.table({
+    head: [s.colTime, s.colModel, s.colTokens, s.metricCredit, s.colDuration],
+    maxHeight: "300px"
+  });
+  recentSection.append(recentTable.el);
+  sheet.body.append(recentSection);
+  let state = null;
+  function spanRow(label, bucket) {
+    const b = bucket ?? {};
+    return [label, String(b.calls ?? 0), fmtNum(b.credit), fmtNum(b.prompt), fmtNum(b.completion)];
+  }
+  function render() {
+    const totals = state?.summary?.totals ?? {};
+    todayChip.textContent = `${s.todayCredit}: ${fmtNum(totals.today?.credit)} \xB7 ${s.todayTokens}: ${fmtNum(
+      (totals.today?.prompt ?? 0) + (totals.today?.completion ?? 0)
+    )}`;
+    balanceChip.textContent = `${s.balanceTitle}: ${fmtNum(state?.balance?.total)}`;
+    const spans = [spanRow(s.spanToday, totals.today), spanRow(s.spanWeek, totals.week), spanRow(s.spanMonth, totals.month)];
+    overview.clear();
+    for (const row of spans) overview.addRow(row);
+    const byModel = state?.summary?.byModel ?? [];
+    modelTable.clear(byModel.length > 0 ? void 0 : s.noData);
+    for (const m of byModel) {
+      modelTable.addRow([m.model, String(m.calls ?? 0), fmtNum(m.credit), fmtNum(m.prompt), fmtNum(m.completion)]);
+    }
+    const packages = state?.balance?.packages ?? [];
+    pkgTable.clear(packages.length > 0 ? void 0 : s.noData);
+    for (const p of packages) {
+      const cycle = [p.cycleStart, p.cycleEnd].filter(Boolean).join(" \u2192 ") || "\u2014";
+      pkgTable.addRow([p.name ?? "\u2014", fmtNum(p.remain), fmtNum(p.used), cycle]);
+    }
+    promoWrap.replaceChildren();
+    const promos = state?.promos ?? [];
+    if (promos.length === 0) {
+      promoWrap.append(ui.h("div", "dim", s.noData));
+    }
+    for (const p of promos) {
+      const row = ui.h("div");
+      row.style.display = "flex";
+      row.style.gap = "8px";
+      row.style.alignItems = "center";
+      row.style.padding = "4px 0";
+      row.append(ui.pill(p.badge || p.id, p.active ? "on" : "plain"));
+      const text = [
+        p.discountText || p.hoverText,
+        p.windowText || p.absoluteText,
+        (p.models ?? []).join(" / "),
+        p.active ? s.promoActive : s.promoSoon
+      ].filter(Boolean).join(" \xB7 ");
+      const label = ui.h("div", "dim", text);
+      label.style.fontSize = "12px";
+      if (p.hoverText) label.title = p.hoverText;
+      row.append(label);
+      promoWrap.append(row);
+    }
+    const recent = state?.summary?.recent ?? [];
+    recentTable.clear(recent.length > 0 ? void 0 : s.noData);
+    for (const r of recent) {
+      const when = (() => {
+        try {
+          return new Date(r.ts).toLocaleString();
+        } catch {
+          return String(r.ts);
+        }
+      })();
+      recentTable.addRow([
+        when,
+        r.model ?? "\u2014",
+        fmtNum(r.totalTokens ?? (r.promptTokens ?? 0) + (r.completionTokens ?? 0)),
+        r.ok === false ? "\u2014" : fmtNum(r.credit),
+        typeof r.durationMs === "number" ? `${r.durationMs} ms` : "\u2014"
+      ]);
+    }
+  }
+  async function load() {
+    state = await ctx.invoke("state");
+    errLine.textContent = state?.ok === false ? state.error ?? "" : "";
+    render();
+  }
+  refreshBtn.addEventListener("click", async () => {
+    const off = ui.disable(refreshBtn);
+    refreshBtn.textContent = s.refreshing;
+    try {
+      state = await ctx.invoke("refresh");
+      render();
+      ui.toast(`${s.balanceTitle}: ${fmtNum(state?.balance?.total)}`);
+    } catch (err) {
+      errLine.textContent = String(err?.message ?? err);
+      ui.toast(String(err?.message ?? err), "bad");
+    } finally {
+      refreshBtn.textContent = s.usageRefresh;
+      off.dispose();
+    }
+  });
+  clearBtn.addEventListener("click", async () => {
+    const off = ui.disable(clearBtn);
+    try {
+      state = await ctx.invoke("clear");
+      render();
+      ui.toast(s.usageCleared);
+    } catch (err) {
+      ui.toast(String(err?.message ?? err), "bad");
+    } finally {
+      off.dispose();
+    }
+  });
+  ctx.stream({
+    message: () => load().catch(() => {
+    })
+  });
+  load().catch((err) => {
+    errLine.textContent = String(err?.message ?? err);
+  });
+}
 var client_default = {
   panels: {
     models: { mount: mountModels },
     account: { mount: mountAccount },
-    priority: { mount: mountPriority }
+    priority: { mount: mountPriority },
+    usage: { mount: mountUsage }
   }
 };
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cortico-world-workbuddy",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "type": "module",
   "description": "把 Windows 端已登录的 WorkBuddy 客户端模型桥接进 Coopanion：读取本机登录态，列出模型目录与默认积分倍率，供 Coo 调用。",
   "license": "MIT",

package/scripts/verify-ui.mjs

@@ -341,6 +341,21 @@ for (let run = 1; run <= RUNS; run += 1) {
       return dom === false && api.prefer === false ? true : false;
     });
     row.checks.panelToggleOff = true;
+    // --- 用量面板：页签 → 渲染 → 概览表有行 ---
+    await evaluate(clickByText('用量'));
+    const usage = await waitFor('用量面板渲染', async () => {
+      const v = await evaluate(`(() => {
+        const btn = [...document.querySelectorAll('button')].find((b) => b.textContent.trim() === '刷新余额' && b.offsetParent !== null);
+        const chip = [...document.querySelectorAll('*')].find((n) => n.children.length === 0 && (n.textContent || '').startsWith('今日积分'));
+        const rows = document.querySelectorAll('table tr').length;
+        return { hasRefresh: !!btn, chip: (chip?.textContent || '').trim(), rows };
+      })()`);
+      return v.hasRefresh && v.rows >= 4 ? v : false;
+    });
+    row.checks.usageRendered = usage.hasRefresh === true;
+    row.checks.usageRows = usage.rows;
+    row.checks.usageChip = usage.chip;
+    if (SHOTS && run === 1) { await sleep(300); await shot('world-usage'); }
     if (KEEP) await shot(`run${run}-world`);
     void pane;
   } catch (err) {

package/src/ENV_PROMPT.md

@@ -3,6 +3,8 @@
 This machine has a WorkBuddy desktop sign-in bridged in (region: {{workbuddy.region}}; signed in: {{workbuddy.authed}}).
 The model catalog holds {{workbuddy.catalogSize}} models. The currently selected model is `{{workbuddy.model}}` with default credit multiplier {{workbuddy.multiplier}}.
 WorkBuddy desktop main process: {{workbuddy.process}}. Relay-first switch: {{workbuddy.priority}}.
+Spent today through the bridge: {{workbuddy.todayCredit}} credits / {{workbuddy.todayTokens}} tokens (locally recorded).
+The multiplier above already includes any time-limited discount or free window that is active right now; `wb_list_models` also marks which offers are active and their hours.
 
 - Use `wb_list_models` to see every model with its multiplier before choosing; prefer low-multiplier models for casual tasks.
 - Use `wb_select_model` when the user asks to switch the WorkBuddy model.