dsh-context 0.53.4 → 0.54.0

package/lib/client.js

@@ -329,6 +329,10 @@ window.__ModuleLoader__.load({
 			"ov.kpi.sessionsSub": "含 {n} 个会话",
 			"ov.kpi.toolSub": "工具执行 {dur}",
 			"ov.kpi.wallSub": "模型调用 {n}",
+			"balance.title": "DeepSeek 余额",
+			"balance.tip.total": "总余额",
+			"balance.tip.granted": "赠送余额",
+			"balance.tip.toppedUp": "充值余额",
 			"ov.heat.title": "活跃度",
 			"ov.heat.sub": "按日期筛选",
 			"ov.heat.empty": "暂无活跃数据 — 会话产生模型请求后，这里会显示每日用量",
@@ -695,6 +699,10 @@ window.__ModuleLoader__.load({
 			"ov.kpi.sessionsSub": "across {n} sessions",
 			"ov.kpi.toolSub": "tool runs {dur}",
 			"ov.kpi.wallSub": "{n} model calls",
+			"balance.title": "DeepSeek balance",
+			"balance.tip.total": "Total balance",
+			"balance.tip.granted": "Granted balance",
+			"balance.tip.toppedUp": "Topped-up balance",
 			"ov.heat.title": "Activity",
 			"ov.heat.sub": "Filter by date",
 			"ov.heat.empty": "No activity yet — daily usage appears once sessions make model requests",
@@ -6199,6 +6207,141 @@ window.__ModuleLoader__.load({
 			return t("ov.time.d", { n: Math.floor(hours / 24) });
 		}
 		//#endregion
+		//#region src/client/balance.ts
+		const BALANCE_ROUTE = "/api/dsh-context/balance";
+		/** How long a settled answer (including a `null`) serves identical reads. */
+		const TTL_MS$1 = 6e4;
+		/** One platform amount ('110.00', or an already-numeric producer variant), or null. */
+		function amountOf(value) {
+			const n = typeof value === "string" ? Number(value) : value;
+			return typeof n === "number" && Number.isFinite(n) && n >= 0 ? n : null;
+		}
+		/**
+		* Narrow the delivered payload to a render-safe value (the same boundary
+		* rigor as `timelineOf`): each entry's currency and amounts re-proved, an
+		* entry failing the shape drops whole, and a payload with no valid entry is
+		* no balance — the caller renders nothing rather than half a figure.
+		*/
+		function platformBalanceOf(value) {
+			const data = asRecord(value);
+			if (data === null) return null;
+			const infos = Array.isArray(data.balances) ? data.balances : [];
+			const balances = [];
+			for (const info of infos) try {
+				const entry = asRecord(info);
+				if (entry === null) continue;
+				const currency = entry.currency;
+				const total = amountOf(entry.total);
+				const granted = amountOf(entry.granted);
+				const toppedUp = amountOf(entry.toppedUp);
+				if (typeof currency !== "string" || currency === "" || total === null || granted === null || toppedUp === null) continue;
+				balances.push({
+					currency,
+					total,
+					granted,
+					toppedUp
+				});
+			} catch {
+				continue;
+			}
+			return balances.length > 0 ? {
+				isAvailable: data.isAvailable === true,
+				balances
+			} : null;
+		}
+		/**
+		* The entry matching the display currency (zh → CNY, en → USD), falling back
+		* to the account's first entry when the platform reports none in it — a
+		* number in the account's own currency beats no number.
+		*/
+		function balanceEntryOf(balance, currency) {
+			if (balance === null || balance === void 0 || balance.balances.length === 0) return null;
+			const want = currency === "cny" ? "CNY" : "USD";
+			return balance.balances.find((entry) => entry.currency === want) ?? balance.balances[0];
+		}
+		let cached$1 = null;
+		/**
+		* The capsule's read: one route POST, narrowed through
+		* `platformBalanceOf`, deduplicated in flight, TTL-cached. Never rejects.
+		*/
+		function fetchPlatformBalance() {
+			if (cached$1 !== null && Date.now() - cached$1.at < TTL_MS$1) return cached$1.promise;
+			const at = Date.now();
+			const promise = (async () => {
+				try {
+					const response = await fetch(BALANCE_ROUTE, {
+						method: "POST",
+						headers: { "content-type": "application/json" }
+					});
+					if (!response.ok) return null;
+					const r = asRecord(await response.json());
+					if (r === null || r.ok !== true || r.value === null || r.value === void 0) return null;
+					return platformBalanceOf(r.value);
+				} catch {
+					return null;
+				}
+			})();
+			cached$1 = {
+				at,
+				promise
+			};
+			return promise;
+		}
+		//#endregion
+		//#region src/client/components/balanceCapsule.tsx
+		/**
+		* BalanceCapsule — the DeepSeek open-platform balance pill in the Context
+		* Dashboard's header (the plugin's one account-level figure, beside the
+		* session-level ones). Mounted only by the dashboard header; it reads the
+		* plugin's balance route once per open through client/balance.ts and renders
+		* NOTHING while the read is pending, absent, or failed — the pill exists
+		* only when there is a live figure to show. The tooltip carries the
+		* breakdown (total / granted / topped-up) in the entry's own currency; the
+		* entry follows the active locale (zh → CNY) with the account's first
+		* currency as the fallback.
+		*/
+		/** The symbol prefix for the currencies the platform serves; others show their code. */
+		function symbolOf(currency) {
+			if (currency === "CNY") return "¥";
+			if (currency === "USD") return "$";
+			return currency + " ";
+		}
+		function makeBalanceCapsule(ctx, kit) {
+			const { t } = kit;
+			return function BalanceCapsule() {
+				const [balance, setBalance] = (0, react.useState)(null);
+				(0, react.useEffect)(() => {
+					let on = true;
+					fetchPlatformBalance().then((v) => {
+						if (on) setBalance(v);
+					});
+					return () => {
+						on = false;
+					};
+				}, []);
+				const locale = ctx.locale;
+				const entry = balanceEntryOf(balance, (typeof locale.getLocale === "function" ? locale.getLocale().active : "en") === "zh" ? "cny" : "usd");
+				if (entry === null) return null;
+				const money = (amount) => symbolOf(entry.currency) + amount.toFixed(2);
+				const tip = [
+					t("balance.tip.total") + ": " + money(entry.total),
+					t("balance.tip.granted") + ": " + money(entry.granted),
+					t("balance.tip.toppedUp") + ": " + money(entry.toppedUp)
+				].join("\n");
+				return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+					className: "lc-ov-balance",
+					title: tip,
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+						className: "lc-ov-balance-label",
+						children: t("balance.title")
+					}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+						className: "lc-ov-balance-value",
+						children: money(entry.total)
+					})]
+				});
+			};
+		}
+		//#endregion
 		//#region src/shared/days.ts
 		/**
 		* The local-day key (`YYYY-MM-DD`) shared by the activity fold (host) and the
@@ -6660,6 +6803,7 @@ window.__ModuleLoader__.load({
 			const { t, fmtDuration } = kit;
 			const Heatmap = makeHeatmap(kit);
 			const OverviewCard = makeOverviewCard(kit);
+			const BalanceCapsule = makeBalanceCapsule(ctx, kit);
 			const ErrorBoundary = makeErrorBoundary(t);
 			/** The display currency follows the active locale (zh → CNY), read per render — the slot outlet re-renders on a locale switch. */
 			function activeCurrency() {
@@ -6744,6 +6888,7 @@ window.__ModuleLoader__.load({
 									className: "lc-ov-title",
 									children: t("ov.title")
 								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)(BalanceCapsule, {}),
 								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 									className: "lc-gran lc-ov-range",
 									role: "group",
@@ -9494,7 +9639,7 @@ window.__ModuleLoader__.load({
 			return function PluginInfo() {
 				const [latest, setLatest] = (0, react.useState)(null);
 				(0, react.useEffect)(() => {
-					if ("0.53.4".includes("-dev")) return;
+					if ("0.54.0".includes("-dev")) return;
 					let on = true;
 					fetchLatestVersion().then((v) => {
 						if (on && v) setLatest(v);
@@ -9503,8 +9648,8 @@ window.__ModuleLoader__.load({
 						on = false;
 					};
 				}, []);
-				const update = latest !== null && isNewerVersion(latest, "0.53.4") ? latest : null;
-				const nameText = "dsh-context (v0.53.4)";
+				const update = latest !== null && isNewerVersion(latest, "0.54.0") ? latest : null;
+				const nameText = "dsh-context (v0.54.0)";
 				const nameValue = [nameText];
 				if (update) nameValue.push(/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 					className: "lc-pi-update",
@@ -11427,7 +11572,7 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region \0dsh-global-css:/home/runner/work/dsh-context/dsh-context/src/client/styles/overview.css.mjs
-		const css = ".lc-ov-entry{box-sizing:border-box;width:calc(100% + 4px);height:42px;color:var(--dsw-alias-label-primary);cursor:pointer;background:0 0;border:0;border-radius:12px;align-items:center;gap:8px;margin:0 -2px;padding:0 10px 0 8px;font-family:inherit;font-size:14px;line-height:22px;display:flex;overflow:hidden}.lc-ov-entry:hover{background:var(--dsw-alias-interactive-bg-hover)}.lc-ov-entry-rail{border-radius:50%;flex:none;justify-content:center;gap:0;width:36px;height:36px;margin:0;padding:0}.lc-ov-entry-icon{flex:none}.lc-ov-entry-label{text-align:left;white-space:nowrap;text-overflow:ellipsis;flex:auto;min-width:0;overflow:hidden}.lc-ov-backdrop{z-index:200;background:var(--dsw-alias-bg-mask-1,#00000073);justify-content:center;align-items:center;display:flex;position:fixed;inset:0;container:lc-ov/inline-size}.lc-ov-card{box-sizing:border-box;background:var(--dsw-alias-bg-layer-1);border:1px solid var(--dsw-alias-border-l2);width:min(1120px,100vw - 32px);max-height:min(86vh,900px);box-shadow:var(--dsw-shadow-lv3,0 12px 32px #0006);color:var(--dsw-alias-label-primary);border-radius:12px;flex-direction:column;padding:16px 18px 18px;font-size:13px;display:flex;overflow:hidden}.lc-ov-head{flex-wrap:wrap;flex:none;align-items:center;gap:10px;margin-bottom:14px;display:flex}.lc-ov-head-icon{flex:none}.lc-ov-title{white-space:nowrap;font-size:15px;font-weight:600}.lc-ov-head .lc-modal-close{flex:none;margin-left:0}.lc-ov-body{flex:auto;grid-template-columns:minmax(0,3fr) minmax(0,7fr);gap:10px;min-height:0;display:grid}.lc-ov-left{scrollbar-gutter:stable;flex-direction:column;gap:10px;min-height:0;padding-right:8px;display:flex;overflow-y:auto}.lc-ov-right{scrollbar-gutter:stable;min-height:0;padding-right:8px;overflow-y:auto}@container lc-ov (width<=932px){.lc-ov-card{overflow-y:auto}.lc-ov-body{display:block}.lc-ov-left{margin-bottom:12px}.lc-ov-left,.lc-ov-right{min-height:auto;padding-right:0;overflow:visible}.lc-ov-heat-card{flex:none}}.lc-ov-left>.lc-card{box-sizing:border-box;min-width:0;margin-bottom:0}.lc-ov-kpis{flex:none;grid-template-rows:repeat(3,1fr);grid-template-columns:repeat(2,minmax(0,1fr));gap:10px;display:grid}.lc-ov-kpi{align-items:center;padding:10px 8px}.lc-ov-kpi .lc-stat-value{font-size:20px}.lc-ov-heat-card{flex-direction:column;flex:1 0 auto;display:flex}.lc-heat{flex:1;justify-content:center;align-items:center;gap:4px;display:flex}.lc-heat-wds,.lc-heat-col{padding-top:13px}.lc-heat-wds{flex-direction:column;gap:3px;display:flex}.lc-heat-wd{width:10px;height:20px;color:var(--dsw-alias-label-secondary);text-align:center;flex:none;justify-content:center;align-items:center;font-size:9px;display:flex}.lc-heat-cols{gap:3px;display:flex}.lc-heat-col{flex-direction:column;gap:3px;display:flex;position:relative}.lc-heat-mon{color:var(--dsw-alias-label-secondary);white-space:nowrap;font-size:9px;line-height:13px;position:absolute;top:0;left:0}.lc-heat-cell{box-sizing:border-box;background:var(--dsw-alias-bg-layer-2);cursor:default;border:0;border-radius:20%;width:20px;height:20px;padding:0}button.lc-heat-cell{cursor:pointer}button.lc-heat-cell:hover{box-shadow:0 0 0 1.5px color-mix(in srgb, var(--color-blue-500) 70%, transparent)}.lc-heat-future{background:0 0}.lc-heat-0{background:color-mix(in srgb, var(--dsw-alias-label-secondary) 16%, transparent)}.lc-heat-1{background:color-mix(in srgb, var(--color-blue-500) 28%, transparent)}.lc-heat-2{background:color-mix(in srgb, var(--color-blue-500) 50%, transparent)}.lc-heat-3{background:color-mix(in srgb, var(--color-blue-500) 72%, transparent)}.lc-heat-4{background:color-mix(in srgb, var(--color-blue-500) 92%, transparent)}.lc-heat-on{box-shadow:0 0 0 1.5px var(--color-blue-500)}.lc-ov-list-head{flex-wrap:wrap;align-items:center;gap:10px;margin-bottom:10px;display:flex}.lc-ov-list-title{white-space:nowrap;font-weight:600}.lc-ov-list-count{color:var(--dsw-alias-label-secondary);font-variant-numeric:tabular-nums;background:var(--dsw-alias-bg-layer-2);border-radius:8px;padding:1px 7px;font-size:11px}.lc-ov-day-chip{border:1px solid color-mix(in srgb, var(--color-blue-500) 45%, transparent);color:var(--color-blue-500);background:color-mix(in srgb, var(--color-blue-500) 10%, transparent);cursor:pointer;white-space:nowrap;border-radius:999px;padding:1px 10px;font-family:inherit;font-size:11px;line-height:1.4}.lc-ov-search{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-2);min-width:110px;font:inherit;color:var(--dsw-alias-label-primary);transition:border-color var(--ds-transition-duration,.2s) var(--ds-ease-in-out,ease-in-out);border-radius:6px;outline:none;flex:150px;padding:4px 10px;font-size:12px}.lc-ov-search:focus{border-color:var(--dsw-alias-label-secondary)}.lc-ov-search::placeholder{color:var(--dsw-alias-label-secondary)}.lc-ov-groups{flex-wrap:wrap;gap:6px;margin:-2px 0 10px;display:flex}.lc-ov-chip{border:1px solid var(--dsw-alias-border-l2);color:var(--dsw-alias-label-secondary);font:inherit;cursor:pointer;white-space:nowrap;text-overflow:ellipsis;max-width:220px;transition:color var(--ds-transition-duration,.2s) var(--ds-ease-in-out,ease-in-out), border-color var(--ds-transition-duration,.2s) var(--ds-ease-in-out,ease-in-out), background-color var(--ds-transition-duration,.2s) var(--ds-ease-in-out,ease-in-out);background:0 0;border-radius:999px;align-items:baseline;gap:5px;padding:2px 10px;font-size:11px;line-height:1.5;display:inline-flex;overflow:hidden}.lc-ov-chip:hover{color:var(--dsw-alias-label-primary);border-color:var(--dsw-alias-label-secondary)}.lc-ov-chip-on,.lc-ov-chip-on:hover{background:var(--dsw-alias-button-primary-fill);color:var(--dsw-alias-label-primary-foreground);border-color:#0000}.lc-ov-chip-n{font-variant-numeric:tabular-nums;opacity:.65;font-size:10px}.lc-ov-chip-on .lc-ov-chip-n{opacity:.85}.lc-ov-grid{grid-template-columns:repeat(auto-fill,minmax(300px,1fr));gap:10px;display:grid}.lc-ov-session{text-align:left;background:var(--dsw-alias-bg-layer-1);border:1px solid var(--dsw-alias-border-l2);cursor:pointer;font:inherit;color:inherit;transition:border-color var(--ds-transition-duration,.2s) var(--ds-ease-in-out,ease-in-out), background-color var(--ds-transition-duration,.2s) var(--ds-ease-in-out,ease-in-out);border-radius:10px;flex-direction:column;gap:6px;padding:10px 12px;display:flex}.lc-ov-session:hover{border-color:var(--dsw-alias-label-secondary);background:var(--dsw-alias-bg-layer-2)}.lc-ov-session-current{border-color:color-mix(in srgb, var(--color-blue-500) 65%, transparent)}.lc-ov-session-head{align-items:flex-start;gap:6px;min-width:0;display:flex}.lc-ov-running{background:var(--color-green-500);border-radius:50%;flex:none;width:7px;height:7px}.lc-ov-session-title{-webkit-line-clamp:2;overflow-wrap:anywhere;-webkit-box-orient:vertical;flex:auto;min-width:0;font-weight:600;display:-webkit-box;overflow:hidden}.lc-ov-current{color:var(--color-blue-500);border:1px solid color-mix(in srgb, var(--color-blue-500) 45%, transparent);border-radius:4px;flex:none;padding:0 4px;font-size:10px;line-height:1.5}.lc-ov-session-times{flex-direction:column;flex:none;align-items:flex-end;gap:1px;display:flex}.lc-ov-session-time{color:var(--dsw-alias-label-secondary);white-space:nowrap;font-size:11px}.lc-ov-session-created{color:var(--dsw-alias-label-secondary);white-space:nowrap;font-variant-numeric:tabular-nums;font-size:10px;line-height:1.4}.lc-ov-session-crumb{min-width:0;color:var(--dsw-alias-label-secondary);white-space:nowrap;align-items:center;gap:5px;font-size:11px;display:flex;overflow:hidden}.lc-ov-crumb-group{text-overflow:ellipsis;flex:none;max-width:55%;overflow:hidden}.lc-ov-crumb-sep{opacity:.55;flex:none}.lc-ov-crumb-project{text-overflow:ellipsis;min-width:0;font-family:var(--ds-font-family-code,ui-monospace, SFMono-Regular, Menlo, monospace);color:var(--dsw-alias-label-primary);background:color-mix(in srgb, var(--dsw-alias-label-secondary) 16%, transparent);border-radius:999px;flex:0 auto;padding:0 8px;font-size:10px;line-height:1.6;overflow:hidden}.lc-ov-session-body{align-items:center;gap:14px;min-width:0;display:flex}.lc-ov-mini-stats{flex-direction:column;flex:auto;gap:3px;min-width:0;display:flex}.lc-ov-mini-stat{justify-content:space-between;align-items:baseline;gap:10px;font-size:11px;display:flex}.lc-ov-mini-label{color:var(--dsw-alias-label-secondary);white-space:nowrap;flex:none}.lc-ov-mini-value{font-variant-numeric:tabular-nums;white-space:nowrap;font-weight:600}.lc-ov-session-empty{color:var(--dsw-alias-label-secondary);padding:6px 0;font-size:11px;line-height:1.5}.lc-ov-session-preview{border-top:1px solid color-mix(in srgb, var(--dsw-alias-border-l2) 60%, transparent);align-items:baseline;gap:6px;min-width:0;margin-top:auto;padding-top:6px;display:flex}.lc-ov-session-preview-label{color:var(--dsw-alias-label-secondary);flex:none;font-size:10px}.lc-ov-session-preview-text{text-overflow:ellipsis;white-space:nowrap;min-width:0;color:var(--dsw-alias-label-primary);flex:0 auto;font-size:11px;line-height:1.5;overflow:hidden}.lc-ov-pager{justify-content:center;align-items:center;gap:10px;margin-top:12px;display:flex}.lc-ov-pager-btn{border:1px solid var(--dsw-alias-border-l2);width:26px;height:22px;color:var(--dsw-alias-label-primary);font:inherit;cursor:pointer;transition:border-color var(--ds-transition-duration,.2s) var(--ds-ease-in-out,ease-in-out);background:0 0;border-radius:6px;flex:none;justify-content:center;align-items:center;line-height:1;display:flex}.lc-ov-pager-btn:hover:enabled{border-color:var(--dsw-alias-label-secondary)}.lc-ov-pager-btn:disabled{opacity:.4;cursor:default}.lc-ov-pager-n{color:var(--dsw-alias-label-secondary);font-variant-numeric:tabular-nums;white-space:nowrap;font-size:11px}";
+		const css = ".lc-ov-entry{box-sizing:border-box;width:calc(100% + 4px);height:42px;color:var(--dsw-alias-label-primary);cursor:pointer;background:0 0;border:0;border-radius:12px;align-items:center;gap:8px;margin:0 -2px;padding:0 10px 0 8px;font-family:inherit;font-size:14px;line-height:22px;display:flex;overflow:hidden}.lc-ov-entry:hover{background:var(--dsw-alias-interactive-bg-hover)}.lc-ov-entry-rail{border-radius:50%;flex:none;justify-content:center;gap:0;width:36px;height:36px;margin:0;padding:0}.lc-ov-entry-icon{flex:none}.lc-ov-entry-label{text-align:left;white-space:nowrap;text-overflow:ellipsis;flex:auto;min-width:0;overflow:hidden}.lc-ov-backdrop{z-index:200;background:var(--dsw-alias-bg-mask-1,#00000073);justify-content:center;align-items:center;display:flex;position:fixed;inset:0;container:lc-ov/inline-size}.lc-ov-card{box-sizing:border-box;background:var(--dsw-alias-bg-layer-1);border:1px solid var(--dsw-alias-border-l2);width:min(1120px,100vw - 32px);max-height:min(86vh,900px);box-shadow:var(--dsw-shadow-lv3,0 12px 32px #0006);color:var(--dsw-alias-label-primary);border-radius:12px;flex-direction:column;padding:16px 18px 18px;font-size:13px;display:flex;overflow:hidden}.lc-ov-head{flex-wrap:wrap;flex:none;align-items:center;gap:10px;margin-bottom:14px;display:flex}.lc-ov-head-icon{flex:none}.lc-ov-title{white-space:nowrap;font-size:15px;font-weight:600}.lc-ov-balance{background:var(--dsw-alias-bg-layer-2);border:1px solid var(--dsw-alias-border-l2);cursor:default;border-radius:999px;flex:none;align-items:center;gap:6px;max-width:100%;padding:2px 10px;font-size:12px;line-height:18px;display:inline-flex}.lc-ov-balance-label{color:var(--dsw-alias-label-secondary);white-space:nowrap}.lc-ov-balance-value{font-variant-numeric:tabular-nums;white-space:nowrap;font-weight:600}.lc-ov-head .lc-modal-close{flex:none;margin-left:0}.lc-ov-body{flex:auto;grid-template-columns:minmax(0,3fr) minmax(0,7fr);gap:10px;min-height:0;display:grid}.lc-ov-left{scrollbar-gutter:stable;flex-direction:column;gap:10px;min-height:0;padding-right:8px;display:flex;overflow-y:auto}.lc-ov-right{scrollbar-gutter:stable;min-height:0;padding-right:8px;overflow-y:auto}@container lc-ov (width<=932px){.lc-ov-card{overflow-y:auto}.lc-ov-body{display:block}.lc-ov-left{margin-bottom:12px}.lc-ov-left,.lc-ov-right{min-height:auto;padding-right:0;overflow:visible}.lc-ov-heat-card{flex:none}}.lc-ov-left>.lc-card{box-sizing:border-box;min-width:0;margin-bottom:0}.lc-ov-kpis{flex:none;grid-template-rows:repeat(3,1fr);grid-template-columns:repeat(2,minmax(0,1fr));gap:10px;display:grid}.lc-ov-kpi{align-items:center;padding:10px 8px}.lc-ov-kpi .lc-stat-value{font-size:20px}.lc-ov-heat-card{flex-direction:column;flex:1 0 auto;display:flex}.lc-heat{flex:1;justify-content:center;align-items:center;gap:4px;display:flex}.lc-heat-wds,.lc-heat-col{padding-top:13px}.lc-heat-wds{flex-direction:column;gap:3px;display:flex}.lc-heat-wd{width:10px;height:20px;color:var(--dsw-alias-label-secondary);text-align:center;flex:none;justify-content:center;align-items:center;font-size:9px;display:flex}.lc-heat-cols{gap:3px;display:flex}.lc-heat-col{flex-direction:column;gap:3px;display:flex;position:relative}.lc-heat-mon{color:var(--dsw-alias-label-secondary);white-space:nowrap;font-size:9px;line-height:13px;position:absolute;top:0;left:0}.lc-heat-cell{box-sizing:border-box;background:var(--dsw-alias-bg-layer-2);cursor:default;border:0;border-radius:20%;width:20px;height:20px;padding:0}button.lc-heat-cell{cursor:pointer}button.lc-heat-cell:hover{box-shadow:0 0 0 1.5px color-mix(in srgb, var(--color-blue-500) 70%, transparent)}.lc-heat-future{background:0 0}.lc-heat-0{background:color-mix(in srgb, var(--dsw-alias-label-secondary) 16%, transparent)}.lc-heat-1{background:color-mix(in srgb, var(--color-blue-500) 28%, transparent)}.lc-heat-2{background:color-mix(in srgb, var(--color-blue-500) 50%, transparent)}.lc-heat-3{background:color-mix(in srgb, var(--color-blue-500) 72%, transparent)}.lc-heat-4{background:color-mix(in srgb, var(--color-blue-500) 92%, transparent)}.lc-heat-on{box-shadow:0 0 0 1.5px var(--color-blue-500)}.lc-ov-list-head{flex-wrap:wrap;align-items:center;gap:10px;margin-bottom:10px;display:flex}.lc-ov-list-title{white-space:nowrap;font-weight:600}.lc-ov-list-count{color:var(--dsw-alias-label-secondary);font-variant-numeric:tabular-nums;background:var(--dsw-alias-bg-layer-2);border-radius:8px;padding:1px 7px;font-size:11px}.lc-ov-day-chip{border:1px solid color-mix(in srgb, var(--color-blue-500) 45%, transparent);color:var(--color-blue-500);background:color-mix(in srgb, var(--color-blue-500) 10%, transparent);cursor:pointer;white-space:nowrap;border-radius:999px;padding:1px 10px;font-family:inherit;font-size:11px;line-height:1.4}.lc-ov-search{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-2);min-width:110px;font:inherit;color:var(--dsw-alias-label-primary);transition:border-color var(--ds-transition-duration,.2s) var(--ds-ease-in-out,ease-in-out);border-radius:6px;outline:none;flex:150px;padding:4px 10px;font-size:12px}.lc-ov-search:focus{border-color:var(--dsw-alias-label-secondary)}.lc-ov-search::placeholder{color:var(--dsw-alias-label-secondary)}.lc-ov-groups{flex-wrap:wrap;gap:6px;margin:-2px 0 10px;display:flex}.lc-ov-chip{border:1px solid var(--dsw-alias-border-l2);color:var(--dsw-alias-label-secondary);font:inherit;cursor:pointer;white-space:nowrap;text-overflow:ellipsis;max-width:220px;transition:color var(--ds-transition-duration,.2s) var(--ds-ease-in-out,ease-in-out), border-color var(--ds-transition-duration,.2s) var(--ds-ease-in-out,ease-in-out), background-color var(--ds-transition-duration,.2s) var(--ds-ease-in-out,ease-in-out);background:0 0;border-radius:999px;align-items:baseline;gap:5px;padding:2px 10px;font-size:11px;line-height:1.5;display:inline-flex;overflow:hidden}.lc-ov-chip:hover{color:var(--dsw-alias-label-primary);border-color:var(--dsw-alias-label-secondary)}.lc-ov-chip-on,.lc-ov-chip-on:hover{background:var(--dsw-alias-button-primary-fill);color:var(--dsw-alias-label-primary-foreground);border-color:#0000}.lc-ov-chip-n{font-variant-numeric:tabular-nums;opacity:.65;font-size:10px}.lc-ov-chip-on .lc-ov-chip-n{opacity:.85}.lc-ov-grid{grid-template-columns:repeat(auto-fill,minmax(300px,1fr));gap:10px;display:grid}.lc-ov-session{text-align:left;background:var(--dsw-alias-bg-layer-1);border:1px solid var(--dsw-alias-border-l2);cursor:pointer;font:inherit;color:inherit;transition:border-color var(--ds-transition-duration,.2s) var(--ds-ease-in-out,ease-in-out), background-color var(--ds-transition-duration,.2s) var(--ds-ease-in-out,ease-in-out);border-radius:10px;flex-direction:column;gap:6px;padding:10px 12px;display:flex}.lc-ov-session:hover{border-color:var(--dsw-alias-label-secondary);background:var(--dsw-alias-bg-layer-2)}.lc-ov-session-current{border-color:color-mix(in srgb, var(--color-blue-500) 65%, transparent)}.lc-ov-session-head{align-items:flex-start;gap:6px;min-width:0;display:flex}.lc-ov-running{background:var(--color-green-500);border-radius:50%;flex:none;width:7px;height:7px}.lc-ov-session-title{-webkit-line-clamp:2;overflow-wrap:anywhere;-webkit-box-orient:vertical;flex:auto;min-width:0;font-weight:600;display:-webkit-box;overflow:hidden}.lc-ov-current{color:var(--color-blue-500);border:1px solid color-mix(in srgb, var(--color-blue-500) 45%, transparent);border-radius:4px;flex:none;padding:0 4px;font-size:10px;line-height:1.5}.lc-ov-session-times{flex-direction:column;flex:none;align-items:flex-end;gap:1px;display:flex}.lc-ov-session-time{color:var(--dsw-alias-label-secondary);white-space:nowrap;font-size:11px}.lc-ov-session-created{color:var(--dsw-alias-label-secondary);white-space:nowrap;font-variant-numeric:tabular-nums;font-size:10px;line-height:1.4}.lc-ov-session-crumb{min-width:0;color:var(--dsw-alias-label-secondary);white-space:nowrap;align-items:center;gap:5px;font-size:11px;display:flex;overflow:hidden}.lc-ov-crumb-group{text-overflow:ellipsis;flex:none;max-width:55%;overflow:hidden}.lc-ov-crumb-sep{opacity:.55;flex:none}.lc-ov-crumb-project{text-overflow:ellipsis;min-width:0;font-family:var(--ds-font-family-code,ui-monospace, SFMono-Regular, Menlo, monospace);color:var(--dsw-alias-label-primary);background:color-mix(in srgb, var(--dsw-alias-label-secondary) 16%, transparent);border-radius:999px;flex:0 auto;padding:0 8px;font-size:10px;line-height:1.6;overflow:hidden}.lc-ov-session-body{align-items:center;gap:14px;min-width:0;display:flex}.lc-ov-mini-stats{flex-direction:column;flex:auto;gap:3px;min-width:0;display:flex}.lc-ov-mini-stat{justify-content:space-between;align-items:baseline;gap:10px;font-size:11px;display:flex}.lc-ov-mini-label{color:var(--dsw-alias-label-secondary);white-space:nowrap;flex:none}.lc-ov-mini-value{font-variant-numeric:tabular-nums;white-space:nowrap;font-weight:600}.lc-ov-session-empty{color:var(--dsw-alias-label-secondary);padding:6px 0;font-size:11px;line-height:1.5}.lc-ov-session-preview{border-top:1px solid color-mix(in srgb, var(--dsw-alias-border-l2) 60%, transparent);align-items:baseline;gap:6px;min-width:0;margin-top:auto;padding-top:6px;display:flex}.lc-ov-session-preview-label{color:var(--dsw-alias-label-secondary);flex:none;font-size:10px}.lc-ov-session-preview-text{text-overflow:ellipsis;white-space:nowrap;min-width:0;color:var(--dsw-alias-label-primary);flex:0 auto;font-size:11px;line-height:1.5;overflow:hidden}.lc-ov-pager{justify-content:center;align-items:center;gap:10px;margin-top:12px;display:flex}.lc-ov-pager-btn{border:1px solid var(--dsw-alias-border-l2);width:26px;height:22px;color:var(--dsw-alias-label-primary);font:inherit;cursor:pointer;transition:border-color var(--ds-transition-duration,.2s) var(--ds-ease-in-out,ease-in-out);background:0 0;border-radius:6px;flex:none;justify-content:center;align-items:center;line-height:1;display:flex}.lc-ov-pager-btn:hover:enabled{border-color:var(--dsw-alias-label-secondary)}.lc-ov-pager-btn:disabled{opacity:.4;cursor:default}.lc-ov-pager-n{color:var(--dsw-alias-label-secondary);font-variant-numeric:tabular-nums;white-space:nowrap;font-size:11px}";
 		const tagId = "dsh-context/overview.css";
 		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
 			const tag = document.createElement("style");

package/lib/index.d.ts

@@ -796,10 +796,33 @@ interface HeaderRecord {
 interface ContextHeaders {
   headers: HeaderRecord[];
 }
+/** One currency's DeepSeek open-platform balance figures. */
+interface PlatformBalanceEntry {
+  /** The ISO code the platform reported (`CNY` / `USD`). */
+  currency: string;
+  /** Total available funds: the granted and topped-up balances summed. */
+  total: number;
+  /** The not-expired granted (gift) balance. */
+  granted: number;
+  /** The topped-up balance. */
+  toppedUp: number;
+}
+/**
+ * The DeepSeek open-platform balance, served by the plugin's
+ * `/api/dsh-context/balance` fetch route (host/balance.ts). `null` on the
+ * wire — and nothing rendered client-side — whenever the platform is not
+ * configured or the read fails: the capsule only ever shows a live figure.
+ */
+interface PlatformBalance {
+  /** Whether the platform reports the balance sufficient for API calls. */
+  isAvailable: boolean;
+  /** One entry per currency the account holds; at least one. */
+  balances: PlatformBalanceEntry[];
+}
 //#endregion
 //#region src/host/index.d.ts
 export declare const name = "dsh-context";
 export declare const inject: string[];
 export declare function apply(ctx: Context, config: Config): void;
 //#endregion
-export type { ActivityDay, ActivityState, Category, ContextActivity, ContextEventRecord, ContextHeaders, ContextTimeline, ContextTimelineDetail, HeaderRecord, HeaderTool, HeadersState, RequestRecord, Snapshot, SurfaceNode, TimelineCounts, TimelineLast, TimelineState };
+export type { ActivityDay, ActivityState, Category, ContextActivity, ContextEventRecord, ContextHeaders, ContextTimeline, ContextTimelineDetail, HeaderRecord, HeaderTool, HeadersState, PlatformBalance, PlatformBalanceEntry, RequestRecord, Snapshot, SurfaceNode, TimelineCounts, TimelineLast, TimelineState };

package/lib/index.js

@@ -2057,6 +2057,163 @@ function createToolAttribution(ctx) {
 	return { ownerOf: (name) => mcpSourceOf(name) ?? live.get(name) ?? pinnedSourceOf(name) ?? (boot.has(name) ? "<unknown-plugin>" : void 0) };
 }
 //#endregion
+//#region src/host/balance.ts
+/** The plugin's balance route, under the authenticated `/api` fence. */
+const BALANCE_ROUTE = "/api/dsh-context/balance";
+/** The settings namespace llm-deepseek installs its connection section under. */
+const DEEPSEEK_SETTINGS_NS = "llm-deepseek";
+/** llm-deepseek's default credential ref (the env-var name its section resolves). */
+const DEFAULT_API_KEY_ENV = "DEEPSEEK_API_KEY";
+/** The platform's public API root (llm-deepseek's PUBLIC_BASE_URL default). */
+const PUBLIC_BASE_URL = "https://api.deepseek.com";
+/** A settled read serves identical reads for this long; failures decay faster. */
+const CACHE_TTL_MS = 3e5;
+const CACHE_FAIL_TTL_MS = 6e4;
+/** One platform read's whole budget — never worth blocking the route longer. */
+const FETCH_TIMEOUT_MS = 1e4;
+/** Narrow an unknown value to a string-keyed record, or null. */
+function asRecord$1(value) {
+	return value !== null && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+/** One platform amount ('110.00', or an already-numeric producer variant), or null. */
+function amountOf(value) {
+	const n = typeof value === "string" ? Number(value) : value;
+	return typeof n === "number" && Number.isFinite(n) && n >= 0 ? n : null;
+}
+/**
+* Resolve the DeepSeek connection facts exactly as llm-deepseek serves its
+* requests: its settings section for the credential ref and endpoint, the
+* credentials service for the key. `null` whenever any fact is missing —
+* the platform is simply not configured for this deployment.
+*/
+async function resolveFacts(ctx) {
+	const settings = ctx.get("settings");
+	const section = typeof settings?.get === "function" ? asRecord$1(settings.get(DEEPSEEK_SETTINGS_NS)) : null;
+	if (section === null) return null;
+	const apiKeyEnv = typeof section.apiKeyEnv === "string" && section.apiKeyEnv !== "" ? section.apiKeyEnv : DEFAULT_API_KEY_ENV;
+	const baseUrl = typeof section.baseURL === "string" && section.baseURL !== "" ? section.baseURL : PUBLIC_BASE_URL;
+	const credentials = ctx.get("credentials");
+	const resolve = typeof credentials?.resolve === "function" ? credentials.resolve.bind(credentials) : void 0;
+	if (resolve === void 0) return null;
+	let hit;
+	try {
+		hit = await resolve(apiKeyEnv);
+	} catch {
+		return null;
+	}
+	const apiKey = typeof hit?.value === "string" ? hit.value : "";
+	return apiKey === "" ? null : {
+		baseUrl,
+		apiKey
+	};
+}
+/**
+* Narrow the platform's payload to the wire value (the boundary rigor every
+* parser owes untrusted input): each entry's currency and three amounts are
+* re-proved, an entry failing the shape drops whole, and a payload with no
+* valid entry is no balance at all.
+*/
+function balanceOfPayload(value) {
+	const data = asRecord$1(value);
+	if (data === null) return null;
+	const infos = Array.isArray(data.balance_infos) ? data.balance_infos : [];
+	const balances = [];
+	for (const info of infos) try {
+		const entry = asRecord$1(info);
+		if (entry === null) continue;
+		const currency = entry.currency;
+		const total = amountOf(entry.total_balance);
+		const granted = amountOf(entry.granted_balance);
+		const toppedUp = amountOf(entry.topped_up_balance);
+		if (typeof currency !== "string" || currency === "" || total === null || granted === null || toppedUp === null) continue;
+		balances.push({
+			currency,
+			total,
+			granted,
+			toppedUp
+		});
+	} catch {
+		continue;
+	}
+	return balances.length > 0 ? {
+		isAvailable: data.is_available === true,
+		balances
+	} : null;
+}
+/** The outbound platform fetch through the real global fetch. */
+const defaultFetcher = (url, init) => fetch(url, init);
+let fetcher = defaultFetcher;
+let cache = null;
+let inFlight = null;
+/**
+* One platform read for these facts, shared across identical concurrent
+* reads and remembered briefly: successes for CACHE_TTL_MS, failures for
+* CACHE_FAIL_TTL_MS (a blip must not pin the capsule away for the full
+* window). Every failure path — transport, timeout, non-ok status, malformed
+* payload — resolves `null`; the route never throws into the transport.
+*/
+async function readBalance(facts) {
+	const key = facts.baseUrl + "\0" + facts.apiKey;
+	if (cache !== null && cache.key === key && Date.now() - cache.at < (cache.value === null ? CACHE_FAIL_TTL_MS : CACHE_TTL_MS)) return cache.value;
+	if (inFlight !== null) return inFlight;
+	inFlight = (async () => {
+		let value = null;
+		try {
+			const response = await fetcher(facts.baseUrl.replace(/\/+$/, "") + "/user/balance", {
+				headers: {
+					accept: "application/json",
+					authorization: "Bearer " + facts.apiKey
+				},
+				signal: AbortSignal.timeout(FETCH_TIMEOUT_MS)
+			});
+			if (response.ok) value = balanceOfPayload(await response.json());
+		} catch {}
+		cache = {
+			key,
+			at: Date.now(),
+			value
+		};
+		return value;
+	})();
+	const settled = inFlight;
+	try {
+		return await settled;
+	} finally {
+		inFlight = null;
+	}
+}
+/**
+* Serve the balance route whenever the connection service composes (see
+* host/detail.ts for the load-order contract). The registration rides the
+* injected fiber: the service unloading withdraws the route. A rejecting
+* registry only closes the capsule — never the plugin.
+*/
+function watchBalanceChannel(ctx) {
+	ctx.inject(["connection"], (c) => {
+		const connection = c.get("connection");
+		const register = typeof connection?.fetch?.register === "function" ? connection.fetch.register.bind(connection.fetch) : void 0;
+		if (register === void 0) return;
+		const handler = async () => {
+			const facts = await resolveFacts(ctx);
+			const value = facts !== null ? await readBalance(facts) : null;
+			return Response.json({
+				ok: true,
+				value
+			}, { headers: { "cache-control": "no-store" } });
+		};
+		try {
+			c.effect(() => register({
+				path: BALANCE_ROUTE,
+				methods: ["POST"],
+				requestBody: "buffered",
+				fetch: handler
+			}), "dsh-context: balance route");
+		} catch {
+			return;
+		}
+	});
+}
+//#endregion
 //#region src/host/backfill.ts
 /** The plugin's warm-up trigger route, under the authenticated `/api` fence. */
 const BACKFILL_ROUTE = "/api/dsh-context/backfill";
@@ -2067,8 +2224,15 @@ const BACKFILL_ROUTE = "/api/dsh-context/backfill";
 * workspace sidebar rides it), so the pass breathes between sessions.
 */
 const YIELD_MS = 100;
-/** The `name` dsh raises for a durable log its migration surface refuses. */
-const UNSUPPORTED_MIGRATION = "SessionFormatUnsupportedMigrationError";
+/**
+* The `name` family dsh raises for a durable log it cannot interpret. The
+* format edge throws `SessionFormatUnsupportedMigrationError`, but the
+* persistence seam translates it — together with every other "intact yet not
+* interpretable" refusal — into `SessionFormatUnsupportedError` before the
+* error escapes (issue #75): classify by the family prefix, since either
+* exact name may be the one that arrives.
+*/
+const UNSUPPORTED_FORMAT = "SessionFormatUnsupported";
 function asRecord(value) {
 	return value !== null && typeof value === "object" ? value : null;
 }
@@ -2123,15 +2287,15 @@ function isLive(sessions, id) {
 	}
 }
 /**
-* Whether the cold read failed because the running harness refuses to
-* migrate this log — a permanent, source-side refusal (the artifact is left
-* unchanged, so retrying cannot succeed). Matched by the error's documented
-* `name`, so no dsh symbol needs importing and every supported baseline
-* classifies alike: an unknown error shape just falls to the warn path.
+* Whether the cold read failed because the running harness refuses this log's
+* format — a permanent, source-side refusal (the artifact is left unchanged,
+* so retrying cannot succeed). Matched by the error's documented `name`, so no
+* dsh symbol needs importing and every supported baseline classifies alike: an
+* unknown error shape just falls to the warn path.
 */
-function isUnsupportedMigration(error) {
+function isUnsupportedFormat(error) {
 	try {
-		return asRecord(error)?.name === UNSUPPORTED_MIGRATION;
+		return String(asRecord(error)?.name).startsWith(UNSUPPORTED_FORMAT);
 	} catch {
 		return false;
 	}
@@ -2210,7 +2374,7 @@ function watchActivityBackfill(ctx) {
 					cache.coldSnapshot(log.header, log.inheritedEventCount, log.events);
 					folded++;
 				} catch (error) {
-					if (isUnsupportedMigration(error)) {
+					if (isUnsupportedFormat(error)) {
 						refused++;
 						ctx.logger.debug(`dsh-context: projection backfill skipped "${header.id}" (${messageOf(error)})`);
 					} else ctx.logger.warn(`dsh-context: projection backfill skipped "${header.id}" (${messageOf(error)})`);
@@ -3281,6 +3445,7 @@ function detectHarnessVersion(ctx, resolveUrl = resolveRunningModule, pluginRoot
 const name = "dsh-context";
 const inject = ["sessionProjections"];
 function apply(ctx, config) {
+	watchBalanceChannel(ctx);
 	const harnessVersion = detectHarnessVersion(ctx);
 	if (harnessVersion !== void 0 && !meetsBaseline(harnessVersion)) {
 		ctx.sessionProjections.register(createFallbackTimelineDefinition(harnessVersion));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-context",
-  "version": "0.53.4",
+  "version": "0.54.0",
   "description": "A DeepSeek Harness plugin for context insight and management, with context dashboard and context command, for understanding how the context is made of, and how it evolves.",
   "author": "bowenliang123",
   "repository": {