@mars-sea/dsh-commandcode-provider 0.11.0 → 0.11.2

package/lib/client.js

@@ -36,150 +36,6 @@ window.__ModuleLoader__.load({
 			};
 		}
 		//#endregion
-		//#region src/command-locales.ts
-		const commandcodeCommand = {
-			zh: {
-				title: "📊 Command Code 用量{account}",
-				accountTitle: "📊 {label}{badges}",
-				accountSeparator: "────────────────────",
-				activeBadge: "  ✅ 当前使用",
-				invalidCredentialBadge: "  ⛔ 密钥无效",
-				cooldownBadge: "  ⏳ 限额冷却中，重置 {when}",
-				rateLimitBadge: "  ⏳ 已达限额（等待窗口探测）",
-				unconfigured: "  (未配置 API 密钥)",
-				blockedInvalidKey: "⛔ API 密钥无效或已过期 — 服务端拒绝了全部请求（401），请检查该账户的密钥配置",
-				blockedServiceUnavailable: "⚠️ Command Code 服务暂时不可用（5xx），稍后重试",
-				blockedNetwork: "⚠️ 无法连接 Command Code 服务 — 请检查网络或 API 地址",
-				planLine: "  📦 套餐    {name}{status}{period}",
-				planPeriodSuffix: " · 账期截止 {date}",
-				usageHeader: "── 请求 ──────────────────────────────",
-				requestsLine: "  💬 请求    {n} 次 / 失败 {f}  成功率 {r}%",
-				costLine: "  💰 花费    {money}  ({credits} credits)",
-				tokensLine: "  🔤 Token   {in} 入 / {out} 出",
-				creditsHeader: "── 信用 ──────────────────────────────",
-				monthlyLine: "  💳 月额度  {monthly}   (已购 {purchased} / 赠送 {free})",
-				barLine: "     └ {bar}  {pct}%",
-				windowsHeader: "── 窗口用量 ──────────────────────────",
-				fiveHourLine: "  ⏱ 5 小时  {used} / {cap}{warn}",
-				weeklyLine: "  📅 每周    {used} / {cap}{warn}",
-				windowBarLine: "     └ {bar}  重置 {when}",
-				exceededWarning: "  ⚠️ 超限!",
-				resetSuffix: "重置 {when}",
-				partialFailures: "⚠️  部分端点失败: {list}",
-				noData: "（无数据 — 请检查 API 密钥）",
-				errorText: "获取 Command Code 用量失败：{message}",
-				imageGate: "当前会话已包含图片，而模型 {model} 不支持图片输入；请选择支持图片的模型，或先移除会话中的图片。"
-			},
-			en: {
-				title: "📊 Command Code usage{account}",
-				accountTitle: "📊 {label}{badges}",
-				accountSeparator: "────────────────────",
-				activeBadge: "  ✅ active",
-				invalidCredentialBadge: "  ⛔ invalid key",
-				cooldownBadge: "  ⏳ cooling down, resets {when}",
-				rateLimitBadge: "  ⏳ rate-limited (waiting for window probe)",
-				unconfigured: "  (no API key configured)",
-				blockedInvalidKey: "⛔ API key invalid or expired — the server rejected every request (401); check the key configured for this account",
-				blockedServiceUnavailable: "⚠️ Command Code service temporarily unavailable (5xx); try again later",
-				blockedNetwork: "⚠️ could not reach the Command Code service — check your network or the API base setting",
-				planLine: "  📦 Plan     {name}{status}{period}",
-				planPeriodSuffix: " · period ends {date}",
-				usageHeader: "── Requests ──────────────────────────",
-				requestsLine: "  💬 Requests {n} / failed {f}  success rate {r}%",
-				costLine: "  💰 Spend    {money}  ({credits} credits)",
-				tokensLine: "  🔤 Tokens   {in} in / {out} out",
-				creditsHeader: "── Credits ───────────────────────────",
-				monthlyLine: "  💳 Monthly  {monthly}   (purchased {purchased} / free {free})",
-				barLine: "     └ {bar}  {pct}%",
-				windowsHeader: "── Window usage ──────────────────────",
-				fiveHourLine: "  ⏱ 5-hour   {used} / {cap}{warn}",
-				weeklyLine: "  📅 Weekly   {used} / {cap}{warn}",
-				windowBarLine: "     └ {bar}  resets {when}",
-				exceededWarning: "  ⚠️ exceeded!",
-				resetSuffix: "resets {when}",
-				partialFailures: "⚠️  some endpoints failed: {list}",
-				noData: "(no data — check your API key)",
-				errorText: "Could not fetch Command Code usage: {message}",
-				imageGate: "This session already contains images, and model {model} does not accept image input; please select an image-capable model, or remove the images from the session first."
-			}
-		};
-		//#endregion
-		//#region src/client/sessions.ts
-		/**
-		* Friendly-error wrapper for the harness's image-session gate.
-		*
-		* The host rejects switching to a text-only model while the session already
-		* contains images with a `model-unavailable` error
-		* (`dsh-host-apiproxy`'s `session.selectModel` handler). That rejection is
-		* intentional and cannot be relaxed from the plugin side — the adapter's
-		* `inputModalities` is exactly what makes the guard work. What we CAN do is
-		* make the error message friendlier: wrap the shared
-		* `connection.api.sessions.selectModel` face so a `model-unavailable`
-		* rejection shows a clear, actionable hint (with the requested model name)
-		* instead of the raw English harness message.
-		*
-		* The wrapper is deliberately narrow: only the `model-unavailable` code is
-		* rewritten, only when the message matches the image-session gate, and only
-		* the message text changes — the error code and details pass through
-		* untouched so any caller that switches on `error.code` keeps working.
-		*
-		* The wire types are spelled structurally here (not imported from
-		* `@deepseek-ai/dsh-host-apiproxy`) so this client bundle does not drag an
-		* extra peer dependency into the package; the shapes are stable and the
-		* client build inlines them anyway.
-		*
-		* The wrapper takes a `getLocale` thunk because it is reached from a
-		* non-React path that has no `t` in scope; the supplied thunk reads the
-		* active locale at call time (typically `() => ctx.locale.getLocale().active`
-		* in the client entry), and the message template lives in the shared
-		* `commandcodeCommand` dictionary used by the Host-side `/commandcode`
-		* command — the same bilingual surface serves both.
-		*
-		* This module is deliberately free of React and other client-platform
-		* imports so the node test runner can exercise it directly.
-		*/
-		/** Whether a selectModel rejection is the harness's image-session gate. */
-		function isImageSessionRejection(result) {
-			return !result.result.ok && result.result.error.code === "model-unavailable" && result.result.error.message.includes("does not accept image input");
-		}
-		/** Wrap the shared sessions API so selectModel failures read friendlier. */
-		function withFriendlyImageError(sessions, getLocale) {
-			const selectModel = sessions.selectModel.bind(sessions);
-			return {
-				...sessions,
-				selectModel: async (payload, signal) => {
-					const result = await selectModel(payload, signal);
-					if (!isImageSessionRejection(result)) return result;
-					const model = result.result.error.details?.model ?? payload.model;
-					const template = commandcodeCommand[getLocale()].imageGate ?? commandcodeCommand.en.imageGate;
-					return {
-						...result,
-						result: {
-							...result.result,
-							error: {
-								...result.result.error,
-								message: template.replace("{model}", model)
-							}
-						}
-					};
-				}
-			};
-		}
-		/**
-		* Install the friendly-error wrapper when a legacy sessions face is present.
-		*
-		* @returns whether the wrapper was installed. The rewrite is only UX polish;
-		* a 0.1.2 connection has no `api.sessions`, and its absence must never block
-		* the plugin from mounting its settings, credential, or usage surfaces.
-		*/
-		function installFriendlyImageError(connection, getLocale) {
-			const api = connection.api;
-			const sessions = api?.sessions;
-			if (api === void 0 || sessions === void 0 || typeof sessions.selectModel !== "function") return false;
-			api.sessions = withFriendlyImageError(sessions, getLocale);
-			return true;
-		}
-		//#endregion
 		//#region src/client/settings.ts
 		/**
 		* Browser controller for the "Command Code" settings page.
@@ -303,6 +159,7 @@ window.__ModuleLoader__.load({
 			}),
 			booleanField$1("filterModelsByPlan"),
 			booleanField$1("webSearch"),
+			booleanField$1("showSidebarQuota"),
 			textField("activeAccount")
 		];
 		/** Whether two model-id lists are equal as sets (order-insensitive). */
