@kenz1117/dsh-ui-usage-billing 1.0.42 → 1.0.44

package/lib/index.js

@@ -238,6 +238,36 @@ const PEAK_ERA_START_MS = Date.parse("2026-08-16T16:00:00Z");
 */
 const WEEKEND_OFFPEAK_START_MS = Date.parse("2026-08-22T16:00:00Z");
 /**
+* flash 系调价分界（UTC 2026-09-10T04:00:00Z，即北京时间 2026-09-10 12:00）：
+* 官方自此刻起 V4 Flash / V4 Flash Vision (Exp) 调价——谷档 1.5/0.05/4.5 →
+* 1/0.02/4（峰 = 谷 × 2）。目录条目写现行（新）价；分界前的历史事件由
+* {@link computeCostAt} 按 {@link FLASH_REPRICED_OFFPEAK} 回算旧价，与
+* {@link PEAK_ERA_START_MS} 同一「按事件时刻分段适用规则」口径。
+*/
+const FLASH_REPRICE_MS = Date.parse("2026-09-10T04:00:00Z");
+/**
+* flash 系调价前的官方谷档价（CNY / 1M tokens）：{@link FLASH_REPRICE_MS}
+* 之前的 flash / flash-vision-exp 事件按此回算（峰档 = 谷档 × 2）。pro 的
+* 同表条目是 V4 Pro 峰谷时代刊例（谷 4.5/0.15/13.5）：官方公告自
+* {@link FLASH_REPRICE_MS} 起 V4 Pro 请求全部路由至 V4.1 Flash 并按其单价
+* 计费（V4.1 Pro 上线前），故分界前回算 V4 Pro 刊例、分界后走目录的 Flash 价。
+* 用户价 = 实付价，与 legacy 口径相同地跳过本表。
+*/
+const FLASH_PRE_REPRICE_BAND = {
+	input: 1.5,
+	cacheHit: .05,
+	output: 4.5
+};
+const FLASH_REPRICED_OFFPEAK = {
+	flash: FLASH_PRE_REPRICE_BAND,
+	"flash-vision-exp": FLASH_PRE_REPRICE_BAND,
+	pro: {
+		input: 4.5,
+		cacheHit: .15,
+		output: 13.5
+	}
+};
+/**
 * DeepSeek V4 峰谷时代之前的官方基础价（CNY / 1M tokens）：官方中文定价页
 * 峰谷改版前的基础价档（缓存写沿用历史规则按命中价计）。键为内置目录键，
 * flash-vision-exp 与 flash 同价。仅当事件时刻早于 {@link PEAK_ERA_START_MS}
@@ -300,6 +330,8 @@ function isBeijingWeekend(timeMs) {
 * splits peak (09:00-12:00 / 14:00-18:00 Beijing) at 2x the off-peak rate
 * from 2026-08-17, and Gemini's Flex tier discounts spare-capacity traffic.
 */
