@lijian-ui/dsh-file-manager 0.1.21 → 0.2.1

package/lib/client.js

@@ -1083,6 +1083,274 @@ window.__ModuleLoader__.load({
 			return `/filemgr/raw?root=${encodeURIComponent(root)}&path=${encodeURIComponent(path)}&v=${nonce}`;
 		}
 		//#endregion
+		//#region src/client/locales.ts
+		/**
+		* Locale strings for the panel surfaces (zh/en). The client registers the
+		* dictionary through the locale service like the sibling plugins; copy is
+		* deliberately short and technical.
+		* @module dsh-filemgr/client/locales
+		*/
+		const zh = {
+			"explorer.tabs.files": "文件",
+			"explorer.tabs.changes": "变更",
+			"explorer.search.placeholder": "按文件名搜索",
+			"explorer.search.searching": "搜索中…",
+			"explorer.search.empty": "没有匹配的文件",
+			"explorer.search.error": "搜索失败",
+			"explorer.search.truncated": "结果过多，仅显示前 {count} 条",
+			"explorer.tree.empty": "项目为空",
+			"explorer.collapse": "收起面板",
+			"explorer.expand": "展开面板",
+			"explorer.maximize": "最大化文件面板",
+			"explorer.restore": "还原面板",
+			"explorer.openPreview": "打开预览",
+			"explorer.drag.dropHint": "松手插入文件路径",
+			"scm.repositories": "存储库",
+			"scm.changes": "变更",
+			"scm.staged": "已暂存",
+			"scm.unstaged": "变更",
+			"scm.untracked": "未跟踪",
+			"scm.conflicted": "冲突",
+			"scm.stage": "暂存",
+			"scm.unstage": "取消暂存",
+			"scm.discard": "放弃更改",
+			"scm.stageAll": "全部暂存",
+			"scm.discardAll": "全部放弃",
+			"scm.empty": "没有更改",
+			"scm.notRepo": "当前目录不是 git 仓库",
+			"scm.gitMissing": "未检测到 git，请先安装 git 后重试",
+			"scm.loading": "读取状态中…",
+			"scm.failed": "操作失败",
+			"scm.viewList": "列表视图",
+			"scm.viewTree": "树视图",
+			"scm.discardConfirmTracked": "放弃对 {count} 个文件的更改？此操作不可恢复。",
+			"scm.discardConfirmUntracked": "删除 {count} 个未跟踪文件？此操作不可恢复。",
+			"preview.noTabs": "没有打开的预览",
+			"preview.newUrlTab": "新建 URL 预览",
+			"preview.collapsePanel": "收起预览面板",
+			"preview.maximize": "最大化预览面板",
+			"preview.restore": "还原面板",
+			"preview.source": "源码",
+			"preview.preview": "预览",
+			"preview.editor": "编辑器",
+			"preview.split": "分屏",
+			"preview.refresh": "刷新",
+			"preview.refresh.updated": "文件已在磁盘更新",
+			"preview.save": "保存",
+			"preview.download": "下载",
+			"preview.copyCode": "复制代码",
+			"preview.copyCodeDone": "已复制",
+			"preview.openExternal": "在系统应用中打开",
+			"preview.dirty": "未保存的更改",
+			"preview.closeLeft": "关闭左侧",
+			"preview.closeRight": "关闭右侧",
+			"preview.closeOthers": "关闭其他",
+			"preview.closeAll": "关闭全部",
+			"preview.closeConfirmTitle": "关闭未保存的标签页",
+			"preview.closeConfirmBody": "{count} 个标签页有未保存的更改，关闭将丢失这些更改。",
+			"preview.saved": "已保存",
+			"preview.saveConflict": "文件已在磁盘上被修改，保存冲突：请刷新后重试",
+			"preview.errorOversized": "文件过大，仅加载前 80,000 字符",
+			"preview.unsupported": "此格式暂不支持预览",
+			"preview.downloadHint": "可在系统应用中打开或下载查看",
+			"preview.url.placeholder": "输入网址，回车打开",
+			"preview.url.hint": "按 Esc 还原",
+			"common.cancel": "取消",
+			"common.confirm": "确定",
+			"common.close": "关闭",
+			"common.delete": "删除",
+			"common.copyPath": "复制路径",
+			"common.copied": "已复制",
+			"explorer.menu.copyPath": "复制路径",
+			"explorer.menu.copyName": "复制名称",
+			"explorer.menu.reveal": "在文件管理器中显示",
+			"explorer.menu.openWithDefault": "用默认应用打开",
+			"explorer.menu.rename": "重命名",
+			"explorer.menu.newFile": "新建文件",
+			"explorer.menu.newFolder": "新建文件夹",
+			"explorer.menu.delete": "删除",
+			"explorer.rename.title": "重命名",
+			"explorer.newFile.title": "新建文件",
+			"explorer.newFolder.title": "新建文件夹",
+			"explorer.deleteConfirmTitle": "删除确认",
+			"explorer.deleteConfirmBody": "确定要删除「{name}」吗？此操作不可恢复。",
+			"explorer.opFailed": "操作失败",
+			"explorer.refToInput": "引用到输入框",
+			"settings.title": "右侧面板",
+			"settings.description": "Explorer / Preview 与 SCM 变更面板的总开关。",
+			"settings.enabled": "启用右侧面板",
+			"settings.enabledHint": "关闭后不再挂载右侧文件树与预览列、不显示浮动展开按钮、不注册 /filemgr 路由，也不做工作区监视与 git 轮询；聚合包其余插件不受影响。",
+			"settings.overridden": "已覆盖",
+			"settings.reset": "恢复默认",
+			"settings.notExposed": "当前 DSH 版本未向设置页暴露本插件的配置命名空间，表单不可用。可编辑 ~/.dsh/settings.yaml 直接配置，或为 dsh-host-apiproxy 的 WEB_SETTINGS_NAMESPACES 白名单补充本命名空间后重启。",
+			"settings.readOnly": "当前部署的设置只读。",
+			"settings.inherit": "继承",
+			"settings.on": "开",
+			"settings.off": "关",
+			"settings.expand": "展开设置",
+			"settings.collapse": "收起设置",
+			"settings.save": "保存",
+			"settings.saving": "保存中…",
+			"settings.discard": "放弃",
+			"settings.unsaved": "未保存",
+			"settings.saveFailed": "部署未接受这些值，已保留供你修改。",
+			"settings.invalidNumber": "请输入数字，留空则使用默认值。",
+			"dock.filePanel.label": "文件面板",
+			"preview.addToChat": "添加到对话",
+			"picker.title": "引用项目文件",
+			"picker.searchPlaceholder": "搜索工作区文件…",
+			"picker.loading": "加载中…",
+			"picker.emptyDir": "（空目录）",
+			"picker.emptySelection": "选择文件或目录（可多选）",
+			"picker.insert": "插入",
+			"picker.removeAria": "移除",
+			"picker.clearAria": "清空",
+			"picker.closeAria": "关闭"
+		};
+		const en = {
+			"explorer.tabs.files": "Files",
+			"explorer.tabs.changes": "Changes",
+			"explorer.search.placeholder": "Search file names",
+			"explorer.search.searching": "Searching…",
+			"explorer.search.empty": "No matching files",
+			"explorer.search.error": "Search failed",
+			"explorer.search.truncated": "Too many results, showing first {count}",
+			"explorer.tree.empty": "The project is empty",
+			"explorer.collapse": "Collapse panel",
+			"explorer.expand": "Expand panel",
+			"explorer.maximize": "Maximize files panel",
+			"explorer.restore": "Restore panel",
+			"explorer.openPreview": "Open preview",
+			"explorer.drag.dropHint": "Release to insert the file path",
+			"scm.repositories": "Repositories",
+			"scm.changes": "Changes",
+			"scm.staged": "Staged",
+			"scm.unstaged": "Changes",
+			"scm.untracked": "Untracked",
+			"scm.conflicted": "Conflict",
+			"scm.stage": "Stage",
+			"scm.unstage": "Unstage",
+			"scm.discard": "Discard",
+			"scm.stageAll": "Stage all",
+			"scm.discardAll": "Discard all",
+			"scm.empty": "No changes",
+			"scm.notRepo": "Not a git repository",
+			"scm.gitMissing": "Git is not installed. Install git and reload to use the changes panel",
+			"scm.loading": "Loading status…",
+			"scm.failed": "Operation failed",
+			"scm.viewList": "List view",
+			"scm.viewTree": "Tree view",
+			"scm.discardConfirmTracked": "Discard changes in {count} files? This cannot be undone.",
+			"scm.discardConfirmUntracked": "Delete {count} untracked files? This cannot be undone.",
+			"preview.noTabs": "No open previews",
+			"preview.newUrlTab": "New URL preview",
+			"preview.collapsePanel": "Collapse preview panel",
+			"preview.maximize": "Maximize preview panel",
+			"preview.restore": "Restore panel",
+			"preview.source": "Source",
+			"preview.preview": "Preview",
+			"preview.editor": "Editor",
+			"preview.split": "Split",
+			"preview.refresh": "Refresh",
+			"preview.refresh.updated": "File updated on disk",
+			"preview.save": "Save",
+			"preview.download": "Download",
+			"preview.copyCode": "Copy code",
+			"preview.copyCodeDone": "Copied",
+			"preview.openExternal": "Open in system app",
+			"preview.dirty": "Unsaved changes",
+			"preview.closeLeft": "Close left",
+			"preview.closeRight": "Close right",
+			"preview.closeOthers": "Close others",
+			"preview.closeAll": "Close all",
+			"preview.closeConfirmTitle": "Close unsaved tabs",
+			"preview.closeConfirmBody": "{count} tabs have unsaved changes. Closing will lose them.",
+			"preview.saved": "Saved",
+			"preview.saveConflict": "File changed on disk. Save conflict: refresh and retry",
+			"preview.errorOversized": "File too large, only the first 80,000 characters loaded",
+			"preview.unsupported": "Preview not supported for this format",
+			"preview.downloadHint": "Open in a system app or download to view",
+			"preview.url.placeholder": "Enter a URL and press Enter",
+			"preview.url.hint": "Press Esc to revert",
+			"common.cancel": "Cancel",
+			"common.confirm": "OK",
+			"common.close": "Close",
+			"common.delete": "Delete",
+			"common.copyPath": "Copy path",
+			"common.copied": "Copied",
+			"explorer.menu.copyPath": "Copy path",
+			"explorer.menu.copyName": "Copy name",
+			"explorer.menu.reveal": "Reveal in file manager",
+			"explorer.menu.openWithDefault": "Open with default app",
+			"explorer.menu.rename": "Rename",
+			"explorer.menu.newFile": "New file",
+			"explorer.menu.newFolder": "New folder",
+			"explorer.menu.delete": "Delete",
+			"explorer.rename.title": "Rename",
+			"explorer.newFile.title": "New file",
+			"explorer.newFolder.title": "New folder",
+			"explorer.deleteConfirmTitle": "Confirm delete",
+			"explorer.deleteConfirmBody": "Delete \"{name}\"? This cannot be undone.",
+			"explorer.opFailed": "Operation failed",
+			"explorer.refToInput": "Reference to input",
+			"settings.title": "Right panel",
+			"settings.description": "Master switch for the Explorer / Preview and SCM changes panels.",
+			"settings.enabled": "Enable the right panel",
+			"settings.enabledHint": "When off, the Explorer and Preview columns are not mounted, the floating expand button disappears, the /filemgr routes are not registered, and workspace watching and git polling stop. The rest of the family bundle is unaffected.",
+			"settings.overridden": "Overridden",
+			"settings.reset": "Reset",
+			"settings.notExposed": "This DSH version does not expose this plugin's settings namespace; the form is unavailable. Edit ~/.dsh/settings.yaml directly, or add the namespace to the WEB_SETTINGS_NAMESPACES allowlist of dsh-host-apiproxy and restart.",
+			"settings.readOnly": "Settings are read-only in this deployment.",
+			"settings.inherit": "Inherit",
+			"settings.on": "On",
+			"settings.off": "Off",
+			"settings.expand": "Expand settings",
+			"settings.collapse": "Collapse settings",
+			"settings.save": "Save",
+			"settings.saving": "Saving…",
+			"settings.discard": "Discard",
+			"settings.unsaved": "Unsaved",
+			"settings.saveFailed": "The deployment rejected these values; your edits are kept.",
+			"settings.invalidNumber": "Enter a number, or leave it empty to use the default.",
+			"dock.filePanel.label": "File Panel",
+			"preview.addToChat": "Add to Chat",
+			"picker.title": "Reference Project Files",
+			"picker.searchPlaceholder": "Search workspace files…",
+			"picker.loading": "Loading…",
+			"picker.emptyDir": "(empty directory)",
+			"picker.emptySelection": "Select files or directories (multi-select)",
+			"picker.insert": "Insert",
+			"picker.removeAria": "Remove",
+			"picker.clearAria": "Clear",
+			"picker.closeAria": "Close"
+		};
+		/** The dictionary namespace this plugin owns. */
+		const NS = "filemgr";
+		/** Format one copy string with {name} placeholders. */
+		function format(template, params) {
+			return template.replace(/\{(\w+)\}/g, (_, key) => String(params[key] ?? `{${key}}`));
+		}
+		/** Simple dictionary access (zh/en by a global flag the client sets). */
+		const dictionaries = {
+			zh,
+			en
+		};
+		let currentLanguage = "zh";
+		/** Set the active language (the client mirrors the locale service). */
+		function setLanguage(language) {
+			currentLanguage = language === "en" ? "en" : "zh";
+		}
+		let _boundT = null;
+		function bindT(t) {
+			_boundT = t;
+		}
+		/** Translate one key with optional params. */
+		function t(key, params) {
+			if (_boundT !== null) return _boundT(key, params);
+			const template = (dictionaries[currentLanguage] ?? zh)[key] ?? zh[key];
+			return params === void 0 ? template : format(template, params);
+		}
+		//#endregion
 		//#region src/client/persist.ts
 		/**
 		* Persistence helpers for panel preferences: range-validated reads (invalid
@@ -2179,7 +2447,7 @@ window.__ModuleLoader__.load({
 								if (!result.ok) return {
 									...item,
 									loading: false,
-									error: result.error.code === "write-conflict" ? "文件已在磁盘上被修改，保存冲突：请刷新后重试" : result.error.message
+									error: result.error.code === "write-conflict" ? t("preview.saveConflict") : result.error.message
 								};
 								if (item.content !== sentContent) return {
 									...item,
@@ -2348,28 +2616,6 @@ window.__ModuleLoader__.load({
 		function maximizedOverlay(availableWidth) {
 			return availableWidth > 0 && availableWidth < 640;
 		}
-		/** The WCO titlebar height when visible; 0 in a plain browser tab. */
-		function titlebarAreaHeight() {
-			const wco = navigator.windowControlsOverlay;
-			if (wco === void 0 || !wco.visible || wco.getTitlebarAreaRect === void 0) return 0;
-			try {
-				const height = wco.getTitlebarAreaRect()?.height ?? 0;
-				return height > 0 ? Math.round(height) : 0;
-			} catch {
-				return 0;
-			}
-		}
-		/** Clamp a requested top px into the usable vertical range. */
-		function clampFloatingTop(top, viewportHeight, buttonHeight, titlebar) {
-			const min = titlebar + 6;
-			const max = Math.max(min, viewportHeight - buttonHeight - 6);
-			if (!Number.isFinite(top)) return min;
-			return Math.min(max, Math.max(min, top));
-		}
-		/** The default top: aligned with the collapse chevron at the top-right. */
-		function topAlignedFloatingTop(viewportHeight, buttonHeight, titlebar) {
-			return clampFloatingTop(titlebar + 6, viewportHeight, buttonHeight, titlebar);
-		}
 		//#endregion
 		//#region src/client/layout.ts
 		/**
@@ -2457,7 +2703,6 @@ window.__ModuleLoader__.load({
 			explorerCol = null;
 			explorerHandle = null;
 			previewHandle = null;
-			floatingButton = null;
 			styleObserver = null;
 			sizeObserver = null;
 			waitObserver = null;
@@ -2519,23 +2764,6 @@ window.__ModuleLoader__.load({
 				this.previewHandle = this.createHandle("filemgr-preview-handle", 20, true, "preview");
 				frame.appendChild(this.explorerHandle);
 				frame.appendChild(this.previewHandle);
-				this.floatingButton = document.createElement("button");
-				this.floatingButton.type = "button";
-				this.floatingButton.className = "filemgr-floating-expand";
-				this.floatingButton.setAttribute("aria-label", "Expand explorer");
-				this.floatingButton.innerHTML = "<svg viewBox=\"0 0 16 16\" width=\"16\" height=\"16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.5\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M6 3l5 5-5 5\"/></svg>";
-				this.floatingButton.addEventListener("click", () => {
-					this.toggleExplorer();
-				});
-				document.body.appendChild(this.floatingButton);
-				const overlay = navigator.windowControlsOverlay;
-				if (overlay !== void 0) {
-					const onGeometryChange = () => {
-						this.positionFloatingButton();
-					};
-					overlay.addEventListener("geometrychange", onGeometryChange);
-					this.disposers.push(() => overlay.removeEventListener("geometrychange", onGeometryChange));
-				}
 				const onKeyDown = (event) => {
 					if (event.key !== "Escape") return;
 					const target = event.target instanceof Element ? event.target : null;
@@ -2552,483 +2780,231 @@ window.__ModuleLoader__.load({
 					if (el === null) return;
 					const inline = el.style.gridTemplateColumns;
 					if (inline === "") return;
-					const tracks = parseGridTracks(inline);
-					if (tracks.length >= 2 && tracks.length <= 3) {
-						this.shellTracks = tracks;
-						this.applyGrid();
-						return;
-					}
-					if (tracks.length === 5 && this.shellTracks.length === 3) return;
-				};
-				this.styleObserver = new MutationObserver(syncGrid);
-				this.styleObserver.observe(frame, {
-					attributes: true,
-					attributeFilter: ["style"]
-				});
-				const measure = () => {
-					if (this.frame === null) return;
-					this.frameWidth = this.frame.getBoundingClientRect().width;
-					const sidebar = this.shellTracks.length >= 1 ? trackPx(this.shellTracks[0]) : 0;
-					const details = this.shellTracks.length >= 3 ? trackPx(this.shellTracks[2]) : 0;
-					const available = Math.max(0, this.frameWidth - sidebar - details);
-					const state = this.layout.getSnapshot();
-					if (Math.abs(state.availableWidth - available) > .5) this.layout.update((prev) => ({
-						...prev,
-						availableWidth: available
-					}));
-					this.layout.shrinkToFit(this.layout.getSnapshot());
-				};
-				this.sizeObserver = new ResizeObserver(() => {
-					measure();
-					this.applyGrid();
-				});
-				this.sizeObserver.observe(frame);
-				this.disposers.push(this.layout.subscribe(() => this.applyGrid()));
-				const initial = frame.style.gridTemplateColumns;
-				if (initial !== "") {
-					const tracks = parseGridTracks(initial);
-					if (tracks.length >= 2 && tracks.length <= 3) this.shellTracks = tracks;
-					else if (tracks.length === 5 && trackPx(tracks[0]) > 0) this.shellTracks = tracks.slice(0, 3);
-				}
-				measure();
-				this.applyGrid();
-			}
-			/** Create one drag handle element with its pointer wiring. */
-			createHandle(className, hitWidth, reverse, kind) {
-				const el = document.createElement("div");
-				el.className = className;
-				el.style.position = "absolute";
-				el.style.top = "0";
-				el.style.bottom = "0";
-				el.style.zIndex = "30";
-				el.style.cursor = "col-resize";
-				el.style.width = `${hitWidth}px`;
-				if (reverse) el.style.marginLeft = `-${hitWidth}px`;
-				el.addEventListener("pointerdown", (event) => {
-					const isExplorer = kind === "explorer";
-					handlePointerDragStart(event, el, {
-						reverse,
-						getStartWidth: () => {
-							const state = this.layout.getSnapshot();
-							return isExplorer ? state.explorerWidth : state.previewWidth;
-						},
-						compute: (startWidth, deltaX) => dragTargetWidth(isExplorer ? "explorer" : "preview", startWidth, deltaX, this.layout.getSnapshot()),
-						onFrame: (width) => {
-							this.layout.update((prev) => isExplorer ? {
-								...prev,
-								explorerWidth: width
-							} : {
-								...prev,
-								previewWidth: width
-							});
-						},
-						onEnd: (width) => {
-							writeStoredNumber(isExplorer ? KEY_EXPLORER_WIDTH : KEY_PREVIEW_WIDTH, width);
-						}
-					});
-				});
-				el.addEventListener("dblclick", () => {
-					this.instant(() => {
-						const width = kind === "explorer" ? 260 : 480;
-						this.layout.update((prev) => kind === "explorer" ? {
-							...prev,
-							explorerWidth: width
-						} : {
-							...prev,
-							previewWidth: width
-						});
-						writeStoredNumber(kind === "explorer" ? KEY_EXPLORER_WIDTH : KEY_PREVIEW_WIDTH, width);
-						this.applyGrid();
-					});
-				});
-				return el;
-			}
-			/** Toggle explorer collapse (width 0, kept mounted; no transition). */
-			toggleExplorer() {
-				const state = this.layout.getSnapshot();
-				const next = !state.explorerCollapsed;
-				this.instant(() => {
-					this.layout.update((prev) => ({
-						...prev,
-						explorerCollapsed: next
-					}));
-					try {
-						localStorage.setItem(`project-panel-collapse:${state.root}`, next ? "collapsed" : "expanded");
-					} catch {}
-					this.applyGrid();
-				});
-			}
-			/** Toggle the preview region (open = tabs exist; close keeps tabs). */
-			setPreviewOpen(open) {
-				this.instant(() => {
-					this.layout.update((prev) => ({
-						...prev,
-						previewOpen: open
-					}));
-					this.applyGrid();
-				});
-			}
-			/**
-			* Locate the shell conversation header: its bottom border is the
-			* horizontal divider under the "Session log" row the button should
-			* sit below. Resolved per call (the shell may mount it late); null when
-			* the shell has no header (standalone installs, desktop variants).
-			*/
-			findHeaderBottom() {
-				const frame = this.frame;
-				if (frame === null) return null;
-				const header = frame.querySelector("[data-pane=\"conversation\"] header, [class*=\"centerCol\"] header");
-				if (header === null) return null;
-				const bottom = header.getBoundingClientRect().bottom;
-				return Number.isFinite(bottom) ? bottom : null;
-			}
-			/** Position the floating button: docked at the top-right corner, just
-			* below the shell header's bottom divider (fallback: the chevron row). */
-			positionFloatingButton() {
-				const el = this.floatingButton;
-				if (el === null) return;
-				const height = window.innerHeight;
-				const titlebar = titlebarAreaHeight();
-				const headerBottom = this.findHeaderBottom();
-				const top = headerBottom !== null ? clampFloatingTop(headerBottom + 8, height, 24, titlebar) : topAlignedFloatingTop(height, 24, titlebar);
-				el.style.top = `${Math.round(top)}px`;
-				el.style.transform = "none";
-			}
-			/** Apply one store update with transitions disabled for exactly one frame. */
-			instant(fn) {
-				const frame = this.frame;
-				if (frame === null) {
-					fn();
-					return;
-				}
-				frame.setAttribute("data-filemgr-instant", "");
-				if (this.instantTimer !== void 0) clearTimeout(this.instantTimer);
-				this.instantTimer = setTimeout(() => {
-					this.instantTimer = void 0;
-					frame.removeAttribute("data-filemgr-instant");
-				}, 0);
-				fn();
-			}
-			/** Re-write the frame grid and reposition handles + floating button. */
-			applyGrid() {
-				const frame = this.frame;
-				if (frame === null) return;
-				if (this.shellTracks.length !== 3) return;
-				const state = this.layout.getSnapshot();
-				const width = this.frameWidth > 0 ? this.frameWidth : frame.getBoundingClientRect().width;
-				if (state.maximized !== null) {
-					this.applyMaximized(frame, state.maximized, width);
-					return;
-				}
-				this.clearMaximizedChrome();
-				const explorer = this.layout.explorerWidthPx(state);
-				const preview = this.layout.previewWidthPx(state);
-				frame.style.gridTemplateColumns = `${this.shellTracks[0]} minmax(0, 1fr) ${this.shellTracks[2]} ${Math.round(preview)}px ${Math.round(explorer)}px`;
-				if (this.explorerCol !== null) this.explorerCol.style.visibility = explorer > 0 ? "visible" : "hidden";
-				if (this.previewCol !== null) this.previewCol.style.visibility = preview > 0 ? "visible" : "hidden";
-				if (this.explorerHandle !== null) {
-					const left = Math.round(width - explorer);
-					this.explorerHandle.style.left = `${left}px`;
-					this.explorerHandle.style.marginLeft = `${-12 / 2}px`;
-					this.explorerHandle.style.display = explorer > 0 && state.root !== "" ? "block" : "none";
-				}
-				if (this.previewHandle !== null) {
-					const left = Math.round(width - explorer - preview);
-					this.previewHandle.style.left = `${left}px`;
-					this.previewHandle.style.display = preview > 0 && state.root !== "" ? "block" : "none";
-				}
-				const detailsTrack = trackPx(this.shellTracks[2]);
-				if (this.detailsHandle === null || !this.detailsHandle.isConnected) this.detailsHandle = frame.querySelector("[data-side=\"details\"]");
-				if (this.detailsHandle !== null) this.detailsHandle.style.left = `${Math.round(width - detailsTrack - preview - explorer)}px`;
-				if (this.floatingButton !== null) {
-					const show = state.root !== "" && state.explorerCollapsed;
-					this.floatingButton.style.display = show ? "flex" : "none";
-					this.positionFloatingButton();
-				}
-			}
-			/**
-			* Maximize layout: the target column takes over the whole frame row (the
-			* other tracks collapse to 0px). On narrow viewports the takeover grid is
-			* skipped and the column renders as a fixed full-screen overlay instead
-			* (issue #315). Everything stays mounted — only geometry changes.
-			*/
-			applyMaximized(frame, target, width) {
-				const overlay = maximizedOverlay(this.layout.getSnapshot().availableWidth);
-				if (!overlay) frame.style.gridTemplateColumns = maximizedGridTracks(target, width);
-				if (this.explorerCol !== null) {
-					this.explorerCol.style.visibility = target === "explorer" ? "visible" : "hidden";
-					this.explorerCol.classList.toggle("filemgr-maximized", target === "explorer" && overlay);
-				}
-				if (this.previewCol !== null) {
-					this.previewCol.style.visibility = target === "preview" ? "visible" : "hidden";
-					this.previewCol.classList.toggle("filemgr-maximized", target === "preview" && overlay);
-				}
-				if (this.explorerHandle !== null) this.explorerHandle.style.display = "none";
-				if (this.previewHandle !== null) this.previewHandle.style.display = "none";
-				if (this.floatingButton !== null) this.floatingButton.style.display = "none";
-			}
-			/** Remove the narrow-screen overlay class from both columns. */
-			clearMaximizedChrome() {
-				this.explorerCol?.classList.remove("filemgr-maximized");
-				this.previewCol?.classList.remove("filemgr-maximized");
-			}
-			/** Detach everything (plugin unload). */
-			dispose() {
-				this.waitObserver?.disconnect();
-				this.styleObserver?.disconnect();
-				this.sizeObserver?.disconnect();
-				for (const dispose of this.disposers) dispose();
-				this.previewCol?.remove();
-				this.explorerCol?.remove();
-				this.explorerHandle?.remove();
-				this.previewHandle?.remove();
-				this.floatingButton?.remove();
-				if (this.instantTimer !== void 0) clearTimeout(this.instantTimer);
-				if (frameElement === this.frame) frameElement = null;
-				this.frame = null;
-			}
-		};
-		//#endregion
-		//#region src/client/locales.ts
-		/**
-		* Locale strings for the panel surfaces (zh/en). The client registers the
-		* dictionary through the locale service like the sibling plugins; copy is
-		* deliberately short and technical.
-		* @module dsh-filemgr/client/locales
-		*/
-		const zh = {
-			"explorer.tabs.files": "文件",
-			"explorer.tabs.changes": "变更",
-			"explorer.search.placeholder": "按文件名搜索",
-			"explorer.search.searching": "搜索中…",
-			"explorer.search.empty": "没有匹配的文件",
-			"explorer.search.error": "搜索失败",
-			"explorer.search.truncated": "结果过多，仅显示前 {count} 条",
-			"explorer.tree.empty": "项目为空",
-			"explorer.collapse": "收起面板",
-			"explorer.expand": "展开面板",
-			"explorer.maximize": "最大化文件面板",
-			"explorer.restore": "还原面板",
-			"explorer.openPreview": "打开预览",
-			"explorer.drag.dropHint": "松手插入文件路径",
-			"scm.repositories": "存储库",
-			"scm.changes": "变更",
-			"scm.staged": "已暂存",
-			"scm.unstaged": "变更",
-			"scm.untracked": "未跟踪",
-			"scm.conflicted": "冲突",
-			"scm.stage": "暂存",
-			"scm.unstage": "取消暂存",
-			"scm.discard": "放弃更改",
-			"scm.stageAll": "全部暂存",
-			"scm.discardAll": "全部放弃",
-			"scm.empty": "没有更改",
-			"scm.notRepo": "当前目录不是 git 仓库",
-			"scm.gitMissing": "未检测到 git，请先安装 git 后重试",
-			"scm.loading": "读取状态中…",
-			"scm.failed": "操作失败",
-			"scm.viewList": "列表视图",
-			"scm.viewTree": "树视图",
-			"scm.discardConfirmTracked": "放弃对 {count} 个文件的更改？此操作不可恢复。",
-			"scm.discardConfirmUntracked": "删除 {count} 个未跟踪文件？此操作不可恢复。",
-			"preview.noTabs": "没有打开的预览",
-			"preview.newUrlTab": "新建 URL 预览",
-			"preview.collapsePanel": "收起预览面板",
-			"preview.maximize": "最大化预览面板",
-			"preview.restore": "还原面板",
-			"preview.source": "源码",
-			"preview.preview": "预览",
-			"preview.editor": "编辑器",
-			"preview.split": "分屏",
-			"preview.refresh": "刷新",
-			"preview.refresh.updated": "文件已在磁盘更新",
-			"preview.save": "保存",
-			"preview.download": "下载",
-			"preview.copyCode": "复制代码",
-			"preview.copyCodeDone": "已复制",
-			"preview.openExternal": "在系统应用中打开",
-			"preview.dirty": "未保存的更改",
-			"preview.closeLeft": "关闭左侧",
-			"preview.closeRight": "关闭右侧",
-			"preview.closeOthers": "关闭其他",
-			"preview.closeAll": "关闭全部",
-			"preview.closeConfirmTitle": "关闭未保存的标签页",
-			"preview.closeConfirmBody": "{count} 个标签页有未保存的更改，关闭将丢失这些更改。",
-			"preview.saved": "已保存",
-			"preview.saveConflict": "文件已在磁盘上被修改，保存冲突：请刷新后重试",
-			"preview.errorOversized": "文件过大，仅加载前 80,000 字符",
-			"preview.unsupported": "此格式暂不支持预览",
-			"preview.downloadHint": "可在系统应用中打开或下载查看",
-			"preview.url.placeholder": "输入网址，回车打开",
-			"preview.url.hint": "按 Esc 还原",
-			"common.cancel": "取消",
-			"common.confirm": "确定",
-			"common.close": "关闭",
-			"common.delete": "删除",
-			"common.copyPath": "复制路径",
-			"common.copied": "已复制",
-			"explorer.menu.copyPath": "复制路径",
-			"explorer.menu.copyName": "复制名称",
-			"explorer.menu.reveal": "在文件管理器中显示",
-			"explorer.menu.openWithDefault": "用默认应用打开",
-			"explorer.menu.rename": "重命名",
-			"explorer.menu.newFile": "新建文件",
-			"explorer.menu.newFolder": "新建文件夹",
-			"explorer.menu.delete": "删除",
-			"explorer.rename.title": "重命名",
-			"explorer.newFile.title": "新建文件",
-			"explorer.newFolder.title": "新建文件夹",
-			"explorer.deleteConfirmTitle": "删除确认",
-			"explorer.deleteConfirmBody": "确定要删除「{name}」吗？此操作不可恢复。",
-			"explorer.opFailed": "操作失败",
-			"explorer.refToInput": "引用到输入框",
-			"settings.title": "右侧面板",
-			"settings.description": "Explorer / Preview 与 SCM 变更面板的总开关。",
-			"settings.enabled": "启用右侧面板",
-			"settings.enabledHint": "关闭后不再挂载右侧文件树与预览列、不显示浮动展开按钮、不注册 /filemgr 路由，也不做工作区监视与 git 轮询；聚合包其余插件不受影响。",
-			"settings.overridden": "已覆盖",
-			"settings.reset": "恢复默认",
-			"settings.notExposed": "当前 DSH 版本未向设置页暴露本插件的配置命名空间，表单不可用。可编辑 ~/.dsh/settings.yaml 直接配置，或为 dsh-host-apiproxy 的 WEB_SETTINGS_NAMESPACES 白名单补充本命名空间后重启。",
-			"settings.readOnly": "当前部署的设置只读。",
-			"settings.inherit": "继承",
-			"settings.on": "开",
-			"settings.off": "关",
-			"settings.expand": "展开设置",
-			"settings.collapse": "收起设置",
-			"settings.save": "保存",
-			"settings.saving": "保存中…",
-			"settings.discard": "放弃",
-			"settings.unsaved": "未保存",
-			"settings.saveFailed": "部署未接受这些值，已保留供你修改。",
-			"settings.invalidNumber": "请输入数字，留空则使用默认值。"
-		};
-		const en = {
-			"explorer.tabs.files": "Files",
-			"explorer.tabs.changes": "Changes",
-			"explorer.search.placeholder": "Search file names",
-			"explorer.search.searching": "Searching…",
-			"explorer.search.empty": "No matching files",
-			"explorer.search.error": "Search failed",
-			"explorer.search.truncated": "Too many results, showing first {count}",
-			"explorer.tree.empty": "The project is empty",
-			"explorer.collapse": "Collapse panel",
-			"explorer.expand": "Expand panel",
-			"explorer.maximize": "Maximize files panel",
-			"explorer.restore": "Restore panel",
-			"explorer.openPreview": "Open preview",
-			"explorer.drag.dropHint": "Release to insert the file path",
-			"scm.repositories": "Repositories",
-			"scm.changes": "Changes",
-			"scm.staged": "Staged",
-			"scm.unstaged": "Changes",
-			"scm.untracked": "Untracked",
-			"scm.conflicted": "Conflict",
-			"scm.stage": "Stage",
-			"scm.unstage": "Unstage",
-			"scm.discard": "Discard",
-			"scm.stageAll": "Stage all",
-			"scm.discardAll": "Discard all",
-			"scm.empty": "No changes",
-			"scm.notRepo": "Not a git repository",
-			"scm.gitMissing": "Git is not installed. Install git and reload to use the changes panel",
-			"scm.loading": "Loading status…",
-			"scm.failed": "Operation failed",
-			"scm.viewList": "List view",
-			"scm.viewTree": "Tree view",
-			"scm.discardConfirmTracked": "Discard changes in {count} files? This cannot be undone.",
-			"scm.discardConfirmUntracked": "Delete {count} untracked files? This cannot be undone.",
-			"preview.noTabs": "No open previews",
-			"preview.newUrlTab": "New URL preview",
-			"preview.collapsePanel": "Collapse preview panel",
-			"preview.maximize": "Maximize preview panel",
-			"preview.restore": "Restore panel",
-			"preview.source": "Source",
-			"preview.preview": "Preview",
-			"preview.editor": "Editor",
-			"preview.split": "Split",
-			"preview.refresh": "Refresh",
-			"preview.refresh.updated": "File updated on disk",
-			"preview.save": "Save",
-			"preview.download": "Download",
-			"preview.copyCode": "Copy code",
-			"preview.copyCodeDone": "Copied",
-			"preview.openExternal": "Open in system app",
-			"preview.dirty": "Unsaved changes",
-			"preview.closeLeft": "Close left",
-			"preview.closeRight": "Close right",
-			"preview.closeOthers": "Close others",
-			"preview.closeAll": "Close all",
-			"preview.closeConfirmTitle": "Close unsaved tabs",
-			"preview.closeConfirmBody": "{count} tabs have unsaved changes. Closing will lose them.",
-			"preview.saved": "Saved",
-			"preview.saveConflict": "File changed on disk. Save conflict: refresh and retry",
-			"preview.errorOversized": "File too large, only the first 80,000 characters loaded",
-			"preview.unsupported": "Preview not supported for this format",
-			"preview.downloadHint": "Open in a system app or download to view",
-			"preview.url.placeholder": "Enter a URL and press Enter",
-			"preview.url.hint": "Press Esc to revert",
-			"common.cancel": "Cancel",
-			"common.confirm": "OK",
-			"common.close": "Close",
-			"common.delete": "Delete",
-			"common.copyPath": "Copy path",
-			"common.copied": "Copied",
-			"explorer.menu.copyPath": "Copy path",
-			"explorer.menu.copyName": "Copy name",
-			"explorer.menu.reveal": "Reveal in file manager",
-			"explorer.menu.openWithDefault": "Open with default app",
-			"explorer.menu.rename": "Rename",
-			"explorer.menu.newFile": "New file",
-			"explorer.menu.newFolder": "New folder",
-			"explorer.menu.delete": "Delete",
-			"explorer.rename.title": "Rename",
-			"explorer.newFile.title": "New file",
-			"explorer.newFolder.title": "New folder",
-			"explorer.deleteConfirmTitle": "Confirm delete",
-			"explorer.deleteConfirmBody": "Delete \"{name}\"? This cannot be undone.",
-			"explorer.opFailed": "Operation failed",
-			"explorer.refToInput": "Reference to input",
-			"settings.title": "Right panel",
-			"settings.description": "Master switch for the Explorer / Preview and SCM changes panels.",
-			"settings.enabled": "Enable the right panel",
-			"settings.enabledHint": "When off, the Explorer and Preview columns are not mounted, the floating expand button disappears, the /filemgr routes are not registered, and workspace watching and git polling stop. The rest of the family bundle is unaffected.",
-			"settings.overridden": "Overridden",
-			"settings.reset": "Reset",
-			"settings.notExposed": "This DSH version does not expose this plugin's settings namespace; the form is unavailable. Edit ~/.dsh/settings.yaml directly, or add the namespace to the WEB_SETTINGS_NAMESPACES allowlist of dsh-host-apiproxy and restart.",
-			"settings.readOnly": "Settings are read-only in this deployment.",
-			"settings.inherit": "Inherit",
-			"settings.on": "On",
-			"settings.off": "Off",
-			"settings.expand": "Expand settings",
-			"settings.collapse": "Collapse settings",
-			"settings.save": "Save",
-			"settings.saving": "Saving…",
-			"settings.discard": "Discard",
-			"settings.unsaved": "Unsaved",
-			"settings.saveFailed": "The deployment rejected these values; your edits are kept.",
-			"settings.invalidNumber": "Enter a number, or leave it empty to use the default."
-		};
-		/** The dictionary namespace this plugin owns. */
-		const NS = "filemgr";
-		/** Format one copy string with {name} placeholders. */
-		function format(template, params) {
-			return template.replace(/\{(\w+)\}/g, (_, key) => String(params[key] ?? `{${key}}`));
-		}
-		/** Simple dictionary access (zh/en by a global flag the client sets). */
-		const dictionaries = {
-			zh,
-			en
+					const tracks = parseGridTracks(inline);
+					if (tracks.length >= 2 && tracks.length <= 3) {
+						this.shellTracks = tracks;
+						this.applyGrid();
+						return;
+					}
+					if (tracks.length === 5 && this.shellTracks.length === 3) return;
+					if (tracks.length === 6 && tracks.includes("[dsh-term]") && this.shellTracks.length === 3) {
+						this.applyGrid();
+						return;
+					}
+				};
+				this.styleObserver = new MutationObserver(syncGrid);
+				this.styleObserver.observe(frame, {
+					attributes: true,
+					attributeFilter: ["style"]
+				});
+				const measure = () => {
+					if (this.frame === null) return;
+					this.frameWidth = this.frame.getBoundingClientRect().width;
+					const sidebar = this.shellTracks.length >= 1 ? trackPx(this.shellTracks[0]) : 0;
+					const details = this.shellTracks.length >= 3 ? trackPx(this.shellTracks[2]) : 0;
+					const available = Math.max(0, this.frameWidth - sidebar - details);
+					const state = this.layout.getSnapshot();
+					if (Math.abs(state.availableWidth - available) > .5) this.layout.update((prev) => ({
+						...prev,
+						availableWidth: available
+					}));
+					this.layout.shrinkToFit(this.layout.getSnapshot());
+				};
+				this.sizeObserver = new ResizeObserver(() => {
+					measure();
+					this.applyGrid();
+				});
+				this.sizeObserver.observe(frame);
+				this.disposers.push(this.layout.subscribe(() => this.applyGrid()));
+				const initial = frame.style.gridTemplateColumns;
+				if (initial !== "") {
+					const tracks = parseGridTracks(initial);
+					if (tracks.length >= 2 && tracks.length <= 3) this.shellTracks = tracks;
+					else if (tracks.length === 5 && trackPx(tracks[0]) > 0) this.shellTracks = tracks.slice(0, 3);
+				}
+				measure();
+				this.applyGrid();
+			}
+			/** Create one drag handle element with its pointer wiring. */
+			createHandle(className, hitWidth, reverse, kind) {
+				const el = document.createElement("div");
+				el.className = className;
+				el.style.position = "absolute";
+				el.style.top = "0";
+				el.style.bottom = "0";
+				el.style.zIndex = "30";
+				el.style.cursor = "col-resize";
+				el.style.width = `${hitWidth}px`;
+				if (reverse) el.style.marginLeft = `-${hitWidth}px`;
+				el.addEventListener("pointerdown", (event) => {
+					const isExplorer = kind === "explorer";
+					handlePointerDragStart(event, el, {
+						reverse,
+						getStartWidth: () => {
+							const state = this.layout.getSnapshot();
+							return isExplorer ? state.explorerWidth : state.previewWidth;
+						},
+						compute: (startWidth, deltaX) => dragTargetWidth(isExplorer ? "explorer" : "preview", startWidth, deltaX, this.layout.getSnapshot()),
+						onFrame: (width) => {
+							this.layout.update((prev) => isExplorer ? {
+								...prev,
+								explorerWidth: width
+							} : {
+								...prev,
+								previewWidth: width
+							});
+						},
+						onEnd: (width) => {
+							writeStoredNumber(isExplorer ? KEY_EXPLORER_WIDTH : KEY_PREVIEW_WIDTH, width);
+						}
+					});
+				});
+				el.addEventListener("dblclick", () => {
+					this.instant(() => {
+						const width = kind === "explorer" ? 260 : 480;
+						this.layout.update((prev) => kind === "explorer" ? {
+							...prev,
+							explorerWidth: width
+						} : {
+							...prev,
+							previewWidth: width
+						});
+						writeStoredNumber(kind === "explorer" ? KEY_EXPLORER_WIDTH : KEY_PREVIEW_WIDTH, width);
+						this.applyGrid();
+					});
+				});
+				return el;
+			}
+			/** Toggle explorer collapse (width 0, kept mounted; no transition). */
+			toggleExplorer() {
+				const state = this.layout.getSnapshot();
+				const next = !state.explorerCollapsed;
+				this.instant(() => {
+					this.layout.update((prev) => ({
+						...prev,
+						explorerCollapsed: next
+					}));
+					try {
+						localStorage.setItem(`project-panel-collapse:${state.root}`, next ? "collapsed" : "expanded");
+					} catch {}
+					this.applyGrid();
+				});
+			}
+			/** Toggle the preview region (open = tabs exist; close keeps tabs). */
+			setPreviewOpen(open) {
+				this.instant(() => {
+					this.layout.update((prev) => ({
+						...prev,
+						previewOpen: open
+					}));
+					this.applyGrid();
+				});
+			}
+			/**
+			* Locate the shell conversation header: its bottom border is the
+			* horizontal divider under the "Session log" row the button should
+			* sit below. Resolved per call (the shell may mount it late); null when
+			* the shell has no header (standalone installs, desktop variants).
+			*/
+			findHeaderBottom() {
+				const frame = this.frame;
+				if (frame === null) return null;
+				const header = frame.querySelector("[data-pane=\"conversation\"] header, [class*=\"centerCol\"] header");
+				if (header === null) return null;
+				const bottom = header.getBoundingClientRect().bottom;
+				return Number.isFinite(bottom) ? bottom : null;
+			}
+			/** Apply one store update with transitions disabled for exactly one frame. */
+			instant(fn) {
+				const frame = this.frame;
+				if (frame === null) {
+					fn();
+					return;
+				}
+				frame.setAttribute("data-filemgr-instant", "");
+				if (this.instantTimer !== void 0) clearTimeout(this.instantTimer);
+				this.instantTimer = setTimeout(() => {
+					this.instantTimer = void 0;
+					frame.removeAttribute("data-filemgr-instant");
+				}, 0);
+				fn();
+			}
+			/** Re-write the frame grid and reposition handles + floating button. */
+			applyGrid() {
+				const frame = this.frame;
+				if (frame === null) return;
+				if (this.shellTracks.length !== 3) return;
+				const state = this.layout.getSnapshot();
+				const width = this.frameWidth > 0 ? this.frameWidth : frame.getBoundingClientRect().width;
+				if (state.maximized !== null) {
+					this.applyMaximized(frame, state.maximized, width);
+					return;
+				}
+				this.clearMaximizedChrome();
+				const explorer = this.layout.explorerWidthPx(state);
+				const preview = this.layout.previewWidthPx(state);
+				const dshTermCol = parseGridTracks(frame.style.gridTemplateColumns).includes("[dsh-term]") ? frame.querySelector("[data-dsh-term-col]") : null;
+				const dshTermOpen = dshTermCol !== null && dshTermCol.style.display !== "none" && dshTermCol.getBoundingClientRect().width > 0;
+				const dshTermWidth = dshTermOpen ? Math.round(dshTermCol.getBoundingClientRect().width) : 0;
+				const baseGrid = `${this.shellTracks[0]} minmax(0, 1fr) ${this.shellTracks[2]} ${Math.round(preview)}px ${Math.round(explorer)}px`;
+				frame.style.gridTemplateColumns = dshTermOpen ? `${baseGrid} [dsh-term] ${dshTermWidth}px` : baseGrid;
+				if (this.explorerCol !== null) this.explorerCol.style.visibility = explorer > 0 ? "visible" : "hidden";
+				if (this.previewCol !== null) this.previewCol.style.visibility = preview > 0 ? "visible" : "hidden";
+				if (this.explorerHandle !== null) {
+					const left = Math.round(width - explorer - dshTermWidth);
+					this.explorerHandle.style.left = `${left}px`;
+					this.explorerHandle.style.marginLeft = `${-12 / 2}px`;
+					this.explorerHandle.style.display = explorer > 0 && state.root !== "" ? "block" : "none";
+				}
+				if (this.previewHandle !== null) {
+					const left = Math.round(width - explorer - preview - dshTermWidth);
+					this.previewHandle.style.left = `${left}px`;
+					this.previewHandle.style.display = preview > 0 && state.root !== "" ? "block" : "none";
+				}
+				const detailsTrack = trackPx(this.shellTracks[2]);
+				if (this.detailsHandle === null || !this.detailsHandle.isConnected) this.detailsHandle = frame.querySelector("[data-side=\"details\"]");
+				if (this.detailsHandle !== null) this.detailsHandle.style.left = `${Math.round(width - detailsTrack - preview - explorer - dshTermWidth)}px`;
+			}
+			/**
+			* Maximize layout: the target column takes over the whole frame row (the
+			* other tracks collapse to 0px). On narrow viewports the takeover grid is
+			* skipped and the column renders as a fixed full-screen overlay instead
+			* (issue #315). Everything stays mounted — only geometry changes.
+			*/
+			applyMaximized(frame, target, width) {
+				const overlay = maximizedOverlay(this.layout.getSnapshot().availableWidth);
+				if (!overlay) frame.style.gridTemplateColumns = maximizedGridTracks(target, width);
+				if (this.explorerCol !== null) {
+					this.explorerCol.style.visibility = target === "explorer" ? "visible" : "hidden";
+					this.explorerCol.classList.toggle("filemgr-maximized", target === "explorer" && overlay);
+				}
+				if (this.previewCol !== null) {
+					this.previewCol.style.visibility = target === "preview" ? "visible" : "hidden";
+					this.previewCol.classList.toggle("filemgr-maximized", target === "preview" && overlay);
+				}
+				if (this.explorerHandle !== null) this.explorerHandle.style.display = "none";
+				if (this.previewHandle !== null) this.previewHandle.style.display = "none";
+			}
+			/** Remove the narrow-screen overlay class from both columns. */
+			clearMaximizedChrome() {
+				this.explorerCol?.classList.remove("filemgr-maximized");
+				this.previewCol?.classList.remove("filemgr-maximized");
+			}
+			/** Detach everything (plugin unload). */
+			dispose() {
+				this.waitObserver?.disconnect();
+				this.styleObserver?.disconnect();
+				this.sizeObserver?.disconnect();
+				for (const dispose of this.disposers) dispose();
+				this.previewCol?.remove();
+				this.explorerCol?.remove();
+				this.explorerHandle?.remove();
+				this.previewHandle?.remove();
+				if (this.instantTimer !== void 0) clearTimeout(this.instantTimer);
+				if (frameElement === this.frame) frameElement = null;
+				this.frame = null;
+			}
 		};