@@ -455,6 +312,8 @@ window.__ModuleLoader__.load({
 					streamIdleTimeoutMs: this.field("streamIdleTimeoutMs"),
 					filterModelsByPlan: this.field("filterModelsByPlan"),
 					webSearch: this.field("webSearch"),
+					showSidebarQuota: this.field("showSidebarQuota"),
+					sidebarQuota: this.sectionValue("showSidebarQuota") === true,
 					activeAccount: this.field("activeAccount"),
 					accounts,
 					accountsRemoving: [...this.removedRefs],
@@ -2291,7 +2150,7 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region package.json
-		var version = "0.11.0";
+		var version = "0.11.2";
 		var repository = {
 			"type": "git",
 			"url": "git+https://github.com/Mars-Sea/dsh-commandcode-provider.git"
@@ -2491,7 +2350,8 @@ window.__ModuleLoader__.load({
 			"requestTimeoutMs",
 			"streamIdleTimeoutMs",
 			"filterModelsByPlan",
-			"webSearch"
+			"webSearch",
+			"showSidebarQuota"
 		];
 		/** One labelled field row in the page body. */
 		function Field({ id, label, hint, state, disabled, numeric, placeholder, onEdit, onReset, t }) {
@@ -2543,11 +2403,12 @@ window.__ModuleLoader__.load({
 			return t("invalidNumber");
 		}
 		/**
-		* The collapsed "Advanced" card: API base, working dir, both timeouts, and
-		* the plan filter live here so the page leads with the facts a user actually
-		* touches. Starts collapsed on every visit; expands on demand. While
-		* collapsed, a badge names the customized count so a nonzero override stays
-		* visible (a number field's error blocks save and must be reachable).
+		* The collapsed "Advanced" card: API base, working dir, both timeouts, the
+		* plan filter, the web-search backend and the sidebar quota card live here so
+		* the page leads with the facts a user actually touches. Starts collapsed on
+		* every visit; expands on demand. While collapsed, a badge names the
+		* customized count so a nonzero override stays visible (a number field's error
+		* blocks save and must be reachable).
 		*/
 		function AdvancedSection({ state, disabled, t, onEdit, onReset }) {
 			const [expanded, setExpanded] = (0, react.useState)(false);
@@ -2654,6 +2515,17 @@ window.__ModuleLoader__.load({
 								onEdit: (text) => onEdit("webSearch", text),
 								onReset: () => onReset("webSearch"),
 								t
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ToggleField, {
+								id: "cc-show-sidebar-quota",
+								label: t("showSidebarQuota"),
+								hint: t("showSidebarQuotaHint"),
+								state: state.showSidebarQuota,
+								disabled,
+								defaultChecked: false,
+								onEdit: (text) => onEdit("showSidebarQuota", text),
+								onReset: () => onReset("showSidebarQuota"),
+								t
 							})
 						]
 					}) : null,
@@ -3965,12 +3837,68 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region src/client/panel-copy.ts
-		/** The panel's literal string table. */
-		const PANEL_COPY = {
+		/** The locale namespace both panel slots bind their `t` seat to. */
+		const PANEL_LOCALE_NS = "panel.commandcode";
+		/** The panel's Simplified Chinese string table (the key-set source of truth). */
+		const PANEL_COPY_ZH = {
+			nav: "Command Code",
+			subtitle: "套餐、额度与配额窗口",
+			refresh: "刷新",
+			refreshing: "刷新中…",
+			close: "关闭",
+			closeHint: "返回会话",
+			loading: "正在获取账户用量…",
+			noKey: "尚未配置 API 密钥",
+			noKeyHint: "在 设置 → Command Code 中粘贴密钥或登录后，点击刷新。",
+			plan: "套餐",
+			credits: "额度",
+			limits: "配额窗口",
+			usage: "用量",
+			monthly: "月额度",
+			monthlyLimit: "月额度上限",
+			monthlyUsed: "本月已用",
+			remaining: "剩余",
+			purchased: "已购",
+			free: "赠送",
+			fiveHour: "5 小时窗口",
+			weekly: "每周窗口",
+			fiveHourShort: "5 小时",
+			weeklyShort: "每周",
+			windowUnlimited: "不限",
+			exceeded: "已超限",
+			exhausted: "已用尽",
+			resets: "重置于",
+			requests: "请求",
+			failed: "失败",
+			successRate: "成功率",
+			spend: "花费",
+			tokens: "Token",
+			tokensIn: "入",
+			tokensOut: "出",
+			periodEnds: "账期截止",
+			updated: "更新于",
+			partial: "部分端点数据不可用",
+			active: "当前使用",
+			coolingDown: "限额冷却中",
+			invalidKey: "密钥无效",
+			unconfigured: "未配置",
+			unavailable: "无数据",
+			errorInvalidKey: "API 密钥无效或已过期",
+			errorInvalidKeyHint: "服务端拒绝了全部请求（401）。请检查该账户的密钥，或到 commandcode.ai 控制台重新生成。",
+			errorServiceUnavailable: "Command Code 服务暂时不可用",
+			errorServiceUnavailableHint: "服务端返回错误（5xx），请稍后点击刷新重试。",
+			errorNetwork: "无法连接 Command Code 服务",
+			errorNetworkHint: "所有请求都没有到达服务端。请检查网络连接或 API 地址设置。",
+			errorGeneric: "用量获取失败"
+		};
+		/** The panel's English string table (must mirror {@link PANEL_COPY_ZH}). */
+		const PANEL_COPY_EN = {
 			nav: "Command Code",
 			subtitle: "Plans, credits and quota windows",
 			refresh: "Refresh",
 			refreshing: "Refreshing…",
+			close: "Close",
+			closeHint: "Back to the conversation",
 			loading: "Loading account usage…",
 			noKey: "No API key configured",
 			noKeyHint: "Paste a key — or sign in — under Settings → Command Code, then refresh.",
@@ -4015,9 +3943,15 @@ window.__ModuleLoader__.load({
 			errorNetworkHint: "No request reached the server. Check your network connection or the API base setting.",
 			errorGeneric: "Could not fetch account usage"
 		};
-		/** Look up one panel string. The fallback key keeps a bad call visible, never blank. */
-		function panelText(key) {
-			return PANEL_COPY[key] ?? key;
+		/** Every panel key, in the English table's declaration order. */
+		const PANEL_KEYS = Object.keys(PANEL_COPY_EN);
+		/**
+		* The English translator. Used as the fallback when no locale seat is
+		* available (a defensive path: every supported engine supplies one) and as the
+		* default in tests that only assert the projection's figures.
+		*/
+		function panelTextEN(key) {
+			return PANEL_COPY_EN[key] ?? key;
 		}
 		//#endregion
 		//#region src/client/panel.ts
@@ -4115,7 +4049,7 @@ window.__ModuleLoader__.load({
 			};
 		}
 		/** Build one account's view. */
-		function accountView(entry) {
+		function accountView(entry, t) {
 			const { report } = entry;
 			const account = report.account;
 			const plan = report.plan;
@@ -4126,7 +4060,7 @@ window.__ModuleLoader__.load({
 				stats.push({
 					label: "requests",
 					value: String(usage.completedCount),
-					sub: `${usage.failedCount} ${panelText("failed")}`
+					sub: `${usage.failedCount} ${t("failed")}`
 				});
 				stats.push({
 					label: "successRate",
@@ -4141,7 +4075,7 @@ window.__ModuleLoader__.load({
 				stats.push({
 					label: "tokens",
 					value: formatTokensCompact(usage.totalTokensIn + usage.totalTokensOut),
-					sub: `${formatTokensCompact(usage.totalTokensIn)} ${panelText("tokensIn")} / ${formatTokensCompact(usage.totalTokensOut)} ${panelText("tokensOut")}`
+					sub: `${formatTokensCompact(usage.totalTokensIn)} ${t("tokensIn")} / ${formatTokensCompact(usage.totalTokensOut)} ${t("tokensOut")}`
 				});
 			}
 			const windows = [];
@@ -4192,15 +4126,14 @@ window.__ModuleLoader__.load({
 			};
 		}
 		/**
-		* Every panel string, resolved once per projection. One object with all keys
-		* (rather than per-field lookups in the components) keeps the copy table and
-		* the render sites in lockstep: a key cannot be read from `text` unless
-		* {@link PANEL_COPY} declares it.
+		* Every panel string, resolved once per projection through the translator.
+		* One object with all keys (rather than per-field lookups in the components)
+		* keeps the copy table and the render sites in lockstep: a key cannot be read
+		* from `text` unless {@link PANEL_KEYS} declares it.
 		*/
-		function panelStrings() {
-			const keys = Object.keys(PANEL_COPY);
+		function panelStrings(t) {
 			const out = {};
-			for (const key of keys) out[key] = panelText(key);
+			for (const key of PANEL_KEYS) out[key] = t(key);
 			return out;
 		}
 		/**
@@ -4212,6 +4145,7 @@ window.__ModuleLoader__.load({
 		*/
 		function buildPanelView(input) {
 			const { usage } = input;
+			const t = input.t ?? panelTextEN;
 			const hidden = new Set(input.removingIds ?? []);
 			const seen = /* @__PURE__ */ new Set();
 			const entries = (usage.report?.accounts ?? []).filter((entry) => {
@@ -4220,7 +4154,7 @@ window.__ModuleLoader__.load({
 				seen.add(entry.id);
 				return true;
 			});
-			const accounts = entries.map(accountView);
+			const accounts = entries.map((entry) => accountView(entry, t));
 			const selectedEntry = entries.find((entry) => entry.active) ?? entries[0];
 			const selectedView = accounts.find((view) => view.id === selectedEntry?.id);
 			const footerBars = [];
@@ -4239,18 +4173,18 @@ window.__ModuleLoader__.load({
 			const totalCost = selectedEntry?.report.usage?.totalCost;
 			const cost = totalCost === void 0 ? "" : money(totalCost);
 			let status = "";
-			if (entries.length > 0 && !entries.some((entry) => entry.configured)) status = panelText("unconfigured");
-			else if (selectedView?.mark !== void 0 && selectedView.mark !== "active") status = panelText(selectedView.mark);
-			else if (selectedEntry === void 0) status = panelText("unavailable");
-			const planName = selectedView !== void 0 && selectedView.planName !== "" ? selectedView.planName : panelText("nav");
-			const titleParts = planName === panelText("nav") ? [planName] : [panelText("nav"), planName];
+			if (entries.length > 0 && !entries.some((entry) => entry.configured)) status = t("unconfigured");
+			else if (selectedView?.mark !== void 0 && selectedView.mark !== "active") status = t(selectedView.mark);
+			else if (selectedEntry === void 0) status = t("unavailable");
+			const planName = selectedView !== void 0 && selectedView.planName !== "" ? selectedView.planName : t("nav");
+			const titleParts = planName === t("nav") ? [planName] : [t("nav"), planName];
 			for (const bar of footerBars) {
 				const figures = bar.detail === "" ? "" : ` ${bar.detail}`;
-				titleParts.push(`${panelText(bar.label)}${figures} (${bar.percent})`);
+				titleParts.push(`${t(bar.label)}${figures} (${bar.percent})`);
 			}
-			if (cost !== "") titleParts.push(`${panelText("spend")} ${cost}`);
+			if (cost !== "") titleParts.push(`${t("spend")} ${cost}`);
 			return {
-				text: panelStrings(),
+				text: panelStrings(t),
 				planName,
 				status,
 				footerBars,
@@ -4336,11 +4270,11 @@ window.__ModuleLoader__.load({
 		* the sidebar footer card and the dashboard it opens in the center column.
 		*
 		* Both render one {@link PanelView} projected by `./panel.ts` — no fact is
-		* derived here. Strings arrive as keys into `view.text`, and every one of them
-		* is English, because the view is built from `./panel-copy.ts` rather than the
-		* harness `ctx.locale` namespace (which follows the user's language and would
-		* render this panel in Chinese on a Chinese harness — the thing this surface
-		* exists to avoid).
+		* derived here. Strings arrive already localized in `view.text`: the slots
+		* declare the `panel.commandcode` locale namespace, so the renderer hands this
+		* component a `t` seat that is passed into `buildPanelView` — the panel follows
+		* the harness's active language (a language switch mints a new `t`, so the
+		* surfaces re-render without an extra channel).
 		*
 		* The footer card is the panel's home: the sidebar shell renders it in the foot
 		* area directly above the Settings seat, so each quota window's own spend and
@@ -4362,7 +4296,8 @@ window.__ModuleLoader__.load({
 			return buildPanelView({
 				usage,
 				apiKeyConfigured: settings.anyAccountConfigured,
-				removingIds: settings.accountsRemoving
+				removingIds: settings.accountsRemoving,
+				t: props.t ?? panelTextEN
 			});
 		}
 		/**
@@ -4688,6 +4623,18 @@ window.__ModuleLoader__.load({
 									disabled: view.loading,
 									onClick: () => props.refresh(),
 									children: view.loading ? text("refreshing") : text("refresh")
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+									variant: "ghost",
+									size: "sm",
+									className: "ccp-close",
+									"aria-label": text("close"),
+									title: text("closeHint"),
+									onClick: () => props.close(),
+									children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+										"aria-hidden": "true",
+										children: "×"
+									})
 								})
 							]
 						}),
@@ -4773,11 +4720,23 @@ window.__ModuleLoader__.load({
 		* matching the shell's own rail geometry. `wide` comes from the shell as an
 		* owner prop — unlike the old `sidebar.panellist` row, this slot really does
 		* supply it.
+		*
+		* Rendering is gated on the settings page's `showSidebarQuota` toggle, which
+		* defaults OFF: a fresh install shows no quota surface in the sidebar and runs
+		* no background poll. The gate reads the STORED document (the settings
+		* controller's `sidebarQuota` fact), so an unsaved draft cannot show the card,
+		* while a landed save flips it live. The entry is still REGISTERED — this is a
+		* render decision, not a slot registration, so nothing churns the slot ledger.
 		*/
 		function CommandCodeFooterEntry(props) {
+			const visible = props.useCommandCodeSettings((snapshot) => snapshot.sidebarQuota);
 			const view = usePanelView(props);
 			const startAutoRefresh = props.startAutoRefresh;
-			(0, react.useEffect)(() => startAutoRefresh(), [startAutoRefresh]);
+			(0, react.useEffect)(() => {
+				if (!visible) return void 0;
+				return startAutoRefresh();
+			}, [visible, startAutoRefresh]);
+			if (!visible) return null;
 			const text = (key) => view.text[key] ?? key;
 			const headline = view.footerBars[0];
 			const title = view.footTitle;
@@ -5710,6 +5669,11 @@ window.__ModuleLoader__.load({
 .ccp-subtitle{margin:0;color:var(--dsw-alias-label-tertiary);font-size:12px;line-height:1.5}
 .ccp-spacer{flex:1}
 .ccp-meta{color:var(--dsw-alias-label-tertiary);font-size:11px;line-height:1.5;font-variant-numeric:tabular-nums}
+/* The dashboard's exit: an icon-sized glyph button. The primitive's own
+   geometry is kept (size="sm"); only the glyph is enlarged and optically
+   centred, so it reads as a dismiss control rather than a text button. */
+.ccp-close{min-width:28px;justify-content:center;padding-left:0;padding-right:0}
+.ccp-close span{font-size:16px;line-height:1}
 .ccp-hint{color:var(--dsw-alias-label-tertiary);margin:0;font-size:12px;line-height:1.5}
 
 /* Notices: the no-key guidance, a blocked report, and a stale-data error. */
@@ -5787,7 +5751,7 @@ window.__ModuleLoader__.load({
 			streamIdleTimeoutMs: "流空闲超时（毫秒）",
 			streamIdleTimeoutMsHint: "生成流停滞多久视为断连；默认 300000（长思考模型可静默数分钟，默认值刻意放宽）。",
 			advancedSettings: "高级设置",
-			advancedSettingsHint: "API 地址、工作目录、超时与模型过滤等不常修改的选项。",
+			advancedSettingsHint: "API 地址、工作目录、超时、模型过滤、联网搜索与侧边栏额度卡片等不常修改的选项。",
 			advancedOverriddenOne: "已自定义 1 项",
 			advancedOverriddenMany: "已自定义 {count} 项",
 			advancedInvalid: "高级设置中有未填好的数字，请展开修正后再保存。",
@@ -5795,6 +5759,8 @@ window.__ModuleLoader__.load({
 			filterModelsByPlanHint: "开启后，模型选择器只列出当前套餐可用的模型；账户持有按需余额时会显示全部。",
 			webSearch: "用 Command Code 承载联网搜索",
 			webSearchHint: "开启后，dsh 的 web_search 工具由 Command Code 承担（复用同一个 API key 与地址），并优先于其他搜索后端；关闭则把选择权交还给之前的后端（如 modsearch），而不是强制回退到 DeepSeek 搜索。",
+			showSidebarQuota: "在侧边栏显示额度卡片",
+			showSidebarQuotaHint: "开启后，侧边栏底部（Settings 上方）显示 Command Code 套餐与配额卡片，点击可在中间栏打开完整仪表盘。默认关闭：左侧不显示任何额度信息，也不会为其后台刷新用量。保存后立即生效。",
 			accountsTitle: "多账户轮换",
 			accountsHint: "当前账户达到用量限额（429）或密钥失效（401）时，请求自动切换到下一个账户；全部耗尽时会提示最早的重置时间。",
 			accountAdd: "添加账户",
@@ -5919,7 +5885,7 @@ window.__ModuleLoader__.load({
 			streamIdleTimeoutMs: "Stream idle timeout (ms)",
 			streamIdleTimeoutMsHint: "How long a stalled stream is treated as dead; default 300000 (deliberately generous — long-thinking models can stay silent for minutes).",
 			advancedSettings: "Advanced",
-			advancedSettingsHint: "Rarely touched options: API base URL, working directory, timeouts, and model filtering.",
+			advancedSettingsHint: "Rarely touched options: API base URL, working directory, timeouts, model filtering, web search, and the sidebar quota card.",
 			advancedOverriddenOne: "1 customized",
 			advancedOverriddenMany: "{count} customized",
 			advancedInvalid: "A number in Advanced settings is not ready to save; expand to fix it.",
@@ -5927,6 +5893,8 @@ window.__ModuleLoader__.load({
 			filterModelsByPlanHint: "When on, the model picker lists only models your subscription includes; any on-demand credit balance shows the full catalog.",
 			webSearch: "Serve dsh web search with Command Code",
 			webSearchHint: "When on, the model-facing web_search tool is backed by Command Code (same API key and base URL as chat), winning over other search backends. Off hands the selection back to the previous backend (e.g. modsearch) instead of forcing the shipped DeepSeek search.",
+			showSidebarQuota: "Show the quota card in the sidebar",
+			showSidebarQuotaHint: "When on, a Command Code plan & quota card sits at the bottom of the sidebar (above Settings) and opens the full dashboard in the centre column. Off by default: nothing is shown on the left, and no background usage poll runs for it. Applies on save.",
 			accountsTitle: "Account rotation",
 			accountsHint: "When the active account hits its usage limit (429) or its key fails (401), requests switch to the next account; when every account is exhausted the error names the earliest window reset.",
 			accountAdd: "Add account",
@@ -6199,6 +6167,15 @@ select.cc-input{appearance:none;-webkit-appearance:none;-moz-appearance:none;box
 		*/
 		const PANEL_ID = "commandcode-panel";
 		/**
+		* ui-conversation's reserved `main` key, used only as the exit fallback for a
+		* layout whose `selectPanel` predates the `null` "show the Conversation"
+		* selection (see `close` in {@link applyClientSurfaces}). Declared locally for
+		* the same reason as {@link PANEL_ID}: ui-conversation is not a dependency of
+		* this bundle, and the key is a published contract of the layout (its README
+		* names `conversation` as reserved for the Conversation).
+		*/
+		const CONVERSATION_PANEL_ID = "conversation";
+		/**
 		* The composer figure's entry id in `conversation.composer.dock`. Its own id,
 		* not the shipped `stats` cell's: reusing `stats` would REPLACE the tokens /
 		* cache-hit / throughput readout rather than inject into it, and that readout
@@ -6213,12 +6190,15 @@ select.cc-input{appearance:none;-webkit-appearance:none;-moz-appearance:none;box
 		*/
 		function apply(ctx) {
 			injectPageCss();
-			const connection = ctx.get("connection");
-			if (connection !== void 0) installFriendlyImageError(connection, () => ctx.locale.getLocale().active === "zh" ? "zh" : "en");
 			ctx.effect(() => ctx.locale.register("settings.commandcode", {
 				zh,
 				en
 			}), "dsh-commandcode-provider: page copy");
+			ctx.effect(() => ctx.locale.register(PANEL_LOCALE_NS, {
+				zh: PANEL_COPY_ZH,
+				en: PANEL_COPY_EN
+			}), "dsh-commandcode-provider: panel copy");
+			const connection = ctx.get("connection");
 			const legacyApi = adaptLegacyCredentials(connection?.api?.credentials);
 			if (legacyApi !== void 0) {
 				applyClientSurfaces(ctx, legacyApi, connection?.hostDescription);
@@ -6431,6 +6411,19 @@ select.cc-input{appearance:none;-webkit-appearance:none;-moz-appearance:none;box
 				open: () => {
 					const layout = ctx.get("layout");
 					if (typeof layout?.selectPanel === "function") layout.selectPanel(PANEL_ID);
+				},
+				close: () => {
+					const layout = ctx.get("layout");
+					if (typeof layout?.selectPanel !== "function") return;
+					try {
+						layout.selectPanel(null);
+					} catch {
+						try {
+							layout.selectPanel(CONVERSATION_PANEL_ID);
+						} catch (error) {
+							console.error("[dsh-commandcode-provider] could not close the plans & quota panel:", error);
+						}
+					}
 				}
 			});
 			ctx.effect(() => injectPanelCss(), "dsh-commandcode-provider: panel styles");
@@ -6438,6 +6431,7 @@ select.cc-input{appearance:none;-webkit-appearance:none;-moz-appearance:none;box
 				ctx.slots.inject("main", () => ctx.slots.register({
 					name: "main",
 					key: PANEL_ID,
+					locale: PANEL_LOCALE_NS,
 					inject: panelFace
 				}, CommandCodePanel));
 			} catch (error) {
@@ -6450,6 +6444,7 @@ select.cc-input{appearance:none;-webkit-appearance:none;-moz-appearance:none;box
 						name: "sidebar.footer.action",
 						id: PANEL_ID,
 						order: 1,
+						locale: PANEL_LOCALE_NS,
 						inject: panelFace
 					}, CommandCodeFooterEntry));
 				} catch (error) {
@@ -6477,8 +6472,6 @@ select.cc-input{appearance:none;-webkit-appearance:none;-moz-appearance:none;box
 		//#endregion
 		exports.apply = apply;
 		exports.inject = inject;
-		exports.isImageSessionRejection = isImageSessionRejection;
-		exports.withFriendlyImageError = withFriendlyImageError;
 		return module.exports;
 	}
 });