@linxin666/dsh-usage 0.3.20 → 0.3.22

package/lib/index.js

@@ -585,22 +585,22 @@ const PEAK_WINDOWS = [{
 }];
 /** Beijing is UTC+8 year-round (no DST), so a fixed shift is exact. */
 const BEIJING_UTC_OFFSET_MS = 8 * 36e5;
-/** deepseek-v4-flash (and the flash-class vision experiment). */
+/** deepseek-flash (DeepSeek-V4.1-Flash), including the retired flash-class ids it now serves. */
 const FLASH_PRICE = {
 	cacheHit: {
-		offPeak: .05,
-		peak: .1
+		offPeak: .02,
+		peak: .04
 	},
 	inputMiss: {
-		offPeak: 1.5,
-		peak: 3
+		offPeak: 1,
+		peak: 2
 	},
 	output: {
-		offPeak: 4.5,
-		peak: 9
+		offPeak: 4,
+		peak: 8
 	}
 };
-/** deepseek-v4-pro. */
+/** deepseek-v4-pro (DeepSeek-V4-Pro-0813); superseded by the flash row at the retirement instant. */
 const PRO_PRICE = {
 	cacheHit: {
 		offPeak: .15,
@@ -615,6 +615,12 @@ const PRO_PRICE = {
 		peak: 27
 	}
 };
+/**
+* The instant DeepSeek starts serving `deepseek-v4-pro` requests from
+* V4.1-Flash and billing the flash row: 2026-09-14 12:00 Beijing (UTC+8).
+* Drop the pro row's time fence once V4.1 Pro ships with a published row.
+*/
+const V4_PRO_FOLDED_INTO_FLASH_AT_MS = Date.UTC(2026, 8, 14, 4, 0);
 function withinWindow(minuteOfDay) {
 	return PEAK_WINDOWS.find((window) => minuteOfDay >= window.from && minuteOfDay < window.to);
 }
@@ -650,9 +656,9 @@ function deepseekPeriodAt(ms) {
 		boundaryMs: ms + 864e5
 	};
 }
-/** The price row for a model id; unknown ids take the flash-class row (documented estimate). */
-function priceFor(model) {
-	return model.includes("v4-pro") ? PRO_PRICE : FLASH_PRICE;
+/** The price row for a model id at `atMs`; unknown ids take the flash-class row (documented estimate). */
+function priceFor(model, atMs) {
+	return model.includes("v4-pro") && atMs < V4_PRO_FOLDED_INTO_FLASH_AT_MS ? PRO_PRICE : FLASH_PRICE;
 }
 /**
 * Estimate one call's DeepSeek spend in CNY from its token totals, priced in
@@ -661,7 +667,7 @@ function priceFor(model) {
 * by route family). Rounded to micro-CNY so the ledger stays readable.
 */
 function deepseekModelSpend(model, totals, atMs) {
-	const price = priceFor(model);
+	const price = priceFor(model, atMs);
 	const column = deepseekPeriodAt(atMs).peak ? "peak" : "offPeak";
 	const spend = (totals.cacheReadTokens * price.cacheHit[column] + (totals.inputTokens + totals.cacheWriteTokens) * price.inputMiss[column] + totals.outputTokens * price.output[column]) / 1e6;
 	return Math.round(spend * 1e6) / 1e6;
@@ -1008,6 +1014,8 @@ var UsageService = class {
 	snapshotsPath;
 	ledger = createLedgerDocument();
 	snapshots = /* @__PURE__ */ new Map();
+	/** The official DeepSeek family's real-spend watch (see SpendWatch). */
+	spendWatch;
 	/** Per-live-session route attribution (WeakMap: disposed sessions age out). */
 	sessionRoutes = /* @__PURE__ */ new WeakMap();
 	/** The most recent route seen this boot; the pet bubble follows it. */
@@ -1083,8 +1091,10 @@ var UsageService = class {
 			});
 		}
 		providers.sort((a, b) => Number(b.supported) - Number(a.supported) || a.displayName.localeCompare(b.displayName));
-		const days = ledgerDayKeys(this.ledger).slice(-30);
+		const allKeys = ledgerDayKeys(this.ledger);
+		const days = allKeys.slice(-30);
 		const range = summarizeDays(days.map((key) => this.ledger.days[key] ?? {}));
+		const all = summarizeDays(allKeys.map((key) => this.ledger.days[key] ?? {}));
 		return {
 			updatedAt: Date.now(),
 			providers,
@@ -1102,7 +1112,17 @@ var UsageService = class {
 					to: days[days.length - 1] ?? todayKey,
 					totals: range.totals,
 					providers: range.providers
-				}
+				},
+				all: {
+					from: allKeys[0] ?? todayKey,
+					to: allKeys[allKeys.length - 1] ?? todayKey,
+					totals: all.totals,
+					providers: all.providers
+				},
+				...this.spendWatch !== void 0 && this.spendWatch.accruedCny > 0 ? { observedSpend: {
+					cny: this.spendWatch.accruedCny,
+					since: this.spendWatch.since
+				} } : {}
 			}
 		};
 	}
