@kenz1117/dsh-ui-usage-billing 1.2.5 → 1.2.7

package/lib/index.js

@@ -243,24 +243,13 @@ const WEEKEND_OFFPEAK_START_MS = Date.parse("2026-08-22T16:00:00Z");
 * 1/0.02/4（峰 = 谷 × 2）。目录条目写现行（新）价；分界前的历史事件由
 * {@link computeCostAt} 按 {@link FLASH_REPRICED_OFFPEAK} 回算旧价，与
 * {@link PEAK_ERA_START_MS} 同一「按事件时刻分段适用规则」口径。
-* pro 例外：V4 Pro 的路由计费分界是 {@link PRO_OFFLINE_MS}（官方把原定
-* 09-10 的路由时点推迟到 09-14 12:00），不在本分界切换。
+* V4 Pro 不在本分界内：官方取消了 09-14 的路由计划，pro 长期按刊例计费。
 */
 const FLASH_REPRICE_MS = Date.parse("2026-09-10T04:00:00Z");
 /**
-* V4 Pro 下线路由分界（UTC 2026-09-14T04:00:00Z，即北京时间 2026-09-14
-* 12:00）：官方价目页注释明确，此后至 V4.1 Pro 上线前，`deepseek-v4-pro`
-* 的请求全部路由至 V4.1 Flash 并按其单价计费——此前的请求仍按 V4 Pro
-* 峰谷刊例计费（官方原定 09-10 路由，后推迟到 09-14）。
-*/
-const PRO_OFFLINE_MS = Date.parse("2026-09-14T04: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 PRO_OFFLINE_MS} 起（原定 09-10，后推迟）把 V4 Pro 请求全部路由至
-* V4.1 Flash 并按其单价计费（V4.1 Pro 上线前），故分界前回算 V4 Pro 刊例、
-* 分界后走目录的 Flash 价。用户价 = 实付价，与 legacy 口径相同地跳过本表。
+* 之前的 flash / flash-vision-exp 事件按此回算（峰档 = 谷档 × 2）。
+* 用户价 = 实付价，与 legacy 口径相同地跳过本表。
 */
 const FLASH_PRE_REPRICE_BAND = {
 	input: 1.5,
@@ -269,12 +258,7 @@ const FLASH_PRE_REPRICE_BAND = {
 };
 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
-	}
+	"flash-vision-exp": FLASH_PRE_REPRICE_BAND
 };
 /**
 * DeepSeek V4 峰谷时代之前的官方基础价（CNY / 1M tokens）：官方中文定价页
@@ -347,7 +331,7 @@ const MODEL_CATALOG = [
 		key: "flash",
 		name: "DeepSeek V4.1 Flash",
 		provider: "DeepSeek",
-		colorVar: "dsw-static-blue-500",
+		colorVar: "ds-blue",
 		price: {
 			currency: "CNY",
 			input: 2,
@@ -365,7 +349,7 @@ const MODEL_CATALOG = [
 		key: "flash-vision-exp",
 		name: "DeepSeek V4 Flash Vision (Exp)",
 		provider: "DeepSeek",
-		colorVar: "dsw-static-blue-500",
+		colorVar: "ds-blue",
 		retired: true,
 		price: {
 			currency: "CNY",
@@ -387,13 +371,13 @@ const MODEL_CATALOG = [
 		colorVar: "dsw-static-deepseek-500",
 		price: {
 			currency: "CNY",
-			input: 2,
-			cacheHit: .04,
-			output: 8,
+			input: 9,
+			cacheHit: .3,
+			output: 27,
 			offPeak: {
-				input: 1,
-				cacheHit: .02,
-				output: 4
+				input: 4.5,
+				cacheHit: .15,
+				output: 13.5
 			}
 		},
 		peakHours: DEEPSEEK_PEAK_HOURS
@@ -414,7 +398,7 @@ const MODEL_CATALOG = [
 		key: "glm-5.3",
 		name: "GLM-5.3",
 		provider: "智谱 AI",
-		colorVar: "dsw-static-blue-500",
+		colorVar: "ds-blue",
 		price: {
 			currency: "CNY",
 			input: 8,
@@ -480,7 +464,7 @@ const MODEL_CATALOG = [
 		key: "glm-5-turbo",
 		name: "GLM-5-Turbo",
 		provider: "智谱 AI",
-		colorVar: "dsw-static-blue-500",
+		colorVar: "ds-blue",
 		price: {
 			currency: "CNY",
 			input: 5,
@@ -622,7 +606,7 @@ const MODEL_CATALOG = [
 		key: "qwen-plus",
 		name: "Qwen3.5-Plus",
 		provider: "阿里通义",
-		colorVar: "dsw-static-blue-500",
+		colorVar: "ds-blue",
 		price: {
 			currency: "CNY",
 			input: .8,
@@ -675,7 +659,7 @@ const MODEL_CATALOG = [
 		key: "doubao",
 		name: "Doubao Seed-2.0 Pro",
 		provider: "字节豆包",
-		colorVar: "dsw-static-red-500",
+		colorVar: "ds-red",
 		price: {
 			currency: "CNY",
 			input: 3.2,
@@ -711,7 +695,7 @@ const MODEL_CATALOG = [
 		key: "doubao-seed-evolving",
 		name: "Doubao-Seed-Evolving",
 		provider: "字节豆包",
-		colorVar: "dsw-static-red-500",
+		colorVar: "ds-red",
 		price: {
 			currency: "CNY",
 			input: 6,
@@ -819,7 +803,7 @@ const MODEL_CATALOG = [
 		key: "minimax",
 		name: "MiniMax-M3",
 		provider: "MiniMax",
-		colorVar: "dsw-static-amber-500",
+		colorVar: "ds-amber",
 		price: {
 			currency: "CNY",
 			input: 2.1,
@@ -843,7 +827,7 @@ const MODEL_CATALOG = [
 		key: "minimax-m2.7-highspeed",
 		name: "MiniMax-M2.7-highspeed",
 		provider: "MiniMax",
-		colorVar: "dsw-static-amber-500",
+		colorVar: "ds-amber",
 		price: {
 			currency: "CNY",
 			input: 4.2,
@@ -891,7 +875,7 @@ const MODEL_CATALOG = [
 		key: "yi",
 		name: "Yi-Lightning",
 		provider: "零一万物",
-		colorVar: "dsw-static-green-500",
+		colorVar: "ds-green",
 		price: {
 			currency: "CNY",
 			input: .99,
@@ -949,16 +933,34 @@ const MODEL_CATALOG = [
 			output: 9
 		}
 	},
+	{
+		key: "gpt-6-astra",
+		name: "GPT-6 Astra",
+		provider: "OpenAI",
+		colorVar: "ds-green",
+		price: {
+			currency: "USD",
+			input: 10,
+			cacheHit: 1,
+			output: 50
+		}
+	},
 	{
 		key: "gpt-5.6-sol",
 		name: "GPT-5.6 Sol",
 		provider: "OpenAI",
-		colorVar: "dsw-static-green-500",
+		colorVar: "ds-green",
 		price: {
 			currency: "USD",
 			input: 5,
 			cacheHit: .5,
 			output: 30
+		},
+		promo: {
+			factor: .8,
+			factors: { output: 2 / 3 },
+			endsAtMs: Date.UTC(2026, 10, 21, 16, 0, 0),
+			note: "限时促销至 2026-11-21"
 		}
 	},
 	{
@@ -977,7 +979,7 @@ const MODEL_CATALOG = [
 		key: "gpt-5.6-luna",
 		name: "GPT-5.6 Luna",
 		provider: "OpenAI",
-		colorVar: "dsw-static-green-500",
+		colorVar: "ds-green",
 		price: {
 			currency: "USD",
 			input: .2,
@@ -1051,7 +1053,7 @@ const MODEL_CATALOG = [
 		key: "llama",
 		name: "Llama 4 Maverick",
 		provider: "Meta",
-		colorVar: "dsw-static-red-500",
+		colorVar: "ds-red",
 		price: {
 			currency: "USD",
 			input: .2,
@@ -1075,7 +1077,7 @@ const MODEL_CATALOG = [
 		key: "claude-opus-4-6",
 		name: "Claude Opus 4.6",
 		provider: "Anthropic",
-		colorVar: "dsw-static-red-500",
+		colorVar: "ds-red",
 		price: {
 			currency: "USD",
 			input: 5,
@@ -1111,7 +1113,7 @@ const MODEL_CATALOG = [
 		key: "claude-opus-5",
 		name: "Claude Opus 5",
 		provider: "Anthropic",
-		colorVar: "dsw-static-red-500",
+		colorVar: "ds-red",
 		price: {
 			currency: "USD",
 			input: 5,
@@ -1135,7 +1137,7 @@ const MODEL_CATALOG = [
 		key: "mistral-large-2512",
 		name: "Mistral Large 3",
 		provider: "Mistral AI",
-		colorVar: "dsw-static-violet-500",
+		colorVar: "ds-violet",
 		price: {
 			currency: "USD",
 			input: .5,
@@ -1171,7 +1173,7 @@ const MODEL_CATALOG = [
 		key: "command-a-03-2025",
 		name: "Command A",
 		provider: "Cohere",
-		colorVar: "dsw-static-cyan-500",
+		colorVar: "ds-cyan",
 		price: {
 			currency: "USD",
 			input: 2.5,
@@ -1195,7 +1197,7 @@ const MODEL_CATALOG = [
 		key: "longcat-2.0",
 		name: "LongCat 2.0",
 		provider: "美团",
-		colorVar: "dsw-static-amber-500",
+		colorVar: "ds-amber",
 		price: {
 			currency: "CNY",
 			input: 4,
@@ -1208,7 +1210,7 @@ const MODEL_CATALOG = [
 		key: "minicpm-v-4.5",
 		name: "MiniCPM-V 4.5",
 		provider: "面壁智能",
-		colorVar: "dsw-static-green-500",
+		colorVar: "ds-green",
 		price: {
 			currency: "CNY",
 			input: 1,
@@ -1234,7 +1236,7 @@ const MODEL_CATALOG = [
 		key: "dots-3-note-preview",
 		name: "Dots3-Note Preview",
 		provider: "小红书",
-		colorVar: "dsw-static-red-500",
+		colorVar: "ds-red",
 		price: {
 			currency: "CNY",
 			input: 2,
@@ -1346,6 +1348,19 @@ const MODEL_CATALOG = [
 		},
 		estimated: true
 	},
+	{
+		key: "kimi-k2.8-preview",
+		name: "Kimi K2.8 Preview",
+		provider: "月之暗面",
+		colorVar: "dsw-static-cyan-400",
+		price: {
+			currency: "CNY",
+			input: 6.5,
+			cacheHit: 1.3,
+			output: 27
+		},
+		estimated: true
+	},
 	{
 		key: "kimi-k2.6-fast",
 		name: "Kimi K2.6 Fast",
@@ -1388,7 +1403,7 @@ const MODEL_CATALOG = [
 		key: "doubao-seed-2.0-code",
 		name: "Doubao Seed-2.0 Code",
 		provider: "字节豆包",
-		colorVar: "dsw-static-red-500",
+		colorVar: "ds-red",
 		price: {
 			currency: "CNY",
 			input: 3.2,
@@ -1508,6 +1523,12 @@ const MODEL_KEY_ALIASES = {
 	"seed-2.0-mini": "doubao-mini",
 	"k3": "kimi-k3",
 	"kimi-k3": "kimi-k3",
+	"kimi-k2.8-preview": "kimi-k2.8-preview",
+	"kimi-k2.8": "kimi-k2.8-preview",
+	"kimi-k2-8-preview": "kimi-k2.8-preview",
+	"kimi-k2-8": "kimi-k2.8-preview",
+	"k2.8-preview": "kimi-k2.8-preview",
+	"k2.8": "kimi-k2.8-preview",
 	"minimax-m1": "minimax",
 	"minimax-m2": "minimax",
 	"minimax-m3": "minimax",
@@ -1516,7 +1537,9 @@ const MODEL_KEY_ALIASES = {
 	"minimax-m2.7-high-speed": "minimax-m2.7-highspeed",
 	"minimax-m2-7": "minimax-m2.7",
 	"minimax-m2-7-highspeed": "minimax-m2.7-highspeed",
-	"minimax-m2-7-high-speed": "minimax-m2.7-highspeed"
+	"minimax-m2-7-high-speed": "minimax-m2.7-highspeed",
+	"gpt-6": "gpt-6-astra",
+	"gpt-6-astra": "gpt-6-astra"
 };
 /**
 * 模型 id 归一化：小写、去括号附注（如 `gpt5.6 luna(go)` 只看主体）、再去所有
@@ -1681,8 +1704,9 @@ function isPromoActive(promo, nowMs) {
 	return Number.isFinite(nowMs) && !expired && promo.factor > 0 && promo.factor < 1;
 }
 /**
-* 把限时促销折入条目单价：生效期内返回 price 主档与 offPeak 全部乘 factor 的
-* 副本，其余字段原样保留；不在促销期（过期/未开始/factor 非法）原样返回。
+* 把限时促销折入条目单价：生效期内返回 price 主档与 offPeak 逐档乘折扣系数的
+* 副本（某档在 promo.factors 有合法覆盖时用覆盖值，否则用 promo.factor），
+* 其余字段原样保留；不在促销期（过期/未开始/factor 非法）原样返回。
 * 幂等由调用方保证——计价与费率表显示各自只折一次，勿对已折价副本重复应用。
 * @param entry - 目录条目（price 保持刊例价口径）。
 * @param nowMs - 判定时刻（epoch ms）。
@@ -1690,11 +1714,12 @@ function isPromoActive(promo, nowMs) {
 function applyPromo(entry, nowMs) {
 	const { promo } = entry;
 	if (promo === void 0 || !isPromoActive(promo, nowMs)) return entry;
+	const factorOf = (field) => promo.factors?.[field] ?? promo.factor;
 	const scaled = (band) => ({
-		input: band.input * promo.factor,
-		cacheHit: band.cacheHit * promo.factor,
-		...band.cacheMiss !== void 0 ? { cacheMiss: band.cacheMiss * promo.factor } : {},
-		output: band.output * promo.factor
+		input: band.input * factorOf("input"),
+		cacheHit: band.cacheHit * factorOf("cacheHit"),
+		...band.cacheMiss !== void 0 ? { cacheMiss: band.cacheMiss * factorOf("cacheMiss") } : {},
+		output: band.output * factorOf("output")
 	});
 	return {
 		...entry,
@@ -1771,7 +1796,7 @@ 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 < (entry.key === "pro" ? PRO_OFFLINE_MS : FLASH_REPRICE_MS) && entry.userPriced !== true ? FLASH_REPRICED_OFFPEAK[entry.key] : void 0;
+	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,
@@ -2022,9 +2047,151 @@ function workspaceNameOf(cwd) {
 }
 /** TTFT 尖峰阈值（毫秒）：超过计为一次尖峰样本，用于定位服务端抖动。 */
 const PERF_SPIKE_MS = 1e4;
