@dsh-workbench/core 0.3.1 → 0.3.3

package/dist/host/index.js

@@ -252,7 +252,7 @@ var PHASES = [
 function asRecord$10(value) {
 	return typeof value === "object" && value !== null ? value : void 0;
 }
-function textOf$9(value, max) {
+function textOf$8(value, max) {
 	if (typeof value !== "string") return "";
 	const trimmed = value.trim();
 	return trimmed.length > max ? trimmed.slice(0, max) : trimmed;
@@ -265,8 +265,8 @@ function atOf(value) {
 function errorOf(raw) {
 	const record = asRecord$10(raw);
 	if (record === void 0) return void 0;
-	const code = textOf$9(record["code"], 120);
-	const message = textOf$9(record["message"], PANEL_STATE_MAX_TEXT);
+	const code = textOf$8(record["code"], 120);
+	const message = textOf$8(record["message"], PANEL_STATE_MAX_TEXT);
 	if (code === "" && message === "") return void 0;
 	return {
 		code: code === "" ? "unknown" : code,
@@ -279,7 +279,7 @@ function parseCardsReport(payload) {
 		ok: false,
 		message: "请求体要是一个对象"
 	};
-	const workspace = textOf$9(record["workspace"], PANEL_STATE_MAX_TEXT);
+	const workspace = textOf$8(record["workspace"], PANEL_STATE_MAX_TEXT);
 	if (workspace === "") return {
 		ok: false,
 		message: "workspace 不能是空的 —— 面板按工作区存"
@@ -293,9 +293,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$9(card["unit"], 200);
-		const route = textOf$9(card["route"], 400);
-		const phase = textOf$9(card["phase"], 20);
+		const unit = textOf$8(card["unit"], 200);
+		const route = textOf$8(card["route"], 400);
+		const phase = textOf$8(card["phase"], 20);
 		const at = atOf(card["at"]);
 		if (unit === "" || route === "" || at === null || !PHASES.includes(phase)) continue;
 		const error = errorOf(card["error"]);
@@ -325,9 +325,9 @@ function parseCrashReport(payload) {
 		ok: false,
 		message: "请求体要是一个对象"
 	};
-	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);
+	const workspace = textOf$8(record["workspace"], PANEL_STATE_MAX_TEXT);
+	const unit = textOf$8(record["unit"], 200);
+	const reason = textOf$8(record["reason"], PANEL_STATE_MAX_TEXT);
 	if (workspace === "") return {
 		ok: false,
 		message: "workspace 不能是空的"
@@ -593,7 +593,10 @@ async function runShell(shell, command, options = {}) {
 		truncated: result.stdout.truncated || result.stderr.truncated
 	};
 }
-var DEFAULT_TIMEOUT_MS$1 = 25e3;
+//#endregion
+//#region ../shared/dist/host/browser-read.js
+var BROWSER_SCREEN_SESSION = "workbench";
+var DEFAULT_TIMEOUT_MS$2 = 25e3;
 var DEFAULT_RETRY_MS = 1200;
 var DEFAULT_SETTLE_MS$1 = 900;
 var AUTH_CODES = /* @__PURE__ */ new Set([
@@ -614,20 +617,20 @@ var PERMISSION_CODES = /* @__PURE__ */ new Set([
 function asRecord$9(value) {
 	return typeof value === "object" && value !== null ? value : void 0;
 }
-function textOf$8(value) {
+function textOf$7(value) {
 	return typeof value === "string" ? value.trim() : "";
 }
 function codeOf(page) {
 	const record = asRecord$9(page);
-	return record === void 0 ? "" : textOf$8(record["code"]);
+	return record === void 0 ? "" : textOf$7(record["code"]);
 }
 function messageOf$2(page) {
 	const record = asRecord$9(page);
-	return record === void 0 ? "" : textOf$8(record["message"]);
+	return record === void 0 ? "" : textOf$7(record["message"]);
 }
 function hintOf$1(page) {
 	const record = asRecord$9(page);
-	const hint = record === void 0 ? "" : textOf$8(record["hint"]);
+	const hint = record === void 0 ? "" : textOf$7(record["hint"]);
 	return hint === "" ? void 0 : hint;
 }
 function pageFailed(page) {
@@ -765,8 +768,8 @@ async function openOnce$1(shell, command, session, url, timeoutMs) {
 async function browserRead(options) {
 	const { shell, script, url, loginUrl, open = true } = options;
 	const command = options.command ?? "opencli";
-	const session = options.session ?? "workbench";
-	const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS$1;
+	const session = options.session ?? "workbench-read";
+	const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS$2;
 	const retryMs = options.retryMs ?? DEFAULT_RETRY_MS;
 	const settleMs = options.settleMs ?? DEFAULT_SETTLE_MS$1;
 	const at = Date.now();
@@ -850,7 +853,7 @@ async function browserRead(options) {
 }
 //#endregion
 //#region ../shared/dist/host/browser-find.js
-var DEFAULT_TIMEOUT_MS = 25e3;
+var DEFAULT_TIMEOUT_MS$1 = 25e3;
 var DEFAULT_SETTLE_MS = 2500;
 var URL_TIMEOUT_MS = 8e3;
 var DEFAULT_LIMIT = 50;
@@ -858,7 +861,7 @@ var DEFAULT_TEXT_MAX = 200;
 function asRecord$8(value) {
 	return typeof value === "object" && value !== null ? value : void 0;
 }
-function textOf$7(value) {
+function textOf$6(value) {
 	return typeof value === "string" ? value.trim() : "";
 }
 function entriesOf(value) {
@@ -871,8 +874,8 @@ function entriesOf(value) {
 		if (item === void 0) continue;
 		const nth = typeof item["nth"] === "number" ? item["nth"] : entries.length;
 		entries.push({
-			text: textOf$7(item["text"]),
-			tag: textOf$7(item["tag"]),
+			text: textOf$6(item["text"]),
+			tag: textOf$6(item["tag"]),
 			nth
 		});
 	}
@@ -881,7 +884,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$7(error["message"]);
+	const message = error === void 0 ? "" : textOf$6(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);
@@ -889,7 +892,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$7(error["hint"]);
+	const hint = error === void 0 ? "" : textOf$6(error["hint"]);
 	return hint === "" ? void 0 : hint;
 }
 function sameOrigin(left, right) {
@@ -903,7 +906,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$7(parsed["url"]);
+		const url = parsed === void 0 ? "" : textOf$6(parsed["url"]);
 		if (url !== "") return url;
 	}
 	return bare;
@@ -981,10 +984,10 @@ async function openOnce(shell, command, session, url, timeoutMs) {
 async function browserFind(options) {
 	const { shell, css, url, open = true } = options;
 	const command = options.command ?? "opencli";
-	const session = options.session ?? "workbench";
+	const session = options.session ?? "workbench-read";
 	const limit = options.limit ?? DEFAULT_LIMIT;
 	const textMax = options.textMax ?? DEFAULT_TEXT_MAX;
-	const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+	const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS$1;
 	const settleMs = options.settleMs ?? DEFAULT_SETTLE_MS;
 	const at = Date.now();
 	const find = async () => {
@@ -2005,7 +2008,7 @@ var PLUGIN_LEDGER_FILE = "plugins.json";
 function ledgerKeyOf(entry) {
 	return `${entry.opencliHome}\u0000${entry.package}`;
 }
-function textOf$6(value) {
+function textOf$5(value) {
 	if (typeof value !== "string") return void 0;
 	const trimmed = value.trim();
 	return trimmed === "" ? void 0 : trimmed;
@@ -2013,13 +2016,13 @@ function textOf$6(value) {
 function entryOf(value) {
 	if (typeof value !== "object" || value === null) return void 0;
 	const box = value;
-	const opencliHome = textOf$6(box["opencliHome"]);
-	const pkg = textOf$6(box["package"]);
-	const installedAt = textOf$6(box["installedAt"]);
+	const opencliHome = textOf$5(box["opencliHome"]);
+	const pkg = textOf$5(box["package"]);
+	const installedAt = textOf$5(box["installedAt"]);
 	if (opencliHome === void 0 || pkg === void 0 || installedAt === void 0) return void 0;
-	const name = textOf$6(box["name"]);
-	const registry = textOf$6(box["registry"]);
-	const releasedAt = textOf$6(box["releasedAt"]);
+	const name = textOf$5(box["name"]);
+	const registry = textOf$5(box["registry"]);
+	const releasedAt = textOf$5(box["releasedAt"]);
 	return {
 		opencliHome,
 		package: pkg,
@@ -3023,22 +3026,24 @@ 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_SPEC_TOOL = "workbench_diy_spec";
 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_STATE_TOOL = "workbench_diy_state";
+var DIY_HTML_TOOL = "workbench_diy_html";
+var DIY_FIND_TOOL = "workbench_diy_find";
 var DIY_CLICK_TOOL = "workbench_diy_click";
+var DIY_HOVER_TOOL = "workbench_diy_hover";
 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_WAIT_TOOL = "workbench_diy_wait";
+var DIY_EVAL_TOOL = "workbench_diy_eval";
+var DIY_SCREENSHOT_TOOL = "workbench_diy_screenshot";
+var DIY_NETWORK_TOOL = "workbench_diy_network";
+var DIY_DIALOG_TOOL = "workbench_diy_dialog";
 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";
@@ -3053,20 +3058,22 @@ var READ_TOOLS = [
 	DIY_STATUS_TOOL,
 	DIY_PANEL_TOOL,
 	DIY_RECON_TOOL,
+	DIY_SPEC_TOOL,
 	DIY_PROBE_TOOL,
-	DIY_LOOK_TOOL,
+	DIY_STATE_TOOL,
+	DIY_HTML_TOOL,
+	DIY_FIND_TOOL,
 	DIY_CLICK_TOOL,
+	DIY_HOVER_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_WAIT_TOOL,
+	DIY_EVAL_TOOL,
+	DIY_SCREENSHOT_TOOL,
+	DIY_NETWORK_TOOL,
+	DIY_DIALOG_TOOL,
 	DIY_LOGS_WATCH_TOOL,
 	DIY_LOGS_READ_TOOL,
 	DIY_LOGS_STOP_TOOL
@@ -3097,22 +3104,24 @@ var DIY_TOOLS = [
 	DIY_STATUS_TOOL,
 	DIY_PANEL_TOOL,
 	DIY_RECON_TOOL,
+	DIY_SPEC_TOOL,
 	DIY_PROBE_TOOL,
-	DIY_LOOK_TOOL,
 	DIY_INSTALL_TOOL,
 	DIY_SHOW_TOOL,
+	DIY_STATE_TOOL,
+	DIY_HTML_TOOL,
+	DIY_FIND_TOOL,
 	DIY_CLICK_TOOL,
+	DIY_HOVER_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_WAIT_TOOL,
+	DIY_EVAL_TOOL,
+	DIY_SCREENSHOT_TOOL,
+	DIY_NETWORK_TOOL,
+	DIY_DIALOG_TOOL,
 	DIY_LOGS_WATCH_TOOL,
 	DIY_LOGS_READ_TOOL,
 	DIY_LOGS_STOP_TOOL
@@ -3203,7 +3212,7 @@ function boardName(scope) {
 		en: "this project's panel"
 	};
 }
-function argsOf$1(call) {
+function argsOf$2(call) {
 	const raw = call.arguments;
 	return typeof raw === "object" && raw !== null ? raw : {};
 }
@@ -3218,13 +3227,13 @@ function askOf(reason, question, fallback) {
 var panelsApproval = (call) => {
 	if (call.name === "workbench_diy_debug_start" || call.name === "workbench_diy_debug_resume") {
 		const starting = call.name === DIY_DEBUG_START_TOOL;
-		const unit = argsOf$1(call)["unit"];
+		const unit = argsOf$2(call)["unit"];
 		const target = typeof unit === "string" && unit !== "" ? ` [${unit}]` : "";
 		return askOf(`${call.name}${target} takes over the user's screen to debug a workbench module`, pair(starting ? "要在「工作台DIY」那块板上开始调试 —— 调试中请留在那一屏，允许吗？" : "要接着调试 —— 请回到「工作台DIY」那一屏，允许吗？", starting ? "it takes over your screen to debug on the workshop board — please stay on that screen. Allow?" : "it needs your screen again to keep debugging — please go back to the workshop board. Allow?"), pair(starting ? "agent 要占用你的屏幕开始调试工作台模块，允许吗？" : "agent 要接着占用你的屏幕调试，允许吗？", starting ? "The agent wants to take over your screen to start debugging a workbench module. Allow?" : "The agent wants your screen again to keep debugging. Allow?"));
 	}
 	if (call.name === "workbench_diy_debug_pause" || call.name === "workbench_diy_debug_stop") return { kind: "allow" };
 	if (call.name !== void 0 && DIY_TOOLS.includes(call.name)) return { kind: "allow" };
-	const raw = argsOf$1(call);
+	const raw = argsOf$2(call);
 	const text = (key) => {
 		const value = raw[key];
 		return typeof value === "string" && value !== "" ? value : void 0;
@@ -3575,212 +3584,7 @@ function panelEntriesOf(panels, workspace) {
 	}
 }
 //#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 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 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;
-	}
-	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)}`
-		};
-	}
-	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);
   const root = document.querySelector('.wb-root');
@@ -3810,247 +3614,18 @@ var PAGE_PROBE = `(async () => {
 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"]);
+//#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 {
-		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,
-	visible: 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, visible: 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, visible: false });
-  const box = card.getBoundingClientRect();
-  const painted = getComputedStyle(card);
-  const visible =
-    painted.visibility !== 'hidden' && painted.display !== 'none' && box.width > 0 && box.height > 0;
-  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,
-    visible,
-    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
+		ok: result.exitCode === 0 && !result.timedOut,
+		stdout: result.stdout.trim(),
+		stderr: result.stderr.trim(),
+		exitCode: result.exitCode,
+		timedOut: result.timedOut,
+		truncated: result.truncated
 	};
 }
 function jsonOf(raw) {
@@ -4067,9 +3642,6 @@ function jsonOf(raw) {
 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",
@@ -4162,108 +3734,14 @@ async function readyPageOf(shell, command, session) {
 		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,
-		visible: parsed?.["visible"] === true
-	};
-	const width = numberIn(parsed["width"], 0);
-	const height = numberIn(parsed["height"], 0);
-	return {
-		ok: true,
-		anchored: true,
-		visible: parsed["visible"] === 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
 function debugPausedText(held) {
 	return `调试已暂停（${held.unit}）—— 动作族关闸，不再拿屏当目标。要接着看先 workbench_diy_debug_resume（会再要用户点头一次）；这之前可以改源码 / build / 跑门禁。`;
 }
+function debugMissingPactText() {
+	return "现在没有调试约定 —— 看 / 动 / 网络 / 日志这一族只在约定里发得出去。先 workbench_diy_debug_start（unit=…；会请用户点头一次，批了他会被告知「调试中请留在那一屏」），再接着看；收工用 workbench_diy_debug_stop。";
+}
 function debugForeignPactText(held) {
 	return `另一场调试正占着那块屏（${held.sessionId} 在调试 ${held.unit}）—— 一台机器同时只允许一场：让它先 workbench_diy_debug_stop，或等它收工。`;
 }
@@ -4299,6 +3777,13 @@ async function pageAt(ctx, exec, raw, options = {}) {
 	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 held = ctx.get("workbenchDiyDebug")?.live(Date.now()) ?? null;
+	const sessionId = sessionIdOf(exec);
+	if (options.requirePact !== false) {
+		if (held === null) throw new Error(debugMissingPactText());
+		if (held.sessionId !== sessionId) throw new Error(debugForeignPactText(held));
+		if (held.phase === "paused") throw new Error(debugPausedText(held));
+	}
 	const command = opencliCommandOf(ctx).command;
 	const session = asText$1(args["session"]) || "workbench";
 	const handshake = await readyPageOf(shell, command, session);
@@ -4310,13 +3795,7 @@ async function pageAt(ctx, exec, raw, options = {}) {
 	const workshop = workshopPathOf(ctx);
 	const board = boardStateOf(handshake.page, workshop);
 	const situation = boardSituation(boardProbeOf(handshake.page), workshop);
-	const held = ctx.get("workbenchDiyDebug")?.live(Date.now()) ?? null;
-	const sessionId = sessionIdOf(exec);
-	if (options.requirePact !== false && held !== null) {
-		if (held.sessionId !== sessionId) throw new Error(debugForeignPactText(held));
-		if (held.phase === "paused") throw new Error(debugPausedText(held));
-		if (board === "other" || board === "hidden") throw new Error(debugOffBoardText(held, situation));
-	}
+	if (options.requirePact !== false && held !== null && (board === "other" || board === "hidden")) throw new Error(debugOffBoardText(held, situation));
 	if (options.requireBoard !== false && (board === "other" || board === "hidden")) throw new Error(boardGateText(situation, wanted, handshake.page));
 	return {
 		packagesDir,
@@ -4348,7 +3827,11 @@ function debugRefusalText(code, held) {
 	}
 }
 function renderDebugStart(state) {
-	return [`开始调试 ${state.unit}（声明的目标：${state.board === "" ? "用户那一屏" : state.board}）。`, "现在看 / 动 / 网络那一族才把屏当目标 —— 收工前记得 workbench_diy_debug_stop。"].join("\n");
+	return [
+		`开始调试 ${state.unit}（声明的目标：${state.board === "" ? "用户那一屏" : state.board}）。`,
+		"看 / 动 / 网络 / 日志那一族现在才放行（没有这场约定，它们一律当场拒）。",
+		"不看屏时先 workbench_diy_debug_pause；收工记得 workbench_diy_debug_stop。"
+	].join("\n");
 }
 function renderDebugPause(state) {
 	return [`调试暂停了（${state.unit}）—— 动作族关闸，不再拿屏当目标。`, "改源码 / build / 跑门禁照常；要看屏再 workbench_diy_debug_resume（会再要用户点头一次）。"].join("\n");
@@ -4366,7 +3849,7 @@ function moveOrThrow(move, held) {
 function registerDebugTools(ctx, tools, store) {
 	const startTool = {
 		name: DIY_DEBUG_START_TOOL,
-		description: "开始调试：占用用户那一屏（要点头一次）。声明 unit 之后，看 / 动那一族才把屏当目标。",
+		description: "开始调试：占用用户那一屏（要点头一次）。没有它，看 / 动 / 网络那一族一律当场拒。",
 		parameters: withApprovalNote({
 			type: "object",
 			properties: { unit: {
@@ -4458,11 +3941,12 @@ function registerDebugTools(ctx, tools, store) {
 			const { packagesDir } = workshopOf(ctx, exec);
 			const held = store.live(Date.now());
 			const state = moveOrThrow(store.stop(sessionIdOf(exec) ?? "", Date.now()), held);
+			await store.settle?.();
 			return plainJson({
 				workshop: packagesDir,
 				unit: state.unit,
 				phase: "idle",
-				text: renderDebugStop(state)
+				text: `${renderDebugStop(state)}顺手把这一场的观察收一收（网络捕获 / 日志钩子 —— 没开着的不用管）。`
 			});
 		}
 	};
@@ -4476,77 +3960,6 @@ function registerDebugTools(ctx, tools, store) {
 //#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",
@@ -4570,286 +3983,19 @@ function actErrorOf(step) {
 	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 = 0, height = 0) {
-	const step = await actBrowser(shell, command, session, [
-		"screenshot",
-		file,
-		...width > 0 ? ["--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) {
+var SWEEP_TIMEOUT_MS = 4e3;
+async function stopNetworkExact(shell, file, timeoutMs = SWEEP_TIMEOUT_MS) {
 	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, board } = await pageAt(ctx, exec, raw);
-			const pick = pickOf(asRecord$3(raw));
-			let view = await measureCard(shell, command, session, unit, pick);
-			if (!view.ok || !view.visible) {
-				const state = view.ok ? "hidden" : board;
-				return plainJson({
-					workshop: packagesDir,
-					unit,
-					ok: false,
-					board: state,
-					cards: view.cards,
-					text: renderMissingCard(unit, view, state)
-				});
-			}
-			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, view, board) {
-	if (board === "other") return `你现在这一页画的是别的工作区的面板，工坊那块板没在这一屏 —— ${unit} 的卡不在屏上，我不拿别的板当目标。请用户在左栏切回「工作台DIY」，或把这张卡上到他正看着的那块板上。`;
-	if (board === "hidden") return `右栏收着 —— 面板没画在屏上（锚点还在页面里，但看不见它），量不到也不该拍 ${unit}。让用户把面板展开、或切回「工作台DIY」，我再接着看。`;
-	if (view.anchored) return `面板里给 ${unit} 留了位置（锚点在），但里面没有卡片 —— 它的 View 没画出来：要么渲染时抛了（看 workbench_diy_panel 的运行态上报与 workbench_diy_status），要么它返回了空 / 没套卡壳。你现在这一页面板里一共 ${String(view.cards)} 张卡。`;
-	const stale = board === "unknown" ? "③ 页面上跑的外壳可能还是旧的一份（锚点由外壳盖）—— 让用户刷新一次页面。" : "";
-	return `你现在这一页的面板里没有 ${unit} 这张卡（面板里现在有 ${String(view.cards)} 张卡）。按顺序试：① workbench_diy_show（unit=${unit}）把它上板；② 右栏可能没停在「工作台面板」那一列 —— 让用户切回来。${stale}`;
+		`p="$(cat ${pidFile} 2>/dev/null)"`,
+		`r="$(cat ${reaperFile} 2>/dev/null)"`,
+		`[ -n "$p" ] && kill "$p" 2>/dev/null`,
+		`[ -n "$r" ] && pkill -P "$r" 2>/dev/null`,
+		`[ -n "$r" ] && kill "$r" 2>/dev/null`,
+		`if [ "$(cat ${pidFile} 2>/dev/null)" = "$p" ]; then rm -f ${quoteShellArg(file)} ${pidFile} ${reaperFile}; fi`,
+		"true"
+	].join("; "), { timeoutMs })).exitCode === 0;
 }
 //#endregion
 //#region src/modules/panels/model/diy-logs.ts
@@ -5041,531 +4187,678 @@ function registerLogTools(ctx, tools) {
 	];
 }
 //#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 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 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;
+	}
+	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)}`
+		};
+	}
+	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-schema.ts
 var UNIT_PROP = {
 	type: "string",
 	description: "工坊里的 unit（不填 = 工坊里只有一个就用它）。"
 };
-var SESSION_PROP = {
-	type: "string",
-	description: "会话名（默认 workbench，一般不用填）。"
-};
-function pageSchema(extra = {}, required = []) {
+//#endregion
+//#region src/modules/panels/model/diy-browser-tools.ts
+var DEFAULT_TIMEOUT_MS = 3e4;
+var CARD_TAIL = " .wb-card";
+var VIEWPORT_SCRIPT = "({ dpr: window.devicePixelRatio, width: window.innerWidth, height: window.innerHeight })";
+var CARD_TOKEN = "$card";
+function cardSelectorIn(unit) {
+	return `${cardSelectorOf(unit)}${CARD_TAIL}`;
+}
+function stringsOf$2(value) {
+	if (!Array.isArray(value)) return [];
+	return value.map((one) => asText$1(one)).filter((one) => one !== "");
+}
+function withToken(argv, card) {
+	return argv.map((one) => one.split(CARD_TOKEN).join(card));
+}
+function prefixValue(argv, flag, card) {
+	const at = argv.indexOf(flag);
+	if (at !== -1) {
+		const value = argv[at + 1];
+		if (value === void 0 || value.startsWith("-")) return [
+			...argv.slice(0, at + 1),
+			card,
+			...argv.slice(at + 1)
+		];
+		return [
+			...argv.slice(0, at + 1),
+			`${card} ${value}`,
+			...argv.slice(at + 2)
+		];
+	}
+	const joined = `${flag}=`;
+	const eq = argv.findIndex((one) => one.startsWith(joined));
+	if (eq !== -1) return argv.map((one, index) => index === eq ? `${joined}${card} ${one.slice(joined.length)}` : one);
+	return [
+		...argv,
+		flag,
+		card
+	];
+}
+function prefixPositional(argv, at, card, onlyWhenFirst) {
+	if (onlyWhenFirst !== void 0 && argv[0] !== onlyWhenFirst) return [...argv];
+	const value = argv[at];
+	if (value === void 0 || value.startsWith("-")) return [...argv];
+	return [
+		...argv.slice(0, at),
+		`${card} ${value}`,
+		...argv.slice(at + 1)
+	];
+}
+function evalWrapped(script, card) {
+	return `(() => { const root = document.querySelector(${JSON.stringify(card)}); if (root === null) return null;\n${script}\n})()`;
+}
+function wrapFirst(argv, card) {
+	const first = argv[0];
+	if (first === void 0 || first.startsWith("-")) return [...argv];
+	return [evalWrapped(first, card), ...argv.slice(1)];
+}
+function argvOf(row, raw, unit) {
+	const card = cardSelectorIn(unit);
+	const declared = stringsOf$2(raw["args"]);
+	const tokens = withToken(row.evalInCard === true && asText$1(raw["in"]) === "card" ? wrapFirst(declared, card) : declared, card);
+	if (row.css === void 0 || asText$1(raw["scope"]) !== "card") return tokens;
+	if (row.css.kind === "flag") return prefixValue(tokens, row.css.flag, card);
+	return prefixPositional(tokens, row.css.at, card, row.css.onlyWhenFirst);
+}
+function finite(value) {
+	return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+}
+function clipOf(value) {
+	if (typeof value !== "object" || value === null) return void 0;
+	const raw = value;
+	const x = finite(raw["x"]);
+	const y = finite(raw["y"]);
+	const width = finite(raw["width"]);
+	const height = finite(raw["height"]);
+	if (x === void 0 || y === void 0 || width === void 0 || height === void 0) return void 0;
+	if (x < 0 || y < 0 || width <= 0 || height <= 0) return void 0;
+	return {
+		x,
+		y,
+		width,
+		height
+	};
+}
+function deviceClipRect(clip, dpr) {
+	const scale = Number.isFinite(dpr) && dpr > 0 ? dpr : 1;
 	return {
-		type: "object",
-		properties: {
-			unit: UNIT_PROP,
-			...extra,
-			session: SESSION_PROP
-		},
-		...required.length === 0 ? {} : { required },
-		additionalProperties: false
+		x: Math.max(0, Math.round(clip.x * scale)),
+		y: Math.max(0, Math.round(clip.y * scale)),
+		width: Math.max(1, Math.round(clip.width * scale)),
+		height: Math.max(1, Math.round(clip.height * scale))
 	};
 }
-//#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}`
-			});
+function clipNote(clip, viewport) {
+	if (viewport.width <= 0 || viewport.height <= 0) return "没读到视口尺寸（那条量 dpr / innerWidth 的 eval 没回来）—— 给的是整屏图，裁不了";
+	if (clip.x + clip.width <= viewport.width && clip.y + clip.height <= viewport.height && viewport.width > 0) return "";
+	return `要裁的那块 ${String(clip.x)},${String(clip.y)} ${String(clip.width)}×${String(clip.height)} 不在视口里（视口 ${String(viewport.width)}×${String(viewport.height)}）—— 给的是整屏图`;
+}
+function defaultShotPath(packagesDir, unit, stamp) {
+	return join(dirname(packagesDir), "shots", `${unit === "" ? "page" : unit}-${String(stamp)}.png`);
+}
+var BROWSER_TOOLS = [
+	{
+		tool: DIY_STATE_TOOL,
+		verb: ["state"],
+		description: "这一页有什么：URL / 标题 / 可点的元素与索引。",
+		argsHelp: "opencli browser state 的参数（如 --source ax）。"
+	},
+	{
+		tool: DIY_HTML_TOOL,
+		verb: ["get", "html"],
+		description: "取 DOM：默认整页 HTML，--as json 给 {tag,attrs,text,children} 树。",
+		argsHelp: "opencli browser get html 的参数（--selector / --as json / --depth / --children-max / --text-max）。",
+		css: {
+			kind: "flag",
+			flag: "--selector"
 		}
-	};
-	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>"。`
-			});
+	},
+	{
+		tool: DIY_FIND_TOOL,
+		verb: ["find"],
+		description: "按 CSS 或语义找元素，回 {matches_n, entries[]}（ref 只在那一次快照里有效）。",
+		argsHelp: "opencli browser find 的参数（--css / --role / --name / --testid / --limit / --text-max）。",
+		css: {
+			kind: "flag",
+			flag: "--css"
 		}
-	};
-	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。`
-			});
+	},
+	{
+		tool: DIY_CLICK_TOOL,
+		verb: ["click"],
+		description: "点一个元素。",
+		argsHelp: "opencli browser click 的参数（选择器 / --role / --name / --nth）。",
+		css: {
+			kind: "positional",
+			at: 0
 		}
-	};
-	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…）。"
+	{
+		tool: DIY_HOVER_TOOL,
+		verb: ["hover"],
+		description: "把鼠标移到元素上。",
+		argsHelp: "opencli browser hover 的参数（选择器 / --role / --name）。",
+		css: {
+			kind: "positional",
+			at: 0
+		}
 	},
-	name: {
-		type: "string",
-		description: "语义定位：无障碍名（aria-label / 可见文字）包含这段。"
+	{
+		tool: DIY_TYPE_TOOL,
+		verb: ["type"],
+		description: "点一下再敲字。",
+		argsHelp: "opencli browser type 的参数（选择器在前，然后是字）。",
+		css: {
+			kind: "positional",
+			at: 0
+		}
 	},
-	testid: {
-		type: "string",
-		description: "语义定位：data-testid 包含这段。"
+	{
+		tool: DIY_FILL_TOOL,
+		verb: ["fill"],
+		description: "直接把值设进去。",
+		argsHelp: "opencli browser fill 的参数（选择器在前，然后是值）。",
+		css: {
+			kind: "positional",
+			at: 0
+		}
 	},
-	nth: {
-		type: "number",
-		description: "匹配到多个时取第几个（0 起）。"
+	{
+		tool: DIY_KEYS_TOOL,
+		verb: ["keys"],
+		description: "给焦点发按键。",
+		argsHelp: "opencli browser keys 的参数（如 Enter / Meta+K）。"
 	},
-	scope: {
-		type: "string",
-		description: "card（默认，只在这张卡里找）| page（整页找）。"
+	{
+		tool: DIY_SCROLL_TOOL,
+		verb: ["scroll"],
+		description: "滚一屏。",
+		argsHelp: "opencli browser scroll 的参数（up|down / --amount）。"
+	},
+	{
+		tool: DIY_WAIT_TOOL,
+		verb: ["wait"],
+		description: "等一件事：选择器 / 文字 / 时间 / XHR / 下载。",
+		argsHelp: "opencli browser wait 的参数（selector|text|time|xhr|download + --timeout）。",
+		css: {
+			kind: "positional",
+			at: 1,
+			onlyWhenFirst: "selector"
+		}
+	},
+	{
+		tool: DIY_EVAL_TOOL,
+		verb: ["eval"],
+		description: "在页面里跑一段 JS（return 什么就回什么）。",
+		argsHelp: "opencli browser eval 的参数：一段 JS（in=card 时可用注入的 root）。",
+		evalInCard: true
+	},
+	{
+		tool: DIY_SCREENSHOT_TOOL,
+		verb: ["screenshot"],
+		description: "拍一张图（写文件；clip 给 CSS px 就只裁那一块）。",
+		argsHelp: "opencli browser screenshot 的参数：文件路径在前，然后 --full-page / --width / --height / --annotate。",
+		clip: true
+	},
+	{
+		tool: DIY_NETWORK_TOOL,
+		verb: ["network"],
+		description: "看网络：捕获到的请求形状（URL / 方法 / key）；body 取不到，要 body 用 _eval 里 fetch 打一条。",
+		argsHelp: "opencli browser network 的参数（--since / --until / --detail / --filter / --all / --raw / --follow）。"
+	},
+	{
+		tool: DIY_DIALOG_TOOL,
+		verb: ["dialog"],
+		description: "处理 JS 弹窗。",
+		argsHelp: "opencli browser dialog 的参数（accept | dismiss）。"
 	}
-};
-function targetSchema(extra = {}, required = []) {
-	return {
-		type: "object",
-		properties: {
-			unit: UNIT_PROP,
-			...TARGET_PROPS,
-			...extra,
-			session: SESSION_PROP
+];
+function parametersOf(row) {
+	const properties = {
+		unit: UNIT_PROP,
+		args: {
+			type: "array",
+			items: { type: "string" },
+			description: row.argsHelp
 		},
-		...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 明说要整页那一个。`);
+		timeoutMs: {
+			type: "number",
+			description: "超时毫秒（默认 30000；≤0 或非数也按默认算）。"
 		}
-		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}`
-			});
-		}
+	if (row.css !== void 0) properties["scope"] = {
+		type: "string",
+		enum: ["page", "card"],
+		description: "card = 把 CSS 目标收进这张卡；默认 page（原样转发）。"
 	};
-	const hoverTool = {
-		name: DIY_HOVER_TOOL,
-		description: "把鼠标移到这张卡里的某个东西上（悬停才出来的东西靠它）。",
-		parameters: targetSchema(),
-		output: OUTPUT$2,
-		execute: (raw, exec) => runTargeted(exec, raw, "悬停", (selector) => selector === "" ? ["hover"] : ["hover", selector])
+	if (row.evalInCard === true) properties["in"] = {
+		type: "string",
+		enum: ["page", "card"],
+		description: "card = 脚本在卡根里跑（注入 root；脚本自己 return）。"
 	};
-	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 时用它）。"
+	if (row.clip === true) properties["clip"] = {
+		type: "object",
+		properties: {
+			x: {
+				type: "number",
+				description: "左边（CSS px）。"
 			},
-			amount: {
+			y: {
 				type: "number",
-				description: "滚多少像素（默认 500）。"
+				description: "上边（CSS px）。"
 			},
-			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）；不填按当前窗口。"
+				description: "宽（CSS px）。"
 			},
 			height: {
 				type: "number",
-				description: "视口高度（可不要）。"
+				description: "高（CSS px）。"
 			}
-		}, []),
-		output: OUTPUT$2,
-		async execute(raw, exec) {
-			const page = await pageAt(ctx, exec, raw, { requireUnit: false });
-			const width = asNumber(page.args["width"]) ?? 0;
-			if (width < 0) throw new Error("width 得是正的 CSS px；不给就按用户当前窗口拍。");
-			const height = asNumber(page.args["height"]) ?? 0;
-			const overrode = width > 0 || height > 0;
-			const stamp = overrode ? `${String(width)}x${String(height)}` : "now";
-			const file = join(dirname(page.packagesDir), "shots", `${page.unit || "page"}-${stamp}-${String(Date.now())}.png`);
+		},
+		required: [
+			"x",
+			"y",
+			"width",
+			"height"
+		],
+		additionalProperties: false,
+		description: "只要这一块：拍完本地裁；不在视口里就退回整屏图。"
+	};
+	return {
+		type: "object",
+		properties,
+		additionalProperties: false
+	};
+}
+async function viewportOf(page) {
+	const parsed = jsonOf((await runBrowserStep(page.shell, page.command, [
+		"browser",
+		page.session,
+		"eval",
+		VIEWPORT_SCRIPT,
+		"--window",
+		"background"
+	], LOOK_TIMEOUT_MS)).stdout);
+	return {
+		dpr: asNumber(parsed?.["dpr"]) ?? 1,
+		width: asNumber(parsed?.["width"]) ?? 0,
+		height: asNumber(parsed?.["height"]) ?? 0
+	};
+}
+function needsCardOf(row, raw) {
+	if (row.evalInCard === true && asText$1(raw["in"]) === "card") return true;
+	if (row.css !== void 0 && asText$1(raw["scope"]) === "card") return true;
+	return stringsOf$2(raw["args"]).some((one) => one.includes(CARD_TOKEN));
+}
+async function runBrowserTool(row, ctx, raw, exec) {
+	const page = await pageAt(ctx, exec, raw, { requireUnit: false });
+	if (needsCardOf(row, page.args) && page.unit === "") throw new Error("要卡作用域（scope=card / $card / in=card）就得给一个 unit —— 工坊里不止一个模块时，我不知道你说哪一张卡。");
+	const requested = asNumber(page.args["timeoutMs"]);
+	const timeoutMs = requested !== void 0 && requested > 0 ? requested : DEFAULT_TIMEOUT_MS;
+	const argv = argvOf(row, page.args, page.unit);
+	const clip = row.clip === true ? clipOf(page.args["clip"]) : void 0;
+	const clipAsked = row.clip === true && page.args["clip"] !== void 0;
+	let file = "";
+	let finalArgv = argv;
+	if (row.clip === true) {
+		const given = argv[0] !== void 0 && !argv[0].startsWith("-") ? argv[0] : "";
+		if (given === "") {
+			file = defaultShotPath(page.packagesDir, page.unit, Date.now());
+			finalArgv = [file, ...argv];
 			await writeShotsDir(page.shell, dirname(file));
-			const shot = await shootAtWidth(page.shell, page.command, page.session, file, width, height);
+		} else file = given;
+	}
+	const step = await runBrowserStep(page.shell, page.command, [
+		"browser",
+		page.session,
+		...row.verb,
+		...finalArgv,
+		"--window",
+		"background"
+	], timeoutMs);
+	const shot = {};
+	if (row.clip === true) {
+		shot["file"] = step.ok ? file : "";
+		if (clipAsked && clip === void 0) {
+			shot["cropped"] = false;
+			shot["cropReason"] = "clip 不是完整矩形（要 x/y ≥ 0，width/height > 0）—— 给的是整屏图";
+		} else if (clip !== void 0 && step.ok) {
+			const viewport = await viewportOf(page);
+			const note = clipNote(clip, viewport);
+			if (note === "") {
+				const crop = cropPngFile(file, file, deviceClipRect(clip, viewport.dpr));
+				shot["cropped"] = crop.ok;
+				shot["cropReason"] = crop.reason;
+			} else {
+				shot["cropped"] = false;
+				shot["cropReason"] = note;
+			}
+		}
+	}
+	return {
+		workshop: page.packagesDir,
+		unit: page.unit,
+		verb: row.verb.join(" "),
+		argv: finalArgv,
+		ok: step.ok,
+		exitCode: step.exitCode,
+		timedOut: step.timedOut,
+		truncated: step.truncated,
+		stdout: step.stdout,
+		stderr: step.stderr,
+		...shot
+	};
+}
+function registerBrowserTools(ctx, tools) {
+	return BROWSER_TOOLS.map((row) => {
+		const definition = {
+			name: row.tool,
+			description: row.description,
+			parameters: parametersOf(row),
+			output: OUTPUT$2,
+			execute: async (raw, exec) => plainJson(await runBrowserTool(row, ctx, raw, exec))
+		};
+		return tools.register(definition);
+	});
+}
+//#endregion
+//#region src/modules/panels/model/diy-spec.ts
+var SPEC_TIMEOUT_MS = 2e4;
+function specArgvOf(command) {
+	const parts = command.trim().replace(/\//g, " ").split(/\s+/).filter((one) => one !== "");
+	if (parts.length !== 2) return [];
+	return [
+		parts[0] ?? "",
+		parts[1] ?? "",
+		"--help",
+		"-f",
+		"json"
+	];
+}
+function specTool(ctx) {
+	return {
+		name: DIY_SPEC_TOOL,
+		description: "问一条 opencli 命令的形状（入参 / 出参列 / access / 预览档）：`--help -f json` 原样回，插件与内置都能问。",
+		parameters: {
+			type: "object",
+			properties: {
+				command: {
+					type: "string",
+					description: "site 与名字两个词，例 `cmdb publish`（`cmdb/publish` 也认）。"
+				},
+				timeoutMs: {
+					type: "number",
+					description: "超时毫秒（默认 20000）。"
+				}
+			},
+			required: ["command"],
+			additionalProperties: false
+		},
+		output: OUTPUT$2,
+		async execute(raw, _exec) {
+			const args = asRecord$3(raw);
+			const argv = specArgvOf(asText$1(args["command"]));
+			if (argv.length === 0) throw new Error("给一条命令，site 与名字两个词 —— 例 `cmdb publish`（`cmdb/publish` 也认）。");
+			const shell = ctx.get("shell");
+			if (shell === void 0) throw new Error("这台机器上没有 shell 服务，问不了 opencli");
+			const asked = asNumber(args["timeoutMs"]);
+			const timeoutMs = asked !== void 0 && asked > 0 ? asked : SPEC_TIMEOUT_MS;
+			const result = await runShell(shell, backgroundLine(opencliCommandOf(ctx).command, argv), { timeoutMs });
+			const spec = jsonOf(result.stdout);
 			return plainJson({
-				workshop: page.packagesDir,
-				unit: page.unit,
-				ok: shot.ok,
-				file: shot.file,
-				overrode,
-				width: overrode ? width : null,
-				viewport: overrode ? {
-					width,
-					height
-				} : null,
-				text: shot.ok ? overrode ? `重拍了一张：${shot.file}（临时换了视口${width > 0 ? ` 宽 ${String(width)}px` : ""}${height > 0 ? ` 高 ${String(height)}px` : ""}，你那一屏会回流一次、拍完就恢复）。` : `按你当前窗口拍了一张：${shot.file}（没动你的视口）。` : `没拍成：${shot.reason}`
+				ok: result.exitCode === 0 && !result.timedOut,
+				exitCode: result.exitCode,
+				timedOut: result.timedOut,
+				truncated: result.truncated,
+				stdout: result.stdout.trim(),
+				stderr: result.stderr.trim(),
+				...spec === void 0 ? {} : { spec }
 			});
 		}
 	};
-	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)
-	];
+}
+function registerSpecTool(ctx, tools) {
+	return [tools.register(specTool(ctx))];
 }
 //#endregion
 //#region src/shared/api/host/diy-recon.ts
 var SITE_LIMIT = 6;
 var COMMAND_LIMIT = 12;
 var SHOWN_LIMIT = 6;
+var ARG_LIMIT = 6;
 var PLUGIN_PREFIX = "opencli-plugin-";
+var PREVIEW_ARGS = [
+	"yes",
+	"dryrun",
+	"confirm"
+];
 function text(value) {
 	return typeof value === "string" ? value.trim() : "";
 }
 function stringsOf$1(value) {
 	return Array.isArray(value) ? value.filter((one) => typeof one === "string") : [];
 }
+function argsOf$1(value) {
+	if (!Array.isArray(value)) return [];
+	const out = [];
+	for (const one of value) {
+		if (typeof one !== "object" || one === null) continue;
+		const row = one;
+		const name = text(row["name"]);
+		if (name === "") continue;
+		const fallback = row["default"];
+		out.push({
+			name,
+			type: text(row["type"]),
+			required: row["required"] === true,
+			value: typeof fallback === "number" || typeof fallback === "boolean" ? String(fallback) : text(fallback),
+			help: text(row["help"])
+		});
+	}
+	return out;
+}
+function invocableOf(command) {
+	if (command.site === "") return command.command;
+	return command.name === "" ? `opencli ${command.site}` : `opencli ${command.site} ${command.name}`;
+}
 function manifestCommandsOf(raw) {
 	let parsed;
 	try {
@@ -5584,6 +4877,7 @@ function manifestCommandsOf(raw) {
 		const command = declared === "" ? site === "" || name === "" ? "" : `${site}/${name}` : declared;
 		if (command === "" || site === "") continue;
 		const access = text(row["access"]);
+		const args = argsOf$1(row["args"]);
 		commands.push({
 			command,
 			site,
@@ -5594,7 +4888,9 @@ function manifestCommandsOf(raw) {
 			strategy: text(row["strategy"]).toLowerCase(),
 			browser: row["browser"] === true,
 			example: text(row["example"]),
-			columns: stringsOf$1(row["columns"])
+			columns: stringsOf$1(row["columns"]),
+			args,
+			preview: args.some((one) => PREVIEW_ARGS.includes(one.name.toLowerCase()))
 		});
 	}
 	return commands;
@@ -5692,13 +4988,29 @@ function reconOf(commands, plugins, keywords) {
 function nextOf(answer) {
 	const site = answer.sites[0];
 	if (site !== void 0) {
-		const pick = site.commands.find((one) => one.access !== "write") ?? site.commands[0];
-		return `直接复用：${pick === void 0 ? `opencli ${site.site}` : pick.example === "" ? `opencli ${pick.command}` : pick.example}（这台机器上就能跑，不用装、不用点头）`;
+		const read = site.commands.find((one) => one.access !== "write");
+		const pick = read ?? site.commands[0];
+		if (pick === void 0) return `opencli ${site.site} --help 看全部命令`;
+		if (read === void 0) return `这台机器上只匹配到写命令：${invocableOf(pick)} —— 先 \`--help\` 看入参；带 \`--dryRun\` / \`--yes\` 的先用预览档；没有预览档的不许试写（那一次就是真的）。写取证的完整口径见 WRITES.md。`;
+		return `直接复用：${pick.example === "" ? invocableOf(pick) : pick.example}（这台机器上就能跑，不用装、不用点头）`;
 	}
 	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_probe（script 读接口 / css 读 DOM）";
 }
+function signatureOf$1(args) {
+	const shown = args.slice(0, ARG_LIMIT).map((one) => {
+		if (one.required) return `--${one.name}`;
+		return one.value === "" ? `--${one.name}` : `--${one.name}=${one.value}`;
+	});
+	const rest = args.length - shown.length;
+	const tail = rest > 0 ? ` …+${String(rest)}` : "";
+	return `${shown.join(" ")}${tail}`;
+}
+function labelOf(command) {
+	if (command.access !== "write") return "读";
+	return command.preview ? "写（可预览）" : "写（无预览档，一次就是真的）";
+}
 function textOf$3(answer) {
 	const lines = [];
 	if (answer.sites.length > 0) {
@@ -5709,10 +5021,15 @@ function textOf$3(answer) {
 			lines.push(`· ${site.site}${where} · ${site.strategy === "" ? "—" : site.strategy} · ${chrome}`);
 			for (const command of site.commands.slice(0, SHOWN_LIMIT)) {
 				const what = command.description === "" ? "" : ` —— ${command.description.slice(0, 60)}`;
-				lines.push(`    ${command.access === "write" ? "写" : "读"} opencli ${command.command}${what}`);
+				const args = command.access === "write" && command.args.length > 0 ? ` ｜ 入参：${signatureOf$1(command.args)}` : "";
+				lines.push(`    ${labelOf(command)} ${invocableOf(command)}${what}${args}`);
 			}
 			const rest = site.commands.length - SHOWN_LIMIT;
-			if (rest > 0) lines.push(`    … 还有 ${String(rest)} 条：opencli ${site.site} --help`);
+			if (rest > 0) {
+				const writes = site.commands.slice(SHOWN_LIMIT).filter((one) => one.access === "write").length;
+				const tail = writes === 0 ? "" : `（其中写 ${String(writes)} 条）`;
+				lines.push(`    … 还有 ${String(rest)} 条${tail}：opencli ${site.site} --help`);
+			}
 		}
 	}
 	if (answer.plugins.length > 0) lines.push(`这台机器另装的插件里匹配到：${answer.plugins.map((one) => `${one.name}（${String(one.commands.length)} 条命令）`).join("、")}`);
@@ -6146,7 +5463,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 ? "装：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 刷新页面），不要再装一遍";
+	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,
@@ -6385,7 +5702,7 @@ function registerDiyTools(ctx, market, panels, debug) {
 				},
 				session: {
 					type: "string",
-					description: "会话名（默认 workbench，一般不用填）。"
+					description: "会话名（默认读那条，一般不用填）。"
 				},
 				open: {
 					type: "boolean",
@@ -6406,6 +5723,7 @@ function registerDiyTools(ctx, market, panels, debug) {
 			const url = asText$1(args["url"]);
 			const loginUrl = asText$1(args["loginUrl"]);
 			const session = asText$1(args["session"]);
+			if (session === "workbench") throw new Error(`"${BROWSER_SCREEN_SESSION}" 是用户那一屏那条会话 —— probe 只读自己的线（不填就落在读那条上，想给自己一条专线就传自己的 unit）。要看 / 动他那一屏走 workbench_diy_state / _find / _click 那一族，而且要先 workbench_diy_debug_start（会请他点头一次）。`);
 			const open = typeof args["open"] === "boolean" ? args["open"] : void 0;
 			if (css !== "") {
 				const limit = asNumber(args["limit"]);
@@ -6467,9 +5785,9 @@ function registerDiyTools(ctx, market, panels, debug) {
 		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（第一次会让用户点头一次）`);
+			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 会给出同样的判断）`;
+			const text = panel.ok ? `面板上已经打开它了（${workspace}）—— 验收就走这一张卡（你自己走一遍）` : `面板上还没打开：${panel.reason}。这就是它的下一步（workbench_diy_status 会给出同样的判断）`;
 			return plainJson({
 				workshop: packagesDir,
 				unit: found.unit,
@@ -6497,7 +5815,7 @@ function registerDiyTools(ctx, market, panels, debug) {
 			const found = unitOf(packagesDir, raw, "workbench_diy_install");
 			if (found.installed) {
 				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");
+				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: found.unit,
@@ -6514,7 +5832,7 @@ function registerDiyTools(ctx, market, panels, debug) {
 				ok: false,
 				reason: `安装结果是 ${outcome.change.application}，还没生效`
 			};
-			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 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}：${found.unit}（${found.name}）`,
 				panelText,
@@ -6536,17 +5854,67 @@ function registerDiyTools(ctx, market, panels, debug) {
 		tools.register(statusTool),
 		tools.register(panelTool),
 		tools.register(reconTool),
+		...registerSpecTool(ctx, tools),
 		tools.register(probeTool),
-		...registerLookTools(ctx, tools),
 		...registerLogTools(ctx, tools),
-		...registerNetTools(ctx, tools),
-		...registerActTools(ctx, tools),
+		...registerBrowserTools(ctx, tools),
 		...registerDebugTools(ctx, tools, debug),
 		tools.register(showTool),
 		tools.register(installTool)
 	];
 }
 //#endregion
+//#region src/modules/panels/model/diy-observers.ts
+async function stopObservers(ctx, session = BROWSER_SCREEN_SESSION) {
+	const packagesDir = workshopPackagesDir(ctx);
+	const shell = ctx.get("shell");
+	if (packagesDir === null || shell === void 0) return {
+		net: false,
+		logs: false
+	};
+	const file = join(dirname(packagesDir), "shots", `net-${session}.jsonl`);
+	const command = opencliCommandOf(ctx).command;
+	const [net, step] = await Promise.all([stopNetworkExact(shell, file), actBrowser(shell, command, session, ["eval", LOGS_STOP_SCRIPT], SWEEP_TIMEOUT_MS)]);
+	return {
+		net,
+		logs: typeof step.payload?.["unhooked"] === "number"
+	};
+}
+function withObserverCleanup(store, cleanup, logger) {
+	let pending = Promise.resolve();
+	let epoch = 0;
+	const sweep = async (at) => {
+		if (epoch !== at) {
+			logger?.warn?.("收工那一拍：已经有新的调试约定开始了 —— 跳过收观察（新那一场自己收）");
+			return;
+		}
+		try {
+			const out = await cleanup();
+			if (!out.net || !out.logs) logger?.warn?.(`收工那一拍没把观察收干净（网络 ${String(out.net)} / 日志 ${String(out.logs)}）—— 网络那条最多 15 分钟自己收工，日志钩子随页面刷新消失`);
+		} catch (error) {
+			logger?.warn?.(`收工那一拍收观察抛了：${error instanceof Error ? error.message : String(error)}`);
+		}
+	};
+	return {
+		live: (now) => store.live(now),
+		begin(pact) {
+			epoch += 1;
+			return store.begin(pact);
+		},
+		pause: (sessionId, now) => store.pause(sessionId, now),
+		resume: (sessionId, now) => store.resume(sessionId, now),
+		stop(sessionId, now) {
+			const move = store.stop(sessionId, now);
+			if (move.ok) {
+				const at = epoch;
+				pending = pending.then(() => sweep(at));
+			}
+			return move;
+		},
+		settle: () => pending
+	};
+}
+//#endregion
 //#region src/modules/panels/model/diy-debug-routes.ts
 function diyDebugRoutes(store) {
 	return { "panels/diy-debug": () => ({
@@ -8936,7 +8304,7 @@ var OWNED = [{
 			logger
 		});
 		ctx.provide(PANELS_SERVICE, panels);
-		const debug = createDebugStore();
+		const debug = withObserverCleanup(createDebugStore(), () => stopObservers(ctx), logger);
 		ctx.provide(DIY_DEBUG_SERVICE, debug);
 		const profileDir = profileDirOf(ctx);
 		const shell = ctx.get("shell");
@@ -9415,6 +8783,13 @@ var REFUSAL = {
 };
 function debugActResource(deps) {
 	const now = () => deps.now?.() ?? Date.now();
+	const settled = (intent, delivered, summary, state) => ({
+		ok: true,
+		intent,
+		delivered,
+		summary,
+		state
+	});
 	return {
 		resource: "act",
 		handle(payload) {
@@ -9440,13 +8815,9 @@ function debugActResource(deps) {
 				text: REFUSAL[move.code] ?? `按不动：${move.code}`
 			};
 			const notice = deps.notice?.(intent, move.state) ?? debugNotice(intent, move.state);
-			return {
-				ok: true,
-				intent,
-				delivered: deliverDebugNotice(deps.agents(), held.sessionId, notice.message, NOTICE_MODE[intent]),
-				summary: notice.summary,
-				state: store.live(now())
-			};
+			const delivered = deliverDebugNotice(deps.agents(), held.sessionId, notice.message, NOTICE_MODE[intent]);
+			if (intent !== "stop") return settled(intent, delivered, notice.summary, store.live(now()));
+			return (store.settle?.() ?? Promise.resolve()).then(() => settled(intent, delivered, notice.summary, store.live(now())));
 		}
 	};
 }