@@ -1128,6 +1148,33 @@ var UsageService = class {
 		return this.daySummary(localDateKey(Date.now())).providers.find((entry) => entry.provider === provider)?.totals ?? emptyTotals();
 	}
 	/**
+	* Accrue the official DeepSeek family's real spend from observed CNY
+	* balance decreases; a balance rise is a top-up and never counts. The
+	* family's route ids can alias one account, so the watch follows the
+	* largest balance seen this cycle and accrues only decreases of that
+	* series — a failed probe keeps the stale balance and accrues nothing
+	* until the next success reports the whole drop at once.
+	*/
+	accrueDeepSeekSpend() {
+		let balanceCny;
+		for (const [id, snapshot] of this.snapshots) {
+			if (!isDeepSeekProviderRoute(id)) continue;
+			const balance = snapshot.balance;
+			if (balance === void 0 || balance.currency.toUpperCase() !== "CNY") continue;
+			const value = Number(balance.totalBalance);
+			if (!Number.isFinite(value)) continue;
+			balanceCny = balanceCny === void 0 ? value : Math.max(balanceCny, value);
+		}
+		if (balanceCny === void 0) return;
+		const watch = this.spendWatch ?? {
+			accruedCny: 0,
+			since: Date.now()
+		};
+		if (watch.lastBalanceCny !== void 0 && balanceCny < watch.lastBalanceCny) watch.accruedCny += watch.lastBalanceCny - balanceCny;
+		watch.lastBalanceCny = balanceCny;
+		this.spendWatch = watch;
+	}
+	/**
 	* The display name for a route key: the LLM runtime's first, then the
 	* adapter's, then the id itself — the snapshot may not exist for
 	* adapter-less routes, yet the bubble still needs a legible title.
@@ -1209,6 +1256,12 @@ var UsageService = class {
 				if (typeof parsed === "object" && parsed !== null && typeof parsed.providers === "object" && parsed.providers !== null) {
 					for (const [provider, snapshot] of Object.entries(parsed.providers)) if (typeof snapshot === "object" && snapshot !== null && typeof snapshot.provider === "string") this.snapshots.set(provider, snapshot);
 				}
+				const watch = parsed.spendWatch;
+				if (typeof watch === "object" && watch !== null && typeof watch.accruedCny === "number" && Number.isFinite(watch.accruedCny) && watch.accruedCny >= 0 && typeof watch.since === "number" && Number.isFinite(watch.since) && watch.since > 0) this.spendWatch = {
+					accruedCny: watch.accruedCny,
+					since: watch.since,
+					...typeof watch.lastBalanceCny === "number" && Number.isFinite(watch.lastBalanceCny) ? { lastBalanceCny: watch.lastBalanceCny } : {}
+				};
 			}
 		} catch {} finally {
 			this.loaded = true;
@@ -1259,7 +1312,8 @@ var UsageService = class {
 			await mkdir(dirname(this.snapshotsPath), { recursive: true });
 			await writeJsonAtomic(this.snapshotsPath, {
 				version: 1,
-				providers: Object.fromEntries(this.snapshots)
+				providers: Object.fromEntries(this.snapshots),
+				...this.spendWatch !== void 0 ? { spendWatch: this.spendWatch } : {}
 			});
 		} catch {}
 	}
@@ -1294,6 +1348,7 @@ var UsageService = class {
 				}
 				for (const id of [...this.snapshots.keys()]) if (!seen.has(id)) this.snapshots.delete(id);
 				if (this.disposed) return;
+				this.accrueDeepSeekSpend();
 				await this.persistSnapshots();
 				this.announceCurrent();
 			} finally {

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

@@ -1,7 +1,8 @@
 /**
- * The usage statistics settings section: two tabs (用量: today's usage,
- * balances, trend; 个人套餐: per-provider plan quota windows) plus a compact
- * settings row. Data comes from the host's loopback-fenced
+ * The usage statistics settings section: three tabs (用量: today's usage,
+ * balances, trend; 个人套餐: per-provider plan quota windows; Token 银行:
+ * the whale-yuan voucher minted from the DeepSeek official family's usage)
+ * plus a compact settings row. Data comes from the host's loopback-fenced
  * /api/dsh-usage/overview document; polling runs only while the section is
  * mounted and the tab is visible.
  * @module @linxin666/dsh-usage/client/UsageSectionCard

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

@@ -10,11 +10,13 @@ export declare const zh: {
     'usage.title': string;
     'usage.tab.usage': string;
     'usage.tab.plans': string;
+    'usage.tab.bank': string;
     'usage.refresh': string;
     'usage.refreshing': string;
     'usage.updated': string;
     'usage.loading': string;
     'usage.error': string;
+    'usage.disabled': string;
     'usage.current': string;
     'usage.today': string;
     'usage.today.cost': string;
@@ -48,6 +50,16 @@ export declare const zh: {
     'usage.config.bubbleMode.always': string;
     'usage.config.bubbleMode.change': string;
     'usage.config.bubbleMode.off': string;
+    'usage.bank.title': string;
+    'usage.bank.hint': string;
+    'usage.bank.noUsage': string;
+    'usage.bank.minted': string;
+    'usage.bank.spend.observed': string;
+    'usage.bank.spend.estimated': string;
+    'usage.bank.window': string;
+    'usage.bank.save': string;
+    'usage.bank.share': string;
+    'usage.bank.drawError': string;
 };
 /** English mirror; every zh key present. */
 export declare const en: Record<UsageKey, string>;