@noob-stupid/dsh-plugin-console 0.5.85 → 0.5.87

package/lib/client.js

@@ -142,11 +142,31 @@ window.__ModuleLoader__.load({
 			linksToggleSummary: "开发式链接（link）：共 {n} 个，自足 {ready} 个",
 			linksToggleTitle: "展开/收起 link 明细（默认收起）",
 			// 0.5.84 加法（用户第 6 项）：功能包工具栏里的 link 入口 + 它打开的那块面板
-			linksBtn: "开发式链接",
+			linksBtn: "link",
 			linksPanelTitle: "开发式链接（link:）—— 直接展示 /plugin-console/links 的只读清单：指向哪、目标还在不在、依赖/peer 齐不齐、垫片在不在",
 			linksPanelLoading: "正在读取…",
 			linksPanelReload: "重新读取",
 			linksPanelEmpty: "没有 link: 钉住的插件（这份清单只列开发式链接）",
+			// 0.5.87 加法（用户 2026-10-18）：link 面板从「只读清单」升级为「可操作」——
+			//   顶部选开发区 + 两段式钉住；每行按服务端结论给动作（缺依赖 / 缺 peer / 取消钉住）。
+			linksDevRootLabel: "开发区：",
+			linksDevRootPick: "选择已登记的开发区…",
+			linksDirPlaceholder: "要钉住的目录（绝对路径，必须在某个已登记开发区里）",
+			linksBrowse: "浏览…",
+			linksPinPlanBtn: "钉住",
+			linksPinPlanTitle: "{p} 将被钉成 link: 依赖，操作如下（还没动任何东西）",
+			linksPinConfirmBtn: "确认钉住",
+			linksCancel: "取消",
+			linksPinnedDone: "已钉住 {p}",
+			linksMtime: "改动于",
+			linksMtimeHint: "「改动于」= 目标目录本身或它直接下一层（不含 node_modules / .git）里最近的修改时间；更深的文件改动不会体现在这里",
+			linksRepairDeps: "补齐依赖",
+			linksRepairShims: "造垫片",
+			linksRepairDone: "已补齐",
+			linksUnpinBtn: "取消钉住",
+			linksUnpinConfirmBtn: "确认取消钉住",
+			linksUnpinDone: "已取消钉住",
+			linksBusyWorking: "处理中…",
 			devRootsTitle: "开发区根（只有这些根里的目录能钉住）",
 			devRootsNone: "（未登记）",
 			devRootAddPlaceholder: "注册新的开发区根（绝对路径，例如 D:\\my-plugins）",
@@ -785,11 +805,29 @@ window.__ModuleLoader__.load({
 			linksToggleBtn: "Dev link (link:) details",
 			linksToggleSummary: "Dev links (link:): {n} total, {ready} self-sufficient",
 			linksToggleTitle: "Expand/collapse link details (collapsed by default)",
-			linksBtn: "Dev links",
+			linksBtn: "link",
 			linksPanelTitle: "Dev links (link:) - the read-only list from /plugin-console/links: where it points, whether the target still exists, whether deps/peers are complete, and whether shims are in place",
 			linksPanelLoading: "Reading...",
 			linksPanelReload: "Reload",
 			linksPanelEmpty: "No plugin is pinned with link: (this list only covers dev links)",
+			linksDevRootLabel: "Dev root:",
+			linksDevRootPick: "Pick a registered dev root...",
+			linksDirPlaceholder: "Directory to pin (absolute path, must be inside a registered dev root)",
+			linksBrowse: "Browse...",
+			linksPinPlanBtn: "Pin",
+			linksPinPlanTitle: "{p} will be pinned as a link: dependency - steps below (nothing has changed yet)",
+			linksPinConfirmBtn: "Confirm pin",
+			linksCancel: "Cancel",
+			linksPinnedDone: "Pinned {p}",
+			linksMtime: "changed",
+			linksMtimeHint: "'changed' = the newest mtime of the target directory itself or its direct children (node_modules / .git excluded); deeper file edits do not show up here",
+			linksRepairDeps: "Install deps",
+			linksRepairShims: "Create shims",
+			linksRepairDone: "Repaired",
+			linksUnpinBtn: "Unpin",
+			linksUnpinConfirmBtn: "Confirm unpin",
+			linksUnpinDone: "Unpinned",
+			linksBusyWorking: "Working...",
 			devRootsTitle: "Dev roots (only directories inside these can be pinned)",
 			devRootsNone: "(none registered)",
 			devRootAddPlaceholder: "Register a dev root (absolute path, e.g. D:\\my-plugins)",
@@ -1995,6 +2033,40 @@ function healthSignature(health) {
 				return false;
 			}
 		}
+		// ★★ 0.5.87 加法：宿主**真的**有没有系统目录对话框？★★
+		// 判据只有一条、且必须是**正面证据**：桌面端外壳通过 contextBridge 注入的
+		//   `window.__DSH_DIRECTORY_PICKER__.pick()`（Electron 主进程 dialog.showOpenDialog）。
+		// 为什么不能"先摆一个按钮、点了再说"：用户 2026-10-18 的话是「点了没反应」算缺陷 ——
+		//   web 端（浏览器直接打开控制台）没有这个桥，那种按钮点下去只会抛个没意义的错。
+		// 所以：有桥才渲染「浏览…」，没有就**不渲染**（不是灰掉，是根本不出现）。
+		// 放在模块级（不放组件里）：与 skippedSignature / healthSignature 同一条纪律 ——
+		//   主面板不许依赖"只属于某个子组件"的局部东西。
+		let directoryPicker = null;
+		function detectDirectoryPicker() {
+			try {
+				const bridge = typeof globalThis === "undefined" ? null : globalThis.__DSH_DIRECTORY_PICKER__;
+				if (bridge !== null && typeof bridge === "object" && typeof bridge.pick === "function") return () => bridge.pick();
+			} catch {}
+			return null;
+		}
+		/** 目标目录的修改时间：ISO → 本地可读。解析不了就原样回显 —— 绝不编造一个时间。 */
+		function formatMtimeText(iso) {
+			try {
+				const when = new Date(String(iso));
+				if (Number.isNaN(when.getTime())) return String(iso);
+				return when.toLocaleString();
+			} catch { return String(iso); }
+		}
+		/** 从下拉里选了一个开发区 → 补成"待续写"的草稿路径。
+		 *  为什么：**根本身不能当钉住目标**（服务端刻意不允许，领域判据没放宽），
+		 *  所以直接塞根本身会让人点了必被拒。补上分隔符，接着写根里的那个插件目录即可。
+		 *  分隔符按路径自身风格推断（Windows 的 `\` / 其它 `/`）—— 不猜平台，只看字符串。 */
+		function devRootDraft(root) {
+			const text = String(root ?? "");
+			if (text === "") return "";
+			if (/[\\/]$/u.test(text)) return text;
+			return text + (text.includes("\\") ? "\\" : "/");
+		}
 		function PluginConsoleTab({ t, section = null }) {
 			const [state, setState] = react.useState({ status: "loading" });
 			// ★ 0.5.59：健康摘要**可关掉**（用户 2026-10-17「这个提示可以关掉」）。
@@ -2379,6 +2451,106 @@ function healthSignature(health) {
 					setLinksPanelData({ ok: false, items: [], count: 0, readyCount: 0, error: (error && error.message) || t("safetySwitchFailed") });
 				} finally { setLinksPanelBusy(false); }
 			};
+			// ★★ 0.5.87 加法：把 link 面板从「只读清单」升级为「可操作」★★
+			// 边界（写死）：**判据全部在服务端**（/links 给 ready / 缺什么 / 目标 / 改动时间），
+			//   这里只做三件事：选开发区 → 两段式钉住（先只读计划、确认后才 apply）、
+			//   行内动作 → 调对应写接口 → 重新读取。客户端不重算任何"缺什么 / 能不能补"。
+			const [linksDevRoots, setLinksDevRoots] = react.useState([]);
+			const [linksDevRootsNote, setLinksDevRootsNote] = react.useState(null);
+			const [linksDir, setLinksDir] = react.useState("");
+			const [linksPinPlan, setLinksPinPlan] = react.useState(null);
+			const [linksPinBusy, setLinksPinBusy] = react.useState(false);
+			const [linksRowBusy, setLinksRowBusy] = react.useState(null);
+			const [linksRowNote, setLinksRowNote] = react.useState({});
+			const [linksUnpinPlan, setLinksUnpinPlan] = react.useState(null);
+			// 「浏览…」只在宿主**确实**提供系统目录对话框时才存在（见模块级 detectDirectoryPicker）
+			const linksCanBrowse = typeof directoryPicker === "function";
+			/** 已登记开发区（来自 /dev-roots 的只读 list 分支；登记表坏了要如实说，不静默成空）。 */
+			const linksDevRootsLoad = async () => {
+				try {
+					const data = await call("/plugin-console/dev-roots", { action: "list" });
+					setLinksDevRoots(Array.isArray(data && data.roots) ? data.roots : []);
+					setLinksDevRootsNote(data && Array.isArray(data.warnings) && data.warnings.length > 0 ? data.warnings.join("；") : null);
+				} catch (error) {
+					setLinksDevRoots([]);
+					setLinksDevRootsNote((error && error.message) || t("safetySwitchFailed"));
+				}
+			};
+			const linksBrowse = async () => {
+				if (!linksCanBrowse) return;
+				try {
+					const picked = await directoryPicker();
+					if (typeof picked === "string" && picked !== "") setLinksDir(picked);
+				} catch (error) {
+					setLinksPinPlan({ ok: false, applied: false, error: (error && error.message) || t("safetySwitchFailed") });
+				}
+			};
+			/** 第一段：**只读计划**（服务端 plan 段，一个字节都不写）——先让人看清会发生什么。 */
+			const linksPinPlanLoad = async () => {
+				const dir = linksDir.trim();
+				if (dir === "" || linksPinBusy) return;
+				setLinksPinBusy(true);
+				setLinksPinPlan(null);
+				try {
+					const data = await call("/plugin-console/pin-dev-dir", { dir });
+					setLinksPinPlan({ ok: true, applied: false, plan: data });
+				} catch (error) {
+					setLinksPinPlan({ ok: false, applied: false, error: (error && error.message) || t("safetySwitchFailed") });
+				} finally { setLinksPinBusy(false); }
+			};
+			/** 第二段：用户点了「确认钉住」才真写（前端绝不跳过确认去调 apply）。 */
+			const linksPinConfirm = async () => {
+				const dir = linksDir.trim();
+				if (dir === "" || linksPinBusy) return;
+				setLinksPinBusy(true);
+				try {
+					const data = await call("/plugin-console/pin-dev-dir", { dir, confirm: true });
+					setLinksPinPlan({ ok: true, applied: true, plan: data });
+					await linksPanelLoad();
+				} catch (error) {
+					setLinksPinPlan({ ok: false, applied: false, error: (error && error.message) || t("safetySwitchFailed") });
+				} finally { setLinksPinBusy(false); }
+			};
+			/** 行内动作：deps=补齐依赖 / shims=造垫片。成败都按服务端 note 原话展示。 */
+			const linksRowRun = async (item, kind) => {
+				if (linksRowBusy !== null) return;
+				const name = String(item.packageName);
+				setLinksRowBusy(name + "|" + kind);
+				setLinksRowNote((prev) => ({ ...prev, [name]: t("linksBusyWorking") }));
+				try {
+					const data = await call("/plugin-console/link-repair", { packageName: name, kind });
+					setLinksRowNote((prev) => ({ ...prev, [name]: (data && data.note) || t("linksRepairDone") }));
+					await linksPanelLoad();
+				} catch (error) {
+					setLinksRowNote((prev) => ({ ...prev, [name]: t("safetySwitchFailed") + "：" + ((error && error.message) || "") }));
+				} finally { setLinksRowBusy(null); }
+			};
+			/** 取消钉住的第一段：只读计划（会明说"它还在 bundles 里"这类后果）。 */
+			const linksUnpinPlanLoad = async (item) => {
+				if (linksRowBusy !== null) return;
+				const name = String(item.packageName);
+				setLinksRowBusy(name + "|unpin-plan");
+				setLinksUnpinPlan(null);
+				try {
+					const data = await call("/plugin-console/unpin-dev-dir", { packageName: name });
+					setLinksUnpinPlan({ ok: true, packageName: name, plan: data });
+				} catch (error) {
+					setLinksUnpinPlan({ ok: false, packageName: name, error: (error && error.message) || t("safetySwitchFailed") });
+				} finally { setLinksRowBusy(null); }
+			};
+			const linksUnpinConfirm = async (item) => {
+				if (linksRowBusy !== null) return;
+				const name = String(item.packageName);
+				setLinksRowBusy(name + "|unpin");
+				try {
+					const data = await call("/plugin-console/unpin-dev-dir", { packageName: name, confirm: true });
+					setLinksUnpinPlan(null);
+					setLinksRowNote((prev) => ({ ...prev, [name]: (data && data.note) || t("linksUnpinDone") }));
+					await linksPanelLoad();
+				} catch (error) {
+					setLinksUnpinPlan({ ok: false, packageName: name, error: (error && error.message) || t("safetySwitchFailed") });
+				} finally { setLinksRowBusy(null); }
+			};
 			// ★ 0.5.80：历史解锁记录默认折叠（用户：新的应覆盖旧的，别一直铺满）
 			const [gateHistoryOpen, setGateHistoryOpen] = react.useState(false);
 			// 功能包位置:长按拖动,持久化 localStorage(每次打开沿用上次位置)
@@ -5024,13 +5196,67 @@ function healthSignature(health) {
 				// ★ 0.5.84（用户第 6 项）：功能包 → [开发式链接] 的面板：直接展示 /plugin-console/links
 				//   的同一份数据（与「升级安全」里那块折叠展示同源）。判据来自服务端，这里只如实展示：
 				//   每行 = ✓/• + 包名 + 版本 + 指向 + 缺什么（悬停看完整原因）。
+				// ★ 0.5.87 把这份只读清单升级为**可操作**（用户 2026-10-18）：顶部选开发区 → 两段式钉住；
+				//   每行按**服务端说的缺什么**给按钮（有哪个显示哪个，没有就不显示），底部照旧「重新读取」。
 				linksPanelOpen
 					? el("div", { className: styles.modalBackdrop, onClick: (event) => { if (event.target === event.currentTarget) setLinksPanelOpen(false); } },
-						el("div", { className: styles.modalCard, style: { maxWidth: 620 } },
+						el("div", { className: styles.modalCard, style: { maxWidth: 720 } },
 							el("div", { className: styles.rowTop, style: { justifyContent: "space-between" } },
 								el("strong", { className: styles.name }, t("linksBtn")),
 								el("button", { type: "button", className: styles.trashBtn, style: { fontSize: 14, padding: "4px 8px" }, title: t("closeModal"), "aria-label": t("closeModal"), onClick: () => setLinksPanelOpen(false) }, "✕")),
 							el("p", { className: styles.message }, t("linksPanelTitle")),
+							// ── 顶部：选开发区 → [钉住]（先只读计划，用户确认后才真写）────────────────
+							el("div", { style: { display: "flex", flexDirection: "column", gap: 6, marginTop: 6, paddingTop: 8, borderTop: "1px solid var(--dsw-alias-border-secondary, rgba(127,127,127,.18))" } },
+								el("div", { style: { display: "flex", gap: 8, alignItems: "center", flexWrap: "wrap" } },
+									el("span", { className: styles.status }, t("linksDevRootLabel")),
+									el("select", {
+										"aria-label": t("linksDevRootLabel"),
+										value: "",
+										disabled: linksPinBusy,
+										onChange: (event) => { const picked = String(event.currentTarget.value ?? ""); if (picked !== "") setLinksDir(devRootDraft(picked)); },
+										style: { flex: "0 1 300px", minWidth: 180, font: "inherit", padding: "4px 6px" },
+									},
+										el("option", { value: "" }, t("linksDevRootPick")),
+										linksDevRoots.map((root) => el("option", { key: "dr-" + String(root), value: String(root) }, String(root))))),
+								el("div", { style: { display: "flex", gap: 8, alignItems: "center", flexWrap: "wrap" } },
+									el("input", {
+										type: "text",
+										placeholder: t("linksDirPlaceholder"),
+										value: linksDir,
+										disabled: linksPinBusy,
+										"aria-label": t("linksDirPlaceholder"),
+										onChange: (event) => setLinksDir(String(event.currentTarget.value ?? "")),
+										style: { flex: 1, minWidth: 220, font: "inherit", padding: "4px 8px" },
+									}),
+									// ★ 只在宿主**确实**有系统目录对话框时才渲染（web 端没有 ⇒ 不显示，不是灰掉）
+									linksCanBrowse
+										? el("button", { type: "button", className: styles.toggle, disabled: linksPinBusy, onClick: linksBrowse }, t("linksBrowse"))
+										: null,
+									el("button", {
+										type: "button",
+										className: styles.toggle,
+										disabled: linksPinBusy || linksDir.trim() === "",
+										onClick: linksPinPlanLoad,
+									}, linksPinBusy ? t("linksPanelLoading") : t("linksPinPlanBtn"))),
+								linksDevRootsNote === null ? null : el("p", { className: styles.status, "data-warn": "true" }, linksDevRootsNote),
+								// 计划 / 结果卡片（两段式的第一段就在这里给人看）
+								linksPinPlan === null
+									? null
+									: el("div", { style: { display: "flex", flexDirection: "column", gap: 4, fontSize: 12, padding: "6px 8px", border: "1px solid var(--dsw-alias-border-secondary, rgba(127,127,127,.18))", borderRadius: 6 } },
+										linksPinPlan.ok !== true
+											? el("div", { "data-warn": "true" }, t("safetySwitchFailed") + "：" + String(linksPinPlan.error ?? "-"))
+											: (linksPinPlan.applied === true
+												? el("div", null,
+													t("linksPinnedDone").replace("{p}", String(linksPinPlan.plan.packageName ?? linksDir.trim()))
+													+ (linksPinPlan.plan.after ? " → " + String(linksPinPlan.plan.after) : "")
+													+ (linksPinPlan.plan.sufficiency && linksPinPlan.plan.sufficiency.note ? "；" + String(linksPinPlan.plan.sufficiency.note) : ""))
+												: el("div", { style: { display: "flex", flexDirection: "column", gap: 4 } },
+													el("div", { style: { fontWeight: 500 } }, t("linksPinPlanTitle").replace("{p}", String(linksPinPlan.plan.packageName ?? "?"))),
+													(Array.isArray(linksPinPlan.plan.steps) ? linksPinPlan.plan.steps : []).map((step, stepIndex) => el("div", { key: "pin-step-" + stepIndex, style: { opacity: .85 } }, "· " + String(step))),
+													el("div", { style: { display: "flex", gap: 8, marginTop: 4 } },
+														el("button", { type: "button", className: styles.toggle, style: { fontSize: 11, padding: "2px 10px" }, disabled: linksPinBusy, onClick: linksPinConfirm }, t("linksPinConfirmBtn")),
+														el("button", { type: "button", className: styles.toggle, style: { fontSize: 11, padding: "2px 10px" }, disabled: linksPinBusy, onClick: () => setLinksPinPlan(null) }, t("linksCancel"))))))),
+							// ── 清单（每行按服务端结论给动作）──────────────────────────────────────
 							linksPanelData === null
 								? el("p", { className: styles.status }, t("linksPanelLoading"))
 								: (linksPanelData.ok === false
@@ -5045,16 +5271,40 @@ function healthSignature(health) {
 										(Array.isArray(linksPanelData.items) ? linksPanelData.items : []).length === 0
 											? el("p", { className: styles.status }, t("linksPanelEmpty"))
 											: null,
-										(Array.isArray(linksPanelData.items) ? linksPanelData.items : []).map((x) => el("div", { key: "lp-" + x.packageName, title: x.note ?? undefined, style: { fontSize: 12, opacity: .9, wordBreak: "break-all" } },
-											(x.ready === true ? "✓ " : "• ") + x.packageName + (x.version ? " v" + x.version : "")
-												+ (x.target ? "  → " + x.target : "")
-												+ (Array.isArray(x.missingDeps) && x.missingDeps.length > 0 ? "  · 缺依赖 " + x.missingDeps.length : "")
-												+ (Array.isArray(x.missingPeers) && x.missingPeers.length > 0 ? "  · 缺 peer " + x.missingPeers.length : "")
-												+ (x.foreignPeers !== null && x.foreignPeers !== undefined && Array.isArray(x.foreignPeers) && x.foreignPeers.length > 0 ? "  · 异副本 " + x.foreignPeers.length : "")
-												+ (x.shims !== null && x.shims !== undefined ? "  · 垫片 " + String(x.shims.count ?? 0) : "")
-												+ (x.persisted !== null && x.persisted !== undefined && x.persisted.ok === false ? "  · 未持久化" : ""))))),
+										(Array.isArray(linksPanelData.items) ? linksPanelData.items : []).map((x) => el("div", { key: "lp-" + x.packageName, title: [x.note ?? null, t("linksMtimeHint")].filter((v) => typeof v === "string" && v !== "").join("\n") || undefined, style: { fontSize: 12, opacity: .9, wordBreak: "break-all", display: "flex", flexDirection: "column", gap: 3, paddingBottom: 5 } },
+											el("div", null,
+												(x.ready === true ? "✓ " : "• ") + x.packageName + (x.version ? " v" + x.version : "")
+													+ (x.target ? "  → " + x.target : "")
+													+ "  · " + t("linksMtime") + " " + (typeof x.targetMtime === "string" && x.targetMtime !== "" ? formatMtimeText(x.targetMtime) : "—")
+													+ (Array.isArray(x.missingDeps) && x.missingDeps.length > 0 ? "  · 缺依赖 " + x.missingDeps.length : "")
+													+ (Array.isArray(x.missingPeers) && x.missingPeers.length > 0 ? "  · 缺 peer " + x.missingPeers.length : "")
+													+ (x.foreignPeers !== null && x.foreignPeers !== undefined && Array.isArray(x.foreignPeers) && x.foreignPeers.length > 0 ? "  · 异副本 " + x.foreignPeers.length : "")
+													+ (x.shims !== null && x.shims !== undefined ? "  · 垫片 " + String(x.shims.count ?? 0) : "")
+													+ (x.persisted !== null && x.persisted !== undefined && x.persisted.ok === false ? "  · 未持久化" : "")),
+											// 行内动作：**有哪个显示哪个**（没有就不显示，绝不摆灰按钮）
+											el("div", { style: { display: "flex", gap: 8, flexWrap: "wrap", alignItems: "center" } },
+												Array.isArray(x.missingDeps) && x.missingDeps.length > 0
+													? el("button", { type: "button", className: styles.toggle, style: { fontSize: 11, padding: "2px 8px" }, disabled: linksRowBusy !== null, onClick: () => linksRowRun(x, "deps") }, t("linksRepairDeps"))
+													: null,
+												Array.isArray(x.shimmablePeers) && x.shimmablePeers.length > 0
+													? el("button", { type: "button", className: styles.toggle, style: { fontSize: 11, padding: "2px 8px" }, disabled: linksRowBusy !== null, onClick: () => linksRowRun(x, "shims") }, t("linksRepairShims"))
+													: null,
+												el("button", { type: "button", className: styles.toggle, style: { fontSize: 11, padding: "2px 8px" }, disabled: linksRowBusy !== null, onClick: () => linksUnpinPlanLoad(x) }, t("linksUnpinBtn")),
+												linksRowNote[x.packageName] ? el("span", { className: styles.status }, String(linksRowNote[x.packageName])) : null),
+											// 取消钉住的第一段：把"将会发生什么 + 后果"先摆出来（两段式，确认才动手）
+											linksUnpinPlan !== null && linksUnpinPlan.packageName === x.packageName
+												? el("div", { style: { display: "flex", flexDirection: "column", gap: 3, padding: "4px 6px", border: "1px solid var(--dsw-alias-border-secondary, rgba(127,127,127,.18))", borderRadius: 6 } },
+													linksUnpinPlan.ok !== true
+														? el("div", { "data-warn": "true" }, t("safetySwitchFailed") + "：" + String(linksUnpinPlan.error ?? "-"))
+														: el("div", { style: { display: "flex", flexDirection: "column", gap: 3 } },
+															(Array.isArray(linksUnpinPlan.plan.steps) ? linksUnpinPlan.plan.steps : []).map((step, unpinStepIndex) => el("div", { key: "unpin-step-" + unpinStepIndex, style: { opacity: .85 } }, "· " + String(step))),
+															(Array.isArray(linksUnpinPlan.plan.warnings) ? linksUnpinPlan.plan.warnings : []).map((warning, warnIndex) => el("div", { key: "unpin-warn-" + warnIndex, "data-warn": "true" }, "! " + String(warning))),
+															el("div", { style: { display: "flex", gap: 8, marginTop: 2 } },
+																el("button", { type: "button", className: styles.toggle, style: { fontSize: 11, padding: "2px 8px" }, disabled: linksRowBusy !== null, onClick: () => linksUnpinConfirm(x) }, t("linksUnpinConfirmBtn")),
+																el("button", { type: "button", className: styles.toggle, style: { fontSize: 11, padding: "2px 8px" }, disabled: linksRowBusy !== null, onClick: () => setLinksUnpinPlan(null) }, t("linksCancel")))))
+												: null)))),
 							el("div", { className: styles.rowTop, style: { justifyContent: "flex-end", gap: 8, marginTop: 10 } },
-								el("button", { type: "button", className: styles.toolItem, "data-busy": linksPanelBusy ? "true" : "false", onClick: linksPanelLoad }, linksPanelBusy ? t("linksPanelLoading") : t("linksPanelReload")))))
+								el("button", { type: "button", className: styles.toolItem, "data-busy": linksPanelBusy ? "true" : "false", onClick: () => { linksPanelLoad(); linksDevRootsLoad(); } }, linksPanelBusy ? t("linksPanelLoading") : t("linksPanelReload")))))
 					: null,
 				gateOpen
 					? el("div", { className: styles.modalBackdrop, onClick: (event) => { if (event.target === event.currentTarget) setGateOpen(false); } },
@@ -5595,7 +5845,8 @@ function healthSignature(health) {
 							title: t("linksPanelTitle"),
 							"aria-label": t("linksBtn"),
 							// ★ 0.5.84（用户第 6 项）：打开时拉一次真实清单（与安全面板同一个只读接口）
-							onClick: () => setLinksPanelOpen((v) => { const next = !v; if (next) linksPanelLoad(); return next; }),
+							// ★ 0.5.87：同时拉一次「已登记开发区」（钉住要用；没有它下拉就是空的）
+							onClick: () => setLinksPanelOpen((v) => { const next = !v; if (next) { linksPanelLoad(); linksDevRootsLoad(); } return next; }),
 						}, t("linksBtn") + (linksPanelData !== null && Array.isArray(linksPanelData.items) ? " " + linksPanelData.items.length : "")),
 						el("button", {
 							type: "button",
@@ -6766,6 +7017,10 @@ function healthSignature(health) {
 			} catch {}
 		}
 		function apply(ctx) {
+			// ★ 0.5.87：探测宿主有没有系统目录对话框（桌面端外壳有、web 端没有）。
+			//   主面板据此决定**是否渲染**「浏览…」—— 没有就根本不存在这个按钮，
+			//   而不是摆一个点了没反应的（用户 2026-10-18 明确要求）。
+			directoryPicker = detectDirectoryPicker();
 			ctx.effect(() => ctx.locale.register(NS, { zh, en }), "plugin-console: dictionaries");
 			const t = ctx.locale.bind(NS);
 			ctx.slots.inject("settings.plugins.tab", () => ctx.slots.register({
@@ -6809,6 +7064,11 @@ function healthSignature(health) {
 		// 仅测试用导出（tests/test-adapt-unlock-gate.mjs ①-2：断言「已适配，立即解锁」按钮的门控判据，
 		// 以及它必须与卡片正文用同一个判据）。
 		exports.canAdaptUnlock = canAdaptUnlock;
+		// 仅测试用导出（tests/test-links-actions-ui.mjs：假 React **真渲染**主面板，断言 link 面板
+		// 的按钮按服务端结论出现/不出现、「浏览…」只在宿主提供目录对话框时存在、钉住是两段式）。
+		exports.PluginConsoleTab = PluginConsoleTab;
+		// 仅测试用导出（同上：断言「宿主有没有系统目录对话框」这条探测本身）。
+		exports.detectDirectoryPicker = detectDirectoryPicker;
 		return module.exports;
 	}
 	});

package/lib/server/domain/dev-roots.js

@@ -103,6 +103,18 @@ function checkInsideDevRoots(home, candidate) {
     const rootNorm = normalizePath(root)
     if (isInside(norm, rootNorm)) return { ok: true, reason: null, normalized: norm, root }
   }
+  // 2026-10-18 改错（0.5.87）：**它就是某个已注册的根本身**时，旧文案说"不在任何已注册的开发区根里"
+  //   —— 而它恰恰就在里面（只是"根"不算"根之内"，这条边界是刻意的、不改）。那句话会把人引向错误的
+  //   下一步（去注册一个已经注册过的根），所以这里单列一句准确的话：要钉的是**根里的那个插件目录**。
+  const rootNormItself = roots.map((root) => normalizePath(root)).find((rootNorm) => rootNorm === norm) ?? null
+  if (rootNormItself !== null) {
+    return {
+      ok: false,
+      reason: `这是开发区根本身，不是根里的插件目录：${candidate}\n请指向根里的那个目录（例如 ${join(candidate, '<插件目录名>')}）——「根」不能当依赖目标，这是刻意的边界`,
+      normalized: norm,
+      root: null,
+    }
+  }
   return {
     ok: false,
     reason: `不在任何已注册的开发区根里：${candidate}\n已注册：${roots.join(' / ')}\n（这是刻意的限制：只允许钉住开发区里的目录，不允许任意路径）`,

package/lib/server/domain/install-box.js

@@ -0,0 +1,77 @@
+// L1 · domain —— install-box.js（「盒子实验」：解压后的包目录先静态校验再覆盖正式位置）
+//
+// 2026-10-18 从 domain/install.js **原样搬出**（install.js 贴着 600 行架构硬顶，见
+// tests/test-architecture-guard.mjs；这一块本来就是自洽的"装前只读校验"，与 sources 无关）。
+// 搬移只搬移未改逻辑：install.js 继续 re-export 这两个名字，**对外导出名与调用点一个字都没变**。
+//
+// 校验什么（都是"装了也起不来"的硬伤，所以要在覆盖旧版本**之前**拦住）：
+//   · package.json 必须可解析且 name 与安装目标一致；
+//   · main / exports 入口文件必须真实存在；
+//   · bundle patch（cordis.patch.yml）引用的包必须已就位（防聚合包引用缺失崩溃）。
+// 失败抛错 → 调用方保留旧版本（安装不中断服务）。
+import { existsSync, readFileSync } from 'node:fs'
+import { join } from 'node:path'
+
+/** 盒子验证：解压后的包目录先通过静态校验再允许覆盖正式位置。
+ * refCheckRoot 指定引用检查根（宿主插件在根层 node_modules，与 profile 层不同）。 */
+function verifyPackageBox(pkgPath, profileDir, packageName, refCheckRoot = null) {
+  const note = []
+  const pkgRaw = readFileSync(join(pkgPath, 'package.json'), 'utf8')
+  const pkg = JSON.parse(pkgRaw)
+  if (pkg.name !== packageName) {
+    throw new Error(`盒子验证失败：包名不符（tarball 内为 ${pkg.name}，期望 ${packageName}），已保留旧版本`)
+  }
+  // 入口存在性：main 字段 / exports.'.'（字符串或对象 default）指向的文件必须存在
+  let entry = typeof pkg.main === 'string' ? pkg.main : null
+  if (entry === null && pkg.exports && typeof pkg.exports === 'object') {
+    const dot = pkg.exports['.'] ?? pkg.exports['./package.json'] === undefined ? pkg.exports['.'] : null
+    if (typeof dot === 'string') entry = dot
+    else if (dot && typeof dot === 'object') entry = typeof dot.default === 'string' ? dot.default : null
+  }
+  if (entry !== null) {
+    const entryPath = join(pkgPath, ...entry.split('/'))
+    if (!existsSync(entryPath)) {
+      throw new Error(`盒子验证失败：入口文件缺失（${entry}），已保留旧版本`)
+    }
+  }
+  // bundle patch 引用预检：引用的包必须已存在于目标 node_modules（防聚合包半更新崩溃）。
+  // refCheckRoot 指定检查根（宿主插件在根层 node_modules，与 profile 层不同）。
+  const checkRoot = refCheckRoot ?? join(profileDir, 'node_modules')
+  try {
+    const patchRel = pkg.dsh?.bundle?.patch
+    if (typeof patchRel === 'string') {
+      const bundlePatch = join(pkgPath, patchRel)
+      if (existsSync(bundlePatch)) {
+        const refs = parseBundlePatchRefs(readFileSync(bundlePatch, 'utf8'))
+        const missingRefs = refs.filter((r) => !existsSync(join(checkRoot, r.name)))
+        if (missingRefs.length > 0) {
+          note.push(`bundle 引用缺失：${missingRefs.map((r) => r.name).join('、')}（安装后由聚合完整性检查补齐/禁用）`)
+        }
+        if (refs.length > 0) note.push(`bundle 引用 ${refs.length} 个已就位`)
+      }
+    }
+  } catch (error) {
+    if (error instanceof Error && error.message.startsWith('盒子验证失败')) throw error
+  }
+  return { note: note.length > 0 ? note.join('；') : null }
+}
+
+/** 解析 bundle patch（cordis.patch.yml）的 insert 引用列表（id + 包名）。 */
+function parseBundlePatchRefs(text) {
+  const refs = []
+  const lines = text.split(/\r?\n/u)
+  let inInsert = false
+  for (let i = 0; i < lines.length; i += 1) {
+    const line = lines[i]
+    if (/^- insert:\s*$/u.test(line)) { inInsert = true; continue }
+    if (/^- /u.test(line) && !/^ {4}- /u.test(line)) inInsert = false
+    if (!inInsert) continue
+    const idM = line.match(/^ {4}- id: ([A-Za-z0-9_.-]+)\s*$/u)
+    if (!idM) continue
+    const nameM = (lines[i + 1] ?? '').match(/^ {6}name: ['"]([^'"]+)['"]\s*$/u)
+    if (nameM) refs.push({ id: idM[1], name: nameM[1] })
+  }
+  return refs
+}
+
+export { verifyPackageBox, parseBundlePatchRefs }