@dsh-workbench/core 0.2.10 → 0.2.12

package/dist/host/index.js

@@ -1,6 +1,7 @@
 import { createHash, randomUUID } from "node:crypto";
 import fs, { chmodSync, closeSync, existsSync, mkdirSync, openSync, readFileSync, readdirSync, readlinkSync, realpathSync, renameSync, rmSync, statSync, symlinkSync, unlinkSync, writeFileSync } from "node:fs";
 import path, { basename, delimiter, dirname, join, resolve, sep } from "node:path";
+import { deflateSync, inflateSync } from "node:zlib";
 import os from "node:os";
 import { spawn } from "node:child_process";
 import { fileURLToPath } from "node:url";
@@ -247,7 +248,7 @@ var PHASES = [
 function asRecord$10(value) {
 	return typeof value === "object" && value !== null ? value : void 0;
 }
-function textOf$7(value, max) {
+function textOf$9(value, max) {
 	if (typeof value !== "string") return "";
 	const trimmed = value.trim();
 	return trimmed.length > max ? trimmed.slice(0, max) : trimmed;
@@ -260,8 +261,8 @@ function atOf(value) {
 function errorOf(raw) {
 	const record = asRecord$10(raw);
 	if (record === void 0) return void 0;
-	const code = textOf$7(record["code"], 120);
-	const message = textOf$7(record["message"], PANEL_STATE_MAX_TEXT);
+	const code = textOf$9(record["code"], 120);
+	const message = textOf$9(record["message"], PANEL_STATE_MAX_TEXT);
 	if (code === "" && message === "") return void 0;
 	return {
 		code: code === "" ? "unknown" : code,
@@ -274,7 +275,7 @@ function parseCardsReport(payload) {
 		ok: false,
 		message: "请求体要是一个对象"
 	};
-	const workspace = textOf$7(record["workspace"], PANEL_STATE_MAX_TEXT);
+	const workspace = textOf$9(record["workspace"], PANEL_STATE_MAX_TEXT);
 	if (workspace === "") return {
 		ok: false,
 		message: "workspace 不能是空的 —— 面板按工作区存"
@@ -288,9 +289,9 @@ function parseCardsReport(payload) {
 	for (const item of raw.slice(0, 32)) {
 		const card = asRecord$10(item);
 		if (card === void 0) continue;
-		const unit = textOf$7(card["unit"], 200);
-		const route = textOf$7(card["route"], 400);
-		const phase = textOf$7(card["phase"], 20);
+		const unit = textOf$9(card["unit"], 200);
+		const route = textOf$9(card["route"], 400);
+		const phase = textOf$9(card["phase"], 20);
 		const at = atOf(card["at"]);
 		if (unit === "" || route === "" || at === null || !PHASES.includes(phase)) continue;
 		const error = errorOf(card["error"]);
@@ -320,9 +321,9 @@ function parseCrashReport(payload) {
 		ok: false,
 		message: "请求体要是一个对象"
 	};
-	const workspace = textOf$7(record["workspace"], PANEL_STATE_MAX_TEXT);
-	const unit = textOf$7(record["unit"], 200);
-	const reason = textOf$7(record["reason"], PANEL_STATE_MAX_TEXT);
+	const workspace = textOf$9(record["workspace"], PANEL_STATE_MAX_TEXT);
+	const unit = textOf$9(record["unit"], 200);
+	const reason = textOf$9(record["reason"], PANEL_STATE_MAX_TEXT);
 	if (workspace === "") return {
 		ok: false,
 		message: "workspace 不能是空的"
@@ -568,20 +569,20 @@ var PERMISSION_CODES = /* @__PURE__ */ new Set([
 function asRecord$9(value) {
 	return typeof value === "object" && value !== null ? value : void 0;
 }
-function textOf$6(value) {
+function textOf$8(value) {
 	return typeof value === "string" ? value.trim() : "";
 }
 function codeOf(page) {
 	const record = asRecord$9(page);
-	return record === void 0 ? "" : textOf$6(record["code"]);
+	return record === void 0 ? "" : textOf$8(record["code"]);
 }
 function messageOf$2(page) {
 	const record = asRecord$9(page);
-	return record === void 0 ? "" : textOf$6(record["message"]);
+	return record === void 0 ? "" : textOf$8(record["message"]);
 }
 function hintOf$1(page) {
 	const record = asRecord$9(page);
-	const hint = record === void 0 ? "" : textOf$6(record["hint"]);
+	const hint = record === void 0 ? "" : textOf$8(record["hint"]);
 	return hint === "" ? void 0 : hint;
 }
 function pageFailed(page) {
@@ -812,7 +813,7 @@ var DEFAULT_TEXT_MAX = 200;
 function asRecord$8(value) {
 	return typeof value === "object" && value !== null ? value : void 0;
 }
-function textOf$5(value) {
+function textOf$7(value) {
 	return typeof value === "string" ? value.trim() : "";
 }
 function entriesOf(value) {
@@ -825,8 +826,8 @@ function entriesOf(value) {
 		if (item === void 0) continue;
 		const nth = typeof item["nth"] === "number" ? item["nth"] : entries.length;
 		entries.push({
-			text: textOf$5(item["text"]),
-			tag: textOf$5(item["tag"]),
+			text: textOf$7(item["text"]),
+			tag: textOf$7(item["tag"]),
 			nth
 		});
 	}
@@ -835,7 +836,7 @@ function entriesOf(value) {
 function reasonOf(stdout, stderr) {
 	const parsed = asRecord$8(parseJsonLoose(stdout));
 	const error = parsed === void 0 ? void 0 : asRecord$8(parsed["error"]);
-	const message = error === void 0 ? "" : textOf$5(error["message"]);
+	const message = error === void 0 ? "" : textOf$7(error["message"]);
 	if (message !== "") return message;
 	const lines = (stderr.trim() === "" ? stdout : stderr).split("\n").map((one) => one.trim()).filter((one) => one !== "");
 	return (lines[lines.length - 1] ?? "").slice(-200);
@@ -843,7 +844,7 @@ function reasonOf(stdout, stderr) {
 function hintOf(stdout) {
 	const parsed = asRecord$8(parseJsonLoose(stdout));
 	const error = parsed === void 0 ? void 0 : asRecord$8(parsed["error"]);
-	const hint = error === void 0 ? "" : textOf$5(error["hint"]);
+	const hint = error === void 0 ? "" : textOf$7(error["hint"]);
 	return hint === "" ? void 0 : hint;
 }
 function sameOrigin(left, right) {
@@ -857,7 +858,7 @@ function urlOf(stdout) {
 	const bare = (stdout.split("\n").map((one) => one.trim()).filter((one) => one !== "")[0] ?? "").replace(/^url:\s*/i, "").trim().replace(/^["']+|["']+$/g, "");
 	if (bare.startsWith("{")) {
 		const parsed = asRecord$8(parseJsonLoose(bare));
-		const url = parsed === void 0 ? "" : textOf$5(parsed["url"]);
+		const url = parsed === void 0 ? "" : textOf$7(parsed["url"]);
 		if (url !== "") return url;
 	}
 	return bare;
@@ -1108,7 +1109,7 @@ var TARGET_CODE = {
 function asRecord$7(value) {
 	return typeof value === "object" && value !== null ? value : {};
 }
-function stringsOf$3(value) {
+function stringsOf$4(value) {
 	if (!Array.isArray(value)) return void 0;
 	const items = value.filter((item) => typeof item === "string" && item.trim() !== "");
 	return items.length === 0 ? void 0 : items;
@@ -1164,7 +1165,7 @@ function parseProvisionBody(body) {
 		request: requestOf$1(wanted, value.trim())
 	};
 	const registry = typeof raw.registry === "string" && raw.registry.trim() !== "" ? raw.registry.trim() : void 0;
-	const approvedBuilds = stringsOf$3(raw.approvedBuilds);
+	const approvedBuilds = stringsOf$4(raw.approvedBuilds);
 	const requestId = typeof raw.requestId === "string" && raw.requestId.trim() !== "" ? raw.requestId.trim() : void 0;
 	return {
 		ok: true,
@@ -1872,7 +1873,7 @@ var PLUGIN_LEDGER_FILE = "plugins.json";
 function ledgerKeyOf(entry) {
 	return `${entry.opencliHome}\u0000${entry.package}`;
 }
-function textOf$4(value) {
+function textOf$6(value) {
 	if (typeof value !== "string") return void 0;
 	const trimmed = value.trim();
 	return trimmed === "" ? void 0 : trimmed;
@@ -1880,13 +1881,13 @@ function textOf$4(value) {
 function entryOf(value) {
 	if (typeof value !== "object" || value === null) return void 0;
 	const box = value;
-	const opencliHome = textOf$4(box["opencliHome"]);
-	const pkg = textOf$4(box["package"]);
-	const installedAt = textOf$4(box["installedAt"]);
+	const opencliHome = textOf$6(box["opencliHome"]);
+	const pkg = textOf$6(box["package"]);
+	const installedAt = textOf$6(box["installedAt"]);
 	if (opencliHome === void 0 || pkg === void 0 || installedAt === void 0) return void 0;
-	const name = textOf$4(box["name"]);
-	const registry = textOf$4(box["registry"]);
-	const releasedAt = textOf$4(box["releasedAt"]);
+	const name = textOf$6(box["name"]);
+	const registry = textOf$6(box["registry"]);
+	const releasedAt = textOf$6(box["releasedAt"]);
 	return {
 		opencliHome,
 		package: pkg,
@@ -2107,7 +2108,7 @@ async function approvalFor(call, context = {}) {
 			reason: `问"要不要审批"的时候套件的策略抛了错，已经停下：${messageOf$1(error)}`
 		};
 	}
-	if (verdict?.kind === "read") return void 0;
+	if (verdict?.kind === "read" || verdict?.kind === "allow") return void 0;
 	if (verdict?.kind !== "ask") return {
 		kind: "deny",
 		reason: `${call.name ?? "这把工具"} 在清单里声明会写东西，但它的套件没认领这次调用 —— 停下：在套件的 needsApproval 里补一条审批（含"这次会发生什么"），别让写静默过去`
@@ -2497,7 +2498,7 @@ function profileDirOf(ctx) {
 	const dir = typeof profile?.dir === "string" ? profile.dir.trim() : "";
 	return dir === "" ? null : dir;
 }
-function stringsOf$2(value) {
+function stringsOf$3(value) {
 	return Array.isArray(value) ? value.filter((item) => typeof item === "string") : [];
 }
 function profileManifestOf(profileDir) {
@@ -2511,7 +2512,7 @@ function profileManifestOf(profileDir) {
 function profileModules(profileDir) {
 	const record = profileManifestOf(profileDir);
 	if (record === void 0) return [];
-	const bundles = stringsOf$2(asRecord$5(asRecord$5(record.dsh)?.profile)?.bundles);
+	const bundles = stringsOf$3(asRecord$5(asRecord$5(record.dsh)?.profile)?.bundles);
 	const dependencies = asRecord$5(record.dependencies) ?? {};
 	const names = bundles.length > 0 ? bundles : Object.keys(dependencies);
 	const found = [];
@@ -2661,7 +2662,7 @@ function readProfilePackage(profileDir, pkg) {
 //#endregion
 //#region src/shared/api/host/profile-registries.ts
 var REGISTRY_MARKER = "# dsh-workbench 写的：这一行的包只在这个源上（dsh 卸载没有源参数，pnpm 得问得到）";
-function scopeOf(pkg) {
+function scopeOf$1(pkg) {
 	const slash = pkg.indexOf("/");
 	return pkg.startsWith("@") && slash > 1 ? pkg.slice(0, slash) : null;
 }
@@ -2701,7 +2702,7 @@ function sourcesFromLockfile(text) {
 		if (name === null) continue;
 		const tarball = TARBALL.exec(line);
 		if (tarball === null) continue;
-		const scope = scopeOf(name);
+		const scope = scopeOf$1(name);
 		const root = registryRootOf(name, tarball[1] ?? "");
 		name = null;
 		if (scope === null || root === null) continue;
@@ -2832,26 +2833,121 @@ function inWorkshopSession(ctx, workspace) {
 }
 //#endregion
 //#region src/modules/panels/unit.ts
-var PANELS_TOOL = "workbench_panels";
-var MODULES_TOOL = "workbench_modules";
-var DIY_TOOL = "workbench_diy";
+var PANELS_LIST_TOOL = "workbench_panels_list";
+var PANELS_SHOW_TOOL = "workbench_panels_show";
+var PANELS_HIDE_TOOL = "workbench_panels_hide";
+var PANELS_MOVE_TOOL = "workbench_panels_move";
+var PANELS_RESET_TOOL = "workbench_panels_reset";
+var PANELS_FOLLOW_TOOL = "workbench_panels_follow";
+var MODULES_LIST_TOOL = "workbench_modules_list";
+var MODULES_INSTALL_TOOL = "workbench_modules_install";
+var MODULES_UPDATE_TOOL = "workbench_modules_update";
+var MODULES_UNINSTALL_TOOL = "workbench_modules_uninstall";
+var MODULES_INSTALL_BUNDLE_TOOL = "workbench_modules_install_bundle";
+var MODULES_UPDATE_DEPENDENCY_TOOL = "workbench_modules_update_dependency";
+var MODULES_UPDATE_PLUGIN_TOOL = "workbench_modules_update_plugin";
+var MODULES_UNINSTALL_PLUGIN_TOOL = "workbench_modules_uninstall_plugin";
+var MODULES_UPDATE_WORKBENCH_TOOL = "workbench_modules_update_workbench";
+var DIY_LIST_TOOL = "workbench_diy_list";
+var DIY_STATUS_TOOL = "workbench_diy_status";
+var DIY_PANEL_TOOL = "workbench_diy_panel";
+var DIY_RECON_TOOL = "workbench_diy_recon";
+var DIY_PROBE_TOOL = "workbench_diy_probe";
+var DIY_LOOK_TOOL = "workbench_diy_look";
+var DIY_INSTALL_TOOL = "workbench_diy_install";
+var DIY_SHOW_TOOL = "workbench_diy_show";
+var DIY_CLICK_TOOL = "workbench_diy_click";
+var DIY_TYPE_TOOL = "workbench_diy_type";
+var DIY_FILL_TOOL = "workbench_diy_fill";
+var DIY_KEYS_TOOL = "workbench_diy_keys";
+var DIY_HOVER_TOOL = "workbench_diy_hover";
+var DIY_SELECT_TOOL = "workbench_diy_select";
+var DIY_SCROLL_TOOL = "workbench_diy_scroll";
+var DIY_RELOAD_TOOL = "workbench_diy_reload";
+var DIY_VIEWPORT_TOOL = "workbench_diy_viewport";
+var DIY_NET_WATCH_TOOL = "workbench_diy_net_watch";
+var DIY_NET_READ_TOOL = "workbench_diy_net_read";
+var DIY_NET_STOP_TOOL = "workbench_diy_net_stop";
+var DIY_LOGS_WATCH_TOOL = "workbench_diy_logs_watch";
+var DIY_LOGS_READ_TOOL = "workbench_diy_logs_read";
+var DIY_LOGS_STOP_TOOL = "workbench_diy_logs_stop";
+var READ_TOOLS = [
+	PANELS_LIST_TOOL,
+	MODULES_LIST_TOOL,
+	DIY_LIST_TOOL,
+	DIY_STATUS_TOOL,
+	DIY_PANEL_TOOL,
+	DIY_RECON_TOOL,
+	DIY_PROBE_TOOL,
+	DIY_LOOK_TOOL,
+	DIY_CLICK_TOOL,
+	DIY_TYPE_TOOL,
+	DIY_FILL_TOOL,
+	DIY_KEYS_TOOL,
+	DIY_HOVER_TOOL,
+	DIY_SELECT_TOOL,
+	DIY_SCROLL_TOOL,
+	DIY_RELOAD_TOOL,
+	DIY_VIEWPORT_TOOL,
+	DIY_NET_WATCH_TOOL,
+	DIY_NET_READ_TOOL,
+	DIY_NET_STOP_TOOL,
+	DIY_LOGS_WATCH_TOOL,
+	DIY_LOGS_READ_TOOL,
+	DIY_LOGS_STOP_TOOL
+];
+var WRITE_TOOLS = [
+	PANELS_SHOW_TOOL,
+	PANELS_HIDE_TOOL,
+	PANELS_MOVE_TOOL,
+	PANELS_RESET_TOOL,
+	PANELS_FOLLOW_TOOL,
+	MODULES_INSTALL_TOOL,
+	MODULES_UPDATE_TOOL,
+	MODULES_UNINSTALL_TOOL,
+	MODULES_INSTALL_BUNDLE_TOOL,
+	MODULES_UPDATE_DEPENDENCY_TOOL,
+	MODULES_UPDATE_PLUGIN_TOOL,
+	MODULES_UNINSTALL_PLUGIN_TOOL,
+	MODULES_UPDATE_WORKBENCH_TOOL,
+	DIY_INSTALL_TOOL,
+	DIY_SHOW_TOOL
+];
+var DIY_TOOLS = [
+	DIY_LIST_TOOL,
+	DIY_STATUS_TOOL,
+	DIY_PANEL_TOOL,
+	DIY_RECON_TOOL,
+	DIY_PROBE_TOOL,
+	DIY_LOOK_TOOL,
+	DIY_INSTALL_TOOL,
+	DIY_SHOW_TOOL,
+	DIY_CLICK_TOOL,
+	DIY_TYPE_TOOL,
+	DIY_FILL_TOOL,
+	DIY_KEYS_TOOL,
+	DIY_HOVER_TOOL,
+	DIY_SELECT_TOOL,
+	DIY_SCROLL_TOOL,
+	DIY_RELOAD_TOOL,
+	DIY_VIEWPORT_TOOL,
+	DIY_NET_WATCH_TOOL,
+	DIY_NET_READ_TOOL,
+	DIY_NET_STOP_TOOL,
+	DIY_LOGS_WATCH_TOOL,
+	DIY_LOGS_READ_TOOL,
+	DIY_LOGS_STOP_TOOL
+];
 var panelsUnit = {
 	id: "panels",
 	card: null,
-	tools: [
-		{
-			name: PANELS_TOOL,
-			writes: true
-		},
-		{
-			name: MODULES_TOOL,
-			writes: true
-		},
-		{
-			name: DIY_TOOL,
-			writes: true
-		}
-	],
+	tools: [...READ_TOOLS.map((name) => ({
+		name,
+		writes: false
+	})), ...WRITE_TOOLS.map((name) => ({
+		name,
+		writes: true
+	}))],
 	host: {
 		inject: [],
 		optional: ["tools", "shell"]
@@ -2859,14 +2955,6 @@ var panelsUnit = {
 };
 //#endregion
 //#region src/modules/panels/model/approval.ts
-var READ = { kind: "read" };
-var READ_ONLY_ACTIONS = /* @__PURE__ */ new Set([
-	"list",
-	"status",
-	"probe",
-	"recon",
-	""
-]);
 var SPEC_LIMIT = 80;
 function missing(id) {
 	return id === void 0 || id === "";
@@ -2874,6 +2962,12 @@ function missing(id) {
 function pad(token) {
 	return token.startsWith("[") ? ` ${token} ` : token;
 }
+function pair(zh, en) {
+	return {
+		zh,
+		en
+	};
+}
 function workbenchModule(id) {
 	return missing(id) ? {
 		zh: "工作台模块",
@@ -2883,12 +2977,6 @@ function workbenchModule(id) {
 		en: `the workbench [${id}] module`
 	};
 }
-function anyWorkbenchModule(id) {
-	return missing(id) ? {
-		zh: "工作台的一个模块",
-		en: "a workbench module"
-	} : workbenchModule(id);
-}
 function workbenchPlugin(id) {
 	return missing(id) ? {
 		zh: "工作台的 opencli 插件",
@@ -2916,18 +3004,24 @@ function workbenchPanelRow(id) {
 		en: `the workbench [${id}] module row`
 	};
 }
-function actionOf$1(call) {
-	const raw = call.arguments;
-	if (typeof raw !== "object" || raw === null) return {};
-	const value = raw;
-	const target = typeof value.plugin === "string" ? value.plugin : typeof value.name === "string" ? value.name : typeof value.id === "string" ? value.id : typeof value.unit === "string" ? value.unit : void 0;
-	const spec = typeof value.spec === "string" ? value.spec.replace(/\s+/g, " ").trim() : "";
-	return {
-		...typeof value.action === "string" ? { action: value.action } : {},
-		...target === void 0 ? {} : { id: target },
-		...spec === "" ? {} : { spec: spec.length > SPEC_LIMIT ? `${spec.slice(0, SPEC_LIMIT)}…` : spec }
+function specOf(raw) {
+	const spec = typeof raw["spec"] === "string" ? raw["spec"].replace(/\s+/g, " ").trim() : "";
+	if (spec === "") return "";
+	return spec.length > SPEC_LIMIT ? `${spec.slice(0, SPEC_LIMIT)}…` : spec;
+}
+function boardName(scope) {
+	return scope === "machine" ? {
+		zh: "机器级默认板",
+		en: "the machine-level board"
+	} : {
+		zh: "当前项目的面板",
+		en: "this project's panel"
 	};
 }
+function argsOf$1(call) {
+	const raw = call.arguments;
+	return typeof raw === "object" && raw !== null ? raw : {};
+}
 function askOf(reason, question, fallback) {
 	return {
 		kind: "ask",
@@ -2937,152 +3031,62 @@ function askOf(reason, question, fallback) {
 	};
 }
 var panelsApproval = (call) => {
-	const { action, id, spec } = actionOf$1(call);
-	const readAction = action !== void 0 && action !== "" && READ_ONLY_ACTIONS.has(action);
-	if (call.name === "workbench_modules") {
-		if (readAction) return READ;
-		if (action === "update-plugin" || action === "uninstall-plugin") {
-			const verb = action === "update-plugin" ? "更新" : "卸载";
-			const verbEn = action === "update-plugin" ? "update" : "uninstall";
-			const target = workbenchPlugin(id);
-			return askOf(`workbench_modules ${action} ${id ?? ""} changes an opencli plugin on this machine`, {
-				en: `it ${verbEn}s ${target.en}. Allow?`,
-				zh: `会${verb}${target.zh}，允许吗？`
-			}, {
-				en: `The agent wants to ${verbEn} ${target.en}. Allow?`,
-				zh: `agent 想${verb}${target.zh}，允许吗？`
-			});
-		}
-		if (action === "update-workbench") return askOf("workbench_modules update-workbench replaces the workbench itself with the new version from the registry", {
-			en: "it updates the workbench itself to the new version from the registry. Allow?",
-			zh: "会把工作台本身更新到源上的新版，允许吗？"
-		}, {
-			en: "The agent wants to update the workbench itself to the new version from the registry. Allow?",
-			zh: "agent 想把工作台本身更新到源上的新版，允许吗？"
-		});
-		if (action === "update-dependency") {
-			const target = workbenchDependency(id);
-			return askOf(`workbench_modules update-dependency ${id ?? ""} upgrades a shared dependency on this machine`, {
-				en: `it upgrades ${target.en}. Allow?`,
-				zh: `会升级${target.zh}，允许吗？`
-			}, {
-				en: `The agent wants to upgrade ${target.en}. Allow?`,
-				zh: `agent 想升级${target.zh}，允许吗？`
-			});
-		}
-		if (action === "install-bundle" && spec !== void 0) return askOf(`workbench_modules install-bundle ${spec} installs a workbench module from a spec`, {
-			en: `it installs the workbench module from [${spec}]. Allow?`,
-			zh: `会安装工作台模块 [${spec}]，允许吗？`
-		}, {
-			en: `The agent wants to install the workbench module from [${spec}]. Allow?`,
-			zh: `agent 想安装工作台模块 [${spec}]，允许吗？`
-		});
-		if (action === "install") {
+	if (call.name !== void 0 && DIY_TOOLS.includes(call.name)) return { kind: "allow" };
+	const raw = argsOf$1(call);
+	const text = (key) => {
+		const value = raw[key];
+		return typeof value === "string" && value !== "" ? value : void 0;
+	};
+	const id = text("id") ?? text("unit");
+	const plugin = text("plugin");
+	const spec = specOf(raw);
+	const scope = text("scope");
+	const board = boardName(scope);
+	switch (call.name) {
+		case PANELS_SHOW_TOOL: {
+			const row = workbenchPanelRow(id);
+			return askOf(`${PANELS_SHOW_TOOL} ${id ?? ""} puts a workbench module row on this project's board`, pair(`会把${row.zh}加回${board.zh}，允许吗？`, `it puts ${row.en} back on ${board.en}. Allow?`), pair(`agent 想把${row.zh}加到${board.zh}，允许吗？`, `The agent wants to put ${row.en} on ${board.en}. Allow?`));
+		}
+		case PANELS_HIDE_TOOL: {
+			const row = workbenchPanelRow(id);
+			return askOf(`${PANELS_HIDE_TOOL} ${id ?? ""} takes a workbench module row off this project's board`, pair(`会把${row.zh}从${board.zh}上收起，允许吗？`, `it takes ${row.en} off ${board.en} — its card and its tools go too. Allow?`), pair(`agent 想把${row.zh}收起，允许吗？`, `The agent wants to take ${row.en} off the board. Allow?`));
+		}
+		case PANELS_MOVE_TOOL: {
+			const row = workbenchPanelRow(id);
+			return askOf(`${PANELS_MOVE_TOOL} ${id ?? ""} reorders the workbench panel`, pair(`会把${row.zh}移到${board.zh}最前面，允许吗？`, `it moves ${row.en} to the front of ${board.en}. Allow?`), pair(`agent 想把${row.zh}移到最前面，允许吗？`, `The agent wants to move ${row.en} to the front. Allow?`));
+		}
+		case PANELS_RESET_TOOL: return askOf(`${PANELS_RESET_TOOL} clears the rows this project changed on the workbench panel`, pair(scope === "machine" ? "会清空工作台那份机器级默认板，允许吗？" : "会清空工作台在当前项目的面板，允许吗？", `it clears the rows this project changed on the workbench ${board.en}. Allow?`), pair(scope === "machine" ? "agent 想清空工作台那份机器级默认板，允许吗？" : "agent 想清空工作台在当前项目的面板，允许吗？", `The agent wants to clear this project's rows on the workbench ${board.en}. Allow?`));
+		case PANELS_FOLLOW_TOOL: {
+			const row = workbenchPanelRow(id);
+			return askOf(`${PANELS_FOLLOW_TOOL} ${id ?? ""} puts a workbench panel row back to following the machine-level board`, pair(`会把${row.zh}改回跟随机器级默认板，允许吗？`, `it puts ${row.en} back to following the machine-level board. Allow?`), pair(`agent 想把${row.zh}改回跟随机器级默认板，允许吗？`, `The agent wants to put ${row.en} back to following the machine-level board. Allow?`));
+		}
+		case MODULES_INSTALL_TOOL:
+		case MODULES_UPDATE_TOOL: {
+			const install = call.name === MODULES_INSTALL_TOOL;
+			const verb = install ? "装" : "升";
+			const verbEn = install ? "installs" : "upgrades";
+			return askOf(`${call.name} ${id ?? ""} changes the opencli plugins and libraries a workbench module declares`, pair(`会${verb}${workbenchModule(id).zh}要的插件与库，不换模块包本身，允许吗？`, `it ${verbEn} the plugins the ${workbenchModule(id).en} declares, without replacing its package. Allow?`), pair(`agent 想${verb}${workbenchModule(id).zh}要的插件与库，允许吗？`, `The agent wants to ${install ? "install" : "upgrade"} the plugins ${workbenchModule(id).en} declares. Allow?`));
+		}
+		case MODULES_UNINSTALL_TOOL: {
 			const target = workbenchModule(id);
-			return askOf(`workbench_modules install ${id ?? ""} installs a workbench module on this machine`, {
-				en: `it installs ${target.en}. Allow?`,
-				zh: `会安装${target.zh}，允许吗？`
-			}, {
-				en: `The agent wants to install ${target.en}. Allow?`,
-				zh: `agent 想安装${target.zh}，允许吗？`
-			});
+			return askOf(`${MODULES_UNINSTALL_TOOL} ${id ?? ""} removes a workbench module from this machine`, pair(`会把${target.zh}连它的包一起卸掉，允许吗？`, `it uninstalls ${target.en}, package included. Allow?`), pair(`agent 想卸载${target.zh}，允许吗？`, `The agent wants to uninstall ${target.en}. Allow?`));
 		}
-		if (action === "update") {
-			const target = workbenchModule(id);
-			return askOf(`workbench_modules update ${id ?? ""} updates a workbench module on this machine`, {
-				en: `it updates ${target.en}. Allow?`,
-				zh: `会更新${target.zh}，允许吗？`
-			}, {
-				en: `The agent wants to update ${target.en}. Allow?`,
-				zh: `agent 想更新${target.zh}，允许吗？`
-			});
+		case MODULES_INSTALL_BUNDLE_TOOL: return askOf(`${MODULES_INSTALL_BUNDLE_TOOL} ${spec} installs a module package into this profile`, pair(`会把 [${spec}] 装成工作台的模块包，允许吗？`, `it installs [${spec}] as a workbench module package. Allow?`), pair(`agent 想装工作台的模块包 [${spec}]，允许吗？`, `The agent wants to install the workbench module package [${spec}]. Allow?`));
+		case MODULES_UPDATE_DEPENDENCY_TOOL: {
+			const target = workbenchDependency(id);
+			return askOf(`${MODULES_UPDATE_DEPENDENCY_TOOL} ${id ?? ""} upgrades a shared dependency on this machine`, pair(`会升级${target.zh}，允许吗？`, `it upgrades ${target.en}. Allow?`), pair(`agent 想升级${target.zh}，允许吗？`, `The agent wants to upgrade ${target.en}. Allow?`));
 		}
-		if (action === "uninstall") {
-			const target = workbenchModule(id);
-			return askOf(`workbench_modules uninstall ${id ?? ""} removes a workbench module from this machine`, {
-				en: `it uninstalls ${target.en}. Allow?`,
-				zh: `会卸载${target.zh}，允许吗？`
-			}, {
-				en: `The agent wants to uninstall ${target.en}. Allow?`,
-				zh: `agent 想卸载${target.zh}，允许吗？`
-			});
+		case MODULES_UPDATE_PLUGIN_TOOL: {
+			const target = workbenchPlugin(plugin);
+			return askOf(`${MODULES_UPDATE_PLUGIN_TOOL} ${plugin ?? ""} updates an opencli plugin on this machine`, pair(`会更新${target.zh}，允许吗？`, `it updates ${target.en}. Allow?`), pair(`agent 想更新${target.zh}，允许吗？`, `The agent wants to update ${target.en}. Allow?`));
 		}
-		return askOf(`workbench_modules ${action ?? "(unknown action)"} ${id ?? ""} changes plugins on this machine`.trim(), {
-			en: "it changes the plugins installed in the workbench. Allow?",
-			zh: "会改动工作台装的插件，允许吗？"
-		}, {
-			en: "The agent wants to change the plugins installed in the workbench. Allow?",
-			zh: "agent 想改动工作台装的插件，允许吗？"
-		});
-	}
-	if (call.name === "workbench_diy") {
-		if (readAction) return READ;
-		if (action === "open") {
-			const target = anyWorkbenchModule(id);
-			return askOf("workbench_diy open puts an already-installed module on this project panel", {
-				en: `it shows ${target.en} on this project's panel. Allow?`,
-				zh: `会把${target.zh}显示在当前项目的面板上，允许吗？`
-			}, {
-				en: `The agent wants to show ${target.en} on this project's panel. Allow?`,
-				zh: `agent 想把${target.zh}显示在当前项目的面板上，允许吗？`
-			});
+		case MODULES_UNINSTALL_PLUGIN_TOOL: {
+			const target = workbenchPlugin(plugin);
+			return askOf(`${MODULES_UNINSTALL_PLUGIN_TOOL} ${plugin ?? ""} uninstalls an opencli plugin on this machine`, pair(`会卸载${target.zh}，允许吗？`, `it uninstalls ${target.en}. Allow?`), pair(`agent 想卸载${target.zh}，允许吗？`, `The agent wants to uninstall ${target.en}. Allow?`));
 		}
-		const target = workbenchModule(id);
-		return askOf(`workbench_diy ${action ?? "(unknown action)"} installs a module built in the workshop and opens it on this project's panel`, {
-			en: `it installs ${target.en} and opens it on this project's panel. Allow?`,
-			zh: `会安装${target.zh}，并上到当前项目的面板，允许吗？`
-		}, {
-			en: `The agent wants to install ${target.en} and open it on this project's panel. Allow?`,
-			zh: `agent 想安装${target.zh}，并上到当前项目的面板，允许吗？`
-		});
-	}
-	if (call.name !== "workbench_panels") return void 0;
-	if (readAction) return READ;
-	if (action === "hide") {
-		const target = anyWorkbenchModule(id);
-		return askOf("workbench_panels hide removes a module from the panel", {
-			en: `it takes ${target.en} off this project's panel. Allow?`,
-			zh: `会把${target.zh}从当前项目的面板上收起来，允许吗？`
-		}, {
-			en: `The agent wants to take ${target.en} off this project's panel. Allow?`,
-			zh: `agent 想把${target.zh}从当前项目的面板上收起来，允许吗？`
-		});
-	}
-	if (action === "move") {
-		const target = anyWorkbenchModule(id);
-		return askOf("workbench_panels move reorders the panel", {
-			en: `it moves ${target.en} to the front of this project's panel. Allow?`,
-			zh: `会把${target.zh}移到当前项目面板的最前面，允许吗？`
-		}, {
-			en: `The agent wants to move ${target.en} to the front of this project's panel. Allow?`,
-			zh: `agent 想把${target.zh}移到当前项目面板的最前面，允许吗？`
-		});
-	}
-	if (action === "reset") return askOf("workbench_panels reset clears the panel", {
-		en: `it clears the workbench panel for this project. Allow?`,
-		zh: "会清空工作台在当前项目的面板，允许吗？"
-	}, {
-		en: "The agent wants to clear the workbench panel for this project. Allow?",
-		zh: "agent 想清空工作台在当前项目的面板，允许吗？"
-	});
-	if (action === "follow") {
-		const target = workbenchPanelRow(id);
-		return askOf("workbench_panels follow puts a row back to following the machine-level board", {
-			en: `it puts ${target.en} back to following the machine-level board. Allow?`,
-			zh: `会把${target.zh}改回跟随机器级默认板，允许吗？`
-		}, {
-			en: `The agent wants to put ${target.en} back to following the machine-level board. Allow?`,
-			zh: `agent 想把${target.zh}改回跟随机器级默认板，允许吗？`
-		});
+		case MODULES_UPDATE_WORKBENCH_TOOL: return askOf(`${MODULES_UPDATE_WORKBENCH_TOOL} replaces the workbench itself with the new version from the registry`, pair("会把工作台本身更新到源上的新版，允许吗？", "it updates the workbench itself to the new version from the registry. Allow?"), pair("agent 想把工作台本身更新到源上的新版，允许吗？", "The agent wants to update the workbench itself from the registry. Allow?"));
+		default: return;
 	}
-	const target = anyWorkbenchModule(id);
-	return askOf(`workbench_panels ${action ?? "(unknown action)"} changes the user's panel`, {
-		en: `it adds ${target.en} to this project's panel. Allow?`,
-		zh: `会把${target.zh}加到当前项目的面板上，允许吗？`
-	}, {
-		en: `The agent wants to add ${target.en} to this project's panel. Allow?`,
-		zh: `agent 想把${target.zh}加到当前项目的面板上，允许吗？`
-	});
 };
 //#endregion
 //#region src/modules/panels/model/config.ts
@@ -3264,116 +3268,1983 @@ function opencliCommandOf(ctx) {
 		isolated
 	};
 }
-//#endregion
-//#region src/shared/api/host/diy-recon.ts
-var SITE_LIMIT = 6;
-var COMMAND_LIMIT = 12;
-var SHOWN_LIMIT = 6;
-var PLUGIN_PREFIX = "opencli-plugin-";
-function text(value) {
+var OUTPUT$2 = {
+	schema: {
+		type: "object",
+		properties: {
+			text: { type: "string" },
+			workshop: { type: "string" },
+			modules: {
+				type: "array",
+				items: {
+					type: "object",
+					additionalProperties: true
+				}
+			},
+			unit: { type: "string" },
+			path: { type: "string" },
+			install: {
+				type: "object",
+				additionalProperties: true
+			},
+			alreadyInstalled: { type: "boolean" },
+			panel: {
+				type: "object",
+				additionalProperties: true
+			}
+		},
+		additionalProperties: true
+	},
+	render: (_args, value) => {
+		const payload = value;
+		return [{
+			type: "text",
+			text: typeof payload?.text === "string" ? payload.text : JSON.stringify(value)
+		}];
+	}
+};
+function asRecord$3(value) {
+	return typeof value === "object" && value !== null ? value : {};
+}
+function asNumber(value) {
+	if (typeof value === "number" && Number.isFinite(value)) return value;
+	if (typeof value === "string" && value.trim() !== "") {
+		const parsed = Number(value);
+		if (Number.isFinite(parsed)) return parsed;
+	}
+}
+function asText$1(value) {
 	return typeof value === "string" ? value.trim() : "";
 }
-function stringsOf$1(value) {
-	return Array.isArray(value) ? value.filter((one) => typeof one === "string") : [];
+function plainJson(value) {
+	return JSON.parse(JSON.stringify(value));
 }
-function manifestCommandsOf(raw) {
-	let parsed;
-	try {
-		parsed = JSON.parse(raw);
-	} catch {
-		return [];
+function verdictOf$1(change) {
+	if (change.application === "applied") return "装好了，已生效";
+	if (change.application === "restart-required") return "装好了，要重启一次才生效（装新模块、同名重装、替换已有包都走这一支）";
+	if (change.application === "overridden") return "被更高层的声明盖住了，这次没生效";
+	if (change.application === "cancelled") return "安装被取消，没有生效";
+	const tail = (change.packageResult?.output ?? "").trim().split("\n").slice(-3).join(" | ");
+	return `没装上（${change.errorCode ?? "failed"}）${tail === "" ? "" : `：${tail}`}`;
+}
+function renderProbe(out) {
+	if (out.ok) return `读到了 —— 这就是那条读的返回值，把它固化成模块宿主半侧的那一条：\n${(JSON.stringify(out.value, null, 2) ?? "undefined").slice(0, 2e3)}`;
+	const lines = [`没读到（${out.code}）：${out.message}`];
+	if (out.hint !== void 0) lines.push(`照做：${out.hint}`);
+	if (out.helpUrl !== void 0) lines.push(`入口：${out.helpUrl}`);
+	if (out.pageCode !== void 0) lines.push(`页面自己回的码：${out.pageCode}`);
+	return lines.join("\n");
+}
+function renderFind(out) {
+	if (!out.ok) {
+		const lines = [`没找到（${out.code}）：${out.message}`];
+		if (out.hint !== void 0) lines.push(`照做：${out.hint}`);
+		if (out.helpUrl !== void 0) lines.push(`入口：${out.helpUrl}`);
+		return lines.join("\n");
 	}
-	if (!Array.isArray(parsed)) return [];
-	const commands = [];
-	for (const one of parsed) {
-		if (typeof one !== "object" || one === null) continue;
-		const row = one;
-		const declared = text(row["command"]);
-		const site = text(row["site"]) || declared.split("/")[0] || "";
-		const name = text(row["name"]) || declared.split("/")[1] || "";
-		const command = declared === "" ? site === "" || name === "" ? "" : `${site}/${name}` : declared;
-		if (command === "" || site === "") continue;
-		const access = text(row["access"]);
-		commands.push({
-			command,
-			site,
-			name: name === "" ? command.slice(command.indexOf("/") + 1) : name,
-			domain: text(row["domain"]).toLowerCase(),
-			description: text(row["description"]),
-			access: access === "" ? "read" : access,
-			strategy: text(row["strategy"]).toLowerCase(),
-			browser: row["browser"] === true,
-			example: text(row["example"]),
-			columns: stringsOf$1(row["columns"])
-		});
+	if (out.count === 0) return "找到了 0 个元素 —— 选择器没匹配到东西。先确认停在哪一页（probe 会自己问页面），再把选择器放宽一点（例如 table tr 而不是某个 id）。";
+	const head = out.entries.slice(0, 20).map((one, index) => `${String(index + 1)}. ${one.text.replace(/\n+/g, " | ").slice(0, 200)}`);
+	const more = out.entries.length > 20 ? `\n… 还有 ${String(out.entries.length - 20)} 个` : "";
+	return `找到了 ${String(out.count)} 个元素 —— 每行的单元格按换行拼在 text 里；把它固化成模块宿主半侧的那一条（host 的 browserFind + 切格 + 按列序取值）：\n${head.join("\n")}${more}`;
+}
+function showOrReason(panels, unit, workspace) {
+	try {
+		panels.show(unit, workspace);
+		return { ok: true };
+	} catch (error) {
+		return {
+			ok: false,
+			reason: error instanceof Error ? error.message : String(error)
+		};
 	}
-	return commands;
 }
-function pluginNamesOf(entries) {
-	return entries.filter((one) => one.startsWith(PLUGIN_PREFIX)).map((one) => one.slice(15)).filter((one) => one !== "").sort();
+function workshopOf(ctx, exec) {
+	const packagesDir = workshopPackagesDir(ctx);
+	if (packagesDir === null) throw new Error("算不出 DIY 工坊在哪（这台机器没给出 dshHomePath）—— 让用户跑一次 dsh-workbench setup");
+	const session = sessionWorkspace(exec);
+	if (!inWorkshopSession(ctx, session)) throw new Error(`这把工具只在 DIY 工坊里用：当前会话不在工坊里（这个会话的工作区 ${session ?? "(不知道)"}）—— 普通项目里装模块用 workbench_modules_install，工坊的入口是左栏那一行「工作台DIY」`);
+	return {
+		packagesDir,
+		workspace: session
+	};
 }
-function pluginCommandsOf(files) {
-	return files.filter((one) => one.endsWith(".js")).map((one) => one.slice(0, -3)).filter((one) => one !== "index" && !one.startsWith("_")).sort();
+function modulesOf(ctx, packagesDir) {
+	const installed = profileModules(profileDirOf(ctx)).map((row) => row.unit);
+	return {
+		installed,
+		modules: workshopModules(packagesDir, installed)
+	};
 }
-function hostOf(url) {
-	const trimmed = url.trim();
-	if (trimmed === "") return "";
+function panelEntriesOf(panels, workspace) {
 	try {
-		return new URL(trimmed).hostname.toLowerCase().replace(/^www\./, "");
+		return panels.list(workspace);
 	} catch {
-		return "";
+		return [];
 	}
 }
-function keywordsOf(keyword, url) {
-	const words = /* @__PURE__ */ new Set();
-	const trimmed = keyword.trim().toLowerCase();
-	if (trimmed !== "") words.add(trimmed);
-	const host = hostOf(url);
-	if (host !== "") words.add(host);
-	return [...words];
+//#endregion
+//#region src/shared/api/host/png-crop.ts
+var SIGNATURE = Buffer.from([
+	137,
+	80,
+	78,
+	71,
+	13,
+	10,
+	26,
+	10
+]);
+var CHANNELS = {
+	0: 1,
+	2: 3,
+	4: 2,
+	6: 4
+};
+var CRC_TABLE = (() => {
+	const table = /* @__PURE__ */ new Int32Array(256);
+	for (let index = 0; index < 256; index += 1) {
+		let value = index;
+		for (let bit = 0; bit < 8; bit += 1) value = (value & 1) === 1 ? 3988292384 ^ value >>> 1 : value >>> 1;
+		table[index] = value;
+	}
+	return table;
+})();
+function crc32(bytes) {
+	let value = -1;
+	for (const byte of bytes) value = CRC_TABLE[(value ^ byte) & 255] ^ value >>> 8;
+	return (value ^ -1) >>> 0;
+}
+function chunkOf(type, data) {
+	const head = Buffer.alloc(4);
+	head.writeUInt32BE(data.length, 0);
+	const body = Buffer.concat([Buffer.from(type, "latin1"), data]);
+	const tail = Buffer.alloc(4);
+	tail.writeUInt32BE(crc32(body), 0);
+	return Buffer.concat([
+		head,
+		body,
+		tail
+	]);
 }
-function scoreOf(command, word) {
-	const site = command.site.toLowerCase();
-	const name = command.name.toLowerCase();
-	if (word === "") return 0;
-	if (site === word) return 100;
-	if (site.includes(word)) return 80;
-	if (command.domain !== "" && command.domain.includes(word)) return 70;
-	if (site.length >= 3 && word.includes(site)) return 45;
-	if (name === word) return 65;
-	if (name.includes(word)) return 55;
-	if (command.command.toLowerCase().includes(word)) return 50;
-	if (command.description.toLowerCase().includes(word)) return 30;
-	return 0;
+function paethOf(left, above, corner) {
+	const estimate = left + above - corner;
+	const toLeft = Math.abs(estimate - left);
+	const toAbove = Math.abs(estimate - above);
+	const toCorner = Math.abs(estimate - corner);
+	if (toLeft <= toAbove && toLeft <= toCorner) return left;
+	return toAbove <= toCorner ? above : corner;
+}
+function headerOf(bytes) {
+	if (bytes.length < 8 || !bytes.subarray(0, 8).equals(SIGNATURE)) return { reason: "不是一张 PNG" };
+	let at = 8;
+	let raw;
+	const parts = [];
+	while (at + 8 <= bytes.length) {
+		const length = bytes.readUInt32BE(at);
+		const type = bytes.toString("latin1", at + 4, at + 8);
+		const data = bytes.subarray(at + 8, at + 8 + length);
+		if (type === "IHDR") raw = {
+			width: data.readUInt32BE(0),
+			height: data.readUInt32BE(4),
+			depth: data[8] ?? 0,
+			color: data[9] ?? 0,
+			interlace: data[12] ?? 0
+		};
+		else if (type === "IDAT") parts.push(Buffer.from(data));
+		else if (type === "IEND") break;
+		at += 12 + length;
+	}
+	if (raw === void 0) return { reason: "这张 PNG 没有 IHDR" };
+	const channels = CHANNELS[raw.color] ?? 0;
+	if (raw.depth !== 8 || channels === 0) return { reason: `这张 PNG 的形状不认（位深 ${String(raw.depth)} / 颜色类型 ${String(raw.color)}）` };
+	if (raw.interlace !== 0) return { reason: "这张 PNG 是隔行的，不认" };
+	return { header: {
+		...raw,
+		channels
+	} };
 }
-function reconOf(commands, plugins, keywords) {
-	const keyword = keywords[0] ?? "";
-	const best = /* @__PURE__ */ new Map();
-	for (const command of commands) {
-		let score = 0;
-		for (const word of keywords) score = Math.max(score, scoreOf(command, word));
-		if (score === 0) continue;
-		const current = best.get(command.command);
-		if (current === void 0 || current.score < score) best.set(command.command, {
-			command,
-			score
-		});
+function rowsOf$1(header, parts, keep) {
+	const stride = header.width * header.channels;
+	const inflated = inflateSync(Buffer.concat(parts));
+	const above = Buffer.alloc(stride);
+	const current = Buffer.alloc(stride);
+	const out = Buffer.alloc(stride * keep);
+	let at = 0;
+	for (let y = 0; y < header.height; y += 1) {
+		const filter = inflated[at] ?? 0;
+		const line = inflated.subarray(at + 1, at + 1 + stride);
+		at += 1 + stride;
+		for (let i = 0; i < stride; i += 1) {
+			const source = line[i] ?? 0;
+			const left = i >= header.channels ? current[i - header.channels] ?? 0 : 0;
+			const up = above[i] ?? 0;
+			const corner = i >= header.channels ? above[i - header.channels] ?? 0 : 0;
+			const value = filter === 0 ? source : filter === 1 ? source + left : filter === 2 ? source + up : filter === 3 ? source + (left + up >> 1) : source + paethOf(left, up, corner);
+			current[i] = value & 255;
+		}
+		if (y < keep) current.copy(out, y * stride);
+		above.set(current);
+		if (y + 1 >= keep) break;
 	}
-	const grouped = /* @__PURE__ */ new Map();
-	for (const entry of best.values()) {
-		const group = grouped.get(entry.command.site) ?? {
-			best: 0,
-			rows: []
+	return out;
+}
+function encodeOf(width, height, color, pixels) {
+	const stride = width * (CHANNELS[color] ?? 3);
+	const raw = Buffer.alloc((stride + 1) * height);
+	for (let y = 0; y < height; y += 1) {
+		raw[y * (stride + 1)] = 0;
+		pixels.copy(raw, y * (stride + 1) + 1, y * stride, (y + 1) * stride);
+	}
+	const ihdr = Buffer.alloc(13);
+	ihdr.writeUInt32BE(width, 0);
+	ihdr.writeUInt32BE(height, 4);
+	ihdr[8] = 8;
+	ihdr[9] = color;
+	return Buffer.concat([
+		SIGNATURE,
+		chunkOf("IHDR", ihdr),
+		chunkOf("IDAT", deflateSync(raw, { level: 9 })),
+		chunkOf("IEND", Buffer.alloc(0))
+	]);
+}
+function cropPng(bytes, rect) {
+	const found = headerOf(bytes);
+	if ("reason" in found) return {
+		ok: false,
+		bytes: Buffer.alloc(0),
+		width: 0,
+		height: 0,
+		clamped: false,
+		reason: found.reason
+	};
+	const { header } = found;
+	const x = Math.max(0, Math.min(header.width - 1, Math.trunc(rect.x)));
+	const y = Math.max(0, Math.min(header.height - 1, Math.trunc(rect.y)));
+	const width = Math.max(1, Math.min(header.width - x, Math.trunc(rect.width)));
+	const height = Math.max(1, Math.min(header.height - y, Math.trunc(rect.height)));
+	const clamped = x !== Math.trunc(rect.x) || y !== Math.trunc(rect.y) || width !== Math.trunc(rect.width) || height !== Math.trunc(rect.height);
+	const parts = [];
+	let at = 8;
+	while (at + 8 <= bytes.length) {
+		const length = bytes.readUInt32BE(at);
+		const type = bytes.toString("latin1", at + 4, at + 8);
+		if (type === "IDAT") parts.push(Buffer.from(bytes.subarray(at + 8, at + 8 + length)));
+		if (type === "IEND") break;
+		at += 12 + length;
+	}
+	const stride = header.width * header.channels;
+	const rows = rowsOf$1(header, parts, y + height);
+	const outStride = width * header.channels;
+	const pixels = Buffer.alloc(outStride * height);
+	for (let row = 0; row < height; row += 1) {
+		const from = (y + row) * stride + x * header.channels;
+		rows.copy(pixels, row * outStride, from, from + outStride);
+	}
+	return {
+		ok: true,
+		bytes: encodeOf(width, height, header.color, pixels),
+		width,
+		height,
+		clamped,
+		reason: clamped ? "矩形超出图外，已经按边界收进来" : ""
+	};
+}
+function cropPngFile(input, output, rect) {
+	let source;
+	try {
+		source = readFileSync(input);
+	} catch (error) {
+		return {
+			ok: false,
+			clamped: false,
+			reason: `读不到那张截图：${error instanceof Error ? error.message : String(error)}`
 		};
-		group.best = Math.max(group.best, entry.score);
-		group.rows.push(entry);
-		grouped.set(entry.command.site, group);
 	}
-	const base = {
-		keyword,
-		sites: [...grouped.entries()].sort((left, right) => right[1].best - left[1].best || left[0].localeCompare(right[0])).slice(0, SITE_LIMIT).map(([site, group]) => {
-			const picked = [...group.rows].sort((left, right) => (left.command.access === "write" ? 1 : 0) - (right.command.access === "write" ? 1 : 0) || right.score - left.score || left.command.command.localeCompare(right.command.command)).slice(0, COMMAND_LIMIT).map((one) => one.command);
-			const first = picked[0];
+	const cropped = cropPng(source, rect);
+	if (!cropped.ok) return {
+		ok: false,
+		clamped: false,
+		reason: cropped.reason
+	};
+	try {
+		writeFileSync(output, cropped.bytes);
+	} catch (error) {
+		return {
+			ok: false,
+			clamped: false,
+			reason: `裁好的图写不回去：${error instanceof Error ? error.message : String(error)}`
+		};
+	}
+	return {
+		ok: true,
+		clamped: cropped.clamped,
+		reason: cropped.reason
+	};
+}
+//#endregion
+//#region src/modules/panels/model/diy-scripts.ts
+function textOf$5(value) {
+	return typeof value === "string" ? value.trim() : "";
+}
+function numberIn$1(value, fallback) {
+	return typeof value === "number" && Number.isFinite(value) ? value : fallback;
+}
+var PAGE_PROBE = `(async () => {
+  const answer = await fetch('/workbench/api/health').then((one) => one.json()).catch(() => null);
+  return JSON.stringify({
+    plugin: answer === null ? null : answer.plugin,
+    pid: answer === null ? null : answer.pid,
+    url: location.href,
+    title: document.title,
+  });
+})()`;
+function cardSelectorOf(unit) {
+	return `#wb-card-${unit}`;
+}
+var DOM_MODES = [
+	"none",
+	"outline",
+	"html"
+];
+var DEFAULT_PROPS = [
+	"display",
+	"flexDirection",
+	"gap",
+	"padding",
+	"width",
+	"height",
+	"overflow",
+	"backgroundColor",
+	"color",
+	"borderRadius",
+	"fontSize",
+	"lineHeight",
+	"fontFamily",
+	"boxSizing",
+	"--dsw-radius-xl",
+	"--dsw-alias-bg-layer-1",
+	"--dsw-alias-label-primary"
+];
+var DEFAULT_PARTS = [".wb-cardHead", ".wb-cardBody"];
+var MAX_PROPS = 40;
+var MAX_PARTS = 6;
+function cleanNames(value, cap) {
+	if (!Array.isArray(value)) return [];
+	const out = [];
+	for (const one of value) {
+		if (typeof one !== "string") continue;
+		const trimmed = one.trim();
+		if (trimmed === "" || trimmed.length > 80 || out.includes(trimmed)) continue;
+		out.push(trimmed);
+		if (out.length >= cap) break;
+	}
+	return out;
+}
+function pickOf(raw) {
+	const props = cleanNames(raw["props"], MAX_PROPS);
+	const parts = cleanNames(raw["parts"], MAX_PARTS);
+	const asked = textOf$5(raw["dom"]);
+	return {
+		props: props.length === 0 ? [...DEFAULT_PROPS] : props,
+		parts: parts.length === 0 ? [...DEFAULT_PARTS] : parts,
+		dom: DOM_MODES.includes(asked) ? asked : "outline"
+	};
+}
+var NO_PICK = {
+	card: {},
+	parts: {}
+};
+var EMPTY_CARD = {
+	ok: false,
+	anchored: false,
+	width: 0,
+	height: 0,
+	head: "",
+	text: "",
+	clipped: false,
+	cards: 0,
+	rect: {
+		x: 0,
+		y: 0,
+		width: 0,
+		height: 0
+	},
+	dpr: 1,
+	viewport: {
+		width: 0,
+		height: 0
+	},
+	pick: NO_PICK,
+	slot: {
+		parentWidth: 0,
+		parentDisplay: "",
+		columns: "",
+		index: 0,
+		cards: 0,
+		viewportHeight: 0,
+		scrollHeight: 0
+	},
+	outline: [],
+	html: ""
+};
+function measureScriptOf(unit, pick) {
+	return `(() => {
+  const props = ${JSON.stringify([...pick.props])};
+  const parts = ${JSON.stringify([...pick.parts])};
+  const wantDom = ${JSON.stringify(pick.dom)};
+  const kebab = (one) => (one.startsWith('--') ? one : one.replace(/[A-Z]/g, (hit) => '-' + hit.toLowerCase()));
+  const scrub = (one) => (one ?? '').replace(/\\s+/g, ' ').trim();
+  const read = (el) => {
+    if (el === null || el === undefined) return {};
+    const computed = getComputedStyle(el);
+    const out = {};
+    for (const one of props) out[one] = computed.getPropertyValue(kebab(one)).trim().slice(0, 200);
+    return out;
+  };
+  const anchor = document.querySelector(${JSON.stringify(cardSelectorOf(unit))});
+  const all = [...document.querySelectorAll('.wb-card')];
+  if (anchor === null) return JSON.stringify({ ok: false, cards: all.length, anchored: false });
+  const card = anchor.classList.contains('wb-card') ? anchor : anchor.querySelector('.wb-card');
+  if (card === null) return JSON.stringify({ ok: false, cards: all.length, anchored: true });
+  const box = card.getBoundingClientRect();
+  const head = card.querySelector('.wb-cardTitle');
+  const text = scrub(card.textContent);
+  const shown = scrub(card.innerText);
+  const clipped = [...card.querySelectorAll('*')].some((one) => one.scrollWidth > one.clientWidth + 1);
+  const picked = {};
+  for (const one of parts) {
+    let found = null;
+    try {
+      found = card.querySelector(one);
+    } catch {
+      found = null;
+    }
+    picked[one] = found === null ? {} : read(found);
+  }
+  const parent = card.parentElement === anchor ? anchor.parentElement : card.parentElement;
+  let scrollable = parent;
+  while (scrollable !== null && !/(auto|scroll)/.test(getComputedStyle(scrollable).overflowY)) {
+    scrollable = scrollable.parentElement;
+  }
+  const outline = [];
+  if (wantDom === 'outline') {
+    const walk = (el, depth) => {
+      if (depth > 3 || outline.length >= 40) return;
+      const classed =
+        typeof el.className === 'string'
+          ? el.className.split(/\\s+/).filter((one) => one.startsWith('wb-')).slice(0, 2).join('.')
+          : '';
+      outline.push({
+        depth,
+        tag: el.tagName.toLowerCase(),
+        cls: classed,
+        role: el.getAttribute('role') ?? '',
+        name: el.getAttribute('aria-label') ?? '',
+        text: el.children.length === 0 ? scrub(el.textContent).slice(0, 30) : '',
+      });
+      for (const child of [...el.children]) walk(child, depth + 1);
+    };
+    walk(card, 0);
+  }
+  return JSON.stringify({
+    ok: true,
+    cards: all.length,
+    width: Math.ceil(box.width),
+    height: Math.ceil(box.height),
+    x: Math.round(box.x),
+    y: Math.round(box.y),
+    head: head === null ? '' : scrub(head.textContent),
+    text: (shown === '' ? text : shown).slice(0, 600),
+    clipped,
+    dpr: window.devicePixelRatio || 1,
+    vw: Math.round(window.innerWidth),
+    vh: Math.round(window.innerHeight),
+    slot: {
+      parentWidth: parent === null ? 0 : Math.round(parent.getBoundingClientRect().width),
+      parentDisplay: parent === null ? '' : getComputedStyle(parent).display,
+      columns: parent === null ? '' : getComputedStyle(parent).gridTemplateColumns,
+      index: all.indexOf(card),
+      cards: all.length,
+      viewportHeight: scrollable === null ? 0 : scrollable.clientHeight,
+      scrollHeight: scrollable === null ? 0 : scrollable.scrollHeight,
+    },
+    outline,
+    html: wantDom === 'html' ? card.outerHTML.slice(0, 4000) : '',
+    pick: { card: read(card), parts: picked },
+  });
+})()`;
+}
+function nodesOf(value) {
+	if (!Array.isArray(value)) return [];
+	const out = [];
+	for (const one of value) {
+		if (typeof one !== "object" || one === null) continue;
+		const record = one;
+		const depth = numberIn$1(record["depth"], -1);
+		const tag = textOf$5(record["tag"]);
+		if (depth < 0 || tag === "") continue;
+		out.push({
+			depth,
+			tag,
+			cls: textOf$5(record["cls"]),
+			role: textOf$5(record["role"]),
+			name: textOf$5(record["name"]),
+			text: textOf$5(record["text"])
+		});
+	}
+	return out;
+}
+function slotOf(value) {
+	const record = typeof value === "object" && value !== null ? value : {};
+	return {
+		parentWidth: numberIn$1(record["parentWidth"], 0),
+		parentDisplay: textOf$5(record["parentDisplay"]),
+		columns: textOf$5(record["columns"]),
+		index: numberIn$1(record["index"], 0),
+		cards: numberIn$1(record["cards"], 0),
+		viewportHeight: numberIn$1(record["viewportHeight"], 0),
+		scrollHeight: numberIn$1(record["scrollHeight"], 0)
+	};
+}
+function stringsOf$2(value) {
+	if (typeof value !== "object" || value === null) return {};
+	const out = {};
+	for (const [key, raw] of Object.entries(value)) {
+		const text = textOf$5(raw);
+		if (text !== "") out[key] = text;
+	}
+	return out;
+}
+function pickFactsOf(value) {
+	if (typeof value !== "object" || value === null) return NO_PICK;
+	const record = value;
+	const raw = record["parts"];
+	const parts = {};
+	if (typeof raw === "object" && raw !== null) for (const [key, one] of Object.entries(raw)) parts[key] = stringsOf$2(one);
+	return {
+		card: stringsOf$2(record["card"]),
+		parts
+	};
+}
+//#endregion
+//#region src/modules/panels/model/diy-browser.ts
+var LOOK_TIMEOUT_MS = 3e4;
+async function runBrowserStep(shell, command, argv, timeoutMs = LOOK_TIMEOUT_MS) {
+	const result = await runShell(shell, backgroundLine(command, argv), { timeoutMs });
+	return {
+		ok: result.exitCode === 0 && !result.timedOut,
+		stdout: result.stdout.trim(),
+		stderr: result.stderr.trim(),
+		exitCode: result.exitCode,
+		timedOut: result.timedOut
+	};
+}
+function jsonOf(raw) {
+	const start = raw.indexOf("{");
+	const end = raw.lastIndexOf("}");
+	if (start === -1 || end <= start) return void 0;
+	try {
+		const parsed = JSON.parse(raw.slice(start, end + 1));
+		return typeof parsed === "object" && parsed !== null ? parsed : void 0;
+	} catch {
+		return;
+	}
+}
+function textOf$4(value) {
+	return typeof value === "string" ? value.trim() : "";
+}
+function numberIn(value, fallback) {
+	return typeof value === "number" && Number.isFinite(value) ? value : fallback;
+}
+async function bindCurrentTab(shell, command, session) {
+	const step = await runBrowserStep(shell, command, [
+		"browser",
+		session,
+		"bind",
+		"--window",
+		"background"
+	]);
+	const parsed = jsonOf(step.stdout);
+	if (parsed === void 0) return {
+		ok: false,
+		url: "",
+		title: "",
+		reason: step.timedOut ? "没在 30 秒内返回" : step.stderr || step.stdout
+	};
+	const error = parsed["error"];
+	if (typeof error === "object" && error !== null) {
+		const message = textOf$4(error["message"]);
+		return {
+			ok: false,
+			url: "",
+			title: "",
+			reason: message === "" ? "opencli 报了个错" : message
+		};
+	}
+	return {
+		ok: true,
+		url: textOf$4(parsed["url"]),
+		title: textOf$4(parsed["title"]),
+		reason: ""
+	};
+}
+async function workbenchPageOf(shell, command, session) {
+	const parsed = jsonOf((await runBrowserStep(shell, command, [
+		"browser",
+		session,
+		"eval",
+		PAGE_PROBE,
+		"--window",
+		"background"
+	])).stdout);
+	if (parsed === void 0) return {
+		ok: false,
+		url: "",
+		title: ""
+	};
+	return {
+		ok: textOf$4(parsed["plugin"]) === "@dsh-workbench/core",
+		url: textOf$4(parsed["url"]),
+		title: textOf$4(parsed["title"])
+	};
+}
+async function writeShotsDir(shell, dir) {
+	const result = await runShell(shell, [
+		"mkdir",
+		"-p",
+		dir
+	].map((one) => `'${one}'`).join(" "), { timeoutMs: LOOK_TIMEOUT_MS });
+	return result.exitCode === 0 && !result.timedOut;
+}
+async function readyPageOf(shell, command, session) {
+	const already = await workbenchPageOf(shell, command, session);
+	if (already.ok) return {
+		ok: true,
+		bound: false,
+		page: already,
+		reason: ""
+	};
+	const bound = await bindCurrentTab(shell, command, session);
+	if (!bound.ok) return {
+		ok: false,
+		bound: false,
+		page: already,
+		reason: bound.reason
+	};
+	const after = await workbenchPageOf(shell, command, session);
+	return {
+		ok: after.ok,
+		bound: true,
+		page: after,
+		reason: ""
+	};
+}
+async function measureCard(shell, command, session, unit, pick) {
+	const parsed = jsonOf((await runBrowserStep(shell, command, [
+		"browser",
+		session,
+		"eval",
+		measureScriptOf(unit, pick),
+		"--window",
+		"background"
+	])).stdout);
+	if (parsed === void 0 || parsed["ok"] !== true) return {
+		...EMPTY_CARD,
+		cards: numberIn(parsed?.["cards"], 0),
+		anchored: parsed?.["anchored"] === true
+	};
+	const width = numberIn(parsed["width"], 0);
+	const height = numberIn(parsed["height"], 0);
+	return {
+		ok: true,
+		anchored: true,
+		width,
+		height,
+		head: textOf$4(parsed["head"]),
+		text: textOf$4(parsed["text"]),
+		clipped: parsed["clipped"] === true,
+		cards: numberIn(parsed["cards"], 0),
+		rect: {
+			x: numberIn(parsed["x"], 0),
+			y: numberIn(parsed["y"], 0),
+			width,
+			height
+		},
+		dpr: numberIn(parsed["dpr"], 1) || 1,
+		viewport: {
+			width: numberIn(parsed["vw"], 0),
+			height: numberIn(parsed["vh"], 0)
+		},
+		pick: pickFactsOf(parsed["pick"]),
+		slot: slotOf(parsed["slot"]),
+		outline: nodesOf(parsed["outline"]),
+		html: textOf$4(parsed["html"])
+	};
+}
+function insideViewportOf(view) {
+	return view.rect.x >= 0 && view.rect.y >= 0 && view.rect.x + view.rect.width <= view.viewport.width && view.rect.y + view.rect.height <= view.viewport.height;
+}
+function deviceRectOf(view) {
+	return {
+		x: Math.max(0, Math.round(view.rect.x * view.dpr)),
+		y: Math.max(0, Math.round(view.rect.y * view.dpr)),
+		width: Math.max(1, Math.round(view.rect.width * view.dpr)),
+		height: Math.max(1, Math.round(view.rect.height * view.dpr))
+	};
+}
+function cropFile(file, view) {
+	const crop = cropPngFile(file, file, deviceRectOf(view));
+	return {
+		cropped: crop.ok,
+		reason: crop.reason
+	};
+}
+async function shootCard(shell, command, session, unit, file, view) {
+	const step = await runBrowserStep(shell, command, [
+		"browser",
+		session,
+		"screenshot",
+		file,
+		"--window",
+		"background"
+	]);
+	if (!step.ok) return {
+		ok: false,
+		file: "",
+		width: 0,
+		height: 0,
+		cropped: false,
+		reason: step.timedOut ? "截图没在 30 秒内回来" : step.stderr || step.stdout
+	};
+	if (!insideViewportOf(view)) return {
+		ok: true,
+		file,
+		width: Math.round(view.rect.width),
+		height: Math.round(view.rect.height),
+		cropped: false,
+		reason: `${unit} 这张卡有一部分在视口外面（卡片 ${String(Math.round(view.rect.width))}×${String(Math.round(view.rect.height))}，视口 ${String(view.viewport.width)}×${String(view.viewport.height)}）—— 滚过一次还是放不下，这一张是整屏图，卡片在 ${String(Math.round(view.rect.x))},${String(Math.round(view.rect.y))}。`
+	};
+	const crop = cropFile(file, view);
+	return {
+		ok: true,
+		file,
+		width: Math.round(view.rect.width),
+		height: Math.round(view.rect.height),
+		cropped: crop.cropped,
+		reason: crop.cropped ? crop.reason : `${crop.reason} —— 给的是整屏图：卡片在 ${String(Math.round(view.rect.x))},${String(Math.round(view.rect.y))}`
+	};
+}
+//#endregion
+//#region src/modules/panels/model/diy-page.ts
+async function pageAt(ctx, exec, raw, options = {}) {
+	const { packagesDir } = workshopOf(ctx, exec);
+	const args = asRecord$3(raw);
+	const asked = asText$1(args["unit"]);
+	const modules = modulesOf(ctx, packagesDir).modules;
+	const wanted = asked === "" && modules.length === 1 ? modules[0]?.unit ?? "" : asked;
+	if (wanted === "" && options.requireUnit !== false) throw new Error(`看一眼要一个 unit（工坊里：${modules.map((one) => one.unit).join(", ") || "（空）"}）`);
+	const shell = ctx.get("shell");
+	if (shell === void 0) throw new Error("这台机器上没有 shell 服务，动不了浏览器");
+	const command = opencliCommandOf(ctx).command;
+	const session = asText$1(args["session"]) || "workbench";
+	const handshake = await readyPageOf(shell, command, session);
+	if (!handshake.ok && !handshake.bound) throw new Error(`连不上浏览器：${handshake.reason}。先让用户把工作台那一页切到前台（只有第一次要这样）；还不行就跑 opencli doctor 看扩展连没连上。`);
+	if (!handshake.ok && options.requireWorkbench !== false) {
+		const { page } = handshake;
+		throw new Error(`你现在这一页不是工作台（${page.title || "(没有标题)"} ${page.url}）—— 把工作台那一页切到前台，再喊我一次。我只看用户正在看的那一页。`);
+	}
+	return {
+		packagesDir,
+		unit: wanted,
+		args,
+		shell,
+		command,
+		session,
+		bound: handshake.bound
+	};
+}
+//#endregion
+//#region src/modules/panels/model/diy-browser-act.ts
+var ACT_TIMEOUT_MS = 15e3;
+function actTargetOf(raw) {
+	const nth = raw["nth"];
+	return {
+		selector: textOf$4(raw["selector"]),
+		role: textOf$4(raw["role"]),
+		name: textOf$4(raw["name"]),
+		testid: textOf$4(raw["testid"]),
+		nth: typeof nth === "number" && Number.isFinite(nth) ? Math.max(0, Math.trunc(nth)) : null,
+		page: textOf$4(raw["scope"]) === "page"
+	};
+}
+function scopedSelectorOf(unit, target) {
+	if (target.selector === "") return "";
+	return target.page ? target.selector : `${cardSelectorOf(unit)} ${target.selector}`;
+}
+var SCOPE_ATTR = "data-diy-scope";
+function semanticOptionsOf(target) {
+	const out = [];
+	if (target.role !== "") out.push("--role", target.role);
+	if (target.name !== "") out.push("--name", target.name);
+	if (target.testid !== "") out.push("--testid", target.testid);
+	return out;
+}
+function targetOptionsOf(target) {
+	const out = [...semanticOptionsOf(target)];
+	if (target.nth !== null) out.push("--nth", String(target.nth));
+	return out;
+}
+function refsOf(payload) {
+	const entries = payload?.["entries"];
+	if (!Array.isArray(entries)) return [];
+	const out = [];
+	for (const one of entries) {
+		if (typeof one !== "object" || one === null) continue;
+		const ref = one["ref"];
+		if (typeof ref === "number") out.push(ref);
+	}
+	return out;
+}
+function totalMatchesOf(payload) {
+	const total = payload?.["matches_n"];
+	return typeof total === "number" ? total : 0;
+}
+function scopeMarkScriptOf(unit, refs, nth, token) {
+	return `(() => {
+  const card = document.querySelector(${JSON.stringify(cardSelectorOf(unit))});
+  const refs = ${JSON.stringify(refs)};
+  if (card === null) return { ok: false, code: 'no-card', inside: 0, total: refs.length };
+  const found = [];
+  for (const ref of refs) {
+    const el = document.querySelector('[data-opencli-ref="' + ref + '"]');
+    if (el !== null && card.contains(el)) found.push(el);
+  }
+  for (const stale of card.querySelectorAll('[${SCOPE_ATTR}]')) stale.removeAttribute('${SCOPE_ATTR}');
+  const pick = found[${String(nth)}];
+  if (pick === undefined) return { ok: false, code: 'not-in-card', inside: found.length, total: refs.length };
+  pick.setAttribute('${SCOPE_ATTR}', ${JSON.stringify(token)});
+  return { ok: true, code: '', inside: found.length, total: refs.length };
+})()`;
+}
+function scopeClearScriptOf(token) {
+	return `(() => {
+  const marked = document.querySelectorAll('[${SCOPE_ATTR}="${token}"]');
+  const removed = marked.length;
+  for (const el of marked) el.removeAttribute('${SCOPE_ATTR}');
+  return { ok: true, removed };
+})()`;
+}
+function scopedMarkerSelectorOf(unit, token) {
+	return `${cardSelectorOf(unit)} [${SCOPE_ATTR}="${token}"]`;
+}
+async function actBrowser(shell, command, session, argv, timeoutMs = ACT_TIMEOUT_MS) {
+	const step = await runBrowserStep(shell, command, [
+		"browser",
+		session,
+		...argv,
+		"--window",
+		"background"
+	], timeoutMs);
+	return {
+		...step,
+		payload: jsonOf(step.stdout)
+	};
+}
+function actErrorOf(step) {
+	if (step.timedOut) return `opencli 没在 ${String(Math.round(ACT_TIMEOUT_MS / 1e3))} 秒内回来`;
+	const error = step.payload?.["error"];
+	if (typeof error === "object" && error !== null) {
+		const message = textOf$4(error["message"]);
+		if (message !== "") return message;
+	}
+	if (step.ok) return "";
+	return step.stderr || step.stdout || "opencli 报了个错";
+}
+function matchesOf(step) {
+	const raw = step.payload?.["matches_n"];
+	return typeof raw === "number" && Number.isFinite(raw) ? raw : -1;
+}
+async function scrollIntoView(shell, command, session, unit, selector) {
+	const asked = selector === "" ? ".wb-card" : selector;
+	return actBrowser(shell, command, session, ["eval", `(() => {
+  const anchor = document.querySelector(${JSON.stringify(cardSelectorOf(unit))});
+  const sel = ${JSON.stringify(asked)};
+  if (anchor === null) return JSON.stringify({ ok: false, found: false });
+  const el = anchor.matches(sel) ? anchor : anchor.querySelector(sel);
+  if (el === null) return JSON.stringify({ ok: false, found: false });
+  el.scrollIntoView({ block: 'center', inline: 'nearest' });
+  const box = el.getBoundingClientRect();
+  return JSON.stringify({ ok: true, found: true, x: Math.round(box.x), y: Math.round(box.y), width: Math.ceil(box.width), height: Math.ceil(box.height) });
+})()`]);
+}
+async function reloadPage(shell, command, session) {
+	return actBrowser(shell, command, session, ["eval", `(() => { setTimeout(() => location.reload(), 30); return JSON.stringify({ ok: true }); })()`]);
+}
+async function shootAtWidth(shell, command, session, file, width, height) {
+	const step = await actBrowser(shell, command, session, [
+		"screenshot",
+		file,
+		"--width",
+		String(width),
+		...height > 0 ? ["--height", String(height)] : []
+	], LOOK_TIMEOUT_MS);
+	return {
+		ok: step.ok,
+		file: step.ok ? file : "",
+		width,
+		height,
+		reason: step.ok ? "" : step.timedOut ? "截图没在 30 秒内回来" : step.stderr || step.stdout
+	};
+}
+var NET_CAP_LINES = 2e3;
+function followerPatternOf(session) {
+	return `[b]rowser ${session} network --follow`;
+}
+function killFollowerLine(session, file) {
+	const pidFile = quoteShellArg(`${file}.pid`);
+	const reaperFile = quoteShellArg(`${file}.reaper`);
+	return [
+		`kill "$(cat ${pidFile} 2>/dev/null)" 2>/dev/null`,
+		`pkill -f ${quoteShellArg(followerPatternOf(session))} 2>/dev/null`,
+		`pkill -P "$(cat ${reaperFile} 2>/dev/null)" 2>/dev/null`,
+		`kill "$(cat ${reaperFile} 2>/dev/null)" 2>/dev/null`
+	].join("; ");
+}
+async function armNetwork(shell, command, session, file) {
+	const capture = `${backgroundLine(command, [
+		"browser",
+		session,
+		"network",
+		"--follow",
+		"--window",
+		"background"
+	])} 2>&1 | head -n ${String(NET_CAP_LINES)} > ${quoteShellArg(file)}`;
+	const reaper = `sleep ${String(900)}; ${killFollowerLine(session, file)}`;
+	const step = await runShell(shell, [
+		"rm",
+		"-f",
+		quoteShellArg(file),
+		quoteShellArg(`${file}.pid`),
+		quoteShellArg(`${file}.reaper`),
+		";",
+		"nohup",
+		"sh",
+		"-c",
+		quoteShellArg(capture),
+		">",
+		"/dev/null",
+		"2>&1",
+		"&",
+		"echo",
+		"$!",
+		">",
+		quoteShellArg(`${file}.pid`),
+		";",
+		"nohup",
+		"sh",
+		"-c",
+		quoteShellArg(reaper),
+		">",
+		"/dev/null",
+		"2>&1",
+		"&",
+		"echo",
+		"$!",
+		">",
+		quoteShellArg(`${file}.reaper`),
+		";",
+		"sleep",
+		"0.6",
+		";",
+		"cat",
+		quoteShellArg(`${file}.pid`)
+	].join(" "), { timeoutMs: ACT_TIMEOUT_MS });
+	const pid = step.stdout.trim().split("\n").slice(-1)[0] ?? "";
+	return {
+		ok: step.exitCode === 0 && pid !== "",
+		pid,
+		reason: step.exitCode === 0 ? "" : step.stderr.trim() || step.stdout.trim()
+	};
+}
+async function stopNetwork(shell, session, file) {
+	return (await runShell(shell, [
+		killFollowerLine(session, file),
+		";",
+		"rm",
+		"-f",
+		quoteShellArg(`${file}.pid`),
+		quoteShellArg(`${file}.reaper`)
+	].join(" "), { timeoutMs: ACT_TIMEOUT_MS })).exitCode === 0;
+}
+async function readNetwork(shell, file, lines) {
+	const step = await runShell(shell, `tail -n ${String(lines)} ${quoteShellArg(file)}`, { timeoutMs: ACT_TIMEOUT_MS });
+	const out = [];
+	for (const raw of step.stdout.split("\n")) {
+		const parsed = jsonOf(raw);
+		if (parsed !== void 0) out.push(parsed);
+	}
+	return out;
+}
+//#endregion
+//#region src/modules/panels/model/diy-look.ts
+function registerLookTools(ctx, tools) {
+	const lookTool = {
+		name: DIY_LOOK_TOOL,
+		description: "看一眼这张卡：只截它这一张 + 按你点的那几项读它的样式与字。要用户把工作台那一页切到前台。",
+		parameters: {
+			type: "object",
+			properties: {
+				unit: {
+					type: "string",
+					description: "工坊里的 unit（不填 = 工坊里只有一个就用它）。"
+				},
+				props: {
+					type: "array",
+					items: { type: "string" },
+					description: "要读的 CSS 属性（含 --令牌；不填给默认档）。最多 40 个。"
+				},
+				parts: {
+					type: "array",
+					items: { type: "string" },
+					description: "卡片里再看哪几块（选择器，限卡片内；不填 = 卡头与卡片体）。最多 6 个。"
+				},
+				dom: {
+					type: "string",
+					description: "结构快照：outline（默认，tag+类名+role+文本的浅层大纲）| html（卡片子树原始 HTML）| none。"
+				},
+				session: {
+					type: "string",
+					description: "会话名（默认 workbench，一般不用填）。"
+				}
+			},
+			additionalProperties: false
+		},
+		output: OUTPUT$2,
+		async execute(raw, exec) {
+			const { packagesDir, unit, shell, command, session } = await pageAt(ctx, exec, raw);
+			const pick = pickOf(asRecord$3(raw));
+			let view = await measureCard(shell, command, session, unit, pick);
+			if (!view.ok) return plainJson({
+				workshop: packagesDir,
+				unit,
+				ok: false,
+				cards: view.cards,
+				text: renderMissingCard(unit, view.cards, view.anchored)
+			});
+			if (!insideViewportOf(view)) {
+				await scrollIntoView(shell, command, session, unit, "");
+				view = await measureCard(shell, command, session, unit, pick);
+			}
+			const file = join(dirname(packagesDir), "shots", `${unit}-${String(Date.now())}.png`);
+			await writeShotsDir(shell, dirname(file));
+			const shot = await shootCard(shell, command, session, unit, file, view);
+			return plainJson({
+				workshop: packagesDir,
+				unit,
+				ok: shot.ok,
+				file: shot.file,
+				rect: view.rect,
+				cropped: shot.cropped,
+				clipped: view.clipped,
+				head: view.head,
+				pick: view.pick,
+				slot: view.slot,
+				outline: view.outline,
+				html: view.html,
+				text: renderLook(unit, view, shot, pick)
+			});
+		}
+	};
+	return [tools.register(lookTool)];
+}
+function rgbOf(value) {
+	const hit = /rgba?\((\d+)[,\s]+(\d+)[,\s]+(\d+)/.exec(value);
+	if (hit === null) return void 0;
+	return [
+		Number(hit[1]),
+		Number(hit[2]),
+		Number(hit[3])
+	];
+}
+function luminanceOf(rgb) {
+	const channel = (one) => {
+		const scaled = one / 255;
+		return scaled <= .03928 ? scaled / 12.92 : ((scaled + .055) / 1.055) ** 2.4;
+	};
+	return .2126 * channel(rgb[0]) + .7152 * channel(rgb[1]) + .0722 * channel(rgb[2]);
+}
+function contrastOf(foreground, background) {
+	const front = rgbOf(foreground);
+	const back = rgbOf(background);
+	if (front === void 0 || back === void 0) return void 0;
+	const one = luminanceOf(front);
+	const other = luminanceOf(back);
+	const ratio = (Math.max(one, other) + .05) / (Math.min(one, other) + .05);
+	return Math.round(ratio * 100) / 100;
+}
+function styleLineOf(view, pick) {
+	return pick.props.filter((one) => (view.pick.card[one] ?? "") !== "").map((one) => `${one}=${view.pick.card[one] ?? ""}`).join(" · ");
+}
+function partsLineOf(view, pick) {
+	return pick.parts.map((one) => {
+		const found = view.pick.parts[one] ?? {};
+		const inside = Object.entries(found).map(([key, value]) => `${key}=${value}`).join(" ");
+		return `${one}${inside === "" ? "（页面里没有这个）" : ` ${inside}`}`;
+	}).join("\n");
+}
+function slotText(slot, width) {
+	const columns = slot.columns === "" || slot.columns === "none" ? "一列" : `多列（${slot.columns}）`;
+	const fit = slot.parentWidth === 0 ? "" : `、这张卡占 ${String(width)}/${String(slot.parentWidth)}px`;
+	return `它在第 ${String(slot.index + 1)}/${String(slot.cards)} 张；卡片格子 ${String(slot.parentWidth)}px 宽、${columns}${fit}；滚动容器可视 ${String(slot.viewportHeight)}px / 内容 ${String(slot.scrollHeight)}px`;
+}
+function slotLineOf(view) {
+	return slotText(view.slot, view.width);
+}
+function outlineText(view) {
+	return view.outline.map((one) => {
+		const bits = [`${"  ".repeat(one.depth)}${one.tag}${one.cls === "" ? "" : `.${one.cls}`}`];
+		if (one.role !== "") bits.push(`role=${one.role}`);
+		if (one.name !== "") bits.push(`name="${one.name}"`);
+		if (one.text !== "") bits.push(`"${one.text}"`);
+		return bits.join(" ");
+	}).join("\n");
+}
+function contrastLineOf(view) {
+	const ratio = contrastOf((view.pick.parts[".wb-cardBody"] ?? view.pick.card)["color"] ?? "", view.pick.card["backgroundColor"] ?? "");
+	if (ratio === void 0) return "";
+	return ratio >= 4.5 ? `正文对比度 ${String(ratio)}（够）` : `正文对比度 ${String(ratio)} —— 低于 4.5，正文会看不清（要改）`;
+}
+function renderLook(unit, view, shot, pick) {
+	const where = `面板里 ${String(view.rect.x)},${String(view.rect.y)}（${String(view.width)}×${String(view.height)}）`;
+	return [
+		shot.ok ? `看到了 ${unit} 这张卡：${where}` : `没拍成：${shot.reason}`,
+		...shot.ok ? [shot.file] : [],
+		...shot.ok && shot.reason !== "" ? [shot.reason] : [],
+		...view.head === "" ? [] : [`卡头：${view.head}`],
+		...view.text === "" ? [] : [`卡片上写着：${view.text}`],
+		`格子里：${slotLineOf(view)}`,
+		...styleLineOf(view, pick) === "" ? [] : [`你点的那几项：${styleLineOf(view, pick)}`],
+		...[partsLineOf(view, pick)].filter((one) => one !== ""),
+		...contrastLineOf(view) === "" ? [] : [contrastLineOf(view)],
+		...pick.dom === "outline" && view.outline.length > 0 ? ["结构：", outlineText(view)] : [],
+		...pick.dom === "html" ? [`原始 HTML：${String(view.html.length)} 字符（在返回的 html 字段里）`] : [],
+		...view.clipped ? ["有内容被裁掉了（某一格比它自己的宽度还宽）—— 这是要改的信号"] : []
+	].join("\n");
+}
+function renderMissingCard(unit, cards, anchored) {
+	if (anchored) return `面板里给 ${unit} 留了位置（锚点在），但里面没有卡片 —— 它的 View 没画出来：要么渲染时抛了（看 workbench_diy_panel 的运行态上报与 workbench_diy_status），要么它返回了空 / 没套卡壳。你现在这一页面板里一共 ${String(cards)} 张卡。`;
+	return `你现在这一页的面板里没有 ${unit} 这张卡（面板里现在有 ${String(cards)} 张卡）。三件事，按顺序试：① workbench_diy_show（unit=${unit}）把它上板；② 右栏可能没停在「工作台面板」那一列 —— 让用户切回来；③ 页面上跑的外壳可能还是旧的一份（锚点由外壳盖）—— 让用户刷新一次页面。`;
+}
+//#endregion
+//#region src/modules/panels/model/diy-logs.ts
+var LOGS_KEY = "__dshDiyLogs";
+var LOGS_CAP = 200;
+var LOGS_TEXT_MAX = 400;
+var LEVELS = [
+	"log",
+	"info",
+	"warn",
+	"error",
+	"debug"
+];
+var LOGS_ARM_SCRIPT = `(() => {
+  const KEY = ${JSON.stringify(LOGS_KEY)};
+  const CAP = ${String(LOGS_CAP)};
+  const TEXT_MAX = ${String(LOGS_TEXT_MAX)};
+  const LEVELS = ${JSON.stringify(LEVELS)};
+  let buf = window[KEY];
+  if (!Array.isArray(buf)) {
+    buf = [];
+    window[KEY] = buf;
+  }
+  const textOf = (value) => {
+    try {
+      if (typeof value === 'string') return value;
+      const json = JSON.stringify(value);
+      return typeof json === 'string' ? json : String(value);
+    } catch (error) {
+      return '[unprintable]';
+    }
+  };
+  let hooked = 0;
+  for (const level of LEVELS) {
+    const current = console[level];
+    if (typeof current === 'function' && current.__dshDiy === true) continue;
+    const real = typeof current === 'function' ? current.bind(console) : () => {};
+    const patched = (...args) => {
+      try {
+        buf.push({ level, text: args.map(textOf).join(' ').slice(0, TEXT_MAX), at: Date.now() });
+        if (buf.length > CAP) buf.splice(0, buf.length - CAP);
+      } catch (error) {}
+      return real(...args);
+    };
+    patched.__dshDiy = true;
+    patched.__real = typeof current === 'function' ? current : null;
+    console[level] = patched;
+    hooked += 1;
+  }
+  return { ok: true, cap: CAP, levels: LEVELS.length, hooked, size: buf.length };
+})()`;
+var LOGS_READ_SCRIPT = `(() => {
+  const buf = window[${JSON.stringify(LOGS_KEY)}];
+  if (!Array.isArray(buf)) return { ok: false, code: 'not-armed', seen: 0, lines: [] };
+  return { ok: true, seen: buf.length, lines: buf.slice(-${String(LOGS_CAP)}) };
+})()`;
+var LOGS_STOP_SCRIPT = `(() => {
+  const KEY = ${JSON.stringify(LOGS_KEY)};
+  const LEVELS = ${JSON.stringify(LEVELS)};
+  const buf = window[KEY];
+  const dropped = Array.isArray(buf) ? buf.length : 0;
+  let unhooked = 0;
+  for (const level of LEVELS) {
+    const current = console[level];
+    if (typeof current !== 'function' || current.__dshDiy !== true) continue;
+    if (typeof current.__real === 'function') console[level] = current.__real;
+    else delete console[level];
+    unhooked += 1;
+  }
+  try {
+    delete window[KEY];
+  } catch (error) {
+    window[KEY] = undefined;
+  }
+  return { ok: true, unhooked, dropped };
+})()`;
+function logsReadOf(payload) {
+	const raw = payload ?? {};
+	const lines = Array.isArray(raw["lines"]) ? raw["lines"] : [];
+	const kept = [];
+	for (const one of lines) {
+		if (typeof one !== "object" || one === null) continue;
+		const record = one;
+		const text = typeof record["text"] === "string" ? record["text"] : "";
+		if (text === "") continue;
+		kept.push({
+			level: typeof record["level"] === "string" && record["level"] !== "" ? record["level"] : "log",
+			text,
+			at: typeof record["at"] === "number" ? record["at"] : 0
+		});
+	}
+	const seen = typeof raw["seen"] === "number" ? raw["seen"] : kept.length;
+	return {
+		ok: raw["ok"] === true,
+		code: typeof raw["code"] === "string" ? raw["code"] : "",
+		seen: Math.max(seen, kept.length),
+		lines: kept
+	};
+}
+function renderLogs(read) {
+	if (!read.ok) return "这一页上还没有钩子（看不到控制台）—— 先 workbench_diy_logs_watch 装上，做完你要看的那件事，再 workbench_diy_logs_read。";
+	if (read.lines.length === 0) return "钩子装上了，但这一页到现在一条 console.* 都没打过。";
+	const shown = read.lines.slice(-50);
+	const more = read.seen > shown.length ? `（攒了 ${String(read.seen)} 条，这里只列最近 ${String(shown.length)} 条）` : "";
+	return [`这一页最近 ${String(shown.length)} 条控制台${more}：`, ...shown.map((one) => `[${one.level}] ${one.text}`)].join("\n");
+}
+function registerLogTools(ctx, tools) {
+	const schema = {
+		type: "object",
+		properties: { session: {
+			type: "string",
+			description: "会话名（默认 workbench，一般不用填）。"
+		} },
+		additionalProperties: false
+	};
+	async function run(exec, raw, script) {
+		const page = await pageAt(ctx, exec, raw, {
+			requireUnit: false,
+			requireWorkbench: false
+		});
+		return {
+			page,
+			step: await actBrowser(page.shell, page.command, page.session, ["eval", script])
+		};
+	}
+	const watchTool = {
+		name: DIY_LOGS_WATCH_TOOL,
+		description: "把这一页的控制台听上（每页最多 200 条、单条截 400 字，随页面刷新消失）。",
+		parameters: schema,
+		output: OUTPUT$2,
+		async execute(raw, exec) {
+			const { page, step } = await run(exec, raw, LOGS_ARM_SCRIPT);
+			const error = actErrorOf(step);
+			const hooked = typeof step.payload?.["hooked"] === "number" ? step.payload["hooked"] : 0;
+			const size = typeof step.payload?.["size"] === "number" ? step.payload["size"] : 0;
+			const text = error !== "" ? `没听上：${error}` : hooked === 0 ? `已经在听了（钩子还在，攒着 ${String(size)} 条）。做完那件事用 ${DIY_LOGS_READ_TOOL} 读。` : `听上了（装了 ${String(hooked)} 个钩子，最多 ${String(LOGS_CAP)} 条）：去做你要看的那件事，回头用 ${DIY_LOGS_READ_TOOL} 读；读完用 ${DIY_LOGS_STOP_TOOL} 卸掉。`;
+			return plainJson({
+				workshop: page.packagesDir,
+				ok: step.ok && error === "",
+				hooked,
+				cap: LOGS_CAP,
+				text
+			});
+		}
+	};
+	const readTool = {
+		name: DIY_LOGS_READ_TOOL,
+		description: "读刚才听下来的控制台（最近 50 条；没装钩子会说清，不假装是\"没有报错\"）。",
+		parameters: schema,
+		output: OUTPUT$2,
+		async execute(raw, exec) {
+			const { page, step } = await run(exec, raw, LOGS_READ_SCRIPT);
+			const error = actErrorOf(step);
+			const read = logsReadOf(step.payload);
+			const text = error !== "" ? `读不到：${error}` : renderLogs(read);
+			return plainJson({
+				workshop: page.packagesDir,
+				ok: step.ok && error === "",
+				seen: read.seen,
+				lines: read.lines.slice(-50),
+				text
+			});
+		}
+	};
+	const stopTool = {
+		name: DIY_LOGS_STOP_TOOL,
+		description: "控制台收听收工：卸掉钩子、扔掉攒下的记录。",
+		parameters: schema,
+		output: OUTPUT$2,
+		async execute(raw, exec) {
+			const { page, step } = await run(exec, raw, LOGS_STOP_SCRIPT);
+			const error = actErrorOf(step);
+			const unhooked = typeof step.payload?.["unhooked"] === "number" ? step.payload["unhooked"] : 0;
+			const dropped = typeof step.payload?.["dropped"] === "number" ? step.payload["dropped"] : 0;
+			const text = error !== "" ? `没卸干净：${error}` : `收工了：卸掉 ${String(unhooked)} 个钩子、扔掉 ${String(dropped)} 条记录。`;
+			return plainJson({
+				workshop: page.packagesDir,
+				ok: step.ok && error === "",
+				unhooked,
+				dropped,
+				text
+			});
+		}
+	};
+	return [
+		tools.register(watchTool),
+		tools.register(readTool),
+		tools.register(stopTool)
+	];
+}
+//#endregion
+//#region src/modules/panels/model/diy-schema.ts
+var UNIT_PROP = {
+	type: "string",
+	description: "工坊里的 unit（不填 = 工坊里只有一个就用它）。"
+};
+var SESSION_PROP = {
+	type: "string",
+	description: "会话名（默认 workbench，一般不用填）。"
+};
+function pageSchema(extra = {}, required = []) {
+	return {
+		type: "object",
+		properties: {
+			unit: UNIT_PROP,
+			...extra,
+			session: SESSION_PROP
+		},
+		...required.length === 0 ? {} : { required },
+		additionalProperties: false
+	};
+}
+//#endregion
+//#region src/modules/panels/model/diy-net.ts
+var SIBLING_TRIES = 6;
+var NET_BODY_MAX = 2e4;
+function nearestKeyOf(payload, key) {
+	const entries = payload?.["entries"];
+	if (!Array.isArray(entries)) return "";
+	let recent = "";
+	for (const one of entries) {
+		if (typeof one !== "object" || one === null) continue;
+		const candidate = one["key"];
+		if (typeof candidate !== "string" || candidate === "") continue;
+		if (candidate === key) return key;
+		if (candidate.startsWith(`${key}#`)) recent = candidate;
+	}
+	return recent;
+}
+function registerNetTools(ctx, tools) {
+	async function netDetail(page, key) {
+		return await actBrowser(page.shell, page.command, page.session, [
+			"network",
+			"--detail",
+			key,
+			"--max-body",
+			String(NET_BODY_MAX)
+		]);
+	}
+	async function netFileOf(exec, raw) {
+		const page = await pageAt(ctx, exec, raw, {
+			requireWorkbench: false,
+			requireUnit: false
+		});
+		return {
+			page,
+			file: join(dirname(page.packagesDir), "shots", `net-${page.session}.jsonl`)
+		};
+	}
+	const netWatchTool = {
+		name: DIY_NET_WATCH_TOOL,
+		description: `把网络捕获臂上（opencli 的 network 不臂上就收不到）：随后你在这页上做的事都会被记下（最多 ${String(NET_CAP_LINES)} 行 / ${String(Math.round(15))} 分钟后自己收工）。`,
+		parameters: pageSchema(),
+		output: OUTPUT$2,
+		async execute(raw, exec) {
+			const { page, file } = await netFileOf(exec, raw);
+			await writeShotsDir(page.shell, dirname(file));
+			await stopNetwork(page.shell, page.session, file);
+			const armed = await armNetwork(page.shell, page.command, page.session, file);
+			return plainJson({
+				workshop: page.packagesDir,
+				unit: page.unit,
+				ok: armed.ok,
+				pid: armed.pid,
+				capLines: NET_CAP_LINES,
+				capSeconds: 900,
+				text: armed.ok ? `捕获臂上了（pid ${armed.pid}；最多 ${String(NET_CAP_LINES)} 行、${String(900)} 秒后自己收工）。现在去做你要做的事，回头用 ${DIY_NET_READ_TOOL} 读；读完 ${DIY_NET_STOP_TOOL} 可以提前收工。` : `臂不上：${armed.reason}`
+			});
+		}
+	};
+	const netReadTool = {
+		name: DIY_NET_READ_TOOL,
+		description: "读刚才臂上之后记下的网络（给 key 就取那一条的完整 body）。",
+		parameters: pageSchema({
+			lines: {
+				type: "number",
+				description: "读最近几条（默认 60）。"
+			},
+			failed: {
+				type: "boolean",
+				description: "只看失败请求（0 或 >= 400）。"
+			},
+			grep: {
+				type: "string",
+				description: "再按 URL 里的一段词收。"
+			},
+			key: {
+				type: "string",
+				description: "给 key = 取这一条请求的完整 body（read 的返回里带 key）。"
+			}
+		}),
+		output: OUTPUT$2,
+		async execute(raw, exec) {
+			const { page, file } = await netFileOf(exec, raw);
+			const key = asText$1(page.args["key"]);
+			if (key !== "") {
+				const tried = [key];
+				let used = key;
+				let detail = await netDetail(page, key);
+				for (let n = 2; n <= SIBLING_TRIES && !detail.ok; n += 1) {
+					const sibling = `${key}#${String(n)}`;
+					const attempt = await netDetail(page, sibling);
+					tried.push(sibling);
+					if (attempt.ok) {
+						detail = attempt;
+						used = sibling;
+					}
+				}
+				let refreshed = false;
+				if (!detail.ok) {
+					const capture = await actBrowser(page.shell, page.command, page.session, ["network"]);
+					const grabbed = Array.isArray(capture.payload?.["entries"]) ? capture.payload["entries"].length : 0;
+					refreshed = capture.ok && grabbed > 0;
+					if (refreshed) {
+						const retry = await netDetail(page, key);
+						tried.push(key);
+						if (retry.ok) {
+							detail = retry;
+							used = key;
+						} else {
+							const alt = nearestKeyOf(capture.payload, key);
+							if (alt !== "" && alt !== key) {
+								const attempt = await netDetail(page, alt);
+								tried.push(alt);
+								if (attempt.ok) {
+									detail = attempt;
+									used = alt;
+								}
+							}
+						}
+					}
+				}
+				return plainJson({
+					workshop: page.packagesDir,
+					unit: page.unit,
+					ok: detail.ok,
+					key: used,
+					tried,
+					refreshed,
+					detail: detail.payload,
+					text: detail.ok ? `${used} 的完整 body 在 detail.body 里${used === key ? "" : `（给的 key 不在缓存里，取了同名的 ${used}）`}${refreshed ? "（先跑了一次性抓取把缓存落下来）" : ""}。` : `没取到：${actErrorOf(detail)} —— 试过 ${String(tried.length)} 个 key（同名请求在缓存里会带 #2/#3…），缓存里都没有${refreshed ? "" : "，而刚才那次补抓一个请求也没抓到"}。重抓一次（${DIY_NET_WATCH_TOOL} → 做那件事 → ${DIY_NET_READ_TOOL}）之后趁热再取；要的只是这一次接口的返回值的话，用 workbench_diy_probe 在页面里直接读更快。`
+				});
+			}
+			const lines = asNumber(page.args["lines"]) ?? 60;
+			const onlyFailed = page.args["failed"] === true;
+			const grep = asText$1(page.args["grep"]);
+			const all = await readNetwork(page.shell, file, Math.max(1, Math.min(500, lines)));
+			const entries = all.filter((one) => {
+				const status = typeof one["status"] === "number" ? one["status"] : 0;
+				if (onlyFailed && !(status === 0 || status >= 400)) return false;
+				if (grep !== "" && !String(one["url"] ?? "").includes(grep)) return false;
+				return true;
+			});
+			return plainJson({
+				workshop: page.packagesDir,
+				unit: page.unit,
+				ok: true,
+				count: entries.length,
+				seen: all.length,
+				entries: entries.slice(-40),
+				text: all.length === 0 ? "这份捕获是空的 —— 先用 workbench_diy_net_watch 臂上，再去做那件事，然后回来读。" : `${String(entries.length)}/${String(all.length)} 条（最近的在后面）。每条的 key 可以拿去取完整 body：${DIY_NET_READ_TOOL} key="<某条的 key>"。`
+			});
+		}
+	};
+	const netStopTool = {
+		name: DIY_NET_STOP_TOOL,
+		description: "网络捕获收工（把臂上的那条 follower 停掉）。",
+		parameters: pageSchema(),
+		output: OUTPUT$2,
+		async execute(raw, exec) {
+			const { page, file } = await netFileOf(exec, raw);
+			const stopped = await stopNetwork(page.shell, page.session, file);
+			return plainJson({
+				workshop: page.packagesDir,
+				unit: page.unit,
+				ok: stopped,
+				text: stopped ? `捕获收工了（follower 与看门狗都停掉）。` : `收工那一下没跑成（命令退出码非 0）—— 再调一次 ${DIY_NET_STOP_TOOL}；还不行看一眼 shots/ 那份 .pid / .reaper。`
+			});
+		}
+	};
+	return [
+		tools.register(netWatchTool),
+		tools.register(netReadTool),
+		tools.register(netStopTool)
+	];
+}
+//#endregion
+//#region src/modules/panels/model/diy-act.ts
+var TARGET_PROPS = {
+	selector: {
+		type: "string",
+		description: "卡内的 CSS 选择器（默认只在这张卡里找；scope=page 才是整页）。"
+	},
+	role: {
+		type: "string",
+		description: "语义定位：角色（button / link / textbox / option…）。"
+	},
+	name: {
+		type: "string",
+		description: "语义定位：无障碍名（aria-label / 可见文字）包含这段。"
+	},
+	testid: {
+		type: "string",
+		description: "语义定位：data-testid 包含这段。"
+	},
+	nth: {
+		type: "number",
+		description: "匹配到多个时取第几个（0 起）。"
+	},
+	scope: {
+		type: "string",
+		description: "card（默认，只在这张卡里找）| page（整页找）。"
+	}
+};
+function targetSchema(extra = {}, required = []) {
+	return {
+		type: "object",
+		properties: {
+			unit: UNIT_PROP,
+			...TARGET_PROPS,
+			...extra,
+			session: SESSION_PROP
+		},
+		...required.length === 0 ? {} : { required },
+		additionalProperties: false
+	};
+}
+function hasTarget(target) {
+	return target.selector !== "" || target.role !== "" || target.name !== "" || target.testid !== "";
+}
+function describeTarget(target, selector) {
+	if (selector !== "") return `\`${selector}\``;
+	const bits = [];
+	if (target.role !== "") bits.push(`role=${target.role}`);
+	if (target.name !== "") bits.push(`name=${target.name}`);
+	if (target.testid !== "") bits.push(`testid=${target.testid}`);
+	return bits.join(" · ");
+}
+function renderAct(verb, target, selector, step) {
+	const matches = matchesOf(step);
+	if (matches === 0) return `没找到要${verb}的东西（${describeTarget(target, selector)}）—— 用 workbench_diy_look 的 dom=outline 看一眼这张卡里到底有什么。`;
+	const error = actErrorOf(step);
+	if (error !== "") return `${verb}没成：${error}`;
+	const many = matches > 1 ? `（匹配 ${String(matches)} 个，用的是第 ${String((target.nth ?? 0) + 1)} 个）` : "";
+	return `${verb}了 ${describeTarget(target, selector)}${many}。看一眼 workbench_diy_look 就知道这一下有没有生效。`;
+}
+function registerActTools(ctx, tools) {
+	async function resolveTarget(page, target, verb) {
+		if (target.selector !== "") return {
+			selector: scopedSelectorOf(page.unit, target),
+			options: [],
+			token: "",
+			via: "css"
+		};
+		const semantic = semanticOptionsOf(target);
+		if (target.page || semantic.length === 0) return {
+			selector: "",
+			options: targetOptionsOf(target),
+			token: "",
+			via: "page-semantic"
+		};
+		const found = await actBrowser(page.shell, page.command, page.session, [
+			"find",
+			...semantic,
+			"--limit",
+			"200"
+		]);
+		const refs = refsOf(found.payload);
+		const total = totalMatchesOf(found.payload) || refs.length;
+		if (refs.length === 0) throw new Error(`${verb}谁？这一页上没有匹配 ${describeTarget(target, "")} 的东西 —— 用 workbench_diy_look 的 dom=outline 看一眼这张卡里有什么，或者换成卡内 CSS（selector）。`);
+		const token = `diy-${Date.now().toString(36)}`;
+		const nth = target.nth ?? 0;
+		const marked = await actBrowser(page.shell, page.command, page.session, ["eval", scopeMarkScriptOf(page.unit, refs, nth, token)]);
+		if (marked.payload?.["ok"] !== true) {
+			const inside = marked.payload?.["inside"];
+			const why = marked.payload?.["code"] === "no-card" ? `这一页上没有 ${page.unit} 这张卡` : `卡内只有 ${String(typeof inside === "number" ? inside : 0)} 个匹配，拿不出第 ${String(nth + 1)} 个`;
+			throw new Error(`${describeTarget(target, "")} 这一页上匹配了 ${String(total)} 个，但${why} —— 是不是 unit 给错了？也可以在 selector 里点名卡内 CSS，或 scope=page 明说要整页那一个。`);
+		}
+		return {
+			selector: scopedMarkerSelectorOf(page.unit, token),
+			options: [],
+			token,
+			via: "card-semantic"
+		};
+	}
+	async function runTargeted(exec, raw, verb, build, needSelector = false) {
+		const page = await pageAt(ctx, exec, raw);
+		const target = actTargetOf(page.args);
+		if (!hasTarget(target)) throw new Error(`${verb}谁？给一个 selector（卡内 CSS），或 role / name / testid 之一。`);
+		const resolved = await resolveTarget(page, target, verb);
+		if (needSelector && resolved.selector === "") throw new Error(`${verb}要一个 selector：输入框得点名才敢动手（语义定位请去掉 scope=page）。`);
+		const step = await actBrowser(page.shell, page.command, page.session, [...build(resolved.selector, target), ...resolved.options]);
+		if (resolved.token !== "") await actBrowser(page.shell, page.command, page.session, ["eval", scopeClearScriptOf(resolved.token)]);
+		return plainJson({
+			workshop: page.packagesDir,
+			unit: page.unit,
+			ok: step.ok,
+			verb,
+			via: resolved.via,
+			matches: matchesOf(step),
+			text: renderAct(verb, target, target.selector === "" ? "" : resolved.selector, step) + (resolved.via === "card-semantic" ? `（语义定位收进了 ${page.unit} 这张卡）` : "")
+		});
+	}
+	const clickTool = {
+		name: DIY_CLICK_TOOL,
+		description: "在这张卡里点一下（按钮 / 链接 / 行）。默认只在这张卡里找目标，找不到就直说。",
+		parameters: targetSchema(),
+		output: OUTPUT$2,
+		execute: (raw, exec) => runTargeted(exec, raw, "点", (selector) => selector === "" ? ["click"] : ["click", selector])
+	};
+	const typeTool = {
+		name: DIY_TYPE_TOOL,
+		description: "往这张卡里的某个输入框敲字（先点它再敲）—— 要一个 selector 与 value。",
+		parameters: targetSchema({ value: {
+			type: "string",
+			description: "要敲进去的字。"
+		} }, ["selector", "value"]),
+		output: OUTPUT$2,
+		execute: (raw, exec) => runTargeted(exec, raw, "敲", (selector) => [
+			"type",
+			selector,
+			asText$1(asRecord$3(raw)["value"])
+		], true)
+	};
+	const fillTool = {
+		name: DIY_FILL_TOOL,
+		description: "把这张卡里某个输入框的值直接设成这段字并核对（不改别处）—— 要一个 selector 与 value。",
+		parameters: targetSchema({ value: {
+			type: "string",
+			description: "要设进去的值。"
+		} }, ["selector", "value"]),
+		output: OUTPUT$2,
+		execute: (raw, exec) => runTargeted(exec, raw, "填", (selector) => [
+			"fill",
+			selector,
+			asText$1(asRecord$3(raw)["value"])
+		], true)
+	};
+	const keysTool = {
+		name: DIY_KEYS_TOOL,
+		description: "在这一页上按一个键（Enter / Escape / Tab / Control+a）—— 收下拉、提交、挪焦点用它。",
+		parameters: pageSchema({ key: {
+			type: "string",
+			description: "要按的键。"
+		} }, ["key"]),
+		output: OUTPUT$2,
+		async execute(raw, exec) {
+			const page = await pageAt(ctx, exec, raw, { requireUnit: false });
+			const key = asText$1(page.args["key"]);
+			if (key === "") throw new Error("按哪个键？给 key（Enter / Escape / Tab / Control+a）。");
+			const step = await actBrowser(page.shell, page.command, page.session, ["keys", key]);
+			const error = actErrorOf(step);
+			return plainJson({
+				workshop: page.packagesDir,
+				unit: page.unit,
+				ok: step.ok,
+				verb: "keys",
+				text: error === "" ? `按了 ${key}。` : `按键没成：${error}`
+			});
+		}
+	};
+	const hoverTool = {
+		name: DIY_HOVER_TOOL,
+		description: "把鼠标移到这张卡里的某个东西上（悬停才出来的东西靠它）。",
+		parameters: targetSchema(),
+		output: OUTPUT$2,
+		execute: (raw, exec) => runTargeted(exec, raw, "悬停", (selector) => selector === "" ? ["hover"] : ["hover", selector])
+	};
+	const selectTool = {
+		name: DIY_SELECT_TOOL,
+		description: "在这张卡的下拉里选一项 —— 要一个 selector 与选项文字。",
+		parameters: targetSchema({ value: {
+			type: "string",
+			description: "选项文字（或 value）。"
+		} }, ["selector", "value"]),
+		output: OUTPUT$2,
+		execute: (raw, exec) => runTargeted(exec, raw, "选", (selector) => [
+			"select",
+			selector,
+			asText$1(asRecord$3(raw)["value"])
+		], true)
+	};
+	const scrollTool = {
+		name: DIY_SCROLL_TOOL,
+		description: "滚这一页（direction + amount），或把这张卡 / 卡里某块滚到看得见（into）。",
+		parameters: pageSchema({
+			direction: {
+				type: "string",
+				description: "up | down（不给 into 时用它）。"
+			},
+			amount: {
+				type: "number",
+				description: "滚多少像素（默认 500）。"
+			},
+			into: {
+				type: "string",
+				description: "滚到看得见：留空 = 这张卡；填卡内 CSS = 卡里那一块。"
+			}
+		}),
+		output: OUTPUT$2,
+		async execute(raw, exec) {
+			const page = await pageAt(ctx, exec, raw);
+			const into = page.args["into"];
+			if (into !== void 0) {
+				const step = await scrollIntoView(page.shell, page.command, page.session, page.unit, asText$1(into));
+				const found = step.payload?.["found"] === true;
+				return plainJson({
+					workshop: page.packagesDir,
+					unit: page.unit,
+					ok: step.ok && found,
+					verb: "scroll",
+					text: actErrorOf(step) !== "" ? `滚不动：${actErrorOf(step)}` : found ? "滚到看得见了。" : `卡里没有要滚的那一块（${asText$1(into) || "卡片本身"}）。`
+				});
+			}
+			const direction = asText$1(page.args["direction"]) || "down";
+			const amount = asNumber(page.args["amount"]) ?? 500;
+			const step = await actBrowser(page.shell, page.command, page.session, [
+				"scroll",
+				direction,
+				"--amount",
+				String(amount)
+			]);
+			const error = actErrorOf(step);
+			return plainJson({
+				workshop: page.packagesDir,
+				unit: page.unit,
+				ok: step.ok,
+				verb: "scroll",
+				text: error === "" ? `这一页往${direction === "up" ? "上" : "下"}滚了 ${String(amount)}px。` : `滚不动：${error}`
+			});
+		}
+	};
+	const reloadTool = {
+		name: DIY_RELOAD_TOOL,
+		description: "刷新用户正开着的这一页（页面上跑的外壳/共享包是旧的一份时用它；卡片自己会热更新，一般不用）。",
+		parameters: pageSchema(),
+		output: OUTPUT$2,
+		async execute(raw, exec) {
+			const page = await pageAt(ctx, exec, raw, {
+				requireWorkbench: false,
+				requireUnit: false
+			});
+			const step = await reloadPage(page.shell, page.command, page.session);
+			const error = actErrorOf(step);
+			return plainJson({
+				workshop: page.packagesDir,
+				unit: page.unit,
+				ok: step.ok,
+				verb: "reload",
+				text: error === "" ? "让这一页自己刷新了（等两秒再看）。" : `刷新没成：${error}`
+			});
+		}
+	};
+	const viewportTool = {
+		name: DIY_VIEWPORT_TOOL,
+		description: "按某个宽度重拍一张整屏图（看窄屏/宽屏下这张卡挤不挤）—— 只在这一拍里换视口。",
+		parameters: pageSchema({
+			width: {
+				type: "number",
+				description: "视口宽度（CSS px，例如 390）。"
+			},
+			height: {
+				type: "number",
+				description: "视口高度（可不要）。"
+			}
+		}, ["width"]),
+		output: OUTPUT$2,
+		async execute(raw, exec) {
+			const page = await pageAt(ctx, exec, raw, { requireUnit: false });
+			const width = asNumber(page.args["width"]);
+			if (width === void 0 || width <= 0) throw new Error("多宽？给 width（CSS px）。");
+			const height = asNumber(page.args["height"]) ?? 0;
+			const file = join(dirname(page.packagesDir), "shots", `${page.unit || "page"}-${String(width)}-${String(Date.now())}.png`);
+			await writeShotsDir(page.shell, dirname(file));
+			const shot = await shootAtWidth(page.shell, page.command, page.session, file, width, height);
+			return plainJson({
+				workshop: page.packagesDir,
+				unit: page.unit,
+				ok: shot.ok,
+				file: shot.file,
+				width,
+				viewport: {
+					width,
+					height
+				},
+				text: shot.ok ? `按 ${String(width)}px 宽重拍了一张：${shot.file}（页面按新视口回流，只在这一拍里生效）。` : `没拍成：${shot.reason}`
+			});
+		}
+	};
+	return [
+		tools.register(clickTool),
+		tools.register(typeTool),
+		tools.register(fillTool),
+		tools.register(keysTool),
+		tools.register(hoverTool),
+		tools.register(selectTool),
+		tools.register(scrollTool),
+		tools.register(reloadTool),
+		tools.register(viewportTool)
+	];
+}
+//#endregion
+//#region src/shared/api/host/diy-recon.ts
+var SITE_LIMIT = 6;
+var COMMAND_LIMIT = 12;
+var SHOWN_LIMIT = 6;
+var PLUGIN_PREFIX = "opencli-plugin-";
+function text(value) {
+	return typeof value === "string" ? value.trim() : "";
+}
+function stringsOf$1(value) {
+	return Array.isArray(value) ? value.filter((one) => typeof one === "string") : [];
+}
+function manifestCommandsOf(raw) {
+	let parsed;
+	try {
+		parsed = JSON.parse(raw);
+	} catch {
+		return [];
+	}
+	if (!Array.isArray(parsed)) return [];
+	const commands = [];
+	for (const one of parsed) {
+		if (typeof one !== "object" || one === null) continue;
+		const row = one;
+		const declared = text(row["command"]);
+		const site = text(row["site"]) || declared.split("/")[0] || "";
+		const name = text(row["name"]) || declared.split("/")[1] || "";
+		const command = declared === "" ? site === "" || name === "" ? "" : `${site}/${name}` : declared;
+		if (command === "" || site === "") continue;
+		const access = text(row["access"]);
+		commands.push({
+			command,
+			site,
+			name: name === "" ? command.slice(command.indexOf("/") + 1) : name,
+			domain: text(row["domain"]).toLowerCase(),
+			description: text(row["description"]),
+			access: access === "" ? "read" : access,
+			strategy: text(row["strategy"]).toLowerCase(),
+			browser: row["browser"] === true,
+			example: text(row["example"]),
+			columns: stringsOf$1(row["columns"])
+		});
+	}
+	return commands;
+}
+function pluginNamesOf(entries) {
+	return entries.filter((one) => one.startsWith(PLUGIN_PREFIX)).map((one) => one.slice(15)).filter((one) => one !== "").sort();
+}
+function pluginCommandsOf(files) {
+	return files.filter((one) => one.endsWith(".js")).map((one) => one.slice(0, -3)).filter((one) => one !== "index" && !one.startsWith("_")).sort();
+}
+function hostOf(url) {
+	const trimmed = url.trim();
+	if (trimmed === "") return "";
+	try {
+		return new URL(trimmed).hostname.toLowerCase().replace(/^www\./, "");
+	} catch {
+		return "";
+	}
+}
+function keywordsOf(keyword, url) {
+	const words = /* @__PURE__ */ new Set();
+	const trimmed = keyword.trim().toLowerCase();
+	if (trimmed !== "") words.add(trimmed);
+	const host = hostOf(url);
+	if (host !== "") words.add(host);
+	return [...words];
+}
+function scoreOf(command, word) {
+	const site = command.site.toLowerCase();
+	const name = command.name.toLowerCase();
+	if (word === "") return 0;
+	if (site === word) return 100;
+	if (site.includes(word)) return 80;
+	if (command.domain !== "" && command.domain.includes(word)) return 70;
+	if (site.length >= 3 && word.includes(site)) return 45;
+	if (name === word) return 65;
+	if (name.includes(word)) return 55;
+	if (command.command.toLowerCase().includes(word)) return 50;
+	if (command.description.toLowerCase().includes(word)) return 30;
+	return 0;
+}
+function reconOf(commands, plugins, keywords) {
+	const keyword = keywords[0] ?? "";
+	const best = /* @__PURE__ */ new Map();
+	for (const command of commands) {
+		let score = 0;
+		for (const word of keywords) score = Math.max(score, scoreOf(command, word));
+		if (score === 0) continue;
+		const current = best.get(command.command);
+		if (current === void 0 || current.score < score) best.set(command.command, {
+			command,
+			score
+		});
+	}
+	const grouped = /* @__PURE__ */ new Map();
+	for (const entry of best.values()) {
+		const group = grouped.get(entry.command.site) ?? {
+			best: 0,
+			rows: []
+		};
+		group.best = Math.max(group.best, entry.score);
+		group.rows.push(entry);
+		grouped.set(entry.command.site, group);
+	}
+	const base = {
+		keyword,
+		sites: [...grouped.entries()].sort((left, right) => right[1].best - left[1].best || left[0].localeCompare(right[0])).slice(0, SITE_LIMIT).map(([site, group]) => {
+			const picked = [...group.rows].sort((left, right) => (left.command.access === "write" ? 1 : 0) - (right.command.access === "write" ? 1 : 0) || right.score - left.score || left.command.command.localeCompare(right.command.command)).slice(0, COMMAND_LIMIT).map((one) => one.command);
+			const first = picked[0];
 			return {
 				site,
 				domain: first?.domain ?? "",
@@ -3407,7 +5278,7 @@ function nextOf(answer) {
 	}
 	const plugin = answer.plugins[0];
 	if (plugin !== void 0) return `这台机器另装的插件 ${plugin.name} 里有匹配：opencli ${plugin.name} --help 看全部命令`;
-	return "这台机器上没有现成的 —— 两条路：① 给这个站点写 adapter：opencli skills read opencli-adapter-author；② 只读一次：workbench_diy action=probe（script 读接口 / css 读 DOM）";
+	return "这台机器上没有现成的 —— 两条路：① 给这个站点写 adapter：opencli skills read opencli-adapter-author；② 只读一次：workbench_diy_probe（script 读接口 / css 读 DOM）";
 }
 function textOf$3(answer) {
 	const lines = [];
@@ -3575,7 +5446,7 @@ function renderPanel(options) {
 function statusOf(options) {
 	const { dir, unit, name, installed, known, open, health } = options;
 	const facts = moduleBuildFacts(dir);
-	const next = health.state === "failed" ? `它起不来：${health.reason ?? "(没给原因)"} —— 先把这一条修掉（改模块源码 → build；改了 package.json / cordis.patch.yml 要重启工作台），别去重装` : !installed ? "装：action=install（第一次，会让用户点头一次）" : !known ? "面板还不认得这个单元 —— 重启一次工作台（新装的模块要重启才注册进面板），重启后再 action=open" : !open ? "上板：action=open（只上板，不重装）" : !facts.builtAll ? "还没构建：pnpm exec dsh-wb-module build" : facts.stale ? "源码比产物新：pnpm exec dsh-wb-module build（宿主侧秒级热换；改了 client.js 刷新页面）" : "都在生效：改源码 → build（宿主侧秒级热换；改了 client.js 刷新页面），不要再装一遍";
+	const next = health.state === "failed" ? `它起不来：${health.reason ?? "(没给原因)"} —— 先把这一条修掉（改模块源码 → build；改了 package.json / cordis.patch.yml 要重启工作台），别去重装` : !installed ? "装：workbench_diy_install（第一次，会让用户点头一次）" : !known ? "面板还不认得这个单元 —— 重启一次工作台（新装的模块要重启才注册进面板），重启后再 workbench_diy_show" : !open ? "上板：workbench_diy_show（只上板，不重装）" : !facts.builtAll ? "还没构建：pnpm exec dsh-wb-module build" : facts.stale ? "源码比产物新：pnpm exec dsh-wb-module build（宿主侧秒级热换；改了 client.js 刷新页面）" : "都在生效：改源码 → build（宿主侧秒级热换；改了 client.js 刷新页面），不要再装一遍";
 	return {
 		unit,
 		name,
@@ -3607,342 +5478,319 @@ function renderStatus(packagesDir, lines) {
 function renderList(packagesDir, modules) {
 	if (modules.length === 0) return `工坊里还没有模块（${packagesDir}）—— 在里面造一个：pnpm exec dsh-wb-module init <名字> --dir <工坊>/packages/module-<名字> --template diy`;
 	const lines = modules.map((one) => `${one.unit} · ${one.installed ? "已装" : "没装"} · ${one.name}` + (one.description === "" ? "" : `\n${" ".repeat(one.unit.length)}      ${one.description}`));
-	const footer = modules.filter((one) => !one.installed).length === 0 ? "都已装过 —— **不要再装**：改源码 + dsh-wb-module build（宿主侧秒级热换；改了 client.js 刷新一下页面）。" : "装：workbench_diy（action=install, unit=<上面那个 unit>）";
+	const footer = modules.filter((one) => !one.installed).length === 0 ? "都已装过 —— **不要再装**：改源码 + dsh-wb-module build（宿主侧秒级热换；改了 client.js 刷新一下页面）。" : "装：workbench_diy_install（unit=<上面那个 unit>）";
 	return `工坊：${packagesDir}\n${lines.join("\n")}\n\n${footer}`;
 }
 //#endregion
 //#region src/modules/panels/model/diy-tools.ts
-var ACTIONS$2 = [
-	"list",
-	"status",
-	"panel",
-	"probe",
-	"recon",
-	"install",
-	"open"
-];
-var OUTPUT_SCHEMA$2 = {
-	type: "object",
-	properties: {
-		text: { type: "string" },
-		workshop: { type: "string" },
-		modules: {
-			type: "array",
-			items: {
-				type: "object",
-				additionalProperties: true
-			}
-		},
-		unit: { type: "string" },
-		path: { type: "string" },
-		install: {
-			type: "object",
-			additionalProperties: true
-		},
-		alreadyInstalled: { type: "boolean" },
-		panel: {
-			type: "object",
-			additionalProperties: true
-		}
-	},
-	additionalProperties: true
-};
-function asRecord$3(value) {
-	return typeof value === "object" && value !== null ? value : void 0;
-}
-function asNumber(value) {
-	if (typeof value === "number" && Number.isFinite(value)) return value;
-	if (typeof value === "string" && value.trim() !== "") {
-		const parsed = Number(value);
-		if (Number.isFinite(parsed)) return parsed;
-	}
-}
-function asText$1(value) {
-	return typeof value === "string" ? value.trim() : "";
-}
-function plainJson(value) {
-	return JSON.parse(JSON.stringify(value));
-}
-function verdictOf$1(change) {
-	if (change.application === "applied") return "装好了，已生效";
-	if (change.application === "restart-required") return "装好了，要重启一次才生效（装新模块、同名重装、替换已有包都走这一支）";
-	if (change.application === "overridden") return "被更高层的声明盖住了，这次没生效";
-	if (change.application === "cancelled") return "安装被取消，没有生效";
-	const tail = (change.packageResult?.output ?? "").trim().split("\n").slice(-3).join(" | ");
-	return `没装上（${change.errorCode ?? "failed"}）${tail === "" ? "" : `：${tail}`}`;
-}
-function renderProbe(out) {
-	if (out.ok) return `读到了 —— 这就是那条读的返回值，把它固化成模块宿主半侧的那一条：\n${(JSON.stringify(out.value, null, 2) ?? "undefined").slice(0, 2e3)}`;
-	const lines = [`没读到（${out.code}）：${out.message}`];
-	if (out.hint !== void 0) lines.push(`照做：${out.hint}`);
-	if (out.helpUrl !== void 0) lines.push(`入口：${out.helpUrl}`);
-	if (out.pageCode !== void 0) lines.push(`页面自己回的码：${out.pageCode}`);
-	return lines.join("\n");
-}
-function renderFind(out) {
-	if (!out.ok) {
-		const lines = [`没找到（${out.code}）：${out.message}`];
-		if (out.hint !== void 0) lines.push(`照做：${out.hint}`);
-		if (out.helpUrl !== void 0) lines.push(`入口：${out.helpUrl}`);
-		return lines.join("\n");
-	}
-	if (out.count === 0) return "找到了 0 个元素 —— 选择器没匹配到东西。先确认停在哪一页（probe 会自己问页面），再把选择器放宽一点（例如 table tr 而不是某个 id）。";
-	const head = out.entries.slice(0, 20).map((one, index) => `${String(index + 1)}. ${one.text.replace(/\n+/g, " | ").slice(0, 200)}`);
-	const more = out.entries.length > 20 ? `\n… 还有 ${String(out.entries.length - 20)} 个` : "";
-	return `找到了 ${String(out.count)} 个元素 —— 每行的单元格按换行拼在 text 里；把它固化成模块宿主半侧的那一条（host 的 browserFind + 切格 + 按列序取值）：\n${head.join("\n")}${more}`;
-}
-function showOrReason(panels, unit, workspace) {
-	try {
-		panels.show(unit, workspace);
-		return { ok: true };
-	} catch (error) {
-		return {
-			ok: false,
-			reason: error instanceof Error ? error.message : String(error)
-		};
-	}
-}
 function registerDiyTools(ctx, market, panels) {
 	const tools = ctx.get("tools");
 	if (tools === void 0) {
 		ctx.logger?.info?.("[dsh-workbench] 没有 tools 服务，跳过 DIY 工坊工具注册");
 		return [];
 	}
-	const tool = {
-		name: "workbench_diy",
-		description: "DIY 工坊里的模块：看它走到哪一步，或把它装上 / 上板。只认工坊里造好的模块 —— 普通项目里装模块用 workbench_modules。status 是入口，照它给的\"下一步\"走。install 是这台机器上的持久变更，一个模块一辈子只装一次：之后改源码只需 dsh-wb-module build（宿主侧秒级热换；改了 client.js 刷新一下页面）。",
-		parameters: withApprovalNote({
+	const listTool = {
+		name: DIY_LIST_TOOL,
+		description: "DIY 工坊里有哪些模块、装没装 —— 先跑它拿到 unit。普通项目里装模块用 workbench_modules_install。",
+		parameters: {
+			type: "object",
+			properties: {},
+			additionalProperties: false
+		},
+		output: OUTPUT$2,
+		async execute(_raw, exec) {
+			const { packagesDir } = workshopOf(ctx, exec);
+			const { modules } = modulesOf(ctx, packagesDir);
+			return plainJson({
+				workshop: packagesDir,
+				modules,
+				text: renderList(packagesDir, modules)
+			});
+		}
+	};
+	const statusTool = {
+		name: DIY_STATUS_TOOL,
+		description: "某个模块走到哪一步：装没装、面板认不认得、起得来没，以及下一步做什么。",
+		parameters: {
+			type: "object",
+			properties: { unit: {
+				type: "string",
+				description: "单元 id（workbench_diy_list 会给）。"
+			} },
+			required: ["unit"],
+			additionalProperties: false
+		},
+		output: OUTPUT$2,
+		async execute(raw, exec) {
+			const { packagesDir, workspace } = workshopOf(ctx, exec);
+			const { modules } = modulesOf(ctx, packagesDir);
+			const registry = ctx.get(UNITS_SERVICE);
+			const panelEntries = panelEntriesOf(panels, workspace);
+			const wanted = asText$1(asRecord$3(raw)["unit"]);
+			const picked = wanted === "" ? modules : modules.filter((one) => one.unit === wanted);
+			if (picked.length === 0) throw new Error(`工坊里没有单元 id 为「${wanted}」的模块（可用的：${modules.map((one) => one.unit).join(", ") || "（空）"}）`);
+			const rows = picked.map((one) => statusOf({
+				dir: one.dir,
+				unit: one.unit,
+				name: one.name,
+				installed: one.installed,
+				known: panelEntries.some((entry) => entry.id === one.unit),
+				open: panels.isEnabled(one.unit, workspace),
+				health: healthOf({
+					registry,
+					unit: one.unit,
+					installed: one.installed
+				})
+			}));
+			return plainJson({
+				workshop: packagesDir,
+				status: rows,
+				text: renderStatus(packagesDir, rows)
+			});
+		}
+	};
+	const panelTool = {
+		name: DIY_PANEL_TOOL,
+		description: "面板此刻的真实样子（每张卡读到没 / 崩没崩）—— 用户说\"卡片不对 / 一片空白\"就先调它。",
+		parameters: {
+			type: "object",
+			properties: { unit: {
+				type: "string",
+				description: "只看某一个单元（不填 = 全看）。"
+			} },
+			additionalProperties: false
+		},
+		output: OUTPUT$2,
+		async execute(raw, exec) {
+			const { packagesDir, workspace } = workshopOf(ctx, exec);
+			const { installed, modules } = modulesOf(ctx, packagesDir);
+			const panelState = ctx.get(PANEL_STATE_SERVICE);
+			const registry = ctx.get(UNITS_SERVICE);
+			const panelEntries = panelEntriesOf(panels, workspace);
+			const snapshot = panelState?.snapshot(workspace) ?? {
+				workspace,
+				at: 0,
+				units: []
+			};
+			const wanted = asText$1(asRecord$3(raw)["unit"]);
+			const board = panelEntries.filter((entry) => entry.shown && entry.hasCard).map((entry) => entry.id);
+			const nameOf = new Map(modules.map((one) => [one.unit, one.name]));
+			const reported = new Map(snapshot.units.map((one) => [one.unit, one]));
+			const rows = [.../* @__PURE__ */ new Set([
+				...board,
+				...reported.keys(),
+				...nameOf.keys()
+			])].filter((unit) => wanted === "" || unit === wanted).map((unit) => {
+				const report = reported.get(unit);
+				return {
+					unit,
+					name: nameOf.get(unit) ?? "",
+					health: healthOf({
+						registry,
+						unit,
+						installed: installed.includes(unit)
+					}),
+					...report === void 0 ? {} : { report }
+				};
+			});
+			return plainJson({
+				workshop: packagesDir,
+				workspace,
+				board,
+				report: snapshot,
+				panels: rows,
+				text: renderPanel({
+					packagesDir,
+					workspace,
+					rows,
+					board,
+					at: snapshot.at,
+					now: Date.now()
+				})
+			});
+		}
+	};
+	const reconTool = {
+		name: DIY_RECON_TOOL,
+		description: "先查 opencli 有没有现成的（自带 adapter / 本机插件）—— opencli 是什么自己查，别问用户。",
+		parameters: {
 			type: "object",
 			properties: {
-				action: {
+				keyword: {
 					type: "string",
-					description: "list=工坊里有哪些模块（默认）；status=某个模块走到哪一步、下一步做什么；panel=面板此刻的真实样子（宿主回的原文都在）—— 用户说\"卡片不对 / 一片空白 / 一直转圈\"就先调它；recon=先查 opencli 有没有现成的（自带 adapter / 本机插件）—— opencli 是什么自己查，别问用户；probe=用用户浏览器里现有的登录探一条读（script 或 css）；open=只上板（不装）；install=装上并上板（第一次，会让用户点头）。",
-					enum: [...ACTIONS$2]
+					description: "站点名 / 系统名 / 域名（英文名或域名最准，例：bilibili、arxiv.org、cmdb）。"
 				},
-				unit: {
+				url: {
 					type: "string",
-					description: "status / panel / open / install 填：单元 id（list 会给）。"
-				},
+					description: "那套系统的地址（从它取域名）。"
+				}
+			},
+			required: ["keyword"],
+			additionalProperties: false
+		},
+		output: OUTPUT$2,
+		async execute(raw, exec) {
+			const { packagesDir } = workshopOf(ctx, exec);
+			const args = asRecord$3(raw);
+			const keywords = keywordsOf(asText$1(args["keyword"]), asText$1(args["url"]));
+			if (keywords.length === 0) throw new Error("recon 要一个关键词（站点名 / 系统名 / 域名都行）：先拿它去 opencli 自带的那份目录里找有没有现成的能力，别一上来就自己写 adapter；用户不知道 opencli 是什么，这一步别问他。");
+			const catalog = reconCatalogOf();
+			if (catalog === void 0) throw new Error(`读不到 opencli 那份目录（${cliCatalogPath()}）—— 隔离运行时还没装好；照做：${isolatedInstallCommand()}`);
+			return plainJson({
+				workshop: packagesDir,
+				ok: true,
+				...reconOf(catalog, installedPluginsOf(), keywords)
+			});
+		}
+	};
+	const probeTool = {
+		name: DIY_PROBE_TOOL,
+		description: "用用户浏览器里现有的登录探一条读：script 读接口 / css 读 DOM。不在站点上会自己打开 url。",
+		parameters: {
+			type: "object",
+			properties: {
 				script: {
 					type: "string",
-					description: "probe 要（与 css 二选一）：读接口用这个 —— 在页面里跑一段回 JSON 的脚本。不在站点就回 { ok: false, code: \"not-on-site\" }；登录过期回 { ok: false, code: \"not-logged-in\" }；成功回 { ok: true, ...数据 }。"
+					description: "与 css 二选一：页面里跑一段回 JSON 的脚本。不在站点回 { ok: false, code: \"not-on-site\" }，登录过期回 \"not-logged-in\"，成功回 { ok: true, ...数据 }。"
 				},
 				css: {
 					type: "string",
-					description: "probe 要（与 script 二选一）：读 DOM 用这个 —— 给一个 CSS 选择器，宿主回匹配到的元素文本（每行的单元格按换行拼在 text 里）；不在站点会自己打开 url 再读一遍。"
+					description: "与 script 二选一：给一个 CSS 选择器，宿主回匹配到的元素文本（每行单元格按换行拼在 text 里）。"
 				},
 				limit: {
 					type: "number",
-					description: "probe 配 css 用：最多回几个元素（默认 50）。"
+					description: "配 css 用：最多回几个元素（默认 50）。"
 				},
 				textMax: {
 					type: "number",
-					description: "probe 配 css 用：每个元素文本最多留几个字（默认 200）。"
+					description: "配 css 用：每个元素文本最多留几个字（默认 200）。"
 				},
 				url: {
 					type: "string",
-					description: "probe / recon 用：那套系统的地址（probe 不在站点上时自己打开它再读一遍；recon 从它取域名）。"
-				},
-				keyword: {
-					type: "string",
-					description: "recon 要：站点名 / 系统名 / 域名（英文名或域名最准，例：bilibili、arxiv.org、cmdb）。"
+					description: "那套系统的地址（不在站点上时自己打开它再读一遍）。"
 				},
 				loginUrl: {
 					type: "string",
-					description: "probe 用：要登录时那颗\"去登录\"该去哪（默认用 url）。"
+					description: "要登录时那颗\"去登录\"该去哪（默认用 url）。"
 				},
 				session: {
 					type: "string",
-					description: "probe 用：会话名（默认 workbench，一般不用填）。"
+					description: "会话名（默认 workbench，一般不用填）。"
 				},
 				open: {
 					type: "boolean",
-					description: "probe 用：不在站点上时要不要顺手打开（默认要）。"
+					description: "不在站点上时要不要顺手打开（默认要）。"
 				}
 			},
-			required: ["action"],
 			additionalProperties: false
-		}, { required: true }),
-		output: {
-			schema: OUTPUT_SCHEMA$2,
-			render: (_args, value) => {
-				const payload = value;
-				return [{
-					type: "text",
-					text: typeof payload?.text === "string" ? payload.text : JSON.stringify(value)
-				}];
-			}
 		},
+		output: OUTPUT$2,
 		async execute(raw, exec) {
-			const args = asRecord$3(raw) ?? {};
-			const action = asText$1(args.action) || "list";
-			if (!ACTIONS$2.includes(action)) throw new Error(`不认识的 action：${action}（可用：${ACTIONS$2.join(" / ")}）`);
-			const packagesDir = workshopPackagesDir(ctx);
-			if (packagesDir === null) throw new Error("算不出 DIY 工坊在哪（这台机器没给出 dshHomePath）—— 让用户跑一次 dsh-workbench setup");
-			const session = sessionWorkspace(exec);
-			if (!inWorkshopSession(ctx, session)) throw new Error(`这把工具只在 DIY 工坊里用：当前会话不在工坊里（这个会话的工作区 ${session ?? "(不知道)"}）—— 普通项目里装模块用 workbench_modules，工坊的入口是左栏那一行「工作台DIY」`);
-			const workspace = session;
-			const installed = profileModules(profileDirOf(ctx)).map((row) => row.unit);
-			const modules = workshopModules(packagesDir, installed);
-			const registry = ctx.get(UNITS_SERVICE);
-			const panelState = ctx.get(PANEL_STATE_SERVICE);
-			if (action === "list") return plainJson({
-				workshop: packagesDir,
-				modules,
-				text: renderList(packagesDir, modules)
-			});
-			const panelEntries = (() => {
-				try {
-					return panels.list(workspace);
-				} catch {
-					return [];
-				}
-			})();
-			const statusOfUnit = (one) => statusOf({
-				dir: one.dir,
-				unit: one.unit,
-				name: one.name,
-				installed: one.installed,
-				known: panelEntries.some((entry) => entry.id === one.unit),
-				open: panels.isEnabled(one.unit, workspace),
-				health: healthOf({
-					registry,
-					unit: one.unit,
-					installed: one.installed
-				})
-			});
-			if (action === "status") {
-				const wanted = asText$1(args.unit);
-				const picked = wanted === "" ? modules : modules.filter((one) => one.unit === wanted);
-				if (wanted !== "" && picked.length === 0) throw new Error(`工坊里没有单元 id 为「${wanted}」的模块（可用的：${modules.map((one) => one.unit).join(", ") || "（空）"}）`);
-				const rows = picked.map(statusOfUnit);
-				return plainJson({
-					workshop: packagesDir,
-					status: rows,
-					text: renderStatus(packagesDir, rows)
-				});
-			}
-			if (action === "panel") {
-				const snapshot = panelState?.snapshot(workspace) ?? {
-					workspace,
-					at: 0,
-					units: []
-				};
-				const wanted = asText$1(args.unit);
-				const board = panelEntries.filter((entry) => entry.shown && entry.hasCard).map((entry) => entry.id);
-				const nameOf = new Map(modules.map((one) => [one.unit, one.name]));
-				const reported = new Map(snapshot.units.map((one) => [one.unit, one]));
-				const rows = [.../* @__PURE__ */ new Set([
-					...board,
-					...reported.keys(),
-					...nameOf.keys()
-				])].filter((unit) => wanted === "" || unit === wanted).map((unit) => {
-					const report = reported.get(unit);
-					return {
-						unit,
-						name: nameOf.get(unit) ?? "",
-						health: healthOf({
-							registry,
-							unit,
-							installed: installed.includes(unit)
-						}),
-						...report === void 0 ? {} : { report }
-					};
-				});
-				return plainJson({
-					workshop: packagesDir,
-					workspace,
-					board,
-					report: snapshot,
-					panels: rows,
-					text: renderPanel({
-						packagesDir,
-						workspace,
-						rows,
-						board,
-						at: snapshot.at,
-						now: Date.now()
-					})
-				});
-			}
-			if (action === "recon") {
-				const keywords = keywordsOf(asText$1(args.keyword), asText$1(args.url));
-				if (keywords.length === 0) throw new Error("recon 要一个关键词（站点名 / 系统名 / 域名都行）：先拿它去 opencli 自带的那份目录里找有没有现成的能力，别一上来就自己写 adapter；用户不知道 opencli 是什么，这一步别问他。");
-				const catalog = reconCatalogOf();
-				if (catalog === void 0) throw new Error(`读不到 opencli 那份目录（${cliCatalogPath()}）—— 隔离运行时还没装好；照做：${isolatedInstallCommand()}`);
-				return plainJson({
-					workshop: packagesDir,
-					ok: true,
-					...reconOf(catalog, installedPluginsOf(), keywords)
-				});
-			}
-			if (action === "probe") {
-				const script = asText$1(args.script);
-				const css = asText$1(args.css);
-				if (script === "" && css === "") throw new Error("probe 要 script（页面脚本，回 JSON）或 css（读 DOM 那一行的选择器）之一。script 的约定：不在那个站点上就回 { ok: false, code: \"not-on-site\" }（我会自己把它打开再读一遍）；登录过期回 { ok: false, code: \"not-logged-in\" }；成功回 { ok: true, ...数据 }。页面里压根没有接口时给 css，别写 document.querySelectorAll（宿主产物不许出现 DOM 字样）。");
-				const shell = ctx.get("shell");
-				if (shell === void 0) throw new Error("这台机器上没有 shell 服务，probe 跑不了");
-				const url = asText$1(args.url);
-				const loginUrl = asText$1(args.loginUrl);
-				const session = asText$1(args.session);
-				const open = typeof args.open === "boolean" ? args.open : void 0;
-				if (css !== "") {
-					const limit = asNumber(args.limit);
-					const textMax = asNumber(args.textMax);
-					const found = await browserFind({
-						shell,
-						css,
-						command: opencliCommandOf(ctx).command,
-						...url === "" ? {} : { url },
-						...session === "" ? {} : { session },
-						...open === void 0 ? {} : { open },
-						...limit === void 0 ? {} : { limit },
-						...textMax === void 0 ? {} : { textMax }
-					});
-					return plainJson({
-						workshop: packagesDir,
-						...found,
-						text: renderFind(found)
-					});
-				}
-				const out = await browserRead({
+			const { packagesDir } = workshopOf(ctx, exec);
+			const args = asRecord$3(raw);
+			const script = asText$1(args["script"]);
+			const css = asText$1(args["css"]);
+			if (script === "" && css === "") throw new Error("probe 要 script（页面脚本，回 JSON）或 css（读 DOM 那一行的选择器）之一。script 的约定：不在那个站点上就回 { ok: false, code: \"not-on-site\" }（我会自己把它打开再读一遍）；登录过期回 { ok: false, code: \"not-logged-in\" }；成功回 { ok: true, ...数据 }。页面里压根没有接口时给 css，别写 document.querySelectorAll（宿主产物不许出现 DOM 字样）。");
+			const shell = ctx.get("shell");
+			if (shell === void 0) throw new Error("这台机器上没有 shell 服务，probe 跑不了");
+			const url = asText$1(args["url"]);
+			const loginUrl = asText$1(args["loginUrl"]);
+			const session = asText$1(args["session"]);
+			const open = typeof args["open"] === "boolean" ? args["open"] : void 0;
+			if (css !== "") {
+				const limit = asNumber(args["limit"]);
+				const textMax = asNumber(args["textMax"]);
+				const found = await browserFind({
 					shell,
-					script,
+					css,
 					command: opencliCommandOf(ctx).command,
 					...url === "" ? {} : { url },
-					...loginUrl === "" ? {} : { loginUrl },
 					...session === "" ? {} : { session },
-					...open === void 0 ? {} : { open }
-				});
-				return plainJson({
-					workshop: packagesDir,
-					...out,
-					text: renderProbe(out)
+					...open === void 0 ? {} : { open },
+					...limit === void 0 ? {} : { limit },
+					...textMax === void 0 ? {} : { textMax }
 				});
-			}
-			const unit = asText$1(args.unit);
-			if (unit === "") throw new Error(`install 要一个 unit（工坊里：${modules.map((one) => one.unit).join(", ") || "（空）"}）`);
-			const found = modules.find((one) => one.unit === unit);
-			if (found === void 0) throw new Error(`工坊里没有单元 id 为「${unit}」的模块（可用的：${modules.map((one) => one.unit).join(", ") || "（空）"}）—— 先装上的前提是它在工坊里造好了`);
-			if (!insideWorkshop(packagesDir, found.dir)) throw new Error(`这个模块不在工坊里（${found.dir}）—— 只装 ${packagesDir} 之下的模块`);
-			if (action === "open") {
-				if (!found.installed) throw new Error(`${unit} 还没装 —— open 只负责上板。先用 action=install 装上（第一次会让用户点头一次）`);
-				const panel = showOrReason(panels, unit, workspace);
-				const text = panel.ok ? `面板上已经打开它了（${workspace}）—— 让用户看一眼` : `面板上还没打开：${panel.reason}。这就是它的下一步（status 会给出同样的判断）`;
 				return plainJson({
 					workshop: packagesDir,
-					unit,
-					path: found.dir,
-					panel,
-					text
+					...found,
+					text: renderFind(found)
 				});
 			}
+			const out = await browserRead({
+				shell,
+				script,
+				command: opencliCommandOf(ctx).command,
+				...url === "" ? {} : { url },
+				...loginUrl === "" ? {} : { loginUrl },
+				...session === "" ? {} : { session },
+				...open === void 0 ? {} : { open }
+			});
+			return plainJson({
+				workshop: packagesDir,
+				...out,
+				text: renderProbe(out)
+			});
+		}
+	};
+	function unitOf(packagesDir, raw, label) {
+		const { modules } = modulesOf(ctx, packagesDir);
+		const unit = asText$1(asRecord$3(raw)["unit"]);
+		if (unit === "") throw new Error(`${label} 要一个 unit（工坊里：${modules.map((one) => one.unit).join(", ") || "（空）"}）`);
+		const found = modules.find((one) => one.unit === unit);
+		if (found === void 0) throw new Error(`工坊里没有单元 id 为「${unit}」的模块（可用的：${modules.map((one) => one.unit).join(", ") || "（空）"}）—— 先装上的前提是它在工坊里造好了`);
+		if (!insideWorkshop(packagesDir, found.dir)) throw new Error(`这个模块不在工坊里（${found.dir}）—— 只装 ${packagesDir} 之下的模块`);
+		return found;
+	}
+	const showTool = {
+		name: DIY_SHOW_TOOL,
+		description: "只上板（不装）：把一个已经装好的工坊模块显示在当前项目的面板上。",
+		parameters: withApprovalNote({
+			type: "object",
+			properties: { unit: {
+				type: "string",
+				description: "单元 id（workbench_diy_list 会给）。"
+			} },
+			required: ["unit"],
+			additionalProperties: false
+		}, { required: true }),
+		output: OUTPUT$2,
+		async execute(raw, exec) {
+			const { packagesDir, workspace } = workshopOf(ctx, exec);
+			const found = unitOf(packagesDir, raw, "workbench_diy_show");
+			if (!found.installed) throw new Error(`${found.unit} 还没装 —— 只上板的前提是它装过了。先用 workbench_diy_install（第一次会让用户点头一次）`);
+			const panel = showOrReason(panels, found.unit, workspace);
+			const text = panel.ok ? `面板上已经打开它了（${workspace}）—— 让用户看一眼` : `面板上还没打开：${panel.reason}。这就是它的下一步（workbench_diy_status 会给出同样的判断）`;
+			return plainJson({
+				workshop: packagesDir,
+				unit: found.unit,
+				path: found.dir,
+				panel,
+				text
+			});
+		}
+	};
+	const installTool = {
+		name: DIY_INSTALL_TOOL,
+		description: "把工坊里造好的模块装上并上到当前项目的面板。这是持久变更，一个模块只装一次：之后改源码只需 dsh-wb-module build（宿主侧秒级热换）。",
+		parameters: withApprovalNote({
+			type: "object",
+			properties: { unit: {
+				type: "string",
+				description: "单元 id（workbench_diy_list 会给）。"
+			} },
+			required: ["unit"],
+			additionalProperties: false
+		}, { required: true }),
+		output: OUTPUT$2,
+		async execute(raw, exec) {
+			const { packagesDir, workspace } = workshopOf(ctx, exec);
+			const found = unitOf(packagesDir, raw, "workbench_diy_install");
 			if (found.installed) {
-				const panel = showOrReason(panels, unit, workspace);
-				const text = [`它已经装过了（就是工坊里这一份）—— **不要再装**：改源码 + dsh-wb-module build（宿主侧秒级热换；改了 client.js 刷新一下页面）。`, panel.ok ? `面板上已经打开它了（${workspace}）—— 让用户看一眼` : `面板上还没打开：${panel.reason}。调 workbench_panels（action=show, id=${unit}）`].join("\n");
+				const panel = showOrReason(panels, found.unit, workspace);
+				const text = ["它已经装过了（就是工坊里这一份）—— **不要再装**：改源码 + dsh-wb-module build（宿主侧与 client.js 都秒级热换 —— dsh-client-hmr 盯着每个 bundle 的 lib/client.js，重建了就换进已打开的页面）。", panel.ok ? `面板上已经打开它了（${workspace}）—— 让用户看一眼` : `面板上还没打开：${panel.reason}。调 workbench_diy_show（unit=${found.unit}）`].join("\n");
 				return plainJson({
 					workshop: packagesDir,
-					unit,
+					unit: found.unit,
 					path: found.dir,
 					alreadyInstalled: true,
 					panel,
@@ -3952,19 +5800,19 @@ function registerDiyTools(ctx, market, panels) {
 			const outcome = await market.installBundle(found.dir);
 			const verdict = verdictOf$1(outcome.change);
 			const restartRequired = outcome.change.application === "restart-required";
-			const panel = outcome.change.application === "applied" ? showOrReason(panels, unit, workspace) : {
+			const panel = outcome.change.application === "applied" ? showOrReason(panels, found.unit, workspace) : {
 				ok: false,
 				reason: `安装结果是 ${outcome.change.application}，还没生效`
 			};
-			const panelText = panel.ok ? `面板上已经打开它了（${workspace}）—— 让用户看一眼` : outcome.change.application === "applied" ? `面板上还没打开：${panel.reason}。调 workbench_panels（action=show, id=${unit}）试试。` : restartRequired ? `面板上还没打开（${panel.reason}）：模块要**重启一次工作台**才注册进面板 —— 把这句话转给用户，重启后再调 workbench_panels（action=show, id=${unit}）。` : `面板上还没打开：${panel.reason}。先把上面那句"没装成"处理掉，再谈上板。`;
+			const panelText = panel.ok ? `面板上已经打开它了（${workspace}）—— 让用户看一眼` : outcome.change.application === "applied" ? `面板上还没打开：${panel.reason}。调 workbench_diy_show（unit=${found.unit}）试试。` : restartRequired ? `面板上还没打开（${panel.reason}）：模块要**重启一次工作台**才注册进面板 —— 把这句话转给用户，重启后再调 workbench_diy_show（unit=${found.unit}）。` : `面板上还没打开：${panel.reason}。先把上面那句"没装成"处理掉，再谈上板。`;
 			const text = [
-				`${verdict}：${unit}（${found.name}）`,
+				`${verdict}：${found.unit}（${found.name}）`,
 				panelText,
-				"之后只改源码 + dsh-wb-module build（宿主侧秒级热换；改了 client.js 刷新一下页面）：不要再装一遍。"
+				"之后只改源码 + dsh-wb-module build（宿主侧与 client.js 都秒级热换 —— dsh-client-hmr 盯着每个 bundle 的 lib/client.js，重建了就换进已打开的页面）：不要再装一遍。"
 			].join("\n");
 			return plainJson({
 				workshop: packagesDir,
-				unit,
+				unit: found.unit,
 				path: found.dir,
 				install: outcome.change,
 				module: outcome.module,
@@ -3973,7 +5821,19 @@ function registerDiyTools(ctx, market, panels) {
 			});
 		}
 	};
-	return [tools.register(tool)];
+	return [
+		tools.register(listTool),
+		tools.register(statusTool),
+		tools.register(panelTool),
+		tools.register(reconTool),
+		tools.register(probeTool),
+		...registerLookTools(ctx, tools),
+		...registerLogTools(ctx, tools),
+		...registerNetTools(ctx, tools),
+		...registerActTools(ctx, tools),
+		tools.register(showTool),
+		tools.register(installTool)
+	];
 }
 //#endregion
 //#region src/shared/api/host/release.ts
@@ -5136,7 +6996,7 @@ function createEnvDropper(options) {
 async function rememberInstalledSource(deps, manager, pkg, registry) {
 	const { registries, logger } = deps;
 	if (registries === void 0 || registry === void 0) return;
-	const scope = scopeOf(pkg);
+	const scope = scopeOf$1(pkg);
 	if (scope === null) return;
 	const known = await manager.registries().catch(() => null);
 	if (known !== null && sameRegistry(known.resolved, registry)) return;
@@ -5694,27 +7554,41 @@ function failureText(change) {
 function describeInstall(spec, module, supply, change) {
 	return `${change.application === "applied" ? "装好了，已生效" : change.application === "restart-required" ? "装好了，要重启一次才生效" : `没成功：${failureText(change)}`}：${module.kind === "module" ? `${module.unit}（${module.pkg}）` : module.pkg}${supply.state === "installed" ? "；它要的 opencli 插件也装上了" : supply.state === "pending-restart" ? "；重启后再装它要的 opencli 插件" : supply.state === "not-a-module" ? "；但它不是工作台模块（没有 dsh.workbench 声明，不会出现在面板上）" : supply.state === "failed" ? `；但它要的插件没装上：${supply.reason}` : ""}（spec：${spec}）`;
 }
-var OUTPUT_SCHEMA$1 = {
-	type: "object",
-	properties: {
-		text: { type: "string" },
-		modules: {
-			type: "array",
-			items: {
-				type: "object",
-				additionalProperties: true
+var OUTPUT$1 = {
+	schema: {
+		type: "object",
+		properties: {
+			text: { type: "string" },
+			modules: {
+				type: "array",
+				items: {
+					type: "object",
+					additionalProperties: true
+				}
+			},
+			shared: {
+				type: "array",
+				items: {
+					type: "object",
+					additionalProperties: true
+				}
 			}
 		},
-		shared: {
-			type: "array",
-			items: {
-				type: "object",
-				additionalProperties: true
-			}
-		}
+		additionalProperties: true
 	},
-	additionalProperties: true
+	render: (_args, value) => {
+		const payload = value;
+		return [{
+			type: "text",
+			text: typeof payload?.text === "string" ? payload.text : JSON.stringify(value)
+		}];
+	}
 };
+function textArg(raw, key) {
+	if (typeof raw !== "object" || raw === null) return "";
+	const value = raw[key];
+	return typeof value === "string" ? value.trim() : "";
+}
 function describePluginUninstall(pkg, outcome) {
 	if (outcome.removed) return `已卸载 opencli 插件 ${pkg}：没人再用它，文件也删了。`;
 	return `已从「你装的插件」里去掉 ${pkg}。${outcome.kept === void 0 ? "" : pluginKeptText(outcome.kept)}`;
@@ -5728,98 +7602,167 @@ function usersOf(shared, names) {
 	if (hit === void 0 || hit.usedBy.length === 0) return "";
 	return `它被 ${hit.usedBy.join("、")} 用着（动的是它们的供给，它们的状态跟着重探了一遍）`;
 }
-var ACTIONS$1 = [
-	"list",
-	"install",
-	"update",
-	"uninstall",
-	"install-bundle",
-	"update-dependency",
-	"update-plugin",
-	"uninstall-plugin",
-	"update-workbench"
-];
 function registerMarketTools(ctx, market) {
 	const tools = ctx.get("tools");
 	if (tools === void 0) {
 		ctx.logger?.info?.("[dsh-workbench] 没有 tools 服务，跳过模块市场工具注册");
 		return [];
 	}
-	const tool = {
-		name: "workbench_modules",
-		description: "看 / 装 / 升 / 卸工作台的面板模块，以及用户自己装的 opencli 插件。install-bundle 按 spec 把模块包装进 profile；按模块 id 的 install / update 只装、升它声明的那份外部供给（opencli 插件与库），不换模块包本身；uninstall 连模块包一起卸。update-workbench 把工作台自己更新到源上的新版（一般自己换上，要重启时结果里会说；重启由用户来）。卸模块只动工作台运行时，不影响终端那套 dsh；共用依赖只有升级。",
+	const noParams = {
+		type: "object",
+		properties: {},
+		additionalProperties: false
+	};
+	async function idOrList(raw, label) {
+		const id = textArg(raw, "id");
+		if (id !== "") return id;
+		const { modules, shared } = await market.list();
+		throw new Error(`${label} 需要一个 id（例如 coding-issues）。可安装的模块：${modules.map((entry) => entry.unit).join(", ") || "（空）"}；共用依赖：${shared.map((dep) => dep.id).join(", ") || "（空）"}`);
+	}
+	function moduleSupplyTool(spec) {
+		return {
+			name: spec.name,
+			description: spec.description,
+			parameters: withApprovalNote({
+				type: "object",
+				properties: { id: {
+					type: "string",
+					description: "模块 id（如 coding-issues）。"
+				} },
+				required: ["id"],
+				additionalProperties: false
+			}, { required: true }),
+			output: OUTPUT$1,
+			async execute(raw) {
+				const id = await idOrList(raw, spec.name);
+				const entry = spec.install ? await market.install(id) : await market.update(id);
+				return {
+					module: entry,
+					text: `${spec.install ? "已安装" : "已更新"} ${id}：${stateOf(entry)}`
+				};
+			}
+		};
+	}
+	const listTool = {
+		name: MODULES_LIST_TOOL,
+		description: "看模块市场与已装：每个模块装没装、可用不可用、要哪些 opencli 插件；还有共用依赖（只有升级）。",
+		parameters: noParams,
+		output: OUTPUT$1,
+		async execute() {
+			const { modules, shared } = await market.list();
+			return {
+				modules,
+				shared,
+				text: render$1(modules, shared)
+			};
+		}
+	};
+	const installTool = moduleSupplyTool({
+		name: MODULES_INSTALL_TOOL,
+		description: "按模块 id 装它声明的那份外部供给（opencli 插件与库），不换模块包本身。",
+		install: true
+	});
+	const updateTool = moduleSupplyTool({
+		name: MODULES_UPDATE_TOOL,
+		description: "按模块 id 升它声明的那份外部供给（opencli 插件与库），不换模块包本身。",
+		install: false
+	});
+	const uninstallTool = {
+		name: MODULES_UNINSTALL_TOOL,
+		description: "卸模块：连模块包一起卸（只动工作台运行时）；要换一份实现先卸再装。",
+		parameters: withApprovalNote({
+			type: "object",
+			properties: { id: {
+				type: "string",
+				description: "模块 id（如 coding-issues）。"
+			} },
+			required: ["id"],
+			additionalProperties: false
+		}, { required: true }),
+		output: OUTPUT$1,
+		async execute(raw) {
+			const id = await idOrList(raw, MODULES_UNINSTALL_TOOL);
+			const outcome = await market.uninstall(id);
+			const kept = outcome.keptFor.length === 0 ? "" : `（还有模块在面板上要用其中一份安装，所以那份留着：${outcome.keptFor.join("、")}）`;
+			return {
+				module: outcome.entry,
+				text: `已卸载 ${id}：${stateOf(outcome.entry)}${kept}`
+			};
+		}
+	};
+	const installBundleTool = {
+		name: MODULES_INSTALL_BUNDLE_TOOL,
+		description: "按 spec 把模块包装进这份 profile（包名 / git 地址 / tarball / 本地路径）；装完它要的插件也一起装。",
 		parameters: withApprovalNote({
 			type: "object",
 			properties: {
-				action: {
-					type: "string",
-					description: "list=看状态（默认）；install / update / uninstall 要 id；install-bundle 要 spec（换源给 registry）；update-dependency 要 id；update-plugin / uninstall-plugin 要 plugin。",
-					enum: [...ACTIONS$1]
-				},
-				id: {
-					type: "string",
-					description: "模块 id（如 coding-issues）；update-dependency 用共用依赖 id（如 plugin:coding）。"
-				},
 				spec: {
 					type: "string",
-					description: "包名（可带 @版本），也可以是 git 地址 / tarball / 本地绝对路径。"
+					description: "包名（可带 @版本）/ git 地址 / tarball / 本地路径。"
 				},
 				registry: {
 					type: "string",
-					description: "去哪个源装（不填就用这份 profile 自己配的源）。"
-				},
-				plugin: {
-					type: "string",
-					description: "opencli 插件的包名或插件名（如 cmdb 或 opencli-plugin-cmdb）。"
+					description: "去哪个源装（不填用 profile 自己配的源）。"
 				}
 			},
-			required: ["action"],
+			required: ["spec"],
 			additionalProperties: false
 		}, { required: true }),
-		output: {
-			schema: OUTPUT_SCHEMA$1,
-			render: (_args, value) => {
-				const payload = value;
-				return [{
-					type: "text",
-					text: typeof payload?.text === "string" ? payload.text : JSON.stringify(value)
-				}];
-			}
-		},
-		async execute(args) {
-			const action = args?.action ?? "list";
-			if (!ACTIONS$1.includes(action)) throw new Error(`不认识的 action：${action}（可用：${ACTIONS$1.join(" / ")}）`);
-			if (action === "list") {
-				const { modules, shared } = await market.list();
-				return {
-					modules,
-					shared,
-					text: render$1(modules, shared)
-				};
-			}
-			if (action === "install-bundle") {
-				const spec = args?.spec?.trim() ?? "";
-				if (spec === "") throw new Error("install-bundle 需要一个 spec：包名（可带版本，如 @scope/module@1.2.3），也可以是 git 地址 / tarball / 本地绝对路径。");
-				const registry = args?.registry?.trim();
-				const outcome = await market.installBundle(spec, registry === void 0 || registry === "" ? {} : { registry });
-				return {
-					change: outcome.change,
-					module: outcome.module,
-					supply: outcome.supply,
-					text: describeInstall(spec, outcome.module, outcome.supply, outcome.change)
-				};
-			}
-			if (action === "update-workbench") {
-				const outcome = await market.updateWorkbench("");
-				return {
-					change: outcome.change,
-					text: describeWorkbenchUpdate(outcome.change)
-				};
-			}
-			if (action === "update-plugin" || action === "uninstall-plugin") {
-				const plugin = args?.plugin?.trim() ?? "";
-				if (plugin === "") throw new Error(`${action} 需要一个 plugin：opencli 插件的包名或插件名 —— 就是市场「已安装 opencli 插件」那一段里的名字。`);
-				if (action === "update-plugin") {
+		output: OUTPUT$1,
+		async execute(raw) {
+			const spec = textArg(raw, "spec");
+			if (spec === "") throw new Error("install-bundle 需要一个 spec：包名（可带版本，如 @scope/module@1.2.3），也可以是 git 地址 / tarball / 本地绝对路径。");
+			const registry = textArg(raw, "registry");
+			const outcome = await market.installBundle(spec, registry === "" ? {} : { registry });
+			return {
+				change: outcome.change,
+				module: outcome.module,
+				supply: outcome.supply,
+				text: describeInstall(spec, outcome.module, outcome.supply, outcome.change)
+			};
+		}
+	};
+	const updateDependencyTool = {
+		name: MODULES_UPDATE_DEPENDENCY_TOOL,
+		description: "升共用依赖（工作台自己那份营生，如 plugin:coding）：只有升级，用依赖 id。",
+		parameters: withApprovalNote({
+			type: "object",
+			properties: { id: {
+				type: "string",
+				description: "共用依赖 id（如 plugin:coding）。"
+			} },
+			required: ["id"],
+			additionalProperties: false
+		}, { required: true }),
+		output: OUTPUT$1,
+		async execute(raw) {
+			const id = await idOrList(raw, MODULES_UPDATE_DEPENDENCY_TOOL);
+			const shared = await market.updateDependency(id);
+			const dep = shared.find((item) => item.id === id);
+			return {
+				shared,
+				text: `已更新共用依赖 ${id}${dep === void 0 ? "" : `：${stateOfDependency(dep)}`}`
+			};
+		}
+	};
+	function pluginTool(spec) {
+		return {
+			name: spec.name,
+			description: spec.description,
+			parameters: withApprovalNote({
+				type: "object",
+				properties: { plugin: {
+					type: "string",
+					description: "opencli 插件的包名或插件名（如 cmdb）。"
+				} },
+				required: ["plugin"],
+				additionalProperties: false
+			}, { required: true }),
+			output: OUTPUT$1,
+			async execute(raw) {
+				const plugin = textArg(raw, "plugin");
+				if (plugin === "") throw new Error(`${spec.name} 需要一个 plugin：opencli 插件的包名或插件名 —— 就是市场「已安装 opencli 插件」那一段里的名字。`);
+				if (spec.update) {
 					const updated = await market.updatePlugin(plugin);
 					const users = usersOf((await market.list()).shared, [updated.name, plugin]);
 					return { text: `已更新 opencli 插件 ${plugin}${users === "" ? "。" : `；${users}。`}` };
@@ -5833,35 +7776,42 @@ function registerMarketTools(ctx, market) {
 					text: `${describePluginUninstall(plugin, outcome)}${users === "" ? "" : `${users}。`}`
 				};
 			}
-			const id = args?.id;
-			if (id === void 0 || id.trim() === "") {
-				const { modules, shared } = await market.list();
-				throw new Error(`${action} 需要一个 id（例如 coding-issues）。可安装的模块：${modules.map((entry) => entry.unit).join(", ") || "（空）"}；共用依赖：${shared.map((dep) => dep.id).join(", ") || "（空）"}`);
-			}
-			if (action === "update-dependency") {
-				const shared = await market.updateDependency(id);
-				const dep = shared.find((item) => item.id === id);
-				return {
-					shared,
-					text: `已更新共用依赖 ${id}${dep === void 0 ? "" : `：${stateOfDependency(dep)}`}`
-				};
-			}
-			const outcome = action === "install" ? {
-				entry: await market.install(id),
-				keptFor: []
-			} : action === "update" ? {
-				entry: await market.update(id),
-				keptFor: []
-			} : await market.uninstall(id);
-			const verb = action === "uninstall" ? "已卸载" : action === "update" ? "已更新" : "已安装";
-			const kept = outcome.keptFor.length === 0 ? "" : `（还有模块在面板上要用其中一份安装，所以那份留着：${outcome.keptFor.join("、")}）`;
+		};
+	}
+	const updatePluginTool = pluginTool({
+		name: MODULES_UPDATE_PLUGIN_TOOL,
+		description: "更新用户装的 opencli 插件（按包名或插件名）；老插件跑不动了先试它。",
+		update: true
+	});
+	const uninstallPluginTool = pluginTool({
+		name: MODULES_UNINSTALL_PLUGIN_TOOL,
+		description: "卸用户装的 opencli 插件：没人再用它时文件也删；还有模块用着就只从名单去掉。",
+		update: false
+	});
+	const updateWorkbenchTool = {
+		name: MODULES_UPDATE_WORKBENCH_TOOL,
+		description: "把工作台自己更新到源上的新版（要重启时结果里会说；重启由用户来）。",
+		parameters: withApprovalNote(noParams, { required: true }),
+		output: OUTPUT$1,
+		async execute() {
+			const outcome = await market.updateWorkbench("");
 			return {
-				module: outcome.entry,
-				text: `${verb} ${id}：${stateOf(outcome.entry)}${kept}`
+				change: outcome.change,
+				text: describeWorkbenchUpdate(outcome.change)
 			};
 		}
 	};
-	return [tools.register(tool)];
+	return [
+		tools.register(listTool),
+		tools.register(installTool),
+		tools.register(updateTool),
+		tools.register(uninstallTool),
+		tools.register(installBundleTool),
+		tools.register(updateDependencyTool),
+		tools.register(updatePluginTool),
+		tools.register(uninstallPluginTool),
+		tools.register(updateWorkbenchTool)
+	];
 }
 //#endregion
 //#region src/modules/panels/model/prefs.ts
@@ -5920,23 +7870,26 @@ function applyPanelsPref(panels, payload) {
 //#region src/modules/panels/model/handoff.ts
 var PANELS_FACT = "panels";
 var CAPABILITY_FACT = "capability";
+var PROVISION_TOOLS = {
+	[MODULES_INSTALL_TOOL]: "install",
+	[MODULES_UPDATE_TOOL]: "update",
+	[MODULES_UNINSTALL_TOOL]: "uninstall",
+	[MODULES_UPDATE_DEPENDENCY_TOOL]: "update-dependency",
+	[DIY_INSTALL_TOOL]: "install"
+};
 function textOf$2(value) {
 	return typeof value === "string" ? value.trim() : "";
 }
-function actionOf(call) {
-	return textOf$2(call.args["action"]) || "list";
-}
 function requestOf(call) {
-	const action = actionOf(call);
-	if (!PROVISION_ACTIONS.includes(action)) return void 0;
+	const action = PROVISION_TOOLS[call.source];
+	if (action === void 0) return void 0;
 	const target = textOf$2(call.args["unit"]) || textOf$2(call.args["id"]);
 	if (target === "") return void 0;
-	const wanted = action;
-	return isDependencyAction(wanted) ? {
-		action: wanted,
+	return isDependencyAction(action) ? {
+		action,
 		id: target
 	} : {
-		action: wanted,
+		action,
 		unit: target
 	};
 }
@@ -5948,11 +7901,10 @@ function panelsHandoffEntry(target = {}) {
 	};
 }
 function panelsFactsOf(call, manifests) {
-	if (call.source === "workbench_panels") return actionOf(call) === "list" ? [PANELS_FACT] : void 0;
-	if (call.source === "workbench_diy" && actionOf(call) === "list") return [PANELS_FACT];
-	if (call.source !== "workbench_modules" && call.source !== "workbench_diy") return void 0;
-	if (actionOf(call) === "list") return [PANELS_FACT, CAPABILITY_FACT];
-	if (actionOf(call) === "update-workbench") return [PANELS_FACT, CAPABILITY_FACT];
+	if (call.source === "workbench_panels_list") return [PANELS_FACT];
+	if (call.source === "workbench_modules_list") return [PANELS_FACT, CAPABILITY_FACT];
+	if (call.source === "workbench_modules_update_workbench") return [PANELS_FACT, CAPABILITY_FACT];
+	if (call.source === "workbench_diy_list") return [PANELS_FACT];
 	const request = requestOf(call);
 	if (request === void 0) return void 0;
 	return [
@@ -6280,16 +8232,28 @@ function pluginRoutes(options) {
 //#region src/modules/panels/model/tools.ts
 var MACHINE_LABEL = "机器级默认板 —— 还没配过的工作区默认开这些：";
 var MACHINE_CAVEAT = "机器级默认板只是还没配过的工作区的默认值：已经自己配过的工作区保持自己的选择，不会被它改。";
+var SCOPE_PARAM = {
+	type: "string",
+	description: "workspace（默认）=只动当前工作区；machine=动机器级默认板（只影响还没配过的工作区）。",
+	enum: ["workspace", "machine"]
+};
+var ID_PARAM = {
+	type: "string",
+	description: "套件 id（如 cmdb）。"
+};
+function noted(parameters) {
+	return withApprovalNote(parameters, { required: true });
+}
 function listed(entries) {
 	return entries.map((entry, index) => `${index + 1}. ${entry.id} · ${entry.shown ? "已启用" : "未启用"}${entry.hasCard ? "" : "（无卡片）"}${entry.source === "user" ? " · 用户改过" : ""}`).join("\n");
 }
 function render(entries, workspace, scope) {
 	if (scope === "machine") {
-		if (entries.length === 0) return "机器级默认板是空的（还没配过的工作区默认什么卡片都不开）——用 show 放一个上去。";
+		if (entries.length === 0) return "机器级默认板是空的（还没配过的工作区默认什么卡片都不开）——用 workbench_panels_show 放一个上去。";
 		return `${MACHINE_LABEL}\n${listed(entries)}`;
 	}
 	const where = workspace === null ? "（不知道当前会话在哪个工作区）" : workspace;
-	if (entries.length === 0) return `这个工作区的面板是空的（${where}）——用 show 放一个上去。`;
+	if (entries.length === 0) return `这个工作区的面板是空的（${where}）——用 workbench_panels_show 放一个上去。`;
 	return `当前工作区：${where}\n${listed(entries)}`;
 }
 function parseScope(raw) {
@@ -6297,141 +8261,205 @@ function parseScope(raw) {
 	if (typeof raw === "string" && BOARD_TARGETS.includes(raw)) return raw;
 	throw new Error(`不认识的 scope：${String(raw)}（可用：workspace / machine）`);
 }
-var OUTPUT_SCHEMA = {
-	type: "object",
-	properties: {
-		text: { type: "string" },
-		units: {
-			type: "array",
-			items: {
-				type: "object",
-				properties: {
-					id: { type: "string" },
-					shown: { type: "boolean" },
-					order: { type: "integer" },
-					hasCard: { type: "boolean" },
-					source: { type: "string" }
-				},
-				additionalProperties: true
+var OUTPUT = {
+	schema: {
+		type: "object",
+		properties: {
+			text: { type: "string" },
+			units: {
+				type: "array",
+				items: {
+					type: "object",
+					properties: {
+						id: { type: "string" },
+						shown: { type: "boolean" },
+						order: { type: "integer" },
+						hasCard: { type: "boolean" },
+						source: { type: "string" }
+					},
+					additionalProperties: true
+				}
 			}
-		}
+		},
+		additionalProperties: true
 	},
-	additionalProperties: true
+	render: (_args, value) => {
+		const payload = value;
+		return [{
+			type: "text",
+			text: typeof payload?.text === "string" ? payload.text : JSON.stringify(value)
+		}];
+	}
 };
+function idOf(raw) {
+	if (typeof raw !== "object" || raw === null) return void 0;
+	const value = raw["id"];
+	return typeof value === "string" ? value : void 0;
+}
+function scopeOf(raw) {
+	if (typeof raw !== "object" || raw === null) return parseScope(void 0);
+	return parseScope(raw["scope"]);
+}
 function registerPanelTools(ctx, panels, values) {
 	const tools = ctx.get("tools");
 	if (tools === void 0) {
 		ctx.logger?.info?.("[dsh-workbench] 没有 tools 服务，跳过户表面板工具注册");
 		return [];
 	}
-	const tool = {
-		name: "workbench_panels",
-		description: "看或调右侧面板：哪些套件开着、什么顺序。两份板：本工作区那份优先，没提过的行看机器级默认板 —— 那只是还没配过的工作区的默认值（已经自己配过的工作区保持自己的选择）；本工作区只记改过的那几行，所以那份板以后改了，没改过的工作区跟着变。收起 = 这个工作区明确不要它：卡片与 agent 工具一起在这个工作区下线，连机器级默认板上开着的套件也照样收起；别的项目不受影响、不删数据，要放回来用 show。在机器级默认板上 hide 是写下\"不要它\"这一笔 —— 比名单更管用，show 会把这一笔划掉。顺序只属于工作区：没排过的按各模块自己声明的次序（开着的在前、关着的在后），show 或 move 过就以那次为准。",
-		parameters: withApprovalNote({
+	const listTool = {
+		name: PANELS_LIST_TOOL,
+		description: "看现在这份板：哪些套件开着、什么顺序。两份板：本工作区那份优先，没提过的行看机器级默认板 ——那只是还没配过的工作区的默认值（自己配过的保持自己的选择）。",
+		parameters: {
+			type: "object",
+			properties: { scope: SCOPE_PARAM },
+			additionalProperties: false
+		},
+		output: OUTPUT,
+		async execute(raw, exec) {
+			const scope = scopeOf(raw);
+			const workspace = sessionWorkspace(exec);
+			const units = panels.list(workspace, scope);
+			if (scope === "workspace") {
+				const entry = panelsHandoffEntry(workspace === null ? {} : { path: workspace });
+				if (entry !== void 0) values?.hand(entry, units);
+			}
+			return {
+				units,
+				text: render(units, workspace, scope)
+			};
+		}
+	};
+	const showTool = {
+		name: PANELS_SHOW_TOOL,
+		description: "这个工作区要它：之前收起的也放回来，卡片与 agent 工具一起上线；那份板上写过\"不要\"的也划掉。",
+		parameters: noted({
 			type: "object",
 			properties: {
-				action: {
-					type: "string",
-					description: "list=看现在这份板（默认）；show=这个工作区要它（之前收起的也放回来）；hide=这个工作区明确不要它；move=调顺序（新开一行时排最后）；reset=清掉这个工作区改过的行（改完全部回到跟着机器级默认板走）；follow=某一行放回跟随（带 id = 只那一行，不带 = 全部）。",
-					enum: [
-						"list",
-						"show",
-						"hide",
-						"move",
-						"reset",
-						"follow"
-					]
-				},
-				id: {
-					type: "string",
-					description: "show / hide / move 必填：要动的套件 id。"
-				},
+				id: ID_PARAM,
+				scope: SCOPE_PARAM
+			},
+			required: ["id"],
+			additionalProperties: false
+		}),
+		output: OUTPUT,
+		async execute(raw, exec) {
+			const id = idOf(raw);
+			const scope = scopeOf(raw);
+			const workspace = sessionWorkspace(exec);
+			if (id === void 0 || id === "") throw new Error(`workbench_panels_show 需要一个 id（例如 coding-issues）。当前套件：${panels.list(workspace, scope).map((entry) => entry.id).join(", ")}`);
+			const units = panels.show(id, workspace, scope);
+			return {
+				units,
+				text: scope === "machine" ? `已把 ${id} 放进机器级默认板 —— 还没配过的工作区会带上它（卡片与工具一起上线）；那份板上要是给它写过"不要"，这一下也划掉了。${MACHINE_CAVEAT}\n${render(units, workspace, scope)}` : `已启用 ${id} —— 这个工作区要它：之前收起的也放回来了，卡片与工具一起上线。\n${render(units, workspace, scope)}`
+			};
+		}
+	};
+	const hideTool = {
+		name: PANELS_HIDE_TOOL,
+		description: "这个工作区明确不要它：卡片与 agent 工具一起下线（机器板上开着的也照样收起）；别的项目不受影响，要放回来用 workbench_panels_show。在机器板上 hide 是写下\"不要\"这一笔，比名单管用。",
+		parameters: noted({
+			type: "object",
+			properties: {
+				id: ID_PARAM,
+				scope: SCOPE_PARAM
+			},
+			required: ["id"],
+			additionalProperties: false
+		}),
+		output: OUTPUT,
+		async execute(raw, exec) {
+			const id = idOf(raw);
+			const scope = scopeOf(raw);
+			const workspace = sessionWorkspace(exec);
+			if (id === void 0 || id === "") throw new Error(`workbench_panels_hide 需要一个 id（例如 coding-issues）。当前套件：${panels.list(workspace, scope).map((entry) => entry.id).join(", ")}`);
+			const units = panels.hide(id, workspace, scope);
+			return {
+				units,
+				text: scope === "machine" ? `已把 ${id} 从机器级默认板划掉，并在那份板上明确写下"不要它" —— 还没配过的工作区从此看不到它（卡片与工具一起下线）；名单里还列着它也一样不算数，要放回来用 workbench_panels_show。${MACHINE_CAVEAT}\n${render(units, workspace, scope)}` : `已收起 ${id} —— 这个工作区明确不要它：卡片与工具一起下线（默认在机器上也开着的套件同样收起），别的项目不受影响；要放回来用 workbench_panels_show。\n${render(units, workspace, scope)}`
+			};
+		}
+	};
+	const moveTool = {
+		name: PANELS_MOVE_TOOL,
+		description: "调顺序：放到最前面（新开一行时排最后）。顺序只属于工作区；机器级默认板上没有顺序一说。",
+		parameters: noted({
+			type: "object",
+			properties: {
+				id: ID_PARAM,
 				index: {
 					type: "integer",
-					description: "move 的位置，0 基（数的是当前开着的那几行）。"
+					description: "位置，0 基（数的是当前开着的那几行）。"
 				},
-				scope: {
-					type: "string",
-					description: "workspace（默认）=只动当前工作区；machine=动那份机器级默认板（只影响还没配过的工作区；没有顺序一说，move 会报错）。",
-					enum: ["workspace", "machine"]
-				}
+				scope: SCOPE_PARAM
 			},
-			required: ["action"],
+			required: ["id"],
 			additionalProperties: false
-		}, { required: true }),
-		output: {
-			schema: OUTPUT_SCHEMA,
-			render: (_args, value) => {
-				const payload = value;
-				return [{
-					type: "text",
-					text: typeof payload?.text === "string" ? payload.text : JSON.stringify(value)
-				}];
-			}
-		},
-		async execute(args, exec) {
-			const action = args?.action ?? "list";
-			const id = args?.id;
-			const scope = parseScope(args?.scope);
+		}),
+		output: OUTPUT,
+		async execute(raw, exec) {
+			const id = idOf(raw);
+			const scope = scopeOf(raw);
 			const workspace = sessionWorkspace(exec);
-			const list = () => panels.list(workspace, scope);
-			if (![
-				"list",
-				"show",
-				"hide",
-				"move",
-				"reset",
-				"follow"
-			].includes(action)) throw new Error(`不认识的 action：${action}（可用：list / show / hide / move / reset / follow）`);
-			if (action === "list") {
-				const units = list();
-				if (scope === "workspace") {
-					const entry = panelsHandoffEntry(workspace === null ? {} : { path: workspace });
-					if (entry !== void 0) values?.hand(entry, units);
-				}
-				return {
-					units,
-					text: render(units, workspace, scope)
-				};
-			}
-			if (action === "follow") {
-				if (scope === "machine") throw new Error("机器级默认板没有\"放回跟随\"一说：它就是那份默认本身，直接 show / hide 写它。");
-				const units = panels.follow(workspace, id);
-				return {
-					units,
-					text: id === void 0 ? `这个工作区改过的行全部清掉 —— 每一行都回到跟着机器级默认板走（那份板以后改了，这里跟着变）。\n${render(units, workspace, scope)}` : `${id} 放回跟随 —— 它不再由这个工作区定，改跟机器级默认板走。\n${render(units, workspace, scope)}`
-				};
-			}
-			if (action === "reset") {
-				const units = panels.reset(workspace, scope);
-				return {
-					units,
-					text: scope === "machine" ? `机器级默认板已清空 —— 从今往后，没在这一行改过的工作区默认什么都不开。${MACHINE_CAVEAT}\n${render(units, workspace, scope)}` : `这个工作区改过的行已全部清掉 —— 每一行都回到跟着机器级默认板走。\n${render(units, workspace, scope)}`
-				};
-			}
-			if (id === void 0) throw new Error(`${action} 需要一个 id（例如 coding-issues）。当前套件：${list().map((entry) => entry.id).join(", ")}`);
-			if (action === "show") {
-				const units = panels.show(id, workspace, scope);
-				return {
-					units,
-					text: scope === "machine" ? `已把 ${id} 放进机器级默认板 —— 还没配过的工作区会带上它（卡片与工具一起上线）；那份板上要是给它写过"不要"，这一下也划掉了。${MACHINE_CAVEAT}\n${render(units, workspace, scope)}` : `已启用 ${id} —— 这个工作区要它：之前收起的也放回来了，卡片与工具一起上线。\n${render(units, workspace, scope)}`
-				};
-			}
-			if (action === "hide") {
-				const units = panels.hide(id, workspace, scope);
-				return {
-					units,
-					text: scope === "machine" ? `已把 ${id} 从机器级默认板划掉，并在那份板上明确写下"不要它" —— 还没配过的工作区从此看不到它（卡片与工具一起下线）；名单里还列着它也一样不算数，要放回来用 show。${MACHINE_CAVEAT}\n${render(units, workspace, scope)}` : `已收起 ${id} —— 这个工作区明确不要它：卡片与工具一起下线（默认在机器上也开着的套件同样收起），别的项目不受影响；要放回来用 show。\n${render(units, workspace, scope)}`
-				};
-			}
-			const units = panels.move(id, args?.index ?? 0, workspace, scope);
+			if (id === void 0 || id === "") throw new Error(`workbench_panels_move 需要一个 id（例如 coding-issues）。当前套件：${panels.list(workspace, scope).map((entry) => entry.id).join(", ")}`);
+			const index = typeof raw === "object" && raw !== null && typeof raw.index === "number" ? raw.index : 0;
+			const units = panels.move(id, index, workspace, scope);
+			return {
+				units,
+				text: scope === "machine" ? `已把 ${id} 放到机器级默认板第 ${index + 1} 位 —— 只影响还没配过的工作区。${MACHINE_CAVEAT}\n${render(units, workspace, scope)}` : `已把 ${id} 放到第 ${index + 1} 位。\n${render(units, workspace, scope)}`
+			};
+		}
+	};
+	const resetTool = {
+		name: PANELS_RESET_TOOL,
+		description: "清掉这个工作区改过的行（改完全部回到跟着机器级默认板走）；scope=machine 清的是整份机器级默认板。",
+		parameters: noted({
+			type: "object",
+			properties: { scope: SCOPE_PARAM },
+			additionalProperties: false
+		}),
+		output: OUTPUT,
+		async execute(raw, exec) {
+			const scope = scopeOf(raw);
+			const workspace = sessionWorkspace(exec);
+			const units = panels.reset(workspace, scope);
+			return {
+				units,
+				text: scope === "machine" ? `机器级默认板已清空 —— 从今往后，没在这一行改过的工作区默认什么都不开。${MACHINE_CAVEAT}\n${render(units, workspace, scope)}` : `这个工作区改过的行已全部清掉 —— 每一行都回到跟着机器级默认板走。\n${render(units, workspace, scope)}`
+			};
+		}
+	};
+	const followTool = {
+		name: PANELS_FOLLOW_TOOL,
+		description: "某一行放回跟随机器级默认板（带 id = 只那一行，不带 = 全部）。",
+		parameters: noted({
+			type: "object",
+			properties: {
+				id: ID_PARAM,
+				scope: SCOPE_PARAM
+			},
+			additionalProperties: false
+		}),
+		output: OUTPUT,
+		async execute(raw, exec) {
+			const id = idOf(raw);
+			const scope = scopeOf(raw);
+			const workspace = sessionWorkspace(exec);
+			if (scope === "machine") throw new Error("机器级默认板没有\"放回跟随\"一说：它就是那份默认本身，直接 show / hide 写它。");
+			const units = panels.follow(workspace, id);
 			return {
 				units,
-				text: scope === "machine" ? `已把 ${id} 放到机器级默认板第 ${(args?.index ?? 0) + 1} 位 —— 只影响还没配过的工作区。${MACHINE_CAVEAT}\n${render(units, workspace, scope)}` : `已把 ${id} 放到第 ${(args?.index ?? 0) + 1} 位。\n${render(units, workspace, scope)}`
+				text: id === void 0 ? `这个工作区改过的行全部清掉 —— 每一行都回到跟着机器级默认板走（那份板以后改了，这里跟着变）。\n${render(units, workspace, scope)}` : `${id} 放回跟随 —— 它不再由这个工作区定，改跟机器级默认板走。\n${render(units, workspace, scope)}`
 			};
 		}
 	};
-	return [tools.register(tool)];
+	return [
+		tools.register(listTool),
+		tools.register(showTool),
+		tools.register(hideTool),
+		tools.register(moveTool),
+		tools.register(resetTool),
+		tools.register(followTool)
+	];
 }
 //#endregion
 //#region src/app/units/host.ts
@@ -6514,7 +8542,7 @@ var OWNED = [{
 					return [...manifests().flatMap((manifest) => owned.has(manifest.id) || resolveScope({
 						id: manifest.id,
 						boards
-					}) ? [] : manifest.tools.map((tool) => tool.name)), ...inWorkshopSession(ctx, workspace) ? [] : [DIY_TOOL]];
+					}) ? [] : manifest.tools.map((tool) => tool.name)), ...inWorkshopSession(ctx, workspace) ? [] : [...DIY_TOOLS]];
 				},
 				subscribe: (listener) => panels.subscribe(listener)
 			},
@@ -6562,18 +8590,19 @@ function withRunsRoute(result, unit) {
 		}
 	};
 }
-function notedRegistry(registry, writesOf) {
+function notedRegistry(registry, writesOf, journal) {
 	return { register(definition) {
-		if (!writesOf(definition.name)) return registry.register(definition);
-		const noted = withApprovalNote(definition.parameters, { required: true });
-		return registry.register(noted === definition.parameters ? definition : {
+		const noted = writesOf(definition.name) ? withApprovalNote(definition.parameters, { required: true }) : void 0;
+		const registered = registry.register(noted === void 0 || noted === definition.parameters ? definition : {
 			...definition,
 			parameters: noted
 		});
+		journal.push(registered);
+		return registered;
 	} };
 }
-function scopedMountCtx(ctx, registry, writesOf) {
-	const tools = notedRegistry(registry, writesOf);
+function scopedMountCtx(ctx, registry, writesOf, journal) {
+	const tools = notedRegistry(registry, writesOf, journal);
 	const get = (name) => {
 		const value = ctx.get(name);
 		return name === "tools" && value !== void 0 ? tools : value;
@@ -6588,6 +8617,12 @@ function failureReasonOf(error) {
 	if (error instanceof Error) return error.message;
 	return typeof error === "string" ? error : String(error);
 }
+function applyPlanFailures(failures, sinks) {
+	for (const failure of failures) {
+		sinks.note(failure.id, failure.reason);
+		sinks.warn(`[dsh-workbench] ${failure.id} 套件起不来，已摘掉它这一份：${failure.reason}`);
+	}
+}
 function fail(ledger, item, reason) {
 	ledger.failed.add(item);
 	ledger.failures.push({
@@ -6729,7 +8764,8 @@ function mountUnits(units, deps) {
 		const unit = host.manifest.id;
 		const tools = deps.ctx.get("tools");
 		const writes = toolUnits(deps.manifests());
-		const mountCtx = tools === void 0 ? deps.ctx : scopedMountCtx(deps.ctx, tools, (name) => writes.get(name)?.writes === true);
+		const toolJournal = [];
+		const mountCtx = tools === void 0 ? deps.ctx : scopedMountCtx(deps.ctx, tools, (name) => writes.get(name)?.writes === true, toolJournal);
 		const longTasks = deps.longTasks === void 0 ? void 0 : createLongTaskHost({
 			scope: deps.longTasks.scope,
 			unit,
@@ -6761,7 +8797,10 @@ function mountUnits(units, deps) {
 		const item = {
 			host,
 			readiness,
-			result: withRunsRoute(result, unit)
+			result: withRunsRoute(result, unit),
+			rollbackTools: () => {
+				for (const dispose of toolJournal.splice(0)) dispose();
+			}
 		};
 		mounted.push(item);
 		if (longTasks !== void 0) longTaskDisposers.set(item, longTasks.dispose);
@@ -9153,13 +11192,16 @@ function apply(ctx) {
 			return;
 		}
 		for (const item of one.skipped) ctx.logger?.warn?.(`[dsh-workbench] ${item.id} 套件缺硬依赖，跳过：${item.missing.join(", ")}`);
-		for (const failure of one.failed) {
-			mountFailures.set(failure.id, {
-				reason: failure.reason,
-				host
-			});
-			ctx.logger?.warn?.(`[dsh-workbench] ${failure.id} 套件起不来，已摘掉它这一份：${failure.reason}`);
-		}
+		applyPlanFailures(one.failed, {
+			note: (unit, reason) => {
+				mountFailures.set(unit, {
+					reason,
+					host
+				});
+				units.fail(unit, reason);
+			},
+			warn: (message) => ctx.logger?.warn?.(message)
+		});
 		const slot = one.mounted[0];
 		if (slot === void 0) {
 			one.disposeLongTasks();
@@ -9183,6 +11225,7 @@ function apply(ctx) {
 			mountFailures.delete(id);
 			units.recovered(id);
 		} catch (error) {
+			slot.rollbackTools();
 			for (const route of added) delete routes[route];
 			for (const kind of one.contextRenderers.keys()) renderers.delete(kind);
 			for (const unit of one.factsOf.keys()) factsOfMap.delete(unit);