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

package/CHANGELOG.md

@@ -6,6 +6,26 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 
 ## [Unreleased]
 
+## [0.11.2] - 2026-09-15
+
+### Added
+- **A pre-release engine smoke test** (`npm run test:engine`, [#43](https://github.com/Mars-Sea/dsh-commandcode-provider/issues/43)). It installs the newest release `package.json` declares compatible, stages this checkout's published surface in a scratch tree whose peers ARE that engine's, and imports the bundle there — the only check that can see a bundle which cannot link against the engine it will run on, because a `link:`-installed profile resolves the plugin's peers from the plugin's own `node_modules` instead. It also audits every static named import, the client bundle's `require()` calls, and the request-image policy the engine exposes (including that `LlmError` carries the offload count back).
+- **Session images are now priced the way the upstream that serves them charges for them.** The plugin declares request-image pricing to the harness's token meter, so an image occurrence is charged its family's published visual-token count — Anthropic's one-token-per-750-pixels rule, OpenAI's 512-px tiles, Gemini's 768-px crops, DeepSeek's token grid — read off the model's catalog id, with the most expensive of those rules as the conservative estimate for the families whose accounting we cannot tell apart (Qwen, MiniMax, xAI, moonshot and friends). Without it the meter fell back to a structural estimate that charged a handful of tokens for a full screenshot, so an image-heavy session under-reported the context it was carrying and could walk into its own context window. Offloaded images and text-only routes are priced as the placeholder text the model actually receives. These are context estimates, not invoices: a completed request's own usage stays authoritative.
+
+
+### Changed
+- **The declared Harness range now admits every release the manifest supports.** A caret on a prerelease (`^0.1.2-rc.1`) can only ever resolve to `0.1.2-rc.1`, because semver admits a prerelease only inside the same `major.minor.patch` tuple — so a fresh generation installed a second, older copy of the Harness beside the running engine instead of pairing with it. The peer range is now an exact-version disjunction covering `0.1.2-rc.1` through `0.1.6-alpha.1`, repeated verbatim in `dsh.compatibility.dsh` and `engines.dsh`, and `dsh.compatibility.dshReleases` records `0.1.6-alpha.1` as compatible so the catalog keeps listing the plugin for the current release.
+- **Request images now travel as request versions instead of the stored originals.** An attachment is kept normalized at the size admission accepted; every provider request now asks the attachment service for the version encoded to this route's target — a 1568-px long edge (Anthropic's ceiling, inside the high-detail band of the OpenAI and Gemini tile schemes) and at most 1 MiB per image — and that version is cached by the service and reused across occurrences. Measured on a 3600x2400 screenshot: the harness-normalized original was 2508x1672 at 2.4 MiB, and what reached the wire was 1568x1045 at 0.7 MiB, a 3.4x cut in the base64 that every subsequent request in the session re-sends — which is what pushes a long vision session toward the gateway's undocumented ~50 MB body cap. The request-image budget still accounts the stored size, so the safety margin it computes is unchanged (and conservative).
+- **The plans & quota panel now follows the harness language.** Its copy was English on every harness by construction; both the sidebar card and the dashboard now read in the active language (`panel.commandcode` is a registered locale namespace binding the two panel slots' `t` seat, and every label, state word and the card's tooltip is composed through it). Switching the harness language re-renders the panel immediately. The composer session-cost estimate remains English by construction.
+
+
+### Fixed
+- **The plugin loads on dsh `0.1.6-alpha.1` again** ([#43](https://github.com/Mars-Sea/dsh-commandcode-provider/issues/43)). dsh-llm 0.1.6 removed `offloadRequestImagesWithPolicy`, which the adapter imported by name, so the built bundle failed at ESM link time and the host half never instantiated: no `commandcode` route, no settings page, no panel — and 0.1.6 reports an optional plugin's failure far more quietly than 0.1.5 did. The request-image policy is now reached through a namespace import and selected at runtime, so one build serves both engine generations. On 0.1.2–0.1.5 nothing changes: the adapter still projects its own history under the same 32 MiB / 60-image budget. On 0.1.6 the offload set belongs to the session surface: the adapter renders the surface's durable `offloaded` marks as placeholder text, and an over-budget history fails with `IMAGE_OFFLOAD_REQUIRED` + the count to offload, which the default `dsh-compaction-image-offload` plugin records as one `image/offload` event before retrying. An omission therefore survives session restore and fork, and the token meter stops counting evicted images as context. A 413 asks for the stricter rung's shortfall through the same channel; when nothing is left to offload, the existing bilingual request-size diagnosis stands.
+- **The plans & quota dashboard can be closed again** ([#41](https://github.com/Mars-Sea/dsh-commandcode-provider/issues/41)). Opening it from the sidebar card replaces the conversation in the center column, and there was no way back: the card only re-selected the same panel, so the session stayed unreachable until the whole page was reloaded. The dashboard header now carries a **×** button (its tooltip and accessible name say "Back to the conversation") that returns to the conversation (`ctx.layout.selectPanel(null)`) without changing the current session; on a layout whose panel selection predates that `null` form it falls back to ui-conversation's reserved `main` seat.
+
+### Removed
+- **The client-side image-gate error rewrite, which could never fire.** The plugin used to wrap the legacy `connection.api.sessions` face so a `model-unavailable` "does not accept image input" rejection came back friendlier. That face is gone (model selection moved to the remote in 0.1.2), and the rejection it looked for is not the one this harness raises: the real guard runs on the SEND path as `session/attachment-invalid` with `reason: MODEL_DOES_NOT_SUPPORT_IMAGES`, and the conversation UI already renders it in the active language ("当前模型不支持图片，请切换支持图片的模型" / "The current model does not support images; switch to a model that does"). So the wrapper, its tests and its two dictionary strings are gone rather than retargeted — a second copy of a message the harness already localizes would only be able to drift from it.
+
 ## [0.11.1] - 2026-09-15
 
 ### Changed

package/README.md

@@ -27,7 +27,7 @@ Unofficial [DeepSeek Harness](https://deepseek-harness.github.io/deepseek-harnes
 - **Plan-aware picker** — models above your subscription tier are hidden by default (toggleable); an optional **Model allowlist** keeps only your favorites in the picker.
 - **Reasoning-effort support** — models with selectable reasoning effort levels expose them in the picker.
 - **Image input** — Vision-capable models accept images.
-- **Plans & quota panel** — an optional Command Code card at the bottom of the sidebar (directly above Settings) shows the serving account's plan and its 5-hour and weekly windows; clicking it opens a dashboard with the billing period, both windows as progress bars with reset times, monthly credit consumption, and the purchased/free balances. **Off by default** — turn on *"Show the quota card in the sidebar"* under **Settings → Command Code → Advanced** to show it, and the same switch hides it again (a hidden card draws nothing at all and runs no background usage poll); the change lands as soon as you save. Needs dsh 0.1.5 (rc.1) or newer, and reads in English on every harness language.
+- **Plans & quota panel** — an optional Command Code card at the bottom of the sidebar (directly above Settings) shows the serving account's plan and its 5-hour and weekly windows; clicking it opens a dashboard with the billing period, both windows as progress bars with reset times, monthly credit consumption, and the purchased/free balances. The dashboard's **×** button hands the center column back to your conversation (the current session is untouched). **Off by default** — turn on *"Show the quota card in the sidebar"* under **Settings → Command Code → Advanced** to show it, and the same switch hides it again (a hidden card draws nothing at all and runs no background usage poll); the change lands as soon as you save. The panel follows your harness language (中文 / English) and needs dsh 0.1.5 (rc.1) or newer.
 - **Session cost estimate** — published-rate estimates (`≈`) beside the composer token counter and in its usage dialog, using each request's model, request time and context tier from durable session history. Model switches and viewing the session later do not reprice earlier requests. Mixed-provider or unpriced usage shows a labeled subtotal (`≥`); missing history or wholly unpriceable usage stays hidden. These are estimates from the installed price snapshot, not provider invoices. Also English on every harness language.
 - **Web search** — the dsh `web_search` tool is backed by the Command Code Provider API (`/alpha/web-search`) with the same key/endpoint as chat, so no separate search key or base URL is needed. See [Web search](#web-search).
 

package/README.zh-CN.md

@@ -27,7 +27,7 @@
 - **按套餐过滤**：默认隐藏超出订阅套餐的模型，可一键关闭；「模型白名单」可进一步只保留常用模型。
 - **推理强度支持**：支持推理强度的模型可在选择器中选择档位。
 - **图片输入**：Vision 模型支持发送图片。
-- **套餐与配额面板**：可选的 Command Code 卡片位于侧边栏底部（Settings 正上方），显示当前服务账号的套餐与 5 小时 / 每周两个配额窗口；点击后在中间栏打开面板，包含计费周期、两个窗口的进度条与重置时间、月度额度消耗，以及已购买 / 赠送余额。**默认关闭**——在 **设置 → Command Code → 高级设置** 中打开「在侧边栏显示额度卡片」即可显示，同一开关也能随时隐藏（隐藏时左侧不渲染任何内容，也不会为其后台刷新用量）。需要 dsh 0.1.5（rc.1）或更高版本；无论 Harness 语言如何，该面板固定为英文。
+- **套餐与配额面板**：可选的 Command Code 卡片位于侧边栏底部（Settings 正上方），显示当前服务账号的套餐与 5 小时 / 每周两个配额窗口；点击后在中间栏打开面板，包含计费周期、两个窗口的进度条与重置时间、月度额度消耗，以及已购买 / 赠送余额。面板右上角的 **×** 按钮可随时把中间栏交还给会话（不会切换当前会话）。**默认关闭**——在 **设置 → Command Code → 高级设置** 中打开「在侧边栏显示额度卡片」即可显示，同一开关也能随时隐藏（隐藏时左侧不渲染任何内容，也不会为其后台刷新用量）。面板文案跟随 Harness 显示语言（中文 / English），需要 dsh 0.1.5（rc.1）或更高版本。
 - **会话费用估算**：在输入框下方的 token 计数旁及用量对话框中显示估算金额（`≈`），根据持久化历史中每次请求的模型、请求时间和上下文阶梯分别计价。切换模型或稍后查看不会重新定价之前的请求。混合供应商或缺少费率时显示已定价部分的小计（`≥`）；缺少历史事实或完全无法定价时不显示金额。结果基于插件内的价格快照，不等同于供应商账单。同样固定为英文。
 - **联网搜索**：dsh 的 `web_search` 工具由 Command Code Provider API（`/alpha/web-search`）承载，复用聊天同一个 key 与端点，无需单独配置搜索 key 或地址。详见[联网搜索](#联网搜索)。
 

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.
@@ -2294,7 +2150,7 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region package.json
-		var version = "0.11.1";
+		var version = "0.11.2";
 		var repository = {
 			"type": "git",
 			"url": "git+https://github.com/Mars-Sea/dsh-commandcode-provider.git"
@@ -3981,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.",
@@ -4031,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
@@ -4131,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;
@@ -4142,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",
@@ -4157,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 = [];
@@ -4208,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;
 		}
 		/**
@@ -4228,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) => {
@@ -4236,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 = [];
@@ -4255,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,
@@ -4352,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
@@ -4378,7 +4296,8 @@ window.__ModuleLoader__.load({
 			return buildPanelView({
 				usage,
 				apiKeyConfigured: settings.anyAccountConfigured,
-				removingIds: settings.accountsRemoving
+				removingIds: settings.accountsRemoving,
+				t: props.t ?? panelTextEN
 			});
 		}
 		/**
@@ -4704,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: "×"
+									})
 								})
 							]
 						}),
@@ -5738,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. */
@@ -6231,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
@@ -6245,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);
@@ -6463,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");
@@ -6470,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) {
@@ -6482,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) {
@@ -6509,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;
 	}
 });