dsh-calorie 0.3.3 → 0.3.5

package/dist/client.js

@@ -186,6 +186,678 @@ window.__ModuleLoader__.load({
 		/** 宿主目录选择命名空间的服务名（#736；出处与禁令见 cookbook §13）。 */
 		const REMOTE_DIRECTORY_PICKER = "remote.directoryPicker";
 		//#endregion
+		//#region ../plugin-manager/dist/directory-browser-contract.js
+		/** 目录浏览器的纯逻辑半（**不认识宿主**：只认两格原语）。
+		*
+		* 为什么在这里：六个单品插件的设置页各有一批「值是一个目录」的行，它们要的界面是同一个东西。
+		* 界面的**取数**来自宿主给的两个原语（`list`／`createDirectory`），而这两个原语的形状是**调用方喂进来的**
+		* ——本件不 import 宿主的任何实现，也不认识 `remote.directoryPicker` 这个名字（那两件住在各家的
+		* `dsh-ctx.ts` 镜像里）。于是本件在 Windows 桌面、远程浏览器、SSH 三种部署下是同一份代码。
+		*
+		* 装什么：本次要浏览的那一层怎么走（进子目录／回上一级／跳面包屑）、路径怎么切出「目录部分」与
+		* 「筛选词」、回执怎么认。**不装**任何 IO、不装任何持久化——`list`／`createDirectory` 由调用方执行。
+		*
+		* 与平台自带浏览器件的关系：`@deepseek-ai/dsh-client-ui-directory-picker-browse` 的 `DirectoryBrowser`
+		* 是包内私有件（只经 `ui-workspace` 的流程空位暴露），插件侧取不到，所以这里是一份独立实现，
+		* 只对齐它的**交互结果**（进/选/新建），不对齐它的 DOM。
+		*/
+		/** 认一认某个值是不是可用的目录取数面（软依赖守卫用：认不出就当没有，绝不把页面带下来）。 */
+		function isBrowseFace(raw) {
+			if (typeof raw !== "object" || raw === null) return false;
+			const face = raw;
+			return typeof face.list === "function" && typeof face.createDirectory === "function";
+		}
+		/** 认一认某个值有没有 `pick`（对应宿主 composition 里的 `native` 能力）。 */
+		function hasPickFn(raw) {
+			if (typeof raw !== "object" || raw === null) return false;
+			return typeof raw.pick === "function";
+		}
+		/** 三态判定：先 native（有 pick），再 browse（有两格原语），都没有＝`none`。 */
+		function pickerModeOf$1(raw) {
+			if (hasPickFn(raw)) return "native";
+			return isBrowseFace(raw) ? "browse" : "none";
+		}
+		/** 平台回执 → 三态（**永不抛**）：成功回的是信封里的 `value` 不是路径；`ok:false` 是「供不了」不是「取消」。
+		*
+		* 出处：`@deepseek-ai/dsh-api-gateway/lib/client.js` 的 `invoke()`（失败不抛、成功也不回裸值），
+		* 第一方消费方 `@deepseek-ai/dsh-client-ui-workspace/lib/client.js:99-103` 就照这个信封拆。
+		* 裸串照收（老形状兜底），认不出的形状当「供不了」报出来，不当取消吞掉（#743 的教训）。 */
+		function readPickAnswer$1(raw) {
+			if (typeof raw === "string") return raw.trim() === "" ? { kind: "cancelled" } : {
+				kind: "picked",
+				path: raw
+			};
+			const answer = typeof raw === "object" && raw !== null ? raw : {};
+			if (answer.ok === true) {
+				const value = answer.value;
+				return typeof value === "string" && value.trim() !== "" ? {
+					kind: "picked",
+					path: value
+				} : { kind: "cancelled" };
+			}
+			const detail = answer.error?.message?.trim() ?? "";
+			return {
+				kind: "unavailable",
+				message: "打不开系统文件夹对话框" + (detail === "" ? "" : "（" + detail + "）") + "：请直接在框里填绝对路径。"
+			};
+		}
+		/** 一段路径里最后那个分隔符的位置（Windows 上 `\` 与 `/` 都算；POSIX 上 `\` 是合法文件名字符，不算）。 */
+		function lastSeparator(path) {
+			const back = path.lastIndexOf("\\");
+			const slash = path.lastIndexOf("/");
+			return back > slash ? back : slash;
+		}
+		/** 上一层：`'C:\\a\\b\\'` → `'C:\\a'`；已经是根则回自身；相对名（没有任何分隔符）也回自身。
+		*
+		* 尾分隔符先吃掉再切——否则「回上一级」会在原地打转。**盘根单独认**：`C:\` 掐掉尾分隔符会剩成
+		* `C:`，而 `C:` 是「当前盘」不是「上一层」，回它就会多跑一趟、还可能跨到别的盘上去。
+		* UNC（`\\server\share`）不特殊处理：切到头就是共享名本身，浏览停在共享根。 */
+		function parentOf(path) {
+			const trimmed = path.replace(/[\\/]+$/, "");
+			if (trimmed === "") return path;
+			const sep = path.includes("\\") ? "\\" : "/";
+			if (/^[A-Za-z]:$/.test(trimmed)) return trimmed + sep;
+			const cut = lastSeparator(trimmed);
+			if (cut === -1) return trimmed;
+			if (cut === 0) return path.slice(0, 1);
+			if (cut === 2 && /^[A-Za-z]:/.test(trimmed)) return trimmed.slice(0, 2) + sep;
+			return trimmed.slice(0, cut);
+		}
+		/** 一层列举里，哪些行可进：隐藏目录按开关过滤，其余照宿主给的顺序。 */
+		function visibleEntries(listing, showHidden) {
+			return showHidden ? listing.entries : listing.entries.filter((entry) => !entry.hidden);
+		}
+		/** 这一层有多少个被藏起来的目录（用来决定「显示隐藏目录」那个开关要不要出现在图上）。 */
+		function hiddenCount(listing) {
+			return listing.entries.filter((entry) => entry.hidden).length;
+		}
+		/** 拿一段文本按「最后一个分隔符」切成「目录部分 ＋ 筛选词」。
+		*
+		* 没打过任何分隔符时目录部分＝null（那段文字还不指任何目录，只当筛选词用）。
+		* Windows 上 `/` 也当分隔符（宿主那边两种都收），POSIX 上不。 */
+		function splitDraft(draft) {
+			const cut = lastSeparator(draft);
+			if (cut === -1) return {
+				directory: null,
+				filter: draft
+			};
+			return {
+				directory: draft.slice(0, cut + 1),
+				filter: draft.slice(cut + 1)
+			};
+		}
+		/** 按筛选词过一层目录（大小写不敏感；空筛选词＝全留）。 */
+		function filterEntries(entries, filter) {
+			const needle = filter.trim().toLowerCase();
+			if (needle === "") return entries;
+			return entries.filter((entry) => entry.name.toLowerCase().includes(needle));
+		}
+		/** 给界面用的一句话位置说明：优先显示相对 home 的说法，省得整条绝对路径占满一行。 */
+		function locationLabel(listing) {
+			const home = listing.home.replace(/[\\/]+$/, "");
+			if (home !== "" && listing.path !== home && listing.path.startsWith(home)) {
+				const tail = listing.path.slice(home.length).replace(/^[\\/]+/, "");
+				if (tail !== "") return "~" + (listing.path.includes("\\") ? "\\" : "/") + tail;
+			}
+			return listing.path;
+		}
+		/** 新建文件夹的名字合不合法（单个路径段：不许分隔符、不许空、不许 `.`／`..`）。
+		*
+		* 与宿主 browse 后端的校验同口径——这里先拦一道，是为了在图上给得出人话，不是替代宿主校验。 */
+		function validateFolderName(name) {
+			const trimmed = name.trim();
+			if (trimmed === "") return {
+				ok: false,
+				reason: "文件夹名不能为空。"
+			};
+			if (/[\\/]/.test(trimmed)) return {
+				ok: false,
+				reason: "文件夹名里不能带路径分隔符。"
+			};
+			if (trimmed === "." || trimmed === "..") return {
+				ok: false,
+				reason: "「.」与「..」不是文件夹名。"
+			};
+			return { ok: true };
+		}
+		//#endregion
+		//#region ../plugin-manager/dist/directory-browser-state.js
+		/** 文件浏览器的操作半：把「进哪一层、这一层显示什么、选到了什么」算成状态，**IO 全部由调用方注入**。
+		*
+		* 分两层的原因：本件（操作）在 Node 里就能直测——喂一个假的取数面，就能把「进目录／回上一级／
+		* 跳面包屑／筛选／新建文件夹／失败出人话」全跑一遍；视图那半（`directory-browser-ui.ts`）
+		* 只负责把这份状态画成 DOM。两边都不认识宿主。
+		*
+		* 数据来源只有两格：`list(path?)` 与 `createDirectory(path, name)`（调用方注入的 `DirectoryBrowseFace`）。
+		*/
+		/** 建一个浏览器控制器。取数、回调、初值全部由调用方给。 */
+		function createBrowseController(deps) {
+			const label = deps.failureLabel ?? "浏览失败";
+			const listeners = /* @__PURE__ */ new Set();
+			let state = {
+				phase: "idle",
+				listing: null,
+				failure: null,
+				selected: null,
+				showHidden: false,
+				draft: deps.initialPath,
+				filter: "",
+				creating: null,
+				notice: null
+			};
+			/** 每次列举带一个序号：晚回来的旧回执直接丢掉，不许覆盖新一层。 */
+			let generation = 0;
+			const emit = (next) => {
+				state = {
+					...state,
+					...next
+				};
+				for (const listener of [...listeners]) listener(state);
+			};
+			const humanize = (cause) => {
+				const raw = typeof cause === "object" && cause !== null ? cause : {};
+				const message = typeof raw.message === "string" && raw.message.trim() !== "" ? raw.message.trim() : String(cause);
+				return {
+					code: typeof raw.code === "string" && raw.code !== "" ? raw.code : "browse-failed",
+					message: `${label}：${message}`
+				};
+			};
+			const load = async (path) => {
+				const mine = ++generation;
+				emit({
+					phase: "loading",
+					failure: null,
+					notice: null
+				});
+				try {
+					const listing = path === null ? await deps.face.list() : await deps.face.list(path);
+					if (mine !== generation) return;
+					emit({
+						phase: "ready",
+						listing,
+						failure: null,
+						selected: null,
+						draft: listing.path,
+						filter: ""
+					});
+				} catch (cause) {
+					if (mine !== generation) return;
+					emit({
+						phase: "failed",
+						listing: null,
+						failure: humanize(cause),
+						selected: null
+					});
+				}
+			};
+			/** 草稿指到的那一层已经列举过时，按末段筛当前这一层的行；否则不过滤。
+			*
+			* 两边都先掐掉尾分隔符再比：草稿那边切开后天然带尾分隔符（`C:\a\` ＋ `b`），
+			* 而这一层的 `path` 由宿主给、不带尾分隔符。 */
+			const applyDraft = (draft) => {
+				const { directory, filter } = splitDraft(draft);
+				const listing = state.listing;
+				const sameLevel = listing !== null && directory !== null && normalize(directory) === normalize(listing.path);
+				emit({
+					draft,
+					filter: sameLevel ? filter : ""
+				});
+			};
+			const normalize = (path) => path.replace(/[\\/]+$/, "");
+			return {
+				getState: () => state,
+				subscribe(listener) {
+					listeners.add(listener);
+					return () => listeners.delete(listener);
+				},
+				open: () => load(null),
+				enter: (path) => load(path),
+				async up() {
+					const listing = state.listing;
+					if (listing === null) return;
+					const parent = parentOf(listing.path);
+					if (parent === listing.path) return;
+					await load(parent);
+				},
+				pick() {
+					const target = state.selected ?? state.listing?.path ?? null;
+					if (target === null) return;
+					deps.onPicked(target);
+				},
+				cancel() {
+					deps.onClose();
+				},
+				close() {
+					deps.onClose();
+				},
+				select(path) {
+					emit({
+						selected: state.selected === path ? null : path,
+						notice: null
+					});
+				},
+				toggleHidden() {
+					emit({ showHidden: !state.showHidden });
+				},
+				setDraft(draft) {
+					applyDraft(draft);
+				},
+				async commitDraft() {
+					const trimmed = state.draft.trim();
+					if (trimmed === "") return;
+					await load(trimmed);
+				},
+				setCreating(name) {
+					emit({
+						creating: name,
+						notice: null
+					});
+				},
+				async createFolder(name) {
+					const checked = validateFolderName(name);
+					if (!checked.ok) {
+						emit({ notice: checked.reason });
+						return;
+					}
+					const base = state.selected ?? state.listing?.path ?? null;
+					if (base === null) {
+						emit({ notice: "还没有打开任何目录，无法新建文件夹。" });
+						return;
+					}
+					try {
+						const created = await deps.face.createDirectory(base, name.trim());
+						emit({
+							creating: null,
+							notice: null
+						});
+						await load(created);
+						emit({ selected: created });
+					} catch (cause) {
+						const failure = humanize(cause);
+						emit({
+							notice: failure.message,
+							creating: null
+						});
+					}
+				}
+			};
+		}
+		/** 图上这一层要画的行（按隐藏开关与草稿末段过滤之后的）。 */
+		function rowsOf(state) {
+			if (state.listing === null) return [];
+			return filterEntries(visibleEntries(state.listing, state.showHidden), state.filter);
+		}
+		/** 「打开」这颗按钮的目标：选中行优先，没选中就是当前层。 */
+		function targetOf(state) {
+			return state.selected ?? state.listing?.path ?? null;
+		}
+		/** 一段路径拼成可读的一句话（给用例与调试用；图上不直接显示）。 */
+		function describe(state) {
+			if (state.phase === "failed") return `${state.failure?.code ?? "browse-failed"} @ ${state.draft}`;
+			if (state.listing === null) return `${state.phase}`;
+			return `${state.listing.path}（${rowsOf(state).length} 行）`;
+		}
+		/** 建一份「目录行接线」：给一个取数面与初值，回一组动作。
+		*
+		* 只做接线：把控制器算出来的状态与回调打包好，不取数、不画图、不认宿主。 */
+		function createDirectoryRowBrowser(deps) {
+			const controller = createBrowseController({
+				face: deps.face,
+				initialPath: deps.initialPath,
+				onPicked: deps.onPicked,
+				onClose: () => deps.onClosed?.(),
+				...deps.failureLabel === void 0 ? {} : { failureLabel: deps.failureLabel }
+			});
+			return {
+				open: () => controller.open(),
+				state: () => controller.getState(),
+				summary: () => describe(controller.getState()),
+				actions: {
+					onPick: () => controller.pick(),
+					onClose: () => controller.cancel(),
+					onEnter: (path) => void controller.enter(path),
+					onUp: () => void controller.up(),
+					onSelect: (path) => controller.select(path),
+					onToggleHidden: () => controller.toggleHidden(),
+					onDraft: (draft) => controller.setDraft(draft),
+					onCommitDraft: () => void controller.commitDraft(),
+					onCreate: (name) => void controller.createFolder(name),
+					onCreatingChange: (name) => controller.setCreating(name)
+				}
+			};
+		}
+		//#endregion
+		//#region ../plugin-manager/dist/directory-browser-ui.js
+		/** 文件浏览器的视图半：把 `BrowseState` 画成一张对话框。**不认识宿主**，也不自己做 IO。
+		*
+		* 手写 `React.createElement`（本包 client 束禁 JSX，见 `tsdown.config.ts` 的既成口径）。
+		* 只读状态、只回调；进哪一层、选到什么由操作半（`directory-browser-state.ts`）算。
+		*/
+		const EMPTY_LISTING = {
+			path: "",
+			home: "",
+			crumbs: [],
+			entries: [],
+			truncated: false
+		};
+		const S$1 = {
+			scrim: {
+				position: "fixed",
+				inset: 0,
+				background: "rgba(0,0,0,0.35)",
+				display: "flex",
+				alignItems: "center",
+				justifyContent: "center",
+				zIndex: 9999
+			},
+			dialog: {
+				width: 680,
+				maxWidth: "92vw",
+				height: 500,
+				maxHeight: "86vh",
+				display: "flex",
+				flexDirection: "column",
+				background: "var(--dsw-alias-bg-layer-1, #1f1f23)",
+				color: "var(--dsw-alias-label-primary, inherit)",
+				border: "1px solid var(--dsw-alias-border-l2, rgba(128,128,128,0.35))",
+				borderRadius: 10,
+				boxShadow: "0 12px 32px rgba(0,0,0,0.35)",
+				overflow: "hidden"
+			},
+			head: {
+				display: "flex",
+				alignItems: "center",
+				gap: 8,
+				padding: "10px 12px",
+				borderBottom: "1px solid var(--dsw-alias-border-l2, rgba(128,128,128,0.25))"
+			},
+			title: {
+				fontSize: 14,
+				fontWeight: 700
+			},
+			headTail: {
+				marginLeft: "auto",
+				fontSize: 12,
+				opacity: .72,
+				overflow: "hidden",
+				textOverflow: "ellipsis",
+				whiteSpace: "nowrap"
+			},
+			crumbs: {
+				display: "flex",
+				flexWrap: "wrap",
+				alignItems: "center",
+				gap: 2,
+				padding: "8px 12px 0",
+				fontSize: 12
+			},
+			chromeButton: {
+				background: "transparent",
+				border: "none",
+				color: "var(--dsw-alias-label-primary, inherit)",
+				cursor: "pointer",
+				padding: "2px 4px",
+				fontSize: 12,
+				opacity: .85
+			},
+			crumbSep: {
+				opacity: .45,
+				fontSize: 12
+			},
+			pathRow: {
+				display: "flex",
+				gap: 6,
+				padding: "8px 12px"
+			},
+			input: {
+				flex: 1,
+				minWidth: 0,
+				fontSize: 12,
+				padding: "5px 8px",
+				background: "var(--dsw-alias-bg-layer-2, rgba(128,128,128,0.12))",
+				color: "inherit",
+				border: "1px solid var(--dsw-alias-border-l2, rgba(128,128,128,0.35))",
+				borderRadius: 6
+			},
+			button: {
+				fontSize: 12,
+				padding: "5px 10px",
+				cursor: "pointer",
+				background: "var(--dsw-alias-bg-layer-2, rgba(128,128,128,0.12))",
+				color: "inherit",
+				border: "1px solid var(--dsw-alias-border-l2, rgba(128,128,128,0.35))",
+				borderRadius: 6
+			},
+			buttonOff: {
+				opacity: .45,
+				cursor: "default"
+			},
+			list: {
+				flex: 1,
+				minHeight: 0,
+				overflowY: "auto",
+				margin: "0 12px",
+				border: "1px solid var(--dsw-alias-border-l2, rgba(128,128,128,0.25))",
+				borderRadius: 6
+			},
+			row: {
+				display: "flex",
+				alignItems: "center",
+				gap: 8,
+				width: "100%",
+				padding: "6px 10px",
+				textAlign: "left",
+				background: "transparent",
+				color: "inherit",
+				border: "none",
+				borderBottom: "1px solid var(--dsw-alias-border-l2, rgba(128,128,128,0.12))",
+				cursor: "pointer",
+				fontSize: 13
+			},
+			rowSelected: { background: "var(--dsw-alias-bg-layer-2, rgba(128,128,128,0.18))" },
+			empty: {
+				padding: "14px 12px",
+				fontSize: 12,
+				opacity: .7
+			},
+			footNote: {
+				padding: "6px 12px 0",
+				fontSize: 12,
+				minHeight: 20
+			},
+			foot: {
+				display: "flex",
+				alignItems: "center",
+				gap: 8,
+				padding: "10px 12px",
+				borderTop: "1px solid var(--dsw-alias-border-l2, rgba(128,128,128,0.25))"
+			},
+			target: {
+				marginRight: "auto",
+				fontSize: 12,
+				opacity: .8,
+				overflow: "hidden",
+				textOverflow: "ellipsis",
+				whiteSpace: "nowrap"
+			},
+			error: { color: "var(--dsw-alias-label-error, #e66)" }
+		};
+		function crumbRow(state, labels, onEnter) {
+			const listing = state.listing;
+			if (listing === null || listing.crumbs.length === 0) return null;
+			const parts = [];
+			listing.crumbs.forEach((crumb, index) => {
+				if (index > 0) parts.push(react.createElement("span", {
+					key: "sep-" + crumb.path,
+					style: S$1.crumbSep
+				}, "›"));
+				const isCurrent = crumb.path === listing.path;
+				parts.push(react.createElement("button", {
+					key: crumb.path,
+					type: "button",
+					style: {
+						...S$1.chromeButton,
+						fontWeight: isCurrent ? 700 : 400
+					},
+					title: crumb.path,
+					onClick: () => onEnter(crumb.path)
+				}, index === 0 ? labels.up : crumb.name));
+			});
+			return react.createElement("div", { style: S$1.crumbs }, parts);
+		}
+		function entryRow(entry, selected, labels, onToggleSelect, onEnter) {
+			return react.createElement("div", {
+				key: entry.path,
+				style: {
+					...S$1.row,
+					padding: 0,
+					...selected ? S$1.rowSelected : {}
+				}
+			}, react.createElement("button", {
+				type: "button",
+				style: {
+					...S$1.row,
+					flex: 1,
+					border: "none"
+				},
+				onClick: () => onEnter(entry.path)
+			}, "📁 " + entry.name), react.createElement("button", {
+				type: "button",
+				style: {
+					...S$1.button,
+					marginRight: 8,
+					padding: "2px 8px"
+				},
+				"aria-pressed": selected,
+				title: selected ? labels.selected : labels.select,
+				onClick: () => onToggleSelect(entry.path)
+			}, selected ? "✓" : labels.select));
+		}
+		function createRow(labels, onName, onCancel, onCreate, creatingName) {
+			if (creatingName === null) return null;
+			return react.createElement("div", { style: {
+				...S$1.pathRow,
+				borderTop: "1px solid var(--dsw-alias-border-l2, rgba(128,128,128,0.25))"
+			} }, react.createElement("input", {
+				style: S$1.input,
+				value: creatingName,
+				placeholder: labels.newFolder,
+				"aria-label": labels.newFolder,
+				onChange: (event) => onName(event.currentTarget.value),
+				onKeyDown: (event) => {
+					if (event.key === "Enter") onCreate(creatingName);
+					if (event.key === "Escape") onCancel();
+				}
+			}), react.createElement("button", {
+				type: "button",
+				style: S$1.button,
+				onClick: () => onCreate(creatingName)
+			}, labels.createConfirm), react.createElement("button", {
+				type: "button",
+				style: S$1.button,
+				onClick: onCancel
+			}, labels.createCancel));
+		}
+		/** 画一张文件浏览器对话框。`open=false` 时返回 null（本件不挂 portal，由调用方决定挂在哪）。 */
+		function DirectoryBrowser(props) {
+			const { open, state, labels } = props;
+			if (!open) return null;
+			const rows = rowsOf(state);
+			const target = targetOf(state);
+			const listing = state.listing ?? EMPTY_LISTING;
+			const hidden = hiddenCount(listing);
+			const body = [];
+			body.push(crumbRow(state, labels, props.onEnter));
+			body.push(react.createElement("div", { style: S$1.pathRow }, react.createElement("input", {
+				style: S$1.input,
+				value: state.draft,
+				placeholder: labels.pathPlaceholder,
+				"aria-label": labels.pathPlaceholder,
+				onChange: (event) => props.onDraft(event.currentTarget.value),
+				onKeyDown: (event) => {
+					if (event.key === "Enter") props.onCommitDraft();
+				}
+			}), react.createElement("button", {
+				type: "button",
+				style: S$1.button,
+				onClick: props.onUp
+			}, labels.up), react.createElement("button", {
+				type: "button",
+				style: S$1.button,
+				onClick: props.onCommitDraft
+			}, labels.go)));
+			body.push(react.createElement("div", {
+				style: S$1.list,
+				role: "listbox",
+				"aria-label": labels.title
+			}, rows.length === 0 ? react.createElement("div", { style: S$1.empty }, state.phase === "loading" ? labels.loading : labels.empty) : rows.map((entry) => entryRow(entry, state.selected === entry.path, labels, props.onSelect, props.onEnter))));
+			body.push(createRow(labels, props.onDraft, () => props.onCreatingChange(null), props.onCreate, state.creating));
+			body.push(react.createElement("div", { style: S$1.footNote }, hidden > 0 ? react.createElement("label", { style: {
+				fontSize: 12,
+				cursor: "pointer",
+				marginRight: 10
+			} }, react.createElement("input", {
+				type: "checkbox",
+				checked: state.showHidden,
+				onChange: props.onToggleHidden
+			}), " " + labels.showHidden(hidden)) : null, state.creating === null ? react.createElement("button", {
+				type: "button",
+				style: {
+					...S$1.chromeButton,
+					textDecoration: "underline"
+				},
+				onClick: () => props.onCreatingChange("")
+			}, labels.newFolder) : null, state.notice !== null ? react.createElement("div", { style: S$1.error }, state.notice) : null, state.phase === "failed" && state.failure !== null ? react.createElement("div", { style: S$1.error }, state.failure.message) : null));
+			body.push(react.createElement("div", { style: S$1.foot }, react.createElement("span", {
+				style: S$1.target,
+				title: target ?? ""
+			}, target === null ? "" : labels.willPick + target), react.createElement("button", {
+				type: "button",
+				style: {
+					...S$1.button,
+					...target === null ? S$1.buttonOff : {}
+				},
+				onClick: props.onPick
+			}, labels.open), react.createElement("button", {
+				type: "button",
+				style: S$1.button,
+				onClick: props.onClose
+			}, labels.cancel)));
+			return react.createElement("div", {
+				style: S$1.scrim,
+				role: "presentation",
+				onMouseDown: (event) => {
+					if (event.target === event.currentTarget) props.onClose();
+				}
+			}, react.createElement("div", {
+				style: S$1.dialog,
+				role: "dialog",
+				"aria-modal": true,
+				"aria-label": labels.title
+			}, react.createElement("div", { style: S$1.head }, react.createElement("span", { style: S$1.title }, labels.title), react.createElement("span", {
+				style: S$1.headTail,
+				title: listing.path
+			}, state.listing === null ? "" : locationLabel(listing)), react.createElement("button", {
+				type: "button",
+				style: S$1.button,
+				"aria-label": labels.close,
+				title: labels.close,
+				onClick: props.onClose
+			}, "✕")), body));
+		}
+		/** 目录行接线的 React 半边：把操作半那组动作直接喂给组件。
+		*
+		* 操作半（`directory-browser-state.ts` 的 `createDirectoryRowBrowser`）不碰 React，
+		* 这里只把它的 `actions` 摊进 props —— 于是「进哪一层」那套在 Node 里可测，这里只做接线。 */
+		function DirectoryBrowserFromRow(props) {
+			return DirectoryBrowser({
+				open: props.open,
+				state: props.row.state(),
+				labels: props.labels,
+				...props.row.actions
+			});
+		}
+		//#endregion
 		//#region src/client.ts
 		/** dsh-calorie client 适配器（六边形：port=contract+dsh-ctx 镜像，adapter=本文件）。
 		*
@@ -213,7 +885,10 @@ window.__ModuleLoader__.load({
 		/** client 短名声明：只有这两个（#736 的目录选择走**可选查找**，不写进来——
 		* 写进来＝硬依赖，提供方缺席时整包被停靠，设置页会跟着装不上；见 cookbook §13）。 */
 		const inject = ["slots", "connection"];
-		/** 面板视觉（内联 style；颜色走 DSH 主题别名，深浅主题自适应，写死值只做回退）。 */
+		/** 面板视觉（内联 style；颜色走 DSH 主题别名，深浅主题自适应，写死值只做回退）。
+		*
+		* **六家逐项同形**（备忘·卡路里·记账·作息·居家·大厨）：同一项在这六份里逐字相同，
+		* 改任一条要六家一起改，锁见 `test/panel-copy-743.test.mjs` 第 ⑤ 条。 */
 		const S = {
 			card: {
 				padding: "12px 14px",
@@ -238,10 +913,13 @@ window.__ModuleLoader__.load({
 				fontSize: "0.92em"
 			},
 			error: {
-				color: "var(--dsw-alias-state-error-primary, #ff6b6b)",
-				fontSize: "1em"
+				marginTop: 8,
+				color: "var(--dsw-alias-label-error, #b3261e)",
+				fontSize: "1em",
+				whiteSpace: "pre-wrap"
 			},
 			okText: {
+				marginTop: 8,
 				color: "var(--dsw-alias-state-success-primary, #12805c)",
 				fontSize: "0.96em"
 			},
@@ -258,16 +936,16 @@ window.__ModuleLoader__.load({
 				fontSize: "0.92em"
 			},
 			info: {
-				fontSize: "0.92em",
 				color: "var(--dsw-alias-label-secondary, #9a9a9a)",
+				fontSize: "0.92em",
 				overflowWrap: "anywhere"
 			},
-			row: { marginTop: 10 },
+			row: { marginBottom: 10 },
 			label: { fontWeight: 600 },
 			hint: {
-				color: "var(--dsw-alias-label-tertiary, #8a8a8a)",
+				color: "var(--dsw-alias-label-secondary, #9a9a9a)",
 				fontSize: "0.92em",
-				margin: "1px 0 4px"
+				marginBottom: 4
 			},
 			input: {
 				width: "100%",
@@ -294,34 +972,29 @@ window.__ModuleLoader__.load({
 				cursor: "pointer"
 			},
 			bar: {
-				marginTop: 14,
 				display: "flex",
 				gap: 8,
-				alignItems: "center",
+				marginTop: 12,
 				flexWrap: "wrap"
 			},
 			btn: {
-				padding: "5px 14px",
-				borderRadius: 7,
+				padding: "4px 12px",
+				borderRadius: 6,
 				border: "1px solid var(--dsw-alias-border, rgba(128,128,128,.45))",
 				background: "var(--dsw-alias-bg-base, transparent)",
 				color: "var(--dsw-alias-label-primary, inherit)",
 				cursor: "pointer"
 			},
 			btnPrimary: {
-				padding: "5px 14px",
-				borderRadius: 7,
+				padding: "4px 12px",
+				borderRadius: 6,
 				border: "1px solid var(--dsw-alias-brand-primary, #2f6fed)",
 				background: "var(--dsw-alias-brand-primary, #2f6fed)",
 				color: "#fff",
 				cursor: "pointer"
 			},
-			adv: {
-				marginTop: 12,
-				paddingTop: 8,
-				borderTop: "1px solid var(--dsw-alias-border, rgba(128,128,128,.25))"
-			},
-			advSummary: {
+			advanced: { marginTop: 12 },
+			summary: {
 				cursor: "pointer",
 				fontWeight: 600
 			}
@@ -646,29 +1319,9 @@ window.__ModuleLoader__.load({
 				return null;
 			}
 		}
-		/** 平台回执 → 三种结果（**永不抛**）。回执是信封 `{ok, value|error}`（见 dsh-ctx.ts 的
-		* `DirectoryPickerAnswer`）：成功回的是 `value` 不是路径本身，被拒回的是 `ok:false` 不是抛——
-		* 照裸值解会把两种情况都误判成「用户取消」（#743 真机现象：点「选择文件夹」什么都没发生）。
-		* 裸串照收（老形状兜底），认不出的形状当「供不了」报出来，不当取消吞掉。 */
-		function readPickAnswer(raw) {
-			if (typeof raw === "string") return raw.trim() === "" ? { kind: "cancelled" } : {
-				kind: "picked",
-				path: raw
-			};
-			const answer = typeof raw === "object" && raw !== null ? raw : {};
-			if (answer.ok === true) {
-				const value = answer.value;
-				return typeof value === "string" && value.trim() !== "" ? {
-					kind: "picked",
-					path: value
-				} : { kind: "cancelled" };
-			}
-			const detail = answer.error?.message?.trim() ?? "";
-			return {
-				kind: "unavailable",
-				message: "打不开系统文件夹对话框" + (detail === "" ? "" : "（" + detail + "）") + "：请直接在框里填绝对路径。"
-			};
-		}
+		/** 平台回执／入口三态：**已经收进共用件**（票 #744），这里只同名转出。 */
+		const readPickAnswer = readPickAnswer$1;
+		const pickerModeOf = pickerModeOf$1;
 		/** 唤起一次系统文件夹选择器并归一结果（**永不抛**）。 */
 		async function pickDirectory(picker) {
 			try {
@@ -680,6 +1333,29 @@ window.__ModuleLoader__.load({
 				};
 			}
 		}
+		/** 入口三态：有系统对话框（`pick`）／只有应用内浏览（`list` ＋ `createDirectory`）／都没有。
+		*
+		* 判定取自共用件（一处定义）。本函数只读那个命名空间，不做 IO。 */
+		function directoryEntryMode(picker) {
+			return picker === null ? "none" : pickerModeOf(picker);
+		}
+		/** 开一行的应用内浏览器；返回 undefined＝这条路供不了（调用方据此不画入口）。
+		*
+		* **状态由调用方持有**（`setBrowseRow`）：本函数只造浏览器、开图，不碰 React 状态。 */
+		function openRowBrowser(input) {
+			if (input.picker === null || pickerModeOf(input.picker) !== "browse") return void 0;
+			const row = createDirectoryRowBrowser({
+				face: input.picker,
+				initialPath: input.path,
+				onPicked: (picked) => {
+					input.onChange(input.key, picked);
+					input.setBrowseRow(null);
+				},
+				onClosed: () => input.setBrowseRow(null)
+			});
+			input.setBrowseRow(row);
+			return row.open();
+		}
 		/** 「选择文件夹」按钮的真装配函数（目录行渲染出来的按钮，onClick 就是它）。
 		*
 		* 回 Promise 是为了本地可判（用例直接 await）；接进 React 时调用方 `void` 掉。 */
@@ -710,12 +1386,14 @@ window.__ModuleLoader__.load({
 				spellCheck: false,
 				onChange
 			});
-			const browse = item.control === "directory" && props.onBrowse !== void 0 ? react.createElement("button", {
+			/** 三态入口：供不了（`none`／缺席）就不画，不摆一个点了没反应的死按钮。 */
+			const entry = props.browser ?? null;
+			const browse = item.control === "directory" && entry !== null && entry.mode !== "none" ? react.createElement("button", {
 				style: S.btnPick,
 				type: "button",
 				disabled: props.disabled,
-				onClick: () => props.onBrowse?.(item.key)
-			}, "选择文件夹…") : null;
+				onClick: () => entry.onOpen(item.key)
+			}, entry.mode === "native" ? "选择文件夹…" : "浏览…") : null;
 			return react.createElement("div", { style: S.row }, react.createElement("div", { style: S.label }, item.title), react.createElement("div", { style: S.hint }, item.hint), browse === null ? control : react.createElement("div", { style: S.pickRow }, control, browse));
 		}
 		/** 技能设置页：承载卡路里自己的全部可配置项（只配置，不干活）。
@@ -790,24 +1468,46 @@ window.__ModuleLoader__.load({
 				setNotice(null);
 				setError(null);
 			}, []);
-			/** 目录选择：拿不到命名空间就没有入口；被拒一次即收起入口（不留死按钮）。 */
-			const picker = pickerGone ? null : props.getPicker();
-			const onBrowse = react.useMemo(() => {
-				if (picker === null) return void 0;
-				const browse = createBrowseHandler({
-					picker,
-					onChange,
-					onUnavailable: (message) => {
-						setError(message);
+			/** 目录行入口：三态（系统对话框／应用内浏览／都没有）。
+			*
+			* **软依赖**：拿不到命名空间就没有入口（留文本框），被拒一次即收起入口，不留死按钮。
+			* 状态全部住在组件自己（hook 顺序与旧版同形）：浏览器那一份只存「当前开着的那条」。 */
+			const picker = pickerGone ? null : props.pickerSource();
+			const [browseRow, setBrowseRow] = react.useState(null);
+			/** 目录行的入口动作：三态各一条路；都供不了就不给入口（`undefined` ⇒ Row 不画按钮）。 */
+			const onOpenRow = react.useCallback(async (key) => {
+				if (pickerModeOf(picker) === "native") {
+					setPicking(true);
+					setError(null);
+					const outcome = await pickDirectory(picker);
+					setPicking(false);
+					if (outcome.kind === "picked") onChange(key, outcome.path);
+					else if (outcome.kind === "unavailable") {
+						setError(outcome.message);
 						setPickerGone(true);
 					}
+					return;
+				}
+				const opened = openRowBrowser({
+					picker,
+					key,
+					path: draft[key] ?? "",
+					onChange,
+					setBrowseRow
 				});
-				return (key) => {
-					setPicking(true);
-					setError(null);
-					browse(key).finally(() => setPicking(false));
-				};
-			}, [picker, onChange]);
+				if (opened === void 0) return;
+				setError(null);
+				await opened;
+			}, [
+				picker,
+				onChange,
+				draft
+			]);
+			/** 给 Row 的三态入口：`none` 时给 null（不画按钮，文本框照旧）。 */
+			const rowEntry = pickerModeOf(picker) === "none" ? null : {
+				mode: pickerModeOf(picker),
+				onOpen: onOpenRow
+			};
 			const surface = state.kind === "ready" ? state.surface : null;
 			const dirty = surface !== null && CONFIG_ITEMS.some((i) => (draft[i.key] ?? "") !== (toDraft(surface.values, surface)[i.key] ?? ""));
 			/** 写完（保存／重置）之后重新读一份整面：写回执是 `{path, values}`、重置回执是 `{path, backupPath}`，
@@ -874,9 +1574,9 @@ window.__ModuleLoader__.load({
 				value: draft[item.key] ?? "",
 				disabled: busy,
 				onChange,
-				onBrowse
+				browser: rowEntry
 			});
-			return react.createElement("div", { style: S.card }, head, react.createElement("div", { style: S.rows }, common.map(renderRow)), react.createElement("details", { style: S.adv }, react.createElement("summary", { style: S.advSummary }, ADVANCED_GROUP_TITLE), react.createElement("div", { style: S.muted }, ADVANCED_GROUP_NOTE), advanced.map(renderRow)), react.createElement("div", { style: S.bar }, react.createElement("button", {
+			return react.createElement("div", { style: S.card }, head, react.createElement("div", { style: S.rows }, common.map(renderRow)), react.createElement("details", { style: S.advanced }, react.createElement("summary", { style: S.summary }, ADVANCED_GROUP_TITLE), react.createElement("div", { style: S.muted }, ADVANCED_GROUP_NOTE), advanced.map(renderRow)), react.createElement("div", { style: S.bar }, react.createElement("button", {
 				style: dirty ? S.btnPrimary : S.btn,
 				type: "button",
 				disabled: busy || !dirty,
@@ -891,7 +1591,28 @@ window.__ModuleLoader__.load({
 				type: "button",
 				disabled: busy,
 				onClick: () => void load()
-			}, "重新读取")), picking ? react.createElement("div", { style: S.muted }, "已唤起系统文件夹对话框：选中后自动填上，取消则不动。") : null, notice !== null ? react.createElement("div", { style: S.okText }, notice) : null, error !== null ? react.createElement("div", { style: S.error }, error) : null, react.createElement(VersionLine, {
+			}, "重新读取")), picking ? react.createElement("div", { style: S.muted }, "已唤起系统文件夹对话框：选中后自动填上，取消则不动。") : null, browseRow !== null ? react.createElement(DirectoryBrowserFromRow, {
+				open: true,
+				row: browseRow,
+				labels: {
+					title: "选择文件夹",
+					close: "关闭",
+					up: "上一级",
+					pathPlaceholder: "直接填绝对路径，回车即进入",
+					go: "转到",
+					showHidden: (n) => "显示隐藏目录（" + n + "）",
+					empty: "这个目录里没有子目录。",
+					loading: "正在读取…",
+					newFolder: "新建文件夹",
+					createConfirm: "创建",
+					createCancel: "取消",
+					select: "选",
+					selected: "已选",
+					open: "选定这个目录",
+					cancel: "取消",
+					willPick: "将选定："
+				}
+			}) : null, notice !== null ? react.createElement("div", { style: S.okText }, notice) : null, error !== null ? react.createElement("div", { style: S.error }, error) : null, react.createElement(VersionLine, {
 				pluginVersion: versions.plugin,
 				skillVersion: versions.skill
 			}));
@@ -907,7 +1628,7 @@ window.__ModuleLoader__.load({
 				channel: RPC_CHANNEL
 			}, () => react.createElement(CalorieConfig, {
 				getCall,
-				getPicker
+				pickerSource: getPicker
 			})));
 			const ensureWorkTab = () => {
 				try {
@@ -949,6 +1670,7 @@ window.__ModuleLoader__.load({
 		exports.VersionLine = VersionLine;
 		exports.apply = apply;
 		exports.createBrowseHandler = createBrowseHandler;
+		exports.directoryEntryMode = directoryEntryMode;
 		exports.fetchConfigSurface = fetchConfigSurface;
 		exports.fetchVersions = fetchVersions;
 		exports.formatVersionLine = formatVersionLine;
@@ -957,7 +1679,9 @@ window.__ModuleLoader__.load({
 		exports.inject = inject;
 		exports.isDirectoryPicker = isDirectoryPicker;
 		exports.normalizeVersion = normalizeVersion;
+		exports.openRowBrowser = openRowBrowser;
 		exports.pickDirectory = pickDirectory;
+		exports.pickerModeOf = pickerModeOf;
 		exports.readPickAnswer = readPickAnswer;
 		exports.resetConfigSurface = resetConfigSurface;
 		exports.resolveDirectoryPicker = resolveDirectoryPicker;