-		let currentLanguage = "zh";
-		/** Set the active language (the client mirrors the locale service). */
-		function setLanguage(language) {
-			currentLanguage = language === "en" ? "en" : "zh";
-		}
-		/** Translate one key with optional params. */
-		function t(key, params) {
-			const template = (dictionaries[currentLanguage] ?? zh)[key] ?? zh[key];
-			return params === void 0 ? template : format(template, params);
-		}
 		//#endregion
 		//#region src/client/hooks/useStore.ts
 		/**
@@ -4104,7 +4080,7 @@ window.__ModuleLoader__.load({
 		};
 		//#endregion
 		//#region \0dsh-css:src/client/styles/tokens.module.css.mjs
-		const css$4 = ":root{--aion-bg-base:#fff;--aion-bg-1:#f9fafb;--aion-bg-2:#f2f3f5;--aion-bg-3:#e5e6eb;--aion-bg-hover:#f3f4f6;--aion-bg-active:#e5e6eb;--aion-text-primary:#000;--aion-text-secondary:#454d5f;--aion-text-tertiary:#86909c;--aion-text-disabled:#c9cdd4;--aion-primary:#165dff;--aion-success:#00b42a;--aion-warning:#ff7d00;--aion-danger:#f53f3f;--aion-brand:#7583b2;--aion-aou-1:#eff0f6;--aion-aou-2:#e5e7f0;--aion-aou-3:#d1d5e5;--aion-aou-4:#b5bcd6;--aion-aou-5:#97a0c5;--aion-aou-6:#7583b2;--aion-fill-2:#f2f3f5;--aion-fill-3:#e5e6eb;--aion-border-base:#e5e6eb;--aion-overlay-shadow:0 8px 24px #0f172a1f;--aion-font-sans:-apple-system, \"system-ui\", \"Segoe UI\", Roboto, \"Helvetica Neue\", \"PingFang SC\", \"Microsoft YaHei\", sans-serif;--aion-font-mono:ui-monospace, \"SF Mono\", SFMono-Regular, Menlo, Consolas, \"Liberation Mono\", monospace}body[data-ds-dark-theme]{--aion-bg-base:#0e0e0e;--aion-bg-1:#1a1a1a;--aion-bg-2:#262626;--aion-bg-3:#333;--aion-bg-hover:#1f1f1f;--aion-bg-active:#2d2d2d;--aion-text-primary:#fff;--aion-text-secondary:#ced3da;--aion-text-tertiary:#737373;--aion-text-disabled:#737373;--aion-primary:#4d9fff;--aion-success:#23c343;--aion-warning:#ff9a2e;--aion-danger:#f76560;--aion-brand:#a1aacb;--aion-aou-1:#2a2a2a;--aion-aou-2:#3d4150;--aion-aou-3:#525a77;--aion-aou-4:#6a749b;--aion-aou-5:#838fba;--aion-aou-6:#a1aacb;--aion-fill-2:#ffffff14;--aion-fill-3:#ffffff1f;--aion-border-base:#333;--aion-overlay-shadow:0 12px 32px #00000073;color-scheme:dark}.filemgr-root{font-family:var(--aion-font-sans);color:var(--aion-text-primary);background-color:var(--aion-bg-1);font-size:13px}.filemgr-root *,.filemgr-root :before,.filemgr-root :after{box-sizing:border-box}.filemgr-root ::-webkit-scrollbar{width:8px;height:8px}.filemgr-root ::-webkit-scrollbar-thumb{background:var(--aion-bg-3);border-radius:4px}.filemgr-root ::-webkit-scrollbar-thumb:hover{background:var(--aion-bg-4,#c9cdd4)}.filemgr-root ::-webkit-scrollbar-track{background:0 0}@media (prefers-reduced-motion:reduce){.filemgr-root *,.filemgr-root :before,.filemgr-root :after{transition:none!important;animation:none!important}}[data-dsh-frame][data-filemgr-instant]{transition:none!important}.filemgr-preview-col,.filemgr-explorer-col{background-color:var(--aion-bg-1);z-index:30;flex-direction:column;min-width:0;display:flex;overflow:hidden}.filemgr-preview-col{border-left:1px solid var(--aion-bg-3)}.filemgr-preview-col.filemgr-maximized,.filemgr-explorer-col.filemgr-maximized{z-index:60;inset:0;position:fixed!important}.filemgr-explorer-col{border-left:1px solid var(--aion-bg-3)}.filemgr-preview-col.filemgr-preview-enter{animation:.25s cubic-bezier(.4,0,.2,1) aPVr2q_filemgr-preview-enter}@keyframes aPVr2q_filemgr-preview-enter{0%{opacity:0;transform:translate(20px)}to{opacity:1;transform:translate(0)}}.filemgr-explorer-handle,.filemgr-preview-handle{touch-action:none}.filemgr-explorer-handle:after,.filemgr-preview-handle:after{content:\"\";background-color:var(--aion-bg-3);opacity:.9;pointer-events:none;border-radius:9999px;width:2px;transition:width .15s cubic-bezier(.4,0,.2,1),background-color .15s cubic-bezier(.4,0,.2,1);position:absolute;top:0;bottom:0;left:0}.filemgr-explorer-handle:hover:after,.filemgr-explorer-handle:active:after,.filemgr-preview-handle:hover:after,.filemgr-preview-handle:active:after{background-color:var(--aion-brand);width:6px}.filemgr-preview-handle:after{opacity:.3;left:auto;right:0}.filemgr-preview-handle:hover:after,.filemgr-preview-handle:active:after{opacity:1}.filemgr-floating-expand{top:calc(6px + env(aPVr2q_titlebar-area-height,0px));background-color:var(--aion-bg-2);width:24px;height:24px;color:var(--aion-text-secondary);cursor:pointer;z-index:100;border:none;border-radius:4px;justify-content:center;align-items:center;transition:background-color .15s cubic-bezier(.4,0,.2,1);display:none;position:fixed;right:8px;box-shadow:0 2px 8px #0000001f}.filemgr-floating-expand:hover{background-color:var(--aion-bg-3);color:var(--aion-text-primary)}.filemgr-floating-expand:active{background-color:var(--aion-bg-active)}.filemgr-floating-expand:focus-visible{outline:2px solid var(--aion-primary);outline-offset:2px}.filemgr-collapse-chevron{top:calc(6px + env(aPVr2q_titlebar-area-height,0px));z-index:30;width:24px;height:24px;color:var(--aion-text-secondary);cursor:pointer;background:0 0;border:none;border-radius:4px;justify-content:center;align-items:center;transition:background-color .15s cubic-bezier(.4,0,.2,1);display:flex;position:absolute;right:8px}.filemgr-collapse-chevron:hover{background-color:var(--aion-bg-3);color:var(--aion-text-primary)}.filemgr-collapse-chevron:active{background-color:var(--aion-bg-active)}.filemgr-collapse-chevron:focus-visible{outline:2px solid var(--aion-primary);outline-offset:2px}.filemgr-overlay{z-index:1000;background:#00000059;justify-content:center;align-items:center;display:flex;position:fixed;inset:0}.filemgr-dialog{background:var(--aion-bg-base);width:400px;max-width:calc(100vw - 48px);box-shadow:var(--aion-overlay-shadow);font-family:var(--aion-font-sans);border-radius:16px;overflow:hidden}.filemgr-dialog-title{color:var(--aion-text-primary);padding:16px 20px 8px;font-size:14px;font-weight:600}.filemgr-dialog-body{color:var(--aion-text-secondary);padding:0 20px;font-size:13px;line-height:1.6}.filemgr-dialog-actions{justify-content:flex-end;gap:8px;padding:16px 20px 20px;display:flex}.filemgr-btn{border:1px solid var(--aion-bg-3);background:var(--aion-bg-base);height:28px;color:var(--aion-text-primary);cursor:pointer;border-radius:4px;padding:0 14px;font-size:13px;transition:background-color .15s cubic-bezier(.4,0,.2,1)}.filemgr-btn:hover{background:var(--aion-bg-hover)}.filemgr-btn:active{background:var(--aion-bg-active)}.filemgr-btn:focus-visible{outline:2px solid var(--aion-primary);outline-offset:2px}.filemgr-btn-primary{background:var(--aion-primary);border-color:var(--aion-primary);color:#fff}.filemgr-btn-primary:hover{background:var(--aion-primary);opacity:.9}.filemgr-btn-primary:active{opacity:.75;filter:saturate(.9)}.filemgr-btn-danger{background:var(--aion-danger);border-color:var(--aion-danger);color:#fff}.filemgr-btn-danger:hover{opacity:.9}.filemgr-btn-danger:active{opacity:.75}.filemgr-menu{z-index:1100;background:var(--aion-bg-base);min-width:160px;box-shadow:var(--aion-overlay-shadow);border:1px solid var(--aion-bg-3);font-family:var(--aion-font-sans);border-radius:8px;padding:4px;position:fixed}.filemgr-menu-item{height:28px;color:var(--aion-text-primary);cursor:pointer;white-space:nowrap;border-radius:4px;align-items:center;padding:0 10px;font-size:13px;display:flex}.filemgr-menu-item:hover{background:var(--aion-fill-2)}.filemgr-menu-item:focus-visible{outline:2px solid var(--aion-primary);outline-offset:-2px}.filemgr-menu-item-disabled{color:var(--aion-text-disabled);cursor:default}.filemgr-menu-item-disabled:hover{background:0 0}.filemgr-menu-sep{background:var(--aion-bg-3);height:1px;margin:4px 8px}.filemgr-input{border:1px solid var(--aion-bg-3);background:var(--aion-bg-base);width:100%;height:32px;color:var(--aion-text-primary);font-size:13px;font-family:var(--aion-font-sans);box-sizing:border-box;border-radius:6px;outline:none;padding:0 10px}.filemgr-input:focus{border-color:var(--aion-primary)}.filemgr-toast{z-index:1200;background:var(--aion-bg-base);max-width:70vw;color:var(--aion-text-primary);font-size:13px;font-family:var(--aion-font-sans);box-shadow:var(--aion-overlay-shadow);border:1px solid var(--aion-bg-3);border-radius:6px;padding:8px 14px;animation:.2s cubic-bezier(.4,0,.2,1) aPVr2q_filemgr-toast-in;position:fixed;bottom:32px;left:50%;transform:translate(-50%)}@keyframes aPVr2q_filemgr-toast-in{0%{opacity:0;transform:translate(-50%)translateY(8px)}to{opacity:1;transform:translate(-50%)translateY(0)}}";
+		const css$4 = ":root{--aion-bg-base:#fff;--aion-bg-1:#f9fafb;--aion-bg-2:#f2f3f5;--aion-bg-3:#e5e6eb;--aion-bg-hover:#f3f4f6;--aion-bg-active:#e5e6eb;--aion-text-primary:#000;--aion-text-secondary:#454d5f;--aion-text-tertiary:#86909c;--aion-text-disabled:#c9cdd4;--aion-primary:#165dff;--aion-success:#00b42a;--aion-warning:#ff7d00;--aion-danger:#f53f3f;--aion-brand:#7583b2;--aion-aou-1:#eff0f6;--aion-aou-2:#e5e7f0;--aion-aou-3:#d1d5e5;--aion-aou-4:#b5bcd6;--aion-aou-5:#97a0c5;--aion-aou-6:#7583b2;--aion-fill-2:#f2f3f5;--aion-fill-3:#e5e6eb;--aion-border-base:#e5e6eb;--aion-overlay-shadow:0 8px 24px #0f172a1f;--aion-font-sans:-apple-system, \"system-ui\", \"Segoe UI\", Roboto, \"Helvetica Neue\", \"PingFang SC\", \"Microsoft YaHei\", sans-serif;--aion-font-mono:ui-monospace, \"SF Mono\", SFMono-Regular, Menlo, Consolas, \"Liberation Mono\", monospace}body[data-ds-dark-theme]{--aion-bg-base:#0e0e0e;--aion-bg-1:#1a1a1a;--aion-bg-2:#262626;--aion-bg-3:#333;--aion-bg-hover:#1f1f1f;--aion-bg-active:#2d2d2d;--aion-text-primary:#fff;--aion-text-secondary:#ced3da;--aion-text-tertiary:#737373;--aion-text-disabled:#737373;--aion-primary:#4d9fff;--aion-success:#23c343;--aion-warning:#ff9a2e;--aion-danger:#f76560;--aion-brand:#a1aacb;--aion-aou-1:#2a2a2a;--aion-aou-2:#3d4150;--aion-aou-3:#525a77;--aion-aou-4:#6a749b;--aion-aou-5:#838fba;--aion-aou-6:#a1aacb;--aion-fill-2:#ffffff14;--aion-fill-3:#ffffff1f;--aion-border-base:#333;--aion-overlay-shadow:0 12px 32px #00000073;color-scheme:dark}.filemgr-root{font-family:var(--aion-font-sans);color:var(--aion-text-primary);background-color:var(--aion-bg-1);font-size:13px}.filemgr-root *,.filemgr-root :before,.filemgr-root :after{box-sizing:border-box}.filemgr-root ::-webkit-scrollbar{width:8px;height:8px}.filemgr-root ::-webkit-scrollbar-thumb{background:var(--aion-bg-3);border-radius:4px}.filemgr-root ::-webkit-scrollbar-thumb:hover{background:var(--aion-bg-4,#c9cdd4)}.filemgr-root ::-webkit-scrollbar-track{background:0 0}@media (prefers-reduced-motion:reduce){.filemgr-root *,.filemgr-root :before,.filemgr-root :after{transition:none!important;animation:none!important}}[data-dsh-frame][data-filemgr-instant]{transition:none!important}.filemgr-preview-col,.filemgr-explorer-col{background-color:var(--aion-bg-1);z-index:30;flex-direction:column;min-width:0;display:flex;overflow:hidden}.filemgr-preview-col{border-left:1px solid var(--aion-bg-3)}.filemgr-preview-col.filemgr-maximized,.filemgr-explorer-col.filemgr-maximized{z-index:60;inset:0;position:fixed!important}.filemgr-explorer-col{border-left:1px solid var(--aion-bg-3)}.filemgr-preview-col.filemgr-preview-enter{animation:.25s cubic-bezier(.4,0,.2,1) aPVr2q_filemgr-preview-enter}@keyframes aPVr2q_filemgr-preview-enter{0%{opacity:0;transform:translate(20px)}to{opacity:1;transform:translate(0)}}.filemgr-explorer-handle,.filemgr-preview-handle{touch-action:none;cursor:col-resize}.filemgr-collapse-chevron{top:calc(6px + env(aPVr2q_titlebar-area-height,0px));z-index:30;width:24px;height:24px;color:var(--aion-text-secondary);cursor:pointer;background:0 0;border:none;border-radius:4px;justify-content:center;align-items:center;transition:background-color .15s cubic-bezier(.4,0,.2,1);display:flex;position:absolute;right:8px}.filemgr-collapse-chevron:hover{background-color:var(--aion-bg-3);color:var(--aion-text-primary)}.filemgr-collapse-chevron:active{background-color:var(--aion-bg-active)}.filemgr-collapse-chevron:focus-visible{outline:2px solid var(--aion-primary);outline-offset:2px}.filemgr-overlay{z-index:1000;background:#00000059;justify-content:center;align-items:center;display:flex;position:fixed;inset:0}.filemgr-dialog{background:var(--aion-bg-base);width:400px;max-width:calc(100vw - 48px);box-shadow:var(--aion-overlay-shadow);font-family:var(--aion-font-sans);border-radius:16px;overflow:hidden}.filemgr-dialog-title{color:var(--aion-text-primary);padding:16px 20px 8px;font-size:14px;font-weight:600}.filemgr-dialog-body{color:var(--aion-text-secondary);padding:0 20px;font-size:13px;line-height:1.6}.filemgr-dialog-actions{justify-content:flex-end;gap:8px;padding:16px 20px 20px;display:flex}.filemgr-btn{border:1px solid var(--aion-bg-3);background:var(--aion-bg-base);height:28px;color:var(--aion-text-primary);cursor:pointer;border-radius:4px;padding:0 14px;font-size:13px;transition:background-color .15s cubic-bezier(.4,0,.2,1)}.filemgr-btn:hover{background:var(--aion-bg-hover)}.filemgr-btn:active{background:var(--aion-bg-active)}.filemgr-btn:focus-visible{outline:2px solid var(--aion-primary);outline-offset:2px}.filemgr-btn-primary{background:var(--aion-primary);border-color:var(--aion-primary);color:#fff}.filemgr-btn-primary:hover{background:var(--aion-primary);opacity:.9}.filemgr-btn-primary:active{opacity:.75;filter:saturate(.9)}.filemgr-btn-danger{background:var(--aion-danger);border-color:var(--aion-danger);color:#fff}.filemgr-btn-danger:hover{opacity:.9}.filemgr-btn-danger:active{opacity:.75}.filemgr-menu{z-index:1100;background:var(--aion-bg-base);min-width:160px;box-shadow:var(--aion-overlay-shadow);border:1px solid var(--aion-bg-3);font-family:var(--aion-font-sans);border-radius:8px;padding:4px;position:fixed}.filemgr-menu-item{height:28px;color:var(--aion-text-primary);cursor:pointer;white-space:nowrap;border-radius:4px;align-items:center;padding:0 10px;font-size:13px;display:flex}.filemgr-menu-item:hover{background:var(--aion-fill-2)}.filemgr-menu-item:focus-visible{outline:2px solid var(--aion-primary);outline-offset:-2px}.filemgr-menu-item-disabled{color:var(--aion-text-disabled);cursor:default}.filemgr-menu-item-disabled:hover{background:0 0}.filemgr-menu-sep{background:var(--aion-bg-3);height:1px;margin:4px 8px}.filemgr-input{border:1px solid var(--aion-bg-3);background:var(--aion-bg-base);width:100%;height:32px;color:var(--aion-text-primary);font-size:13px;font-family:var(--aion-font-sans);box-sizing:border-box;border-radius:6px;outline:none;padding:0 10px}.filemgr-input:focus{border-color:var(--aion-primary)}.filemgr-toast{z-index:1200;background:var(--aion-bg-base);max-width:70vw;color:var(--aion-text-primary);font-size:13px;font-family:var(--aion-font-sans);box-shadow:var(--aion-overlay-shadow);border:1px solid var(--aion-bg-3);border-radius:6px;padding:8px 14px;animation:.2s cubic-bezier(.4,0,.2,1) aPVr2q_filemgr-toast-in;position:fixed;bottom:32px;left:50%;transform:translate(-50%)}@keyframes aPVr2q_filemgr-toast-in{0%{opacity:0;transform:translate(-50%)translateY(8px)}to{opacity:1;transform:translate(-50%)translateY(0)}}";
 		const tagId$4 = "@lijian-ui/dsh-file-manager/tokens.module.css";
 		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId$4) + "]") === null) {
 			const tag = document.createElement("style");
@@ -6195,7 +6171,7 @@ window.__ModuleLoader__.load({
 						onClick: handleAddToChat,
 						role: "button",
 						tabIndex: -1,
-						children: "添加到对话"
+						children: t("preview.addToChat")
 					}),
 					closingIds !== null && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ConfirmDialog, {
 						title: t("preview.closeConfirmTitle"),
@@ -6220,6 +6196,15 @@ window.__ModuleLoader__.load({
 		* failure degrades the panels, never the GUI boot.
 		* @module dsh-filemgr/client/mount
 		*/
