@kenz1117/dsh-ui-usage-billing 0.9.7 → 0.9.8

package/lib/index.js

@@ -958,6 +958,46 @@ const DEFAULT_SUBSCRIPTION_PROVIDERS = [
 function isOfficialProvider(provider) {
 	return /^deepseek(?:-[a-z0-9-]+)?$/i.test(provider.trim());
 }
+/** 由 baseURL 归一化出站点 origin（协议 + 主机 + 端口）；解析失败回退原值。 */
+function siteOriginOf(baseURL) {
+	try {
+		return new URL(baseURL).origin;
+	} catch {
+		return baseURL;
+	}
+}
+/**
+* 把一个 provider 路由归类为站点引用。判定顺序（与路由在 provider 配置里的状态一致）：
+* - 路由存在于当前配置且配了 baseURL → 中转站 `site`（按 origin 归组，同站多 key 合并）；
+* - 路由存在于当前配置但无 baseURL → 厂商直连 `direct`；
+* - 路由不在当前配置里 → `unknown`（改过名 / 删除过，是「读不到」而非「直连」）。
+* @param provider - 会话日志里的 provider 路由名（request/header 的 `config.provider`）。
+* @param routes - 当前 provider 路由视图（来自 llm-pi-ai providers）。
+*/
+function siteRefOf(provider, routes) {
+	const view = routes[provider];
+	if (view !== void 0) {
+		if (view.baseURL !== void 0) return {
+			kind: "site",
+			origin: siteOriginOf(view.baseURL),
+			provider
+		};
+		return {
+			kind: "direct",
+			provider
+		};
+	}
+	return {
+		kind: "unknown",
+		provider
+	};
+}
+/** 站点桶的稳定 key：`site:<origin>` 与 `direct:<provider>` 分开，`unknown` 单一桶。 */
+function siteBucketKey(ref) {
+	if (ref.kind === "site") return `site:${ref.origin ?? ""}`;
+	if (ref.kind === "direct") return `direct:${ref.provider}`;
+	return "unknown";
+}
 /** Zeroed usage accumulator. */
 function emptyUsage() {
 	return {
@@ -1081,12 +1121,13 @@ function turnState(turns, turn) {
 *   (default: any `deepseek`-prefixed id). Others count as third-party.
 * @returns the per-session fold (cached by the incremental aggregator).
 */
-function foldSession(events, subscriptionProviders, officialProviderIds) {
+function foldSession(events, subscriptionProviders, officialProviderIds, routes = {}) {
 	const fold = {
 		total: emptyUsage(),
 		byModel: /* @__PURE__ */ new Map(),
 		byDay: /* @__PURE__ */ new Map(),
 		byDayModels: /* @__PURE__ */ new Map(),
+		bySite: /* @__PURE__ */ new Map(),
 		planCalls: /* @__PURE__ */ new Map(),
 		turns: [],
 		perf: [],
@@ -1101,6 +1142,7 @@ function foldSession(events, subscriptionProviders, officialProviderIds) {
 	let key = "other";
 	let subscription = false;
 	let official = false;
+	let siteBucket = "unknown";
 	const turns = /* @__PURE__ */ new Map();
 	const steps = /* @__PURE__ */ new Map();
 	let lastOpenStepKey;
@@ -1145,6 +1187,7 @@ function foldSession(events, subscriptionProviders, officialProviderIds) {
 			key = resolveCatalogKey(model);
 			subscription = subscriptionProviders.has(provider);
 			official = officialProviderIds === void 0 ? isOfficialProvider(provider) : officialProviderIds.has(provider);
+			siteBucket = siteBucketKey(siteRefOf(provider, routes));
 			if (lastOpenStepKey !== void 0) {
 				const stepState = steps.get(lastOpenStepKey);
 				if (stepState !== void 0 && stepState.requestTime === void 0) stepState.requestTime = event.time;
@@ -1174,6 +1217,7 @@ function foldSession(events, subscriptionProviders, officialProviderIds) {
 		foldUsage(usageCell(fold.byModel, modelKey), usage, modelKey, subscription, event.time, official);
 		foldUsage(usageCell(fold.byDay, day), usage, modelKey, subscription, event.time, official);
 		foldUsage(modelDayCell(fold.byDayModels, day, modelKey), usage, modelKey, subscription, event.time, official);
+		foldUsage(usageCell(fold.bySite, siteBucket), usage, modelKey, subscription, event.time, official);
 		if (subscription) fold.planCalls.set(modelKey, (fold.planCalls.get(modelKey) ?? 0) + 1);
 		const turn = event.data.turn ?? -1;
 		const state = turnState(turns, turn);
@@ -1293,6 +1337,8 @@ function createUsageAggregator(persistence, options = {}) {
 	const cache = /* @__PURE__ */ new Map();
 	let lastDoc;
 	let lastAt = 0;
+	/** 每次聚合取最新的 provider 路由视图（中转站零配置发现）；缺省按空处理（全部未知路由）。 */
+	const routesOf = () => options.resolveRoutes?.() ?? {};
 	/** 失效键：日志文件的 mtime+size；拿不到（后端无 locate / 文件丢失）时每次重折。 */
 	const stampOf = async (meta) => {
 		const location = persistence.locate?.(meta);
@@ -1329,7 +1375,7 @@ function createUsageAggregator(persistence, options = {}) {
 				const { events } = await persistence.readFrom(meta.id, 0);
 				const after = await stampOf(meta);
 				if (stamp !== null && after !== stamp) continue;
-				const fold = foldSession(events, subscriptionProviders, officialProviderIds);
+				const fold = foldSession(events, subscriptionProviders, officialProviderIds, routesOf());
 				cache.set(id, {
 					stamp,
 					fold
@@ -1354,6 +1400,7 @@ function createUsageAggregator(persistence, options = {}) {
 		const byModel = /* @__PURE__ */ new Map();
 		const byDay = /* @__PURE__ */ new Map();
 		const byDayModels = /* @__PURE__ */ new Map();
+		const bySite = /* @__PURE__ */ new Map();
 		const planCalls = /* @__PURE__ */ new Map();
 		const sessionRows = [];
 		const turnRows = [];
@@ -1376,6 +1423,7 @@ function createUsageAggregator(persistence, options = {}) {
 			for (const [modelKey, cell] of fold.byModel) mergeUsageInto(usageCell(byModel, modelKey), cell);
 			for (const [day, cell] of fold.byDay) mergeUsageInto(usageCell(byDay, day), cell);
 			for (const [day, models] of fold.byDayModels) for (const [modelKey, cell] of models) mergeUsageInto(modelDayCell(byDayModels, day, modelKey), cell);
+			for (const [siteKey, cell] of fold.bySite) mergeUsageInto(usageCell(bySite, siteKey), cell);
 			for (const [modelKey, count] of fold.planCalls) planCalls.set(modelKey, (planCalls.get(modelKey) ?? 0) + count);
 			for (const sample of fold.perf) {
 				let modelAccum = perfModel.get(sample.model);
@@ -1407,7 +1455,7 @@ function createUsageAggregator(persistence, options = {}) {
 				sessionId,
 				...row
 			});
-			const wsName = workspaceNameOf(meta.cwd);
+			const wsName = options.resolveWorkspaceTitle !== void 0 && meta.cwd !== void 0 ? options.resolveWorkspaceTitle(meta.cwd) ?? workspaceNameOf(meta.cwd) : workspaceNameOf(meta.cwd);
 			const ws = workspaceMap.get(wsName) ?? {
 				name: wsName,
 				calls: 0,
@@ -1471,6 +1519,7 @@ function createUsageAggregator(persistence, options = {}) {
 			bySession: sessionRows.slice(0, 100),
 			byTurn: turnRows.slice(0, 200),
 			byWorkspace: workspaces.slice(0, 100),
+			...bySite.size === 0 ? {} : { bySite: toRecord(bySite) },
 			...perf === void 0 ? {} : { perf },
 			byRole: (() => {
 				const chars = roles.userChars + roles.toolChars;
@@ -1576,7 +1625,7 @@ function createCooldownGate(options = {}) {
 * provider's key once and every surface reuses it.
 */
 /** Abort a balance fetch when the upstream hangs beyond this budget. */
-const FETCH_TIMEOUT_MS$1 = 8e3;
+const FETCH_TIMEOUT_MS$2 = 8e3;
 /**
 * 每平台熔断门：单个 provider 连续可重试失败（网络波动 / 5xx / 429）达阈值后
 * 短路一段真实时间，避免 30 秒轮询在已不可用的上游上反复打满超时。
@@ -1601,6 +1650,8 @@ const STEPFUN_BALANCE_URL = "https://api.stepfun.com/v1/accounts";
 const SILICONFLOW_BALANCE_URL = "https://api.siliconflow.cn/v1/user/info";
 /** xAI 官方账单接口（docs.x.ai/developers/api/credits）；total.val 为美分。 */
 const XAI_CREDITS_URL = "https://api.x.ai/v1/billing/credits";
+/** 智谱 GLM（大模型国内域）官方余额接口（open.bigmodel.cn/api/paas/v4/balance）。 */
+const ZHIPU_BALANCE_URL = "https://open.bigmodel.cn/api/paas/v4/balance";
 /** 数字归一化：接口返回的余额是字符串（如 `"110.00"`），统一转 number。 */
 function toNumber(value) {
 	if (typeof value === "number" && Number.isFinite(value)) return value;
@@ -1635,7 +1686,7 @@ async function queryBearerBalance(ctx, url, apiKeyEnv, provider, displayName, pa
 	};
 	const doRequest = async () => {
 		const controller = new AbortController();
-		const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS$1);
+		const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS$2);
 		try {
 			const response = await fetch(url, {
 				headers: {
@@ -1791,6 +1842,27 @@ function queryXai(ctx, apiKeyEnv) {
 		};
 	});
 }
+/**
+* Query the Zhipu GLM / Z.ai (国内 bigmodel-cn 域) account balance.
+* 与订阅（zai-coding-cn 的 Coding Plan）互补：一个平台可同时有钱包余额与订阅
+* 套餐，两者各读各的（TokenLedger 同款双读姿态）。Z.ai global 域币种为 USD，
+* 本函数固定走国内 CNY 域（open.bigmodel.cn），币种不猜，仅覆盖国内域。
+* @param ctx - host context carrying the credentials seam.
+* @param apiKeyEnv - credential reference resolving the Zhipu API key.
+* @returns the balance row, or an error row when the key/endpoint misbehaves.
+*/
+function queryZhipu(ctx, apiKeyEnv) {
+	return queryBearerBalance(ctx, ZHIPU_BALANCE_URL, apiKeyEnv, "智谱 AI", "智谱 AI", (data) => {
+		const doc = data;
+		const totalBalance = toNumber(doc.balance?.available) ?? toNumber(doc.balance?.total);
+		return {
+			provider: "智谱 AI",
+			displayName: "智谱 AI",
+			currency: "CNY",
+			...totalBalance !== void 0 ? { totalBalance } : {}
+		};
+	});
+}
 const QUERIERS = [
 	{
 		route: "deepseek",
@@ -1816,6 +1888,16 @@ const QUERIERS = [
 		route: "xai",
 		displayName: "xAI",
 		querier: queryXai
+	},
+	{
+		route: "zhipu",
+		displayName: "智谱 AI",
+		querier: queryZhipu
+	},
+	{
+		route: "zai-coding-cn",
+		displayName: "智谱 AI",
+		querier: queryZhipu
 	}
 ];
 /**
@@ -1919,7 +2001,7 @@ async function queryCustomBalances(ctx, configs) {
 		};
 		const doRequest = async () => {
 			const controller = new AbortController();
-			const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS$1);
+			const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS$2);
 			try {
 				const response = await fetch(config.url, {
 					method: config.method ?? "GET",
@@ -1985,7 +2067,7 @@ async function queryCustomBalances(ctx, configs) {
 * catalog for the rest — a total outage answers `{ source: 'builtin' }`.
 */
 /** Abort a fetch when the upstream hangs beyond this budget. */
-const FETCH_TIMEOUT_MS = 8e3;
+const FETCH_TIMEOUT_MS$1 = 8e3;
 /** 每平台熔断门：单个定价上游连续可重试失败（网络 / 5xx / 429）达阈值后短路，
 *  避免 6 小时刷新循环与每次启动在已故障的上游上反复打满超时。按 URL 独立。 */
 const pricingGate = createCooldownGate({
@@ -2079,7 +2161,7 @@ async function fetchText(url) {
 	if (!pricingGate.check(url)) return null;
 	const doFetch = async () => {
 		const controller = new AbortController();
-		const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+		const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS$1);
 		try {
 			const response = await fetch(url, { signal: controller.signal });
 			if (!response.ok) {
@@ -2330,7 +2412,7 @@ function identifySubscriptionPlans(providers) {
 }
 const DEFAULT_TIMEOUT_MS = 15e3;
 /** Number, or null when the value is not a finite number (nor numeric string). */
-function numberOrNull(value) {
+function numberOrNull$1(value) {
 	if (typeof value === "number" && Number.isFinite(value)) return value;
 	if (typeof value === "string" && value.trim() !== "") {
 		const parsed = Number(value);
@@ -2339,11 +2421,11 @@ function numberOrNull(value) {
 	return null;
 }
 /** Clamp a percentage to 0–100. */
-function clampPercent(value) {
+function clampPercent$1(value) {
 	return value === null ? null : Math.max(0, Math.min(100, value));
 }
 /** Round to one decimal. */
-function round1(value) {
+function round1$1(value) {
 	return Math.round(value * 10) / 10;
 }
 /** Number → ISO string (seconds treated as epoch seconds, ms as epoch ms). */
@@ -2357,7 +2439,7 @@ function toIso(value) {
 	return Number.isNaN(date.getTime()) ? null : date.toISOString();
 }
 /** Map a fetch error to a stable status. */
-function statusOf(error) {
+function statusOf$1(error) {
 	if (error instanceof Error) {
 		if (error.name === "TimeoutError" || error.name === "AbortError") return "unavailable";
 		const status = error.httpStatus;
@@ -2392,21 +2474,21 @@ async function requestJson(url, init, timeoutMs) {
 function kimiWindow(value, kind) {
 	if (value === null || typeof value !== "object") return null;
 	const record = value;
-	const limit = numberOrNull(record.limit ?? record.total);
-	const remaining = numberOrNull(record.remaining);
-	if (remaining === null && limit === null && numberOrNull(record.percentage ?? record.usedPercent ?? record.used_percent) === null) return null;
+	const limit = numberOrNull$1(record.limit ?? record.total);
+	const remaining = numberOrNull$1(record.remaining);
+	if (remaining === null && limit === null && numberOrNull$1(record.percentage ?? record.usedPercent ?? record.used_percent) === null) return null;
 	const hasLimit = limit !== null && limit > 0;
 	let usedPercent;
-	if (hasLimit) usedPercent = round1(clampPercent((limit - (remaining ?? 0)) / limit * 100) ?? 0);
+	if (hasLimit) usedPercent = round1$1(clampPercent$1((limit - (remaining ?? 0)) / limit * 100) ?? 0);
 	else {
-		const percent = numberOrNull(record.percentage ?? record.usedPercent ?? record.used_percent);
-		usedPercent = percent !== null ? round1(clampPercent(percent) ?? 0) : remaining === null || remaining <= 0 ? 100 : 0;
+		const percent = numberOrNull$1(record.percentage ?? record.usedPercent ?? record.used_percent);
+		usedPercent = percent !== null ? round1$1(clampPercent$1(percent) ?? 0) : remaining === null || remaining <= 0 ? 100 : 0;
 	}
 	const resetsAt = toIso(record.resetTime ?? record.reset_time ?? record.resetsAt);
 	return {
 		kind,
 		usedPercent,
-		remainingPercent: round1(100 - usedPercent),
+		remainingPercent: round1$1(100 - usedPercent),
 		...remaining !== null ? { remaining } : {},
 		...resetsAt === null ? {} : { resetsAt }
 	};
@@ -2448,15 +2530,15 @@ async function collectKimi(keys, config, timeoutMs) {
 		return {
 			provider: config.provider,
 			displayName: "Kimi For Coding",
-			status: statusOf(error),
+			status: statusOf$1(error),
 			windows: []
 		};
 	}
 }
 /** Window length in minutes for a Z.ai limit row; null when unknown. */
 function zaiWindowMinutes(limit) {
-	const unit = numberOrNull(limit.unit);
-	const number = numberOrNull(limit.number);
+	const unit = numberOrNull$1(limit.unit);
+	const number = numberOrNull$1(limit.number);
 	if (unit === null || number === null || number <= 0) return null;
 	if (unit === 5) return number;
 	if (unit === 3) return number * 60;
@@ -2466,14 +2548,14 @@ function zaiWindowMinutes(limit) {
 }
 /** Used percent for a Z.ai limit row. */
 function zaiUsedPercent(limit) {
-	const total = numberOrNull(limit.usage);
-	const remaining = numberOrNull(limit.remaining);
-	const current = numberOrNull(limit.currentValue ?? limit.current_value);
+	const total = numberOrNull$1(limit.usage);
+	const remaining = numberOrNull$1(limit.remaining);
+	const current = numberOrNull$1(limit.currentValue ?? limit.current_value);
 	if (total !== null && total > 0) {
 		const used = remaining === null ? current : current === null ? total - remaining : Math.max(total - remaining, current);
-		if (used !== null) return clampPercent(Math.max(0, Math.min(total, used)) / total * 100);
+		if (used !== null) return clampPercent$1(Math.max(0, Math.min(total, used)) / total * 100);
 	}
-	return clampPercent(numberOrNull(limit.percentage ?? limit.usedPercent ?? limit.used_percent));
+	return clampPercent$1(numberOrNull$1(limit.percentage ?? limit.usedPercent ?? limit.used_percent));
 }
 /** One Z.ai quota window row. */
 function zaiWindow(limit, kind, fallbackReset = null) {
@@ -2482,8 +2564,8 @@ function zaiWindow(limit, kind, fallbackReset = null) {
 	const resetsAt = toIso(limit.nextResetTime ?? limit.next_reset_time) ?? fallbackReset;
 	return {
 		kind,
-		usedPercent: round1(usedPercent),
-		remainingPercent: round1(100 - usedPercent),
+		usedPercent: round1$1(usedPercent),
+		remainingPercent: round1$1(100 - usedPercent),
 		...resetsAt === null ? {} : { resetsAt }
 	};
 }
@@ -2568,7 +2650,7 @@ async function collectZai(keys, config, timeoutMs) {
 		return {
 			provider: config.provider,
 			displayName: "Z.ai Coding Plan",
-			status: statusOf(error),
+			status: statusOf$1(error),
 			windows: []
 		};
 	}
@@ -2578,20 +2660,20 @@ function goWindow(value, kind) {
 	if (value === null || typeof value !== "object") return null;
 	const record = value;
 	const percentSource = record.usagePercent ?? record.usedPercent ?? record.percentUsed ?? record.percentage ?? record.percent;
-	let usedPercent = clampPercent(numberOrNull(percentSource));
+	let usedPercent = clampPercent$1(numberOrNull$1(percentSource));
 	if (usedPercent === null) {
-		const used = numberOrNull(record.used ?? record.consumed);
-		const limit = numberOrNull(record.limit ?? record.total ?? record.quota);
-		if (used !== null && limit !== null && limit > 0) usedPercent = clampPercent(used / limit * 100);
+		const used = numberOrNull$1(record.used ?? record.consumed);
+		const limit = numberOrNull$1(record.limit ?? record.total ?? record.quota);
+		if (used !== null && limit !== null && limit > 0) usedPercent = clampPercent$1(used / limit * 100);
 	}
 	if (usedPercent === null) return null;
 	if (usedPercent <= 1 && usedPercent >= 0 && record.percent === void 0 && percentSource !== void 0) usedPercent *= 100;
-	const resetSeconds = numberOrNull(record.resetInSec ?? record.resetInSeconds ?? record.resetSeconds);
+	const resetSeconds = numberOrNull$1(record.resetInSec ?? record.resetInSeconds ?? record.resetSeconds);
 	const resetsAt = resetSeconds === null ? toIso(record.resetAt ?? record.resetsAt ?? record.nextReset) : new Date(Date.now() + Math.max(0, resetSeconds) * 1e3).toISOString();
 	return {
 		kind,
-		usedPercent: round1(clampPercent(usedPercent) ?? 0),
-		remainingPercent: round1(100 - (clampPercent(usedPercent) ?? 0)),
+		usedPercent: round1$1(clampPercent$1(usedPercent) ?? 0),
+		remainingPercent: round1$1(100 - (clampPercent$1(usedPercent) ?? 0)),
 		...resetsAt === null ? {} : { resetsAt }
 	};
 }
@@ -2631,7 +2713,7 @@ async function collectOpenCodeGo(keys, config, timeoutMs) {
 		return {
 			provider: config.provider,
 			displayName: "OpenCode Go",
-			status: statusOf(error),
+			status: statusOf$1(error),
 			windows: []
 		};
 	}
@@ -2648,14 +2730,14 @@ async function collectOpenCodeGo(keys, config, timeoutMs) {
 function minmaxWindow(record, kind, remainPctKey, statusKey, resetKey) {
 	if (record === void 0) return null;
 	if (Number(record[statusKey]) === 3) return null;
-	const remain = numberOrNull(record[remainPctKey]);
+	const remain = numberOrNull$1(record[remainPctKey]);
 	if (remain === null) return null;
-	const usedPercent = round1(clampPercent(100 - (remain <= 1 ? remain * 100 : remain)) ?? 0);
+	const usedPercent = round1$1(clampPercent$1(100 - (remain <= 1 ? remain * 100 : remain)) ?? 0);
 	const resetsAt = toIso(record[resetKey]);
 	return {
 		kind,
 		usedPercent,
-		remainingPercent: round1(100 - usedPercent),
+		remainingPercent: round1$1(100 - usedPercent),
 		...resetsAt === null ? {} : { resetsAt }
 	};
 }
@@ -2702,7 +2784,7 @@ async function collectMiniMax(keys, config, timeoutMs) {
 		return {
 			provider: config.provider,
 			displayName: "MiniMax Coding Plan",
-			status: statusOf(error),
+			status: statusOf$1(error),
 			windows: []
 		};
 	}
@@ -2716,15 +2798,15 @@ async function collectMiniMax(keys, config, timeoutMs) {
 function parseOpenRouterCredits(body) {
 	const doc = body ?? {};
 	const data = doc.data ?? doc;
-	const total = numberOrNull(data.total_credits ?? data.credits);
-	const used = numberOrNull(data.total_usage ?? data.usage);
+	const total = numberOrNull$1(data.total_credits ?? data.credits);
+	const used = numberOrNull$1(data.total_usage ?? data.usage);
 	if (total === null || total <= 0 || used === null) return [];
-	const usedPercent = round1(clampPercent(used / total * 100) ?? 0);
+	const usedPercent = round1$1(clampPercent$1(used / total * 100) ?? 0);
 	const resetsAt = toIso(data.resets_at ?? data.next_reset_time);
 	return [{
 		kind: "billing",
 		usedPercent,
-		remainingPercent: round1(100 - usedPercent),
+		remainingPercent: round1$1(100 - usedPercent),
 		...resetsAt === null ? {} : { resetsAt }
 	}];
 }
@@ -2753,7 +2835,7 @@ async function collectOpenRouter(keys, config, timeoutMs) {
 		return {
 			provider: config.provider,
 			displayName: "OpenRouter",
-			status: statusOf(error),
+			status: statusOf$1(error),
 			windows: []
 		};
 	}
@@ -2789,6 +2871,262 @@ async function collectSubscriptions(keys, plans = [], timeoutMs = DEFAULT_TIMEOU
 	}));
 }
 //#endregion
+//#region lib/types/relay.js
+/**
+* 中转站额度查询（node 半区）：识别并读取 New API 系与 Sub2API 的「余额 / 额度窗口」。
+*
+* 适用场景：用户把某条 llm-pi-ai provider 路由的 `baseURL` 指向第三方中转站
+* （New API / One API / VoAPI / Sub2API 等）。这类站点不卖官方余额，卖的是
+* 按 key 的额度（used/total）或多个滚动窗口。本模块对**配了 baseURL 且有
+* apiKeyEnv** 的路由逐个探测两个已知端点，能解析出额度就返回；解析不出的
+* 静默标记 unavailable，绝不臆造金额（与 balance/subscriptions 一致的姿态）。
+*
+* 探测顺序：先 Sub2API `/v1/usage`（标准化程度高），再 New API `/api/status`；
+* 404 = 不是该套程序，继续试下一种；401/403 = 是但 key 不对（unauthorized）；
+* 网络/5xx 走熔断门短路一段时间。同一站点多把 key 是独立额度，分别列出。
+*/
+/** 单个中转站额度请求的熔断门：按 baseURL 独立熔断（各站点互不干扰）。 */
+const relayGate = createCooldownGate({
+	failures: 3,
+	cooldownMs: 6e4
+});
+/** Abort a relay fetch when the upstream hangs beyond this budget. */
+const FETCH_TIMEOUT_MS = 8e3;
+/** Number, or null when the value is not a finite number (nor numeric string). */
+function numberOrNull(value) {
+	if (typeof value === "number" && Number.isFinite(value)) return value;
+	if (typeof value === "string" && value.trim() !== "") {
+		const parsed = Number(value);
+		if (Number.isFinite(parsed)) return parsed;
+	}
+	return null;
+}
+/** Clamp a percentage to 0–100. */
+function clampPercent(value) {
+	return value === null ? null : Math.max(0, Math.min(100, value));
+}
+/** Round to one decimal. */
+function round1(value) {
+	return Math.round(value * 10) / 10;
+}
+/** Map a fetch error to a stable status (same taxonomy as subscriptions). */
+function statusOf(error) {
+	if (error instanceof Error) {
+		if (error.name === "TimeoutError" || error.name === "AbortError") return "unavailable";
+		const status = error.httpStatus;
+		if (status === 401 || status === 403) return "unauthorized";
+		if (status === 429) return "rate-limited";
+		if (status === 404) return "unavailable";
+	}
+	return "unavailable";
+}
+/**
+* GET 一个中转站端点并返回 JSON。可重试错误（网络 / 5xx / 429）退避重试一次；
+* 401/403/404 不重试。返回 `{ ok, status, data }`，由调用方区分"不是这套程序
+* （404）"与"是但读取失败（其他非 2xx）"。
+*/
+async function fetchRelayJson(url, apiKey) {
+	const doFetch = async () => {
+		const response = await fetch(url, {
+			headers: {
+				accept: "application/json",
+				authorization: `Bearer ${apiKey}`
+			},
+			signal: AbortSignal.timeout(FETCH_TIMEOUT_MS)
+		});
+		if (!response.ok) {
+			if (response.status === 404) return {
+				ok: false,
+				status: 404
+			};
+			const error = /* @__PURE__ */ new Error(`HTTP ${String(response.status)}`);
+			error.httpStatus = response.status;
+			throw error;
+		}
+		return {
+			ok: true,
+			status: response.status,
+			data: await response.json()
+		};
+	};
+	return await withRetry(doFetch, {
+		retries: 1,
+		baseDelayMs: 250,
+		maxDelayMs: 2e3
+	});
+}
+/** 新建一个额度窗口行（未解析出百分比时不产出）。 */
+function windowOf(kind, usedPercent, resetsAt) {
+	const used = clampPercent(usedPercent);
+	if (used === null) return null;
+	return {
+		kind,
+		usedPercent: round1(used),
+		remainingPercent: round1(Math.max(0, 100 - used)),
+		...resetsAt === void 0 ? {} : { resetsAt }
+	};
+}
+/**
+* 解析 Sub2API `/v1/usage` 响应：能取到 balance 或 quota/used 就识别为 sub2api。
+* 三种形态（窗口 / 分组 / 钱包余额）都宽容处理：有 `quota/total` 给出窗口，
+* 有 `balance` 给出余额，两者可同时存在。
+* @param data - `/v1/usage` 的 JSON 响应。
+* @returns 解析结果；两者都取不到返回 null（不是 Sub2API 或响应漂移）。
+*/
+function parseSub2ApiUsage(data) {
+	if (data === null || typeof data !== "object") return null;
+	const doc = data;
+	const balance = numberOrNull(doc.balance);
+	const total = numberOrNull(doc.quota ?? doc.total_quota ?? doc.limit);
+	const used = numberOrNull(doc.used_quota ?? doc.usage);
+	if (balance === null && total === null) return null;
+	const windows = [];
+	if (total !== null && used !== null) {
+		const pct = used / total * 100;
+		const window = windowOf("weekly", Number.isFinite(pct) ? pct : null);
+		if (window !== null) windows.push(window);
+	}
+	return {
+		...balance !== null ? { balance } : {},
+		...windows.length === 0 ? {} : { windows }
+	};
+}
+/**
+* 解析 New API `/api/status` 响应：New API 系（One API / VoAPI 分支）的额度是
+* 按记录行的 ratio（已用比例）。只给出窗口，不猜金额（币种防猜）。
+* @param data - `/api/status` 的 JSON 响应。
+* @returns 窗口；取不到比例返回 null（响应漂移）。
+*/
+function parseNewApiStatus(data) {
+	if (data === null || typeof data !== "object") return null;
+	const inner = data.data;
+	if (inner === null || typeof inner !== "object") return null;
+	const ratio = numberOrNull(inner.ratio);
+	const used = numberOrNull(inner.used_quota);
+	const total = numberOrNull(inner.total_quota ?? inner.quota);
+	let pct = null;
+	if (ratio !== null) pct = ratio * 100;
+	else if (total !== null && used !== null) pct = used / total * 100;
+	if (pct === null) return null;
+	const window = windowOf("billing", Number.isFinite(pct) ? pct : null);
+	return window === null ? null : { windows: [window] };
+}
+/** 归一化站点 origin（与聚合层 `siteOriginOf` 同口径）。 */
+function originOf(baseURL) {
+	try {
+		return new URL(baseURL).origin;
+	} catch {
+		return baseURL;
+	}
+}
+/** 构造端点 URL：`/v1/usage` 与 `/api/status` 都以 baseURL 为宿主解析。 */
+function endpointOf(baseURL, path) {
+	return new URL(path, baseURL).toString();
+}
+/**
+* 查询单个中转站路由的额度。先试 Sub2API，再试 New API；任一读出额度即返回。
+* @param ctx - host context carrying the credentials seam.
+* @param route - 待探测的路由（baseURL + apiKeyEnv）。
+* @returns 该路由的一行额度结果（status 标记成败）。
+*/
+async function queryRelayQuota(ctx, route) {
+	const base = {
+		route: route.route,
+		origin: originOf(route.baseURL),
+		displayName: route.displayName ?? route.route
+	};
+	if (!relayGate.check(route.baseURL)) return {
+		...base,
+		kind: "unknown",
+		status: "unavailable"
+	};
+	const hit = await ctx.credentials.resolve(credentialRef(route.apiKeyEnv));
+	if (hit === void 0 || hit.value === "") return {
+		...base,
+		kind: "unknown",
+		status: "not-configured"
+	};
+	try {
+		const sub2 = await fetchRelayJson(endpointOf(route.baseURL, "/v1/usage"), hit.value);
+		if (sub2.ok) {
+			const parsed = parseSub2ApiUsage(sub2.data);
+			if (parsed !== null) {
+				relayGate.success(route.baseURL);
+				return {
+					...base,
+					kind: "sub2api",
+					status: "ok",
+					...parsed.balance !== void 0 ? { balance: parsed.balance } : {},
+					...parsed.windows !== void 0 ? { windows: parsed.windows } : {}
+				};
+			}
+			relayGate.fail(route.baseURL);
+			return {
+				...base,
+				kind: "sub2api",
+				status: "invalid-response"
+			};
+		}
+		if (sub2.status === 401 || sub2.status === 403) {
+			relayGate.fail(route.baseURL);
+			return {
+				...base,
+				kind: "unknown",
+				status: "unauthorized"
+			};
+		}
+		const na = await fetchRelayJson(endpointOf(route.baseURL, "/api/status"), hit.value);
+		if (na.status === 401 || na.status === 403) {
+			relayGate.fail(route.baseURL);
+			return {
+				...base,
+				kind: "unknown",
+				status: "unauthorized"
+			};
+		}
+		if (na.ok) {
+			const parsed = parseNewApiStatus(na.data);
+			if (parsed !== null) {
+				relayGate.success(route.baseURL);
+				return {
+					...base,
+					kind: "new-api",
+					status: "ok",
+					...parsed.windows !== void 0 ? { windows: parsed.windows } : {}
+				};
+			}
+			relayGate.fail(route.baseURL);
+			return {
+				...base,
+				kind: "new-api",
+				status: "invalid-response"
+			};
+		}
+		relayGate.fail(route.baseURL);
+		return {
+			...base,
+			kind: "unknown",
+			status: "unavailable"
+		};
+	} catch (error) {
+		relayGate.fail(route.baseURL);
+		return {
+			...base,
+			kind: "unknown",
+			status: statusOf(error)
+		};
+	}
+}
+/**
+* 批量查询多个中转站路由的额度（每个独立成败，互不影响）。
+* @param ctx - host context carrying the credentials seam.
+* @param routes - 配了 baseURL 且 apiKeyEnv 有值的路由列表。
+* @returns 每个路由一行的额度结果。
+*/
+async function queryRelayQuotas(ctx, routes) {
+	return await Promise.all(routes.map(async (route) => queryRelayQuota(ctx, route)));
+}
+//#endregion
 //#region lib/types/client/usage-billing-settings.js
 /**
 * usage-stats 工具开关的共享设置契约（node 与 client 两端共用）。
@@ -2889,19 +3227,80 @@ const SUBSCRIPTION_KEY_SOURCES = [
 		key: "openrouterApiKey"
 	}
 ];
-/**
-* 读取 llm-pi-ai 设置的 `providers` 字典（`<route> → { apiKeyEnv? }`）。
-* 余额查询复用同一份来源：部署为某个 provider 配一次 key，多个 surface 共享。
+/** 读 llm-pi-ai 设置的 `providers` 字典（`<route> → { apiKeyEnv?, baseURL?, displayName? }`）。
+*  余额与订阅查询复用同一份来源：部署为某个 provider 配一次，多 surface 共享。
 * @param settings - the settings service (reads the llm-pi-ai namespace).
 * @returns the providers dict; empty when the namespace is unreadable.
 */
 async function readPiAiProviders(settings) {
 	try {
-		return (settings.describe({ redactSecrets: true }).find((descriptor) => descriptor.ns === "llm-pi-ai")?.value)?.providers ?? {};
+		const providers = (settings.describe({ redactSecrets: true }).find((descriptor) => descriptor.ns === "llm-pi-ai")?.value)?.providers;
+		const out = {};
+		for (const [route, entry] of Object.entries(providers ?? {})) {
+			if (entry === null || typeof entry !== "object") continue;
+			const { apiKeyEnv, baseURL, displayName } = entry;
+			out[route] = {
+				...typeof apiKeyEnv === "string" ? { apiKeyEnv } : {},
+				...typeof baseURL === "string" ? { baseURL } : {},
+				...typeof displayName === "string" ? { displayName } : {}
+			};
+		}
+		return out;
 	} catch {
 		return {};
 	}
 }
+/** 同步读取 provider 路由的 baseURL 视图（中转站零配置发现来源）。
+*  `settings.describe` 是同步调用，聚合器每次折叠取最新站点映射，无需缓存/过期。
+*  注意：返回**全部可读路由**（baseURL 可选），聚合层据此区分「路由存在但无
+*  baseURL=直连」与「路由已删除=未知路由」两种不同归属。
+* @param settings - the settings service (reads the llm-pi-ai namespace).
+* @returns `<route> → { baseURL? }`；命名空间不可读时返回空。
+*/
+function readPiAiProviderRoutes(settings) {
+	try {
+		const providers = (settings.describe({ redactSecrets: true }).find((descriptor) => descriptor.ns === "llm-pi-ai")?.value)?.providers;
+		const out = {};
+		for (const [route, entry] of Object.entries(providers ?? {})) {
+			if (entry === null || typeof entry !== "object") continue;
+			const baseURL = entry.baseURL;
+			out[route] = typeof baseURL === "string" && baseURL !== "" ? { baseURL } : {};
+		}
+		return out;
+	} catch {
+		return {};
+	}
+}
+/**
+* 构造「cwd → 工作区标题」解析器（host 的 `workspaceRegistry` 为可选依赖）。
+* 匹配与 TokenLedger 同口径：会话 cwd 等于某工作区 path、或位于其子目录时，用
+* 工作区标题命名该项目（子目录的会话也计入）；否则返回 undefined（回退到目录名）。
+* registry 缺席/读取失败都返回 undefined，绝不抛错（可选依赖，不影响主流程）。
+* @param ctx - host context carrying the optional workspace registry.
+* @returns 标题解析函数；registry 不可用时 undefined。
+*/
+function buildWorkspaceTitleResolver(ctx) {
+	let registry;
+	try {
+		registry = ctx.get("workspaceRegistry");
+	} catch {
+		return;
+	}
+	if (registry === void 0 || typeof registry.list !== "function") return void 0;
+	const reg = registry;
+	return (cwd) => {
+		if (cwd === "") return void 0;
+		try {
+			const records = reg.list() ?? [];
+			const exact = records.find((record) => record.path === cwd);
+			if (exact !== void 0) return exact.title;
+			for (const record of records) if (record.path !== "" && cwd.startsWith(`${record.path}/`)) return record.title;
+			return;
+		} catch {
+			return;
+		}
+	};
+}
 /**
 * 解析订阅适配器需要的 API Key：从 llm-pi-ai 设置的 `providers.<id>.apiKeyEnv`
 * 读引用（如 kimi-coding → KIMI_CODING_API_KEY），再经凭据 seam 解析成实际值。
@@ -2941,7 +3340,12 @@ async function resolveSubscriptionKeys(settings, credentials) {
 */
 function apply(ctx, config = {}) {
 	let usageSettingsScope;
-	const aggregator = createUsageAggregator(ctx.sessionPersistence, { ...config.subscriptionProviders === void 0 ? {} : { subscriptionProviders: config.subscriptionProviders } });
+	const workspaceTitleResolver = buildWorkspaceTitleResolver(ctx);
+	const aggregator = createUsageAggregator(ctx.sessionPersistence, {
+		...config.subscriptionProviders === void 0 ? {} : { subscriptionProviders: config.subscriptionProviders },
+		resolveRoutes: () => readPiAiProviderRoutes(ctx.settings),
+		...workspaceTitleResolver === void 0 ? {} : { resolveWorkspaceTitle: workspaceTitleResolver }
+	});
 	const cwd = process.cwd();
 	const snapshotPath = join(homedir(), ".dsh/.dsh-usage-stats.json");
 	const candidates = [
@@ -3225,6 +3629,36 @@ function apply(ctx, config = {}) {
 			res.end(JSON.stringify({ quotas: quotaCache.quotas }));
 		}
 	}), "usage-billing: subscriptions route");
+	let relayCache = {
+		at: 0,
+		quotas: []
+	};
+	const refreshRelay = async () => {
+		const providers = await readPiAiProviders(ctx.settings);
+		const routes = [];
+		for (const [route, entry] of Object.entries(providers)) {
+			if (entry.baseURL === void 0 || entry.apiKeyEnv === void 0) continue;
+			routes.push({
+				route,
+				baseURL: entry.baseURL,
+				apiKeyEnv: entry.apiKeyEnv,
+				...entry.displayName === void 0 ? {} : { displayName: entry.displayName }
+			});
+		}
+		relayCache = {
+			at: Date.now(),
+			quotas: await queryRelayQuotas(ctx, routes)
+		};
+	};
+	ctx.effect(() => ctx.webServer.register({
+		kind: "exact",
+		path: "/api/billing/relay-quotas",
+		handler: async (_req, res) => {
+			res.writeHead(200, { "content-type": "application/json; charset=utf-8" });
+			if (Date.now() - relayCache.at >= SUBSCRIPTION_CACHE_MS) await refreshRelay();
+			res.end(JSON.stringify({ quotas: relayCache.quotas }));
+		}
+	}), "usage-billing: relay-quotas route");
 	ctx.effect(() => ctx.webServer.register({
 		kind: "exact",
 		path: "/api/billing/usage-stats",
@@ -3261,4 +3695,4 @@ function apply(ctx, config = {}) {
 	}), "usage-billing: usage-stats route");
 }
 //#endregion
-export { apply, inject, resolveSubscriptionKeys };
+export { apply, inject, readPiAiProviderRoutes, resolveSubscriptionKeys };