@rayadesu/dsh-client-ui-billing 0.1.0-rc.8 → 0.2.0

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # last confirmed-consistent state. Both languages carry equal authority; after
 # editing either side, bring the other along and re-record both hashes with:
 #   git hash-object README.md README.zh.md
-README.md: 509fb81169ba38ef35a3a364eb88765456143443
-README.zh.md: 19fa2ed3c3f4692c60945c614c44c5b832075100
+README.md: 8672854e338576b027810cbfe8bf1a976ffa0824
+README.zh.md: 6c7e0cbd95094d437535def3f2d5d01d5bc98f6c

package/README.md

@@ -4,7 +4,7 @@ English | [中文](README.zh.md)
 
 Web billing feature owner: contributes one entry to `conversation.session.header.utilities` that mounts its own `billing` Remote, reads the DeepSeek account balance, this session's billed spend, and today's spend across every session through `billing/getBalance`, `billing/getSessionSpend`, and `billing/getTodaySpend`, and renders them as a top-right label box. The host half of the capability lives in [`dsh-llm-billing`](../llm-billing/README.md), which owns the `/user/balance` transport, the peak/off-peak pricing table, and the `billing` Remote namespace; this package mounts that Remote and renders what it returns.
 
-The trigger shows two lines — the remaining balance and this conversation's billed spend ("本轮对话花费 ¥X") — and renders nothing while the first fetch is in flight. Clicking it opens a label box with the remaining amount, this session's billed spend (本会话花费, priced per message at the official peak/off-peak rate) with today's all-session spend beside it (今日共花费), one priced row per model with the cache-hit / cache-miss-input / output cost breakdown ("缓存命中 ¥X · 未命中输入 ¥Y · 输出 ¥Z"), a manual refresh action, and a spend disclaimer. Refreshing keeps the last values visible rather than blanking them, and a refresh failure retains the last good value. A session or day without priced usage shows a "no usage recorded" word rather than a fabricated figure. A failure — no API key configured, a rejected credential, a transport error — renders a muted "Balance unavailable" word whose tooltip carries the Remote's own error message.
+The trigger shows two lines — the remaining balance and this conversation's billed spend ("本轮对话花费 ¥X") — and renders nothing while the first fetch is in flight. Clicking it opens a label box with the remaining amount, this session's billed spend (本会话花费, priced per message at the official peak/off-peak rate — peak windows apply weekdays Mon–Fri only, weekends are off-peak) with today's all-session spend beside it (今日共花费), one priced row per model with the cache-hit / cache-miss-input / output cost breakdown ("缓存命中 ¥X · 未命中输入 ¥Y · 输出 ¥Z"), a manual refresh action, and a spend disclaimer. Refreshing keeps the last values visible rather than blanking them, and a refresh failure retains the last good value. A session or day without priced usage shows a "no usage recorded" word rather than a fabricated figure. A failure — no API key configured, a rejected credential, a transport error — renders a muted "Balance unavailable" word whose tooltip carries the Remote's own error message.
 
 The badge is account-level even though the slot is session-scoped: the header utilities row is simply the one always-visible title-bar seat the shell offers, and the balance it shows does not vary by session — but the spend lines do, because they price the current session's own token usage through `billing/getSessionSpend` and every session's usage through `billing/getTodaySpend`. Copy goes through the package's own `billing` locale namespace; styling uses tokens only.
 
@@ -12,9 +12,9 @@ The badge is account-level even though the slot is session-scoped: the header ut
 
 The spends follow the conversation and the balance stays a manual snapshot:
 
-- **Spends follow new messages** — the component subscribes to the current session's message count through the framework `useSession` seat. When a new message lands, it recomputes this session's spend (`billing/getSessionSpend`) and today's spend (`billing/getTodaySpend`), local pricing passes with no network request, so the spend lines stay live during an ongoing conversation.
+- **Spends follow new messages, debounced** — the component subscribes to the current session's message count through the framework `useSession` seat. When a new message lands, it recomputes this session's spend (`billing/getSessionSpend`) and today's spend (`billing/getTodaySpend`), local pricing passes with no network request, so the spend lines stay live during an ongoing conversation. The recompute is debounced for two seconds, so a burst of messages (a streaming agent turn) prices once instead of once per message; the host-side cache (see `dsh-llm-billing`) then serves the first miss for the rest of the minute.
 - **Balance is manual** — the account balance is fetched on mount, on session switch, and on the explicit refresh action (`billing/getBalance`). There is no polling and no automatic refetch: the balance line only changes when one of those events happens.