+		/**
+		* Wrapper that subscribes to locale revision so createRoot-mounted panels
+		* re-render on language switch (slot outlets do this automatically via
+		* useLocaleRevision; createRoot trees must opt in explicitly).
+		*/
+		function LocaleAwareRoot({ children, locale }) {
+			(0, react.useSyncExternalStore)((cb) => locale.subscribe(cb), () => locale.getSnapshot().revision);
+			return children;
+		}
 		const EXPLORER_COL_SELECTOR = "[data-filemgr-explorer-col]";
 		const PREVIEW_COL_SELECTOR = "[data-filemgr-preview-col]";
 		/** Wait for one selector (the shell/frame mounts after boot settlement). */
@@ -6258,23 +6243,29 @@ window.__ModuleLoader__.load({
 		*   a preview selection (path + start/end line).
 		* @returns a disposer unmounting both trees.
 		*/
-		function mountPanels(stores, onToggleExplorer, onReference, onAddFileReference) {
+		function mountPanels(stores, onToggleExplorer, onReference, onAddFileReference, locale) {
 			let explorerRoot;
 			let previewRoot;
 			const disposers = [];
 			disposers.push(waitForElement(EXPLORER_COL_SELECTOR, (el) => {
 				explorerRoot = (0, react_dom_client.createRoot)(el);
-				explorerRoot.render(/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ExplorerPanel, {
-					stores,
-					onToggleCollapse: onToggleExplorer,
-					onReference
+				explorerRoot.render(/* @__PURE__ */ (0, react_jsx_runtime.jsx)(LocaleAwareRoot, {
+					locale,
+					children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ExplorerPanel, {
+						stores,
+						onToggleCollapse: onToggleExplorer,
+						onReference
+					})
 				}));
 			}));
 			disposers.push(waitForElement(PREVIEW_COL_SELECTOR, (el) => {
 				previewRoot = (0, react_dom_client.createRoot)(el);
-				previewRoot.render(/* @__PURE__ */ (0, react_jsx_runtime.jsx)(PreviewPanel, {
-					stores,
-					onAddFileReference
+				previewRoot.render(/* @__PURE__ */ (0, react_jsx_runtime.jsx)(LocaleAwareRoot, {
+					locale,
+					children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(PreviewPanel, {
+						stores,
+						onAddFileReference
+					})
 				}));
 			}));
 			return () => {
@@ -6852,11 +6843,11 @@ window.__ModuleLoader__.load({
 					}), isDir && isOpen && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", { children: isLoading ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 						className: picker_module_css_default.note,
 						style: { paddingLeft: 8 + (depth + 1) * 16 },
-						children: "加载中…"
+						children: t("picker.loading")
 					}) : children.length === 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 						className: picker_module_css_default.note,
 						style: { paddingLeft: 8 + (depth + 1) * 16 },
-						children: "（空目录）"
+						children: t("picker.emptyDir")
 					}) : children.map((child) => renderNode(child, depth + 1)) })] }, entry.path);
 				};
 				return renderNode;
