@dsh-workbench/core 0.3.3 → 0.3.4

package/dist/host/index.js

@@ -1,9 +1,9 @@
 import { createHash, randomUUID } from "node:crypto";
 import fs, { chmodSync, closeSync, existsSync, mkdirSync, openSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, statSync, unlinkSync, writeFileSync } from "node:fs";
 import path, { basename, delimiter, dirname, join, resolve, sep } from "node:path";
+import { fileURLToPath } from "node:url";
 import { deflateSync, inflateSync } from "node:zlib";
 import { spawn } from "node:child_process";
-import { fileURLToPath } from "node:url";
 import os from "node:os";
 //#region ../shared/dist/config/constants.js
 var PLUGIN_ID = "@dsh-workbench/core";
@@ -16,12 +16,15 @@ var PROVISION_PREFIX = `${API_PREFIX}/provision`;
 var PANEL_STATE_PATH = "panel-state";
 var DIY_DEBUG_PATH = "diy-debug";
 `${DIY_DEBUG_PATH}`;
+var DIY_RECORD_PATH = "diy-record";
+`${DIY_RECORD_PATH}`;
 var PANEL_STATE_PREFIX = `${API_PREFIX}/${PANEL_STATE_PATH}`;
 var OPENCLI_PIN = "1.8.8";
 var PANELS_SERVICE = "workbenchPanels";
 var UNITS_SERVICE = "workbenchUnits";
 var PANEL_STATE_SERVICE = "workbenchPanelState";
 var DIY_DEBUG_SERVICE = "workbenchDiyDebug";
+var DIY_RECORD_SERVICE = "workbenchDiyRecord";
 var OPENCLI_TIMEOUT_MS = 12e4;
 var WARM_TIMEOUT_MS = 2e4;
 var INSTALL_TIMEOUT_MS = 3e5;