-- **Refresh keeps the last values** — an in-flight refresh leaves the previous values on screen, and a failed refresh retains the last good value instead of blanking it.
+- **Refresh keeps the last values** — an in-flight refresh leaves the previous values on screen, and a failed refresh retains the last good value instead of blanking it. The refresh action calls `billing/getTodaySpend(true)`, which bypasses the host-side cache; the message-triggered recompute and the mount/session-switch read use the cached path.
 
 ## Model Experience
 

package/README.zh.md

@@ -4,7 +4,7 @@
 
 Web 额度特性的归属方：向 `conversation.session.header.utilities` 贡献一个条目，自己挂载 `billing` Remote，通过 `billing/getBalance`、`billing/getSessionSpend` 与 `billing/getTodaySpend` 读取 DeepSeek 账户余额、本会话的计费花费与今日所有会话的计费花费，并在右上角渲染成一个标签框。该能力的宿主侧在 [`dsh-llm-billing`](../llm-billing/README.md)，它拥有 `/user/balance` 传输、峰谷计价表与 `billing` Remote 命名空间；本包挂载那个 Remote 并渲染它返回的内容。
 
-触发器显示两行——剩余额度与本轮对话的计费花费（「本轮对话花费 ¥X」）——首个请求在途时不渲染任何东西。点击后展开一个标签框：剩余金额、本会话的计费花费（本会话花费，按官方峰/谷单价逐条消息计价，右侧并列今日所有会话的合计「今日共花费」）、每个模型一行的花费及其缓存命中/未命中输入/输出分项（「缓存命中 ¥X · 未命中输入 ¥Y · 输出 ¥Z」）、手动刷新按钮与花费说明。刷新时旧值不消失，刷新失败保留上一次有效值。没有可计价消耗的会话或日子显示「暂无消耗记录」而不是编造数字。失败——未配置 API key、凭据被拒绝、传输错误——渲染弱化的「额度不可用」，其提示携带 Remote 自己的错误信息。
+触发器显示两行——剩余额度与本轮对话的计费花费（「本轮对话花费 ¥X」）——首个请求在途时不渲染任何东西。点击后展开一个标签框：剩余金额、本会话的计费花费（本会话花费，按官方峰/谷单价逐条消息计价——高峰窗口仅周一至周五适用，周末按低谷价——右侧并列今日所有会话的合计「今日共花费」）、每个模型一行的花费及其缓存命中/未命中输入/输出分项（「缓存命中 ¥X · 未命中输入 ¥Y · 输出 ¥Z」）、手动刷新按钮与花费说明。刷新时旧值不消失，刷新失败保留上一次有效值。没有可计价消耗的会话或日子显示「暂无消耗记录」而不是编造数字。失败——未配置 API key、凭据被拒绝、传输错误——渲染弱化的「额度不可用」，其提示携带 Remote 自己的错误信息。
 
 角标是账户级的，尽管插槽是会话作用域：顶栏工具行不过是外壳提供的那个始终可见的标题栏席位，余额并不随会话变化——但花费行会，因为它通过 `billing/getSessionSpend` 按当前会话自己的 token 用量计价、通过 `billing/getTodaySpend` 按所有会话的用量计价。文案走本包自己的 `billing` locale 命名空间；样式只用 token。
 
@@ -12,9 +12,9 @@ Web 额度特性的归属方：向 `conversation.session.header.utilities` 贡
 
 花费跟随会话、额度保持手动快照：
 
-- **花费随新消息自动更新** —— 组件通过框架 `useSession` 座位订阅当前会话的消息数。每到达一条新消息，就只重算**本会话的花费**（`billing/getSessionSpend`）与**今日共花费**（`billing/getTodaySpend`，纯本地计价、不发网络请求），连续对话时花费行实时跟随。
+- **花费随新消息自动更新（去抖）** —— 组件通过框架 `useSession` 座位订阅当前会话的消息数。每到达一条新消息，就只重算**本会话的花费**（`billing/getSessionSpend`）与**今日共花费**（`billing/getTodaySpend`，纯本地计价、不发网络请求），连续对话时花费行实时跟随。重算有 2 秒去抖，消息突发（流式 agent 回合）只计价一次；宿主侧缓存（见 `dsh-llm-billing`）随后在一分钟内服务首次未命中。
 - **额度保持手动** —— 账户余额在挂载、切换会话、点刷新按钮时拉取（`billing/getBalance`）。**没有轮询、不会自动重拉**：余额行只在这几个时机变化。
-- **刷新保留旧值** —— 刷新在途时旧值留在屏幕上，刷新失败保留上一次有效值，不清空。
+- **刷新保留旧值** —— 刷新在途时旧值留在屏幕上，刷新失败保留上一次有效值，不清空。刷新按钮调用 `billing/getTodaySpend(true)`，绕过宿主侧缓存；消息触发的重算与挂载/切换会话的读取走缓存路径。
 
 ## 模型体验
 

package/lib/client.js