+/** 全零摘要（合并的恒等元）。 */
+const EMPTY_MODEL_DIGEST = {
+	samples: 0,
+	ttftSum: 0,
+	ttftMax: 0,
+	ttftSpikes: 0,
+	ttftP50: 0,
+	ttftP90: 0,
+	tpsCount: 0,
+	tpsSum: 0,
+	latencyCount: 0,
+	latencySum: 0,
+	estimated: 0
+};
+/** 从样本集构建模型级摘要（样本侧精确：P50/P90 为精确插值）。 */
+function modelDigestOf(samples) {
+	const ttfts = [];
+	let ttftSum = 0;
+	let ttftMax = 0;
+	let ttftSpikes = 0;
+	let tpsCount = 0;
+	let tpsSum = 0;
+	let latencyCount = 0;
+	let latencySum = 0;
+	let estimated = 0;
+	for (const sample of samples) {
+		ttfts.push(sample.ttftMs);
+		ttftSum += sample.ttftMs;
+		if (sample.ttftMs > ttftMax) ttftMax = sample.ttftMs;
+		if (sample.ttftMs > 1e4) ttftSpikes += 1;
+		if (sample.tps !== void 0) {
+			tpsCount += 1;
+			tpsSum += sample.tps;
+		}
+		if (sample.latencyMs !== void 0) {
+			latencyCount += 1;
+			latencySum += sample.latencyMs;
+		}
+		if (sample.estimated) estimated += 1;
+	}
+	return {
+		samples: samples.length,
+		ttftSum,
+		ttftMax,
+		ttftSpikes,
+		ttftP50: percentile(ttfts, .5),
+		ttftP90: percentile(ttfts, .9),
+		tpsCount,
+		tpsSum,
+		latencyCount,
+		latencySum,
+		estimated
+	};
+}
+/** 合并两个模型级摘要：计数/求和/极值精确；分位数按样本数加权。 */
+function mergeModelDigest(a, b) {
+	const n = a.samples + b.samples;
+	const weighted = (x, y) => n === 0 ? 0 : (x * a.samples + y * b.samples) / n;
+	return {
+		samples: n,
+		ttftSum: a.ttftSum + b.ttftSum,
+		ttftMax: Math.max(a.ttftMax, b.ttftMax),
+		ttftSpikes: a.ttftSpikes + b.ttftSpikes,
+		ttftP50: weighted(a.ttftP50, b.ttftP50),
+		ttftP90: weighted(a.ttftP90, b.ttftP90),
+		tpsCount: a.tpsCount + b.tpsCount,
+		tpsSum: a.tpsSum + b.tpsSum,
+		latencyCount: a.latencyCount + b.latencyCount,
+		latencySum: a.latencySum + b.latencySum,
+		estimated: a.estimated + b.estimated
+	};
+}
+/** 从样本集构建小时级摘要（均值可无损重建）。 */
+function hourDigestOf(samples) {
+	let ttftSum = 0;
+	let tpsCount = 0;
+	let tpsSum = 0;
+	for (const sample of samples) {
+		ttftSum += sample.ttftMs;
+		if (sample.tps !== void 0) {
+			tpsCount += 1;
+			tpsSum += sample.tps;
+		}
+	}
+	return {
+		samples: samples.length,
+		ttftSum,
+		tpsCount,
+		tpsSum
+	};
+}
+/** 全零小时摘要（合并的恒等元）。 */
+const EMPTY_HOUR_DIGEST = {
+	samples: 0,
+	ttftSum: 0,
+	tpsCount: 0,
+	tpsSum: 0
+};
+/** 合并两个小时级摘要（纯字段加法，无损）。 */
+function mergeHourDigest(a, b) {
+	return {
+		samples: a.samples + b.samples,
+		ttftSum: a.ttftSum + b.ttftSum,
+		tpsCount: a.tpsCount + b.tpsCount,
+		tpsSum: a.tpsSum + b.tpsSum
+	};
+}
+/**
+* 样本集 → 账本摘要形态（模型 → 摘要；小时 → 模型 → 摘要）。serializeFold
+* 与账本迁移共用同一转换，两处口径不会漂移。
+* @param samples - 一个会话的全部性能样本。
+* @returns `{ byModel, byHourModel }` 的 JSON-safe 记录。
+*/
+function perfDigestsOf(samples) {
+	const byModelSamples = /* @__PURE__ */ new Map();
+	const byHourModelSamples = /* @__PURE__ */ new Map();
+	for (const sample of samples) {
+		let modelSamples = byModelSamples.get(sample.model);
+		if (modelSamples === void 0) {
+			modelSamples = [];
+			byModelSamples.set(sample.model, modelSamples);
+		}
+		modelSamples.push(sample);
+		let hourModels = byHourModelSamples.get(sample.hour);
+		if (hourModels === void 0) {
+			hourModels = /* @__PURE__ */ new Map();
+			byHourModelSamples.set(sample.hour, hourModels);
+		}
+		let hourModelSamples = hourModels.get(sample.model);
+		if (hourModelSamples === void 0) {
+			hourModelSamples = [];
+			hourModels.set(sample.model, hourModelSamples);
+		}
+		hourModelSamples.push(sample);
+	}
+	return {
+		byModel: Object.fromEntries([...byModelSamples].map(([model, list]) => [model, modelDigestOf(list)])),
+		byHourModel: Object.fromEntries([...byHourModelSamples].map(([hour, models]) => [hour, Object.fromEntries([...models].map(([model, list]) => [model, hourDigestOf(list)]))]))
+	};
+}
 /**
 * 账本迁移注册表。首条迁移给 1.0.6 及更早的行回填 foldVersion = 1（它们全部出自
-* header 归因算法）；此后新写入的行总带当前 {@link FOLD_VERSION}。
+* header 归因算法）；perf 摘要化迁移把 v15 及更早行的逐样本 `perf` 数组转换为
+* `perfDigest`/`perfHourDigest` 摘要（日志已删的行不再被重折，迁移是它们唯一的
+* 收缩机会）；此后新写入的行总带当前 {@link FOLD_VERSION} 与摘要形态。
 */
 const LEDGER_MIGRATIONS = [{
 	id: "fold-version-backfill",
@@ -2036,6 +2203,26 @@ const LEDGER_MIGRATIONS = [{
 		}
 		return changed;
 	}
+}, {
+	id: "perf-sample-to-digest",
+	apply(document) {
+		let changed = false;
+		for (const session of document.sessions) {
+			const fold = session.fold;
+			if (Array.isArray(fold.perf)) {
+				const { byModel, byHourModel } = perfDigestsOf(fold.perf);
+				fold.perfDigest = byModel;
+				fold.perfHourDigest = byHourModel;
+				delete fold.perf;
+				changed = true;
+			} else if (fold.perfDigest === void 0 || fold.perfHourDigest === void 0) {
+				fold.perfDigest ??= {};
+				fold.perfHourDigest ??= {};
+				changed = true;
+			}
+		}
+		return changed;
+	}
 }];
 /**
 * 在加载边界对账本文档应用未执行的迁移，并记录已应用 id 供写回。
@@ -2059,6 +2246,7 @@ function runLedgerMigrations(document, migrations = LEDGER_MIGRATIONS) {
 }
 /** Serialize Map/Set-heavy fold state into a JSON-safe ledger entry. */
 function serializeFold(fold) {
+	const { byModel: perfDigest, byHourModel: perfHourDigest } = perfDigestsOf(fold.perf);
 	return {
 		total: fold.total,
 		byModel: Object.fromEntries(fold.byModel),
@@ -2071,7 +2259,8 @@ function serializeFold(fold) {
 		unpricedModels: [...fold.unpricedModels],
 		planCalls: Object.fromEntries(fold.planCalls),
 		turns: fold.turns,
-		perf: fold.perf,
+		perfDigest,
+		perfHourDigest,
 		roles: fold.roles,
 		lastActive: fold.lastActive,
 		...fold.title !== void 0 ? { title: fold.title } : {}
@@ -2091,7 +2280,9 @@ function deserializeFold(fold) {
 		unpricedModels: new Set(fold.unpricedModels),
 		planCalls: new Map(Object.entries(fold.planCalls)),
 		turns: fold.turns,
-		perf: fold.perf,
+		perf: [],
+		perfDigest: new Map(Object.entries(fold.perfDigest)),
+		perfHourDigest: new Map(Object.entries(fold.perfHourDigest).map(([hour, models]) => [hour, new Map(Object.entries(models))])),
 		roles: fold.roles,
 		lastActive: fold.lastActive,
 		...fold.title !== void 0 ? { title: fold.title } : {}
@@ -2107,7 +2298,7 @@ function ledgerSessionsOf(value) {
 		const row = entry;
 		if (typeof row.id !== "string" || row.id === "" || row.fold === null || typeof row.fold !== "object") return false;
 		const fold = row.fold;
-		return fold.total !== void 0 && fold.byModel !== void 0 && fold.byDay !== void 0 && fold.byDayModels !== void 0 && fold.bySite !== void 0 && Array.isArray(fold.unpricedModels) && fold.planCalls !== void 0 && Array.isArray(fold.turns) && Array.isArray(fold.perf) && fold.roles !== void 0 && typeof fold.lastActive === "number";
+		return fold.total !== void 0 && fold.byModel !== void 0 && fold.byDay !== void 0 && fold.byDayModels !== void 0 && fold.bySite !== void 0 && Array.isArray(fold.unpricedModels) && fold.planCalls !== void 0 && Array.isArray(fold.turns) && fold.perfDigest !== void 0 && fold.perfHourDigest !== void 0 && fold.roles !== void 0 && typeof fold.lastActive === "number";
 	});
 }
 /**
@@ -2202,6 +2393,8 @@ function freshFold() {
 		planCalls: /* @__PURE__ */ new Map(),
 		turns: [],
 		perf: [],
+		perfDigest: /* @__PURE__ */ new Map(),
+		perfHourDigest: /* @__PURE__ */ new Map(),
 		roles: {
 			userChars: 0,
 			toolChars: 0,
@@ -2443,11 +2636,6 @@ function mergeUsageInto(acc, cell) {
 	acc.officialCost += cell.officialCost;
 	if (cell.searchCalls !== void 0) acc.searchCalls = (acc.searchCalls ?? 0) + cell.searchCalls;
 }
-/** 均值（数组非空时调用；空数组按 0 兜底）。 */
-function mean(values) {
-	if (values.length === 0) return 0;
-	return values.reduce((sum, value) => sum + value, 0) / values.length;
-}
 /** 分位数（0..1）：先拷贝排序，再线性插值；空数组返回 0。 */
 function percentile(values, p) {
 	if (values.length === 0) return 0;
@@ -2464,6 +2652,53 @@ function percentile(values, p) {
 	if (a === void 0 || b === void 0) return 0;
 	return a + (b - a) * (idx - lo);
 }
+/** 活样本累加器 → 模型级摘要（跨会话合并前先归一到摘要形态）。 */
+function accumToModelDigest(acc) {
+	return {
+		samples: acc.ttfts.length,
+		ttftSum: acc.ttfts.reduce((sum, value) => sum + value, 0),
+		ttftMax: acc.ttfts.length === 0 ? 0 : Math.max(...acc.ttfts),
+		ttftSpikes: acc.ttfts.filter((ttft) => ttft > PERF_SPIKE_MS).length,
+		ttftP50: percentile(acc.ttfts, .5),
+		ttftP90: percentile(acc.ttfts, .9),
+		tpsCount: acc.tps.length,
+		tpsSum: acc.tps.reduce((sum, value) => sum + value, 0),
+		latencyCount: acc.latencies.length,
+		latencySum: acc.latencies.reduce((sum, value) => sum + value, 0),
+		estimated: acc.estimated
+	};
+}
+/** 活样本小时累加器 → 小时级摘要。 */
+function accumToHourDigest(acc) {
+	return {
+		samples: acc.ttfts.length,
+		ttftSum: acc.ttfts.reduce((sum, value) => sum + value, 0),
+		tpsCount: acc.tps.length,
+		tpsSum: acc.tps.reduce((sum, value) => sum + value, 0)
+	};
+}
+/** 模型级摘要 → 面板行（均值由求和/计数派生）。 */
+function modelPerfOf(digest) {
+	return {
+		samples: digest.samples,
+		ttftAvg: digest.samples === 0 ? 0 : digest.ttftSum / digest.samples,
+		ttftP50: digest.ttftP50,
+		ttftP90: digest.ttftP90,
+		ttftMax: digest.ttftMax,
+		ttftSpikes: digest.ttftSpikes,
+		...digest.tpsCount === 0 ? {} : { tpsAvg: digest.tpsSum / digest.tpsCount },
+		latencyAvg: digest.latencyCount === 0 ? 0 : digest.latencySum / digest.latencyCount,
+		estimatedSamples: digest.estimated
+	};
+}
+/** 小时级摘要 → 面板行（均值由求和/计数派生）。 */
+function hourPerfOf(digest) {
+	return {
+		samples: digest.samples,
+		ttftAvg: digest.samples === 0 ? 0 : digest.ttftSum / digest.samples,
+		...digest.tpsCount === 0 ? {} : { tpsAvg: digest.tpsSum / digest.tpsCount }
+	};
+}
 /**
 * 聚合配置指纹：影响折叠语义的全部配置（订阅豁免、官方名单、路由别名、搜索估值）
 * 的稳定序列化。账本行的复用判定携带该指纹——用户改配置后（如为 grok build 加
@@ -2511,7 +2746,7 @@ function createUsageAggregator(persistence, options = {}) {
 			id,
 			...cwd === void 0 ? {} : { cwd },
 			...stamp === null ? {} : { stamp },
-			foldVersion: 14,
+			foldVersion: 16,
 			fingerprint: foldFingerprint,
 			fold: serializeFold(fold)
 		};
@@ -2608,7 +2843,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) === 14 && ledgerRow.fingerprint === foldFingerprint) {
+				if (ledgerRow !== void 0 && ledgerRow.stamp !== void 0 && stamp !== null && ledgerRow.stamp === stamp && (ledgerRow.foldVersion ?? 1) === 16 && ledgerRow.fingerprint === foldFingerprint) {
 					const fold = deserializeFold(ledgerRow.fold);
 					folds.push({
 						id,
@@ -2690,7 +2925,7 @@ function createUsageAggregator(persistence, options = {}) {
 			for (const entry of ledger.values()) {
 				if (included.has(entry.id)) continue;
 				try {
-					const stale = (entry.foldVersion ?? 1) < 14 || entry.fingerprint !== foldFingerprint;
+					const stale = (entry.foldVersion ?? 1) < 16 || entry.fingerprint !== foldFingerprint;
 					folds.push({
 						id: entry.id,
 						...entry.cwd === void 0 ? {} : { cwd: entry.cwd },
@@ -2727,6 +2962,8 @@ function createUsageAggregator(persistence, options = {}) {
 		};
 		const perfModel = /* @__PURE__ */ new Map();
 		const perfHourModel = /* @__PURE__ */ new Map();
+		const perfModelDigest = /* @__PURE__ */ new Map();
+		const perfHourDigest = /* @__PURE__ */ new Map();
 		for (const { id: sessionId, cwd, fold, staleLedger } of folds) {
 			mergeUsageInto(total, fold.total);
 			roles.userChars += fold.roles.userChars;
@@ -2773,6 +3010,15 @@ function createUsageAggregator(persistence, options = {}) {
 				hourAccum.ttfts.push(sample.ttftMs);
 				if (sample.tps !== void 0) hourAccum.tps.push(sample.tps);
 			}
+			for (const [model, digest] of fold.perfDigest) perfModelDigest.set(model, mergeModelDigest(perfModelDigest.get(model) ?? EMPTY_MODEL_DIGEST, digest));
+			for (const [hour, models] of fold.perfHourDigest) {
+				let hourModels = perfHourDigest.get(hour);
+				if (hourModels === void 0) {
+					hourModels = /* @__PURE__ */ new Map();
+					perfHourDigest.set(hour, hourModels);
+				}
+				for (const [model, digest] of models) hourModels.set(model, mergeHourDigest(hourModels.get(model) ?? EMPTY_HOUR_DIGEST, digest));
+			}
 			for (const row of fold.turns) turnRows.push({
 				sessionId,
 				...row
@@ -2816,23 +3062,26 @@ function createUsageAggregator(persistence, options = {}) {
 		};
 		const toModelDayRecord = (map) => Object.fromEntries([...map].map(([day, models]) => [day, Object.fromEntries(models)]));
 		const toModelDaySiteRecord = (map) => Object.fromEntries([...map].map(([day, models]) => [day, Object.fromEntries([...models].map(([model, sites]) => [model, Object.fromEntries(sites)]))]));
-		const perf = perfModel.size === 0 ? void 0 : {
-			byModel: Object.fromEntries([...perfModel].map(([model, acc]) => [model, {
-				samples: acc.ttfts.length,
-				ttftAvg: mean(acc.ttfts),
-				ttftP50: percentile(acc.ttfts, .5),
-				ttftP90: percentile(acc.ttfts, .9),
-				ttftMax: Math.max(...acc.ttfts),
-				ttftSpikes: acc.ttfts.filter((ttft) => ttft > PERF_SPIKE_MS).length,
-				...acc.tps.length === 0 ? {} : { tpsAvg: mean(acc.tps) },
-				latencyAvg: acc.latencies.length === 0 ? 0 : mean(acc.latencies),
-				estimatedSamples: acc.estimated
-			}])),
-			byHourModel: Object.fromEntries([...perfHourModel].map(([hour, models]) => [hour, Object.fromEntries([...models].map(([model, acc]) => [model, {
-				samples: acc.ttfts.length,
-				ttftAvg: mean(acc.ttfts),
-				...acc.tps.length === 0 ? {} : { tpsAvg: mean(acc.tps) }
-			}]))]))
+		const modelKeys = /* @__PURE__ */ new Set([...perfModel.keys(), ...perfModelDigest.keys()]);
+		const hourKeys = /* @__PURE__ */ new Set([...perfHourModel.keys(), ...perfHourDigest.keys()]);
+		const perf = modelKeys.size === 0 && hourKeys.size === 0 ? void 0 : {
+			byModel: Object.fromEntries([...modelKeys].map((model) => {
+				const live = perfModel.get(model);
+				const restored = perfModelDigest.get(model);
+				const digest = live === void 0 ? restored : mergeModelDigest(accumToModelDigest(live), restored ?? EMPTY_MODEL_DIGEST);
+				return digest === void 0 ? null : [model, modelPerfOf(digest)];
+			}).filter((entry) => entry !== null)),
+			byHourModel: Object.fromEntries([...hourKeys].sort().map((hour) => {
+				const liveModels = perfHourModel.get(hour);
+				const digestModels = perfHourDigest.get(hour);
+				const modelKeysInHour = /* @__PURE__ */ new Set([...liveModels?.keys() ?? [], ...digestModels?.keys() ?? []]);
+				return [hour, Object.fromEntries([...modelKeysInHour].map((model) => {
+					const live = liveModels?.get(model);
+					const restored = digestModels?.get(model);
+					const digest = live === void 0 ? restored : mergeHourDigest(accumToHourDigest(live), restored ?? EMPTY_HOUR_DIGEST);
+					return digest === void 0 ? null : [model, hourPerfOf(digest)];
+				}).filter((entry) => entry !== null))];
+			}))
 		};
 		lastDoc = {
 			version: 4,
@@ -2878,6 +3127,29 @@ function createUsageAggregator(persistence, options = {}) {
 			});
 			return inflight;
 		},
+		async sessionUsageOf(sessionId) {
+			await this.aggregate();
+			const hit = cache.get(sessionId);
+			if (hit !== void 0) return {
+				calls: hit.fold.total.calls,
+				cost: hit.fold.total.cost,
+				input: hit.fold.total.input,
+				output: hit.fold.total.output
+			};
+			const row = ledger.get(sessionId);
+			if (row === void 0) return void 0;
+			try {
+				const fold = deserializeFold(row.fold);
+				return {
+					calls: fold.total.calls,
+					cost: fold.total.cost,
+					input: fold.total.input,
+					output: fold.total.output
+				};
+			} catch {
+				return;
+			}
+		},
 		async flush() {
 			if (inflight !== void 0) await inflight.catch(() => {});
 			await saveLedger(true);
@@ -5443,8 +5715,10 @@ const DEFAULT_BALANCE_API_KEY_ENV = "DEEPSEEK_API_KEY";
 * 下发，供「设置 → 插件信息卡」展示。发布版 lib/index.js 相对包根解析。
 */
 const PACKAGE_VERSION = createRequire(import.meta.url)("../package.json").version ?? "0.0.0";
-/** 统计快照的落盘节流（毫秒）：前端 30 秒轮询，快照最多每 30 秒写一次。 */
-const SNAPSHOT_INTERVAL_MS = 3e4;
+/** 统计快照的落盘节流（毫秒）：快照只服务聚合失败回退与重启首屏（展示级
+*  新鲜度即可），降到 5 分钟一次——原子写含上一版备份是两次全量 JSON 落盘，
+*  重度用户快照上百 KB，跟随前端轮询 30 秒写一次纯属写放大。 */
+const SNAPSHOT_INTERVAL_MS = 3e5;
 /** usage-stats 响应的等待预算（毫秒）：聚合在此预算内完成就回实时数据，
 *  超预算立即回最近快照（stale-while-revalidate），后台折叠继续跑。
 *  轻量用户暖缓存下的聚合是毫秒级，预算几乎不会触发。 */
@@ -5977,6 +6251,11 @@ function apply(ctx, config = {}) {
 					}
 					const sessionId = exec.agent?.id;
 					if (sessionId === void 0) throw new Error("usage_stats 的 session 范围需要 agent 会话上下文");
+					const summary = await aggregator.sessionUsageOf(String(sessionId));
+					if (summary !== void 0) return {
+						range: args.range,
+						...summary
+					};
 					let cost = 0;
 					let calls = 0;
 					let input = 0;