@kenz1117/dsh-ui-usage-billing 1.0.1 → 1.0.3

package/lib/index.js

@@ -70,7 +70,21 @@ const PLAN_KNOWLEDGE = {
 	"minimax": { type: "code" },
 	"minimax-cn": { type: "code" },
 	"minimax-token-plan": { type: "code" },
-	"minimax-token-plan-cn": { type: "code" }
+	"minimax-token-plan-cn": { type: "code" },
+	"hunyuan-token-plan": { type: "code" },
+	"tencent-token-plan": { type: "code" },
+	"hy-token-plan": { type: "code" },
+	"xinghuo-token-plan": { type: "code" },
+	"xfyun-coding": { type: "code" },
+	"spark-coding": { type: "code" },
+	"huawei-token-plan": { type: "code" },
+	"pangu-token-plan": { type: "code" },
+	"huawei-maas-token-plan": { type: "code" },
+	"volcengine-agent-plan": { type: "code" },
+	"ark-agent-plan": { type: "code" },
+	"baidu-token-plan": { type: "code" },
+	"ernie-token-plan": { type: "code" },
+	"wenxin-token-plan": { type: "code" }
 };
 /**
 * 订阅/plan provider id 变体 → PLAN_KNOWLEDGE 规范键（引用 dsh-spend 的别名归一化）。
@@ -312,6 +326,23 @@ const MODEL_CATALOG = [
 			output: 28
 		}
 	},
+	{
+		key: "glm-5.3-flash",
+		name: "GLM-5.3-Flash",
+		provider: "智谱 AI",
+		colorVar: "dsw-static-blue-300",
+		price: {
+			currency: "CNY",
+			input: .8,
+			cacheHit: .23,
+			output: 2.8
+		},
+		promo: {
+			factor: .5,
+			endsAtMs: Date.UTC(2026, 8, 8, 16, 0, 0),
+			note: "限时 5 折"
+		}
+	},
 	{
 		key: "glm-4.6",
 		name: "GLM-4.6",
@@ -392,10 +423,66 @@ const MODEL_CATALOG = [
 		colorVar: "dsw-static-blue-600",
 		price: {
 			currency: "CNY",
-			input: 13.58,
-			cacheHit: 1.36,
-			output: 40.74
-		}
+			input: 12,
+			cacheHit: 1.5,
+			output: 36
+		},
+		extraRows: [
+			{
+				label: "显式缓存创建",
+				input: 15
+			},
+			{
+				label: "显式缓存命中",
+				input: 1
+			},
+			{
+				label: "Batch File",
+				input: 6,
+				output: 18,
+				note: "长期半价"
+			},
+			{
+				label: "Batch Chat",
+				input: 12,
+				output: 36,
+				note: "与标准价一致"
+			}
+		]
+	},
+	{
+		key: "qwen-3.8-flash",
+		name: "Qwen3.8 Flash",
+		provider: "阿里通义",
+		colorVar: "dsw-static-blue-400",
+		price: {
+			currency: "CNY",
+			input: 1,
+			cacheHit: .1,
+			output: 3
+		},
+		extraRows: [
+			{
+				label: "显式缓存创建",
+				input: 1.25
+			},
+			{
+				label: "显式缓存命中",
+				input: .1
+			},
+			{
+				label: "Batch File",
+				input: .5,
+				output: 1.5,
+				note: "长期半价"
+			},
+			{
+				label: "Batch Chat",
+				input: 1,
+				output: 3,
+				note: "与标准价一致"
+			}
+		]
 	},
 	{
 		key: "qwen-max",
@@ -404,10 +491,36 @@ const MODEL_CATALOG = [
 		colorVar: "dsw-static-blue-300",
 		price: {
 			currency: "CNY",
-			input: 6,
-			cacheHit: .6,
-			output: 18
-		}
+			input: 12,
+			cacheHit: 1.2,
+			output: 36
+		},
+		promo: {
+			factor: .5,
+			note: "限时 5 折"
+		},
+		extraRows: [
+			{
+				label: "显式缓存创建",
+				input: 15
+			},
+			{
+				label: "显式缓存命中",
+				input: 1.2
+			},
+			{
+				label: "Batch File",
+				input: 6,
+				output: 18,
+				note: "长期半价"
+			},
+			{
+				label: "Batch Chat",
+				input: 12,
+				output: 36,
+				note: "与标准价一致"
+			}
+		]
 	},
 	{
 		key: "qwen-plus",
@@ -419,7 +532,29 @@ const MODEL_CATALOG = [
 			input: .8,
 			cacheHit: .08,
 			output: 4.8
-		}
+		},
+		extraRows: [
+			{
+				label: "显式缓存创建",
+				input: 1
+			},
+			{
+				label: "显式缓存命中",
+				input: .08
+			},
+			{
+				label: "Batch File",
+				input: .4,
+				output: 2.4,
+				note: "长期半价"
+			},
+			{
+				label: "Batch Chat",
+				input: .8,
+				output: 4.8,
+				note: "与标准价一致"
+			}
+		]
 	},
 	{
 		key: "qwen-flash",
@@ -431,7 +566,14 @@ const MODEL_CATALOG = [
 			input: .2,
 			cacheHit: .02,
 			output: 2
-		}
+		},
+		extraRows: [{
+			label: "显式缓存创建",
+			input: .25
+		}, {
+			label: "显式缓存命中",
+			input: .02
+		}]
 	},
 	{
 		key: "doubao",
@@ -469,6 +611,42 @@ const MODEL_CATALOG = [
 			output: 8
 		}
 	},
+	{
+		key: "doubao-seed-evolving",
+		name: "Doubao-Seed-Evolving",
+		provider: "字节豆包",
+		colorVar: "dsw-static-red-500",
+		price: {
+			currency: "CNY",
+			input: 6,
+			cacheHit: 1.2,
+			output: 30
+		}
+	},
+	{
+		key: "doubao-seed-2.1-pro",
+		name: "Doubao Seed-2.1 Pro",
+		provider: "字节豆包",
+		colorVar: "dsw-static-red-400",
+		price: {
+			currency: "CNY",
+			input: 6,
+			cacheHit: 1.2,
+			output: 30
+		}
+	},
+	{
+		key: "doubao-seed-2.1-turbo",
+		name: "Doubao Seed-2.1 Turbo",
+		provider: "字节豆包",
+		colorVar: "dsw-static-red-300",
+		price: {
+			currency: "CNY",
+			input: 3,
+			cacheHit: .6,
+			output: 15
+		}
+	},
 	{
 		key: "kimi",
 		name: "Kimi K2.7 Code",
@@ -795,6 +973,343 @@ const MODEL_CATALOG = [
 			output: .3
 		}
 	},
+	{
+		key: "claude-opus-4-6",
+		name: "Claude Opus 4.6",
+		provider: "Anthropic",
+		colorVar: "dsw-static-red-500",
+		price: {
+			currency: "USD",
+			input: 5,
+			cacheHit: .5,
+			output: 25
+		}
+	},
+	{
+		key: "claude-sonnet-4-6",
+		name: "Claude Sonnet 4.6",
+		provider: "Anthropic",
+		colorVar: "dsw-static-red-400",
+		price: {
+			currency: "USD",
+			input: 3,
+			cacheHit: .3,
+			output: 15
+		}
+	},
+	{
+		key: "claude-haiku-4-5",
+		name: "Claude Haiku 4.5",
+		provider: "Anthropic",
+		colorVar: "dsw-static-red-300",
+		price: {
+			currency: "USD",
+			input: 1,
+			cacheHit: .1,
+			output: 5
+		}
+	},
+	{
+		key: "claude-opus-5",
+		name: "Claude Opus 5",
+		provider: "Anthropic",
+		colorVar: "dsw-static-red-500",
+		price: {
+			currency: "USD",
+			input: 5,
+			cacheHit: .5,
+			output: 25
+		}
+	},
+	{
+		key: "claude-sonnet-5",
+		name: "Claude Sonnet 5",
+		provider: "Anthropic",
+		colorVar: "dsw-static-red-400",
+		price: {
+			currency: "USD",
+			input: 2,
+			cacheHit: .2,
+			output: 10
+		}
+	},
+	{
+		key: "mistral-large-2512",
+		name: "Mistral Large 3",
+		provider: "Mistral AI",
+		colorVar: "dsw-static-violet-500",
+		price: {
+			currency: "USD",
+			input: .5,
+			cacheHit: .05,
+			output: 1.5
+		}
+	},
+	{
+		key: "mistral-small-2603",
+		name: "Mistral Small 4",
+		provider: "Mistral AI",
+		colorVar: "dsw-static-violet-400",
+		price: {
+			currency: "USD",
+			input: .15,
+			cacheHit: .015,
+			output: .6
+		}
+	},
+	{
+		key: "ministral-8b-latest",
+		name: "Ministral 8B",
+		provider: "Mistral AI",
+		colorVar: "dsw-static-violet-300",
+		price: {
+			currency: "USD",
+			input: .1,
+			cacheHit: .01,
+			output: .1
+		}
+	},
+	{
+		key: "command-a-03-2025",
+		name: "Command A",
+		provider: "Cohere",
+		colorVar: "dsw-static-cyan-500",
+		price: {
+			currency: "USD",
+			input: 2.5,
+			cacheHit: .25,
+			output: 10
+		}
+	},
+	{
+		key: "command-r-08-2024",
+		name: "Command R",
+		provider: "Cohere",
+		colorVar: "dsw-static-cyan-400",
+		price: {
+			currency: "USD",
+			input: .15,
+			cacheHit: .015,
+			output: .6
+		}
+	},
+	{
+		key: "longcat-2.0",
+		name: "LongCat 2.0",
+		provider: "美团",
+		colorVar: "dsw-static-amber-500",
+		price: {
+			currency: "CNY",
+			input: 4,
+			cacheHit: .8,
+			output: 16
+		},
+		estimated: true
+	},
+	{
+		key: "minicpm-v-4.5",
+		name: "MiniCPM-V 4.5",
+		provider: "面壁智能",
+		colorVar: "dsw-static-green-500",
+		price: {
+			currency: "CNY",
+			input: 1,
+			cacheHit: .2,
+			output: 4
+		},
+		estimated: true
+	},
+	{
+		key: "ernie-4.5",
+		name: "ERNIE-4.5 300B",
+		provider: "百度文心",
+		colorVar: "dsw-static-blue-300",
+		price: {
+			currency: "CNY",
+			input: 2,
+			cacheHit: .4,
+			output: 8
+		},
+		estimated: true
+	},
+	{
+		key: "dots-3-note-preview",
+		name: "Dots3-Note Preview",
+		provider: "小红书",
+		colorVar: "dsw-static-red-500",
+		price: {
+			currency: "CNY",
+			input: 2,
+			cacheHit: .4,
+			output: 8
+		},
+		estimated: true
+	},
+	{
+		key: "qwen3.6-max",
+		name: "Qwen3.6 Max",
+		provider: "阿里通义",
+		colorVar: "dsw-static-orange-500",
+		price: {
+			currency: "CNY",
+			input: 9,
+			cacheHit: .9,
+			output: 54
+		},
+		extraRows: [{
+			label: "显式缓存创建",
+			input: 11.25
+		}, {
+			label: "显式缓存命中",
+			input: .9
+		}]
+	},
+	{
+		key: "qwen3-coder-plus",
+		name: "Qwen3-Coder Plus",
+		provider: "阿里通义",
+		colorVar: "dsw-static-orange-400",
+		price: {
+			currency: "CNY",
+			input: 4,
+			cacheHit: .8,
+			output: 16
+		},
+		extraRows: [{
+			label: "显式缓存创建",
+			input: 5
+		}, {
+			label: "显式缓存命中",
+			input: .4
+		}]
+	},
+	{
+		key: "qwen3-coder",
+		name: "Qwen3-Coder 480B",
+		provider: "阿里通义",
+		colorVar: "dsw-static-orange-300",
+		price: {
+			currency: "CNY",
+			input: 4,
+			cacheHit: .8,
+			output: 16
+		},
+		estimated: true
+	},
+	{
+		key: "glm-4.5-x",
+		name: "GLM-4.5-X",
+		provider: "智谱 AI",
+		colorVar: "dsw-static-blue-400",
+		price: {
+			currency: "CNY",
+			input: 4,
+			cacheHit: 1,
+			output: 16
+		},
+		estimated: true
+	},
+	{
+		key: "glm-5.2-fast",
+		name: "GLM-5.2 Fast",
+		provider: "智谱 AI",
+		colorVar: "dsw-static-blue-300",
+		price: {
+			currency: "CNY",
+			input: 6,
+			cacheHit: 1.2,
+			output: 24
+		},
+		estimated: true
+	},
+	{
+		key: "kimi-k3-fast",
+		name: "Kimi K3 Fast",
+		provider: "月之暗面",
+		colorVar: "dsw-static-cyan-400",
+		price: {
+			currency: "CNY",
+			input: 20,
+			cacheHit: 2,
+			output: 100
+		},
+		estimated: true
+	},
+	{
+		key: "kimi-k2.7-code-fast",
+		name: "Kimi K2.7 Code Fast",
+		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",
+		provider: "月之暗面",
+		colorVar: "dsw-static-cyan-300",
+		price: {
+			currency: "CNY",
+			input: 6.5,
+			cacheHit: 1.1,
+			output: 27
+		},
+		estimated: true
+	},
+	{
+		key: "kimi-k2.6-turbo",
+		name: "Kimi K2.6 Turbo",
+		provider: "月之暗面",
+		colorVar: "dsw-static-cyan-300",
+		price: {
+			currency: "CNY",
+			input: 6.5,
+			cacheHit: 1.1,
+			output: 27
+		},
+		estimated: true
+	},
+	{
+		key: "kimi-k2-thinking-turbo",
+		name: "Kimi K2 Thinking Turbo",
+		provider: "月之暗面",
+		colorVar: "dsw-static-cyan-300",
+		price: {
+			currency: "CNY",
+			input: 8,
+			cacheHit: 1,
+			output: 58
+		}
+	},
+	{
+		key: "doubao-seed-2.0-code",
+		name: "Doubao Seed-2.0 Code",
+		provider: "字节豆包",
+		colorVar: "dsw-static-red-500",
+		price: {
+			currency: "CNY",
+			input: 3.2,
+			cacheHit: .64,
+			output: 16
+		}
+	},
+	{
+		key: "doubao-seed-2.0-lite",
+		name: "Doubao Seed-2.0 Lite",
+		provider: "字节豆包",
+		colorVar: "dsw-static-red-300",
+		price: {
+			currency: "CNY",
+			input: .6,
+			cacheHit: .12,
+			output: 3.6
+		}
+	},
 	{
 		key: "other",
 		name: "其他模型",
@@ -802,10 +1317,10 @@ const MODEL_CATALOG = [
 		colorVar: "dsw-static-neutral-bluish-500",
 		price: {
 			currency: "CNY",
-			input: .5,
-			cacheHit: .25,
-			cacheMiss: .5,
-			output: 1.5
+			input: 0,
+			cacheHit: 0,
+			cacheMiss: 0,
+			output: 0
 		}
 	}
 ];
@@ -825,10 +1340,66 @@ const MODEL_KEY_ALIASES = {
 	"glm-4.7": "glm-4.7",
 	"glm-5-turbo": "glm-5-turbo",
 	"glm-5.1": "glm-5.1",
+	"glm-5.3-flash": "glm-5.3-flash",
 	"glm-5v-turbo": "glm-5v-turbo",
 	"glm-5v.1": "glm-5v-turbo",
+	"claude-opus-4-6": "claude-opus-4-6",
+	"claude-opus-4.6": "claude-opus-4-6",
+	"claude-sonnet-4-6": "claude-sonnet-4-6",
+	"claude-sonnet-4.6": "claude-sonnet-4-6",
+	"claude-haiku-4-5": "claude-haiku-4-5",
+	"claude-haiku-4.5": "claude-haiku-4-5",
+	"claude-opus-5": "claude-opus-5",
+	"claude-sonnet-5": "claude-sonnet-5",
+	"mistral-large-2512": "mistral-large-2512",
+	"mistral-large-3": "mistral-large-2512",
+	"mistral-small-2603": "mistral-small-2603",
+	"mistral-small-4": "mistral-small-2603",
+	"ministral-8b-latest": "ministral-8b-latest",
+	"ministral-8b": "ministral-8b-latest",
+	"command-a-03-2025": "command-a-03-2025",
+	"command-a": "command-a-03-2025",
+	"command-r-08-2024": "command-r-08-2024",
+	"command-r": "command-r-08-2024",
+	"longcat-2.0": "longcat-2.0",
+	"longcat-2": "longcat-2.0",
+	"minicpm-v-4.5": "minicpm-v-4.5",
+	"minicpm-v-4.5-thinking": "minicpm-v-4.5",
+	"ernie-4.5": "ernie-4.5",
+	"ernie-4.5-300b": "ernie-4.5",
+	"dots-3-note-preview": "dots-3-note-preview",
+	"dots-3-note": "dots-3-note-preview",
+	"dots3-note-preview": "dots-3-note-preview",
+	"rednote-dots3": "dots-3-note-preview",
+	"doubao-seed-evolving": "doubao-seed-evolving",
+	"doubao-seed-evolve": "doubao-seed-evolving",
+	"doubao-seed-2.1-pro": "doubao-seed-2.1-pro",
+	"doubao-seed-2.1-pro-290000": "doubao-seed-2.1-pro",
+	"doubao-seed-2.1-turbo": "doubao-seed-2.1-turbo",
+	"doubao-seed-2-1-turbo": "doubao-seed-2.1-turbo",
 	"qwen3.8-max": "qwen-3.8-max",
+	"qwen3.8-flash": "qwen-3.8-flash",
 	"qwen3.7-max": "qwen-max",
+	"qwen3.6-max": "qwen3.6-max",
+	"qwen3.6-max-preview": "qwen3.6-max",
+	"qwen3-coder-plus": "qwen3-coder-plus",
+	"qwen3-coder": "qwen3-coder",
+	"qwen3-coder-480b": "qwen3-coder",
+	"glm-4.5-x": "glm-4.5-x",
+	"glm-4.5x": "glm-4.5-x",
+	"glm-5.2-fast": "glm-5.2-fast",
+	"glm-5.2f": "glm-5.2-fast",
+	"kimi-k3-fast": "kimi-k3-fast",
+	"kimi-k3f": "kimi-k3-fast",
+	"kimi-k2.7-code-fast": "kimi-k2.7-code-fast",
+	"kimi-k2.7-code-f": "kimi-k2.7-code-fast",
+	"kimi-k2.6-fast": "kimi-k2.6-fast",
+	"kimi-k2.6-turbo": "kimi-k2.6-turbo",
+	"kimi-k2-thinking-turbo": "kimi-k2-thinking-turbo",
+	"doubao-seed-2.0-code": "doubao-seed-2.0-code",
+	"doubao-seed-2-0-code": "doubao-seed-2.0-code",
+	"doubao-seed-2.0-lite": "doubao-seed-2.0-lite",
+	"doubao-seed-2-0-lite": "doubao-seed-2.0-lite",
 	"qwen-max": "qwen-max",
 	"hunyuan-t1": "hunyuan-t1",
 	"step-3.7-flash": "step",
@@ -952,6 +1523,42 @@ function isPriced(key) {
 	return FALLBACK_RATES.some((rate) => rate.key.toLowerCase() === resolved.toLowerCase());
 }
 /**
+* 促销在 nowMs 是否生效：factor 必须落在 (0,1) 区间，截止时刻及之后视为过期；
+* endsAtMs 缺省表示长期活动，在 factor 合法期间持续生效。
+* 导出供测试：纯函数。
+* @param promo - 待判定的促销窗口。
+* @param nowMs - 判定时刻（epoch ms）。
+*/
+function isPromoActive(promo, nowMs) {
+	const expired = promo.endsAtMs !== void 0 && nowMs >= promo.endsAtMs;
+	return Number.isFinite(nowMs) && !expired && promo.factor > 0 && promo.factor < 1;
+}
+/**
+* 把限时促销折入条目单价：生效期内返回 price 主档与 offPeak 全部乘 factor 的
+* 副本，其余字段原样保留；不在促销期（过期/未开始/factor 非法）原样返回。
+* 幂等由调用方保证——计价与费率表显示各自只折一次，勿对已折价副本重复应用。
+* @param entry - 目录条目（price 保持刊例价口径）。
+* @param nowMs - 判定时刻（epoch ms）。
+*/
+function applyPromo(entry, nowMs) {
+	const { promo } = entry;
+	if (promo === void 0 || !isPromoActive(promo, nowMs)) return entry;
+	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
+	});
+	return {
+		...entry,
+		price: {
+			...scaled(entry.price),
+			currency: entry.price.currency,
+			...entry.price.offPeak !== void 0 ? { offPeak: scaled(entry.price.offPeak) } : {}
+		}
+	};
+}
+/**
 * Price one band's token usage in CNY. The stats `input` field is the TOTAL
 * prompt tokens (cacheHit + cacheMiss), so billing splits it: the cache-hit
 * share prices at the hit rate and the remaining share at the miss rate.
@@ -980,15 +1587,17 @@ function priceBandCost(band, buckets, currency) {
 * @param peakShare - share of traffic in the peak band (0..1); defaults to {@link DEFAULT_PEAK_SHARE}.
 * @returns the estimated cost in CNY.
 */