@@ -613,6 +613,7 @@ window.__ModuleLoader__.load({
 		const integer = /^-?\d+$/;
 		const number$1 = /^-?\d+(?:\.\d+)?$/;
 		const boolean$1 = /^(?:true|false)$/i;
+		const _undefined$2 = /^undefined$/i;
 		const lowercase = /^[^A-Z]*$/;
 		const uppercase = /^[^a-z]*$/;
 		//#endregion
@@ -1425,6 +1426,22 @@ window.__ModuleLoader__.load({
 				return payload;
 			};
 		});
+		const $ZodUndefined = /*@__PURE__*/ $constructor("$ZodUndefined", (inst, def) => {
+			$ZodType.init(inst, def);
+			inst._zod.pattern = _undefined$2;
+			inst._zod.values = new Set([void 0]);
+			inst._zod.parse = (payload, _ctx) => {
+				const input = payload.value;
+				if (typeof input === "undefined") return payload;
+				payload.issues.push({
+					expected: "undefined",
+					code: "invalid_type",
+					input,
+					inst
+				});
+				return payload;
+			};
+		});
 		const $ZodUnknown = /*@__PURE__*/ $constructor("$ZodUnknown", (inst, def) => {
 			$ZodType.init(inst, def);
 			inst._zod.parse = (payload) => payload;
@@ -1886,6 +1903,24 @@ window.__ModuleLoader__.load({
 				return payload;
 			};
 		});
+		const $ZodLiteral = /*@__PURE__*/ $constructor("$ZodLiteral", (inst, def) => {
+			$ZodType.init(inst, def);
+			if (def.values.length === 0) throw new Error("Cannot create literal schema with no valid values");
+			const values = new Set(def.values);
+			inst._zod.values = values;
+			inst._zod.pattern = new RegExp(`^(${def.values.map((o) => typeof o === "string" ? escapeRegex(o) : o ? escapeRegex(o.toString()) : String(o)).join("|")})$`);
+			inst._zod.parse = (payload, _ctx) => {
+				const input = payload.value;
+				if (values.has(input)) return payload;
+				payload.issues.push({
+					code: "invalid_value",
+					values: def.values,
+					input,
+					inst
+				});
+				return payload;
+			};
+		});
 		const $ZodTransform = /*@__PURE__*/ $constructor("$ZodTransform", (inst, def) => {
 			$ZodType.init(inst, def);
 			inst._zod.optin = "optional";
@@ -2464,6 +2499,13 @@ window.__ModuleLoader__.load({
 			});
 		}
 		// @__NO_SIDE_EFFECTS__
+		function _undefined$1(Class, params) {
+			return new Class({
+				type: "undefined",
+				...normalizeParams(params)
+			});
+		}
+		// @__NO_SIDE_EFFECTS__
 		function _unknown(Class) {
 			return new Class({ type: "unknown" });
 		}
@@ -3012,6 +3054,9 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		const booleanProcessor = (_schema, _ctx, json, _params) => {
 			json.type = "boolean";
 		};
+		const undefinedProcessor = (_schema, ctx, _json, _params) => {
+			if (ctx.unrepresentable === "throw") throw new Error("Undefined cannot be represented in JSON Schema");
+		};
 		const neverProcessor = (_schema, _ctx, json, _params) => {
 			json.not = {};
 		};
@@ -3022,6 +3067,27 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			if (values.every((v) => typeof v === "string")) json.type = "string";
 			json.enum = values;
 		};
+		const literalProcessor = (schema, ctx, json, _params) => {
+			const def = schema._zod.def;
+			const vals = [];
+			for (const val of def.values) if (val === void 0) {
+				if (ctx.unrepresentable === "throw") throw new Error("Literal `undefined` cannot be represented in JSON Schema");
+			} else if (typeof val === "bigint") if (ctx.unrepresentable === "throw") throw new Error("BigInt literals cannot be represented in JSON Schema");
+			else vals.push(Number(val));
+			else vals.push(val);
+			if (vals.length === 0) {} else if (vals.length === 1) {
+				const val = vals[0];
+				json.type = val === null ? "null" : typeof val;
+				if (ctx.target === "draft-04" || ctx.target === "openapi-3.0") json.enum = [val];
+				else json.const = val;
+			} else {
+				if (vals.every((v) => typeof v === "number")) json.type = "number";
+				if (vals.every((v) => typeof v === "string")) json.type = "string";
+				if (vals.every((v) => typeof v === "boolean")) json.type = "boolean";
+				if (vals.every((v) => v === null)) json.type = "null";
+				json.enum = vals;
+			}
+		};
 		const customProcessor = (_schema, ctx, _json, _params) => {
 			if (ctx.unrepresentable === "throw") throw new Error("Custom types cannot be represented in JSON Schema");
 		};
@@ -3648,6 +3714,14 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		function boolean(params) {
 			return /* @__PURE__ */ _boolean(ZodBoolean, params);
 		}
+		const ZodUndefined = /*@__PURE__*/ $constructor("ZodUndefined", (inst, def) => {
+			$ZodUndefined.init(inst, def);
+			ZodType.init(inst, def);
+			inst._zod.processJSONSchema = (ctx, json, params) => undefinedProcessor(inst, ctx, json, params);
+		});
+		function _undefined(params) {
+			return /* @__PURE__ */ _undefined$1(ZodUndefined, params);
+		}
 		const ZodUnknown = /*@__PURE__*/ $constructor("ZodUnknown", (inst, def) => {
 			$ZodUnknown.init(inst, def);
 			ZodType.init(inst, def);
@@ -3823,6 +3897,23 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 				...normalizeParams(params)
 			});
 		}
+		const ZodLiteral = /*@__PURE__*/ $constructor("ZodLiteral", (inst, def) => {
+			$ZodLiteral.init(inst, def);
+			ZodType.init(inst, def);
+			inst._zod.processJSONSchema = (ctx, json, params) => literalProcessor(inst, ctx, json, params);
+			inst.values = new Set(def.values);
+			Object.defineProperty(inst, "value", { get() {
+				if (def.values.length > 1) throw new Error("This schema contains multiple valid literal values. Use `.values` instead.");
+				return def.values[0];
+			} });
+		});
+		function literal(value, params) {
+			return new ZodLiteral({
+				type: "literal",
+				values: Array.isArray(value) ? value : [value],
+				...normalizeParams(params)
+			});
+		}
 		const ZodTransform = /*@__PURE__*/ $constructor("ZodTransform", (inst, def) => {
 			$ZodTransform.init(inst, def);
 			ZodType.init(inst, def);
@@ -3990,7 +4081,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		}
 		//#endregion
 		//#region ../../llm/llm-billing/lib/typert.remote-client.js
-		const _deepseek_ai_dsh_llm_billing_billing_getBalance_result$schema = object({
+		const _rayadesu_dsh_llm_billing_billing_getBalance_result$schema = object({
 			"isAvailable": boolean(),
 			"lines": array(object({
 				"currency": string(),
@@ -3999,8 +4090,8 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 				"toppedUp": string()
 			}))
 		});
-		const _deepseek_ai_dsh_llm_billing_billing_getSessionSpend_parameter_0$schema = intersection(string(), unknown());
-		const _deepseek_ai_dsh_llm_billing_billing_getSessionSpend_result$schema = object({
+		const _rayadesu_dsh_llm_billing_billing_getSessionSpend_parameter_0$schema = intersection(string(), unknown());
+		const _rayadesu_dsh_llm_billing_billing_getSessionSpend_result$schema = object({
 			"total": number(),
 			"models": array(object({
 				"model": string(),
@@ -4016,7 +4107,12 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 				"outputCost": number()
 			}))
 		});
-		const _deepseek_ai_dsh_llm_billing_billing_getTodaySpend_result$schema = object({
+		const _rayadesu_dsh_llm_billing_billing_getTodaySpend_parameter_0$schema = union([
+			_undefined(),
+			literal(false),
+			literal(true)
+		]);
+		const _rayadesu_dsh_llm_billing_billing_getTodaySpend_result$schema = object({
 			"total": number(),
 			"models": array(object({
 				"model": string(),
@@ -4045,11 +4141,11 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					result: {
 						mode: "strict",
 						typeSymbol: "@rayadesu/dsh-llm-billing/types#DeepSeekBalance",
-						schema: _deepseek_ai_dsh_llm_billing_billing_getBalance_result$schema
+						schema: _rayadesu_dsh_llm_billing_billing_getBalance_result$schema
 					},
 					sourceLocation: {
 						"file": "packages/llm/llm-billing/src/balance.ts",
-						"line": 139,
+						"line": 143,
 						"column": 3
 					}
 				},
@@ -4066,17 +4162,17 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 						codec: {
 							mode: "strict",
 							typeSymbol: "@deepseek-ai/dsh-session/types#SessionId",
-							schema: _deepseek_ai_dsh_llm_billing_billing_getSessionSpend_parameter_0$schema
+							schema: _rayadesu_dsh_llm_billing_billing_getSessionSpend_parameter_0$schema
 						}
 					}],
 					result: {
 						mode: "strict",
 						typeSymbol: "@rayadesu/dsh-llm-billing/types#DeepSeekSessionSpend",
-						schema: _deepseek_ai_dsh_llm_billing_billing_getSessionSpend_result$schema
+						schema: _rayadesu_dsh_llm_billing_billing_getSessionSpend_result$schema
 					},
 					sourceLocation: {
 						"file": "packages/llm/llm-billing/src/balance.ts",
-						"line": 149,
+						"line": 154,
 						"column": 3
 					}
 				},
@@ -4086,23 +4182,33 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					namespace: "billing",
 					method: "getTodaySpend",
 					invocation: { kind: "direct" },
-					parameters: [],
+					parameters: [{
+						name: "force",
+						wire: "force",
+						source: "json",
+						acceptsUndefined: true,
+						codec: {
+							mode: "strict",
+							typeSymbol: "@rayadesu/dsh-llm-billing#billing/getTodaySpend:force",
+							schema: _rayadesu_dsh_llm_billing_billing_getTodaySpend_parameter_0$schema
+						}
+					}],
 					result: {
 						mode: "strict",
 						typeSymbol: "@rayadesu/dsh-llm-billing/types#DeepSeekTodaySpend",
-						schema: _deepseek_ai_dsh_llm_billing_billing_getTodaySpend_result$schema
+						schema: _rayadesu_dsh_llm_billing_billing_getTodaySpend_result$schema
 					},
 					sourceLocation: {
 						"file": "packages/llm/llm-billing/src/balance.ts",
-						"line": 159,
+						"line": 167,
 						"column": 3
 					}
 				}
 			]
 		};
 		//#endregion
-		//#region \0dsh-css:D:\code\deepseek-harness\packages\client\ui-billing\src\client\BalanceBadge.module.css.mjs
-		const css = ".YAT53G_root{position:relative}.YAT53G_trigger{background:var(--dsw-alias-fill-l2);min-height:32px;color:var(--dsw-alias-label-secondary);cursor:pointer;border:0;border-radius:8px;align-items:center;gap:4px;padding:4px 8px;display:inline-flex}.YAT53G_trigger:hover,.YAT53G_trigger:focus-visible{color:var(--dsw-alias-label-primary)}.YAT53G_trigger svg{transition:transform .12s}.YAT53G_chevronOpen{transform:rotate(180deg)}.YAT53G_triggerLines{text-align:left;flex-direction:column;align-items:flex-start;gap:0;display:flex}.YAT53G_linePrimary{font-variant-numeric:tabular-nums;font-size:12px;line-height:16px}.YAT53G_lineSecondary{color:var(--dsw-alias-label-tertiary);font-variant-numeric:tabular-nums;font-size:11px;line-height:15px}.YAT53G_unavailable{color:var(--dsw-alias-label-tertiary)}.YAT53G_inlineIcon{color:var(--dsw-alias-label-tertiary);flex:none}.YAT53G_spinning{color:var(--dsw-alias-label-tertiary);flex:none;animation:.8s linear infinite YAT53G_spin}@keyframes YAT53G_spin{to{transform:rotate(360deg)}}.YAT53G_panel{z-index:100;box-sizing:border-box;border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-specific-menu);width:336px;max-width:min(360px,100vw - 32px);box-shadow:var(--dsw-shadow-lv3);border-radius:12px;flex-direction:column;gap:2px;padding:6px;display:flex;position:absolute;top:calc(100% + 6px);right:0}.YAT53G_amountRow{border-radius:8px;justify-content:space-between;align-items:center;gap:8px;padding:6px 8px;display:flex}.YAT53G_amountLabel{color:var(--dsw-alias-label-primary);font-variant-numeric:tabular-nums;font-size:13px;line-height:18px}.YAT53G_spendRow{border-top:1px solid var(--dsw-alias-border-l2);border-radius:0;justify-content:space-between;align-items:center;gap:8px;padding:6px 8px;display:flex}.YAT53G_costRow{align-items:center;padding:2px 8px 6px;display:flex}.YAT53G_costBreakdown{color:var(--dsw-alias-label-tertiary);font-variant-numeric:tabular-nums;font-size:11px;line-height:16px}.YAT53G_amountActions{align-items:center;gap:2px;display:inline-flex}.YAT53G_infoButton,.YAT53G_refreshButton{width:24px;height:24px;color:var(--dsw-alias-label-tertiary);cursor:pointer;background:0 0;border:0;border-radius:6px;flex:none;justify-content:center;align-items:center;padding:0;display:inline-flex}.YAT53G_infoButton:hover,.YAT53G_infoButton:focus-visible,.YAT53G_refreshButton:hover,.YAT53G_refreshButton:focus-visible{color:var(--dsw-alias-label-secondary);background:var(--dsw-alias-fill-l2)}.YAT53G_modelRow{border-radius:8px;justify-content:space-between;align-items:baseline;gap:8px;padding:6px 8px;display:flex}.YAT53G_modelName{color:var(--dsw-alias-label-secondary);flex:none;font-size:12px;line-height:18px}.YAT53G_tasks{text-align:right;min-width:0;color:var(--dsw-alias-label-tertiary);font-variant-numeric:tabular-nums;overflow-wrap:anywhere;font-size:12px;line-height:18px}";
+		//#region \0dsh-css:C:\Users\admin\Desktop\me\code\deepseek-harness\packages\client\ui-billing\src\client\BalanceBadge.module.css.mjs
+		const css = ".v_-kjq_root{position:relative}.v_-kjq_trigger{background:var(--dsw-alias-fill-l2);min-height:32px;color:var(--dsw-alias-label-secondary);cursor:pointer;border:0;border-radius:8px;align-items:center;gap:4px;padding:4px 8px;display:inline-flex}.v_-kjq_trigger:hover,.v_-kjq_trigger:focus-visible{color:var(--dsw-alias-label-primary)}.v_-kjq_trigger svg{transition:transform .12s}.v_-kjq_chevronOpen{transform:rotate(180deg)}.v_-kjq_triggerLines{text-align:left;flex-direction:column;align-items:flex-start;gap:0;display:flex}.v_-kjq_linePrimary{font-variant-numeric:tabular-nums;font-size:12px;line-height:16px}.v_-kjq_lineSecondary{color:var(--dsw-alias-label-tertiary);font-variant-numeric:tabular-nums;font-size:11px;line-height:15px}.v_-kjq_unavailable{color:var(--dsw-alias-label-tertiary)}.v_-kjq_inlineIcon{color:var(--dsw-alias-label-tertiary);flex:none}.v_-kjq_spinning{color:var(--dsw-alias-label-tertiary);flex:none;animation:.8s linear infinite v_-kjq_spin}@keyframes v_-kjq_spin{to{transform:rotate(360deg)}}.v_-kjq_panel{z-index:100;box-sizing:border-box;border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-specific-menu);width:336px;max-width:min(360px,100vw - 32px);box-shadow:var(--dsw-shadow-lv3);border-radius:12px;flex-direction:column;gap:2px;padding:6px;display:flex;position:absolute;top:calc(100% + 6px);right:0}.v_-kjq_amountRow{border-radius:8px;justify-content:space-between;align-items:center;gap:8px;padding:6px 8px;display:flex}.v_-kjq_amountLabel{color:var(--dsw-alias-label-primary);font-variant-numeric:tabular-nums;font-size:13px;line-height:18px}.v_-kjq_spendRow{border-top:1px solid var(--dsw-alias-border-l2);border-radius:0;justify-content:space-between;align-items:center;gap:8px;padding:6px 8px;display:flex}.v_-kjq_costRow{align-items:center;padding:2px 8px 6px;display:flex}.v_-kjq_costBreakdown{color:var(--dsw-alias-label-tertiary);font-variant-numeric:tabular-nums;font-size:11px;line-height:16px}.v_-kjq_amountActions{align-items:center;gap:2px;display:inline-flex}.v_-kjq_infoButton,.v_-kjq_refreshButton{width:24px;height:24px;color:var(--dsw-alias-label-tertiary);cursor:pointer;background:0 0;border:0;border-radius:6px;flex:none;justify-content:center;align-items:center;padding:0;display:inline-flex}.v_-kjq_infoButton:hover,.v_-kjq_infoButton:focus-visible,.v_-kjq_refreshButton:hover,.v_-kjq_refreshButton:focus-visible{color:var(--dsw-alias-label-secondary);background:var(--dsw-alias-fill-l2)}.v_-kjq_modelRow{border-radius:8px;justify-content:space-between;align-items:baseline;gap:8px;padding:6px 8px;display:flex}.v_-kjq_modelName{color:var(--dsw-alias-label-secondary);flex:none;font-size:12px;line-height:18px}.v_-kjq_tasks{text-align:right;min-width:0;color:var(--dsw-alias-label-tertiary);font-variant-numeric:tabular-nums;overflow-wrap:anywhere;font-size:12px;line-height:18px}";
 		const tagId = "@rayadesu/dsh-client-ui-billing/BalanceBadge.module.css";
 		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
 			const tag = document.createElement("style");
@@ -4112,28 +4218,28 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			document.head.appendChild(tag);
 		}
 		var BalanceBadge_module_css_default = {
-			"amountActions": "YAT53G_amountActions",
-			"amountLabel": "YAT53G_amountLabel",
-			"amountRow": "YAT53G_amountRow",
-			"chevronOpen": "YAT53G_chevronOpen",
-			"costBreakdown": "YAT53G_costBreakdown",
-			"costRow": "YAT53G_costRow",
-			"infoButton": "YAT53G_infoButton",
-			"inlineIcon": "YAT53G_inlineIcon",
-			"linePrimary": "YAT53G_linePrimary",
-			"lineSecondary": "YAT53G_lineSecondary",
-			"modelName": "YAT53G_modelName",
-			"modelRow": "YAT53G_modelRow",
-			"panel": "YAT53G_panel",
-			"refreshButton": "YAT53G_refreshButton",
-			"root": "YAT53G_root",
-			"spendRow": "YAT53G_spendRow",
-			"spin": "YAT53G_spin",
-			"spinning": "YAT53G_spinning",
-			"tasks": "YAT53G_tasks",
-			"trigger": "YAT53G_trigger",
-			"triggerLines": "YAT53G_triggerLines",
-			"unavailable": "YAT53G_unavailable"
+			"amountActions": "v_-kjq_amountActions",
+			"amountLabel": "v_-kjq_amountLabel",
+			"amountRow": "v_-kjq_amountRow",
+			"chevronOpen": "v_-kjq_chevronOpen",
+			"costBreakdown": "v_-kjq_costBreakdown",
+			"costRow": "v_-kjq_costRow",
+			"infoButton": "v_-kjq_infoButton",
+			"inlineIcon": "v_-kjq_inlineIcon",
+			"linePrimary": "v_-kjq_linePrimary",
+			"lineSecondary": "v_-kjq_lineSecondary",
+			"modelName": "v_-kjq_modelName",
+			"modelRow": "v_-kjq_modelRow",
+			"panel": "v_-kjq_panel",
+			"refreshButton": "v_-kjq_refreshButton",
+			"root": "v_-kjq_root",
+			"spendRow": "v_-kjq_spendRow",
+			"spin": "v_-kjq_spin",
+			"spinning": "v_-kjq_spinning",
+			"tasks": "v_-kjq_tasks",
+			"trigger": "v_-kjq_trigger",
+			"triggerLines": "v_-kjq_triggerLines",
+			"unavailable": "v_-kjq_unavailable"
 		};
 		//#endregion
 		//#region lib/types/client/BalanceBadge.js
@@ -4199,7 +4305,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 						if (!current) return;
 						setSpend(value);
 					}, () => {});
-					const todaySpendRequest = Promise.resolve().then(getTodaySpend).then((value) => {
+					const todaySpendRequest = Promise.resolve().then(() => getTodaySpend(request > 0)).then((value) => {
 						if (!current) return;
 						setTodaySpend(value);
 					}, () => {});
@@ -4225,17 +4331,20 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 				if (messageCount === pricedMessageCountRef.current) return;
 				pricedMessageCountRef.current = messageCount;
 				let current = true;
-				Promise.resolve().then(() => {
-					Promise.resolve().then(() => getSessionSpend(sessionId)).then((value) => {
-						if (!current) return;
-						setSpend(value);
-					}, () => {});
-					Promise.resolve().then(getTodaySpend).then((value) => {
-						if (!current) return;
-						setTodaySpend(value);
-					}, () => {});
-				});
+				const timer = setTimeout(() => {
+					Promise.resolve().then(() => {
+						Promise.resolve().then(() => getSessionSpend(sessionId)).then((value) => {
+							if (!current) return;
+							setSpend(value);
+						}, () => {});
+						Promise.resolve().then(() => getTodaySpend()).then((value) => {
+							if (!current) return;
+							setTodaySpend(value);
+						}, () => {});
+					});
+				}, 2e3);
 				return () => {
+					clearTimeout(timer);
 					current = false;
 				};
 			}, [
@@ -4387,7 +4496,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			"state.unavailable": "额度不可用",
 			"action.refresh": "刷新",
 			"info.aria": "花费说明",
-			"info.hint": "仅能预估 DeepSeek 相关模型。本会话花费按每条消息的发生时刻（北京时间）所在峰谷时段单价计费：缓存命中输入、未命中输入（含缓存写入）、输出（含推理）分别计价。费用按 8 月 17 日实行的标准。",
+			"info.hint": "仅能预估 DeepSeek 相关模型。本会话花费按每条消息的发生时刻（北京时间）所在峰谷时段单价计费：缓存命中输入、未命中输入（含缓存写入）、输出（含推理）分别计价。费率按 8 月 17 日实行的标准，高峰时段为北京时间周一至周五 9:00–12:00、14:00–18:00，周末全天按低谷价计费。",
 			"badge.aria": "DeepSeek 额度：{amount}",
 			"panel.aria": "DeepSeek 额度详情"
 		};
@@ -4405,7 +4514,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			"state.unavailable": "Balance unavailable",
 			"action.refresh": "Refresh",
 			"info.aria": "About this spend",
-			"info.hint": "Only DeepSeek models are estimated. This session's spend is priced per message at the rate of its Beijing-time peak/off-peak hour: cache-hit input, cache-miss input (including cache writes), and output (including reasoning) are billed separately. Pricing follows the August 17 rates.",
+			"info.hint": "Only DeepSeek models are estimated. This session's spend is priced per message at the rate of its Beijing-time peak/off-peak hour: cache-hit input, cache-miss input (including cache writes), and output (including reasoning) are billed separately. Rates follow the August 17 pricing; peak hours are Beijing time Monday–Friday 09:00–12:00 and 14:00–18:00, and weekends are billed at off-peak prices all day.",
 			"badge.aria": "DeepSeek balance {amount}",
 			"panel.aria": "DeepSeek balance details"
 		};
@@ -4442,8 +4551,8 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					if (!result.ok) throw new Error(`billing.getSessionSpend failed: ${result.error.code}: ${result.error.message}`);
 					return result.value;
 				},
-				getTodaySpend: async () => {
-					const result = await billing.getTodaySpend();
+				getTodaySpend: async (force) => {
+					const result = await billing.getTodaySpend(force);
 					if (!result.ok) throw new Error(`billing.getTodaySpend failed: ${result.error.code}: ${result.error.message}`);
 					return result.value;
 				}

package/lib/types/client/BalanceBadge.d.ts

@@ -9,8 +9,12 @@ export interface BalanceBadgeInjected {
     getBalance: () => Promise<DeepSeekBalance>;
     /** Read one session's billed spend; rejects with the Remote error message. */
     getSessionSpend: (sessionId: SessionId) => Promise<DeepSeekSessionSpend>;
-    /** Read today's billed spend across every session; rejects with the Remote error message. */
-    getTodaySpend: () => Promise<DeepSeekTodaySpend>;
+    /**
+     * Read today's billed spend across every session; rejects with the Remote
+     * error message. `force` bypasses the host-side cache — the manual refresh
+     * passes it, the message-triggered recompute does not.
+     */
+    getTodaySpend: (force?: boolean) => Promise<DeepSeekTodaySpend>;
 }
 /** Full props assembled by the header utilities slot renderer. */
 export type BalanceBadgeProps = PropsRuntime<'conversation.session.header.utilities'> & InjectFace<BalanceBadgeInjected> & PropsLocale<typeof NS>;

package/lib/types/client/locales.d.ts

@@ -15,7 +15,7 @@ export declare const zh: {
     readonly 'state.unavailable': "额度不可用";
     readonly 'action.refresh': "刷新";
     readonly 'info.aria': "花费说明";
-    readonly 'info.hint': "仅能预估 DeepSeek 相关模型。本会话花费按每条消息的发生时刻（北京时间）所在峰谷时段单价计费：缓存命中输入、未命中输入（含缓存写入）、输出（含推理）分别计价。费用按 8 月 17 日实行的标准。";
+    readonly 'info.hint': "仅能预估 DeepSeek 相关模型。本会话花费按每条消息的发生时刻（北京时间）所在峰谷时段单价计费：缓存命中输入、未命中输入（含缓存写入）、输出（含推理）分别计价。费率按 8 月 17 日实行的标准，高峰时段为北京时间周一至周五 9:00–12:00、14:00–18:00，周末全天按低谷价计费。";
     readonly 'badge.aria': "DeepSeek 额度：{amount}";
     readonly 'panel.aria': "DeepSeek 额度详情";
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@rayadesu/dsh-client-ui-billing",
   "description": "Session-header DeepSeek account-balance and conversation-spend badge over the billing Remote",
-  "version": "0.1.0-rc.8",
+  "version": "0.2.0",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/types/index.d.ts",
@@ -31,6 +31,10 @@
       "platform": "web"
     }
   },
+  "scripts": {
+    "bundle": "tsdown",
+    "watch": "tsdown --watch"
+  },
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -41,7 +45,7 @@
     "access": "public"
   },
   "peerDependencies": {
-    "@rayadesu/dsh-llm-billing": "^0.1.0-rc.8",
+    "@rayadesu/dsh-llm-billing": "^0.2.0",
     "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.8",
     "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.8",
     "@deepseek-ai/dsh-client-ui-conversation": "^0.1.0-rc.8",
@@ -50,7 +54,7 @@
     "@deepseek-ai/cordis": "^4.0.1"
   },
   "devDependencies": {
-    "@rayadesu/dsh-llm-billing": "^0.1.0-rc.8",
+    "@rayadesu/dsh-llm-billing": "^0.2.0",
     "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.8",
     "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.8",
     "@deepseek-ai/dsh-client-test-runtime": "^0.1.0-rc.8",
@@ -68,9 +72,5 @@
     "lib/invariant.js",
     "lib/client.js",
     "lib/types/**/*.d.ts"
-  ],
-  "scripts": {
-    "bundle": "tsdown",
-    "watch": "tsdown --watch"
-  }
-}
+  ]
+}

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 WilliamLIiii
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.