+/** DeepSeek 官方高峰时段说明（峰谷分时计费目录条目共用）。 */
+const DEEPSEEK_PEAK_HOURS = "09:00-12:00 / 14:00-18:00";
 const MODEL_CATALOG = [
 	{
 		key: "flash",
@@ -308,16 +340,16 @@ const MODEL_CATALOG = [
 		colorVar: "dsw-static-blue-500",
 		price: {
 			currency: "CNY",
-			input: 3,
-			cacheHit: .1,
-			output: 9,
+			input: 2,
+			cacheHit: .04,
+			output: 8,
 			offPeak: {
-				input: 1.5,
-				cacheHit: .05,
-				output: 4.5
+				input: 1,
+				cacheHit: .02,
+				output: 4
 			}
 		},
-		peakHours: "09:00-12:00 / 14:00-18:00"
+		peakHours: DEEPSEEK_PEAK_HOURS
 	},
 	{
 		key: "flash-vision-exp",
@@ -326,16 +358,16 @@ const MODEL_CATALOG = [
 		colorVar: "dsw-static-blue-500",
 		price: {
 			currency: "CNY",
-			input: 3,
-			cacheHit: .1,
-			output: 9,
+			input: 2,
+			cacheHit: .04,
+			output: 8,
 			offPeak: {
-				input: 1.5,
-				cacheHit: .05,
-				output: 4.5
+				input: 1,
+				cacheHit: .02,
+				output: 4
 			}
 		},
-		peakHours: "09:00-12:00 / 14:00-18:00"
+		peakHours: DEEPSEEK_PEAK_HOURS
 	},
 	{
 		key: "pro",
@@ -344,16 +376,16 @@ const MODEL_CATALOG = [
 		colorVar: "dsw-static-deepseek-500",
 		price: {
 			currency: "CNY",
-			input: 9,
-			cacheHit: .3,
-			output: 27,
+			input: 2,
+			cacheHit: .04,
+			output: 8,
 			offPeak: {
-				input: 4.5,
-				cacheHit: .15,
-				output: 13.5
+				input: 1,
+				cacheHit: .02,
+				output: 4
 			}
 		},
-		peakHours: "09:00-12:00 / 14:00-18:00"
+		peakHours: DEEPSEEK_PEAK_HOURS
 	},
 	{
 		key: "glm",
@@ -1388,6 +1420,7 @@ const MODEL_CATALOG = [
 const MODEL_KEY_ALIASES = {
 	"deepseek-v4-flash": "flash",
 	"deepseek-v4-flash-vision-exp": "flash-vision-exp",
+	"deepseek-v4.1-flash": "flash",
 	"deepseek-v4-pro": "pro",
 	"glm-5.2": "glm",
 	"glm-4.5-air": "glm-4.5-air",
@@ -1725,6 +1758,12 @@ function computeCostAt(entry, buckets, timeMs, peakShare = DEFAULT_PEAK_SHARE) {
 	const priced = applyPromo(entry, timeMs);
 	const legacy = timeMs < PEAK_ERA_START_MS && entry.userPriced !== true ? LEGACY_DEEPSEEK_BANDS[entry.key] : void 0;
 	if (legacy !== void 0) return priceBandCost(legacy, buckets, "CNY");
+	const repriced = timeMs < FLASH_REPRICE_MS && entry.userPriced !== true ? FLASH_REPRICED_OFFPEAK[entry.key] : void 0;
+	if (repriced !== void 0) return priceBandCost((timeMs < WEEKEND_OFFPEAK_START_MS ? tariffV1At(timeMs) : tierAt(timeMs)) === "peak" ? {
+		input: repriced.input * 2,
+		cacheHit: repriced.cacheHit * 2,
+		output: repriced.output * 2
+	} : repriced, buckets, "CNY");
 	if (priced.price.offPeak === void 0) return priceBandCost(priced.price, buckets, priced.price.currency);
 	return priceBandCost((timeMs < WEEKEND_OFFPEAK_START_MS ? tariffV1At(timeMs) : tierAt(timeMs)) === "peak" ? priced.price : priced.price.offPeak, buckets, priced.price.currency);
 }
@@ -2459,7 +2498,7 @@ function createUsageAggregator(persistence, options = {}) {
 			id,
 			...cwd === void 0 ? {} : { cwd },
 			...stamp === null ? {} : { stamp },
-			foldVersion: 10,
+			foldVersion: 12,
 			fingerprint: foldFingerprint,
 			fold: serializeFold(fold)
 		};
@@ -2556,7 +2595,7 @@ function createUsageAggregator(persistence, options = {}) {
 			try {
 				const cwd = meta.cwd;
 				const ledgerRow = ledger.get(id);
-				if (ledgerRow !== void 0 && ledgerRow.stamp !== void 0 && stamp !== null && ledgerRow.stamp === stamp && (ledgerRow.foldVersion ?? 1) === 10 && ledgerRow.fingerprint === foldFingerprint) {
+				if (ledgerRow !== void 0 && ledgerRow.stamp !== void 0 && stamp !== null && ledgerRow.stamp === stamp && (ledgerRow.foldVersion ?? 1) === 12 && ledgerRow.fingerprint === foldFingerprint) {
 					const fold = deserializeFold(ledgerRow.fold);
 					folds.push({
 						id,
@@ -2638,7 +2677,7 @@ function createUsageAggregator(persistence, options = {}) {
 			for (const entry of ledger.values()) {
 				if (included.has(entry.id)) continue;
 				try {
-					const stale = (entry.foldVersion ?? 1) < 10 || entry.fingerprint !== foldFingerprint;
+					const stale = (entry.foldVersion ?? 1) < 12 || entry.fingerprint !== foldFingerprint;
 					folds.push({
 						id: entry.id,
 						...entry.cwd === void 0 ? {} : { cwd: entry.cwd },
@@ -5714,13 +5753,7 @@ function apply(ctx, config = {}) {
 		const now = Date.now();
 		if (now - lastSnapshotAt < SNAPSHOT_INTERVAL_MS) return;
 		lastSnapshotAt = now;
-		const payload = JSON.stringify({
-			...doc,
-			_writer: {
-				pid: process.pid,
-				at: now
-			}
-		});
+		const payload = JSON.stringify(doc);
 		(async () => {
 			try {
 				const existing = await readFile(snapshotPath, "utf8");
@@ -5744,13 +5777,67 @@ function apply(ctx, config = {}) {
 		} catch {}
 		return null;
 	};
-	(async () => {
-		try {
-			const text = await readFile(snapshotPath, "utf8");
-			const writer = JSON.parse(text)._writer;
-			if (writer?.pid !== void 0 && writer.pid !== process.pid && writer.at !== void 0 && Date.now() - writer.at < 6e4) console.warn(`[usage-billing] 检测到另一实例（pid ${writer.pid}）正在提供用量统计，双实例可能导致提醒重复。`);
-		} catch {}
-	})();
+	const notifyClaimsPath = `${snapshotPath}.notify-claims.json`;
+	const notifyClaims = {
+		loaded: false,
+		keys: []
+	};
+	ctx.effect(() => ctx.webServer.register({
+		kind: "exact",
+		path: "/api/billing/notify-claim",
+		handler: async (req, res) => {
+			if (!guardLoopback(req, res)) return;
+			if (req.method !== "POST") {
+				res.writeHead(405, { "content-type": "application/json; charset=utf-8" });
+				res.end(JSON.stringify({ error: "method not allowed" }));
+				return;
+			}
+			if (!isLoopbackOrigin(req.headers.origin) || !(req.headers["content-type"] ?? "").toLowerCase().includes("application/json")) {
+				res.writeHead(403, { "content-type": "application/json; charset=utf-8" });
+				res.end(JSON.stringify({ error: "forbidden: loopback only" }));
+				return;
+			}
+			try {
+				let body = "";
+				for await (const chunk of req) {
+					body += String(chunk);
+					if (body.length > 2048) {
+						res.end(JSON.stringify({ error: "body too large" }));
+						return;
+					}
+				}
+				const parsed = JSON.parse(body === "" ? "{}" : body);
+				if (typeof parsed.key !== "string" || parsed.key === "" || parsed.key.length > 200) {
+					res.writeHead(400, { "content-type": "application/json; charset=utf-8" });
+					res.end(JSON.stringify({ error: "invalid key" }));
+					return;
+				}
+				if (!notifyClaims.loaded) {
+					notifyClaims.loaded = true;
+					try {
+						const stored = JSON.parse(await readFile(notifyClaimsPath, "utf8"));
+						if (Array.isArray(stored.keys)) notifyClaims.keys = stored.keys.filter((k) => typeof k === "string");
+					} catch {}
+				}
+				if (notifyClaims.keys.includes(parsed.key)) {
+					res.writeHead(200, { "content-type": "application/json; charset=utf-8" });
+					res.end(JSON.stringify({ claimed: false }));
+					return;
+				}
+				notifyClaims.keys.push(parsed.key);
+				if (notifyClaims.keys.length > 400) notifyClaims.keys = notifyClaims.keys.slice(-200);
+				writeFileAtomic(notifyClaimsPath, JSON.stringify({ keys: notifyClaims.keys }), {
+					mode: 384,
+					dirMode: 448
+				}).catch(() => {});
+				res.writeHead(200, { "content-type": "application/json; charset=utf-8" });
+				res.end(JSON.stringify({ claimed: true }));
+			} catch {
+				res.writeHead(400, { "content-type": "application/json; charset=utf-8" });
+				res.end(JSON.stringify({ error: "invalid" }));
+			}
+		}
+	}), "usage-billing: notify-claim route");
 	ctx.inject(["settings"], (sctx) => {
 		const scope = sctx.settings.register(usageBillingSettingsNs, UsageBillingSettingsSchema, { base: { enableUsageStatsTool: config.enableUsageStatsTool ?? false } });
 		usageSettingsScope = scope;

package/lib/types/aggregate.d.ts

@@ -478,7 +478,7 @@ export interface UsageLedgerDocument {
  * 会话费用只剩最近一段，issue #29）。
  * 持久账本行据此区分新旧算法：日志已删/不可读而只能沿用旧行时，UI 标注置信度提示。
  */
-export declare const FOLD_VERSION = 10;
+export declare const FOLD_VERSION = 12;
 /**
  * 一次性账本迁移：id 唯一，apply 在加载边界对原始文档执行，已应用过的跳过。
  * 未来账本/schema 字段变更（重命名、拆桶、语义调整）时，在此追加一条迁移并

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

@@ -84,6 +84,15 @@ export declare function projectMonthCost(byDay: Record<string, {
  * @returns 重估后的文档；无用户价或缺 byDayModels 时原样返回。
  */
 export declare function recostWithUserPrices(stats: UsageStats): UsageStats;
+/**
+ * 跨实例提醒认领后发系统通知（issue #44）：多实例（CLI + 桌面等）合法共存，
+ * 各自轮询会重复弹通知。两级去重——进程内 Set 挡同进程的并发/重渲染（trigger
+ * 与仪表盘是两个组件实例，effect 同周期并发时本地 store 标记读到的还是旧值）；
+ * 跨进程走宿主认领端点（先到先得），另一实例刚发过则跳过。端点不可达（旧版本/
+ * 网络故障）时放行，退化为原有 per-客户端去重。通知构造失败（平台限制）静默。
+ * Set 导出供测试重置（模块级状态会跨用例泄漏）。
+ */
+export declare const notifiedKeys: Set<string>;
 /** 近 7 天费用序列（含今天，缺日补 0）：触发卡 hover 速览的迷你柱数据源。
  * 导出供测试：纯函数（日期取本地时区）。 */
 export declare function activeDaysOf(byDay: Record<string, {
@@ -126,6 +135,10 @@ interface SessionBillingRow {
     calls: number;
     cost: number;
     lastActive: number;
+    /** 展示层合并标记（issue #42）：同标题会话归并后的段数（>1 时行尾显示 ×N）。 */
+    mergedCount?: number;
+    /** 合并组的段明细（展示层专用）：一级行默认收起，展开后逐段显示。合并函数需 push，故非 readonly。 */
+    children?: SessionBillingRow[];
 }
 /** Usage stats structure from `.dsh-usage-stats.json`. */
 export interface UsageStats {

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

@@ -1,5 +1,5 @@
 /** Locale dictionaries for the usage billing surface. */
-export type UsageBillingKey = 'title' | 'cost' | 'todayCost' | 'monthCost' | 'yearCost' | 'monthProjected' | 'liveTurn' | 'liveSession' | 'calls' | 'cacheHitRate' | 'tokens' | 'inputTokens' | 'outputTokens' | 'avgCost' | 'trend' | 'trend7d' | 'trend30d' | 'trendMetric' | 'trendMetricCost' | 'trendMetricTokens' | 'trendEmpty' | 'budget' | 'budgetAmount' | 'budgetSummary' | 'sessions' | 'sessionTitle' | 'lastActive' | 'sessionOverflow' | 'budgetTierBody' | 'models' | 'providerBilling' | 'channelUnknown' | 'actual' | 'pricing' | 'input' | 'output' | 'cacheHit' | 'peak' | 'offPeak' | 'flat' | 'band' | 'close' | 'footer' | 'footerCredit' | 'lastUpdated' | 'noData' | 'todayRate' | 'rateLive' | 'rateBuiltin' | 'promoBadge' | 'promoUntil' | 'promoOpenEnded' | 'pricingTip' | 'pricingUnit' | 'pricingNotes' | 'ubPeak' | 'ubOff' | 'ubStd' | 'peakBand' | 'pricingSource' | 'noteCache' | 'noteBand' | 'noteSource' | 'balance' | 'balanceUnconfigured' | 'balanceUnauthorized' | 'balanceUnreachable' | 'uncatalogued' | 'estimatedPricing' | 'balanceDays' | 'balanceLowBody' | 'reconcileDrift' | 'reconcileDismiss' | 'subscriptionNotConfigured' | 'subscriptionUnauthorized' | 'subscriptionUnavailable' | 'subscriptionInvalid' | 'subscriptionRateLimited' | 'subscriptionSession' | 'subscriptionWeekly' | 'subscriptionMonthly' | 'subscriptionBilling' | 'subscriptionRemaining' | 'subscriptionExhausted' | 'subscriptionReset' | 'subscriptionNoApi' | 'floatWindow' | 'floatModeCombined' | 'floatModeSubscription' | 'floatMode' | 'floatTargets' | 'floatWindowHint' | 'floatNoTargets' | 'floatNoTargetsHint' | 'cardDisplay' | 'cardDisplayHint' | 'cardMetric' | 'cardMetricMoney' | 'cardMetricTokens' | 'triggerMonthTokens' | 'subscriptionsStale' | 'staleLedgerNotice' | 'tokenCacheWrite' | 'toolRank' | 'toolName' | 'userPrices' | 'userPricesHint' | 'userPriceSave' | 'userPriceModel' | 'userPriceSource' | 'userPriceSourceHint' | 'userPriceOffPeak' | 'userPriceNormal' | 'userPriceCurrency' | 'userPriceAdd' | 'userPriceRemoveSelected' | 'userPriceSelect' | 'sessionStaleBadge' | 'heatmapLess' | 'heatmapMore' | 'currency' | 'currencyCny' | 'currencyUsd' | 'heatmap' | 'rounds' | 'roundsHint' | 'anomaly' | 'workspaceSubtotal' | 'model' | 'thModel' | 'thInputMiss' | 'thInputHit' | 'costAbbr' | 'tabOverview' | 'tabTrends' | 'tabProviders' | 'tabPricing' | 'tabSettings' | 'budgetHint' | 'peakAlertHint' | 'peakAlertDescPeak' | 'peakAlertDescOff' | 'export' | 'exportCsvDay' | 'exportCsvSession' | 'exportJson' | 'peakShare' | 'peakSharePerCall' | 'offPeakSavings' | 'perfMax' | 'weekCost' | 'roleCost' | 'roleUser' | 'roleAssistant' | 'roleTool' | 'roleHint' | 'tierPeak' | 'tierOff' | 'tierToPeak' | 'tierToOff' | 'tierAlertEnterPeak' | 'tierAlertEnterOff' | 'peakAlertTitlePeak' | 'peakAlertTitleOff' | 'peakAlert' | 'peakAlertLeadMin' | 'peakAlertPos' | 'peakAlertMode' | 'peakAlertPosCorner' | 'peakAlertPosCenter' | 'peakAlertModePeak' | 'peakAlertModeOff' | 'peakAlertModeBoth' | 'peakAlertWebNotify' | 'peakAlertPreview' | 'planTypeCode' | 'planTypeToken' | 'subscriptionFeePerMonth' | 'triggerToday' | 'triggerMonth' | 'subscriptionIncluded' | 'free' | 'official' | 'thirdParty' | 'perfSamples' | 'perfTtft' | 'perfP50' | 'perfP90' | 'perfTps' | 'perfLatency' | 'perfEstimated' | 'perfEmpty' | 'perfTpsUnit' | 'perfTitle' | 'perfHint' | 'perfAll' | 'perfChartEmpty' | 'heatmapYear' | 'heatmapMonth' | 'activeDays' | 'streakDays' | 'subscriptionAutoDetect' | 'pluginAuthor' | 'pluginRepository' | 'pluginNpm' | 'pluginLicense' | 'tabToken' | 'tokenExport' | 'tokenExportCsv' | 'tokenCacheHitRate' | 'tokenReasoningShare' | 'tokenReasoningShort' | 'tokenIo' | 'tokenPeak' | 'tokenDaily' | 'tokenByModel' | 'tokenMiss' | 'tokenHit' | 'tokenOutput' | 'tokenViewStructure' | 'tokenViewModel' | 'tokenHitShort' | 'tokenMissShort' | 'tokenTotal' | 'tokenShare' | 'usageStatsTool' | 'usageStatsToolHint' | 'balanceGranted' | 'balanceTopped' | 'balanceDaily' | 'balanceDaysLong' | 'balanceDaysUnit' | 'popTodayModel' | 'popNoConsumption' | 'popTitle' | 'popDirectLead' | 'popSubLead' | 'unpricedHint' | 'searchEstimateHint' | 'siteListDisplay' | 'siteListDisplayHint' | 'liveCostBar' | 'liveCostBarHint' | 'liveCostBarPosition' | 'liveCostBarPosBelow' | 'liveCostBarPosAbove' | 'liveCostBarPosToolbar' | 'exportCsvSite' | 'panelRelayQuota' | 'relayBalance' | 'relayNoQuota' | 'relayWindowUsed' | 'relayKindNewApi' | 'relayKindSub2Api' | 'relayKindUnknown';
+export type UsageBillingKey = 'title' | 'cost' | 'todayCost' | 'monthCost' | 'yearCost' | 'monthProjected' | 'liveTurn' | 'liveSession' | 'calls' | 'cacheHitRate' | 'tokens' | 'inputTokens' | 'outputTokens' | 'avgCost' | 'trend' | 'trend7d' | 'trend30d' | 'trendMetric' | 'trendMetricCost' | 'trendMetricTokens' | 'trendEmpty' | 'budget' | 'budgetAmount' | 'budgetSummary' | 'sessions' | 'sessionTitle' | 'lastActive' | 'sessionOverflow' | 'budgetTierBody' | 'models' | 'providerBilling' | 'channelUnknown' | 'actual' | 'pricing' | 'input' | 'output' | 'cacheHit' | 'peak' | 'offPeak' | 'flat' | 'band' | 'close' | 'footer' | 'footerCredit' | 'lastUpdated' | 'noData' | 'todayRate' | 'rateLive' | 'rateBuiltin' | 'promoBadge' | 'promoUntil' | 'promoOpenEnded' | 'pricingTip' | 'pricingUnit' | 'pricingNotes' | 'ubPeak' | 'ubOff' | 'ubStd' | 'peakBand' | 'pricingSource' | 'noteCache' | 'noteBand' | 'noteSource' | 'balance' | 'balanceUnconfigured' | 'balanceUnauthorized' | 'balanceUnreachable' | 'uncatalogued' | 'estimatedPricing' | 'balanceDays' | 'balanceLowBody' | 'reconcileDrift' | 'reconcileDismiss' | 'subscriptionNotConfigured' | 'subscriptionUnauthorized' | 'subscriptionUnavailable' | 'subscriptionInvalid' | 'subscriptionRateLimited' | 'subscriptionSession' | 'subscriptionWeekly' | 'subscriptionMonthly' | 'subscriptionBilling' | 'subscriptionRemaining' | 'subscriptionExhausted' | 'subscriptionReset' | 'subscriptionNoApi' | 'floatWindow' | 'floatModeCombined' | 'floatModeSubscription' | 'floatMode' | 'floatTargets' | 'floatWindowHint' | 'floatNoTargets' | 'floatNoTargetsHint' | 'cardDisplay' | 'cardDisplayHint' | 'cardMetric' | 'cardMetricMoney' | 'cardMetricTokens' | 'triggerMonthTokens' | 'subscriptionsStale' | 'staleLedgerNotice' | 'tokenCacheWrite' | 'toolRank' | 'toolName' | 'userPrices' | 'userPricesHint' | 'userPriceSave' | 'userPriceModel' | 'userPriceSource' | 'userPriceSourceHint' | 'userPriceOffPeak' | 'userPriceNormal' | 'userPriceCurrency' | 'userPriceAdd' | 'userPriceRemoveSelected' | 'userPriceSelect' | 'sessionStaleBadge' | 'sessionUntitled' | 'heatmapLess' | 'heatmapMore' | 'currency' | 'currencyCny' | 'currencyUsd' | 'heatmap' | 'rounds' | 'roundsHint' | 'anomaly' | 'model' | 'thModel' | 'thInputMiss' | 'thInputHit' | 'costAbbr' | 'tabOverview' | 'tabTrends' | 'tabProviders' | 'tabPricing' | 'tabSettings' | 'budgetHint' | 'peakAlertHint' | 'peakAlertDescPeak' | 'peakAlertDescOff' | 'export' | 'exportCsvDay' | 'exportCsvSession' | 'exportJson' | 'peakShare' | 'peakSharePerCall' | 'offPeakSavings' | 'perfMax' | 'weekCost' | 'roleCost' | 'roleUser' | 'roleAssistant' | 'roleTool' | 'roleHint' | 'tierPeak' | 'tierOff' | 'tierToPeak' | 'tierToOff' | 'tierAlertEnterPeak' | 'tierAlertEnterOff' | 'peakAlertTitlePeak' | 'peakAlertTitleOff' | 'peakAlert' | 'peakAlertLeadMin' | 'peakAlertPos' | 'peakAlertMode' | 'peakAlertPosCorner' | 'peakAlertPosCenter' | 'peakAlertModePeak' | 'peakAlertModeOff' | 'peakAlertModeBoth' | 'peakAlertWebNotify' | 'peakAlertPreview' | 'planTypeCode' | 'planTypeToken' | 'subscriptionFeePerMonth' | 'triggerToday' | 'triggerMonth' | 'subscriptionIncluded' | 'free' | 'official' | 'thirdParty' | 'perfSamples' | 'perfTtft' | 'perfP50' | 'perfP90' | 'perfTps' | 'perfLatency' | 'perfEstimated' | 'perfEmpty' | 'perfTpsUnit' | 'perfTitle' | 'perfHint' | 'perfAll' | 'perfChartEmpty' | 'heatmapYear' | 'heatmapMonth' | 'activeDays' | 'streakDays' | 'subscriptionAutoDetect' | 'pluginAuthor' | 'pluginRepository' | 'pluginNpm' | 'pluginLicense' | 'tabToken' | 'tokenExport' | 'tokenExportCsv' | 'tokenCacheHitRate' | 'tokenReasoningShare' | 'tokenReasoningShort' | 'tokenIo' | 'tokenPeak' | 'tokenDaily' | 'tokenByModel' | 'tokenMiss' | 'tokenHit' | 'tokenOutput' | 'tokenViewStructure' | 'tokenViewModel' | 'tokenHitShort' | 'tokenMissShort' | 'tokenTotal' | 'tokenShare' | 'usageStatsTool' | 'usageStatsToolHint' | 'balanceGranted' | 'balanceTopped' | 'balanceDaily' | 'balanceDaysLong' | 'balanceDaysUnit' | 'popTodayModel' | 'popNoConsumption' | 'popTitle' | 'popDirectLead' | 'popSubLead' | 'unpricedHint' | 'searchEstimateHint' | 'siteListDisplay' | 'siteListDisplayHint' | 'liveCostBar' | 'liveCostBarHint' | 'liveCostBarPosition' | 'liveCostBarPosBelow' | 'liveCostBarPosAbove' | 'liveCostBarPosToolbar' | 'exportCsvSite' | 'panelRelayQuota' | 'relayBalance' | 'relayNoQuota' | 'relayWindowUsed' | 'relayKindNewApi' | 'relayKindSub2Api' | 'relayKindUnknown';
 export declare const NS = "usageBilling";
 export declare const zh: Record<UsageBillingKey, string>;
 export declare const en: Record<UsageBillingKey, string>;

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

@@ -153,6 +153,14 @@ export declare const PEAK_ERA_START_MS: number;
  * 档位判定按事件所在时段适用各自的规则，不得统一套现行规则重算历史。
  */
 export declare const WEEKEND_OFFPEAK_START_MS: number;
+/**
+ * flash 系调价分界（UTC 2026-09-10T04:00:00Z，即北京时间 2026-09-10 12:00）：
+ * 官方自此刻起 V4 Flash / V4 Flash Vision (Exp) 调价——谷档 1.5/0.05/4.5 →
+ * 1/0.02/4（峰 = 谷 × 2）。目录条目写现行（新）价；分界前的历史事件由
+ * {@link computeCostAt} 按 {@link FLASH_REPRICED_OFFPEAK} 回算旧价，与
+ * {@link PEAK_ERA_START_MS} 同一「按事件时刻分段适用规则」口径。
+ */
+export declare const FLASH_REPRICE_MS: number;
 /** 计费时段档位：高峰 / 空闲（官方 DeepSeek 刊例价：高峰 = 空闲 × 2）。 */
 export type PriceTierId = 'peak' | 'offPeak';
 /** 成本显示币种：人民币（国内模型直价）/ 美元（国外模型直价或换算显示）。 */
@@ -299,21 +307,6 @@ export interface ModelEntry {
     /** 该条目当前按用户自定义单价计价（设置面板可维护）；费率表标注「自定义」。 */
     userPriced?: boolean;
 }
-/**
- * Built-in catalog of current mainstream models as of 2026-08-16, priced from
- * each provider's official price page. Domestic providers are OpenAI-API
- * compatible and publish RMB prices directly; overseas providers publish USD
- * and convert through the exchange rate at estimate time. Retired models
- * (GPT-4o family, Gemini 2.x, GLM-4.x-lite, older Qwen) are deliberately
- * absent, as are Anthropic Claude models (their native API is not
- * OpenAI-compatible, so the harness cannot drive them directly). DeepSeek
- * keys match the harness stats file so real usage prices from the catalog;
- * unknown keys fall back to `other`.
- *
- * Time-of-day billing (peak/off-peak) is now real: DeepSeek V4 officially
- * splits peak (09:00-12:00 / 14:00-18:00 Beijing) at 2x the off-peak rate
- * from 2026-08-17, and Gemini's Flex tier discounts spare-capacity traffic.
- */
 export declare const MODEL_CATALOG: readonly ModelEntry[];
 /**
  * 真实 provider model id → 计费目录键（`MODEL_CATALOG[].key`）的映射。未知 id

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kenz1117/dsh-ui-usage-billing",
   "description": "Usage billing dashboard for DeepSeek Harness: sidebar cost metrics plus a full dashboard modal, priced from a current multi-provider catalog with real usage aggregated from session logs.",
-  "version": "1.0.42",
+  "version": "1.0.44",
   "keywords": [
     "deepseek-harness",
     "deepseek",