-function computeCost(entry, buckets, peakShare = DEFAULT_PEAK_SHARE) {
-	const peak = priceBandCost(entry.price, buckets, entry.price.currency);
-	const off = entry.price.offPeak === void 0 ? peak : priceBandCost(entry.price.offPeak, buckets, entry.price.currency);
+function computeCost(entry, buckets, peakShare = DEFAULT_PEAK_SHARE, nowMs = Date.now()) {
+	const priced = applyPromo(entry, nowMs);
+	const peak = priceBandCost(priced.price, buckets, priced.price.currency);
+	const off = priced.price.offPeak === void 0 ? peak : priceBandCost(priced.price.offPeak, buckets, priced.price.currency);
 	return peak * peakShare + off * (1 - peakShare);
 }
 /**
 * 按调用时刻精确判定高峰/空闲档并计价（P0-1：替代固定比例混合）。时刻未知
 * （null/NaN，理论不发生在真实事件流）时回退 {@link DEFAULT_PEAK_SHARE} 混合，
-* 保持旧语义不低估。平档模型（无 offPeak）两个时段同价。
+* 保持旧语义不低估。平档模型（无 offPeak）两个时段同价。限时促销与峰谷档
+* 同口径：按事件时刻判定该笔流量当时享受的单价。
 * @param entry - the catalog entry whose prices apply.
 * @param buckets - token usage counts.
 * @param timeMs - the call's wall-clock time (epoch ms); null falls back to the peak-share mix.
@@ -996,9 +1605,10 @@ function computeCost(entry, buckets, peakShare = DEFAULT_PEAK_SHARE) {
 * @returns the estimated cost in CNY（USD 计价模型已按当前汇率折算）。
 */
 function computeCostAt(entry, buckets, timeMs, peakShare = DEFAULT_PEAK_SHARE) {
-	if (entry.price.offPeak === void 0) return priceBandCost(entry.price, buckets, entry.price.currency);
 	if (timeMs === null || timeMs === void 0 || !Number.isFinite(timeMs)) return computeCost(entry, buckets, peakShare);
-	return priceBandCost(tierAt(timeMs) === "peak" ? entry.price : entry.price.offPeak, buckets, entry.price.currency);
+	const priced = applyPromo(entry, timeMs);
+	if (priced.price.offPeak === void 0) return priceBandCost(priced.price, buckets, priced.price.currency);
+	return priceBandCost(tierAt(timeMs) === "peak" ? priced.price : priced.price.offPeak, buckets, priced.price.currency);
 }
 /**
 * Format an amount with adaptive precision and the given currency symbol.
@@ -3980,6 +4590,7 @@ const UsageBillingSettingsSchema = z.object({ [ENABLE_USAGE_STATS_TOOL_FIELD]: z
 const PRICING_REFRESH_INTERVAL_MS = 360 * 60 * 1e3;
 /** 订阅套餐额度缓存时长（毫秒）：上游配额 API 低频变化，5 分钟足够。 */
 const SUBSCRIPTION_CACHE_MS = 300 * 1e3;
+const BALANCE_CACHE_MS = 300 * 1e3;
 /** DeepSeek 余额查询的默认凭据引用（与 llm-deepseek 的默认引用一致）。 */
 const DEFAULT_BALANCE_API_KEY_ENV = "DEEPSEEK_API_KEY";
 /**
@@ -4463,6 +5074,10 @@ function apply(ctx, config = {}) {
 			res.end(JSON.stringify(live));
 		}
 	}), "usage-billing: pricing route");
+	let balanceCache = {
+		at: 0,
+		doc: { balances: [] }
+	};
 	ctx.effect(() => ctx.webServer.register({
 		kind: "exact",
 		path: "/api/billing/balance",
@@ -4476,39 +5091,53 @@ function apply(ctx, config = {}) {
 				...providers["deepseek"],
 				apiKeyEnv: config.balanceApiKeyEnv ?? DEFAULT_BALANCE_API_KEY_ENV
 			};
-			const balances = await queryBalances(ctx, providers);
-			const custom = await queryCustomBalances(ctx, config.customBalances ?? []);
-			const declared = await queryDeclaredEndpoints(ctx, piProviders, config.declaredEndpoints ?? []);
-			for (const row of [
-				...balances,
-				...custom,
-				...declared
-			]) if (row.error === "unauthorized") warnAuthOnce("balance", row.provider, row.displayName);
-			const official = balances.find((row) => row.provider === "deepseek");
-			let reconcile;
-			if (official !== void 0 && official.totalBalance !== void 0) {
-				const now = Date.now();
-				const today = dayStamp(now);
-				let todayOfficialCost = 0;
-				try {
-					todayOfficialCost = (await aggregator.aggregate()).byDay[today]?.officialCost ?? 0;
-				} catch {}
-				const result = reconcileBalanceDelta(reconcileRef, official, todayOfficialCost, today, now);
-				reconcileRef = result.ref;
-				if (result.event !== null && result.event.kind !== "flat") reconcile = {
-					...result.event,
-					provider: official.displayName
-				};
-				if (result.ref !== null) persistReconcileRef();
+			if (Date.now() - balanceCache.at < BALANCE_CACHE_MS) {
+				res.end(JSON.stringify(balanceCache.doc));
+				return;
 			}
-			res.end(JSON.stringify({
-				balances: [
+			try {
+				const balances = await queryBalances(ctx, providers);
+				const custom = await queryCustomBalances(ctx, config.customBalances ?? []);
+				const declared = await queryDeclaredEndpoints(ctx, piProviders, config.declaredEndpoints ?? []);
+				for (const row of [
 					...balances,
 					...custom,
 					...declared
-				],
-				...reconcile === void 0 ? {} : { reconcile }
-			}));
+				]) if (row.error === "unauthorized") warnAuthOnce("balance", row.provider, row.displayName);
+				const official = balances.find((row) => row.provider === "deepseek");
+				let reconcile;
+				if (official !== void 0 && official.totalBalance !== void 0) {
+					const now = Date.now();
+					const today = dayStamp(now);
+					let todayOfficialCost = 0;
+					try {
+						todayOfficialCost = (await aggregator.aggregate()).byDay[today]?.officialCost ?? 0;
+					} catch {}
+					const result = reconcileBalanceDelta(reconcileRef, official, todayOfficialCost, today, now);
+					reconcileRef = result.ref;
+					if (result.event !== null && result.event.kind !== "flat") reconcile = {
+						...result.event,
+						provider: official.displayName
+					};
+					if (result.ref !== null) persistReconcileRef();
+				}
+				const doc = {
+					balances: [
+						...balances,
+						...custom,
+						...declared
+					],
+					...reconcile === void 0 ? {} : { reconcile }
+				};
+				balanceCache = {
+					at: Date.now(),
+					doc
+				};
+				res.end(JSON.stringify(doc));
+			} catch (error) {
+				console.warn("[usage-billing] refreshBalances failed; serving cached balances:", error);
+				res.end(JSON.stringify(balanceCache.doc));
+			}
 		}
 	}), "usage-billing: balance route");
 	ctx.effect(() => ctx.webServer.register({