@@ -465,22 +468,22 @@ function boardSituation(probe, workshop) {
 function parseDebugIntent(value) {
 	return value === "pause" || value === "resume" || value === "stop" ? value : null;
 }
-function alive(state, now) {
+function alive$1(state, now) {
 	if (state === null) return null;
 	return now - state.at <= 144e5 ? state : null;
 }
-function ownerOf(state, sessionId, now) {
-	const held = alive(state, now);
+function ownerOf$1(state, sessionId, now) {
+	const held = alive$1(state, now);
 	if (held === null) return "none";
 	return held.sessionId === sessionId ? held : "not-owner";
 }
 function createDebugStore() {
 	let held = null;
-	const live = (now) => alive(held, now);
+	const live = (now) => alive$1(held, now);
 	return {
 		live,
 		begin(pact) {
-			const current = alive(held, pact.now);
+			const current = alive$1(held, pact.now);
 			if (current !== null) return {
 				ok: false,
 				code: current.sessionId === pact.sessionId ? "already-held" : "held-by-other"
@@ -502,7 +505,7 @@ function createDebugStore() {
 			};
 		},
 		pause(sessionId, now) {
-			const found = ownerOf(held, sessionId, now);
+			const found = ownerOf$1(held, sessionId, now);
 			if (typeof found === "string") return {
 				ok: false,
 				code: found
@@ -523,7 +526,7 @@ function createDebugStore() {
 			};
 		},
 		resume(sessionId, now) {
-			const found = ownerOf(held, sessionId, now);
+			const found = ownerOf$1(held, sessionId, now);
 			if (typeof found === "string") return {
 				ok: false,
 				code: found
@@ -543,6 +546,113 @@ function createDebugStore() {
 				state
 			};
 		},
+		stop(sessionId, now) {
+			const found = ownerOf$1(held, sessionId, now);
+			if (typeof found === "string") return {
+				ok: false,
+				code: found
+			};
+			held = null;
+			return {
+				ok: true,
+				state: found
+			};
+		}
+	};
+}
+function parseRecordIntent(raw) {
+	return raw === "peek" || raw === "halt" || raw === "stop" ? raw : null;
+}
+function alive(state, now) {
+	if (state === null) return null;
+	return now - state.at <= 9e5 ? state : null;
+}
+function ownerOf(state, sessionId, now) {
+	const held = alive(state, now);
+	if (held === null) return "none";
+	return held.sessionId === sessionId ? held : "not-owner";
+}
+function createRecordStore() {
+	let held = null;
+	const live = (now) => alive(held, now);
+	return {
+		live,
+		begin(pact) {
+			const current = alive(held, pact.now);
+			if (current !== null) return {
+				ok: false,
+				code: current.sessionId === pact.sessionId ? "already-held" : "held-by-other"
+			};
+			const state = {
+				phase: "armed",
+				sessionId: pact.sessionId,
+				workspace: pact.workspace,
+				unit: pact.unit,
+				name: pact.name,
+				url: pact.url,
+				title: pact.title,
+				action: pact.action,
+				expect: pact.expect,
+				captureFile: pact.captureFile,
+				startedAt: pact.now,
+				t0: null,
+				t1: null,
+				at: pact.now
+			};
+			held = state;
+			return {
+				ok: true,
+				state
+			};
+		},
+		started(sessionId, at, now) {
+			const found = ownerOf(held, sessionId, now);
+			if (typeof found === "string") return {
+				ok: false,
+				code: found
+			};
+			if (found.phase === "recording") return {
+				ok: false,
+				code: "already-recording"
+			};
+			if (found.phase !== "armed") return {
+				ok: false,
+				code: "not-armed"
+			};
+			const state = {
+				...found,
+				phase: "recording",
+				t0: at,
+				at: now
+			};
+			held = state;
+			return {
+				ok: true,
+				state
+			};
+		},
+		finished(sessionId, at, now) {
+			const found = ownerOf(held, sessionId, now);
+			if (typeof found === "string") return {
+				ok: false,
+				code: found
+			};
+			if (found.phase !== "recording") return {
+				ok: false,
+				code: "not-recording"
+			};
+			const state = {
+				...found,
+				phase: "finished",
+				t1: at,
+				at: now
+			};
+			held = state;
+			return {
+				ok: true,
+				state
+			};
+		},
 		stop(sessionId, now) {
 			const found = ownerOf(held, sessionId, now);
 			if (typeof found === "string") return {
@@ -596,6 +706,7 @@ async function runShell(shell, command, options = {}) {
 //#endregion
 //#region ../shared/dist/host/browser-read.js
 var BROWSER_SCREEN_SESSION = "workbench";
+var BROWSER_RECORD_SESSION = "workbench-rec";
 var DEFAULT_TIMEOUT_MS$2 = 25e3;
 var DEFAULT_RETRY_MS = 1200;
 var DEFAULT_SETTLE_MS$1 = 900;
@@ -1235,7 +1346,7 @@ var TARGET_CODE = {
 function asRecord$7(value) {
 	return typeof value === "object" && value !== null ? value : {};
 }
-function stringsOf$4(value) {
+function stringsOf$5(value) {
 	if (!Array.isArray(value)) return void 0;
 	const items = value.filter((item) => typeof item === "string" && item.trim() !== "");
 	return items.length === 0 ? void 0 : items;
@@ -1291,7 +1402,7 @@ function parseProvisionBody(body) {
 		request: requestOf$1(wanted, value.trim())
 	};
 	const registry = typeof raw.registry === "string" && raw.registry.trim() !== "" ? raw.registry.trim() : void 0;
-	const approvedBuilds = stringsOf$4(raw.approvedBuilds);
+	const approvedBuilds = stringsOf$5(raw.approvedBuilds);
 	const requestId = typeof raw.requestId === "string" && raw.requestId.trim() !== "" ? raw.requestId.trim() : void 0;
 	return {
 		ok: true,
@@ -1796,6 +1907,15 @@ function registerDiyDebugAct(ctx, resource, log) {
 		wrote: () => log?.bump(["diy-debug"])
 	});
 }
+function registerDiyRecordAct(ctx, resource, log) {
+	return registerPost(ctx, {
+		prefix: `${API_PREFIX}/${DIY_RECORD_PATH}`,
+		what: "工作台 DIY 录制交接动作",
+		refusedCode: "action-refused",
+		resources: [resource],
+		wrote: () => log?.bump(["diy-record"])
+	});
+}
 //#endregion
 //#region ../shared/dist/host/long-task.js
 var LIVE = /* @__PURE__ */ new Set(["running", "needs-login"]);
@@ -2013,7 +2133,7 @@ function textOf$5(value) {
 	const trimmed = value.trim();
 	return trimmed === "" ? void 0 : trimmed;
 }
-function entryOf(value) {
+function entryOf$1(value) {
 	if (typeof value !== "object" || value === null) return void 0;
 	const box = value;
 	const opencliHome = textOf$5(box["opencliHome"]);
@@ -2039,7 +2159,7 @@ function parsePluginLedger(raw) {
 	if (!Array.isArray(list)) return [];
 	const entries = [];
 	for (const item of list) {
-		const entry = entryOf(item);
+		const entry = entryOf$1(item);
 		if (entry === void 0) continue;
 		if (entries.some((known) => ledgerKeyOf(known) === ledgerKeyOf(entry))) continue;
 		entries.push(entry);
@@ -2210,11 +2330,14 @@ function withApprovalNote(parameters, options = {}) {
 		...required.length === 0 ? {} : { required }
 	};
 }
+function oneLine(text) {
+	return text.replace(/\s+/g, " ").trim();
+}
 function approvalNoteOf(call) {
 	const raw = call.arguments;
 	const value = typeof raw === "object" && raw !== null ? raw[APPROVAL_NOTE_ARG] : void 0;
 	if (typeof value !== "string") return void 0;
-	const line = value.replace(/\s+/g, " ").trim();
+	const line = oneLine(value);
 	if (line === "") return void 0;
 	return line.length > 40 ? `${line.slice(0, 40)}…` : line;
 }
@@ -2226,11 +2349,14 @@ function compose(detail, verdict, note) {
 		en: `${detail.en} — ${verdict.question.en}`,
 		zh: `${detail.zh} —— ${verdict.question.zh}`
 	};
-	if (note === void 0) return base;
-	return {
+	const line = note === void 0 ? base : {
 		en: `${base.en} — ${note}`,
 		zh: `${base.zh} —— ${note}`
 	};
+	return {
+		en: oneLine(line.en),
+		zh: oneLine(line.zh)
+	};
 }
 async function approvalFor(call, context = {}) {
 	if (context.writes !== true) return void 0;
@@ -2264,7 +2390,7 @@ async function approvalFor(call, context = {}) {
 	return {
 		kind: "ask",
 		reason: verdict.reason,
-		displayReason: compose(facts, verdict, approvalNoteOf(call))
+		displayReason: compose(facts, verdict, context.declaredNote === true ? approvalNoteOf(call) : void 0)
 	};
 }
 //#endregion
@@ -2489,7 +2615,7 @@ var CANCELLATIONS = [
 function asRecord$6(value) {
 	return typeof value === "object" && value !== null ? value : void 0;
 }
-function asText$4(value) {
+function asText$5(value) {
 	return typeof value === "string" ? value : "";
 }
 function pick(allowed, value) {
@@ -2519,9 +2645,9 @@ function asPackageResult(raw) {
 	const kind = pick(FAILURE_KINDS, record.kind);
 	return {
 		exitCode: typeof record.exitCode === "number" ? record.exitCode : -1,
-		output: asText$4(record.output),
+		output: asText$5(record.output),
 		truncated: record.truncated === true,
-		logPath: asText$4(record.logPath),
+		logPath: asText$5(record.logPath),
 		...kind === void 0 ? {} : { kind }
 	};
 }
@@ -2536,14 +2662,14 @@ function asChange(raw) {
 	const pendingBuilds = asTextArray(record.pendingBuilds);
 	const restartReason = pick(RESTART_REASONS, record.restartReason);
 	const failedAt = pick(["registry", "spec-host"], record.failedAt);
-	const bundle = asText$4(record.bundle);
-	const errorCode = error === void 0 ? "" : asText$4(error.code);
-	const errorDetail = error === void 0 ? "" : asText$4(error.diagnostic);
+	const bundle = asText$5(record.bundle);
+	const errorCode = error === void 0 ? "" : asText$5(error.code);
+	const errorDetail = error === void 0 ? "" : asText$5(error.diagnostic);
 	return {
 		application,
 		stage,
 		changed: record.changed === true,
-		target: asText$4(record.target),
+		target: asText$5(record.target),
 		...bundle === "" ? {} : { bundle },
 		...errorCode === "" ? {} : { errorCode },
 		...errorDetail === "" ? {} : { errorDetail },
@@ -2556,14 +2682,14 @@ function asChange(raw) {
 function asInspection(raw) {
 	const record = asRecord$6(raw);
 	if (record === void 0) return null;
-	const status = asText$4(record.status);
+	const status = asText$5(record.status);
 	if (status === "refused") {
 		const problem = pick(PROBLEMS, record.problem) ?? "unknown";
 		const registries = Array.isArray(record.registries) ? record.registries.map(asRegistry).filter((item) => item !== void 0) : [];
 		return {
 			status: "refused",
 			problem,
-			reason: asText$4(record.reason),
+			reason: asText$5(record.reason),
 			...registries.length === 0 ? {} : { registries }
 		};
 	}
@@ -2571,10 +2697,10 @@ function asInspection(raw) {
 	const kind = pick(SPEC_KINDS, record.kind);
 	const registry = asRegistry(record.registry);
 	if (kind === void 0 || registry === void 0) return null;
-	const name = asText$4(record.name);
-	const version = asText$4(record.version);
-	const description = asText$4(record.description);
-	const host = asText$4(record.host);
+	const name = asText$5(record.name);
+	const version = asText$5(record.version);
+	const description = asText$5(record.description);
+	const host = asText$5(record.host);
 	return {
 		status: "accepted",
 		kind,
@@ -2626,7 +2752,7 @@ var PACKAGE_NAME$1 = /^(?:@[a-z0-9][a-z0-9._~-]*\/)?[a-z0-9][a-z0-9._~-]*$/;
 function asRecord$5(value) {
 	return typeof value === "object" && value !== null ? value : void 0;
 }
-function asText$3(value) {
+function asText$4(value) {
 	return typeof value === "string" ? value : "";
 }
 function isPackageName(value) {
@@ -2637,7 +2763,7 @@ function profileDirOf(ctx) {
 	const dir = typeof profile?.dir === "string" ? profile.dir.trim() : "";
 	return dir === "" ? null : dir;
 }
-function stringsOf$3(value) {
+function stringsOf$4(value) {
 	return Array.isArray(value) ? value.filter((item) => typeof item === "string") : [];
 }
 function profileManifestOf(profileDir) {
@@ -2651,7 +2777,7 @@ function profileManifestOf(profileDir) {
 function profileModules(profileDir) {
 	const record = profileManifestOf(profileDir);
 	if (record === void 0) return [];
-	const bundles = stringsOf$3(asRecord$5(asRecord$5(record.dsh)?.profile)?.bundles);
+	const bundles = stringsOf$4(asRecord$5(asRecord$5(record.dsh)?.profile)?.bundles);
 	const dependencies = asRecord$5(record.dependencies) ?? {};
 	const names = bundles.length > 0 ? bundles : Object.keys(dependencies);
 	const found = [];
@@ -2662,7 +2788,7 @@ function profileModules(profileDir) {
 			unit: read.unit,
 			version: read.version,
 			...read.registry === void 0 ? {} : { registry: read.registry },
-			local: isLocalDependencySpec(asText$3(dependencies[read.pkg]))
+			local: isLocalDependencySpec(asText$4(dependencies[read.pkg]))
 		});
 	}
 	return found;
@@ -2757,18 +2883,18 @@ function readInstalledModule(profileDir, pkg) {
 		pkg
 	};
 	const declared = asRecord$5(asRecord$5(record.dsh)?.workbench);
-	const unit = declared === void 0 ? "" : asText$3(declared.unit);
+	const unit = declared === void 0 ? "" : asText$4(declared.unit);
 	if (unit === "") return {
 		kind: "not-module",
 		pkg
 	};
-	const declaredRegistry = asText$3(asRecord$5(record.publishConfig)?.registry);
+	const declaredRegistry = asText$4(asRecord$5(record.publishConfig)?.registry);
 	const registry = declaredRegistry === "" ? registryFromLockfile(profileDir, pkg) : declaredRegistry;
 	return {
 		kind: "module",
 		pkg,
 		unit,
-		version: asText$3(record.version),
+		version: asText$4(record.version),
 		...registry === "" ? {} : { registry }
 	};
 }
@@ -2786,11 +2912,11 @@ function readProfilePackage(profileDir, pkg) {
 	}
 	const record = asRecord$5(manifest);
 	if (record === void 0) return void 0;
-	const version = asText$3(record.version);
+	const version = asText$4(record.version);
 	if (version === "") return void 0;
-	const declaredRegistry = asText$3(asRecord$5(record.publishConfig)?.registry);
+	const declaredRegistry = asText$4(asRecord$5(record.publishConfig)?.registry);
 	const registry = declaredRegistry === "" ? registryFromLockfile(profileDir, pkg) : declaredRegistry;
-	const local = isLocalDependencySpec(asText$3((asRecord$5(profileManifestOf(profileDir)?.dependencies) ?? {})[pkg]));
+	const local = isLocalDependencySpec(asText$4((asRecord$5(profileManifestOf(profileDir)?.dependencies) ?? {})[pkg]));
 	return {
 		pkg,
 		version,
@@ -2799,9 +2925,40 @@ function readProfilePackage(profileDir, pkg) {
 	};
 }
 //#endregion
+//#region src/shared/api/host/opencli-command.ts
+var OPENCLI_PATH_FALLBACK = "opencli";
+function isolatedOpencliPathOf(ctx) {
+	const homePath = ctx.get("dshHomePath");
+	if (typeof homePath !== "function") return null;
+	try {
+		return join(homePath("workbench/opencli/bin/opencli"));
+	} catch {
+		return null;
+	}
+}
+function opencliCommandOf(ctx) {
+	const isolated = isolatedOpencliPathOf(ctx);
+	const fromEnv = process.env.DSH_WORKBENCH_OPENCLI;
+	if (fromEnv !== void 0 && fromEnv !== "") return {
+		command: fromEnv,
+		source: "env",
+		isolated
+	};
+	if (isolated !== null && existsSync(isolated)) return {
+		command: isolated,
+		source: "isolated",
+		isolated
+	};
+	return {
+		command: OPENCLI_PATH_FALLBACK,
+		source: "path",
+		isolated
+	};
+}
+//#endregion
 //#region src/shared/api/host/profile-registries.ts
 var REGISTRY_MARKER = "# dsh-workbench 写的：这一行的包只在这个源上（dsh 卸载没有源参数，pnpm 得问得到）";
-function scopeOf$1(pkg) {
+function scopeOf$2(pkg) {
 	const slash = pkg.indexOf("/");
 	return pkg.startsWith("@") && slash > 1 ? pkg.slice(0, slash) : null;
 }
@@ -2841,7 +2998,7 @@ function sourcesFromLockfile(text) {
 		if (name === null) continue;
 		const tarball = TARBALL.exec(line);
 		if (tarball === null) continue;
-		const scope = scopeOf$1(name);
+		const scope = scopeOf$2(name);
 		const root = registryRootOf(name, tarball[1] ?? "");
 		name = null;
 		if (scope === null || root === null) continue;
@@ -2930,7 +3087,7 @@ function workshopPathOf(ctx) {
 function asRecord$4(value) {
 	return typeof value === "object" && value !== null ? value : void 0;
 }
-function asText$2(value) {
+function asText$3(value) {
 	return typeof value === "string" ? value.trim() : "";
 }
 function workshopPackagesDir(ctx) {
@@ -2953,17 +3110,26 @@ function workshopModules(packagesDir, installed = []) {
 		}
 		const record = asRecord$4(manifest);
 		const declared = record === void 0 ? void 0 : asRecord$4(asRecord$4(record.dsh)?.workbench);
-		const unit = declared === void 0 ? "" : asText$2(declared.unit);
+		const unit = declared === void 0 ? "" : asText$3(declared.unit);
 		if (unit === "") return [];
 		return [{
 			unit,
-			name: asText$2(record?.name),
-			description: asText$2(record?.description),
+			name: asText$3(record?.name),
+			description: asText$3(record?.description),
 			dir,
 			installed: already.has(unit)
 		}];
 	}).sort((left, right) => left.unit.localeCompare(right.unit));
 }
+function readDesignOfModule(dir) {
+	const file = join(dir, "design.json");
+	if (!existsSync(file)) return void 0;
+	try {
+		return JSON.parse(readFileSync(file, "utf8"));
+	} catch {
+		return;
+	}
+}
 function inWorkshopSession(ctx, workspace) {
 	const root = workshopPathOf(ctx);
 	return root !== null && workspace !== null && insideWorkshop(root, workspace);
@@ -2977,20 +3143,20 @@ function workshopSyncOf(workshopRoot) {
 	}
 	if (typeof parsed !== "object" || parsed === null) return void 0;
 	const record = parsed;
-	const state = asText$2(record["state"]);
+	const state = asText$3(record["state"]);
 	if (state !== "ok" && state !== "syncing" && state !== "failed") return void 0;
-	const reason = asText$2(record["reason"]);
+	const reason = asText$3(record["reason"]);
 	return {
 		state,
-		version: asText$2(record["version"]),
-		at: asText$2(record["at"]),
+		version: asText$3(record["version"]),
+		at: asText$3(record["at"]),
 		...reason === "" ? {} : { reason }
 	};
 }
 function workshopToolchainOf(workshopRoot) {
 	const versionOf = (name) => {
 		try {
-			return asText$2(JSON.parse(readFileSync(join(workshopRoot, "node_modules", "@dsh-workbench", name, "package.json"), "utf8")).version);
+			return asText$3(JSON.parse(readFileSync(join(workshopRoot, "node_modules", "@dsh-workbench", name, "package.json"), "utf8")).version);
 		} catch {
 			return "";
 		}
@@ -3025,6 +3191,7 @@ var MODULES_UPDATE_WORKBENCH_TOOL = "workbench_modules_update_workbench";
 var DIY_LIST_TOOL = "workbench_diy_list";
 var DIY_STATUS_TOOL = "workbench_diy_status";
 var DIY_PANEL_TOOL = "workbench_diy_panel";
+var DIY_COMPONENTS_TOOL = "workbench_diy_components";
 var DIY_RECON_TOOL = "workbench_diy_recon";
 var DIY_SPEC_TOOL = "workbench_diy_spec";
 var DIY_PROBE_TOOL = "workbench_diy_probe";
@@ -3047,6 +3214,10 @@ 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";
+var DIY_RECORD_PREPARE_TOOL = "workbench_diy_record_prepare";
+var DIY_RECORD_READ_TOOL = "workbench_diy_record_read";
+var DIY_RECORD_DETAIL_TOOL = "workbench_diy_record_detail";
+var DIY_RECORD_STOP_TOOL = "workbench_diy_record_stop";
 var DIY_DEBUG_START_TOOL = "workbench_diy_debug_start";
 var DIY_DEBUG_PAUSE_TOOL = "workbench_diy_debug_pause";
 var DIY_DEBUG_RESUME_TOOL = "workbench_diy_debug_resume";
@@ -3057,6 +3228,7 @@ var READ_TOOLS = [
 	DIY_LIST_TOOL,
 	DIY_STATUS_TOOL,
 	DIY_PANEL_TOOL,
+	DIY_COMPONENTS_TOOL,
 	DIY_RECON_TOOL,
 	DIY_SPEC_TOOL,
 	DIY_PROBE_TOOL,
@@ -3076,7 +3248,10 @@ var READ_TOOLS = [
 	DIY_DIALOG_TOOL,
 	DIY_LOGS_WATCH_TOOL,
 	DIY_LOGS_READ_TOOL,
-	DIY_LOGS_STOP_TOOL
+	DIY_LOGS_STOP_TOOL,
+	DIY_RECORD_READ_TOOL,
+	DIY_RECORD_DETAIL_TOOL,
+	DIY_RECORD_STOP_TOOL
 ];
 var WRITE_TOOLS = [
 	PANELS_SHOW_TOOL,
@@ -3094,6 +3269,7 @@ var WRITE_TOOLS = [
 	MODULES_UPDATE_WORKBENCH_TOOL,
 	DIY_INSTALL_TOOL,
 	DIY_SHOW_TOOL,
+	DIY_RECORD_PREPARE_TOOL,
 	DIY_DEBUG_START_TOOL,
 	DIY_DEBUG_PAUSE_TOOL,
 	DIY_DEBUG_RESUME_TOOL,
@@ -3103,6 +3279,7 @@ var DIY_TOOLS = [
 	DIY_LIST_TOOL,
 	DIY_STATUS_TOOL,
 	DIY_PANEL_TOOL,
+	DIY_COMPONENTS_TOOL,
 	DIY_RECON_TOOL,
 	DIY_SPEC_TOOL,
 	DIY_PROBE_TOOL,
@@ -3126,6 +3303,12 @@ var DIY_TOOLS = [
 	DIY_LOGS_READ_TOOL,
 	DIY_LOGS_STOP_TOOL
 ];
+var DIY_RECORD_TOOLS = [
+	DIY_RECORD_PREPARE_TOOL,
+	DIY_RECORD_READ_TOOL,
+	DIY_RECORD_DETAIL_TOOL,
+	DIY_RECORD_STOP_TOOL
+];
 var DIY_DEBUG_TOOLS = [
 	DIY_DEBUG_START_TOOL,
 	DIY_DEBUG_PAUSE_TOOL,
@@ -3229,9 +3412,16 @@ var panelsApproval = (call) => {
 		const starting = call.name === DIY_DEBUG_START_TOOL;
 		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?"));
+		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 a workbench module. Allow?"));
 	}
 	if (call.name === "workbench_diy_debug_pause" || call.name === "workbench_diy_debug_stop") return { kind: "allow" };
+	if (call.name === "workbench_diy_record_prepare") {
+		const raw = argsOf$2(call);
+		const asked = typeof raw["url"] === "string" ? raw["url"].replace(/\s+/g, " ").trim() : "";
+		const act = typeof raw["doing"] === "string" ? raw["doing"].replace(/\s+/g, " ").trim() : "";
+		const title = pair("申请录制调试", "Request recording a debug session");
+		return askOf(`${DIY_RECORD_PREPARE_TOOL} opens a browser window in front on ${asked} to record one real write` + (act === "" ? "" : ` (${act})`), title, title);
+	}
 	if (call.name !== void 0 && DIY_TOOLS.includes(call.name)) return { kind: "allow" };
 	const raw = argsOf$2(call);
 	const text = (key) => {
@@ -3439,35 +3629,305 @@ function withMoved(board, id, index, visible) {
 	};
 }
 //#endregion
-//#region src/shared/api/host/opencli-command.ts
-var OPENCLI_PATH_FALLBACK = "opencli";
-function isolatedOpencliPathOf(ctx) {
-	const homePath = ctx.get("dshHomePath");
-	if (typeof homePath !== "function") return null;
+//#region src/shared/api/host/diy-components.ts
+var SURFACE_TIMEOUT_MS = 3e4;
+var PRUNE_CHARS = 8192;
+var PRIMITIVES_PKG = "@deepseek-ai/dsh-client-ui-primitives";
+var MANIFEST_TAIL = "//# sourceMappingURL=";
+function scopeOf$1(raw) {
+	if (raw === "primitives" || raw === "kit") return raw;
+	return "all";
+}
+function wantsPrimitives(scope) {
+	return scope !== "kit";
+}
+function wantsKit(scope) {
+	return scope !== "primitives";
+}
+function toolchainBinOf(root) {
+	const bin = join(root, "node_modules", ".bin", "dsh-wb-module");
+	if (existsSync(bin)) return bin;
+	const script = join(root, "node_modules", "@dsh-workbench", "module-tools", "bin", "dsh-wb-module.mjs");
+	return existsSync(script) ? script : null;
+}
+function queryCommandOf(bin, only) {
+	return `${quoteShellArg(bin)} check --only ${only} --json`;
+}
+async function runSurfaceQuery(shell, bin, only, root) {
+	const result = await runShell(shell, queryCommandOf(bin, only), {
+		workdir: root,
+		timeoutMs: SURFACE_TIMEOUT_MS
+	});
+	const parsed = jsonOf$1(result.stdout);
+	if (parsed !== null) return withoutProblems(parsed);
+	if (result.exitCode !== 0) {
+		const tail = `${result.stderr}\n${result.stdout}`.trim().split("\n").slice(-3).join(" | ");
+		throw new Error(`工坊工具链的 \`check --only ${only} --json\` 没跑通（exit ${String(result.exitCode)}）—— 这不是工具链坏了，是工坊里有模块过不了判据，所以连清单也没打出来${tail === "" ? "" : `：${tail}`}`);
+	}
+	throw new Error(`工坊工具链的 \`check --only ${only} --json\` 没回 JSON：${result.stdout.trim().split("\n").slice(-2).join(" | ")}`);
+}
+function jsonOf$1(stdout) {
 	try {
-		return join(homePath("workbench/opencli/bin/opencli"));
+		const parsed = JSON.parse(stdout);
+		return typeof parsed === "object" && parsed !== null ? parsed : null;
 	} catch {
 		return null;
 	}
 }
-function opencliCommandOf(ctx) {
-	const isolated = isolatedOpencliPathOf(ctx);
-	const fromEnv = process.env.DSH_WORKBENCH_OPENCLI;
-	if (fromEnv !== void 0 && fromEnv !== "") return {
-		command: fromEnv,
-		source: "env",
-		isolated
-	};
-	if (isolated !== null && existsSync(isolated)) return {
-		command: isolated,
-		source: "isolated",
-		isolated
-	};
-	return {
-		command: OPENCLI_PATH_FALLBACK,
-		source: "path",
-		isolated
-	};
+function withoutProblems(payload) {
+	const rest = {};
+	for (const [key, value] of Object.entries(payload)) if (key !== "problems") rest[key] = value;
+	return rest;
+}
+function recordOf$1(value) {
+	return typeof value === "object" && value !== null ? value : {};
+}
+function asText$2(value) {
+	return typeof value === "string" ? value : "";
+}
+function stringsOf$3(value) {
+	return Array.isArray(value) ? value.filter((one) => typeof one === "string") : [];
+}
+function filesOf$1(payload) {
+	const files = recordOf$1(payload?.["files"]);
+	const out = {};
+	for (const [name, file] of Object.entries(files)) if (typeof file === "string") out[name] = file;
+	return out;
+}
+function rootsOf(payload) {
+	const roots = recordOf$1(payload?.["roots"]);
+	const out = {};
+	for (const [key, dir] of Object.entries(roots)) if (typeof dir === "string") out[key] = dir;
+	return out;
+}
+function installedVersionOf(payload) {
+	const version = recordOf$1(payload?.["installed"])["version"];
+	return typeof version === "string" ? version : null;
+}
+function distance(left, right) {
+	let previous = Array.from({ length: right.length + 1 }, (_unused, index) => index);
+	for (let row = 1; row <= left.length; row += 1) {
+		const current = [row];
+		for (let column = 1; column <= right.length; column += 1) {
+			const same = left[row - 1] === right[column - 1] ? 0 : 1;
+			current.push(Math.min((previous[column] ?? 0) + 1, (current[column - 1] ?? 0) + 1, (previous[column - 1] ?? 0) + same));
+		}
+		previous = current;
+	}
+	return previous[right.length] ?? 0;
+}
+function nearNamesOf(name, names, limit = 8) {
+	const wanted = name.toLowerCase();
+	return names.flatMap((one) => {
+		const lower = one.toLowerCase();
+		if (lower.length < 3) return lower === wanted ? [{
+			one,
+			score: 0
+		}] : [];
+		if (lower.includes(wanted)) return [{
+			one,
+			score: 0
+		}];
+		if (wanted.includes(lower)) return [{
+			one,
+			score: 1
+		}];
+		const typos = distance(lower, wanted);
+		return typos <= 2 ? [{
+			one,
+			score: typos + 1
+		}] : [];
+	}).sort((left, right) => left.score - right.score || left.one.length - right.one.length || left.one.localeCompare(right.one)).slice(0, limit).map((one) => one.one);
+}
+function findFileOf(name, query) {
+	const primitives = filesOf$1(query.primitives)[name];
+	if (primitives !== void 0) return {
+		file: primitives,
+		from: "primitives"
+	};
+	const kit = filesOf$1(query.kit)[name];
+	return kit === void 0 ? null : {
+		file: kit,
+		from: "kit"
+	};
+}
+function excerptOf(text, maxLines = 60) {
+	const cutAt = text.indexOf(MANIFEST_TAIL);
+	const body = (cutAt === -1 ? text : text.slice(0, cutAt)).trimEnd();
+	const lines = body.split("\n");
+	return lines.length <= maxLines ? body : `${lines.slice(0, maxLines).join("\n")}\n…（这份文件还有 ${String(lines.length - maxLines)} 行）`;
+}
+function excerptAt(file, maxLines = 60) {
+	try {
+		return excerptOf(readFileSync(file, "utf8"), maxLines);
+	} catch {
+		return "（打不开那份类型文件 —— 照上面的路径自己看一眼）";
+	}
+}
+function skillDirOf(from) {
+	let dir = from;
+	for (let hop = 0; hop < 6; hop += 1) {
+		const candidate = join(dir, "skills", "workbench-module-diy");
+		if (existsSync(join(candidate, "HOOKS.md"))) return candidate;
+		const parent = dirname(dir);
+		if (parent === dir) break;
+		dir = parent;
+	}
+	return null;
+}
+function symbolsIn(heading) {
+	return [...heading.matchAll(/`([^`]+)`/g)].map((one) => (one[1] ?? "").trim()).map((one) => one.replace(/[<({[].*$/u, "").trim()).map((one) => one.replace(/[.:：,，\s].*$/u, "").trim()).filter((one) => /^[\w$]+$/u.test(one));
+}
+function sectionOf(text, name) {
+	const rows = text.split("\n");
+	const at = rows.findIndex((row) => row.startsWith("### ") && symbolsIn(row).includes(name));
+	if (at === -1) return "";
+	const rest = rows.slice(at + 1).findIndex((row) => row.startsWith("## ") || row.startsWith("### "));
+	return rows.slice(at, rest === -1 ? rows.length : at + 1 + rest).join("\n").trim();
+}
+function docSectionOf(name, dir) {
+	if (dir === null) return null;
+	for (const doc of ["HOOKS.md", "KIT.md"]) {
+		const file = join(dir, doc);
+		try {
+			const lines = sectionOf(readFileSync(file, "utf8"), name);
+			if (lines !== "") return {
+				file,
+				lines
+			};
+		} catch {
+			continue;
+		}
+	}
+	return null;
+}
+function truncated(names, all) {
+	if (all || names.length <= 12) return names.join(", ");
+	return `${names.slice(0, 12).join(", ")} …+${String(names.length - 12)}`;
+}
+function byLocationOf(payload) {
+	const roots = Object.values(rootsOf(payload)).sort((left, right) => right.length - left.length);
+	const groups = /* @__PURE__ */ new Map();
+	for (const [name, file] of Object.entries(filesOf$1(payload))) {
+		const root = roots.find((one) => file === one || file.startsWith(`${one}/`));
+		const where = (root === void 0 ? file.split("/").slice(-2).join("/") : file.slice(root.length + 1)).split("/").slice(0, -1).join("/") || ".";
+		const bucket = groups.get(where);
+		if (bucket === void 0) groups.set(where, [name]);
+		else bucket.push(name);
+	}
+	return [...groups.entries()].map(([where, names]) => ({
+		where,
+		names: [...names].sort()
+	})).sort((left, right) => right.names.length - left.names.length || left.where.localeCompare(right.where));
+}
+function isComponents(where) {
+	return where.split("/").at(-1) === "components";
+}
+function renderSurfaceText(query, options) {
+	const lines = [];
+	const kitNames = Object.keys(filesOf$1(query.kit)).sort();
+	if (query.kit !== void 0) {
+		const groups = byLocationOf(query.kit);
+		if (kitNames.length === 0 && groups.length === 0) {
+			const anyNames = [...new Set(Object.values(recordOf$1(query.kit["buckets"])).flatMap((value) => stringsOf$3(value)))].sort();
+			lines.push(anyNames.length === 0 ? "kit：读不到（没找到 client.js）" : `kit：类型面扫不到，只有名字 ${truncated(anyNames, options.all)}`);
+		} else {
+			const componentNames = groups.filter((one) => isComponents(one.where)).flatMap((one) => one.names).sort();
+			const countOf = (one) => `${isComponents(one.where) ? "组件" : one.where} ${one.names.length}`;
+			const counts = [...componentNames.length === 0 ? [] : [`组件 ${componentNames.length}`], ...groups.filter((one) => !isComponents(one.where)).map(countOf)];
+			lines.push(`kit ${kitNames.length}：${counts.join(" · ")}`);
+			if (componentNames.length > 0) lines.push(`  组件(${componentNames.length})：${truncated(componentNames, options.all)}`);
+			for (const group of groups) {
+				if (isComponents(group.where)) continue;
+				lines.push(`  ${group.where}(${group.names.length})：${truncated(group.names, options.all)}`);
+			}
+		}
+	}
+	if (query.primitives !== void 0) {
+		const version = installedVersionOf(query.primitives);
+		const only = Object.entries(recordOf$1(query.primitives["onlyPrimitives"])).map(([bucket, value]) => ({
+			bucket,
+			names: [...stringsOf$3(value)].sort()
+		})).filter((one) => one.names.length > 0);
+		const covered = (Array.isArray(query.primitives["kitCovered"]) ? query.primitives["kitCovered"] : []).map((one) => recordOf$1(one)["name"]).filter((one) => typeof one === "string");
+		if (version === null) {
+			const want = asText$2(recordOf$1(recordOf$1(query.primitives["snippet"])["devDependency"])["version"]);
+			lines.push(`原语：没装 —— devDependencies 加 "${PRIMITIVES_PKG}": "${want === "" ? "<外壳钉的那版>" : want}" 再 pnpm install`);
+		} else lines.push(`原语 ${version}${only.length === 0 ? "" : `：只有它有 ${only.map((one) => `${one.bucket} ${truncated(one.names, options.all)}`).join(" · ")}`}`);
+		if (only.length > 0 && version !== null) lines.push("（只有原语有的，用之前先在 dsh.client.external 里声明）");
+		if (covered.length > 0) lines.push(`kit 里已有：${covered.join(", ")}`);
+	}
+	const roots = [...Object.entries(rootsOf(query.kit)).map(([key, dir]) => `${key}=${dir}`), ...Object.entries(rootsOf(query.primitives)).map(([key, dir]) => `${key}=${dir}`)];
+	if (roots.length > 0) lines.push(`类型面：${roots.join(" · ")}`);
+	lines.push(faceStateOf(query, "primitives") === "unreadable" ? "name=<件> 看它怎么用 · all=true 出全表（原语装过才能问原语那类）" : "name=<件> 看它怎么用 · all=true 出全表");
+	const text = lines.join("\n");
+	if (text.length <= 8192) return text;
+	return [
+		`⚠️ 这份清单 ${String(text.length)} 字符，超过 ${String(PRUNE_CHARS)} 会被修剪器裁掉中间：`,
+		`   一件件问（name=<件>）或到 shell 里跑 \`dsh-wb-module check --only ${options.scope === "all" ? "primitives|kit" : options.scope} --all\` 再 grep。`,
+		"",
+		text
+	].join("\n");
+}
+function listedNamesOf(query) {
+	const out = /* @__PURE__ */ new Set([...Object.keys(filesOf$1(query.primitives)), ...Object.keys(filesOf$1(query.kit))]);
+	for (const payload of [query.primitives, query.kit]) {
+		if (payload === void 0) continue;
+		for (const value of Object.values(recordOf$1(payload["buckets"]))) for (const one of stringsOf$3(value)) out.add(one);
+		for (const value of Object.values(recordOf$1(payload["onlyPrimitives"]))) for (const one of stringsOf$3(value)) out.add(one);
+		for (const one of Array.isArray(payload["kitCovered"]) ? payload["kitCovered"] : []) {
+			const covered = asText$2(recordOf$1(one)["name"]);
+			if (covered !== "") out.add(covered);
+		}
+	}
+	return [...out].sort();
+}
+function faceStateOf(query, face) {
+	const payload = face === "kit" ? query.kit : query.primitives;
+	if (payload === void 0) return "not-queried";
+	if (face === "primitives") {
+		const named = Object.keys(filesOf$1(payload)).length > 0 || Object.keys(recordOf$1(payload["onlyPrimitives"])).length > 0;
+		return installedVersionOf(payload) === null || !named ? "unreadable" : "ok";
+	}
+	return Object.keys(filesOf$1(payload)).length > 0 || Object.keys(rootsOf(payload)).length > 0 ? "ok" : "unreadable";
+}
+function installSnippetOf(query) {
+	const dependency = recordOf$1(recordOf$1(query.primitives?.["snippet"])["devDependency"]);
+	const name = asText$2(dependency["name"]) || "@deepseek-ai/dsh-client-ui-primitives";
+	const version = asText$2(dependency["version"]);
+	return `devDependencies 加 "${name}": "${version === "" ? "<外壳钉的那版>" : version}" 再 pnpm install`;
+}
+function renderNameText(name, found, query) {
+	if (found === null) {
+		const every = listedNamesOf(query);
+		const listed = every.includes(name);
+		const near = nearNamesOf(name, every).filter((one) => one !== name);
+		const kit = faceStateOf(query, "kit");
+		const primitives = faceStateOf(query, "primitives");
+		const said = [kit === "ok" ? "kit 里没有" : "", primitives === "ok" ? "原语里也没有" : ""].filter((one) => one !== "");
+		const blind = [kit === "ok" ? "" : `kit 那一面${kit === "not-queried" ? "没查" : "读不到"}`, primitives === "ok" ? "" : `原语那一面${primitives === "not-queried" ? "没查" : "读不到（没装）"}`].filter((one) => one !== "");
+		const how = primitives === "unreadable" ? `${installSnippetOf(query)}，才敢说它在不在。` : kit === "unreadable" ? "把这份外壳装上（让 client.js 读得到）再问。" : "不给 scope 就都查。";
+		const lines = [...listed ? [`「${name}」在清单里（${String(every.length)} 个名字里有它），但扫不到它的类型文件 —— 类型面读不到，或这代外壳的声明形状变了。`] : kit === "ok" && primitives === "ok" ? [`没有「${name}」这个东西（kit 与原语里都没有）。`] : said.length > 0 ? [`「${name}」${said.join("，")}。`, ...blind.length === 0 ? [] : [`${blind.join("、")} —— ${how}`]] : [`没法确认「${name}」在不在：${blind.join("、")} —— ${how}`]];
+		if (near.length > 0) lines.push(`近似的名字：${near.join(", ")}`);
+		return lines.join("\n");
+	}
+	const body = excerptAt(found.file);
+	if (body.includes("/**")) return [
+		`${name} → ${found.file}（${found.from === "kit" ? "kit" : "原语"}）`,
+		"",
+		body,
+		"",
+		found.from === "kit" ? "（上面就是它的声明；@param 写着默认值。kit 件最小写法：KIT.md）" : "（上面就是它的声明；@param 写着默认值。原语件要先在 dsh.client.external 里声明它）"
+	].join("\n");
+	const skillDir = skillDirOf(dirname(fileURLToPath(import.meta.url)));
+	const doc = docSectionOf(name, skillDir);
+	return [
+		`${name} → ${found.file}（${found.from === "kit" ? "kit" : "原语"}）`,
+		"",
+		body,
+		"",
+		doc === null ? `（声明没说明文字；${skillDir === null ? "指引也没装" : `指引里没有专门讲「${name}」的一节`} —— 源码零注释，tsc 不 emit JSDoc。用法看 KIT.md / HOOKS.md / LINKAGE.md / PANEL.md / TOOLS.md。）` : `（声明没说明文字（零注释）；语义出自 ${basename(doc.file)}：）\n\n${doc.lines}`
+	].join("\n");
 }
 var OUTPUT$2 = {
 	schema: {
@@ -3584,6 +4044,74 @@ function panelEntriesOf(panels, workspace) {
 	}
 }
 //#endregion
+//#region src/modules/panels/model/diy-components.ts
+function componentsTool(ctx) {
+	return {
+		name: DIY_COMPONENTS_TOOL,
+		description: "工坊里能用什么：dsh 原语与外壳 kit 的清单、每件的类型文件在哪（给 name 连 JSDoc 与 prop 一起回）。",
+		parameters: {
+			type: "object",
+			properties: {
+				name: {
+					type: "string",
+					description: "要看的那件（例 Card；不填就给清单）。"
+				},
+				scope: {
+					type: "string",
+					enum: [
+						"all",
+						"primitives",
+						"kit"
+					],
+					description: "只看某一面（默认 all）。"
+				},
+				all: {
+					type: "boolean",
+					description: "列全表（默认每组前 12 个）。"
+				}
+			},
+			additionalProperties: false
+		},
+		output: OUTPUT$2,
+		async execute(raw, exec) {
+			const { packagesDir } = workshopOf(ctx, exec);
+			const root = dirname(packagesDir);
+			const bin = toolchainBinOf(root);
+			if (bin === null) throw new Error(`工坊里还没装工具链（${join(root, "node_modules")} 里没有 dsh-wb-module）—— 在工坊根目录跑一次 pnpm install 就有了；workbench_diy_status 会告诉你卡在哪一步`);
+			const shell = ctx.get("shell");
+			if (shell === void 0) throw new Error("这台机器没给 shell 服务，读不了组件清单");
+			const args = asRecord$3(raw);
+			const scope = scopeOf$1(asText$1(args["scope"]));
+			const name = asText$1(args["name"]);
+			const all = args["all"] === true;
+			const [primitives, kit] = await Promise.all([wantsPrimitives(scope) ? runSurfaceQuery(shell, bin, "primitives", root) : Promise.resolve(void 0), wantsKit(scope) ? runSurfaceQuery(shell, bin, "kit", root) : Promise.resolve(void 0)]);
+			const query = {
+				...primitives === void 0 ? {} : { primitives },
+				...kit === void 0 ? {} : { kit }
+			};
+			const found = name === "" ? null : findFileOf(name, query);
+			const text = name === "" ? renderSurfaceText(query, {
+				scope,
+				all
+			}) : renderNameText(name, found, query);
+			return plainJson({
+				workshop: root,
+				scope,
+				name,
+				all,
+				file: found?.file ?? null,
+				from: found?.from ?? null,
+				primitives: primitives ?? null,
+				kit: kit ?? null,
+				text
+			});
+		}
+	};
+}
+function registerComponentsTool(ctx, tools) {
+	return [tools.register(componentsTool(ctx))];
+}
+//#endregion
 //#region src/modules/panels/model/diy-scripts.ts
 var PAGE_PROBE = `(async () => {
   const answer = await fetch('/workbench/api/health').then((one) => one.json()).catch(() => null);
@@ -3842,7 +4370,7 @@ function renderDebugResume(state) {
 function renderDebugStop(state) {
 	return `收工了：${state.unit} 的调试态清掉了（占用解除）。`;
 }
-function moveOrThrow(move, held) {
+function moveOrThrow$1(move, held) {
 	if (move.ok) return move.state;
 	throw new Error(debugRefusalText(move.code, held ?? void 0));
 }
@@ -3850,7 +4378,7 @@ function registerDebugTools(ctx, tools, store) {
 	const startTool = {
 		name: DIY_DEBUG_START_TOOL,
 		description: "开始调试：占用用户那一屏（要点头一次）。没有它，看 / 动 / 网络那一族一律当场拒。",
-		parameters: withApprovalNote({
+		parameters: {
 			type: "object",
 			properties: { unit: {
 				type: "string",
@@ -3858,7 +4386,7 @@ function registerDebugTools(ctx, tools, store) {
 			} },
 			required: ["unit"],
 			additionalProperties: false
-		}, { required: true }),
+		},
 		output: OUTPUT$2,
 		async execute(raw, exec) {
 			const { packagesDir, workspace } = workshopOf(ctx, exec);
@@ -3872,7 +4400,7 @@ function registerDebugTools(ctx, tools, store) {
 				requireBoard: false,
 				requirePact: false
 			});
-			const state = moveOrThrow(store.begin({
+			const state = moveOrThrow$1(store.begin({
 				sessionId: sessionIdOf(exec) ?? "",
 				workspace: workspace ?? "",
 				board: page.boardPath,
@@ -3898,7 +4426,7 @@ function registerDebugTools(ctx, tools, store) {
 		async execute(_raw, exec) {
 			const { packagesDir } = workshopOf(ctx, exec);
 			const held = store.live(Date.now());
-			const state = moveOrThrow(store.pause(sessionIdOf(exec) ?? "", Date.now()), held);
+			const state = moveOrThrow$1(store.pause(sessionIdOf(exec) ?? "", Date.now()), held);
 			return plainJson({
 				workshop: packagesDir,
 				unit: state.unit,
@@ -3911,7 +4439,7 @@ function registerDebugTools(ctx, tools, store) {
 	const resumeTool = {
 		name: DIY_DEBUG_RESUME_TOOL,
 		description: "继续调试（要点头一次）：请用户回到「工作台DIY」那一屏。",
-		parameters: withApprovalNote(EMPTY, { required: true }),
+		parameters: EMPTY,
 		output: OUTPUT$2,
 		async execute(_raw, exec) {
 			const { packagesDir } = workshopOf(ctx, exec);
@@ -3921,7 +4449,7 @@ function registerDebugTools(ctx, tools, store) {
 				requirePact: false,
 				requireUnit: false
 			});
-			const state = moveOrThrow(store.resume(sessionIdOf(exec) ?? "", Date.now()), held);
+			const state = moveOrThrow$1(store.resume(sessionIdOf(exec) ?? "", Date.now()), held);
 			return plainJson({
 				workshop: packagesDir,
 				unit: state.unit,
@@ -3940,7 +4468,7 @@ function registerDebugTools(ctx, tools, store) {
 		async execute(_raw, exec) {
 			const { packagesDir } = workshopOf(ctx, exec);
 			const held = store.live(Date.now());
-			const state = moveOrThrow(store.stop(sessionIdOf(exec) ?? "", Date.now()), held);
+			const state = moveOrThrow$1(store.stop(sessionIdOf(exec) ?? "", Date.now()), held);
 			await store.settle?.();
 			return plainJson({
 				workshop: packagesDir,
@@ -3990,6 +4518,7 @@ async function stopNetworkExact(shell, file, timeoutMs = SWEEP_TIMEOUT_MS) {
 	return (await runShell(shell, [
 		`p="$(cat ${pidFile} 2>/dev/null)"`,
 		`r="$(cat ${reaperFile} 2>/dev/null)"`,
+		`[ -n "$p" ] && pkill -P "$p" 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`,
@@ -5772,7 +6301,7 @@ function registerDiyTools(ctx, market, panels, debug) {
 	const showTool = {
 		name: DIY_SHOW_TOOL,
 		description: "只上板（不装）：把一个已经装好的工坊模块显示在当前项目的面板上。",
-		parameters: withApprovalNote({
+		parameters: {
 			type: "object",
 			properties: { unit: {
 				type: "string",
@@ -5780,7 +6309,7 @@ function registerDiyTools(ctx, market, panels, debug) {
 			} },
 			required: ["unit"],
 			additionalProperties: false
-		}, { required: true }),
+		},
 		output: OUTPUT$2,
 		async execute(raw, exec) {
 			const { packagesDir, workspace } = workshopOf(ctx, exec);
@@ -5800,7 +6329,7 @@ function registerDiyTools(ctx, market, panels, debug) {
 	const installTool = {
 		name: DIY_INSTALL_TOOL,
 		description: "把工坊里造好的模块装上并上到当前项目的面板。这是持久变更，一个模块只装一次：之后改源码只需 dsh-wb-module build（宿主侧秒级热换）。",
-		parameters: withApprovalNote({
+		parameters: {
 			type: "object",
 			properties: { unit: {
 				type: "string",
@@ -5808,121 +6337,1740 @@ function registerDiyTools(ctx, market, panels, debug) {
 			} },
 			required: ["unit"],
 			additionalProperties: false
-		}, { required: true }),
+		},
+		output: OUTPUT$2,
+		async execute(raw, exec) {
+			const { packagesDir, workspace } = workshopOf(ctx, exec);
+			const found = unitOf(packagesDir, raw, "workbench_diy_install");
+			if (found.installed) {
+				const panel = showOrReason(panels, found.unit, workspace);
+				const text = ["它已经装过了（就是工坊里这一份）—— **不要再装**：改源码 + dsh-wb-module build（宿主侧与 client.js 都秒级热换 —— dsh-client-hmr 盯着每个 bundle 的 lib/client.js，重建了就换进已打开的页面）。", panel.ok ? `面板上已经打开它了（${workspace}）—— 验收就走这一张卡（你自己走一遍）` : `面板上还没打开：${panel.reason}。调 workbench_diy_show（unit=${found.unit}）`].join("\n");
+				return plainJson({
+					workshop: packagesDir,
+					unit: found.unit,
+					path: found.dir,
+					alreadyInstalled: true,
+					panel,
+					text
+				});
+			}
+			const outcome = await market.installBundle(found.dir);
+			const verdict = verdictOf$1(outcome.change);
+			const restartRequired = outcome.change.application === "restart-required";
+			const panel = outcome.change.application === "applied" ? showOrReason(panels, found.unit, workspace) : {
+				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 text = [
+				`${verdict}：${found.unit}（${found.name}）`,
+				panelText,
+				"之后只改源码 + dsh-wb-module build（宿主侧与 client.js 都秒级热换 —— dsh-client-hmr 盯着每个 bundle 的 lib/client.js，重建了就换进已打开的页面）：不要再装一遍。"
+			].join("\n");
+			return plainJson({
+				workshop: packagesDir,
+				unit: found.unit,
+				path: found.dir,
+				install: outcome.change,
+				module: outcome.module,
+				panel,
+				text
+			});
+		}
+	};
+	return [
+		tools.register(listTool),
+		tools.register(statusTool),
+		tools.register(panelTool),
+		...registerComponentsTool(ctx, tools),
+		tools.register(reconTool),
+		...registerSpecTool(ctx, tools),
+		tools.register(probeTool),
+		...registerLogTools(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": () => ({
+		ok: true,
+		state: store.live(Date.now())
+	}) };
+}
+//#endregion
+//#region src/modules/panels/model/diy-record-routes.ts
+function diyRecordRoutes(store) {
+	return { "panels/diy-record": () => ({
+		ok: true,
+		state: store.live(Date.now())
+	}) };
+}
+//#endregion
+//#region src/shared/api/host/diy-debug-act.ts
+var DEBUG_NOTICE_KIND = "workbench-diy";
+function noticeMessage(text, summary, kind = DEBUG_NOTICE_KIND) {
+	return {
+		role: "user",
+		id: randomUUID(),
+		content: [{
+			type: "text",
+			text
+		}],
+		source: {
+			kind,
+			form: "notice",
+			summary
+		}
+	};
+}
+function isNoticeMessage(value) {
+	if (typeof value !== "object" || value === null) return false;
+	const one = value;
+	const source = one.source;
+	return one.role === "user" && typeof one.id === "string" && Array.isArray(one.content) && typeof source === "object" && source !== null && typeof source.kind === "string";
+}
+function requireNoticeMessage(value) {
+	if (!isNoticeMessage(value)) throw new Error("notice 得是 dsh 的 UserMessage 形状（role / id / content / source.kind）—— 裸字符串会写坏会话日志（agent/inbox/spliced requires message objects）");
+	return value;
+}
+var INTENT_WORD$1 = {
+	pause: "暂停",
+	resume: "继续",
+	stop: "结束"
+};
+function debugNoticeText(intent, state) {
+	const head = `［工作台 DIY］用户按了「${INTENT_WORD$1[intent]}」：`;
+	if (intent === "pause") return `${head}${state.unit} 这场调试暂停了 —— 现在别再把那一屏当目标（看 / 动 / 网络那一族发不出去）。要接着看屏就等用户按「继续」；在那之前照常改源码 / build / 跑门禁。`;
+	if (intent === "resume") return `${head}${state.unit} 这场调试重新开始了 —— 那一屏又归你看。屏 / 板不对的话照旧会被拒，拒了就照实说清是哪种不对。`;
+	return `${head}${state.unit} 这场调试收工了（占用解除）。要再调试就重新 start 一场。`;
+}
+function debugNoticeSummary(intent, state) {
+	return `工作台 DIY：用户按了${INTENT_WORD$1[intent]}（${state.unit}）`;
+}
+function debugNotice(intent, state) {
+	const summary = debugNoticeSummary(intent, state);
+	return {
+		summary,
+		message: noticeMessage(debugNoticeText(intent, state), summary)
+	};
+}
+var NOTICE_MODE$1 = {
+	resume: "wake",
+	pause: "hold",
+	stop: "drop"
+};
+var held = /* @__PURE__ */ new Map();
+function holdNotice(sessionId, message) {
+	const checked = requireNoticeMessage(message);
+	const list = held.get(sessionId);
+	if (list === void 0) held.set(sessionId, [checked]);
+	else list.push(checked);
+}
+function takeHeldNotices(sessionId) {
+	const list = held.get(sessionId) ?? [];
+	held.delete(sessionId);
+	return list;
+}
+function deliverDebugNotice(agents, sessionId, message, mode = "wake") {
+	const notice = requireNoticeMessage(message);
+	const agent = agents?.get(sessionId);
+	if (agent === void 0) {
+		if (mode === "drop") return "none";
+		holdNotice(sessionId, notice);
+		return "held";
+	}
+	if (agent.status !== "idle") {
+		agent.inject(notice);
+		return "inject";
+	}
+	if (mode === "wake") {
+		agent.followup(notice);
+		return "followup";
+	}
+	if (mode === "hold") {
+		holdNotice(sessionId, notice);
+		return "held";
+	}
+	return "skipped-idle";
+}
+var REFUSAL$1 = {
+	"already-paused": "这一场已经是暂停态了",
+	"already-debugging": "这一场本来就在调试中",
+	none: "现在没有调试态",
+	"not-owner": "这场调试不是这个会话的"
+};
+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) {
+			const intent = parseDebugIntent(payload?.intent);
+			if (intent === null) return {
+				ok: false,
+				text: "不认识的意图（只认 pause / resume / stop）"
+			};
+			const store = deps.store();
+			if (store === void 0) return {
+				ok: false,
+				text: "现在没有调试态 —— 没什么可暂停 / 继续 / 结束的"
+			};
+			const at = now();
+			const held = store.live(at);
+			if (held === null) return {
+				ok: false,
+				text: "现在没有调试态 —— 没什么可暂停 / 继续 / 结束的"
+			};
+			const move = intent === "pause" ? store.pause(held.sessionId, at) : intent === "resume" ? store.resume(held.sessionId, at) : store.stop(held.sessionId, at);
+			if (!move.ok) return {
+				ok: false,
+				text: REFUSAL$1[move.code] ?? `按不动：${move.code}`
+			};
+			const notice = deps.notice?.(intent, move.state) ?? debugNotice(intent, move.state);
+			const delivered = deliverDebugNotice(deps.agents(), held.sessionId, notice.message, NOTICE_MODE$1[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())));
+		}
+	};
+}
+//#endregion
+//#region src/modules/panels/model/diy-record-scripts.ts
+var RECORD_KEY = "__dshDiyRecord";
+var RECORD_KEEP_KEY = "__dshDiyRecordKeep";
+var RECORD_OFF_KEY = "__dshDiyRecordOff";
+var RECORD_ARM_SCRIPT = `(() => {
+  const KEY = ${JSON.stringify(RECORD_KEY)};
+  const KEEP = ${JSON.stringify(RECORD_KEEP_KEY)};
+  const OFF = ${JSON.stringify(RECORD_OFF_KEY)};
+  const CAP = ${String(50)};
+  const BODY_MAX = ${String(16384)};
+  const blank = () => ({ phase: 'armed', t0: null, t1: null, href: location.href, dropped: 0, calls: [] });
+  const readKeep = () => {
+    try {
+      const raw = sessionStorage.getItem(KEEP);
+      const parsed = raw === null ? null : JSON.parse(raw);
+      return parsed !== null && typeof parsed === 'object' ? parsed : blank();
+    } catch (error) {
+      return blank();
+    }
+  };
+  const state = window[KEY] !== null && typeof window[KEY] === 'object' ? window[KEY] : readKeep();
+  state.calls = Array.isArray(state.calls) ? state.calls : [];
+  state.phase = typeof state.phase === 'string' ? state.phase : 'armed';
+  window[KEY] = state;
+  const keep = () => {
+    try {
+      sessionStorage.setItem(KEEP, JSON.stringify(state));
+    } catch (error) {}
+  };
+  const slice = (value) => {
+    try {
+      if (value === undefined || value === null || value === '') return '';
+      if (typeof value === 'string') return value.slice(0, BODY_MAX);
+      if (typeof FormData === 'function' && value instanceof FormData) return '[form-data]';
+      if (typeof Blob === 'function' && value instanceof Blob) return '[blob ' + String(value.size) + ']';
+      if (typeof URLSearchParams === 'function' && value instanceof URLSearchParams) return String(value).slice(0, BODY_MAX);
+      const json = JSON.stringify(value);
+      return typeof json === 'string' ? json.slice(0, BODY_MAX) : '';
+    } catch (error) {
+      return '[unprintable]';
+    }
+  };
+  const repaint = () => {
+    if (typeof state.__repaint === 'function') state.__repaint();
+  };
+  const record = (method, url, body, status, ct, response) => {
+    if (state.phase !== 'recording') return;
+    state.calls.push({
+      method: String(method === '' || method === undefined ? 'GET' : method).toUpperCase(),
+      url: String(url === undefined || url === null ? '' : url),
+      body: slice(body === undefined || body === null ? '' : body),
+      status: typeof status === 'number' ? status : 0,
+      ct: String(ct === undefined || ct === null ? '' : ct),
+      response: slice(response === undefined || response === null ? '' : response),
+      at: Date.now(),
+    });
+    if (state.calls.length > CAP) {
+      state.dropped = (typeof state.dropped === 'number' ? state.dropped : 0) + (state.calls.length - CAP);
+      state.calls.splice(0, state.calls.length - CAP);
+    }
+    keep();
+    repaint();
+  };
+  const fresh = typeof window[OFF] !== 'function';
+  if (fresh) {
+    const realFetch = window.fetch;
+    const proto = XMLHttpRequest.prototype;
+    const realOpen = proto.open;
+    const realSend = proto.send;
+    const realBeacon = typeof navigator === 'object' && navigator !== null ? navigator.sendBeacon : undefined;
+    const hasBeacon = typeof realBeacon === 'function';
+    const ctOf = (xhr) => {
+      try {
+        return typeof xhr.getResponseHeader === 'function' ? xhr.getResponseHeader('content-type') || '' : '';
+      } catch (error) {
+        return '';
+      }
+    };
+    const textOf = (xhr) => {
+      try {
+        return typeof xhr.responseText === 'string' ? xhr.responseText : '';
+      } catch (error) {
+        return '';
+      }
+    };
+    window.fetch = function () {
+      const args = arguments;
+      const init = args[1] || {};
+      const asked = args[0];
+      const url = typeof asked === 'string' ? asked : asked !== null && typeof asked === 'object' ? asked.url : '';
+      const method = init.method !== undefined ? init.method : asked !== null && typeof asked === 'object' ? asked.method : 'GET';
+      const body = init.body === undefined ? '' : init.body;
+      const done = realFetch.apply(this, args);
+      try {
+        done.then((response) => {
+          try {
+            const ct = response.headers.get('content-type') || '';
+            const clone = response.clone();
+            const target = response.url || url;
+            clone.text().then((text) => record(method, target, body, response.status, ct, text)).catch(() => record(method, target, body, response.status, ct, ''));
+          } catch (error) {}
+        }).catch((error) => {
+          try {
+            record(method, url, body, 0, 'fetch-error', String(error !== null && typeof error === 'object' && error.message !== undefined ? error.message : error));
+          } catch (inner) {}
+        });
+      } catch (error) {}
+      return done;
+    };
+    proto.open = function (method, url) {
+      this.__dshMethod = method;
+      this.__dshUrl = url;
+      return realOpen.apply(this, arguments);
+    };
+    proto.send = function (body) {
+      const xhr = this;
+      if (typeof xhr.__dshLoadEnd === 'function' && typeof xhr.removeEventListener === 'function') {
+        try {
+          xhr.removeEventListener('loadend', xhr.__dshLoadEnd);
+        } catch (error) {}
+      }
+      const onEnd = () => {
+        try {
+          record(xhr.__dshMethod, xhr.__dshUrl, body, xhr.status, ctOf(xhr), textOf(xhr));
+        } catch (error) {}
+      };
+      xhr.__dshLoadEnd = onEnd;
+      xhr.addEventListener('loadend', onEnd);
+      return realSend.apply(this, arguments);
+    };
+    if (hasBeacon) {
+      navigator.sendBeacon = function (url, data) {
+        try {
+          record('POST', url, data === undefined || data === null ? '' : data, 0, 'beacon', '');
+        } catch (error) {}
+        return realBeacon.apply(navigator, arguments);
+      };
+    }
+    const onResize = () => {
+      if (typeof state.barX === 'number' && typeof state.barY === 'number') place(state.barX, state.barY);
+    };
+    window.addEventListener('resize', onResize);
+    window[OFF] = () => {
+      window.fetch = realFetch;
+      proto.open = realOpen;
+      proto.send = realSend;
+      if (hasBeacon) {
+        try {
+          navigator.sendBeacon = realBeacon;
+        } catch (error) {}
+      }
+      if (typeof window.removeEventListener === 'function') {
+        try {
+          window.removeEventListener('resize', onResize);
+        } catch (error) {}
+      }
+    };
+  }
+  let bar = document.getElementById('__dsh-record-bar');
+  const freshBar = bar === null;
+  if (freshBar) {
+    bar = document.createElement('div');
+    bar.id = '__dsh-record-bar';
+    document.documentElement.appendChild(bar);
+  }
+  bar.setAttribute('style', 'position:fixed;z-index:2147483647;right:16px;bottom:16px;display:flex;gap:8px;align-items:center;padding:8px 10px;border-radius:10px;background:#1f2430;color:#fff;box-shadow:0 6px 24px rgba(0,0,0,.35);font:12px/1.5 -apple-system,system-ui,sans-serif');
+  let sheet = document.getElementById('__dsh-record-bar-style');
+  if (sheet === null) {
+    sheet = document.createElement('style');
+    sheet.id = '__dsh-record-bar-style';
+    sheet.textContent = '@keyframes __dshRecordBreath{0%,100%{opacity:1;transform:scale(1)}50%{opacity:.25;transform:scale(.7)}}#__dsh-record-bar .__dsh-record-dot{animation:__dshRecordBreath 1.1s ease-in-out infinite}';
+    const sheetHost = document.head === null || document.head === undefined ? document.documentElement : document.head;
+    sheetHost.appendChild(sheet);
+  }
+  const place = (x, y, width, height) => {
+    const rect = bar.getBoundingClientRect();
+    const w = typeof width === 'number' ? width : rect.width;
+    const h = typeof height === 'number' ? height : rect.height;
+    const maxX = Math.max(0, (window.innerWidth || 0) - w);
+    const maxY = Math.max(0, (window.innerHeight || 0) - h);
+    const left = Math.min(Math.max(0, x), maxX);
+    const top = Math.min(Math.max(0, y), maxY);
+    state.barX = left;
+    state.barY = top;
+    bar.style.right = 'auto';
+    bar.style.bottom = 'auto';
+    bar.style.left = String(left) + 'px';
+    bar.style.top = String(top) + 'px';
+  };
+  const grip = document.createElement('span');
+  grip.setAttribute('role', 'button');
+  grip.setAttribute('tabindex', '0');
+  grip.setAttribute('title', '拖动浮条');
+  grip.setAttribute('aria-label', '拖动浮条');
+  grip.setAttribute('style', 'flex:0 0 auto;width:12px;height:18px;border-radius:3px;cursor:grab;touch-action:none;background-image:radial-gradient(circle,rgba(255,255,255,.5) 1.2px,transparent 1.3px);background-size:6px 6px;background-position:center center');
+  const dot = document.createElement('span');
+  dot.className = '__dsh-record-dot';
+  dot.setAttribute('aria-hidden', 'true');
+  dot.setAttribute('style', 'flex:0 0 auto;display:none;width:8px;height:8px;border-radius:999px;corner-shape:round;background:#ef4444');
+  const label = document.createElement('span');
+  label.setAttribute('style', 'flex:0 0 auto;white-space:nowrap;font-variant-numeric:tabular-nums');
+  const start = document.createElement('button');
+  const end = document.createElement('button');
+  start.type = 'button';
+  start.setAttribute('title', '开始录制');
+  start.setAttribute('aria-label', '开始录制');
+  start.innerHTML = '<svg width="13" height="13" viewBox="0 0 16 16" aria-hidden="true" focusable="false" fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round"><rect x="1.5" y="4" width="9" height="8" rx="2"></rect><path d="M10.5 7.4 14.5 5v6l-4-2.4z"></path></svg>开始';
+  end.type = 'button';
+  end.setAttribute('title', '结束录制');
+  end.setAttribute('aria-label', '结束录制');
+  end.innerHTML = '<svg width="12" height="12" viewBox="0 0 12 12" aria-hidden="true" focusable="false"><rect x="2" y="2" width="8" height="8" rx="1.5" fill="currentColor"></rect></svg>结束';
+  const look = (on) => 'display:inline-flex;align-items:center;gap:4px;height:24px;padding:0 8px;border:0;border-radius:6px;font-size:12px;line-height:1;font-family:inherit;white-space:nowrap;cursor:' + (on ? 'pointer' : 'default') + ';color:#fff;background:' + (on ? '#3b82f6' : '#334155');
+  const paint = () => {
+    const phase = state.phase;
+    label.textContent = (phase === 'recording' ? '录制中 · ' : phase === 'finished' ? '录制完成 · ' : '录制 · 等开始 · ') + String(state.calls.length) + ' 条';
+    dot.style.display = phase === 'recording' ? 'inline-block' : 'none';
+    start.disabled = phase !== 'armed';
+    end.disabled = phase !== 'recording';
+    start.setAttribute('style', look(phase === 'armed'));
+    end.setAttribute('style', look(phase === 'recording'));
+  };
+  state.__repaint = paint;
+  const drag = { on: false, px: 0, py: 0, left: 0, top: 0, w: 0, h: 0 };
+  const drop = () => {
+    if (!drag.on) return;
+    drag.on = false;
+    grip.style.cursor = 'grab';
+    keep();
+  };
+  grip.onpointerdown = (event) => {
+    const rect = bar.getBoundingClientRect();
+    drag.on = true;
+    drag.px = event.clientX;
+    drag.py = event.clientY;
+    drag.left = rect.left;
+    drag.top = rect.top;
+    drag.w = rect.width;
+    drag.h = rect.height;
+    grip.style.cursor = 'grabbing';
+    if (typeof grip.setPointerCapture === 'function') {
+      try {
+        grip.setPointerCapture(event.pointerId);
+      } catch (error) {}
+    }
+    if (typeof event.preventDefault === 'function') event.preventDefault();
+  };
+  grip.onpointermove = (event) => {
+    if (!drag.on) return;
+    place(drag.left + event.clientX - drag.px, drag.top + event.clientY - drag.py, drag.w, drag.h);
+  };
+  grip.onpointerup = drop;
+  grip.onpointercancel = drop;
+  grip.onkeydown = (event) => {
+    const step = event.shiftKey ? 40 : 16;
+    const rect = bar.getBoundingClientRect();
+    const left = event.key === 'ArrowLeft' ? rect.left - step : event.key === 'ArrowRight' ? rect.left + step : rect.left;
+    const top = event.key === 'ArrowUp' ? rect.top - step : event.key === 'ArrowDown' ? rect.top + step : rect.top;
+    if (left === rect.left && top === rect.top) return;
+    place(left, top);
+    keep();
+    if (typeof event.preventDefault === 'function') event.preventDefault();
+  };
+  start.onclick = () => {
+    if (state.phase !== 'armed') return;
+    state.phase = 'recording';
+    state.t0 = Date.now();
+    state.t1 = null;
+    state.href = location.href;
+    state.calls = [];
+    state.dropped = 0;
+    keep();
+    paint();
+  };
+  end.onclick = () => {
+    state.phase = 'finished';
+    state.t1 = Date.now();
+    keep();
+    paint();
+  };
+  bar.textContent = '';
+  bar.appendChild(grip);
+  bar.appendChild(dot);
+  bar.appendChild(label);
+  bar.appendChild(start);
+  bar.appendChild(end);
+  if (typeof state.barX === 'number' && typeof state.barY === 'number') place(state.barX, state.barY);
+  paint();
+  return { ok: true, fresh, phase: state.phase, t0: state.t0 === undefined ? null : state.t0, t1: state.t1 === undefined ? null : state.t1, href: state.href || location.href, size: state.calls.length, dropped: typeof state.dropped === 'number' ? state.dropped : 0 };
+})()`;
+var RECORD_READ_SCRIPT = `(() => {
+  const KEY = ${JSON.stringify(RECORD_KEY)};
+  const KEEP = ${JSON.stringify(RECORD_KEEP_KEY)};
+  let state = window[KEY] !== null && typeof window[KEY] === 'object' ? window[KEY] : null;
+  if (state === null) {
+    try {
+      const raw = sessionStorage.getItem(KEEP);
+      state = raw === null ? null : JSON.parse(raw);
+    } catch (error) {
+      state = null;
+    }
+  }
+  if (state === null || typeof state !== 'object') return { ok: false, code: 'not-armed', phase: 'none', calls: [] };
+  return { ok: true, phase: typeof state.phase === 'string' ? state.phase : 'armed', t0: state.t0 === undefined ? null : state.t0, t1: state.t1 === undefined ? null : state.t1, href: typeof state.href === 'string' ? state.href : '', here: location.href, dropped: typeof state.dropped === 'number' ? state.dropped : 0, calls: Array.isArray(state.calls) ? state.calls : [] };
+})()`;
+var RECORD_STOP_SCRIPT = `(() => {
+  const KEY = ${JSON.stringify(RECORD_KEY)};
+  const KEEP = ${JSON.stringify(RECORD_KEEP_KEY)};
+  const OFF = ${JSON.stringify(RECORD_OFF_KEY)};
+  let state = window[KEY] !== null && typeof window[KEY] === 'object' ? window[KEY] : null;
+  if (state === null) {
+    try {
+      const raw = sessionStorage.getItem(KEEP);
+      state = raw === null ? null : JSON.parse(raw);
+    } catch (error) {
+      state = null;
+    }
+  }
+  let unhooked = 0;
+  if (typeof window[OFF] === 'function') {
+    try {
+      window[OFF]();
+      unhooked = 1;
+    } catch (error) {}
+  }
+  const bar = document.getElementById('__dsh-record-bar');
+  if (bar !== null) bar.remove();
+  const sheet = document.getElementById('__dsh-record-bar-style');
+  if (sheet !== null) sheet.remove();
+  try {
+    delete window[KEY];
+  } catch (error) {
+    window[KEY] = undefined;
+  }
+  try {
+    delete window[OFF];
+  } catch (error) {
+    window[OFF] = undefined;
+  }
+  try {
+    sessionStorage.removeItem(KEEP);
+  } catch (error) {}
+  return { ok: true, unhooked, phase: state !== null && typeof state === 'object' ? state.phase : 'none', t0: state !== null && typeof state === 'object' && state.t0 !== undefined ? state.t0 : null, t1: state !== null && typeof state === 'object' && state.t1 !== undefined ? state.t1 : null, calls: state !== null && typeof state === 'object' && Array.isArray(state.calls) ? state.calls : [], dropped: state !== null && typeof state === 'object' && typeof state.dropped === 'number' ? state.dropped : 0 };
+})()`;
+//#endregion
+//#region src/modules/panels/model/diy-record-capture.ts
+var SEGMENT_SLACK_MS = 1500;
+function parsedOf(line) {
+	const trimmed = line.trim();
+	if (trimmed === "") return null;
+	let parsed;
+	try {
+		parsed = JSON.parse(trimmed);
+	} catch {
+		return null;
+	}
+	return typeof parsed === "object" && parsed !== null && !Array.isArray(parsed) ? parsed : null;
+}
+function plain$1(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value) ? value : {};
+}
+function bodyTextOf(value) {
+	if (typeof value === "string") return value;
+	if (typeof value === "number" || typeof value === "boolean") return String(value);
+	if (typeof value === "object" && value !== null) try {
+		return JSON.stringify(value);
+	} catch {
+		return "";
+	}
+	return "";
+}
+function sizeOf(value) {
+	return typeof value === "number" && Number.isFinite(value) ? value : 0;
+}
+function entryOf(row) {
+	const url = row["url"];
+	const method = row["method"];
+	if (typeof url !== "string" || url === "") return null;
+	if (typeof method !== "string" || method === "") return null;
+	const stamp = typeof row["timestamp"] === "string" ? Date.parse(row["timestamp"]) : NaN;
+	const request = plain$1(row["request"]);
+	const requestBody = bodyTextOf(request["body"]);
+	const responseBody = bodyTextOf(row["body"]);
+	const requestFull = sizeOf(request["body_full_size"]);
+	const responseFull = sizeOf(row["body_full_size"]);
+	return {
+		key: typeof row["key"] === "string" ? row["key"] : "",
+		at: Number.isFinite(stamp) ? stamp : 0,
+		method: method.toUpperCase(),
+		url,
+		status: sizeOf(row["status"]),
+		ct: typeof row["ct"] === "string" ? row["ct"] : "",
+		size: sizeOf(row["size"]),
+		request: requestBody,
+		response: responseBody,
+		requestFullSize: requestFull || requestBody.length,
+		responseFullSize: responseFull || responseBody.length,
+		requestSizeExact: requestFull > 0,
+		responseSizeExact: responseFull > 0,
+		headers: Object.keys(request["headers"] === void 0 ? {} : plain$1(request["headers"])).length === 0 ? "" : bodyTextOf(request["headers"])
+	};
+}
+function richerOf(left, right) {
+	const leftScore = (left.status === 0 ? 0 : 1) + (left.response === "" ? 0 : 1) + (left.ct === "" ? 0 : 1);
+	const best = (right.status === 0 ? 0 : 1) + (right.response === "" ? 0 : 1) + (right.ct === "" ? 0 : 1) > leftScore ? right : left;
+	const other = best === left ? right : left;
+	return {
+		...best,
+		request: best.request === "" ? other.request : best.request,
+		requestFullSize: best.request === "" ? other.requestFullSize : best.requestFullSize,
+		requestSizeExact: best.requestSizeExact || other.requestSizeExact,
+		response: best.response === "" ? other.response : best.response,
+		responseFullSize: best.response === "" ? other.responseFullSize : best.responseFullSize,
+		responseSizeExact: best.responseSizeExact || other.responseSizeExact,
+		headers: best.headers === "" ? other.headers : best.headers
+	};
+}
+function captureEntriesOf(text) {
+	const out = [];
+	const at = /* @__PURE__ */ new Map();
+	const push = (one) => {
+		if (one === null) return;
+		const id = one.key === "" ? `${one.method} ${one.url}@${String(one.at)}` : `${one.key}@${String(one.at)}`;
+		const found = at.get(id);
+		if (found === void 0) {
+			at.set(id, out.length);
+			out.push(one);
+			return;
+		}
+		const kept = out[found];
+		if (kept !== void 0) out[found] = richerOf(kept, one);
+	};
+	for (const line of text.split("\n")) {
+		const row = parsedOf(line);
+		if (row === null) continue;
+		const inside = row["entries"];
+		if (Array.isArray(inside)) {
+			for (const one of inside) push(entryOf(plain$1(one)));
+			continue;
+		}
+		push(entryOf(row));
+	}
+	return out;
+}
+function segmentOf(entries, t0, t1) {
+	if (t0 === null || t1 === null) return {
+		inside: entries,
+		outside: 0
+	};
+	const from = t0 - SEGMENT_SLACK_MS;
+	const to = t1 + SEGMENT_SLACK_MS;
+	const inside = [];
+	let outside = 0;
+	for (const one of entries) if (one.at === 0 || one.at >= from && one.at <= to) inside.push(one);
+	else outside += 1;
+	return {
+		inside,
+		outside
+	};
+}
+function captureCallsOf(entries) {
+	return entries.map((one) => ({
+		key: one.key,
+		method: one.method,
+		url: one.url,
+		body: one.request,
+		status: one.status,
+		ct: one.ct,
+		response: one.response,
+		at: one.at,
+		source: "capture"
+	}));
+}
+function callKeyOf(one) {
+	return `${one.method} ${one.url}`;
+}
+function mergeCalls(hook, captured) {
+	const out = [...hook];
+	const hooks = hook.length;
+	const claimed = /* @__PURE__ */ new Set();
+	for (const one of captured) {
+		const key = callKeyOf(one);
+		let found = -1;
+		for (let index = 0; index < hooks; index += 1) {
+			if (claimed.has(index)) continue;
+			const kept = out[index];
+			if (kept === void 0 || callKeyOf(kept) !== key) continue;
+			if (kept.key !== "" && kept.key !== one.key) continue;
+			found = index;
+			break;
+		}
+		if (found === -1) {
+			out.push(one);
+			continue;
+		}
+		claimed.add(found);
+		const kept = out[found];
+		if (kept === void 0) continue;
+		out[found] = {
+			...kept,
+			key: kept.key === "" ? one.key : kept.key,
+			body: kept.body === "" ? one.body : kept.body,
+			response: kept.response === "" ? one.response : kept.response
+		};
+	}
+	return out.sort((left, right) => left.at - right.at);
+}
+function matchKey(one, want) {
+	if (one.key === want) return true;
+	const bare = want.replace(/#\d+$/, "");
+	if (one.key.replace(/#\d+$/, "") === bare) return true;
+	return callKeyOf(one) === bare;
+}
+function pickAllOf(entries, key) {
+	const want = key.trim();
+	if (want === "") return [];
+	const exact = entries.filter((one) => one.key === want);
+	if (exact.length > 0) return exact;
+	return entries.filter((one) => matchKey(one, want));
+}
+function pickOf(entries, key, at = null) {
+	const found = pickAllOf(entries, key);
+	const first = found[0];
+	if (first === void 0) return null;
+	if (at === null) return first;
+	let best = first;
+	for (const one of found) if (Math.abs(one.at - at) < Math.abs(best.at - at)) best = one;
+	return best;
+}
+//#endregion
+//#region src/modules/panels/model/diy-record-text.ts
+var CALLS_SHOWN = 12;
+function recordPageOf(payload) {
+	const raw = payload ?? {};
+	const calls = [];
+	const rows = Array.isArray(raw["calls"]) ? raw["calls"] : [];
+	for (const one of rows) {
+		if (typeof one !== "object" || one === null) continue;
+		const row = one;
+		calls.push({
+			key: "",
+			method: typeof row["method"] === "string" ? row["method"] : "",
+			url: typeof row["url"] === "string" ? row["url"] : "",
+			body: typeof row["body"] === "string" ? row["body"] : "",
+			status: typeof row["status"] === "number" ? row["status"] : 0,
+			ct: typeof row["ct"] === "string" ? row["ct"] : "",
+			response: typeof row["response"] === "string" ? row["response"] : "",
+			at: typeof row["at"] === "number" ? row["at"] : 0,
+			source: "hook"
+		});
+	}
+	const phase = typeof raw["phase"] === "string" ? raw["phase"] : "none";
+	return {
+		ok: raw["ok"] === true,
+		code: typeof raw["code"] === "string" ? raw["code"] : "",
+		phase,
+		t0: typeof raw["t0"] === "number" ? raw["t0"] : null,
+		t1: typeof raw["t1"] === "number" ? raw["t1"] : null,
+		href: typeof raw["href"] === "string" ? raw["href"] : "",
+		here: typeof raw["here"] === "string" ? raw["here"] : "",
+		dropped: typeof raw["dropped"] === "number" ? raw["dropped"] : 0,
+		unhooked: raw["unhooked"] === 1 || raw["unhooked"] === true,
+		calls
+	};
+}
+function filterTextOf(expect) {
+	const want = expect;
+	if (want === null || want.method === "" && want.urlContains === "") return "";
+	const parts = [];
+	if (want.method !== "") parts.push(want.method);
+	if (want.urlContains !== "") parts.push(`url 含 ${want.urlContains}`);
+	return parts.join(" · ");
+}
+function probeCommandOf(calls) {
+	const pick = calls.find((one) => one.body !== "");
+	if (pick === void 0) return "";
+	return `${pick.method} ${pick.url}\n${pick.body.slice(0, 400)}`;
+}
+function bodyMissingOf(calls) {
+	return calls.length > 0 && calls.every((one) => one.body === "");
+}
+function recordRefusalText(code, held) {
+	switch (code) {
+		case "held-by-other": return `另一场录制还占着（${held === void 0 ? "另一个会话" : held.sessionId}）—— 一台机器同时只允许一场：让它先 ${DIY_RECORD_STOP_TOOL}，或等它收工。`;
+		case "already-held": return `你这个会话已经持有一场录制（${held === void 0 ? "" : `${held.unit}，${held.phase}`}）—— 要换目标先 ${DIY_RECORD_STOP_TOOL}；上一场录完了就再录一段（同一场不用重新审批）。`;
+		case "not-owner": return "这一场录制不是你这个会话的 —— 谁开的谁收工。";
+		case "none": return "现在没有录制中的那一场。";
+		case "already-recording": return "已经在录了 —— 请他按「结束录制」，再调这一次。";
+		case "not-armed": return "这一场已经录完了 —— 要再录一段就先起一段新的（同一场不用重新审批）。";
+		case "not-recording": return "还没开始录（他还没按「开始录制」）—— 先请他按开始。";
+		case "not-finished": return "这一场还没录完 —— 等他按「结束录制」再起下一段。";
+	}
+}
+function recordMissingText() {
+	return `现在没有录制中的那一场（${DIY_RECORD_PREPARE_TOOL} 起的那一场可能已经过期或收工了）—— 先调 ${DIY_RECORD_PREPARE_TOOL}。`;
+}
+function recordTalkOf() {
+	return "已开始录制";
+}
+function noFilter(expect) {
+	return expect === null || expect.method === "" && expect.urlContains === "";
+}
+function matchesExpect(one, expect) {
+	if (noFilter(expect)) return false;
+	const want = expect;
+	if (want.method !== "" && one.method !== want.method) return false;
+	if (want.urlContains !== "" && !one.url.includes(want.urlContains)) return false;
+	return true;
+}
+function listRowsOf(calls, expect) {
+	return calls.map((one, index) => {
+		const hasRequest = one.body !== "";
+		const hasResponse = one.response !== "";
+		const likelyWrite = one.method !== "GET" || hasRequest;
+		return {
+			index,
+			key: one.key,
+			at: one.at,
+			method: one.method,
+			url: one.url,
+			status: one.status,
+			ct: one.ct,
+			size: one.response.length === 0 ? 0 : one.response.length,
+			source: one.source,
+			hasRequest,
+			hasResponse,
+			likelyWrite,
+			marked: matchesExpect(one, expect) || noFilter(expect) && likelyWrite
+		};
+	}).slice().sort((left, right) => Number(right.marked) - Number(left.marked) || left.at - right.at).map((one, index) => ({
+		...one,
+		index
+	}));
+}
+function sizeText(bytes) {
+	if (bytes <= 0) return "无";
+	if (bytes < 1024) return `${String(bytes)} B`;
+	return `${(bytes / 1024).toFixed(1)} KB`;
+}
+function rowTextOf(one) {
+	const mark = one.marked ? " ⭐" : "  ";
+	const where = one.source === "capture" ? "捕获" : "钩子";
+	return `· [${String(one.index)}]${mark} ${one.method} ${one.url}（${where} · 入参 ${one.hasRequest ? "有" : "无"} · 出参 ${sizeText(one.size)}）`;
+}
+function renderRecordRead(input) {
+	if (!input.armed) return `那一页上还没有录制条（${DIY_RECORD_PREPARE_TOOL} 起的那一场可能被导航冲掉了）—— 先 ${DIY_RECORD_PREPARE_TOOL}，或让他回到那一页再 ${DIY_RECORD_READ_TOOL}。`;
+	if (input.phase === "armed") return "他还没按「开始录制」—— 等他按了再读。";
+	if (input.phase === "recording") return `还在录（页面钩子上已经攒了 ${String(input.hookCaught)} 条）—— 等他按「结束录制」。`;
+	const hook = String(input.hookCaught);
+	const inside = String(input.capturedInSegment);
+	const markShown = input.rows.filter((one) => one.marked).slice(0, CALLS_SHOWN);
+	const restShown = input.rows.filter((one) => !one.marked).slice(-Math.max(0, CALLS_SHOWN - markShown.length));
+	const shown = [...markShown, ...restShown];
+	const lines = [];
+	if (input.rows.length > 0) lines.push(`录完了：这一段一共 ${String(input.merged)} 条请求（页面钩子 ${hook} 条 · 会话捕获落在这个时间段里 ${inside} 条，合并去重后 ${String(input.merged)} 条）。下面 ⭐ 都列上、其余按时间取最近几条：`, ...shown.map(rowTextOf));
+	else lines.push(input.capturedTruncated ? `录完了：这一段（就解析到的那部分而言）一条请求都没抓到（页面钩子 0 条 · 解析到的会话捕获里落在这个时间段里 0 条）—— 但捕获文件被截过，见下一行。` : "录完了：这一段一条请求都没抓到（页面钩子 0 条 · 会话捕获落在这个时间段里 0 条，两边都是 0 —— 不是筛掉的）。");
+	if (input.capturedTruncated) lines.push(input.capturedTotalLines > input.capturedTailLimit ? `（捕获文件这一场一共落了 ${String(input.capturedTotalLines)} 行，这里只解析了最后 ${String(input.capturedTailLimit)} 行 —— 更早的没看；上面那几个"有几条 / 没落"的捕获数只对最后这段成立）` : `（捕获文件这一场一共落了 ${String(input.capturedTotalLines)} 行（没顶到 ${String(input.capturedTailLimit)} 行那顶帽），是**这一读本身被输出上限截了** —— 读到的只是最近一段，上面那几个捕获数只对读到的这段成立）`);
+	if (input.dropped > 0) lines.push(`（缓冲区满了，最早丢了 ${String(input.dropped)} 条）`);
+	if (input.captureRound === "fail") lines.push("（会话捕获最近一轮没跑成（opencli 那条报了错）—— 这一场可能只有页面钩子。）");
+	else if (input.captureRound === "") lines.push("（会话捕获还没回过一轮 —— 再等一拍再看，别急着下\"没抓到\"的结论。）");
+	if (input.capturedLines === 0 && !input.capturedTruncated) lines.push("（opencli 那条会话捕获一条都没落 —— 这次只有页面钩子。请求体抓不到时请他打开 DevTools 把那次请求复制成 curl）");
+	if (input.nav) lines.push("（这一段里那一页导航过 —— 浮条重新注入过，导航前的那几条可能不在）");
+	return lines.join("\n");
+}
+function clip(text, maxBytes) {
+	if (maxBytes <= 0 || text.length <= maxBytes) return {
+		text,
+		cut: false
+	};
+	return {
+		text: text.slice(0, maxBytes),
+		cut: true
+	};
+}
+function sizeLabel(size, exact) {
+	return exact ? `${String(size)} 字节` : `${String(size)} 字符（opencli 没给 body_full_size，按字符数算）`;
+}
+function renderRecordDetail(input) {
+	if (!input.found) return [`没找到这一条：${input.note}`, `可用的取法：② 还在这场录制里时用清单里的 key 或 index；③ 这一场已经收工的话，给 unit 让我去读 shots/rec-<unit>.jsonl.last；④ 都不行就让他打开 DevTools，把那次请求复制成 curl。`].join("\n");
+	const req = clip(input.request, input.maxBytes);
+	const res = clip(input.response, input.maxBytes);
+	const status = input.status === 0 ? "回包还没到（status 0）" : String(input.status);
+	const lines = [`${input.method} ${input.url} · ${status}${input.ct === "" ? "" : ` · ${input.ct}`}`, `（${input.where} · ${new Date(input.at).toISOString()}）`];
+	lines.push(req.text === "" ? "入参（request body）：没有" : `入参（request body，原长 ${sizeLabel(input.requestFullSize, input.requestSizeExact)}${req.cut ? `，这里截到 ${String(input.maxBytes)}` : ""}）：\n${req.text}`);
+	lines.push(res.text === "" ? "出参（response body）：没有" : `出参（response body，原长 ${sizeLabel(input.responseFullSize, input.responseSizeExact)}${res.cut ? `，这里截到 ${String(input.maxBytes)}` : ""}）：\n${res.text}`);
+	if (input.headers !== "") lines.push(`请求头（可能含凭据 —— 别落进 design.json）：${input.headers}`);
+	if (input.ambiguous > 1) lines.push(`（这个 key 在这一场的原文里出现 ${String(input.ambiguous)} 次 —— 跨轮会重名；带上清单里那一行的 at 才钉得住是哪一次。）`);
+	if (input.note !== "") lines.push(`（${input.note}）`);
+	return lines.join("\n");
+}
+function moveOrThrow(move, held) {
+	if (move.ok) return move.state;
+	throw new Error(recordRefusalText(move.code, held ?? void 0));
+}
+function plain(value) {
+	return typeof value === "object" && value !== null ? value : {};
+}
+function domainOf(url) {
+	try {
+		const host = new URL(url).hostname.toLowerCase();
+		return host.startsWith("www.") ? host.slice(4) : host;
+	} catch {
+		return "";
+	}
+}
+function readDomainsOf(design) {
+	const root = plain(design);
+	const many = root["reads"];
+	const one = root["datasource"];
+	const rows = Array.isArray(many) ? many : one === void 0 ? [] : [one];
+	const found = /* @__PURE__ */ new Set();
+	for (const row of rows) {
+		const read = plain(row)["read"];
+		if (typeof read !== "string") continue;
+		for (const match of read.matchAll(/https?:\/\/[^\s"'`)\\]+/g)) {
+			const domain = domainOf(match[0]);
+			if (domain !== "") found.add(domain);
+		}
+	}
+	return [...found];
+}
+//#endregion
+//#region src/modules/panels/model/diy-record.ts
+var OPEN_TIMEOUT_MS = 3e4;
+var START_TIMEOUT_MS = 8e3;
+var SETTLE_MS = 2e3;
+var WAIT_CAP_MS = 9e5;
+var POLL_MS = 1e3;
+var CAPTURE_TAIL_LINES = 2e4;
+var CAPTURE_POLL_S = 3;
+var CAPTURE_ARM_S = 2;
+var STATIC_URL_PATTERN = "^(data:)|(\\.(js|css|png|jpe?g|gif|svg|woff2?|ico|map|webp|mp4)(\\?|$))";
+var RECORD_WATCH_MS = 3e3;
+var RECORD_WATCH_TRIES = 5;
+var DROP_STATIC_JS = "let s=\"\";process.stdin.on(\"data\",(d)=>s+=d).on(\"end\",()=>{const re=new RegExp(process.argv[1],\"i\");for(const line of s.split(\"\\n\")){const t=line.trim();if(t===\"\")continue;let one;try{one=JSON.parse(t)}catch{process.stdout.write(t+\"\\n\");continue}if(Array.isArray(one.entries)){one.entries=one.entries.filter((e)=>!re.test(String((e||{}).url||\"\")));if(one.entries.length===0)continue}process.stdout.write(JSON.stringify(one)+\"\\n\")}});";
+var DETAIL_MAX_BYTES = 6e4;
+var HOST_PID = String(process.pid);
+var pauseFor = (ms) => new Promise((resolve) => {
+	setTimeout(resolve, ms);
+});
+function waitOf(value) {
+	return Math.min(Math.max(typeof value === "number" && Number.isFinite(value) ? Math.floor(value) : 0, 0), WAIT_CAP_MS);
+}
+function foreignDomainText(design, url) {
+	const known = readDomainsOf(design);
+	if (known.length === 0) return "";
+	const domain = domainOf(url);
+	if (domain === "" || known.includes(domain)) return "";
+	return `这一页（${domain}）跟这个模块已经探明的读源（${known.join(" / ")}）不是一个域 —— 录下来的请求原文是要留在工坊里的，不许跨域录。换成它那个域的页面，或者先把这个模块的读源说清。`;
+}
+function captureFileOf(packagesDir, unit) {
+	return join(dirname(packagesDir), "shots", `rec-${unit}.jsonl`);
+}
+function lastCaptureFileOf(file) {
+	return `${file}.last`;
+}
+async function startRecordCapture(shell, command, session, file) {
+	const bin = command === "" ? "opencli" : command;
+	const arm = backgroundLine(bin, [
+		"browser",
+		session,
+		"network",
+		"--follow",
+		"--all",
+		"--window",
+		"background"
+	]);
+	const snap = backgroundLine(bin, [
+		"browser",
+		session,
+		"network",
+		"--all",
+		"--raw",
+		"--window",
+		"background"
+	]);
+	return (await runShell(shell, [
+		`f=${quoteShellArg(file)}`,
+		`r=${quoteShellArg(`${file}.round`)}`,
+		": > \"$f\"",
+		"rm -f \"$f.last\" \"$f.first\" \"$r\"",
+		`( ${arm} >> "$f" 2>/dev/null & p=$!; sleep ${String(CAPTURE_ARM_S)}; kill "$p" 2>/dev/null )`,
+		`( while kill -0 ${HOST_PID} 2>/dev/null; do if ${snap} > "$r" 2>/dev/null; then printf ok > "$f.first"; else printf fail > "$f.first"; fi; if [ -s "$r" ]; then if command -v node >/dev/null 2>&1; then tr -d '\\n' < "$r" | node -e ${quoteShellArg(DROP_STATIC_JS)} ${quoteShellArg(STATIC_URL_PATTERN)} >> "$f"; else tr -d '\\n' < "$r" >> "$f"; printf '\\n' >> "$f"; fi; fi; rm -f "$r"; sleep ${String(CAPTURE_POLL_S)}; done & echo $! > "$f.pid" ) & echo $! > "$f.reaper"`,
+		"kill -0 \"$(cat \"$f.pid\" 2>/dev/null)\" 2>/dev/null"
+	].join("; "), { timeoutMs: START_TIMEOUT_MS })).exitCode === 0;
+}
+async function releaseLeftoversOf(input) {
+	await releaseQuietly({
+		shell: input.shell,
+		command: input.command,
+		session: BROWSER_RECORD_SESSION,
+		url: input.url,
+		captureFile: input.captureFile
+	});
+}
+async function watchFinishStepOf(input) {
+	const live = input.store.live(Date.now());
+	if (live === null) {
+		await releaseLeftoversOf(input);
+		return {
+			stop: true,
+			delivered: false
+		};
+	}
+	if (live.sessionId !== input.sessionId) return {
+		stop: true,
+		delivered: false
+	};
+	if (live.phase === "finished") return {
+		stop: false,
+		delivered: false
+	};
+	let page;
+	try {
+		page = recordPageOf((await actBrowser(input.shell, input.command, BROWSER_RECORD_SESSION, ["eval", RECORD_READ_SCRIPT])).payload);
+	} catch {
+		return {
+			stop: false,
+			delivered: false
+		};
+	}
+	const held = input.store.live(Date.now());
+	if (held === null) {
+		await releaseLeftoversOf(input);
+		return {
+			stop: true,
+			delivered: false
+		};
+	}
+	if (held.sessionId !== input.sessionId) return {
+		stop: true,
+		delivered: false
+	};
+	if (held.phase === "finished") return {
+		stop: false,
+		delivered: false
+	};
+	if (!page.ok) return {
+		stop: false,
+		delivered: false
+	};
+	if (page.phase === "finished" && page.t1 !== null) {
+		const now = Date.now();
+		if (held.phase === "recording") input.store.finished(input.sessionId, page.t1, now);
+		const caught = page.calls.length;
+		const summary = `工作台 DIY：他按了「结束录制」（${String(caught)} 条）`;
+		deliverDebugNotice(input.ctx.get("agents"), input.sessionId, noticeMessage(`他按了「结束录制」（页面钩子上 ${String(caught)} 条）—— 去 ${DIY_RECORD_READ_TOOL} 取这一段清单，要某一条原文用 ${DIY_RECORD_DETAIL_TOOL}。`, summary), "wake");
+		return {
+			stop: false,
+			delivered: true
+		};
+	}
+	if (page.phase === "recording" && page.t0 !== null && held.phase === "armed") input.store.started(input.sessionId, page.t0, Date.now());
+	return {
+		stop: false,
+		delivered: false
+	};
+}
+function watchRecordFinish(input) {
+	let misses = 0;
+	const tick = () => {
+		watchFinishStepOf(input).then((out) => {
+			misses = 0;
+			if (!out.stop) setTimeout(tick, RECORD_WATCH_MS);
+		}).catch(() => {
+			misses += 1;
+			if (misses < RECORD_WATCH_TRIES) setTimeout(tick, RECORD_WATCH_MS);
+		});
+	};
+	setTimeout(tick, RECORD_WATCH_MS);
+}
+async function captureLinesOf(shell, file, timeoutMs = START_TIMEOUT_MS) {
+	const step = await runShell(shell, `wc -l < ${quoteShellArg(file)} 2>/dev/null || echo 0`, { timeoutMs });
+	const value = Number.parseInt(step.stdout.trim() === "" ? "0" : step.stdout.trim(), 10);
+	return Number.isFinite(value) ? value : 0;
+}
+async function captureRoundOf(shell, file, timeoutMs = START_TIMEOUT_MS) {
+	const value = (await runShell(shell, `cat ${quoteShellArg(`${file}.first`)} 2>/dev/null || true`, { timeoutMs })).stdout.trim();
+	return value === "ok" || value === "fail" ? value : "";
+}
+async function captureTextOf(shell, file, timeoutMs = START_TIMEOUT_MS) {
+	const step = await runShell(shell, `tail -n ${String(CAPTURE_TAIL_LINES)} ${quoteShellArg(file)} 2>/dev/null || true`, { timeoutMs });
+	return {
+		text: step.stdout,
+		truncated: step.truncated
+	};
+}
+async function captureReadOf(shell, file, timeoutMs = START_TIMEOUT_MS) {
+	const totalLines = await captureLinesOf(shell, file, timeoutMs);
+	const read = await captureTextOf(shell, file, timeoutMs);
+	const round = await captureRoundOf(shell, file, timeoutMs);
+	return {
+		text: read.text,
+		totalLines,
+		tailLimit: CAPTURE_TAIL_LINES,
+		truncated: read.truncated || totalLines > CAPTURE_TAIL_LINES,
+		round
+	};
+}
+async function keepCaptureOf(shell, file, timeoutMs = START_TIMEOUT_MS) {
+	return (await runShell(shell, `[ -f ${quoteShellArg(file)} ] && mv ${quoteShellArg(file)} ${quoteShellArg(lastCaptureFileOf(file))} && [ -s ${quoteShellArg(lastCaptureFileOf(file))} ]`, { timeoutMs })).exitCode === 0;
+}
+async function captureLinesWithKeyOf(shell, file, key, timeoutMs = START_TIMEOUT_MS) {
+	const quoted = quoteShellArg(file);
+	const compact = quoteShellArg(`"key":"${key}"`);
+	const spaced = quoteShellArg(`"key": "${key}"`);
+	return (await runShell(shell, [`[ -f ${quoted} ] || exit 0`, `grep -m 20 -F ${compact} ${quoted} 2>/dev/null || grep -m 20 -F ${spaced} ${quoted} 2>/dev/null || true`].join("; "), { timeoutMs })).stdout;
+}
+function bundleOf(capture, page, state) {
+	const entries = captureEntriesOf(capture.text);
+	const segment = segmentOf(entries, page.t0 ?? state.t0, page.t1 ?? state.t1);
+	const merged = mergeCalls(page.calls, captureCallsOf(segment.inside));
+	return {
+		capture,
+		entries,
+		inside: segment.inside,
+		outside: segment.outside,
+		merged,
+		rows: listRowsOf(merged, state.expect)
+	};
+}
+function hookCallOf(page, key) {
+	const want = key.trim();
+	const bare = want.replace(/#\d+$/, "");
+	for (const one of page.calls) {
+		if (one.key !== "" && one.key === want) return one;
+		if (`${one.method} ${one.url}` === bare) return one;
+	}
+	return null;
+}
+var DETAIL_WHERE_CAPTURE = "会话捕获（浏览器那一层，快照原文）";
+var DETAIL_WHERE_HOOK = "页面钩子（这一段）";
+function detailFactsOf(input) {
+	return plainJson({
+		ok: true,
+		found: true,
+		key: input.key,
+		method: input.method,
+		url: input.url,
+		status: input.status,
+		ct: input.ct,
+		at: input.at,
+		request: input.request,
+		response: input.response,
+		headers: input.headers,
+		requestFullSize: input.requestFullSize,
+		responseFullSize: input.responseFullSize,
+		requestSizeExact: input.requestSizeExact,
+		responseSizeExact: input.responseSizeExact,
+		ambiguous: input.ambiguous,
+		source: input.source,
+		text: renderRecordDetail({
+			found: true,
+			where: input.where,
+			method: input.method,
+			url: input.url,
+			status: input.status,
+			ct: input.ct,
+			at: input.at,
+			request: input.request,
+			response: input.response,
+			headers: input.headers,
+			requestFullSize: input.requestFullSize,
+			responseFullSize: input.responseFullSize,
+			requestSizeExact: input.requestSizeExact,
+			responseSizeExact: input.responseSizeExact,
+			ambiguous: input.ambiguous,
+			source: input.source,
+			maxBytes: input.maxBytes,
+			note: ""
+		})
+	});
+}
+function detailOfEntry(entry, maxBytes, ambiguous = 1) {
+	return detailFactsOf({
+		where: DETAIL_WHERE_CAPTURE,
+		key: entry.key,
+		method: entry.method,
+		url: entry.url,
+		status: entry.status,
+		ct: entry.ct,
+		at: entry.at,
+		request: entry.request,
+		response: entry.response,
+		headers: entry.headers,
+		requestFullSize: entry.requestFullSize,
+		responseFullSize: entry.responseFullSize,
+		requestSizeExact: entry.requestSizeExact,
+		responseSizeExact: entry.responseSizeExact,
+		ambiguous,
+		source: "capture",
+		maxBytes
+	});
+}
+function detailOfCall(call, maxBytes) {
+	return detailFactsOf({
+		where: DETAIL_WHERE_HOOK,
+		key: call.key,
+		method: call.method,
+		url: call.url,
+		status: call.status,
+		ct: call.ct,
+		at: call.at,
+		request: call.body,
+		response: call.response,
+		headers: "",
+		requestFullSize: call.body.length,
+		responseFullSize: call.response.length,
+		requestSizeExact: false,
+		responseSizeExact: false,
+		ambiguous: 0,
+		source: "hook",
+		maxBytes
+	});
+}
+function tabsOf(raw) {
+	const start = raw.indexOf("[");
+	const end = raw.lastIndexOf("]");
+	if (start === -1 || end <= start) return [];
+	try {
+		const parsed = JSON.parse(raw.slice(start, end + 1));
+		if (!Array.isArray(parsed)) return [];
+		return parsed.filter((one) => typeof one === "object" && one !== null);
+	} catch {
+		return [];
+	}
+}
+async function closeRecordTab(shell, command, session, url) {
+	const pages = tabsOf((await actBrowser(shell, command, session, ["tab", "list"])).stdout);
+	const pick = pages.find((one) => typeof one["url"] === "string" && one["url"] === url) ?? pages[0];
+	const page = pick === void 0 ? "" : typeof pick["page"] === "string" ? pick["page"] : "";
+	if (page !== "") {
+		if ((await actBrowser(shell, command, session, [
+			"tab",
+			"close",
+			page
+		])).ok) return true;
+	}
+	return (await actBrowser(shell, command, session, ["close"])).ok;
+}
+async function releaseRecord(input) {
+	const capture = await stopNetworkExact(input.shell, input.captureFile);
+	return {
+		tab: await closeRecordTab(input.shell, input.command, input.session, input.url),
+		capture
+	};
+}
+async function releaseQuietly(input) {
+	try {
+		return await releaseRecord(input);
+	} catch {
+		return {
+			tab: false,
+			capture: false
+		};
+	}
+}
+//#endregion
+//#region src/modules/panels/model/diy-record-tools.ts
+function registerRecordTools(ctx, store) {
+	const tools = ctx.get("tools");
+	if (tools === void 0) {
+		ctx.logger?.info?.("[dsh-workbench] 没有 tools 服务，跳过录制交接工具注册");
+		return [];
+	}
+	const prepareTool = {
+		name: DIY_RECORD_PREPARE_TOOL,
+		description: `开一扇浏览器窗口并顶到最前，让他自己录一次真实的写（开窗要点头一次）；他按开始/结束后用 ${DIY_RECORD_READ_TOOL} 取那一段、${DIY_RECORD_STOP_TOOL} 收工。`,
+		parameters: {
+			type: "object",
+			properties: {
+				unit: {
+					type: "string",
+					description: "工坊里的 unit（workbench_diy_list 会给）。"
+				},
+				url: {
+					type: "string",
+					description: "那一页（他平时看这套系统的入口；与已探明的读源同 domain）。"
+				},
+				doing: {
+					type: "string",
+					description: "那一下叫什么，例：发布 / 提交（不是多路复用：这把工具只做录制这一件事）。"
+				},
+				expect: {
+					type: "object",
+					properties: {
+						method: {
+							type: "string",
+							description: "想抓的那条的 HTTP 方法，例 POST（不填就按\"像写的那几条\"挑）。"
+						},
+						urlContains: {
+							type: "string",
+							description: "URL 里必须含的片段（不填就不筛）。"
+						}
+					},
+					additionalProperties: false,
+					description: "可选：你想抓的那条长什么样。"
+				}
+			},
+			required: [
+				"unit",
+				"url",
+				"doing"
+			],
+			additionalProperties: false
+		},
+		output: OUTPUT$2,
+		async execute(raw, exec) {
+			const { packagesDir, workspace } = workshopOf(ctx, exec);
+			const args = asRecord$3(raw);
+			const unit = asText$1(args["unit"]);
+			const modules = modulesOf(ctx, packagesDir).modules;
+			if (unit === "") throw new Error(`要一个 unit（工坊里：${modules.map((one) => one.unit).join(", ") || "（空）"}）`);
+			const found = modules.find((one) => one.unit === unit);
+			if (found === void 0) throw new Error(`工坊里没有单元 id 为「${unit}」的模块（可用的：${modules.map((one) => one.unit).join(", ") || "（空）"}）`);
+			const url = asText$1(args["url"]);
+			if (url === "") throw new Error("要那一页的 url（他平时看这套系统的入口；先用 workbench_diy_recon 或问他\"你平时在哪看这个\"）—— 我不猜是哪个站点。");
+			const foreign = foreignDomainText(readDesignOfModule(found.dir), url);
+			if (foreign !== "") throw new Error(foreign);
+			const doing = asText$1(args["doing"]);
+			const rawExpect = asRecord$3(args["expect"]);
+			const method = asText$1(rawExpect["method"]).toUpperCase();
+			const urlContains = asText$1(rawExpect["urlContains"]);
+			const expect = method === "" && urlContains === "" ? null : {
+				method,
+				urlContains
+			};
+			const shell = ctx.get("shell");
+			if (shell === void 0) throw new Error("这台机器上没有 shell 服务，开不了录制窗");
+			const command = opencliCommandOf(ctx).command;
+			const sessionId = sessionIdOf(exec) ?? "";
+			const held = store.live(Date.now());
+			const captureFile = captureFileOf(packagesDir, unit);
+			moveOrThrow(store.begin({
+				sessionId,
+				workspace: workspace ?? "",
+				unit,
+				name: found.name,
+				url,
+				title: "",
+				action: doing,
+				expect,
+				captureFile,
+				now: Date.now()
+			}), held);
+			try {
+				const opened = await runBrowserStep(shell, command, [
+					"browser",
+					BROWSER_RECORD_SESSION,
+					"tab",
+					"new",
+					url,
+					"--window",
+					"foreground"
+				], OPEN_TIMEOUT_MS);
+				if (!opened.ok) throw new Error(`开不了录制窗：${opened.stderr || opened.stdout || "opencli 报了个错"}。先让用户把工作台那一页切到前台（第一次要这样），或跑 opencli doctor 看扩展连没连上。`);
+				await runBrowserStep(shell, command, [
+					"browser",
+					BROWSER_RECORD_SESSION,
+					"wait",
+					"time",
+					String(SETTLE_MS / 1e3)
+				], OPEN_TIMEOUT_MS);
+				const armed = await actBrowser(shell, command, BROWSER_RECORD_SESSION, ["eval", RECORD_ARM_SCRIPT]);
+				const page = recordPageOf(armed.payload);
+				if (!armed.ok || !page.ok) throw new Error(`浮条没装上：${armed.stderr || armed.stdout || "那一页还在加载"} —— 等他那一页站稳了再试。`);
+				await stopNetworkExact(shell, captureFile);
+				const capture = await startRecordCapture(shell, command, BROWSER_RECORD_SESSION, captureFile);
+				watchRecordFinish({
+					ctx,
+					shell,
+					command,
+					sessionId,
+					store,
+					url,
+					captureFile
+				});
+				const talk = recordTalkOf();
+				return plainJson({
+					workshop: packagesDir,
+					ok: true,
+					wrote: false,
+					phase: page.phase,
+					site: url,
+					session: BROWSER_RECORD_SESSION,
+					capture,
+					captureFile,
+					size: page.calls.length,
+					talk,
+					text: capture ? talk : `${talk}（opencli 那条捕获没起来 —— 这次只有页面钩子）`
+				});
+			} catch (error) {
+				await releaseQuietly({
+					shell,
+					command,
+					session: BROWSER_RECORD_SESSION,
+					url,
+					captureFile
+				});
+				store.stop(sessionId, Date.now());
+				throw error;
+			}
+		}
+	};
+	const readTool = {
+		name: DIY_RECORD_READ_TOOL,
+		description: "读这一段录到的请求（他按「结束录制」之后用）；没按开始 / 没装钩子都会说清，不假装是\"没有请求\"。",
+		parameters: {
+			type: "object",
+			properties: { waitMs: {
+				type: "integer",
+				description: "可选：阻塞等他按「结束」最多这么久（毫秒，默认 0 = 立刻回；帽 15 分钟）。"
+			} },
+			additionalProperties: false
+		},
+		output: OUTPUT$2,
+		async execute(raw, exec) {
+			const { packagesDir } = workshopOf(ctx, exec);
+			const shell = ctx.get("shell");
+			if (shell === void 0) throw new Error("这台机器上没有 shell 服务，读不了录制");
+			const sessionId = sessionIdOf(exec) ?? "";
+			const held = store.live(Date.now());
+			if (held === null) throw new Error(recordMissingText());
+			if (held.sessionId !== sessionId) moveOrThrow({
+				ok: false,
+				code: "not-owner"
+			}, held);
+			const command = opencliCommandOf(ctx).command;
+			const budget = waitOf(asRecord$3(raw)["waitMs"]);
+			const opened = budget === 0 ? 0 : Date.now();
+			const deadline = opened + budget;
+			const sync = (page) => {
+				if (page.ok && page.phase === "recording" && page.t0 !== null) {
+					if (store.live(Date.now())?.phase === "armed") store.started(sessionId, page.t0, Date.now());
+				}
+				if (page.ok && page.phase === "finished" && page.t1 !== null) {
+					if (store.live(Date.now())?.phase === "armed" && page.t0 !== null) store.started(sessionId, page.t0, Date.now());
+					if (store.live(Date.now())?.phase === "recording") store.finished(sessionId, page.t1, Date.now());
+				}
+			};
+			await actBrowser(shell, command, BROWSER_RECORD_SESSION, ["eval", RECORD_ARM_SCRIPT]);
+			let step = await actBrowser(shell, command, BROWSER_RECORD_SESSION, ["eval", RECORD_READ_SCRIPT]);
+			let page = recordPageOf(step.payload);
+			sync(page);
+			while (budget > 0 && page.phase !== "finished" && Date.now() < deadline) {
+				await pauseFor(Math.min(POLL_MS, Math.max(0, deadline - Date.now())));
+				step = await actBrowser(shell, command, BROWSER_RECORD_SESSION, ["eval", RECORD_READ_SCRIPT]);
+				const next = recordPageOf(step.payload);
+				if (next.ok) page = next;
+				sync(page);
+			}
+			const timedOut = budget > 0 && page.phase !== "finished";
+			const waitedMs = opened === 0 ? 0 : Date.now() - opened;
+			if (timedOut) {
+				const waited = String(Math.round(budget / 1e3));
+				holdNotice(sessionId, noticeMessage(`录制还没结束（等了约 ${waited} 秒）：他按了「结束」再 read 一次。`, `工作台 DIY：录制还没结束（等了约 ${waited} 秒）`));
+			}
+			const state = store.live(Date.now()) ?? held;
+			const capture = await captureReadOf(shell, state.captureFile);
+			const bundle = bundleOf(capture, page, state);
+			const hookCaught = page.calls.length;
+			const nav = page.href !== "" && page.here !== "" && page.href !== page.here;
+			const noBody = bodyMissingOf(bundle.merged);
+			const text = step.ok ? [renderRecordRead({
+				phase: page.phase,
+				armed: page.ok,
+				hookCaught,
+				rows: bundle.rows,
+				merged: bundle.merged.length,
+				capturedLines: bundle.entries.length,
+				capturedInSegment: bundle.inside.length,
+				capturedOutside: bundle.outside,
+				capturedTotalLines: capture.totalLines,
+				capturedTruncated: capture.truncated,
+				capturedTailLimit: capture.tailLimit,
+				dropped: page.dropped,
+				nav,
+				filter: filterTextOf(state.expect),
+				captureRound: bundle.capture.round
+			}), timedOut ? `还在录 —— 等他按「结束」（要等就带 waitMs，帽 ${String(WAIT_CAP_MS / 6e4)} 分钟）。` : ""].filter((one) => one !== "").join("\n") : `读不到那一页上的录制条：${step.stderr || step.stdout || "opencli 报了个错"}`;
+			return plainJson({
+				workshop: packagesDir,
+				ok: step.ok && page.ok,
+				phase: state.phase,
+				t0: state.t0,
+				t1: state.t1,
+				rows: bundle.rows,
+				dropped: page.dropped,
+				captureLines: bundle.entries.length,
+				capturedInSegment: bundle.inside.length,
+				capturedOutside: bundle.outside,
+				capturedTotalLines: capture.totalLines,
+				capturedTruncated: capture.truncated,
+				hookCaught,
+				noBody,
+				nav,
+				waitedMs,
+				timedOut,
+				text
+			});
+		}
+	};
+	const detailTool = {
+		name: DIY_RECORD_DETAIL_TOOL,
+		description: "取录制这一段里某一条请求的原文：入参（request body）与出参（response body）。先用 record_read 拿清单（每条带 key），再用它挑一条 —— 清单不删条，\"那一条\"永远挑得到。",
+		parameters: {
+			type: "object",
+			properties: {
+				key: {
+					type: "string",
+					description: "清单里那一条的 key（原样给，含 #2 这种后缀）。"
+				},
+				index: {
+					type: "integer",
+					description: "清单里的序号（0 起）；只在那一场还开着时可用。"
+				},
+				at: {
+					type: "integer",
+					description: "清单里那一行的 at（毫秒时间戳）：同一个 key 跨轮会重名，带上它才钉得住是哪一次。"
+				},
+				unit: {
+					type: "string",
+					description: "那一场已经收工、只能去读 shots/rec-<unit>.jsonl.last 时给。"
+				},
+				maxBody: {
+					type: "integer",
+					description: `入参 / 出参各自最多回多少字符（默认 ${String(DETAIL_MAX_BYTES)}，0 = 不限）。`
+				}
+			},
+			additionalProperties: false
+		},
 		output: OUTPUT$2,
 		async execute(raw, exec) {
-			const { packagesDir, workspace } = workshopOf(ctx, exec);
-			const found = unitOf(packagesDir, raw, "workbench_diy_install");
-			if (found.installed) {
-				const panel = showOrReason(panels, found.unit, workspace);
-				const text = ["它已经装过了（就是工坊里这一份）—— **不要再装**：改源码 + dsh-wb-module build（宿主侧与 client.js 都秒级热换 —— dsh-client-hmr 盯着每个 bundle 的 lib/client.js，重建了就换进已打开的页面）。", panel.ok ? `面板上已经打开它了（${workspace}）—— 验收就走这一张卡（你自己走一遍）` : `面板上还没打开：${panel.reason}。调 workbench_diy_show（unit=${found.unit}）`].join("\n");
-				return plainJson({
-					workshop: packagesDir,
-					unit: found.unit,
-					path: found.dir,
-					alreadyInstalled: true,
-					panel,
-					text
-				});
+			const { packagesDir } = workshopOf(ctx, exec);
+			const shell = ctx.get("shell");
+			if (shell === void 0) throw new Error("这台机器上没有 shell 服务，取不了详情");
+			const args = asRecord$3(raw);
+			const unit = asText$1(args["unit"]);
+			const askedKey = asText$1(args["key"]).trim();
+			const rawIndex = args["index"];
+			const index = typeof rawIndex === "number" && Number.isFinite(rawIndex) ? Math.floor(rawIndex) : null;
+			const rawAt = args["at"];
+			let at = typeof rawAt === "number" && Number.isFinite(rawAt) ? Math.floor(rawAt) : null;
+			const rawMax = args["maxBody"];
+			const maxBytes = typeof rawMax === "number" && Number.isFinite(rawMax) && rawMax >= 0 ? Math.floor(rawMax) : DETAIL_MAX_BYTES;
+			const sessionId = sessionIdOf(exec) ?? "";
+			const held = store.live(Date.now());
+			if (held !== null && held.sessionId !== sessionId) moveOrThrow({
+				ok: false,
+				code: "not-owner"
+			}, held);
+			const file = held !== null ? held.captureFile : unit === "" ? "" : lastCaptureFileOf(captureFileOf(packagesDir, unit));
+			if (file === "") throw new Error(`这一场录制已经不在了（收工 / 过期 / 不是你这个会话的）—— 要给一个 unit（我去读 shots/rec-<unit>.jsonl.last），或者重新 ${DIY_RECORD_PREPARE_TOOL} 一场。`);
+			const command = opencliCommandOf(ctx).command;
+			let key = askedKey;
+			let page = null;
+			if (key === "") {
+				if (index === null) throw new Error("给一个 key（清单里那一条的）或 index（清单里的序号）。");
+				if (held === null) throw new Error("收工之后只能用 key —— index 是\"那一场清单里\"的序号，这一场已经清掉了。");
+				page = recordPageOf((await actBrowser(shell, command, BROWSER_RECORD_SESSION, ["eval", RECORD_READ_SCRIPT])).payload);
+				const bundle = bundleOf(await captureReadOf(shell, file), page, held);
+				const row = bundle.rows[index];
+				if (row === void 0) throw new Error(`这一段清单里没有第 ${String(index)} 条（一共 ${String(bundle.rows.length)} 条）—— 先 ${DIY_RECORD_READ_TOOL} 拿一份新的清单。`);
+				key = row.key;
+				at = at ?? row.at;
+				if (key === "") {
+					const only = hookCallOf(page, `${row.method} ${row.url}`);
+					if (only !== null) return detailOfCall(only, maxBytes);
+				}
 			}
-			const outcome = await market.installBundle(found.dir);
-			const verdict = verdictOf$1(outcome.change);
-			const restartRequired = outcome.change.application === "restart-required";
-			const panel = outcome.change.application === "applied" ? showOrReason(panels, found.unit, workspace) : {
+			const candidates = pickAllOf(captureEntriesOf(await captureLinesWithKeyOf(shell, file, key)), key);
+			const fromCapture = pickOf(candidates, key, at);
+			if (fromCapture !== null) return detailOfEntry(fromCapture, maxBytes, candidates.length);
+			const call = hookCallOf(page ?? recordPageOf((await actBrowser(shell, command, "workbench-rec", ["eval", RECORD_READ_SCRIPT])).payload), key);
+			if (call !== null) return detailOfCall(call, maxBytes);
+			return plainJson({
+				workshop: packagesDir,
+				ok: true,
+				found: false,
+				key,
+				text: renderRecordDetail({
+					found: false,
+					where: "",
+					method: "",
+					url: "",
+					status: 0,
+					ct: "",
+					at: 0,
+					request: "",
+					response: "",
+					headers: "",
+					requestFullSize: 0,
+					responseFullSize: 0,
+					requestSizeExact: false,
+					responseSizeExact: false,
+					ambiguous: 0,
+					source: "",
+					maxBytes,
+					note: `「${key}」既不在这一场的快照原文（${file}）里，也不在这一页的钩子那一份里`
+				})
+			});
+		}
+	};
+	const stopTool = {
+		name: DIY_RECORD_STOP_TOOL,
+		description: "录制收工：卸浮条、停捕获、收掉那个标签、清状态（不动你的其他标签）。",
+		parameters: {
+			type: "object",
+			properties: {},
+			additionalProperties: false
+		},
+		output: OUTPUT$2,
+		async execute(_raw, exec) {
+			const { packagesDir } = workshopOf(ctx, exec);
+			const shell = ctx.get("shell");
+			if (shell === void 0) throw new Error("这台机器上没有 shell 服务，收不了工");
+			const sessionId = sessionIdOf(exec) ?? "";
+			const held = store.live(Date.now());
+			if (held === null) throw new Error(recordMissingText());
+			if (held.sessionId !== sessionId) moveOrThrow({
 				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 text = [
-				`${verdict}：${found.unit}（${found.name}）`,
-				panelText,
-				"之后只改源码 + dsh-wb-module build（宿主侧与 client.js 都秒级热换 —— dsh-client-hmr 盯着每个 bundle 的 lib/client.js，重建了就换进已打开的页面）：不要再装一遍。"
-			].join("\n");
+				code: "not-owner"
+			}, held);
+			const command = opencliCommandOf(ctx).command;
+			await actBrowser(shell, command, BROWSER_RECORD_SESSION, ["eval", RECORD_ARM_SCRIPT]);
+			const page = recordPageOf((await actBrowser(shell, command, BROWSER_RECORD_SESSION, ["eval", RECORD_STOP_SCRIPT])).payload);
+			const bundle = bundleOf(await captureReadOf(shell, held.captureFile), page, held);
+			const hookCaught = page.calls.length;
+			const noBody = bodyMissingOf(bundle.merged);
+			const kept = await keepCaptureOf(shell, held.captureFile);
+			const cleaned = await releaseQuietly({
+				shell,
+				command,
+				session: BROWSER_RECORD_SESSION,
+				url: held.url,
+				captureFile: held.captureFile
+			});
+			store.stop(sessionId, Date.now());
+			const probeCommand = probeCommandOf(bundle.merged);
+			const lastFile = lastCaptureFileOf(held.captureFile);
 			return plainJson({
 				workshop: packagesDir,
-				unit: found.unit,
-				path: found.dir,
-				install: outcome.change,
-				module: outcome.module,
-				panel,
-				text
+				ok: true,
+				phase: "idle",
+				rows: bundle.rows,
+				lastFile: kept ? lastFile : "",
+				dropped: page.dropped,
+				captureLines: bundle.entries.length,
+				capturedInSegment: bundle.inside.length,
+				capturedOutside: bundle.outside,
+				hookCaught,
+				noBody,
+				probeCommand,
+				cleaned: {
+					...cleaned,
+					hook: page.ok && page.unhooked
+				},
+				text: [
+					`收工了：${held.unit} 的「${held.action}」这一段一共 ${String(bundle.merged.length)} 条请求（页面钩子 ${String(hookCaught)} 条 · 会话捕获这一段 ${String(bundle.inside.length)} 条）。`,
+					kept ? `原文留在 ${lastFile}（下一场 prepare 会清掉它）—— 要再看某一条用 ${DIY_RECORD_DETAIL_TOOL}（给 unit + key；同一个 key 跨轮会重名，再带上清单里那行的 at 就钉住了）。` : "没留下原文（这一场的捕获文件是空的或没起来）—— 要哪一条就让他从 DevTools 复制 curl。",
+					bundle.capture.round === "fail" ? "（会话捕获最近一轮没跑成（opencli 那条报了错）—— 这一场可能只有页面钩子。）" : "",
+					cleaned.tab ? "录制窗那个标签收掉了。" : "那个标签没关掉（他自己关一下）。",
+					cleaned.capture ? "" : "捕获那条没停干净（最多 15 分钟自己收工）。",
+					probeCommand !== "" ? "这段原文可以直接落 design.json 的 writes[].probeCommand。" : noBody ? "只有方法 / URL，body 拿不到 —— 补到 body 再落 writes[].probeCommand；要体就让他从 DevTools 复制 curl，或在他那一页上用 _eval 里的 fetch 打一条同形的（先问过他）。" : "这一段的原文是空的 —— 别硬写进 design.json。",
+					"不许复现这一段（没预览档的写一次就是真的）。"
+				].filter((one) => one !== "").join("\n")
 			});
 		}
 	};
 	return [
-		tools.register(listTool),
-		tools.register(statusTool),
-		tools.register(panelTool),
-		tools.register(reconTool),
-		...registerSpecTool(ctx, tools),
-		tools.register(probeTool),
-		...registerLogTools(ctx, tools),
-		...registerBrowserTools(ctx, tools),
-		...registerDebugTools(ctx, tools, debug),
-		tools.register(showTool),
-		tools.register(installTool)
+		tools.register(prepareTool),
+		tools.register(readTool),
+		tools.register(detailTool),
+		tools.register(stopTool)
 	];
 }
 //#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": () => ({
-		ok: true,
-		state: store.live(Date.now())
-	}) };
-}
-//#endregion
 //#region src/shared/api/host/release.ts
 function parseLedgerVersion(stdout, name) {
 	const parsed = parseJsonLoose(stdout);
@@ -6813,7 +8961,7 @@ function createEnvDropper(options) {
 async function rememberInstalledSource(deps, manager, pkg, registry) {
 	const { registries, logger } = deps;
 	if (registries === void 0 || registry === void 0) return;
-	const scope = scopeOf$1(pkg);
+	const scope = scopeOf$2(pkg);
 	if (scope === null) return;
 	const known = await manager.registries().catch(() => null);
 	if (known !== null && sameRegistry(known.resolved, registry)) return;
@@ -7440,7 +9588,7 @@ function registerMarketTools(ctx, market) {
 		return {
 			name: spec.name,
 			description: spec.description,
-			parameters: withApprovalNote({
+			parameters: {
 				type: "object",
 				properties: { id: {
 					type: "string",
@@ -7448,7 +9596,7 @@ function registerMarketTools(ctx, market) {
 				} },
 				required: ["id"],
 				additionalProperties: false
-			}, { required: true }),
+			},
 			output: OUTPUT$1,
 			async execute(raw) {
 				const id = await idOrList(raw, spec.name);
@@ -7487,7 +9635,7 @@ function registerMarketTools(ctx, market) {
 	const uninstallTool = {
 		name: MODULES_UNINSTALL_TOOL,
 		description: "卸模块：连模块包一起卸（只动工作台运行时）；要换一份实现先卸再装。",
-		parameters: withApprovalNote({
+		parameters: {
 			type: "object",
 			properties: { id: {
 				type: "string",
@@ -7495,7 +9643,7 @@ function registerMarketTools(ctx, market) {
 			} },
 			required: ["id"],
 			additionalProperties: false
-		}, { required: true }),
+		},
 		output: OUTPUT$1,
 		async execute(raw) {
 			const id = await idOrList(raw, MODULES_UNINSTALL_TOOL);
@@ -7510,7 +9658,7 @@ function registerMarketTools(ctx, market) {
 	const installBundleTool = {
 		name: MODULES_INSTALL_BUNDLE_TOOL,
 		description: "按 spec 把模块包装进这份 profile（包名 / git 地址 / tarball / 本地路径）；装完它要的插件也一起装。",
-		parameters: withApprovalNote({
+		parameters: {
 			type: "object",
 			properties: {
 				spec: {
@@ -7524,7 +9672,7 @@ function registerMarketTools(ctx, market) {
 			},
 			required: ["spec"],
 			additionalProperties: false
-		}, { required: true }),
+		},
 		output: OUTPUT$1,
 		async execute(raw) {
 			const spec = textArg(raw, "spec");
@@ -7542,7 +9690,7 @@ function registerMarketTools(ctx, market) {
 	const updateDependencyTool = {
 		name: MODULES_UPDATE_DEPENDENCY_TOOL,
 		description: "升共用依赖（工作台自己那份营生，如 plugin:coding）：只有升级，用依赖 id。",
-		parameters: withApprovalNote({
+		parameters: {
 			type: "object",
 			properties: { id: {
 				type: "string",
@@ -7550,7 +9698,7 @@ function registerMarketTools(ctx, market) {
 			} },
 			required: ["id"],
 			additionalProperties: false
-		}, { required: true }),
+		},
 		output: OUTPUT$1,
 		async execute(raw) {
 			const id = await idOrList(raw, MODULES_UPDATE_DEPENDENCY_TOOL);
@@ -7566,7 +9714,7 @@ function registerMarketTools(ctx, market) {
 		return {
 			name: spec.name,
 			description: spec.description,
-			parameters: withApprovalNote({
+			parameters: {
 				type: "object",
 				properties: { plugin: {
 					type: "string",
@@ -7574,7 +9722,7 @@ function registerMarketTools(ctx, market) {
 				} },
 				required: ["plugin"],
 				additionalProperties: false
-			}, { required: true }),
+			},
 			output: OUTPUT$1,
 			async execute(raw) {
 				const plugin = textArg(raw, "plugin");
@@ -7608,7 +9756,7 @@ function registerMarketTools(ctx, market) {
 	const updateWorkbenchTool = {
 		name: MODULES_UPDATE_WORKBENCH_TOOL,
 		description: "把工作台自己更新到源上的新版（要重启时结果里会说；重启由用户来）。",
-		parameters: withApprovalNote(noParams, { required: true }),
+		parameters: noParams,
 		output: OUTPUT$1,
 		async execute() {
 			const outcome = await market.updateWorkbench("");
@@ -7687,6 +9835,7 @@ function applyPanelsPref(panels, payload) {
 //#region src/modules/panels/model/handoff.ts
 var PANELS_FACT = "panels";
 var DIY_DEBUG_FACT = "diy-debug";
+var DIY_RECORD_FACT = "diy-record";
 var CAPABILITY_FACT = "capability";
 var DEBUG_TOOLS = [
 	DIY_DEBUG_START_TOOL,
@@ -7694,6 +9843,12 @@ var DEBUG_TOOLS = [
 	DIY_DEBUG_RESUME_TOOL,
 	DIY_DEBUG_STOP_TOOL
 ];
+var RECORD_TOOLS = [
+	DIY_RECORD_PREPARE_TOOL,
+	DIY_RECORD_READ_TOOL,
+	DIY_RECORD_DETAIL_TOOL,
+	DIY_RECORD_STOP_TOOL
+];
 var PROVISION_TOOLS = {
 	[MODULES_INSTALL_TOOL]: "install",
 	[MODULES_UPDATE_TOOL]: "update",
@@ -7730,6 +9885,7 @@ function panelsFactsOf(call, manifests) {
 	if (call.source === "workbench_modules_update_workbench") return [PANELS_FACT, CAPABILITY_FACT];
 	if (call.source === "workbench_diy_list") return [PANELS_FACT];
 	if (DEBUG_TOOLS.includes(call.source)) return [DIY_DEBUG_FACT];
+	if (RECORD_TOOLS.includes(call.source)) return [DIY_RECORD_FACT];
 	const request = requestOf(call);
 	if (request === void 0) return void 0;
 	return [
@@ -8066,9 +10222,6 @@ var ID_PARAM = {
 	type: "string",
 	description: "套件 id（如 cmdb）。"
 };
-function noted(parameters) {
-	return withApprovalNote(parameters, { required: true });
-}
 function listed(entries) {
 	return entries.map((entry, index) => `${index + 1}. ${entry.id} · ${entry.shown ? "已启用" : "未启用"}${entry.hasCard ? "" : "（无卡片）"}${entry.source === "user" ? " · 用户改过" : ""}`).join("\n");
 }
@@ -8157,7 +10310,7 @@ function registerPanelTools(ctx, panels, values) {
 	const showTool = {
 		name: PANELS_SHOW_TOOL,
 		description: "这个工作区要它：之前收起的也放回来，卡片与 agent 工具一起上线；那份板上写过\"不要\"的也划掉。",
-		parameters: noted({
+		parameters: {
 			type: "object",
 			properties: {
 				id: ID_PARAM,
@@ -8165,7 +10318,7 @@ function registerPanelTools(ctx, panels, values) {
 			},
 			required: ["id"],
 			additionalProperties: false
-		}),
+		},
 		output: OUTPUT,
 		async execute(raw, exec) {
 			const id = idOf(raw);
@@ -8182,7 +10335,7 @@ function registerPanelTools(ctx, panels, values) {
 	const hideTool = {
 		name: PANELS_HIDE_TOOL,
 		description: "这个工作区明确不要它：卡片与 agent 工具一起下线（机器板上开着的也照样收起）；别的项目不受影响，要放回来用 workbench_panels_show。在机器板上 hide 是写下\"不要\"这一笔，比名单管用。",
-		parameters: noted({
+		parameters: {
 			type: "object",
 			properties: {
 				id: ID_PARAM,
@@ -8190,7 +10343,7 @@ function registerPanelTools(ctx, panels, values) {
 			},
 			required: ["id"],
 			additionalProperties: false
-		}),
+		},
 		output: OUTPUT,
 		async execute(raw, exec) {
 			const id = idOf(raw);
@@ -8207,7 +10360,7 @@ function registerPanelTools(ctx, panels, values) {
 	const moveTool = {
 		name: PANELS_MOVE_TOOL,
 		description: "调顺序：放到最前面（新开一行时排最后）。顺序只属于工作区；机器级默认板上没有顺序一说。",
-		parameters: noted({
+		parameters: {
 			type: "object",
 			properties: {
 				id: ID_PARAM,
@@ -8219,7 +10372,7 @@ function registerPanelTools(ctx, panels, values) {
 			},
 			required: ["id"],
 			additionalProperties: false
-		}),
+		},
 		output: OUTPUT,
 		async execute(raw, exec) {
 			const id = idOf(raw);
@@ -8237,11 +10390,11 @@ function registerPanelTools(ctx, panels, values) {
 	const resetTool = {
 		name: PANELS_RESET_TOOL,
 		description: "清掉这个工作区改过的行（改完全部回到跟着机器级默认板走）；scope=machine 清的是整份机器级默认板。",
-		parameters: noted({
+		parameters: {
 			type: "object",
 			properties: { scope: SCOPE_PARAM },
 			additionalProperties: false
-		}),
+		},
 		output: OUTPUT,
 		async execute(raw, exec) {
 			const scope = scopeOf(raw);
@@ -8256,14 +10409,14 @@ function registerPanelTools(ctx, panels, values) {
 	const followTool = {
 		name: PANELS_FOLLOW_TOOL,
 		description: "某一行放回跟随机器级默认板（带 id = 只那一行，不带 = 全部）。",
-		parameters: noted({
+		parameters: {
 			type: "object",
 			properties: {
 				id: ID_PARAM,
 				scope: SCOPE_PARAM
 			},
 			additionalProperties: false
-		}),
+		},
 		output: OUTPUT,
 		async execute(raw, exec) {
 			const id = idOf(raw);
@@ -8306,6 +10459,24 @@ var OWNED = [{
 		ctx.provide(PANELS_SERVICE, panels);
 		const debug = withObserverCleanup(createDebugStore(), () => stopObservers(ctx), logger);
 		ctx.provide(DIY_DEBUG_SERVICE, debug);
+		const record = {
+			...createRecordStore(),
+			release: (state) => {
+				const shellNow = ctx.get("shell");
+				if (shellNow === void 0) return Promise.resolve({
+					tab: false,
+					capture: false
+				});
+				return releaseQuietly({
+					shell: shellNow,
+					command: opencliCommandOf(ctx).command,
+					session: BROWSER_RECORD_SESSION,
+					url: state.url,
+					captureFile: state.captureFile
+				});
+			}
+		};
+		ctx.provide(DIY_RECORD_SERVICE, record);
 		const profileDir = profileDirOf(ctx);
 		const shell = ctx.get("shell");
 		const moduleManifests = () => {
@@ -8354,12 +10525,14 @@ var OWNED = [{
 					ledger,
 					...shell === void 0 ? {} : { shell }
 				}),
-				...diyDebugRoutes(debug)
+				...diyDebugRoutes(debug),
+				...diyRecordRoutes(record)
 			},
 			registerTools: () => [
 				...registerPanelTools(ctx, panels, values),
 				...registerMarketTools(ctx, market),
-				...registerDiyTools(ctx, market, panels, debug)
+				...registerDiyTools(ctx, market, panels, debug),
+				...registerRecordTools(ctx, record)
 			],
 			factsOf: (call) => panelsFactsOf(call, manifests()),
 			needsApproval: panelsApproval,
@@ -8370,7 +10543,11 @@ var OWNED = [{
 					return [...manifests().flatMap((manifest) => owned.has(manifest.id) || resolveScope({
 						id: manifest.id,
 						boards
-					}) ? [] : manifest.tools.map((tool) => tool.name)), ...inWorkshopSession(ctx, workspace) ? [] : [...DIY_TOOLS, ...DIY_DEBUG_TOOLS]];
+					}) ? [] : manifest.tools.map((tool) => tool.name)), ...inWorkshopSession(ctx, workspace) ? [] : [
+						...DIY_TOOLS,
+						...DIY_DEBUG_TOOLS,
+						...DIY_RECORD_TOOLS
+					]];
 				},
 				subscribe: (listener) => panels.subscribe(listener)
 			},
@@ -8418,19 +10595,26 @@ function withRunsRoute(result, unit) {
 		}
 	};
 }
-function notedRegistry(registry, writesOf, journal) {
+function declaresNote(definition) {
+	const parameters = definition.parameters;
+	if (typeof parameters !== "object" || parameters === null) return false;
+	const properties = parameters["properties"];
+	if (typeof properties !== "object" || properties === null) return false;
+	return APPROVAL_NOTE_ARG in properties;
+}
+function declaredNotesOf(plans) {
+	return new Set([...plans].flatMap((plan) => [...plan.declaredNotes]));
+}
+function journaledRegistry(registry, journal, declaredNotes) {
 	return { register(definition) {
-		const noted = writesOf(definition.name) ? withApprovalNote(definition.parameters, { required: true }) : void 0;
-		const registered = registry.register(noted === void 0 || noted === definition.parameters ? definition : {
-			...definition,
-			parameters: noted
-		});
+		const registered = registry.register(definition);
 		journal.push(registered);
+		if (declaresNote(definition)) declaredNotes.add(definition.name);
 		return registered;
 	} };
 }
-function scopedMountCtx(ctx, registry, writesOf, journal) {
-	const tools = notedRegistry(registry, writesOf, journal);
+function scopedMountCtx(ctx, registry, journal, declaredNotes) {
+	const tools = journaledRegistry(registry, journal, declaredNotes);
 	const get = (name) => {
 		const value = ctx.get(name);
 		return name === "tools" && value !== void 0 ? tools : value;
@@ -8574,6 +10758,7 @@ function mountUnits(units, deps) {
 	const store = deps.store ?? createWorkspaceStore({ root: null });
 	const ownedUnits = deps.ownedUnits ?? (() => []);
 	const mounted = [];
+	const declaredNotes = /* @__PURE__ */ new Set();
 	const skipped = [];
 	const longTaskDisposers = /* @__PURE__ */ new Map();
 	const ledger = {
@@ -8591,9 +10776,8 @@ function mountUnits(units, deps) {
 		}
 		const unit = host.manifest.id;
 		const tools = deps.ctx.get("tools");
-		const writes = toolUnits(deps.manifests());
 		const toolJournal = [];
-		const mountCtx = tools === void 0 ? deps.ctx : scopedMountCtx(deps.ctx, tools, (name) => writes.get(name)?.writes === true, toolJournal);
+		const mountCtx = tools === void 0 ? deps.ctx : scopedMountCtx(deps.ctx, tools, toolJournal, declaredNotes);
 		const longTasks = deps.longTasks === void 0 ? void 0 : createLongTaskHost({
 			scope: deps.longTasks.scope,
 			unit,
@@ -8667,6 +10851,7 @@ function mountUnits(units, deps) {
 		skipped,
 		failed: ledger.failures,
 		warmReads: collectWarmReads(alive),
+		declaredNotes,
 		disposeLongTasks: () => {
 			for (const dispose of [...longTaskDisposers.values()]) dispose();
 			longTaskDisposers.clear();
@@ -8703,125 +10888,105 @@ function createPostChannels(deps) {
 	};
 }
 //#endregion
-//#region src/shared/api/host/diy-debug-act.ts
-var DEBUG_NOTICE_KIND = "workbench-diy";
+//#region src/shared/api/host/diy-record-act.ts
+var RECORD_NOTICE_KIND = "workbench-diy-record";
 var INTENT_WORD = {
-	pause: "暂停",
-	resume: "继续",
-	stop: "结束"
+	peek: "看结果",
+	halt: "停",
+	stop: "收工"
 };
-function debugNoticeText(intent, state) {
+function recordNoticeText(intent, state) {
 	const head = `［工作台 DIY］用户按了「${INTENT_WORD[intent]}」：`;
-	if (intent === "pause") return `${head}${state.unit} 这场调试暂停了 —— 现在别再把那一屏当目标（看 / 动 / 网络那一族发不出去）。要接着看屏就等用户按「继续」；在那之前照常改源码 / build / 跑门禁。`;
-	if (intent === "resume") return `${head}${state.unit} 这场调试重新开始了 —— 那一屏又归你看。屏 / 板不对的话照旧会被拒，拒了就照实说清是哪种不对。`;
-	return `${head}${state.unit} 这场调试收工了（占用解除）。要再调试就重新 start 一场。`;
+	if (intent === "peek") return state.phase === "finished" ? `${head}${state.unit} 这一段录制他做完了 —— 用 workbench_diy_record_read 取那一段（他不在了也照取），取过用 workbench_diy_record_stop 收工。` : `${head}${state.unit} 这一段现在还是 ${state.phase}（他还没按「结束录制」）—— 等他按完再 read；他要是说浮条没了，read 那一步会顺手把浮条重新装上。`;
+	if (intent === "halt") return `${head}${state.unit} 这一段他停下来了（浮条可能被导航干掉过）。**先 read 再 stop**：read 会把那一页上的缓冲取出来，stop 之后就取不到了 —— 顺序反了就等于白录。`;
+	return `${head}${state.unit} 这一场收了（占用解除）。已经 read 过的部分在你手上；没读的那部分没了 —— 要再录一段重新 prepare 一场。`;
 }
-function debugNoticeSummary(intent, state) {
+function recordNoticeSummary(intent, state) {
 	return `工作台 DIY：用户按了${INTENT_WORD[intent]}（${state.unit}）`;
 }
-function debugNotice(intent, state) {
-	const summary = debugNoticeSummary(intent, state);
+function recordNotice(intent, state) {
+	const summary = recordNoticeSummary(intent, state);
 	return {
 		summary,
-		message: {
-			role: "user",
-			id: randomUUID(),
-			content: [{
-				type: "text",
-				text: debugNoticeText(intent, state)
-			}],
-			source: {
-				kind: DEBUG_NOTICE_KIND,
-				form: "notice",
-				summary
-			}
-		}
+		message: noticeMessage(recordNoticeText(intent, state), summary, RECORD_NOTICE_KIND)
 	};
 }
 var NOTICE_MODE = {
-	resume: "wake",
-	pause: "hold",
+	peek: "wake",
+	halt: "wake",
 	stop: "drop"
 };
-var held = /* @__PURE__ */ new Map();
-function holdNotice(sessionId, message) {
-	const list = held.get(sessionId);
-	if (list === void 0) held.set(sessionId, [message]);
-	else list.push(message);
-}
-function takeHeldNotices(sessionId) {
-	const list = held.get(sessionId) ?? [];
-	held.delete(sessionId);
-	return list;
-}
-function deliverDebugNotice(agents, sessionId, message, mode = "wake") {
-	const agent = agents?.get(sessionId);
-	if (agent === void 0) {
-		if (mode === "drop") return "none";
-		holdNotice(sessionId, message);
-		return "held";
-	}
-	if (agent.status !== "idle") {
-		agent.inject(message);
-		return "inject";
-	}
-	if (mode === "wake") {
-		agent.followup(message);
-		return "followup";
-	}
-	if (mode === "hold") {
-		holdNotice(sessionId, message);
-		return "held";
+var REFUSAL = "现在没有录制中的那一场 —— 没什么可停 / 可收的";
+async function releaseHeld(store, held) {
+	try {
+		return await (store.release?.(held) ?? Promise.resolve({
+			tab: false,
+			capture: false
+		}));
+	} catch {
+		return {
+			tab: false,
+			capture: false
+		};
 	}
-	return "skipped-idle";
 }
-var REFUSAL = {
-	"already-paused": "这一场已经是暂停态了",
-	"already-debugging": "这一场本来就在调试中",
-	none: "现在没有调试态",
-	"not-owner": "这场调试不是这个会话的"
-};
-function debugActResource(deps) {
+function recordActResource(deps) {
 	const now = () => deps.now?.() ?? Date.now();
-	const settled = (intent, delivered, summary, state) => ({
-		ok: true,
-		intent,
-		delivered,
-		summary,
-		state
-	});
 	return {
 		resource: "act",
-		handle(payload) {
-			const intent = parseDebugIntent(payload?.intent);
+		async handle(payload) {
+			const intent = parseRecordIntent(payload?.intent);
 			if (intent === null) return {
 				ok: false,
-				text: "不认识的意图（只认 pause / resume / stop）"
+				text: "不认识的意图（只认 peek / halt / stop）"
 			};
 			const store = deps.store();
-			if (store === void 0) return {
-				ok: false,
-				text: "现在没有调试态 —— 没什么可暂停 / 继续 / 结束的"
-			};
 			const at = now();
-			const held = store.live(at);
-			if (held === null) return {
+			const held = store?.live(at) ?? null;
+			if (store === void 0 || held === null) return {
 				ok: false,
-				text: "现在没有调试态 —— 没什么可暂停 / 继续 / 结束的"
+				text: REFUSAL
 			};
-			const move = intent === "pause" ? store.pause(held.sessionId, at) : intent === "resume" ? store.resume(held.sessionId, at) : store.stop(held.sessionId, at);
-			if (!move.ok) return {
-				ok: false,
-				text: REFUSAL[move.code] ?? `按不动：${move.code}`
+			const notice = deps.notice?.(intent, held) ?? recordNotice(intent, held);
+			if (intent !== "stop") return {
+				ok: true,
+				intent,
+				delivered: deliverDebugNotice(deps.agents(), held.sessionId, notice.message, NOTICE_MODE[intent]),
+				summary: notice.summary,
+				state: store.live(now())
+			};
+			const cleaned = await releaseHeld(store, held);
+			const move = store.stop(held.sessionId, at);
+			return {
+				ok: true,
+				intent,
+				delivered: deliverDebugNotice(deps.agents(), held.sessionId, notice.message, NOTICE_MODE[intent]),
+				summary: notice.summary,
+				cleaned,
+				refused: move.ok ? "" : move.code,
+				state: store.live(now())
 			};
-			const notice = deps.notice?.(intent, move.state) ?? debugNotice(intent, move.state);
-			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())));
 		}
 	};
 }
 //#endregion
+//#region src/shared/api/host/diy-acts.ts
+function registerDiyActs(ctx, facts) {
+	const log = { bump: (names) => facts.bump(names) };
+	const offDebug = registerDiyDebugAct(ctx, debugActResource({
+		store: () => ctx.get(DIY_DEBUG_SERVICE),
+		agents: () => ctx.get("agents")
+	}), log);
+	const offRecord = registerDiyRecordAct(ctx, recordActResource({
+		store: () => ctx.get(DIY_RECORD_SERVICE),
+		agents: () => ctx.get("agents")
+	}), log);
+	return () => {
+		offDebug();
+		offRecord();
+	};
+}
+//#endregion
 //#region src/shared/api/host/events.ts
 var HEARTBEAT_MS = 25e3;
 function frame(payload) {
@@ -11083,6 +13248,7 @@ function apply(ctx) {
 	const factsOfUnit = (unit) => [...routesOfUnitMap.get(unit) ?? [], "capability"];
 	const callFacts = (unit, call) => factsOfMap.get(unit)?.(call) ?? factsOfUnit(unit);
 	const deniedNow = (workspace) => [...new Set([...mounted.values()].flatMap((item) => item.plan.gate?.deniedTools(workspace) ?? []))];
+	const declaredNoteTools = () => declaredNotesOf([...mounted.values()].map((item) => item.plan));
 	const wrote = (resource, write) => {
 		const unit = ownersMap.get(resource);
 		if (unit !== void 0) facts.bump(callFacts(unit, {
@@ -11314,10 +13480,12 @@ function apply(ctx) {
 				...workspace === void 0 ? {} : { workspace }
 			};
 			const policy = owner?.needsApproval;
+			const declaredNote = name !== void 0 && declaredNoteTools().has(name);
 			return await approvalFor(call, {
 				detailOf,
 				policy,
-				writes: tool?.writes ?? false
+				writes: tool?.writes ?? false,
+				declaredNote
 			}) ?? decision;
 		});
 		return () => off?.();
@@ -11347,12 +13515,7 @@ function apply(ctx) {
 	}, `${PLUGIN_ID}: 对话引用注入`);
 	ctx.effect(() => registerFactStream(ctx, facts), `${PLUGIN_ID}: 变更流`);
 	ctx.effect(() => registerPanelState(ctx, panelState), `${PLUGIN_ID}: 面板运行态上报（浏览器半侧报自己的取数与渲染收尾）`);
-	ctx.effect(() => {
-		return registerDiyDebugAct(ctx, debugActResource({
-			store: () => ctx.get(DIY_DEBUG_SERVICE),
-			agents: () => ctx.get("agents")
-		}), { bump: (names) => facts.bump(names) });
-	}, `${PLUGIN_ID}: DIY 调试的三个键（用户按的）`);
+	ctx.effect(() => registerDiyActs(ctx, { bump: (names) => facts.bump(names) }), `${PLUGIN_ID}: DIY 的两族键（用户按的）`);
 	ctx.effect(() => registerApi(ctx, routes), `${PLUGIN_ID}: HTTP 投影`);
 }
 //#endregion