dsh-subusage 0.11.0 → 0.11.2

package/lib/client.js

@@ -122,13 +122,24 @@ window.__ModuleLoader__.load({
 			pillCookieSoon: "Cookie {rest}后到期",
 			mimoCookieExpiresAt: "{time} 到期",
 			noUsageData: "暂无额度数据",
+			statusPaygo: "可按量续用",
+			statusPaygoSub: "已购余额或计费接口支持按量续用；实际请求与余额仍以服务端为准",
+			statusIncludedAdvice: "基础额度已用尽，接口仍允许订阅续用",
+			statusAvailabilityUnknown: "续用条件待确认",
+			statusRestricted: "账户或预算已受限",
+			statusScopeLimited: "部分能力额度已用尽",
+			statusPoolAvailable: "轮换池仍有可用账户", statusPoolAvailableShort: "池可用", scopeAllShort: "共享额度",
+			statusPoolUnknown: "轮换池可用性待确认",
+			budgetKey: "Key 预算", budgetUser: "用户预算", budgetTeam: "团队预算", budgetScope: "上级预算",
+			noteLabel: "说明", creditStatusLabel: "Credits 状态", statusUnlimited: "已报告的套餐窗口不设限",
+			statusPaygoShort: "按量续用", statusIncludedShort: "仍可续用", statusUnknownShort: "续用待确认", statusScopeShort: "部分能力用尽", statusRestrictedShort: "已受限",
 			providerUnavailable: "用量暂不可用",
 			pillNeedCommandcode: "需配置 —— 可在 设置 → Command Code 登录、运行 cmd login，或导出 COMMANDCODE_API_KEY 后重试。",
 			pillNeedGrok: "需登录 —— 可在 设置 → Grok Kit（xAI OAuth）登录或运行 grok login（共享登录文件 ~/.grok/auth.json）。",
 			accountLabel: "账户",
 			commandcodeManaged: "凭据由 Command Code 提供方插件（设置 → Command Code）管理；本页只读、不保存凭据。用量由本插件直接拉取其计费接口，取用同一凭据来源（凭据服务 COMMANDCODE_API_KEY → 启动环境 → ~/.commandcode/auth.json）。",
 			commandcodeHelp: "并行读取 /alpha/billing/credits 和 /alpha/billing/subscriptions（默认 API 地址 https://api.commandcode.ai）。月总额按已知套餐快照推算，未知套餐只显示月剩余；月池耗尽不代表已购/赠送池不可用。显示选中账户的额度（未选择时为默认账户/顶层 Key），可能与实际服务账户不同；插件里自定义 apiBase 不会被跟随。账户切换就在下方「Command Code 账户」区，与药丸弹层同一开关；模型查询额度工具时会同时给出全部账户的余量与当前激活项。",
-			grokManaged: "凭据由 dsh-grok-kit / Grok CLI 的 OAuth 登录文件（~/.grok/auth.json）管理；本页只读、不保存凭据、不刷新 token。用量由本插件取同一凭据直连 Grok CLI 计费代理（cli-chat-proxy.grok.com）拉取。",
+			grokManaged: "凭据由 dsh-grok-kit / Grok CLI 的 OAuth 登录文件（~/.grok/auth.json）管理；本页不保存凭据，平时只读该文件。access token 过期时，本插件借 dsh-grok-kit 的官方登录链自动续约（同一文件、同一把写锁，不会顶掉它的登录态）；未安装 dsh-grok-kit 或续约失败时才提示手动重新登录。用量由本插件取同一凭据直连 Grok CLI 计费代理（cli-chat-proxy.grok.com）拉取。",
 			grokHelp: "并行读取 /v1/billing?format=credits 与 /v1/settings。creditUsagePercent 是统一用量池的已用百分比（通常为周池，重置于 currentPeriod.end，剩余 = 100 − 已用）；套餐名取 subscription_tier_display；已购加量余额 prepaidBalance 以美元显示。API Key（XAI_API_KEY）路线取不到订阅周池，必须 OAuth 登录。",
 			ccAccountsTitle: "Command Code 账户",
 			ccAccountAuto: "自动轮换",
@@ -139,7 +150,29 @@ window.__ModuleLoader__.load({
 			ccUsageAccount: "上方用量：{account}",
 			ccUsageAutoNote: "自动轮换时上方用量仍是默认账户（顶层 Key），不跟随实际服务账户",
 			ccSwitching: "切换中…",
-			ccSwitchFailed: "切换失败"
+			ccSwitchFailed: "切换失败",
+			// Command Code 自动轮换池健康度（其余账户用量由 Host 并行读取，各自缓存 60 秒）。
+			ccPoolTitle: "轮换账户池",
+			ccPoolAllHealthy: "{n} 个账户均可轮换使用",
+			ccPoolCapacity: "{available}/{total} 个账户可用，{blocked} 个已达限额",
+			ccPoolUnusable: "{unusable} 个账户无可用凭据或暂时读不到",
+			ccPoolExhausted: "轮换账户均已达限额，新请求很可能被拒绝",
+			ccPoolExhaustedShort: "池已满限额",
+			ccPoolClickToPin: "点击可固定到此账户",
+			// Host 失败原因按 errorCode 本地化（Host message 为中文兜底，原文保留在节点 title 供排障）。
+			errNetwork: "网络请求失败或超时，请稍后重试",
+			errHttp: "服务暂时不可用，请稍后重试",
+			errRateLimit: "请求过于频繁，已按服务端要求退避，请稍后再试",
+			errAuth: "登录或凭据已失效，请检查或重新配置",
+			errCredentials: "凭据无法解析，请检查凭据来源",
+			errIdentityTimeout: "凭据解析超时，请稍后重试",
+			errResponse: "用量响应无法解析（上游接口可能已变更）",
+			errConfig: "本机订阅设置无法读取或保存",
+			errRevisionConflict: "设置已被其他窗口修改，请重新读取后再保存",
+			errConfigChanged: "读取期间配置已改变，请刷新",
+			errUnknownProvider: "本机运行中的 Host 版本较旧，不认识该提供商；重启 DSH 后生效",
+			errTimeout: "查询超时，请稍后重试或减少查询家数",
+			errDisposed: "服务已卸载"
 		};
 		const en = {
 			nav: "Subscription usage",
@@ -244,13 +277,24 @@ window.__ModuleLoader__.load({
 			pillCookieSoon: "Cookie expires in {rest}",
 			mimoCookieExpiresAt: "Expires {time}",
 			noUsageData: "No quota data",
+			statusPaygo: "Paid usage available",
+			statusPaygoSub: "Purchased balance or billing advice permits paid usage; the server and actual balance remain authoritative",
+			statusIncludedAdvice: "Base quota used up; subscription usage still advised",
+			statusAvailabilityUnknown: "Continuation conditions not confirmed",
+			statusRestricted: "Account or budget restricted",
+			statusScopeLimited: "Some capability quotas used up",
+			statusPoolAvailable: "Rotation pool still has usable accounts", statusPoolAvailableShort: "pool usable", scopeAllShort: "shared quota",
+			statusPoolUnknown: "Rotation pool availability not confirmed",
+			budgetKey: "Key budget", budgetUser: "User budget", budgetTeam: "Team budget", budgetScope: "Parent budget",
+			noteLabel: "Note", creditStatusLabel: "Credits status", statusUnlimited: "Reported plan windows are unlimited",
+			statusPaygoShort: "paid usage", statusIncludedShort: "usage advised", statusUnknownShort: "check continuation", statusScopeShort: "some quotas used up", statusRestrictedShort: "restricted",
 			providerUnavailable: "Usage unavailable",
 			pillNeedCommandcode: "Setup required — sign in under Settings → Command Code, run cmd login, or export COMMANDCODE_API_KEY and retry.",
 			pillNeedGrok: "Login required — sign in under Settings → Grok Kit (xAI OAuth) or run grok login (shared login file ~/.grok/auth.json).",
 			accountLabel: "Account",
 			commandcodeManaged: "Credentials are managed by the Command Code provider plugin (Settings → Command Code); this page is read-only and stores nothing. Usage is fetched directly by this plugin from its billing endpoint, using the same credential sources (credential service COMMANDCODE_API_KEY → launch environment → ~/.commandcode/auth.json).",
 			commandcodeHelp: "Parallel requests to /alpha/billing/credits and /alpha/billing/subscriptions (default API base https://api.commandcode.ai). Monthly totals use a known-plan snapshot; unknown plans show remaining credits only. Monthly-pool depletion does not imply purchased/free credits are unusable. Shows the selected account's quota (the default/top-level key account when none is selected), which may differ from the serving account; a custom apiBase in the provider plugin is not followed. Account switching lives in the “Command Code accounts” block below — the same switch as the pill popover; the quota tool reports every account plus which one is active.",
-			grokManaged: "Credentials are the OAuth login file shared by dsh-grok-kit / Grok CLI (~/.grok/auth.json); this page is read-only — it stores nothing and never refreshes the token. Usage is fetched directly by this plugin from the Grok CLI billing proxy (cli-chat-proxy.grok.com) with the same credential.",
+			grokManaged: "Credentials are the OAuth login file shared by dsh-grok-kit / Grok CLI (~/.grok/auth.json); this page stores nothing and only reads the file. When the access token expires, this plugin renews it through dsh-grok-kit's (≥0.2.0) official sign-in chain — same file, same write lock, so the shared login cannot be invalidated by this renewal; it only asks for a manual re-login when dsh-grok-kit is absent or renewal fails. Usage is fetched directly from the Grok CLI billing proxy (cli-chat-proxy.grok.com) with the same credential.",
 			grokHelp: "Parallel requests to /v1/billing?format=credits and /v1/settings. creditUsagePercent is the USED percentage of the unified usage pool (usually weekly, resetting at currentPeriod.end; remaining = 100 − used). The plan name comes from subscription_tier_display; the purchased top-up balance prepaidBalance is shown in USD. An API key (XAI_API_KEY) cannot read the subscription pool — OAuth sign-in is required.",
 			ccAccountsTitle: "Command Code accounts",
 			ccAccountAuto: "Automatic (rotation order)",
@@ -261,7 +305,29 @@ window.__ModuleLoader__.load({
 			ccUsageAccount: "Usage above: {account}",
 			ccUsageAutoNote: "with automatic rotation the usage above stays on the default (top-level key) account, not the serving one",
 			ccSwitching: "Switching…",
-			ccSwitchFailed: "Switch failed"
+			ccSwitchFailed: "Switch failed",
+			// Command Code rotation-pool health (the Host reads the other accounts in parallel, each cached 60s).
+			ccPoolTitle: "Rotation account pool",
+			ccPoolAllHealthy: "All {n} accounts are available",
+			ccPoolCapacity: "{available}/{total} accounts available, {blocked} at their limit",
+			ccPoolUnusable: "{unusable} account(s) have no usable credentials or could not be read",
+			ccPoolExhausted: "Every rotation account is at its limit; new requests are likely to be rejected",
+			ccPoolExhaustedShort: "pool at limit",
+			ccPoolClickToPin: "Click to pin to this account",
+			// Host failure reasons localized by errorCode (the Host message stays Chinese; the raw text remains in node title for debugging).
+			errNetwork: "Network request failed or timed out; retry shortly",
+			errHttp: "The service is temporarily unavailable; retry shortly",
+			errRateLimit: "Rate limited; backing off as the server asked, retry shortly",
+			errAuth: "Sign-in or credentials were rejected; check or re-enter them",
+			errCredentials: "Credentials could not be resolved; check the credential source",
+			errIdentityTimeout: "Credential resolution timed out; retry shortly",
+			errResponse: "The usage response could not be parsed (the upstream API may have changed)",
+			errConfig: "The local subscription settings could not be read or saved",
+			errRevisionConflict: "Settings were changed in another window; reload before saving",
+			errConfigChanged: "Settings changed during the read; refresh",
+			errUnknownProvider: "The running Host is older and does not know this provider; restart DSH to take effect",
+			errTimeout: "The query timed out; retry shortly or query fewer providers",
+			errDisposed: "The service has been unloaded"
 		};
 		const NS = "settings.subusage";
 		const KIND_LABEL = { "5h": "w5h", "7d": "w7d", day: "wday", week: "wweek", month: "wmonth", period: "wperiod", sub: "wsub", rolling: "wrolling" };
@@ -282,7 +348,6 @@ window.__ModuleLoader__.load({
 			// SuperGrok / X Premium 订阅（dsh-grok-kit 的 xai-oauth 路由）：OAuth 登录文件凭据，无继承变量。
 			"xai-oauth": { label: "SuperGrok", short: "SuperGrok", envName: "", managedByPlugin: true },
 			// Codex / ChatGPT 订阅：凭据是 Codex CLI 的 OAuth 登录文件，只读、不刷新、不接受本地 Key。
-			// 默认开启：它对齐的是 DSH 内置的 openai-codex 路由，没登录时会被「默认隐藏」自动收起。
 			// 默认关闭：Codex 的提供方插件自带用量药丸，两个并排只是重复信息（仍可手动开启）。
 			"openai-codex": { label: "Codex (ChatGPT)", short: "Codex", envName: "", managedByPlugin: true, defaultEnabled: false },
 			// 国际版默认关闭，中国版保持默认开启。
@@ -319,7 +384,7 @@ window.__ModuleLoader__.load({
 		};
 		// 顺序只影响展示：DeepSeek 放在末尾以免打乱既有条目位置；药丸匹配靠 provider id，与顺序无关。
 		const PROVIDER_ORDER = ["zai-coding-cn", "kimi-coding", "xiaomi-token-plan-cn", "opencode-go", "commandcode", "openai-codex", "xai-oauth", "minimax", "minimax-cn", "zai-coding", "synthetic", "nanogpt", "siliconflow", "deepseek", "openrouter", "novita", "hyperbolic", "deepinfra", "chutes", "ollama-cloud", "vercel-ai-gateway", "zenmux", "litellm", "arkcli-agent-plan", "arkcli-coding-plan", "arkcli-agent-plan-team", "arkcli-coding-plan-team"];
-		// 火山方舟的 7 条路由共用同一组 IAM AK/SK，而一般用户只持有一个套餐，所以设置页只给一张卡片、
+		// 火山方舟的 4 条路由共用同一组 IAM AK/SK，而一般用户只持有一个套餐，所以设置页只给一张卡片、
 		// 一个开关（组开关落在 Host 的 visibility.ark 上）。这些 id 不能真正合并——药丸靠 provider id 匹配路由。
 		const ARK_IDS = PROVIDER_ORDER.filter(id => PROVIDER_META[id]?.volc);
 		/**
@@ -349,7 +414,7 @@ window.__ModuleLoader__.load({
 			if (settings?.visibility?.hideWithoutApi === false) return true;
 			// 火山方舟**不按推理路由收起**：额度是账号级订阅，路由装没装与额度无关——一组 IAM AK/SK 就能
 			// 查到名下所有套餐（GetCodingPlanUsage 与 GetAFPUsage 同协议同凭据）。但它**要按接口回报的
-			// 订阅状态收起**：7 条路由一律列出来，用户根本分不清哪个是哪个，而其中多数是「未检测到该套餐订阅」。
+			// 订阅状态收起**：4 条路由一律列出来，用户根本分不清哪个是哪个，而其中多数是「未检测到该套餐订阅」。
 			// `subscribed === undefined` 表示还没拉到数据，按「未知」放行——不能因为一次没拉到就把有订阅的藏起来。
 			if (PROVIDER_META[id]?.volc) {
 				if (entry?.subscribed === false) return false;
@@ -403,12 +468,12 @@ window.__ModuleLoader__.load({
 		}
 		/** extras 标签：plan / account / balance 三类，未知类型回退为余额。 */
 		function extraLabel(x, t) {
-			return x.kind === "plan" ? t("planLabel") : x.kind === "account" ? t("accountLabel") : x.kind === "monthly-balance" ? t("monthlyBalanceLabel") : x.kind === "spend" ? t("spendLabel") : t("balanceLabel");
+			return x.kind === "plan" ? t("planLabel") : x.kind === "account" ? t("accountLabel") : x.kind === "monthly-balance" ? t("monthlyBalanceLabel") : ["note", "quota-status"].includes(x.kind) ? t("noteLabel") : x.kind === "credit-status" ? t("creditStatusLabel") : x.kind === "spend" || x.kind.endsWith("-spend") ? t("spendLabel") : t("balanceLabel");
 		}
 		/** 余额兜底文案：没有额度窗口但接口报告了余额时（余额型 provider、或额度接口暂时只给余额），余额就是唯一信息。 */
 		function balanceText(entry, t) {
-			const row = entry && Array.isArray(entry.extras) ? entry.extras.find(x => x.kind === "balance") : undefined;
-			return row ? `${t("balanceLabel")} ${row.value}` : null;
+			const row = entry && Array.isArray(entry.extras) ? entry.extras.find(x => x.kind === "balance") ?? entry.extras.find(x => x.kind === "spend") : undefined;
+			return row ? `${extraLabel(row, t)} ${row.value}` : null;
 		}
 		/** 时长紧凑文案：窗口重置倒计时与 Cookie 剩余有效期共用同一档位。 */
 		function durationText(ms, t) {
@@ -467,8 +532,11 @@ window.__ModuleLoader__.load({
 			if (!value || typeof value !== "object") throw new Error("Invalid dsh-subusage settings");
 			if (value.visibility !== undefined) {
 				const v = value.visibility;
-				if (!v || typeof v !== "object" || Array.isArray(v) || Object.keys(value).some(k => !["visibility", "expectedRevision"].includes(k)) || typeof value.expectedRevision !== "string" || !value.expectedRevision || !Object.keys(v).length || Object.keys(v).some(k => !["providers", "hideWithoutApi"].includes(k))) throw new Error("Invalid visibility patch");
+				// 白名单必须与 Host 的 parseSettings 逐字对齐：火山组开关走 visibility.ark（Host 合法字段），
+				// 漏掉它会让两端 schema 漂移（当前网关出站不校验，但任何复用本 parser 的出站校验都会致障）。
+				if (!v || typeof v !== "object" || Array.isArray(v) || Object.keys(value).some(k => !["visibility", "expectedRevision"].includes(k)) || typeof value.expectedRevision !== "string" || !value.expectedRevision || !Object.keys(v).length || Object.keys(v).some(k => !["providers", "hideWithoutApi", "ark"].includes(k))) throw new Error("Invalid visibility patch");
 				if (v.hideWithoutApi !== undefined && typeof v.hideWithoutApi !== "boolean") throw new Error("Invalid auto-hide switch");
+				if (v.ark !== undefined && typeof v.ark !== "boolean") throw new Error("Invalid Ark group switch");
 				if (v.providers !== undefined && (!v.providers || typeof v.providers !== "object" || Array.isArray(v.providers) || !Object.keys(v.providers).length || Object.entries(v.providers).some(([id, enabled]) => !PROVIDER_ORDER.includes(id) || typeof enabled !== "boolean"))) throw new Error("Invalid provider switches");
 			}
 			return value;
@@ -614,6 +682,31 @@ window.__ModuleLoader__.load({
 			if (entry.coverage === "partial") return t("statusPartial");
 			return t("statusOk");
 		}
+		/**
+		 * Host 的 failure message 是中文兜底（含错误特有的排障细节），英文界面直接渲染会中英混杂。
+		 * 按稳定的 errorCode 出当前语言文案；认不出的 code 或传输层错误（无 code）保留原文——
+		 * 原文可能携带只有它才有的信息（如 HTTP 状态、火山 Action 名），调用方把它放进节点 title。
+		 */
+		const ERROR_TEXT_KEY = {
+			"subusage/network": "errNetwork",
+			"subusage/http": "errHttp",
+			"subusage/rate-limit": "errRateLimit",
+			"subusage/auth": "errAuth",
+			"subusage/credentials": "errCredentials",
+			"subusage/identity-timeout": "errIdentityTimeout",
+			"subusage/response": "errResponse",
+			"subusage/config": "errConfig",
+			"subusage/revision-conflict": "errRevisionConflict",
+			"subusage/config-changed": "errConfigChanged",
+			"subusage/unknown-provider": "errUnknownProvider",
+			"subusage/timeout": "errTimeout",
+			"subusage/disposed": "errDisposed"
+		};
+		function localError(errorCode, raw, t) {
+			const key = typeof errorCode === "string" ? ERROR_TEXT_KEY[errorCode] : undefined;
+			if (key) return t(key);
+			return typeof raw === "string" && raw ? raw : t("statusError");
+		}
 		/**
 		 * 需要用户行动时的内联入口类型。设置页的「状态」在上（用量面板）、「操作」在下（提供商管理），
 		 * 出问题时用户得先去下面找到对应厂商才能修——这里让问题旁边直接出现修复动作。
@@ -639,13 +732,11 @@ window.__ModuleLoader__.load({
 		 */
 		function usageAttentionRank(entry, t) {
 			if (!entry) return 0;
-			if (entry.state === "error") return 3;
-			const expiry = cookieExpiry(entry, t);
-			if (expiry && expiry.expired) return 3;
-			if ((entry.windows || []).some(w => w.status === "rate-limited")) return 2;
-			if (expiry && expiry.rank >= 2) return 2;
-			if (entry.freshness === "stale" || entry.coverage === "partial") return 1;
-			return 0;
+			const status = computeStatus(entry, { providerId: entry.providerId, t, getLocale: () => undefined });
+			if (status.key === "error" || status.key === "cookie" && status.expiry?.expired) return 3;
+			if (["blocked", "restricted", "cookie"].includes(status.key)) return 2;
+			if (["paygo", "included", "unknown", "scope", "pool-unknown", "degraded"].includes(status.key)) return 1;
+			return status.key === "pool" && (entry.accountPool.blockedCount || entry.accountPool.unusableCount) ? 1 : 0;
 		}
 		function providerDescription(entry, t) {
 			const windows = canShowUsage(entry) ? entry.windows || [] : [];
@@ -690,7 +781,14 @@ window.__ModuleLoader__.load({
 			};
 			const refresh = (ids, force = false) => {
 				if (disposed) return Promise.reject(new Error("Client 已卸载"));
-				const unique = [...new Set(ids)].filter((id) => PROVIDER_ORDER.includes(id) && providerEnabled(snapshot.settings, id) && providerRoutable(snapshot, id));
+				// Ark 必须豁免路由检查：它的额度是账号级管控面订阅（一组 AK/SK 查名下全部套餐），
+				// providerVisible 对 volc 同样不看推理路由——这里若按 providerRoutable 过滤，
+				// 「有套餐但本机没装对应 arkcli 路由」的条目在激活刷新、重置到期补拉与定时刷新时
+				// 全部静默不发请求，用户点「刷新当前」也空转，只有「刷新全部」走 read 才能更新。
+				const unique = [...new Set(ids)].filter((id) => {
+					if (!PROVIDER_ORDER.includes(id) || !providerEnabled(snapshot.settings, id)) return false;
+					return PROVIDER_META[id]?.volc ? true : providerRoutable(snapshot, id);
+				});
 				const start = (id) => {
 					if (inflight.has(id)) return inflight.get(id);
 					const startedEpoch = epoch, request = markRequest([id]);
@@ -785,12 +883,6 @@ window.__ModuleLoader__.load({
 			};
 		}
 
-		// ── 用量药丸（匹配当前选中模型的 provider）──────────────────────────────
-		function severity(percent, status) {
-			if (status === "rate-limited" || percent >= 100) return "limited";
-			return percent >= 80 ? "high" : void 0;
-		}
-
 		// ── Command Code 账户切换（对齐提供方插件的账户显示）────────────────────
 		// 账户列表与 id 规则对齐 @mars-sea/dsh-commandcode-provider 的 slots()：
 		// 默认账户 id 固定 "default"；额外账户 id 取其 apiKeyEnv（凭据引用名）。
@@ -948,6 +1040,53 @@ window.__ModuleLoader__.load({
 			);
 		}
 
+		/**
+		 * Command Code 自动轮换池健康摘要（弹层与设置页共用）：
+		 * 数据来自 Host 挂在 commandcode entry 上的 accountPool（auto 模式才有）。
+		 * 不简单取「最差账户」染红——账户间是独立配额，单个限额轮换器会避开它；
+		 * 只有全部有凭据账户都限额（exhausted）才是真的要 429。点账户行可固定到它。
+		 */
+		function CommandCodePoolSummary({ pool, cc, t }) {
+			if (!pool || pool.mode !== "auto" || !Array.isArray(pool.accounts) || pool.total <= 1) return null;
+			const summary = pool.exhausted
+				? t("ccPoolExhausted")
+				: pool.blockedCount > 0 || pool.unusableCount > 0
+					? t("ccPoolCapacity").replace("{available}", pool.available).replace("{total}", pool.total).replace("{blocked}", pool.blockedCount)
+					: t("ccPoolAllHealthy").replace("{n}", pool.total);
+			const tone = pool.exhausted ? "#ef4444" : pool.blockedCount > 0 || pool.unusableCount > 0 ? "#eab308" : "#22c55e";
+			const rowFor = (account) => {
+				const worst = worstWindow(account.windows || []);
+				const tier = account.availability === "paygo" ? { color: "#eab308", icon: "ℹ" } : account.usable || account.blocked ? usageTier(worst || { percent: 0, status: "ok" }) : null;
+				const blocked = account.blocked;
+				const unusable = !account.usable && !account.blocked;
+				const dot = statusGlyph(unusable ? NEUTRAL : (tier ? tier.color : NEUTRAL), unusable ? "?" : blocked ? "✕" : (tier ? tier.icon : "?"), 14);
+				const detail = unusable
+					? (account.availability === "unknown" ? t("statusUnknownShort") : account.state === "error" ? t("statusError") : account.state === "disabled" ? t("statusDisabled") : account.state === "no-cookie" ? t("statusNoCookie") : t("statusNoKey"))
+					: blocked
+						? t("pillLimited")
+						: account.availability === "paygo" ? t("statusPaygoShort") : worst ? pillText(worst, (account.windows || []).length > 1, t)
+						: t("noUsageData");
+				const canPin = cc && account.id !== "default";
+				return h("button", {
+					key: account.id, type: "button", disabled: !canPin,
+					title: canPin ? t("ccPoolClickToPin") : undefined,
+					onClick: canPin ? () => void cc.switchTo(account.id) : undefined,
+					style: { display: "flex", alignItems: "center", gap: 6, width: "100%", textAlign: "left", marginTop: 4, padding: "3px 6px", borderRadius: 6, border: "1px solid rgba(128,128,128,.25)", background: "transparent", color: "inherit", font: "inherit", fontSize: 11, cursor: canPin ? "pointer" : "default" }
+				},
+					dot,
+					h("span", { style: { flex: 1, minWidth: 0, whiteSpace: "nowrap", overflow: "hidden", textOverflow: "ellipsis" } }, account.id === "default" ? t("ccAccountDefault") : account.label),
+					h("span", { style: { opacity: 0.75, whiteSpace: "nowrap" } }, detail));
+			};
+			return h("div", { style: { marginTop: 10, padding: "8px 10px", borderRadius: 10, border: `1px solid ${alpha(tone, ".35")}`, background: alpha(tone, ".07") } },
+				h("div", { style: { display: "flex", alignItems: "center", gap: 6, fontSize: 11.5, fontWeight: 600, color: textTone(tone) } },
+					h("span", null, t("ccPoolTitle")),
+					h("span", { style: { flex: 1 } }),
+					h("span", { style: { fontWeight: 500, opacity: 0.9 } }, `${pool.available}/${pool.total}`)),
+				h("p", { role: pool.exhausted ? "alert" : "status", style: { margin: "3px 0 0", fontSize: 11, color: textTone(tone) } }, summary),
+				pool.unusableCount > 0 ? h("p", { style: { margin: "2px 0 0", fontSize: 10.5, opacity: 0.7 } }, t("ccPoolUnusable").replace("{unusable}", pool.unusableCount)) : null,
+				h("div", { style: { marginTop: 4 } }, pool.accounts.map(rowFor)));
+		}
+
 		// ── 视觉原语：扁平 + 状态色（药丸 / 弹层 / 设置页共用同一套）────────────────
 		// 注意：下面这些都是**普通函数调用**而不是 React 组件元素——它们不用 Hook，直接内联展开，
 		// 测试里的 React 桩也能看到它们渲染出的文字。
@@ -1007,7 +1146,7 @@ window.__ModuleLoader__.load({
 			// 倒计时只用于展示，永远不能盖过官方接口的判定：凭据已被拒绝（state=error）时主文案仍是失败原因；
 			// 例外是已过期——它本身就是「请重新登录」的行动项。
 			const expiryActionable = expiring && (!(rawEntry && rawEntry.state === "error") || expiry.expired);
-			const windowName = (w) => t(KIND_LABEL[w.kind] ?? "wall");
+			const windowName = (w) => w.budgetScope ? t({ key: "budgetKey", user: "budgetUser", team: "budgetTeam", scope: "budgetScope" }[w.budgetScope] ?? "budgetScope") : t(KIND_LABEL[w.kind] ?? "wall") + (w.detail?.scope === "all" ? ` · ${t("scopeAllShort")}` : "");
 			const windowShort = (w) => multi ? `${t(KIND_SHORT[w.kind] ?? "srolling")} ` : "";
 			const windowSub = (w) => {
 				const head = t(multi ? "statusWorst" : "statusOnly").replace("{w}", windowName(w)).replace("{p}", String(windowLeft(w)));
@@ -1019,6 +1158,17 @@ window.__ModuleLoader__.load({
 			const base = { entry, windows, worst, worstTier, multi, degraded, expiry, expiring, expiryActionable, needConfig };
 			if ((!rawEntry && !failed && !failState) || state === "loading") return { ...base, key: "loading", color: NEUTRAL, icon: "…", title: t("loading"), sub: "", short: "", tinted: false };
 			if (state === "disabled") return { ...base, key: "disabled", color: NEUTRAL, icon: "–", title: t("statusDisabled"), sub: "", short: t("statusDisabled"), tinted: false };
+			const pool = rawEntry?.accountPool;
+			if (pool?.mode === "auto" && pool.available > 0) return { ...base, key: "pool", color: pool.blockedCount || pool.unusableCount ? "#eab308" : "#22c55e", icon: "✓", title: t("statusPoolAvailable"), sub: `${pool.available}/${pool.total}`, short: pool.blockedCount || pool.unusableCount ? `${pool.available}/${pool.total} ${t("statusPoolAvailableShort")}` : "", tinted: !!(pool.blockedCount || pool.unusableCount) };
+			if (pool?.mode === "auto" && !pool.exhausted && pool.accounts?.some(a => a.state === "error" || a.availability === "unknown")) return { ...base, key: "pool-unknown", color: "#eab308", icon: "?", title: t("statusPoolUnknown"), sub: "", short: t("statusPoolUnknown"), tinted: true };
+			const freshAdvice = rawEntry?.state === "ok" && rawEntry.freshness !== "stale";
+			if (freshAdvice && rawEntry.availability === "blocked" && (rawEntry.availabilityReason !== "quota-exhausted" || !worstTier || worstTier.rank < 4)) return { ...base, key: "restricted", color: "#ef4444", icon: "✕", title: t("statusRestricted"), sub: "", short: t("statusRestrictedShort"), tinted: true };
+			if (freshAdvice && (["paygo", "unknown"].includes(rawEntry.availability) || rawEntry.availability === "included" && worstTier?.rank >= 4)) {
+				const title = t(rawEntry.availability === "paygo" ? "statusPaygo" : rawEntry.availability === "included" ? "statusIncludedAdvice" : "statusAvailabilityUnknown");
+				return { ...base, key: rawEntry.availability, color: "#eab308", icon: rawEntry.availability === "unknown" ? "?" : "ℹ", title, sub: rawEntry.availability === "paygo" ? t("statusPaygoSub") : worst ? windowSub(worst) : "", short: t(rawEntry.availability === "paygo" ? "statusPaygoShort" : rawEntry.availability === "included" ? "statusIncludedShort" : "statusUnknownShort"), tinted: true };
+			}
+			const scopeLimited = worstTier?.rank >= 4 && windows.some(w => w.status !== "rate-limited" && w.detail?.scope && w.detail.scope !== "all") && windows.filter(w => w.status === "rate-limited").every(w => w.detail?.scope && w.detail.scope !== "all");
+			if (scopeLimited) return { ...base, key: "scope", color: "#eab308", icon: "⚠", title: t("statusScopeLimited"), sub: windowSub(worst), short: t("statusScopeShort"), tinted: true };
 			if (worstTier && worstTier.rank >= 4) {
 				const title = t(worst.cascade ? "statusBlocked" : "statusExhausted");
 				return { ...base, key: "blocked", color: worstTier.color, icon: "✕", title, sub: windowSub(worst), short: windowShort(worst) + t(worst.cascade ? "pillBlocked" : "pillLimited"), tinted: true };
@@ -1030,7 +1180,8 @@ window.__ModuleLoader__.load({
 				return { ...base, key: "config", color: INFO, icon: "⚙", title: t(state === "no-key" ? "statusNoKey" : "statusNoCookie"), sub: needConfig, short: t(state === "no-key" ? "needConfigShort" : "statusNoCookie"), tinted: true };
 			}
 			if (!entry) {
-				return { ...base, key: "error", color: "#ef4444", icon: "!", title: t("statusError"), sub: failed || (rawEntry && rawEntry.error) || "", short: t("statusError"), tinted: true };
+				const rawReason = failed || (rawEntry && rawEntry.error) || "";
+				return { ...base, key: "error", color: "#ef4444", icon: "!", title: t("statusError"), sub: localError(rawEntry?.errorCode, rawReason, t), rawReason, short: t("statusError"), tinted: true };
 			}
 			if (degraded) {
 				// 过期缓存即使 state=error 也要叫「缓存数据」：读取失败是原因，用户看到的是上次的数字。
@@ -1044,6 +1195,7 @@ window.__ModuleLoader__.load({
 				if (worstTier.rank === 2) return { ...base, key: "low", color: worstTier.color, icon: "⚠", title: t("statusLow"), sub, short: windowShort(worst) + t(worstTier.badge), tinted: true };
 				return { ...base, key: "ok", color: worstTier.color, icon: "✓", title: t("statusPlenty"), sub, short: "", tinted: false };
 			}
+			if (entry.extras?.some(e => e.kind === "quota-status" && e.value === "unlimited")) return { ...base, key: "unlimited", color: NEUTRAL, icon: "ℹ", title: t("statusUnlimited"), sub: "", short: t("statusUnlimited"), tinted: false };
 			// 成功但没有额度窗口：只有余额（或什么都没有）。余额就是唯一信息，不画成「充足」。
 			const balance = balanceText(entry, t);
 			return { ...base, key: "balance", color: NEUTRAL, icon: "ℹ", title: balance ?? t("noUsageData"), sub: "", short: balance ?? t("noUsageData"), tinted: false };
@@ -1098,7 +1250,7 @@ window.__ModuleLoader__.load({
 				style: { marginTop: 8, padding: "10px 12px", borderRadius: 10, background: blocked ? alpha(tier.color, ".09") : "rgba(128,128,128,.07)" }
 			},
 				h("div", { style: { display: "flex", alignItems: "center", gap: 8 } },
-					h("span", { style: { fontSize: 12.5, fontWeight: 600 } }, t(KIND_LABEL[w.kind] ?? "wall")),
+					h("span", { style: { fontSize: 12.5, fontWeight: 600 } }, w.budgetScope ? t({ key: "budgetKey", user: "budgetUser", team: "budgetTeam", scope: "budgetScope" }[w.budgetScope] ?? "budgetScope") : t(KIND_LABEL[w.kind] ?? "wall") + (w.detail?.scope === "all" ? ` · ${t("scopeAllShort")}` : "")),
 					alert ? statusChip(t(tier.badge), tier.color) : null,
 					h("span", { style: { flex: 1 } }),
 					h("strong", { style: { fontSize: 18, lineHeight: 1.1, color: alert ? textTone(tier.color) : "inherit", whiteSpace: "nowrap" } }, `${left}%`),
@@ -1119,7 +1271,7 @@ window.__ModuleLoader__.load({
 		 * 弹层与设置页共用，避免只有其中一处带分组。
 		 */
 		function UsageWindowList({ windows, t, getLocale, uncertain = false }) {
-			return (windows || []).map((w, index) => h(react.Fragment, { key: w.kind },
+			return (windows || []).map((w, index) => h(react.Fragment, { key: `${w.budgetScope ?? w.kind}:${index}` },
 				w.groupLabel && w.groupLabel !== windows[index - 1]?.groupLabel
 					? h("p", { role: "note", style: { margin: index ? "14px 0 0" : "6px 0 0", fontSize: 11, opacity: 0.6 } }, w.groupLabel)
 					: null,
@@ -1206,8 +1358,14 @@ window.__ModuleLoader__.load({
 			}, [open]);
 			const rawEntry = snapshot && snapshot.entry;
 			if (rawEntry?.visible === false || rawEntry?.state === "disabled") return null;
+			// Command Code 自动轮换：默认账户健康不代表池健康。所有有凭据账户都限额（exhausted）
+			// 时，用池里一条 rate-limited 窗口喂给 computeStatus，让药丸/横幅如实染红；部分受限不染红
+			// （轮换器会避开该账户），只在弹层池摘要里提示容量降级。
+			const pool = providerId === "commandcode" ? (rawEntry?.accountPool ?? null) : null;
+			const exhaustedWindow = pool?.exhausted ? (pool.accounts.flatMap(a => a.windows || []).find(w => w.status === "rate-limited") ?? null) : null;
+			const statusEntry = exhaustedWindow ? { ...rawEntry, state: "ok", coverage: "complete", freshness: "fresh", windows: [exhaustedWindow] } : rawEntry;
 			// 整体状态由 computeStatus 一处判定：药丸、弹层横幅、设置页横幅读的是同一个结论。
-			const st = computeStatus(rawEntry, { failed, failState, providerId, t, getLocale });
+			const st = computeStatus(statusEntry, { failed, failState, providerId, t, getLocale });
 			const { entry, windows, worst, degraded, expiry, expiring } = st;
 			const summary = worst ? pillText(worst, windows.length > 1, t) : entry ? (balanceText(entry, t) ?? t("noUsageData")) : t("providerUnavailable");
 			// 药丸只回答「订阅现在怎么样」：状态图形 + 至多一个词。正常时只剩彩色余量条——
@@ -1252,7 +1410,7 @@ window.__ModuleLoader__.load({
 						planName(entry) ? h("span", { style: { fontSize: 11, fontWeight: 600, padding: "1px 8px", borderRadius: 999, background: "rgba(128,128,128,.16)", whiteSpace: "nowrap" } }, planName(entry)) : null),
 					// 状态横幅：先给结论（充足 / 偏少 / 即将用尽 / 已用尽 / 需配置 / 失败…）与一行依据。
 					statusBanner(st),
-					failed && st.key !== "error" && !st.needConfig ? h("p", { style: { color: "#f87171", margin: "8px 0 0", whiteSpace: "pre-wrap" } }, failed) : null,
+					failed && st.key !== "error" && !st.needConfig ? h("p", { role: "alert", title: failed, style: { color: "#f87171", margin: "8px 0 0", whiteSpace: "pre-wrap" } }, localError(rawEntry?.errorCode, failed, t)) : null,
 					// Cookie 到期常驻弹层：即使用量正常，也让用户看见 Cookie 还剩多久（已在横幅里说明时不重复）。
 					expiry && st.key !== "cookie" ? h("p", { role: "status", style: { margin: "8px 0 0", fontSize: 11, color: expiring ? textTone(expiry.color) : "inherit", opacity: expiring ? 1 : 0.75 } }, `${expiry.label} · ${t("mimoCookieExpiresAt").replace("{time}", new Date(expiry.expiresAt).toLocaleString(getLocale()))}`) : null,
 					// 用量账户标注：账户区 ready 时说明上方数字属于哪个账户；自动轮换时明确不跟随实际服务账户。
@@ -1261,6 +1419,9 @@ window.__ModuleLoader__.load({
 							t("ccUsageAccount").replace("{account}", ccState.activeId === "" || ccState.activeId === "default" ? t("ccAccountDefault") : (ccState.accounts.find((a) => a.id === ccState.activeId)?.label ?? ccState.activeId)),
 							ccState.activeId === "" ? h("span", { style: { opacity: 0.85 } }, ` · ${t("ccUsageAutoNote")}`) : null)
 						: null,
+					// 自动轮换池健康度：默认账户之外的账户也可能已限额，池耗尽时药丸已染红，这里给出逐账户明细。
+					// 直接函数调用（非 React 元素），与 UsageWindowList 等视觉原语同约定，测试桩可见展开内容。
+					pool ? CommandCodePoolSummary({ pool, cc, t }) : null,
 					// 额度线切换时插一条分组标题：AFP 的日限额只覆盖视觉 / 语音模型与 Harness，与文本模型的
 					// 5 小时 / 周 / 月不是同一条线，混排会让人把两条线的配额当成一组来互相比较。
 					UsageWindowList({ windows, t, getLocale, uncertain: degraded }),
@@ -1365,14 +1526,14 @@ window.__ModuleLoader__.load({
 			const text = (cn, en) => local ? cn : en;
 			react.useEffect(() => {
 				let alive = true;
-				void usageStore.readAll().then(() => { if (alive) setLoadError(null); }).catch((error) => { if (alive) setLoadError(String(error.message || error)); });
+				void usageStore.readAll().then(() => { if (alive) setLoadError(null); }).catch((error) => { if (alive) setLoadError(localError(error.code, String(error.message || error), t)); });
 				return () => { alive = false; };
 			}, [usageStore]);
 			react.useEffect(() => {
 				let alive = true;
 				const enabled = editorOpen && providerEnabled(result.settings, tab);
 				const deactivate = enabled ? usageStore.activate(tab) : () => {};
-				void usageStore.readAll().then(() => { if (alive && enabled && providerEnabled(usageStore.getSnapshot().settings, tab)) return usageStore.refresh([tab], false); }).catch((error) => { if (alive) setLoadError(String(error.message || error)); });
+				void usageStore.readAll().then(() => { if (alive && enabled && providerEnabled(usageStore.getSnapshot().settings, tab)) return usageStore.refresh([tab], false); }).catch((error) => { if (alive) setLoadError(localError(error.code, String(error.message || error), t)); });
 				return () => { alive = false; deactivate(); };
 			}, [usageStore, tab, editorOpen, providerEnabled(result.settings, tab)]);
 			react.useEffect(() => {
@@ -1433,7 +1594,7 @@ window.__ModuleLoader__.load({
 			const refresh = async (all) => {
 				setRefreshing(true);
 				try { if (!result.settings) await usageStore.readAll(); else await usageStore.refresh(all ? PROVIDER_ORDER : usageId ? [usageId] : [], true); if (aliveRef.current) setLoadError(null); }
-				catch (error) { if (aliveRef.current) setLoadError(String(error.message || error)); }
+				catch (error) { if (aliveRef.current) setLoadError(localError(error.code, String(error.message || error), t)); }
 				finally { if (aliveRef.current) setRefreshing(false); }
 			};
 			const saveVisibility = async (visibility) => {
@@ -1448,7 +1609,7 @@ window.__ModuleLoader__.load({
 					// 新启用条目先重新探测凭据；保存成功不与接口验证混为一谈。
 					const enabled = Object.entries(visibility.providers || {}).filter(([, value]) => value).map(([id]) => id);
 					if (enabled.length) { try { await usageStore.refresh(enabled, false); } catch { if (aliveRef.current) setLoadError(text("设置已保存；用量刷新失败，可稍后重试。", "Settings saved; usage refresh failed. Retry later.")); } }
-				} catch (error) { if (aliveRef.current) setNotice({ ok: false, text: String(error.message || error) }); }
+				} catch (error) { if (aliveRef.current) setNotice({ ok: false, text: localError(error.code, String(error.message || error), t) }); }
 				finally { if (aliveRef.current) setBusy(false); }
 			};
 			const onSave = async () => {
@@ -1473,16 +1634,19 @@ window.__ModuleLoader__.load({
 						const current = verified.entries.find((e) => e.providerId === tab);
 						if (aliveRef.current) setLoadError(current && current.state === "ok" ? null : text("已保存；验证获取失败：", "Saved; validation fetch failed: ") + (current && current.error || statusText(current, t)));
 					} catch (error) { if (aliveRef.current) setLoadError(text("已保存；验证获取失败：", "Saved; validation fetch failed: ") + String(error.message || error)); }
-				} catch (error) { if (aliveRef.current) setNotice({ ok: false, text: String(error.message || error) }); }
+				} catch (error) { if (aliveRef.current) setNotice({ ok: false, text: localError(error.code, String(error.message || error), t) }); }
 				finally { if (aliveRef.current) setBusy(false); }
 			};
 			const inputStyle = { width: "100%", minWidth: 0, boxSizing: "border-box", padding: "6px 8px", borderRadius: 6, border: "1px solid rgba(128,128,128,.4)", background: "transparent", color: "inherit", font: "inherit" };
 			const btnStyle = { padding: "6px 10px", borderRadius: 6, border: "1px solid rgba(128,128,128,.35)", background: "transparent", color: "inherit", cursor: "pointer", font: "inherit" };
 			const primary = { ...btnStyle, background: "rgba(59,130,246,.12)", borderColor: "rgba(59,130,246,.65)" };
 			const entries = result.entries || [];
+			// 首次挂载时 settings 还没读到（readAll 在飞行中），providerVisible 对缺失一律「未知放行」，
+			// 会让标签栏先闪现全部默认开启的提供商；未初始化期间标签栏、空状态与计数都不渲染。
+			const initialized = !!result.settings;
 			const entry = entries.find((e) => e.providerId === tab);
 			// 待处理的排前面；组内保持登记顺序，所以顺序不会自己抖动。
-			const visibleIds = PROVIDER_ORDER
+			const visibleIds = !initialized ? [] : PROVIDER_ORDER
 				.map((id, index) => ({ id, index, rank: usageAttentionRank(entries.find(e => e.providerId === id), t) }))
 				.filter(item => providerVisible(result.settings, item.id, entries.find(e => e.providerId === item.id), result))
 				.sort((a, b) => b.rank - a.rank || a.index - b.index)
@@ -1499,7 +1663,11 @@ window.__ModuleLoader__.load({
 			const usageMeta = PROVIDER_META[usageId];
 			// 需要行动时（缺凭据/凭据被拒/Cookie 即将到期）在用量面板里内联修复入口。
 			const usageAction = usageActionKind(usageEntry, usageId, t);
-			const usageStatus = computeStatus(usageEntry, { failed: usageEntry && usageEntry.state !== "ok" ? usageEntry.error || usageEntry.state : null, failState: usageEntry && usageEntry.state, providerId: usageId, t, getLocale });
+			// Command Code 自动轮换：池耗尽时横幅按池中一条限额窗口染红（与药丸同一结论）。
+			const usagePool = usageId === "commandcode" ? (usageEntry?.accountPool ?? null) : null;
+			const usageExhaustedWindow = usagePool?.exhausted ? (usagePool.accounts.flatMap(a => a.windows || []).find(w => w.status === "rate-limited") ?? null) : null;
+			const usageStatusEntry = usageExhaustedWindow ? { ...usageEntry, state: "ok", coverage: "complete", freshness: "fresh", windows: [usageExhaustedWindow] } : usageEntry;
+			const usageStatus = computeStatus(usageStatusEntry, { failed: usageEntry && usageEntry.state !== "ok" ? usageEntry.error || usageEntry.state : null, failState: usageEntry && usageEntry.state, providerId: usageId, t, getLocale });
 			// 行动按钮把人送到对应厂商的凭据编辑器：展开管理区、打开该行、滚动过去。
 			const revealEditor = (target) => {
 				openEditor(target);
@@ -1610,7 +1778,7 @@ window.__ModuleLoader__.load({
 						h("button", { type: "button", role: "switch", "aria-checked": hideWithoutApi, disabled: busy || dirty || !result.settings?.revision, "aria-label": text("没有检测到API的默认隐藏", "Hide providers without detected API credentials"), style: hideWithoutApi ? primary : btnStyle, onClick: () => saveVisibility({ hideWithoutApi: !hideWithoutApi }) }, `${hideWithoutApi ? "✓ " : "○ "}${text("没有检测到API的默认隐藏", "Hide providers without detected API credentials")}`),
 						h("p", { style: { fontSize: 12, opacity: .75 } }, text("检测依据为可用 Key 或 MiMo Cookie 是否存在；认证失败和网络错误不会当成未配置 API。隐藏的提供商仍可在这里配置。", "Detection checks for a Key or MiMo Cookie, not request success. Auth/network errors are not treated as missing API credentials. Hidden providers remain configurable here.")),
 						// 启用的排到最前面，省得每次往下翻；组内保持 PROVIDER_ORDER 的既有顺序（sort 稳定）。
-						// Ark 的 7 条路由合并成一张卡片：只渲染本机装了的那条作代表（都没装就渲染第一条），
+						// Ark 的 4 条路由合并成一张卡片：只渲染本机装了的那条作代表（都没装就渲染第一条），
 						// 由它统一控制整组的检测开关与那组共享的 AK/SK。
 						h("div", { style: { display: "grid", gridTemplateColumns: "repeat(auto-fit, minmax(min(100%, 240px), 1fr))", gap: 8 } }, [...PROVIDER_ORDER].filter(id => !PROVIDER_META[id]?.volc || id === (ARK_IDS.find(key => providerRoutable(result, key)) ?? ARK_IDS[0])).sort((a, b) => Number(!providerEnabled(result.settings, a)) - Number(!providerEnabled(result.settings, b))).map(id => {
 							const isArk = Boolean(PROVIDER_META[id].volc), arkPresent = isArk ? ARK_IDS.filter(key => providerRoutable(result, key)) : [];
@@ -1631,20 +1799,20 @@ window.__ModuleLoader__.load({
 			return h("div", { ref: root, style: { padding: 16, maxWidth: 720, minWidth: 0, font: "13px/1.6 sans-serif", containerType: "inline-size", containerName: "subusage" } },
 				h("div", { style: { display: "flex", alignItems: "center", gap: 10, flexWrap: "wrap" } },
 					h("h2", { style: { margin: 0, fontSize: 16 } }, t("title")),
-					h("button", {
+					initialized ? h("button", {
 						type: "button",
 						disabled: !troubledIds.length,
 						onClick: () => { if (troubledIds.length) chooseUsage(troubledIds[0]); },
 						title: troubledIds.length ? text(`跳到 ${PROVIDER_META[troubledIds[0]].short}（共 ${troubledIds.length} 家待处理）`, `Jump to ${PROVIDER_META[troubledIds[0]].short} (${troubledIds.length} need attention)`) : text("全部获取成功", "All fetched"),
 						"aria-label": text(`${success}/${visibleIds.length} 家数据获取成功；${troubledIds.length ? `点击跳到 ${PROVIDER_META[troubledIds[0]].short}` : "没有待处理项"}`, `${success}/${visibleIds.length} providers fetched; ${troubledIds.length ? `click to jump to ${PROVIDER_META[troubledIds[0]].short}` : "nothing needs attention"}`),
 						style: { ...btnStyle, padding: "2px 8px", fontSize: 12, opacity: .85, cursor: troubledIds.length ? "pointer" : "default", color: troubledIds.length ? "#b7791f" : "inherit" }
-					}, text(`${success}/${visibleIds.length} 家数据获取成功`, `${success}/${visibleIds.length} providers fetched`)),
+					}, text(`${success}/${visibleIds.length} 家数据获取成功`, `${success}/${visibleIds.length} providers fetched`)) : null,
 					h("button", { type: "button", disabled: busy || refreshing || !usageId, style: { ...primary, cursor: busy || refreshing || !usageId ? "default" : "pointer" }, onClick: () => refresh(false) }, refreshing ? t("refreshing") : text("刷新当前", "Refresh current")),
 					h("button", { type: "button", disabled: busy || refreshing, style: { ...btnStyle, cursor: busy || refreshing ? "default" : "pointer" }, onClick: () => refresh(true) }, refreshing ? t("refreshing") : text("刷新全部", "Refresh all"))
 				),
 				loadError ? h("p", { role: "alert", style: { color: "#dc2626", overflowWrap: "anywhere" } }, loadError) : null,
-				!visibleIds.length ? h("p", { role: "status" }, text("没有可显示的提供商，请展开下方「提供商管理」开启、配置 API，或关闭默认隐藏。", "No visible providers. Expand Provider management below to enable a provider, configure API credentials, or turn off auto-hide.")) : null,
-				h("div", { className: "subusage-provider-tabs", role: "tablist", "aria-label": text("模型商", "Providers"), style: { display: "flex", flexWrap: "wrap", gap: 4, marginTop: 14 } },
+				initialized && !visibleIds.length ? h("p", { role: "status" }, text("没有可显示的提供商，请展开下方「提供商管理」开启、配置 API，或关闭默认隐藏。", "No visible providers. Expand Provider management below to enable a provider, configure API credentials, or turn off auto-hide.")) : null,
+				initialized ? h("div", { className: "subusage-provider-tabs", role: "tablist", "aria-label": text("模型商", "Providers"), style: { display: "flex", flexWrap: "wrap", gap: 4, marginTop: 14 } },
 					visibleIds.map((id, index) => {
 						const e = entries.find((item) => item.providerId === id), active = usageId === id;
 						// 标签圆标与面板/药丸读同一个 computeStatus：缺凭据是蓝 ⚙ 而不是红 !，
@@ -1661,7 +1829,7 @@ window.__ModuleLoader__.load({
 								const button = event.currentTarget.parentElement.querySelectorAll('[role="tab"]')[next]; if (button) button.focus();
 							}, style: { ...btnStyle, display: "inline-flex", alignItems: "center", gap: 6, minWidth: 0, padding: "5px 12px 5px 8px", whiteSpace: "nowrap", fontSize: 12, fontWeight: active ? 600 : 400, borderRadius: 999, border: "1px solid transparent", background: active ? alpha(INFO, ".16") : "transparent" }
 						}, statusGlyph(tabStatus.color, tabStatus.icon, 14), PROVIDER_META[id].short);
-					})),
+					})) : null,
 				!!usageId ? h("section", { role: "tabpanel", id: "subusage-provider-panel", "aria-label": usageMeta.label, style: { marginTop: 12, border: "1px solid rgba(128,128,128,.25)", borderRadius: 14, padding: 16 } },
 					h("div", { style: { display: "flex", alignItems: "center", gap: 8 } },
 						h("strong", { style: { fontSize: 14 } }, usageMeta.label),
@@ -1669,13 +1837,16 @@ window.__ModuleLoader__.load({
 						planName(usageEntry) ? h("span", { style: { fontSize: 11, fontWeight: 600, padding: "1px 8px", borderRadius: 999, background: "rgba(128,128,128,.16)", whiteSpace: "nowrap" } }, planName(usageEntry)) : null),
 					// 一眼结论：与药丸、弹层同一个状态判定。读取成功只说明接口健康，额度档位另有结论。
 					statusBanner(usageStatus),
-					usageEntry && usageEntry.error && usageStatus.key !== "error" ? h("p", { role: "alert", style: { color: "#dc2626", overflowWrap: "anywhere" } }, usageEntry.error) : null,
+					usageEntry && usageEntry.error && usageStatus.key !== "error" ? h("p", { role: "alert", title: usageEntry.error, style: { color: "#dc2626", overflowWrap: "anywhere" } }, localError(usageEntry.errorCode, usageEntry.error, t)) : null,
 					usageAction ? h("div", { role: "group", "aria-label": text("建议操作", "Suggested action"), style: { display: "flex", alignItems: "center", gap: 8, flexWrap: "wrap", margin: "10px 0", padding: "8px 10px", border: "1px solid rgba(234,179,8,.45)", borderRadius: 8, background: "rgba(234,179,8,.08)" } },
 						h("span", { style: { flex: 1, minWidth: 150, fontSize: 12 } }, usageAction === "mimo-relogin" ? text("Cookie 已过期，重新登录即可恢复。", "Cookie expired — sign in again to restore.") : usageAction === "mimo-login" ? text("需要登录 MiMo（或 Cookie 即将到期）。", "MiMo sign-in needed (or the cookie is about to expire).") : text("这家还没有可用的凭据。", "No usable credentials for this provider.")),
 						usageAction !== "credentials" ? h("button", { type: "button", style: primary, disabled: busy || loginActive, onClick: startLogin }, usageAction === "mimo-relogin" ? text("重新登录", "Sign in again") : text("登录并自动导入", "Sign in & import")) : null,
 						h("button", { type: "button", style: usageAction === "credentials" ? primary : btnStyle, disabled: busy, onClick: () => revealEditor(usageId) }, usageAction === "credentials" ? text("配置凭据", "Configure credentials") : text("手动填写", "Enter manually"))) : null,
+					// 自动轮换池健康度（与弹层同一函数）：池耗尽时上方横幅已按池中限额窗口染红。
+					usagePool ? CommandCodePoolSummary({ pool: usagePool, cc, t }) : null,
 					// 无窗口时的占位只给「成功但既无窗口也无余额」：余额/加载/需配置/失败等状态横幅已经说明，不再叠加「暂无额度数据」。
-					canShowUsage(usageEntry) && (usageEntry.windows || []).length ? UsageWindowList({ windows: usageEntry.windows, t, getLocale, uncertain: usageEntry.coverage === "partial" || usageEntry.freshness === "stale" || usageEntry.state !== "ok" })
+					// 窗口列表用 usageStatusEntry：池耗尽时它携带合成的限额窗口（非耗尽时与 usageEntry 同一对象）。
+					canShowUsage(usageStatusEntry) && (usageStatusEntry.windows || []).length ? UsageWindowList({ windows: usageStatusEntry.windows, t, getLocale, uncertain: usageStatusEntry.coverage === "partial" || usageStatusEntry.freshness === "stale" || usageStatusEntry.state !== "ok" })
 						: usageStatus.key === "balance" && !(usageStatus.entry && balanceText(usageStatus.entry, t)) ? h("p", { style: { opacity: .75 } }, t("noUsageData")) : null,
 					canShowUsage(usageEntry) && usageEntry.extras && usageEntry.extras.some((x) => x.kind !== "plan")
 						? h("div", { style: { marginTop: 10, padding: "6px 12px", borderRadius: 10, background: "rgba(128,128,128,.07)" } },