@@ -6891,12 +6882,12 @@ window.__ModuleLoader__.load({
 									className: picker_module_css_default.titleRow,
 									children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 										className: picker_module_css_default.title,
-										children: "引用项目文件"
+										children: t("picker.title")
 									}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 										type: "button",
 										className: picker_module_css_default.closeBtn,
 										onClick: onClose,
-										"aria-label": "关闭",
+										"aria-label": t("picker.closeAria"),
 										children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CloseIcon, { size: 16 })
 									})]
 								}),
@@ -6909,7 +6900,7 @@ window.__ModuleLoader__.load({
 										}),
 										/* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
 											className: picker_module_css_default.searchInput,
-											placeholder: "搜索工作区文件…",
+											placeholder: t("picker.searchPlaceholder"),
 											value: search,
 											onChange: (e) => setSearch(e.target.value),
 											autoFocus: true
@@ -6918,7 +6909,7 @@ window.__ModuleLoader__.load({
 											type: "button",
 											className: picker_module_css_default.searchClear,
 											onClick: () => setSearch(""),
-											"aria-label": "清空",
+											"aria-label": t("picker.clearAria"),
 											children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CloseIcon, { size: 13 })
 										})
 									]
@@ -6934,10 +6925,10 @@ window.__ModuleLoader__.load({
 							className: picker_module_css_default.body,
 							children: searchResults !== null ? searching ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 								className: picker_module_css_default.note,
-								children: "搜索中…"
+								children: t("explorer.search.searching")
 							}) : searchResults.length === 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 								className: picker_module_css_default.note,
-								children: "没有匹配的文件"
+								children: t("explorer.search.empty")
 							}) : searchResults.map((hit) => {
 								const isSel = selected.has(hit.path);
 								return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
@@ -6969,10 +6960,10 @@ window.__ModuleLoader__.load({
 								}, hit.path);
 							}) : rootLoading ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 								className: picker_module_css_default.note,
-								children: "加载中…"
+								children: t("picker.loading")
 							}) : rootEntries.length === 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 								className: picker_module_css_default.note,
-								children: "（空目录）"
+								children: t("picker.emptyDir")
 							}) : rootEntries.map((entry) => tree(entry, 0))
 						}),
 						/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
@@ -6981,7 +6972,7 @@ window.__ModuleLoader__.load({
 								className: picker_module_css_default.chips,
 								children: selectedList.length === 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 									className: picker_module_css_default.chipsEmpty,
-									children: "选择文件或目录（可多选）"
+									children: t("picker.emptySelection")
 								}) : selectedList.map((pick) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
 									className: picker_module_css_default.chip,
 									children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", { children: [
@@ -6992,7 +6983,7 @@ window.__ModuleLoader__.load({
 										type: "button",
 										className: picker_module_css_default.chipX,
 										onClick: () => toggleSelect(pick.path, pick.isDir),
-										"aria-label": "移除",
+										"aria-label": t("picker.removeAria"),
 										children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CloseIcon, { size: 11 })
 									})]
 								}, pick.path))
@@ -7002,13 +6993,13 @@ window.__ModuleLoader__.load({
 									type: "button",
 									className: picker_module_css_default.cancelBtn,
 									onClick: onClose,
-									children: "取消"
+									children: t("common.cancel")
 								}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
 									type: "button",
 									className: picker_module_css_default.insertBtn,
 									disabled: selectedList.length === 0,
 									onClick: () => onInsert(selectedList),
-									children: ["插入", selectedList.length > 0 ? ` (${selectedList.length})` : ""]
+									children: [t("picker.insert"), selectedList.length > 0 ? ` (${selectedList.length})` : ""]
 								})]
 							})]
 						})
@@ -7339,6 +7330,75 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		//#endregion
+		//#region src/client/DockItem.tsx
+		const STYLE_ID = "dsh-dock-item-style";
+		function ensureStyle() {
+			if (typeof document === "undefined") return;
+			if (document.getElementById(STYLE_ID) !== null) return;
+			const tag = document.createElement("style");
+			tag.id = STYLE_ID;
+			tag.textContent = ".dsh-dock-item{width:32px;height:32px;border:none;border-radius:9999px;background:#000;color:#fff;cursor:pointer;position:relative;transition:transform .15s ease,background .18s ease;display:inline-flex;align-items:center;justify-content:center}.dsh-dock-item:hover{transform:scale(1.15);background:#1a1a1a}.dsh-dock-item-active{background:var(--aion-primary,#6ea0ff)}.dsh-dock-tooltip{position:absolute;top:calc(100% + 6px);left:50%;transform:translateX(-50%);padding:2px 8px;font-size:12px;line-height:1.4;white-space:nowrap;color:#fff;background:rgba(20,20,30,.9);border:1px solid rgba(255,255,255,.12);border-radius:6px;opacity:0;pointer-events:none;transition:opacity .15s}.dsh-dock-item:hover .dsh-dock-tooltip{opacity:1}";
+			document.head.appendChild(tag);
+		}
+		ensureStyle();
+		function DockItem(props) {
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
+				type: "button",
+				className: `dsh-dock-item${props.active ? " dsh-dock-item-active" : ""}`,
+				onClick: props.onClick,
+				"aria-label": props.label,
+				"aria-pressed": props.active,
+				title: props.label,
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+					className: "dsh-dock-tooltip",
+					children: props.label
+				}), props.children]
+			});
+		}
+		//#endregion
+		//#region src/client/FilePanelDockItem.tsx
+		/**
+		* FilePanelDockItem — the file-panel dock button rendered into the conversation
+		* session header (the `conversation.session.header.utilities` slot).
+		*
+		* This plugin owns its own dock button independently: dsh-term renders its own
+		* terminal button, dsh-file-manager renders this file-panel button. The two
+		* are fully decoupled — install either alone and you get just its button;
+		* install both and both buttons appear side by side with shared magnification.
+		*
+		* Clicking broadcasts `dsh-dock:toggle-filepanel` (handled in dsh-file-manager
+		* index); the open state is mirrored back through `dsh-dock:filepanel-state`.
+		* @module dsh-file-manager/client/FilePanelDockItem
+		*/
+		const EV = {
+			toggleFile: "dsh-dock:toggle-filepanel",
+			fileState: "dsh-dock:filepanel-state"
+		};
+		function FilePanelDockItem() {
+			const [active, setActive] = (0, react.useState)(false);
+			(0, react.useEffect)(() => {
+				const onState = (e) => setActive(Boolean(e.detail));
+				window.addEventListener(EV.fileState, onState);
+				return () => window.removeEventListener(EV.fileState, onState);
+			}, []);
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(DockItem, {
+				active,
+				label: t("dock.filePanel.label"),
+				onClick: () => window.dispatchEvent(new CustomEvent(EV.toggleFile)),
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("svg", {
+					width: "16",
+					height: "16",
+					viewBox: "0 0 24 24",
+					fill: "none",
+					stroke: "currentColor",
+					strokeWidth: "2",
+					strokeLinecap: "round",
+					strokeLinejoin: "round",
+					children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "m6 14 1.45-2.9a2 2 0 0 1 1.79-1.1h11.76a2 2 0 0 1 1.94 1.5l1.55 6a2 2 0 0 1-1.94 2.5H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h3.5a2 2 0 0 1 1.59.79l.91 1.21a2 2 0 0 0 1.59.79H18a2 2 0 0 1 2 2v2" })
+				})
+			});
+		}
+		//#endregion
 		//#region src/client/index.ts
 		/**
 		* FileManager right-panel system — browser half: mounts the explorer and preview
@@ -7365,7 +7425,16 @@ window.__ModuleLoader__.load({
 		const panelApi = new PanelApi();
 		/** Apply the browser half. */
 		function apply(ctx) {
+			ctx.inject(["slots"], (scope) => {
+				scope.slots.inject("conversation.session.header.utilities", () => scope.slots.register({
+					name: "conversation.session.header.utilities",
+					id: "filemgr-dock-item",
+					order: -2,
+					inject: () => ({})
+				}, FilePanelDockItem));
+			});
 			ctx.effect(() => ctx.locale.register(NS, dictionaries), "dsh-filemgr: dictionaries");
+			bindT(ctx.locale.bind(NS));
 			ctx.effect(() => registerFileReferenceSource(ctx), "dsh-filemgr: file reference source");
 			ctx.inject([
 				"slots",
@@ -7561,7 +7630,7 @@ window.__ModuleLoader__.load({
 					syncLanguage();
 					try {
 						layout.mount();
-						mountPanels(stores, () => layout.toggleExplorer(), onReference, onAddFileReference);
+						mountPanels(stores, () => layout.toggleExplorer(), onReference, onAddFileReference, ctx.locale);
 					} catch (error) {
 						console.error("[dsh-filemgr] mount failed:", error);
 					}