@dsh-workbench/core 0.3.5 → 0.3.7

package/dist/host/index.js

@@ -56,8 +56,12 @@ var VERSION_CHECK_TIMEOUT_MS = 1e4;
 var PROBE_TTL_MS = 3e4;
 /** 跑本地 git 命令的超时（毫秒）；短于对外的 `OPENCLI_TIMEOUT_MS`。 */
 var GIT_TIMEOUT_MS = 1e4;
-var MARKER = new RegExp(`@工作台:([a-z][a-z0-9-]*:[A-Za-z0-9._~%#/-]+)`, "g");
-var TRAILING_PUNCTUATION = /[.,;:!?]+$/;
+//#endregion
+//#region ../shared/dist/api/context-ref.js
+/**
+* 引用标记的固定名字；完整标记是 @<这个名字>:<编码文本>，改它等于作废历史会话里已写下的引用。
+*/
+var CONTEXT_MARKER_NAME = "工作台";
 /**
 * 把引用拼回标记体里的那一段文本（不含 @ 与标记名）。
 * @param ref 要拼的引用。
@@ -66,41 +70,6 @@ var TRAILING_PUNCTUATION = /[.,;:!?]+$/;
 function encodeRef(ref) {
 	return `${ref.kind}:${ref.parts.join("/")}`;
 }
-/**
-* 把 kind:part/part 文本读回引用。
-* @param text 待解析文本。
-* @returns 没冒号、冒号在首尾、种类不是小写字母开头、或冒号后为空时给 undefined；不抛异常。
-*/
-function decodeRef(text) {
-	const at = text.indexOf(":");
-	if (at <= 0 || at === text.length - 1) return void 0;
-	const kind = text.slice(0, at);
-	if (!/^[a-z][a-z0-9-]*$/.test(kind)) return void 0;
-	const parts = text.slice(at + 1).split("/").filter((part) => part !== "");
-	if (parts.length === 0) return void 0;
-	return {
-		kind,
-		parts
-	};
-}
-/**
-* 从一段文本里按出现顺序捞出所有标记引用，同一个引用只留第一次。
-* @param text 任意文本；null / undefined 当空串。
-* @returns 解析不出来的标记会被丢掉，所以结果只含合法引用，可能为空数组。
-*/
-function parseMarkers(text) {
-	const seen = /* @__PURE__ */ new Set();
-	const refs = [];
-	for (const match of String(text ?? "").matchAll(MARKER)) {
-		const ref = decodeRef(match[1].replace(TRAILING_PUNCTUATION, ""));
-		if (ref === void 0) continue;
-		const key = encodeRef(ref);
-		if (seen.has(key)) continue;
-		seen.add(key);
-		refs.push(ref);
-	}
-	return refs;
-}
 //#endregion
 //#region ../shared/dist/api/unit.js
 /**
@@ -111,162 +80,6 @@ function parseMarkers(text) {
 function hasEnvSupply(manifest) {
 	return (manifest.env?.plugins ?? []).length > 0 || (manifest.env?.libs ?? []).length > 0;
 }
-/**
-* 外壳愿意认的协议版本；不在表里的模块当场被拒，不猜语义。
-*/
-var SUPPORTED_API_VERSIONS = [1];
-/**
-* 协议认得的全部键；写了别的键不会被采纳（外壳静默忽略），所以字段名拼错不会有提示。
-*/
-var DECLARATION_KEYS = [
-	"apiVersion",
-	"unit",
-	"card",
-	"tools",
-	"host",
-	"env"
-];
-/**
-* 协议要求必写的键；env 不在其中（没有环境需要就不写）。
-*/
-var DECLARATION_REQUIRED_KEYS = [
-	"apiVersion",
-	"unit",
-	"card",
-	"tools",
-	"host"
-];
-var CARD_KEYS = ["titleKey", "order"];
-var TOOL_KEYS = [
-	"name",
-	"writes",
-	"key"
-];
-var TOOL_KEY_SHAPE = /^[a-z][a-zA-Z0-9]*$/;
-var HOST_KEYS = ["inject", "optional"];
-function text$1(value) {
-	return typeof value === "string" ? value.trim() : "";
-}
-function isRecord(value) {
-	return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function outsideKeys(value, allowed) {
-	return Object.keys(value).filter((key) => !allowed.includes(key));
-}
-function listOf(keys) {
-	return keys.map((key) => JSON.stringify(key)).join(" / ");
-}
-function stringArrayProblems(at, value) {
-	if (!Array.isArray(value)) return [`${at} 要是一串字符串，现在是 ${JSON.stringify(value)}`];
-	return value.flatMap((item, index) => text$1(item) === "" ? [`${at}[${index}] 不是非空字符串：${JSON.stringify(item)}`] : []);
-}
-/**
-* 查清单里 dsh.workbench 那一段的形状，回一串给人看的问题（中文，带字段路径）。
-* @param subject 报错时用的主语，一般是包名。
-* @param raw 清单里那段原始值，可能什么都不是。
-* @returns 空数组表示形状过得去；版本不对就当场返回（后面的字段无从判起）。
-*/
-function declarationProblemsOf(subject, raw) {
-	if (!isRecord(raw)) return [`${subject}: dsh.workbench 不是一个对象 —— ${JSON.stringify(raw)}`];
-	const version = raw.apiVersion;
-	if (version === void 0) return [`${subject}: dsh.workbench 没有 apiVersion —— 协议从 v1 起，写 \`"apiVersion": 1\`。缺它 = 外壳不认这个模块（ADR-0038 §2.3）`];
-	if (!Number.isInteger(version) || !SUPPORTED_API_VERSIONS.includes(version)) return [`${subject}: dsh.workbench.apiVersion 是 ${JSON.stringify(version)}，这里只认 ${SUPPORTED_API_VERSIONS.join(" / ")}（要整数）`];
-	const problems = [];
-	const unknown = outsideKeys(raw, DECLARATION_KEYS);
-	if (unknown.length > 0) problems.push(`${subject}: dsh.workbench 里有协议 v1 不认识的键 ${listOf(unknown)} —— 只有 ${listOf(DECLARATION_KEYS)}。（拼错的键会被外壳**静默忽略**：那句声明等于没写）`);
-	for (const key of DECLARATION_REQUIRED_KEYS) if (raw[key] === void 0) problems.push(`${subject}: dsh.workbench 缺 ${key}` + (key === "card" ? "（这个模块没有卡片就写 `\"card\": null`）" : ""));
-	const card = raw.card;
-	if (card !== void 0 && card !== null) {
-		if (!isRecord(card)) problems.push(`${subject}: dsh.workbench.card 要么是对象、要么是 null，现在是 ${JSON.stringify(card)}`);
-		else {
-			const extra = outsideKeys(card, CARD_KEYS);
-			if (extra.length > 0) problems.push(`${subject}: dsh.workbench.card 里有不认的键 ${listOf(extra)} —— card 只有 ${listOf(CARD_KEYS)}（卡片默认显不显示由运行期的面板配置决定，清单里没有这一位）`);
-			if (text$1(card.titleKey) === "") problems.push(`${subject}: dsh.workbench.card.titleKey 要是非空字符串（面板那一格的文案键）`);
-			if (typeof card.order !== "number" || !Number.isFinite(card.order)) problems.push(`${subject}: dsh.workbench.card.order 要是数字，现在是 ${JSON.stringify(card.order)}`);
-		}
-	}
-	const tools = raw.tools;
-	if (tools !== void 0) {
-		if (!Array.isArray(tools)) problems.push(`${subject}: dsh.workbench.tools 要是一串声明，现在是 ${JSON.stringify(tools)}`);
-		else {
-			const seen = /* @__PURE__ */ new Set();
-			const seenKeys = /* @__PURE__ */ new Set();
-			tools.forEach((tool, index) => {
-				const at = `dsh.workbench.tools[${index}]`;
-				if (!isRecord(tool)) {
-					problems.push(`${subject}: ${at} 要是对象，现在是 ${JSON.stringify(tool)}`);
-					return;
-				}
-				const extra = outsideKeys(tool, TOOL_KEYS);
-				if (extra.length > 0) problems.push(`${subject}: ${at} 里有不认的键 ${listOf(extra)} —— tools 只有 ${listOf(TOOL_KEYS)}`);
-				const name = text$1(tool.name);
-				if (name === "") problems.push(`${subject}: ${at}.name 要是非空字符串`);
-				else if (seen.has(name)) problems.push(`${subject}: ${at}.name「${name}」与前面那条撞了 —— 工具名会进 dsh 的工具表，不许重`);
-				else seen.add(name);
-				if (typeof tool.writes !== "boolean") problems.push(`${subject}: ${at}.writes 要是 true / false（它是"这会写"的唯一声明，缺了审批无从认领）`);
-				if (tool.key !== void 0) {
-					const key = text$1(tool.key);
-					if (!TOOL_KEY_SHAPE.test(key)) problems.push(`${subject}: ${at}.key 要是 lowerCamelCase 的标识符（如 \`sync\` / \`podLogs\`），现在是 ${JSON.stringify(tool.key)} —— 它会变成生成物里的键名，所以不引号、不许带点或横线`);
-					else if (seenKeys.has(key)) problems.push(`${subject}: ${at}.key「${key}」与前面那条撞了 —— 生成物里的键只能有一个`);
-					else seenKeys.add(key);
-				}
-			});
-		}
-	}
-	const host = raw.host;
-	if (host !== void 0) {
-		if (!isRecord(host)) problems.push(`${subject}: dsh.workbench.host 要是对象，现在是 ${JSON.stringify(host)}`);
-		else {
-			const extra = outsideKeys(host, HOST_KEYS);
-			if (extra.length > 0) problems.push(`${subject}: dsh.workbench.host 里有不认的键 ${listOf(extra)} —— host 只有 ${listOf(HOST_KEYS)}`);
-			if (host.inject === void 0) problems.push(`${subject}: dsh.workbench.host.inject 没写 —— 它声明这个模块要外壳的哪几个服务，外壳靠它判"能不能挂"。一个都不要也要写 \`"inject": []\``);
-			else problems.push(...stringArrayProblems(`${subject}: dsh.workbench.host.inject`, host.inject));
-			if (host.optional !== void 0) problems.push(...stringArrayProblems(`${subject}: dsh.workbench.host.optional`, host.optional));
-		}
-	}
-	if (raw.env !== void 0 && !isRecord(raw.env)) problems.push(`${subject}: dsh.workbench.env 要是对象（command / plugins / libs）—— 语义由门禁的 env 判据查，这里只查形状`);
-	return problems;
-}
-/**
-* 读一份清单：先查形状，过了再把声明规整成 manifest。
-* @param subject 报错时用的主语。
-* @param raw 清单里 dsh.workbench 那段原始值。
-* @returns 有问题时只有 problems；没问题时 declaration 与 manifest 都给，manifest 里的字符串已 trim。
-*/
-function readDeclaration(subject, raw) {
-	const problems = declarationProblemsOf(subject, raw);
-	if (problems.length > 0) return { problems };
-	const declaration = raw;
-	const card = declaration.card;
-	return {
-		declaration,
-		problems: [],
-		manifest: {
-			id: text$1(declaration.unit),
-			card: card === null ? null : {
-				titleKey: text$1(card.titleKey),
-				order: card.order
-			},
-			tools: declaration.tools.map((tool) => ({
-				name: text$1(tool.name),
-				writes: tool.writes
-			})),
-			host: {
-				inject: [...declaration.host.inject ?? []],
-				...declaration.host.optional === void 0 ? {} : { optional: [...declaration.host.optional] }
-			},
-			...declaration.env === void 0 ? {} : { env: declaration.env }
-		}
-	};
-}
-/**
-* 由单元 id 拼出它那一族事实的范围名。
-* @param unit 单元 id，不带后缀。
-* @returns <unit>* —— 永远是范围名，不是某一条事实。
-*/
-function unitFactScope(unit) {
-	return `${unit}*`;
-}
 //#endregion
 //#region ../shared/dist/api/long-task.js
 /**
@@ -277,25 +90,16 @@ function unitFactScope(unit) {
 function runsRouteOf(unit) {
 	return `${unit}/runs`;
 }
-//#endregion
-//#region ../shared/dist/lib/text.js
-/**
-* 把一个值裹成 shell 里的单引号字面量（值里的单引号一并转义），保证元字符按字面量传递。
-* @param value - 任意值；不是字符串的先 `String()`。
-* @returns 可安全拼进 `/bin/sh -c` 的一段文本 —— 含空格 / `$()` / `;` / 通配符的值都不会被当成语法。
-*/
-function quoteShellArg(value) {
-	return `'${String(value).replace(/'/g, `'\\''`)}'`;
-}
 /**
-* 取一段文本的末尾若干行（如命令输出），顺带去掉首尾空白。
-* @param text - 原文；`null` / `undefined` 当空串。
-* @param lines - 最多留几行，默认 6；0 给全篇、负数从开头砍掉那么多行（都是 `slice` 语义），调用方传正数。
-* @returns 末尾若干行、去首尾空行后的文本；原文行数不够就全给，空输入给空串。
+* 停止那条写路由（走 actions 通道的资源名）：`<单元>/runs/stop`。
+* @param unit 单元 id。
+* @returns <unit>/runs/stop。
 */
-function tailLines(text, lines = 6) {
-	return String(text ?? "").trim().split("\n").slice(-lines).join("\n");
+function stopRouteOf(unit) {
+	return `${unit}/runs/stop`;
 }
+//#endregion
+//#region ../shared/dist/lib/text.js
 function candidateStarts(raw) {
 	const starts = [];
 	for (let index = 0; index < raw.length; index += 1) {
@@ -337,262 +141,227 @@ function parseJsonLoose(text) {
 var DAY = 864e5;
 30 * DAY;
 365 * DAY;
+//#endregion
+//#region ../shared/dist/lib/board-fact.js
 /**
-* 上报文本字段的截断长度（2000 字符；workspace / reason / message 共用）。
+* 判一个路径落不落在这个工作区里（按路径前缀比，不是字符串包含）。
+* @param root - 工作区根路径。
+* @param target - 要判的路径。
+* @returns 同一个路径或在其下给 `true`；`root` 末尾带不带斜杠都认（`/a` 不匹配 `/ab`）。
 */
-var PANEL_STATE_MAX_TEXT = 2e3;
-var PHASES = [
-	"idle",
-	"loading",
-	"ready",
-	"error"
-];
-function asRecord$8(value) {
-	return typeof value === "object" && value !== null ? value : void 0;
-}
-function textOf$6(value, max) {
-	if (typeof value !== "string") return "";
-	const trimmed = value.trim();
-	return trimmed.length > max ? trimmed.slice(0, max) : trimmed;
-}
-function atOf(value) {
-	if (typeof value !== "number" || !Number.isFinite(value)) return null;
-	if (value < 0) return null;
-	return Math.trunc(value);
-}
-function errorOf(raw) {
-	const record = asRecord$8(raw);
-	if (record === void 0) return void 0;
-	const code = textOf$6(record["code"], 120);
-	const message = textOf$6(record["message"], PANEL_STATE_MAX_TEXT);
-	if (code === "" && message === "") return void 0;
-	return {
-		code: code === "" ? "unknown" : code,
-		message
-	};
+function insideWorkshop$1(root, target) {
+	if (target === root) return true;
+	const base = root.endsWith("/") ? root : `${root}/`;
+	return target.startsWith(base);
 }
 /**
-* 收一批卡片读数上报。
-* @param payload - `POST` 的请求体。
-* @returns 至少收到一条能认的卡片才 `ok: true`；请求体不是对象、`workspace` 为空、`cards` 不是数组，
-*   或一条都认不出（`unit` / `route` / `phase` / `at` 缺一）时 `ok: false` + 中文原因；认不出的单条静默跳过。
+* 把探针读数归成左栏那句人话的档位。
+* @param probe - 探针读数。
+* @param workshop - 当前工作区根路径；`null` 一律 `unknown`。
+* @returns 椅面画着 → 本板 `ok` / 别板 `other-board`；没画着 → 页面已走 `off-workspace`，否则 `panel-closed`。
 */
-function parseCardsReport(payload) {
-	const record = asRecord$8(payload);
-	if (record === void 0) return {
-		ok: false,
-		message: "请求体要是一个对象"
-	};
-	const workspace = textOf$6(record["workspace"], PANEL_STATE_MAX_TEXT);
-	if (workspace === "") return {
-		ok: false,
-		message: "workspace 不能是空的 —— 面板按工作区存"
-	};
-	const raw = record["cards"];
-	if (!Array.isArray(raw)) return {
-		ok: false,
-		message: "cards 要是一个数组"
-	};
-	const cards = [];
-	for (const item of raw.slice(0, 32)) {
-		const card = asRecord$8(item);
-		if (card === void 0) continue;
-		const unit = textOf$6(card["unit"], 200);
-		const route = textOf$6(card["route"], 400);
-		const phase = textOf$6(card["phase"], 20);
-		const at = atOf(card["at"]);
-		if (unit === "" || route === "" || at === null || !PHASES.includes(phase)) continue;
-		const error = errorOf(card["error"]);
-		cards.push({
-			unit,
-			route,
-			phase,
-			at,
-			...error === void 0 ? {} : { error }
-		});
+function boardSituation(probe, workshop) {
+	if (!probe.workbench || workshop === null) return "unknown";
+	if (probe.bar && probe.open && probe.drawn) {
+		if (probe.board === "") return "unknown";
+		return insideWorkshop$1(workshop, probe.board) ? "ok" : "other-board";
 	}
-	if (cards.length === 0) return {
-		ok: false,
-		message: "cards 里没有一条能认的（unit / route / phase / at 都要有）"
-	};
-	return {
-		ok: true,
-		value: {
-			workspace,
-			cards
-		}
-	};
+	if (probe.where !== "" && !insideWorkshop$1(workshop, probe.where)) return "off-workspace";
+	return "panel-closed";
 }
+//#endregion
+//#region ../shared/dist/host/board-fact.js
 /**
-* 收一次卡片崩溃上报。
-* @param payload - `POST` 的请求体。
-* @returns `workspace` / `unit` / `reason` 都不能空，缺一给 `ok: false` + 中文原因；`at` 缺省或不合法时取当前时间。
+* 把一次探针读数归成椅面归属。
+* @param probe - 探针读数。
+* @param workshop - 当前工作区根路径；`null` 表示还不知道当前是哪个工作区。
+* @returns 外壳不在、或板路径与工作区缺一 → `unknown`；右栏没开或没画出来 → `hidden`；板在本工作区 → `workshop`，否则 `other`。
 */
-function parseCrashReport(payload) {
-	const record = asRecord$8(payload);
-	if (record === void 0) return {
-		ok: false,
-		message: "请求体要是一个对象"
-	};
-	const workspace = textOf$6(record["workspace"], PANEL_STATE_MAX_TEXT);
-	const unit = textOf$6(record["unit"], 200);
-	const reason = textOf$6(record["reason"], PANEL_STATE_MAX_TEXT);
-	if (workspace === "") return {
-		ok: false,
-		message: "workspace 不能是空的"
-	};
-	if (unit === "") return {
-		ok: false,
-		message: "unit 不能是空的"
-	};
-	if (reason === "") return {
-		ok: false,
-		message: "reason 不能是空的（没有原因的崩溃没法查）"
-	};
-	return {
-		ok: true,
-		value: {
-			workspace,
-			unit,
-			reason,
-			at: atOf(record["at"]) ?? Date.now()
-		}
-	};
+function boardFactOf(probe, workshop) {
+	if (!probe.workbench) return "unknown";
+	if (!probe.bar || !probe.open || !probe.drawn) return "hidden";
+	if (probe.board === "" || workshop === null) return "unknown";
+	return insideWorkshop$1(workshop, probe.board) ? "workshop" : "other";
 }
+//#endregion
+//#region ../shared/dist/host/shell-text.js
 /**
-* 造一份面板运行态的留存（进程内存、按工作区分桶，带上面那几条上限的 LRU）。
-* @returns 留存口：`cards` / `crash` 收上报，`snapshot(workspace)` 取全量；没存过的工作区（含 `null`）给一份空的。
+* 把一个值裹成 shell 里的单引号字面量（值里的单引号一并转义），保证元字符按字面量传递。
+* @param value - 任意值；不是字符串的先 `String()`。
+* @returns 可安全拼进 `/bin/sh -c` 的一段文本 —— 含空格 / `$()` / `;` / 通配符的值都不会被当成语法。
 */
-function createPanelStateStore() {
-	const workspaces = /* @__PURE__ */ new Map();
-	function trim(entry, max) {
-		while (entry.size > max) {
-			const oldest = entry.keys().next();
-			if (oldest.done === true) return;
-			entry.delete(oldest.value);
-		}
-	}
-	function workspaceEntryOf(workspace) {
-		const existing = workspaces.get(workspace);
-		if (existing !== void 0) return existing;
-		const created = {
-			at: 0,
-			units: /* @__PURE__ */ new Map()
-		};
-		workspaces.set(workspace, created);
-		trim(workspaces, 64);
-		return created;
-	}
-	function unitEntryOf(entry, unit) {
-		const existing = entry.units.get(unit);
-		if (existing !== void 0) return existing;
-		const created = {
-			at: 0,
-			cards: /* @__PURE__ */ new Map()
-		};
-		entry.units.set(unit, created);
-		return created;
-	}
+function quoteShellArg(value) {
+	return `'${String(value).replace(/'/g, `'\\''`)}'`;
+}
+/**
+* 取一段文本的末尾若干行（如命令输出），顺带去掉首尾空白。
+* @param text - 原文；`null` / `undefined` 当空串。
+* @param lines - 最多留几行，默认 6；0 给全篇、负数从开头砍掉那么多行（都是 `slice` 语义），调用方传正数。
+* @returns 末尾若干行、去首尾空行后的文本；原文行数不够就全给，空输入给空串。
+*/
+function tailLines(text, lines = 6) {
+	return String(text ?? "").trim().split("\n").slice(-lines).join("\n");
+}
+//#endregion
+//#region ../shared/dist/host/opencli-window.js
+var OPENCLI_WINDOW_ENV = "OPENCLI_WINDOW=background";
+function backgroundPrefix() {
+	return [quoteShellArg("env"), quoteShellArg(OPENCLI_WINDOW_ENV)];
+}
+function backgroundLine(command, argv) {
+	return [
+		...backgroundPrefix(),
+		quoteShellArg(command),
+		...argv.map(quoteShellArg)
+	].join(" ");
+}
+//#endregion
+//#region ../shared/dist/host/shell.js
+var DEFAULT_MAX_BYTES = 8388608;
+async function runShell(shell, command, options = {}) {
+	const { workdir, timeoutMs = GIT_TIMEOUT_MS, signal } = options;
+	const spec = shell.resolve({
+		command,
+		...workdir === void 0 ? {} : { workdir },
+		timeoutMs,
+		onExpiry: "kill",
+		stdoutMaxBytes: DEFAULT_MAX_BYTES,
+		...signal === void 0 ? {} : { signal }
+	});
+	const result = await (await shell.execute(spec)).result();
 	return {
-		cards(report) {
-			const entry = workspaceEntryOf(report.workspace);
-			for (const card of report.cards) {
-				const unit = unitEntryOf(entry, card.unit);
-				unit.cards.delete(card.route);
-				unit.cards.set(card.route, card);
-				trim(unit.cards, 12);
-				if (card.at > unit.at) unit.at = card.at;
-				if (card.at > entry.at) entry.at = card.at;
-			}
-		},
-		crash(report) {
-			const entry = workspaceEntryOf(report.workspace);
-			const unit = unitEntryOf(entry, report.unit);
-			const previous = unit.crash;
-			const counted = previous !== void 0 && previous.reason === report.reason && report.at >= previous.at && report.at - previous.at <= 6e5;
-			unit.crash = {
-				unit: report.unit,
-				reason: report.reason,
-				at: report.at,
-				count: counted ? previous.count + 1 : 1
-			};
-			if (report.at > unit.at) unit.at = report.at;
-			if (report.at > entry.at) entry.at = report.at;
-		},
-		snapshot(workspace) {
-			if (workspace === null) return {
-				workspace: null,
-				at: 0,
-				units: []
-			};
-			const entry = workspaces.get(workspace);
-			if (entry === void 0) return {
-				workspace,
-				at: 0,
-				units: []
-			};
-			const units = [...entry.units.entries()].map(([unit, one]) => {
-				const cards = [...one.cards.values()].sort((a, b) => a.route.localeCompare(b.route));
-				const okAt = cards.reduce((best, card) => card.phase === "ready" && (best === null || card.at > best) ? card.at : best, null);
-				return {
-					unit,
-					at: one.at,
-					okAt,
-					cards,
-					...one.crash === void 0 ? {} : { crash: one.crash }
-				};
-			});
-			units.sort((a, b) => b.at - a.at || a.unit.localeCompare(b.unit));
-			return {
-				workspace,
-				at: entry.at,
-				units
+		exitCode: result.exitCode,
+		timedOut: result.timedOut === true,
+		aborted: result.aborted === true,
+		stdout: result.stdout.text,
+		stderr: result.stderr.text,
+		truncated: result.stdout.truncated || result.stderr.truncated
+	};
+}
+//#endregion
+//#region ../shared/dist/host/browser-read.js
+var BROWSER_SCREEN_SESSION = "workbench";
+var BROWSER_READ_SESSION = "workbench-read";
+var BROWSER_RECORD_SESSION = "workbench-rec";
+//#endregion
+//#region ../shared/dist/host/cli-error.js
+function unquote(raw) {
+	const value = raw.trim();
+	if (value.length >= 2 && (value.startsWith("\"") && value.endsWith("\"") || value.startsWith("'") && value.endsWith("'"))) return value.slice(1, -1);
+	return value;
+}
+function joinBlock(previous, line, fold) {
+	if (previous === "") return line;
+	return fold ? `${previous} ${line}` : `${previous}\n${line}`;
+}
+function parseCliErrorEnvelope(text) {
+	if (text === void 0 || text.trim() === "") return void 0;
+	const lines = text.split("\n");
+	const start = lines.findIndex((line) => /^error:\s*$/.test(line.trim()) || /^error:\s*\S/.test(line.trim()));
+	if (start === -1) return void 0;
+	const scalars = {};
+	let current;
+	let block;
+	const errorIndent = lines[start]?.search(/\S/) ?? 0;
+	for (const line of lines.slice(start + 1)) {
+		if (line.trim() === "") continue;
+		const indent = line.search(/\S/);
+		if (block !== void 0 && indent > block.indent) {
+			scalars[block.key] = joinBlock(scalars[block.key] ?? "", line.trim(), block.fold);
+			continue;
+		}
+		block = void 0;
+		if (indent <= errorIndent) break;
+		const match = /^\s*(code|message|help|exitCode):\s*(.*)$/.exec(line);
+		if (match === null) {
+			if (current !== void 0) scalars[current] = `${scalars[current] ?? ""} ${line.trim()}`.trim();
+			continue;
+		}
+		const [, key, value] = match;
+		if (key === void 0) continue;
+		const raw = (value ?? "").trim();
+		const marker = /^([|>])[0-9]*([+-]?)$/.exec(raw);
+		if (marker !== null) {
+			scalars[key] = "";
+			block = {
+				key,
+				fold: marker[1] === ">",
+				indent
 			};
+			current = key;
+			continue;
 		}
+		scalars[key] = unquote(raw);
+		current = key;
+	}
+	const code = scalars["code"];
+	const message = scalars["message"];
+	if (code === void 0 || code === "") return void 0;
+	const exitCode = scalars["exitCode"];
+	return {
+		code,
+		message: message ?? code,
+		...scalars["help"] === void 0 || scalars["help"] === "" ? {} : { help: scalars["help"] },
+		...exitCode === void 0 || Number.isNaN(Number(exitCode)) ? {} : { exitCode: Number(exitCode) }
 	};
 }
-//#endregion
-//#region ../shared/dist/lib/board-fact.js
-/**
-* 判一个路径落不落在这个工作区里（按路径前缀比，不是字符串包含）。
-* @param root - 工作区根路径。
-* @param target - 要判的路径。
-* @returns 同一个路径或在其下给 `true`；`root` 末尾带不带斜杠都认（`/a` 不匹配 `/ab`）。
-*/
-function insideWorkshop$1(root, target) {
-	if (target === root) return true;
-	const base = root.endsWith("/") ? root : `${root}/`;
-	return target.startsWith(base);
+function helpUrlOf(envelope) {
+	return /https?:\/\/[^\s"'`]+/.exec(envelope.help ?? "")?.[0];
 }
+//#endregion
+//#region ../shared/dist/host/context-ref.js
+var MARKER = new RegExp(`@${CONTEXT_MARKER_NAME}:([a-z][a-z0-9-]*:[A-Za-z0-9._~%#/-]+)`, "g");
+var TRAILING_PUNCTUATION = /[.,;:!?]+$/;
 /**
-* 把一次探针读数归成椅面归属。
-* @param probe - 探针读数。
-* @param workshop - 当前工作区根路径；`null` 表示还不知道当前是哪个工作区。
-* @returns 外壳不在、或板路径与工作区缺一 → `unknown`；右栏没开或没画出来 → `hidden`；板在本工作区 → `workshop`，否则 `other`。
+* 把 kind:part/part 文本读回引用。
+* @param text 待解析文本。
+* @returns 没冒号、冒号在首尾、种类不是小写字母开头、或冒号后为空时给 undefined；不抛异常。
 */
-function boardFactOf(probe, workshop) {
-	if (!probe.workbench) return "unknown";
-	if (!probe.bar || !probe.open || !probe.drawn) return "hidden";
-	if (probe.board === "" || workshop === null) return "unknown";
-	return insideWorkshop$1(workshop, probe.board) ? "workshop" : "other";
+function decodeRef(text) {
+	const at = text.indexOf(":");
+	if (at <= 0 || at === text.length - 1) return void 0;
+	const kind = text.slice(0, at);
+	if (!/^[a-z][a-z0-9-]*$/.test(kind)) return void 0;
+	const parts = text.slice(at + 1).split("/").filter((part) => part !== "");
+	if (parts.length === 0) return void 0;
+	return {
+		kind,
+		parts
+	};
 }
 /**
-* 把探针读数归成左栏那句人话的档位。
-* @param probe - 探针读数。
-* @param workshop - 当前工作区根路径；`null` 一律 `unknown`。
-* @returns 椅面画着 → 本板 `ok` / 别板 `other-board`；没画着 → 页面已走 `off-workspace`，否则 `panel-closed`。
+* 从一段文本里按出现顺序捞出所有标记引用，同一个引用只留第一次。
+* @param text 任意文本；null / undefined 当空串。
+* @returns 解析不出来的标记会被丢掉，所以结果只含合法引用，可能为空数组。
 */
-function boardSituation(probe, workshop) {
-	if (!probe.workbench || workshop === null) return "unknown";
-	if (probe.bar && probe.open && probe.drawn) {
-		if (probe.board === "") return "unknown";
-		return insideWorkshop$1(workshop, probe.board) ? "ok" : "other-board";
+function parseMarkers(text) {
+	const seen = /* @__PURE__ */ new Set();
+	const refs = [];
+	for (const match of String(text ?? "").matchAll(MARKER)) {
+		const ref = decodeRef(match[1].replace(TRAILING_PUNCTUATION, ""));
+		if (ref === void 0) continue;
+		const key = encodeRef(ref);
+		if (seen.has(key)) continue;
+		seen.add(key);
+		refs.push(ref);
 	}
-	if (probe.where !== "" && !insideWorkshop$1(workshop, probe.where)) return "off-workspace";
-	return "panel-closed";
+	return refs;
 }
 //#endregion
-//#region ../shared/dist/lib/diy-debug.js
+//#region ../shared/dist/host/data-root.js
+function dshHome() {
+	const configured = process.env.DSH_HOME?.trim();
+	if (configured !== void 0 && configured !== "") return configured;
+	return `${process.env.HOME ?? ""}/.dsh`;
+}
+function workbenchRoot() {
+	return `${dshHome()}/workbench`;
+}
+function workspacesRoot() {
+	return `${workbenchRoot()}/workspaces`;
+}
+//#endregion
+//#region ../shared/dist/host/diy-debug.js
 /**
 * 把工具入参收成人话动作。
 * @param value - 任意入参值。
@@ -706,6 +475,19 @@ function createDebugStore() {
 function parseRecordIntent(raw) {
 	return raw === "peek" || raw === "halt" || raw === "stop" ? raw : null;
 }
+/**
+* 这一拍该不该落图：页面计数涨过 `shotsSeen` 才算；同一个计数已经试满就先放下，等他自己再按。
+* @param state - 当前有效的那份约定。
+* @param pageShots - 页面浮条上那个「已拍」计数。
+* @returns 该落的那个计数；不该落给 `null`（没涨 / 试满了 / 不是个正经数）。
+*/
+function shotDueOf(state, pageShots) {
+	if (!Number.isFinite(pageShots)) return null;
+	const n = Math.floor(pageShots);
+	if (n <= state.shotsSeen) return null;
+	if (state.shotTries !== null && state.shotTries.n === n && state.shotTries.tries >= 2) return null;
+	return n;
+}
 function alive(state, now) {
 	if (state === null) return null;
 	return now - state.at <= 9e5 ? state : null;
@@ -722,6 +504,26 @@ function ownerOf(state, sessionId, now) {
 function createRecordStore() {
 	let held = null;
 	const live = (now) => alive(held, now);
+	const withShot = (found, shot, now, error) => {
+		const row = error === void 0 ? shot : {
+			n: shot.n,
+			at: shot.at,
+			path: shot.path,
+			error
+		};
+		const kept = found.shots.filter((one) => one.n !== shot.n);
+		const tries = found.shotTries !== null && found.shotTries.n === shot.n ? found.shotTries.tries : 0;
+		return {
+			...found,
+			shots: [...kept, row].sort((one, two) => one.n - two.n),
+			shotsSeen: error === void 0 ? Math.max(found.shotsSeen, shot.n) : found.shotsSeen,
+			shotTries: error === void 0 ? null : {
+				n: shot.n,
+				tries: tries + 1
+			},
+			at: now
+		};
+	};
 	return {
 		live,
 		begin(pact) {
@@ -744,6 +546,11 @@ function createRecordStore() {
 				startedAt: pact.now,
 				t0: null,
 				t1: null,
+				shots: [],
+				shotsSeen: 0,
+				shotTries: null,
+				beats: 0,
+				beatMs: 0,
 				at: pact.now
 			};
 			held = state;
@@ -800,139 +607,64 @@ function createRecordStore() {
 				state
 			};
 		},
-		stop(sessionId, now) {
+		shotTaken(sessionId, shot, now) {
 			const found = ownerOf(held, sessionId, now);
 			if (typeof found === "string") return {
 				ok: false,
 				code: found
 			};
-			held = null;
+			const state = withShot(found, shot, now, void 0);
+			held = state;
 			return {
 				ok: true,
-				state: found
+				state
 			};
-		}
-	};
-}
-//#endregion
-//#region ../shared/dist/host/opencli-window.js
-var OPENCLI_WINDOW_ENV = "OPENCLI_WINDOW=background";
-function backgroundPrefix() {
-	return [quoteShellArg("env"), quoteShellArg(OPENCLI_WINDOW_ENV)];
-}
-function backgroundLine(command, argv) {
-	return [
-		...backgroundPrefix(),
-		quoteShellArg(command),
-		...argv.map(quoteShellArg)
-	].join(" ");
-}
-//#endregion
-//#region ../shared/dist/host/shell.js
-var DEFAULT_MAX_BYTES = 8388608;
-async function runShell(shell, command, options = {}) {
-	const { workdir, timeoutMs = GIT_TIMEOUT_MS, signal } = options;
-	const spec = shell.resolve({
-		command,
-		...workdir === void 0 ? {} : { workdir },
-		timeoutMs,
-		onExpiry: "kill",
-		stdoutMaxBytes: DEFAULT_MAX_BYTES,
-		...signal === void 0 ? {} : { signal }
-	});
-	const result = await (await shell.execute(spec)).result();
-	return {
-		exitCode: result.exitCode,
-		timedOut: result.timedOut === true,
-		aborted: result.aborted === true,
-		stdout: result.stdout.text,
-		stderr: result.stderr.text,
-		truncated: result.stdout.truncated || result.stderr.truncated
-	};
-}
-//#endregion
-//#region ../shared/dist/host/browser-read.js
-var BROWSER_SCREEN_SESSION = "workbench";
-var BROWSER_READ_SESSION = "workbench-read";
-var BROWSER_RECORD_SESSION = "workbench-rec";
-//#endregion
-//#region ../shared/dist/host/cli-error.js
-function unquote(raw) {
-	const value = raw.trim();
-	if (value.length >= 2 && (value.startsWith("\"") && value.endsWith("\"") || value.startsWith("'") && value.endsWith("'"))) return value.slice(1, -1);
-	return value;
-}
-function joinBlock(previous, line, fold) {
-	if (previous === "") return line;
-	return fold ? `${previous} ${line}` : `${previous}\n${line}`;
-}
-function parseCliErrorEnvelope(text) {
-	if (text === void 0 || text.trim() === "") return void 0;
-	const lines = text.split("\n");
-	const start = lines.findIndex((line) => /^error:\s*$/.test(line.trim()) || /^error:\s*\S/.test(line.trim()));
-	if (start === -1) return void 0;
-	const scalars = {};
-	let current;
-	let block;
-	const errorIndent = lines[start]?.search(/\S/) ?? 0;
-	for (const line of lines.slice(start + 1)) {
-		if (line.trim() === "") continue;
-		const indent = line.search(/\S/);
-		if (block !== void 0 && indent > block.indent) {
-			scalars[block.key] = joinBlock(scalars[block.key] ?? "", line.trim(), block.fold);
-			continue;
-		}
-		block = void 0;
-		if (indent <= errorIndent) break;
-		const match = /^\s*(code|message|help|exitCode):\s*(.*)$/.exec(line);
-		if (match === null) {
-			if (current !== void 0) scalars[current] = `${scalars[current] ?? ""} ${line.trim()}`.trim();
-			continue;
-		}
-		const [, key, value] = match;
-		if (key === void 0) continue;
-		const raw = (value ?? "").trim();
-		const marker = /^([|>])[0-9]*([+-]?)$/.exec(raw);
-		if (marker !== null) {
-			scalars[key] = "";
-			block = {
-				key,
-				fold: marker[1] === ">",
-				indent
+		},
+		shotFailed(sessionId, shot, now) {
+			const found = ownerOf(held, sessionId, now);
+			if (typeof found === "string") return {
+				ok: false,
+				code: found
+			};
+			const state = withShot(found, shot, now, shot.error === void 0 ? "落图失败" : shot.error);
+			held = state;
+			return {
+				ok: true,
+				state
+			};
+		},
+		beat(sessionId, ms, now) {
+			const found = ownerOf(held, sessionId, now);
+			if (typeof found === "string") return {
+				ok: false,
+				code: found
+			};
+			const state = {
+				...found,
+				beats: found.beats + 1,
+				beatMs: Math.max(0, Math.floor(ms)),
+				at: now
+			};
+			held = state;
+			return {
+				ok: true,
+				state
+			};
+		},
+		stop(sessionId, now) {
+			const found = ownerOf(held, sessionId, now);
+			if (typeof found === "string") return {
+				ok: false,
+				code: found
+			};
+			held = null;
+			return {
+				ok: true,
+				state: found
 			};
-			current = key;
-			continue;
 		}
-		scalars[key] = unquote(raw);
-		current = key;
-	}
-	const code = scalars["code"];
-	const message = scalars["message"];
-	if (code === void 0 || code === "") return void 0;
-	const exitCode = scalars["exitCode"];
-	return {
-		code,
-		message: message ?? code,
-		...scalars["help"] === void 0 || scalars["help"] === "" ? {} : { help: scalars["help"] },
-		...exitCode === void 0 || Number.isNaN(Number(exitCode)) ? {} : { exitCode: Number(exitCode) }
 	};
 }
-function helpUrlOf(envelope) {
-	return /https?:\/\/[^\s"'`]+/.exec(envelope.help ?? "")?.[0];
-}
-//#endregion
-//#region ../shared/dist/host/data-root.js
-function dshHome() {
-	const configured = process.env.DSH_HOME?.trim();
-	if (configured !== void 0 && configured !== "") return configured;
-	return `${process.env.HOME ?? ""}/.dsh`;
-}
-function workbenchRoot() {
-	return `${dshHome()}/workbench`;
-}
-function workspacesRoot() {
-	return `${workbenchRoot()}/workspaces`;
-}
 //#endregion
 //#region ../shared/dist/host/facts.js
 function createFactLog(options = {}) {
@@ -970,18 +702,240 @@ function createFactLog(options = {}) {
 		}
 	};
 }
-function toolUnits(manifests) {
-	const map = /* @__PURE__ */ new Map();
-	for (const manifest of manifests) for (const tool of manifest.tools ?? []) map.set(tool.name, {
-		unit: manifest.id,
-		writes: tool.writes
-	});
-	return map;
-}
-function wroteNow(result) {
-	const wrote = (result?.value)?.wrote;
-	return typeof wrote === "boolean" ? wrote : void 0;
-}
+function toolUnits(manifests) {
+	const map = /* @__PURE__ */ new Map();
+	for (const manifest of manifests) for (const tool of manifest.tools ?? []) map.set(tool.name, {
+		unit: manifest.id,
+		writes: tool.writes
+	});
+	return map;
+}
+function wroteNow(result) {
+	const wrote = (result?.value)?.wrote;
+	return typeof wrote === "boolean" ? wrote : void 0;
+}
+/**
+* 由单元 id 拼出它那一族事实的范围名。
+* @param unit 单元 id，不带后缀。
+* @returns <unit>* —— 永远是范围名，不是某一条事实。
+*/
+function unitFactScope(unit) {
+	return `${unit}*`;
+}
+/**
+* 上报文本字段的截断长度（2000 字符；workspace / reason / message 共用）。
+*/
+var PANEL_STATE_MAX_TEXT = 2e3;
+var PHASES = [
+	"idle",
+	"loading",
+	"ready",
+	"error"
+];
+function asRecord$8(value) {
+	return typeof value === "object" && value !== null ? value : void 0;
+}
+function textOf$7(value, max) {
+	if (typeof value !== "string") return "";
+	const trimmed = value.trim();
+	return trimmed.length > max ? trimmed.slice(0, max) : trimmed;
+}
+function atOf(value) {
+	if (typeof value !== "number" || !Number.isFinite(value)) return null;
+	if (value < 0) return null;
+	return Math.trunc(value);
+}
+function errorOf(raw) {
+	const record = asRecord$8(raw);
+	if (record === void 0) return void 0;
+	const code = textOf$7(record["code"], 120);
+	const message = textOf$7(record["message"], PANEL_STATE_MAX_TEXT);
+	if (code === "" && message === "") return void 0;
+	return {
+		code: code === "" ? "unknown" : code,
+		message
+	};
+}
+/**
+* 收一批卡片读数上报。
+* @param payload - `POST` 的请求体。
+* @returns 至少收到一条能认的卡片才 `ok: true`；请求体不是对象、`workspace` 为空、`cards` 不是数组，
+*   或一条都认不出（`unit` / `route` / `phase` / `at` 缺一）时 `ok: false` + 中文原因；认不出的单条静默跳过。
+*/
+function parseCardsReport(payload) {
+	const record = asRecord$8(payload);
+	if (record === void 0) return {
+		ok: false,
+		message: "请求体要是一个对象"
+	};
+	const workspace = textOf$7(record["workspace"], PANEL_STATE_MAX_TEXT);
+	if (workspace === "") return {
+		ok: false,
+		message: "workspace 不能是空的 —— 面板按工作区存"
+	};
+	const raw = record["cards"];
+	if (!Array.isArray(raw)) return {
+		ok: false,
+		message: "cards 要是一个数组"
+	};
+	const cards = [];
+	for (const item of raw.slice(0, 32)) {
+		const card = asRecord$8(item);
+		if (card === void 0) continue;
+		const unit = textOf$7(card["unit"], 200);
+		const route = textOf$7(card["route"], 400);
+		const phase = textOf$7(card["phase"], 20);
+		const at = atOf(card["at"]);
+		if (unit === "" || route === "" || at === null || !PHASES.includes(phase)) continue;
+		const error = errorOf(card["error"]);
+		cards.push({
+			unit,
+			route,
+			phase,
+			at,
+			...error === void 0 ? {} : { error }
+		});
+	}
+	if (cards.length === 0) return {
+		ok: false,
+		message: "cards 里没有一条能认的（unit / route / phase / at 都要有）"
+	};
+	return {
+		ok: true,
+		value: {
+			workspace,
+			cards
+		}
+	};
+}
+/**
+* 收一次卡片崩溃上报。
+* @param payload - `POST` 的请求体。
+* @returns `workspace` / `unit` / `reason` 都不能空，缺一给 `ok: false` + 中文原因；`at` 缺省或不合法时取当前时间。
+*/
+function parseCrashReport(payload) {
+	const record = asRecord$8(payload);
+	if (record === void 0) return {
+		ok: false,
+		message: "请求体要是一个对象"
+	};
+	const workspace = textOf$7(record["workspace"], PANEL_STATE_MAX_TEXT);
+	const unit = textOf$7(record["unit"], 200);
+	const reason = textOf$7(record["reason"], PANEL_STATE_MAX_TEXT);
+	if (workspace === "") return {
+		ok: false,
+		message: "workspace 不能是空的"
+	};
+	if (unit === "") return {
+		ok: false,
+		message: "unit 不能是空的"
+	};
+	if (reason === "") return {
+		ok: false,
+		message: "reason 不能是空的（没有原因的崩溃没法查）"
+	};
+	return {
+		ok: true,
+		value: {
+			workspace,
+			unit,
+			reason,
+			at: atOf(record["at"]) ?? Date.now()
+		}
+	};
+}
+/**
+* 造一份面板运行态的留存（进程内存、按工作区分桶，带上面那几条上限的 LRU）。
+* @returns 留存口：`cards` / `crash` 收上报，`snapshot(workspace)` 取全量；没存过的工作区（含 `null`）给一份空的。
+*/
+function createPanelStateStore() {
+	const workspaces = /* @__PURE__ */ new Map();
+	function trim(entry, max) {
+		while (entry.size > max) {
+			const oldest = entry.keys().next();
+			if (oldest.done === true) return;
+			entry.delete(oldest.value);
+		}
+	}
+	function workspaceEntryOf(workspace) {
+		const existing = workspaces.get(workspace);
+		if (existing !== void 0) return existing;
+		const created = {
+			at: 0,
+			units: /* @__PURE__ */ new Map()
+		};
+		workspaces.set(workspace, created);
+		trim(workspaces, 64);
+		return created;
+	}
+	function unitEntryOf(entry, unit) {
+		const existing = entry.units.get(unit);
+		if (existing !== void 0) return existing;
+		const created = {
+			at: 0,
+			cards: /* @__PURE__ */ new Map()
+		};
+		entry.units.set(unit, created);
+		return created;
+	}
+	return {
+		cards(report) {
+			const entry = workspaceEntryOf(report.workspace);
+			for (const card of report.cards) {
+				const unit = unitEntryOf(entry, card.unit);
+				unit.cards.delete(card.route);
+				unit.cards.set(card.route, card);
+				trim(unit.cards, 12);
+				if (card.at > unit.at) unit.at = card.at;
+				if (card.at > entry.at) entry.at = card.at;
+			}
+		},
+		crash(report) {
+			const entry = workspaceEntryOf(report.workspace);
+			const unit = unitEntryOf(entry, report.unit);
+			const previous = unit.crash;
+			const counted = previous !== void 0 && previous.reason === report.reason && report.at >= previous.at && report.at - previous.at <= 6e5;
+			unit.crash = {
+				unit: report.unit,
+				reason: report.reason,
+				at: report.at,
+				count: counted ? previous.count + 1 : 1
+			};
+			if (report.at > unit.at) unit.at = report.at;
+			if (report.at > entry.at) entry.at = report.at;
+		},
+		snapshot(workspace) {
+			if (workspace === null) return {
+				workspace: null,
+				at: 0,
+				units: []
+			};
+			const entry = workspaces.get(workspace);
+			if (entry === void 0) return {
+				workspace,
+				at: 0,
+				units: []
+			};
+			const units = [...entry.units.entries()].map(([unit, one]) => {
+				const cards = [...one.cards.values()].sort((a, b) => a.route.localeCompare(b.route));
+				const okAt = cards.reduce((best, card) => card.phase === "ready" && (best === null || card.at > best) ? card.at : best, null);
+				return {
+					unit,
+					at: one.at,
+					okAt,
+					cards,
+					...one.crash === void 0 ? {} : { crash: one.crash }
+				};
+			});
+			units.sort((a, b) => b.at - a.at || a.unit.localeCompare(b.unit));
+			return {
+				workspace,
+				at: entry.at,
+				units
+			};
+		}
+	};
+}
 //#endregion
 //#region ../shared/dist/host/provision.js
 var PROVISION_ACTIONS = [
@@ -1480,7 +1434,7 @@ function changesHandler(log) {
 }
 function preflightHandler(preflight) {
 	return (search) => {
-		preflight.run({ force: flag(search, "force") });
+		preflight.run({ hard: flag(search, "hard") });
 		return {
 			ok: true,
 			...preflight.snapshot()
@@ -1596,11 +1550,17 @@ var LIVE = /* @__PURE__ */ new Set(["running", "needs-login"]);
 var RECENT_MS = 6e5;
 function createLongTaskRegistry(deps) {
 	const runs = /* @__PURE__ */ new Map();
+	const controls = /* @__PURE__ */ new Map();
 	const now = deps.now ?? (() => (/* @__PURE__ */ new Date()).toISOString());
 	let counter = 0;
 	const nextId = deps.nextId ?? (() => `run-${Date.now()}-${counter += 1}`);
 	const recentMs = deps.recentMs ?? RECENT_MS;
 	const listeners = /* @__PURE__ */ new Set();
+	const live = (id) => {
+		const current = runs.get(id);
+		if (current === void 0 || !LIVE.has(current.status)) return null;
+		return current;
+	};
 	const notify = (change) => {
 		for (const listener of [...listeners]) try {
 			listener(change);
@@ -1635,7 +1595,13 @@ function createLongTaskRegistry(deps) {
 				if (snapshot.workspace !== workspace) continue;
 				newest.set(snapshot.target, snapshot);
 			}
-			return [...newest.values()].filter((snapshot) => LIVE.has(snapshot.status) || Date.parse(snapshot.at) >= floor).reverse().map((snapshot) => deps.view(snapshot));
+			return [...newest.values()].filter((snapshot) => LIVE.has(snapshot.status) || Date.parse(snapshot.at) >= floor).reverse().map((snapshot) => ({
+				...deps.view(snapshot),
+				id: snapshot.id
+			}));
+		},
+		live() {
+			return [...runs.values()].filter((snapshot) => LIVE.has(snapshot.status));
 		},
 		start(options) {
 			const running = this.active(options.workspace, options.target);
@@ -1650,15 +1616,16 @@ function createLongTaskRegistry(deps) {
 				step: "",
 				steps: [],
 				startedAt,
-				at: startedAt
+				at: startedAt,
+				...options.session === void 0 ? {} : { session: options.session }
 			});
 			notify({
 				kind: "start",
 				snapshot: runs.get(id)
 			});
 			const onStep = (step) => {
-				const current = runs.get(id);
-				if (current === void 0) return;
+				const current = live(id);
+				if (current === null) return;
 				const steps = [...current.steps, `${step.kind === "fail" ? "✗ " : ""}${step.text}`].slice(-20);
 				const extra = deps.step?.(step, current) ?? {};
 				if (step.loginUrl !== void 0) {
@@ -1685,17 +1652,24 @@ function createLongTaskRegistry(deps) {
 					step
 				});
 			};
+			const control = new AbortController();
+			controls.set(id, control);
 			deps.run({
 				payload: options.payload,
-				onStep
+				onStep,
+				signal: control.signal
 			}).then((result) => {
-				const current = runs.get(id);
+				const current = live(id);
+				if (current === null) return;
+				controls.delete(id);
 				patch(id, {
 					status: "ok",
 					...deps.outcome?.(result, current) ?? {},
 					loginUrl: void 0
 				}, { kind: "settle" });
 			}).catch((error) => {
+				if (live(id) === null) return;
+				controls.delete(id);
 				patch(id, {
 					status: "failed",
 					why: error instanceof Error ? error.message : String(error),
@@ -1704,6 +1678,21 @@ function createLongTaskRegistry(deps) {
 			});
 			return runs.get(id);
 		},
+		stop(id, by) {
+			const current = live(id);
+			if (current === null) return false;
+			controls.get(id)?.abort();
+			controls.delete(id);
+			patch(id, {
+				...deps.stopped?.(current) ?? {},
+				status: "stopped",
+				loginUrl: void 0
+			}, {
+				kind: "settle",
+				by
+			});
+			return true;
+		},
 		snapshot(id) {
 			return runs.get(id) ?? null;
 		},
@@ -1736,6 +1725,7 @@ function createLongTaskHost(options) {
 			offs.push(registry.onChange((change) => {
 				const named = [runsRouteOf(options.unit), ...facts?.(change) ?? []];
 				options.bump([...new Set(named)]);
+				options.notify?.(change);
 			}));
 			return registry;
 		} },
@@ -1802,7 +1792,7 @@ var PLUGIN_LEDGER_FILE = "plugins.json";
 function ledgerKeyOf(entry) {
 	return `${entry.opencliHome}\u0000${entry.package}`;
 }
-function textOf$5(value) {
+function textOf$6(value) {
 	if (typeof value !== "string") return void 0;
 	const trimmed = value.trim();
 	return trimmed === "" ? void 0 : trimmed;
@@ -1810,13 +1800,13 @@ function textOf$5(value) {
 function entryOf$1(value) {
 	if (typeof value !== "object" || value === null) return void 0;
 	const box = value;
-	const opencliHome = textOf$5(box["opencliHome"]);
-	const pkg = textOf$5(box["package"]);
-	const installedAt = textOf$5(box["installedAt"]);
+	const opencliHome = textOf$6(box["opencliHome"]);
+	const pkg = textOf$6(box["package"]);
+	const installedAt = textOf$6(box["installedAt"]);
 	if (opencliHome === void 0 || pkg === void 0 || installedAt === void 0) return void 0;
-	const name = textOf$5(box["name"]);
-	const registry = textOf$5(box["registry"]);
-	const releasedAt = textOf$5(box["releasedAt"]);
+	const name = textOf$6(box["name"]);
+	const registry = textOf$6(box["registry"]);
+	const releasedAt = textOf$6(box["releasedAt"]);
 	return {
 		opencliHome,
 		package: pkg,
@@ -2098,6 +2088,154 @@ var TEXT_OUTPUT = {
 function jsonText(value) {
 	return JSON.stringify(value);
 }
+/**
+* 外壳愿意认的协议版本；不在表里的模块当场被拒，不猜语义。
+*/
+var SUPPORTED_API_VERSIONS = [1];
+/**
+* 协议认得的全部键；写了别的键不会被采纳（外壳静默忽略），所以字段名拼错不会有提示。
+*/
+var DECLARATION_KEYS = [
+	"apiVersion",
+	"unit",
+	"card",
+	"tools",
+	"host",
+	"env"
+];
+/**
+* 协议要求必写的键；env 不在其中（没有环境需要就不写）。
+*/
+var DECLARATION_REQUIRED_KEYS = [
+	"apiVersion",
+	"unit",
+	"card",
+	"tools",
+	"host"
+];
+var CARD_KEYS = ["titleKey", "order"];
+var TOOL_KEYS = [
+	"name",
+	"writes",
+	"key"
+];
+var TOOL_KEY_SHAPE = /^[a-z][a-zA-Z0-9]*$/;
+var HOST_KEYS = ["inject", "optional"];
+function text$1(value) {
+	return typeof value === "string" ? value.trim() : "";
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function outsideKeys(value, allowed) {
+	return Object.keys(value).filter((key) => !allowed.includes(key));
+}
+function listOf(keys) {
+	return keys.map((key) => JSON.stringify(key)).join(" / ");
+}
+function stringArrayProblems(at, value) {
+	if (!Array.isArray(value)) return [`${at} 要是一串字符串，现在是 ${JSON.stringify(value)}`];
+	return value.flatMap((item, index) => text$1(item) === "" ? [`${at}[${index}] 不是非空字符串：${JSON.stringify(item)}`] : []);
+}
+/**
+* 查清单里 dsh.workbench 那一段的形状，回一串给人看的问题（中文，带字段路径）。
+* @param subject 报错时用的主语，一般是包名。
+* @param raw 清单里那段原始值，可能什么都不是。
+* @returns 空数组表示形状过得去；版本不对就当场返回（后面的字段无从判起）。
+*/
+function declarationProblemsOf(subject, raw) {
+	if (!isRecord(raw)) return [`${subject}: dsh.workbench 不是一个对象 —— ${JSON.stringify(raw)}`];
+	const version = raw.apiVersion;
+	if (version === void 0) return [`${subject}: dsh.workbench 没有 apiVersion —— 协议从 v1 起，写 \`"apiVersion": 1\`。缺它 = 外壳不认这个模块（ADR-0038 §2.3）`];
+	if (!Number.isInteger(version) || !SUPPORTED_API_VERSIONS.includes(version)) return [`${subject}: dsh.workbench.apiVersion 是 ${JSON.stringify(version)}，这里只认 ${SUPPORTED_API_VERSIONS.join(" / ")}（要整数）`];
+	const problems = [];
+	const unknown = outsideKeys(raw, DECLARATION_KEYS);
+	if (unknown.length > 0) problems.push(`${subject}: dsh.workbench 里有协议 v1 不认识的键 ${listOf(unknown)} —— 只有 ${listOf(DECLARATION_KEYS)}。（拼错的键会被外壳**静默忽略**：那句声明等于没写）`);
+	for (const key of DECLARATION_REQUIRED_KEYS) if (raw[key] === void 0) problems.push(`${subject}: dsh.workbench 缺 ${key}` + (key === "card" ? "（这个模块没有卡片就写 `\"card\": null`）" : ""));
+	const card = raw.card;
+	if (card !== void 0 && card !== null) {
+		if (!isRecord(card)) problems.push(`${subject}: dsh.workbench.card 要么是对象、要么是 null，现在是 ${JSON.stringify(card)}`);
+		else {
+			const extra = outsideKeys(card, CARD_KEYS);
+			if (extra.length > 0) problems.push(`${subject}: dsh.workbench.card 里有不认的键 ${listOf(extra)} —— card 只有 ${listOf(CARD_KEYS)}（卡片默认显不显示由运行期的面板配置决定，清单里没有这一位）`);
+			if (text$1(card.titleKey) === "") problems.push(`${subject}: dsh.workbench.card.titleKey 要是非空字符串（面板那一格的文案键）`);
+			if (typeof card.order !== "number" || !Number.isFinite(card.order)) problems.push(`${subject}: dsh.workbench.card.order 要是数字，现在是 ${JSON.stringify(card.order)}`);
+		}
+	}
+	const tools = raw.tools;
+	if (tools !== void 0) {
+		if (!Array.isArray(tools)) problems.push(`${subject}: dsh.workbench.tools 要是一串声明，现在是 ${JSON.stringify(tools)}`);
+		else {
+			const seen = /* @__PURE__ */ new Set();
+			const seenKeys = /* @__PURE__ */ new Set();
+			tools.forEach((tool, index) => {
+				const at = `dsh.workbench.tools[${index}]`;
+				if (!isRecord(tool)) {
+					problems.push(`${subject}: ${at} 要是对象，现在是 ${JSON.stringify(tool)}`);
+					return;
+				}
+				const extra = outsideKeys(tool, TOOL_KEYS);
+				if (extra.length > 0) problems.push(`${subject}: ${at} 里有不认的键 ${listOf(extra)} —— tools 只有 ${listOf(TOOL_KEYS)}`);
+				const name = text$1(tool.name);
+				if (name === "") problems.push(`${subject}: ${at}.name 要是非空字符串`);
+				else if (seen.has(name)) problems.push(`${subject}: ${at}.name「${name}」与前面那条撞了 —— 工具名会进 dsh 的工具表，不许重`);
+				else seen.add(name);
+				if (typeof tool.writes !== "boolean") problems.push(`${subject}: ${at}.writes 要是 true / false（它是"这会写"的唯一声明，缺了审批无从认领）`);
+				if (tool.key !== void 0) {
+					const key = text$1(tool.key);
+					if (!TOOL_KEY_SHAPE.test(key)) problems.push(`${subject}: ${at}.key 要是 lowerCamelCase 的标识符（如 \`sync\` / \`podLogs\`），现在是 ${JSON.stringify(tool.key)} —— 它会变成生成物里的键名，所以不引号、不许带点或横线`);
+					else if (seenKeys.has(key)) problems.push(`${subject}: ${at}.key「${key}」与前面那条撞了 —— 生成物里的键只能有一个`);
+					else seenKeys.add(key);
+				}
+			});
+		}
+	}
+	const host = raw.host;
+	if (host !== void 0) {
+		if (!isRecord(host)) problems.push(`${subject}: dsh.workbench.host 要是对象，现在是 ${JSON.stringify(host)}`);
+		else {
+			const extra = outsideKeys(host, HOST_KEYS);
+			if (extra.length > 0) problems.push(`${subject}: dsh.workbench.host 里有不认的键 ${listOf(extra)} —— host 只有 ${listOf(HOST_KEYS)}`);
+			if (host.inject === void 0) problems.push(`${subject}: dsh.workbench.host.inject 没写 —— 它声明这个模块要外壳的哪几个服务，外壳靠它判"能不能挂"。一个都不要也要写 \`"inject": []\``);
+			else problems.push(...stringArrayProblems(`${subject}: dsh.workbench.host.inject`, host.inject));
+			if (host.optional !== void 0) problems.push(...stringArrayProblems(`${subject}: dsh.workbench.host.optional`, host.optional));
+		}
+	}
+	if (raw.env !== void 0 && !isRecord(raw.env)) problems.push(`${subject}: dsh.workbench.env 要是对象（command / plugins / libs）—— 语义由门禁的 env 判据查，这里只查形状`);
+	return problems;
+}
+/**
+* 读一份清单：先查形状，过了再把声明规整成 manifest。
+* @param subject 报错时用的主语。
+* @param raw 清单里 dsh.workbench 那段原始值。
+* @returns 有问题时只有 problems；没问题时 declaration 与 manifest 都给，manifest 里的字符串已 trim。
+*/
+function readDeclaration(subject, raw) {
+	const problems = declarationProblemsOf(subject, raw);
+	if (problems.length > 0) return { problems };
+	const declaration = raw;
+	const card = declaration.card;
+	return {
+		declaration,
+		problems: [],
+		manifest: {
+			id: text$1(declaration.unit),
+			card: card === null ? null : {
+				titleKey: text$1(card.titleKey),
+				order: card.order
+			},
+			tools: declaration.tools.map((tool) => ({
+				name: text$1(tool.name),
+				writes: tool.writes
+			})),
+			host: {
+				inject: [...declaration.host.inject ?? []],
+				...declaration.host.optional === void 0 ? {} : { optional: [...declaration.host.optional] }
+			},
+			...declaration.env === void 0 ? {} : { env: declaration.env }
+		}
+	};
+}
 //#endregion
 //#region ../shared/dist/host/value-handoff.js
 function handoffId(entry) {
@@ -2789,6 +2927,8 @@ 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 LONG_TASKS_LIST_TOOL = "workbench_long_tasks_list";
+var LONG_TASKS_STOP_TOOL = "workbench_long_tasks_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";
@@ -2821,7 +2961,8 @@ var READ_TOOLS = [
 	DIY_LOGS_STOP_TOOL,
 	DIY_RECORD_READ_TOOL,
 	DIY_RECORD_DETAIL_TOOL,
-	DIY_RECORD_STOP_TOOL
+	DIY_RECORD_STOP_TOOL,
+	LONG_TASKS_LIST_TOOL
 ];
 var WRITE_TOOLS = [
 	PANELS_SHOW_TOOL,
@@ -2843,7 +2984,8 @@ var WRITE_TOOLS = [
 	DIY_DEBUG_START_TOOL,
 	DIY_DEBUG_PAUSE_TOOL,
 	DIY_DEBUG_RESUME_TOOL,
-	DIY_DEBUG_STOP_TOOL
+	DIY_DEBUG_STOP_TOOL,
+	LONG_TASKS_STOP_TOOL
 ];
 var DIY_TOOLS = [
 	DIY_LIST_TOOL,
@@ -2902,6 +3044,7 @@ var panelsUnit = {
 //#endregion
 //#region src/modules/panels/model/approval.ts
 var SPEC_LIMIT = 80;
+var TARGET_LIMIT = 20;
 function missing(id) {
 	return id === void 0 || id === "";
 }
@@ -2976,7 +3119,32 @@ function askOf(reason, question, fallback) {
 		fallback
 	};
 }
+function textOf$5(raw, key) {
+	const value = raw[key];
+	return typeof value === "string" ? value.trim() : "";
+}
+function clipped(text) {
+	const chars = [...text];
+	return chars.length > TARGET_LIMIT ? `${chars.slice(0, TARGET_LIMIT).join("")}…` : text;
+}
+function stopVerdict(call, runs) {
+	const raw = argsOf$2(call);
+	const unit = textOf$5(raw, "unit");
+	const id = textOf$5(raw, "id");
+	if (unit === "" || id === "") return { kind: "allow" };
+	const run = runs?.().get(unit)?.snapshot(id) ?? null;
+	if (runs !== void 0 && run === null) return { kind: "allow" };
+	const session = run?.session ?? "";
+	if (session !== "" && session === call.session) return { kind: "allow" };
+	const target = run === null ? "" : run.target.trim();
+	const where = target === "" ? `工作台 [${unit}] 那一趟长任务` : `工作台 [${unit}] 那一趟「${clipped(target)}」长任务`;
+	const whereEn = target === "" ? `a long-running workbench job [${unit}]` : `a long-running workbench job [${unit}] "${clipped(target)}"`;
+	const origin = session === "" ? "用户自己按的" : "别的会话起的";
+	const originEn = session === "" ? "the user started" : "another session started";
+	return askOf(`${LONG_TASKS_STOP_TOOL} ${unit} stops a long run someone else started`, pair(`会停掉${where}，${origin}，允许吗？`, `it stops ${whereEn} ${originEn}. Allow?`), pair(`agent 想停掉${where}，${origin}，允许吗？`, `The agent wants to stop ${whereEn} ${originEn}. Allow?`));
+}
 var panelsApproval = (call) => {
+	if (call.name === "workbench_long_tasks_stop") return stopVerdict(call, void 0);
 	if (call.name === "workbench_diy_debug_start" || call.name === "workbench_diy_debug_resume") {
 		const starting = call.name === DIY_DEBUG_START_TOOL;
 		const unit = argsOf$2(call)["unit"];
@@ -3048,6 +3216,15 @@ var panelsApproval = (call) => {
 		default: return;
 	}
 };
+/**
+* 面板族的审批策略：`panelsApproval` 再认长任务那一档（写成功要用户点头）。
+* `longTaskRuns` 用来查"这一趟是谁起的" —— 自己起的免问，别的会话起的 / 用户按的要问。
+* @param longTaskRuns 当前挂着的单元各自那把长任务注册表；没给就按"别人的"问（保守的那一侧）。
+* @returns 审批策略：认领的写工具回 ask / allow，不是本族的回 undefined。
+*/
+function panelsApprovalFor(longTaskRuns) {
+	return (call) => call.name === "workbench_long_tasks_stop" ? stopVerdict(call, longTaskRuns) : panelsApproval(call);
+}
 //#endregion
 //#region src/modules/panels/model/config.ts
 var EMPTY_BOARD = {
@@ -3162,40 +3339,225 @@ function added(list, id) {
 function dropped(list, id) {
 	return list.filter((item) => item !== id);
 }
-function withShown(board, id, visible) {
-	const next = {
-		shown: added(board.shown, id),
-		hidden: dropped(board.hidden, id)
-	};
-	return visible === void 0 ? next : {
-		...next,
-		order: added(board.order ?? visible, id)
-	};
+function withShown(board, id, visible) {
+	const next = {
+		shown: added(board.shown, id),
+		hidden: dropped(board.hidden, id)
+	};
+	return visible === void 0 ? next : {
+		...next,
+		order: added(board.order ?? visible, id)
+	};
+}
+function withHidden(board, id) {
+	const order = dropped(board.order ?? [], id);
+	return {
+		shown: dropped(board.shown, id),
+		hidden: added(board.hidden, id),
+		...order.length === 0 ? {} : { order }
+	};
+}
+function withoutPanel(board, id) {
+	return {
+		shown: dropped(board.shown, id),
+		hidden: dropped(board.hidden, id)
+	};
+}
+function withMoved(board, id, index, visible) {
+	const current = visible.includes(id) ? [...visible] : [...visible, id];
+	const from = current.indexOf(id);
+	const to = Math.max(0, Math.min(current.length - 1, Math.trunc(index)));
+	if (from !== to) current.splice(to, 0, ...current.splice(from, 1));
+	return {
+		shown: added(board.shown, id),
+		hidden: dropped(board.hidden, id),
+		order: current
+	};
+}
+//#endregion
+//#region src/modules/panels/model/long-task-tools.ts
+var STATUS_WORDS = {
+	running: "进行中",
+	"needs-login": "要登录",
+	stopped: "被停了",
+	ok: "已完成",
+	failed: "出错"
+};
+var NO_WORKSPACE = "不知道当前会话在哪个工作区 —— 长任务按工作区记，这条读不了。";
+var NO_RUNS = "这个工作区现在没有长任务在跑（也没有十分钟内刚收尾的）。";
+var NO_RUN = "没有这一趟 —— unit/id 对不上。";
+var STALE_REGISTRY = "这一份外壳还是上一版的注册表，停不了 —— 重新起一下工作台就能停";
+var LIST_OUTPUT = {
+	schema: {
+		type: "object",
+		properties: {
+			text: { type: "string" },
+			runs: {
+				type: "array",
+				items: {
+					type: "object",
+					properties: {
+						unit: { type: "string" },
+						id: { type: "string" },
+						target: { type: "string" },
+						status: { type: "string" }
+					},
+					additionalProperties: true
+				}
+			}
+		},
+		additionalProperties: true
+	},
+	render: (_args, value) => [{
+		type: "text",
+		text: typeof value?.text === "string" ? value.text : JSON.stringify(value)
+	}]
+};
+var STOP_OUTPUT = {
+	schema: {
+		type: "object",
+		properties: {
+			text: { type: "string" },
+			stopped: { type: "boolean" }
+		},
+		additionalProperties: true
+	},
+	render: (_args, value) => [{
+		type: "text",
+		text: typeof value?.text === "string" ? value.text : JSON.stringify(value)
+	}]
+};
+function str(value) {
+	return typeof value === "string" ? value.trim() : "";
+}
+function arg(raw, key) {
+	return str(typeof raw === "object" && raw !== null ? raw[key] : void 0);
+}
+function statusWord(status) {
+	return STATUS_WORDS[status] ?? status;
+}
+function originOf(session, caller) {
+	if (session === "") return "用户按的";
+	return session === caller ? "我起的" : "别的会话起的";
+}
+function listed$1(runs, workspace) {
+	const out = [];
+	for (const [unit, registry] of runs?.() ?? []) for (const row of registry.current(workspace)) {
+		const id = str(row["id"]);
+		const run = id === "" ? null : registry.snapshot(id);
+		out.push({
+			unit,
+			id,
+			target: str(row["target"]) || str(run?.target),
+			status: str(row["status"]) || str(run?.status),
+			step: str(row["step"]) || str(row["why"]) || str(run?.step) || str(run?.why),
+			session: str(row["session"]) || str(run?.session)
+		});
+	}
+	return out;
+}
+function lineOf(run, index, caller) {
+	const parts = [
+		run.unit,
+		run.target,
+		statusWord(run.status),
+		run.step,
+		run.id === "" ? "" : `id=${run.id}`,
+		originOf(run.session, caller)
+	];
+	return `${String(index + 1)}. ${parts.filter((part) => part !== "").join(" · ")}`;
 }
-function withHidden(board, id) {
-	const order = dropped(board.order ?? [], id);
-	return {
-		shown: dropped(board.shown, id),
-		hidden: added(board.hidden, id),
-		...order.length === 0 ? {} : { order }
-	};
+function renderList$1(runs, workspace, caller) {
+	if (runs.length === 0) return NO_RUNS;
+	return [`当前工作区：${workspace}`, ...runs.map((run, index) => lineOf(run, index, caller))].join("\n");
 }
-function withoutPanel(board, id) {
-	return {
-		shown: dropped(board.shown, id),
-		hidden: dropped(board.hidden, id)
+/**
+* 注册长任务那两把外壳工具：看得见（`workbench_long_tasks_list`）与停得了任何单元的一趟
+* （`workbench_long_tasks_stop`）。`longTaskRuns` 是晚绑定的取值器：两把都从它取注册表，
+* 所以单元晚挂上 / 被摘掉都跟得上；没给的话停那把一律回"没有这一趟"。
+* @param ctx 宿主上下文，`tools` 服务不在时什么都不注册。
+* @param longTaskRuns 当前挂着的单元各自那把长任务注册表。
+* @returns 注销函数（没有 tools 服务就是空数组）。
+*/
+function registerLongTaskTools(ctx, longTaskRuns) {
+	const tools = ctx.get("tools");
+	if (tools === void 0) {
+		ctx.logger?.info?.("[dsh-workbench] 没有 tools 服务，跳过外壳长任务工具注册");
+		return [];
+	}
+	const listTool = {
+		name: LONG_TASKS_LIST_TOOL,
+		description: "看这个工作区在跑（或十分钟内刚收尾）的长任务：每行是 单元 · 目标 · 状态 · 当前一步 · id · 谁起的；要停哪一趟用 workbench_long_tasks_stop。",
+		parameters: {
+			type: "object",
+			properties: {},
+			additionalProperties: false
+		},
+		output: LIST_OUTPUT,
+		async execute(_raw, exec) {
+			const workspace = sessionWorkspace(exec);
+			if (workspace === null) return {
+				runs: [],
+				text: NO_WORKSPACE
+			};
+			const runs = listed$1(longTaskRuns, workspace);
+			return {
+				runs,
+				text: renderList$1(runs, workspace, sessionIdOf(exec))
+			};
+		}
 	};
-}
-function withMoved(board, id, index, visible) {
-	const current = visible.includes(id) ? [...visible] : [...visible, id];
-	const from = current.indexOf(id);
-	const to = Math.max(0, Math.min(current.length - 1, Math.trunc(index)));
-	if (from !== to) current.splice(to, 0, ...current.splice(from, 1));
-	return {
-		shown: added(board.shown, id),
-		hidden: dropped(board.hidden, id),
-		order: current
+	const stopTool = {
+		name: LONG_TASKS_STOP_TOOL,
+		description: "停掉某一趟长任务（unit 与 id 从 workbench_long_tasks_list 拿）。只是让外壳给它发中断信号，平台侧那趟活儿的收尾看模块自己。",
+		parameters: {
+			type: "object",
+			properties: {
+				unit: {
+					type: "string",
+					description: "那一趟属于的单元 id（如 cmdb）。"
+				},
+				id: {
+					type: "string",
+					description: "那一趟的 id（列表里 id= 后面那串）。"
+				}
+			},
+			required: ["unit", "id"],
+			additionalProperties: false
+		},
+		output: STOP_OUTPUT,
+		async execute(raw, exec) {
+			const unit = arg(raw, "unit");
+			const id = arg(raw, "id");
+			if (unit === "" || id === "") return {
+				text: NO_RUN,
+				stopped: false
+			};
+			const registry = longTaskRuns?.().get(unit);
+			if (registry === void 0 || typeof registry.stop !== "function") return {
+				text: registry === void 0 ? NO_RUN : STALE_REGISTRY,
+				stopped: false
+			};
+			const run = registry.snapshot(id);
+			if (run === null) return {
+				text: NO_RUN,
+				stopped: false
+			};
+			if (run.workspace !== sessionWorkspace(exec)) return {
+				text: `这一趟不在你当前的工作区（它在 ${run.workspace}）—— 没动它。`,
+				stopped: false
+			};
+			if (!registry.stop(id, sessionIdOf(exec) ?? void 0)) return {
+				text: `这一趟已经不在跑了（${statusWord(run.status)}）—— 没动它。`,
+				stopped: false
+			};
+			return {
+				text: `停了：${unit} · ${run.target}（${id}）。这一趟的活儿收到中断信号 —— 它认不认、停在哪一步看它自己。`,
+				stopped: true
+			};
+		}
 	};
+	return [tools.register(listTool), tools.register(stopTool)];
 }
 //#endregion
 //#region src/shared/api/host/diy-components.ts
@@ -3658,6 +4020,18 @@ async function resolveAt(registry, dir) {
 function looksLikeWorkshop(dir) {
 	return existsSync(join(dir, "packages")) || existsSync(join(dir, "pnpm-workspace.yaml"));
 }
+/**
+* 工坊**自己的家**（`$DSH_HOME/workbench/diy`）—— 宿主启动时就是按它把工坊登记成工作区的。
+* DIY 会话的工坊根取这一份，**不随会话 cwd 漂**：cwd 一离开工坊（用户把自己的项目设成工作区），
+* 从 cwd 往上找会撞上任意一个"带 `packages/` 的仓库"，于是模块列表、`shots/` 落点、装机名单全跟着变样。
+* 这一档拿不到（没有 `dshHomePath` 服务）时才退回 cwd 那套。
+* @param ctx - 宿主上下文（要从里面取 `dshHomePath`）。
+* @returns 工坊的家；取不到给 `null`。
+*/
+function workshopHomeOf(ctx) {
+	const path = workshopPathOf(ctx);
+	return path === null ? null : rootAt(path, WORKSHOP_TITLE);
+}
 async function workshopRootOf(ctx, workspace) {
 	const start = typeof workspace === "string" ? workspace.trim() : "";
 	if (start === "") return null;
@@ -3750,10 +4124,19 @@ function showOrReason(panels, unit, workspace) {
 		};
 	}
 }
+/**
+* 这一次 DIY 调用落在哪个工坊上：**先认工坊自己的家**（`$DSH_HOME/workbench/diy`，宿主就是按它把工坊
+* 登记成工作区的），**不跟着会话 cwd 走** —— 用户把自己的项目设成工作区时，cwd 往上找会撞上任意一个
+* 带 `packages/` 的仓库，模块列表与 `shots/` 落点会一起变样（真机踩过：录制落点跑到仓库根、截图 EPERM）。
+* 只有拿不到工坊的家时，才退回"从会话工作区往上找像工坊的目录"。
+* @param ctx - 宿主上下文。
+* @param exec - 这次工具调用（退回那一档要读它的会话工作区）。
+* @returns 工坊的 packages 目录、根路径与标题。
+*/
 async function workshopOf(ctx, exec) {
 	const session = sessionWorkspace(exec);
-	const root = await workshopRootOf(ctx, session);
-	if (root === null) throw new Error(`这个工作区没有模块包可落地：DIY 工具把模块放在会话工作区的 packages/ 下（这个会话的工作区 ${session ?? "(不知道)"}）—— 换到一个有模块包的工作区，或者按工程域在仓库里用 dsh-wb-module 新建一个模块包`);
+	const root = workshopHomeOf(ctx) ?? await workshopRootOf(ctx, session);
+	if (root === null) throw new Error(`这台机器上没有工坊可落地（既没有 \$DSH_HOME/workbench/diy，会话工作区也没有模块包）（这个会话的工作区 ${session ?? "(不知道)"}）—— 先在工坊里造一个模块，或者按工程域在仓库里用 dsh-wb-module 新建一个模块包`);
 	return {
 		packagesDir: root.packagesDir,
 		workspace: root.root,
@@ -4275,7 +4658,7 @@ async function stopNetworkExact(shell, file, timeoutMs = SWEEP_TIMEOUT_MS) {
 		`[ -n "$p" ] && kill "$p" 2>/dev/null`,
 		`[ -n "$r" ] && pkill -P "$r" 2>/dev/null`,
 		`[ -n "$r" ] && kill "$r" 2>/dev/null`,
-		`if [ "$(cat ${pidFile} 2>/dev/null)" = "$p" ]; then rm -f ${quoteShellArg(file)} ${pidFile} ${reaperFile}; fi`,
+		`if [ "$(cat ${pidFile} 2>/dev/null)" = "$p" ]; then rm -f ${pidFile} ${reaperFile}; fi`,
 		"true"
 	].join("; "), { timeoutMs })).exitCode === 0;
 }
@@ -6344,7 +6727,7 @@ var RECORD_ARM_SCRIPT = `(() => {
   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 blank = () => ({ phase: 'armed', t0: null, t1: null, href: location.href, dropped: 0, calls: [], shots: 0, shotsAt: null });
   const readKeep = () => {
     try {
       const raw = sessionStorage.getItem(KEEP);
@@ -6379,23 +6762,64 @@ var RECORD_ARM_SCRIPT = `(() => {
   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),
+  const beatOf = (kind) => {
+    try {
+      state.beatN = (typeof state.beatN === 'number' ? state.beatN : 0) + 1;
+      state.beatKind = kind;
+      state.beatAt = Date.now();
+      keep();
+      if (typeof window.__dshBeatWake === 'function') {
+        const wake = window.__dshBeatWake;
+        window.__dshBeatWake = null;
+        wake();
+      }
+    } catch (error) {}
+  };
+  const pending = [];
+  const begin = (method, url, body) => {
+    if (state.phase !== 'recording') return null;
+    const target = String(url === undefined || url === null ? '' : url);
+    const verb = String(method === '' || method === undefined ? 'GET' : method).toUpperCase();
+    const row = {
+      method: verb,
+      url: target,
       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),
+      status: 0,
+      ct: '',
+      response: '',
       at: Date.now(),
-    });
+    };
+    state.calls.push(row);
     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);
     }
+    pending.push(row);
     keep();
     repaint();
+    return row;
+  };
+  const complete = (row, status, ct, response) => {
+    row.status = typeof status === 'number' ? status : 0;
+    row.ct = String(ct === undefined || ct === null ? '' : ct);
+    row.response = slice(response === undefined || response === null ? '' : response);
+  };
+  const record = (method, url, body, status, ct, response) => {
+    const row = begin(method, url, body);
+    if (row === null) return;
+    complete(row, status, ct, response);
+    keep();
+  };
+  const finish = (row, method, url, body, status, ct, response) => {
+    const at = row === null || row === undefined ? -1 : pending.indexOf(row);
+    if (at >= 0) pending.splice(at, 1);
+    if (at >= 0 && state.calls.indexOf(row) >= 0) {
+      complete(row, status, ct, response);
+      keep();
+      repaint();
+      return;
+    }
+    record(method, url, body, status, ct, response);
   };
   const fresh = typeof window[OFF] !== 'function';
   if (fresh) {
@@ -6426,6 +6850,7 @@ var RECORD_ARM_SCRIPT = `(() => {
       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 row = begin(method, url, body);
       const done = realFetch.apply(this, args);
       try {
         done.then((response) => {
@@ -6433,11 +6858,11 @@ var RECORD_ARM_SCRIPT = `(() => {
             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, ''));
+            clone.text().then((text) => finish(row, method, target, body, response.status, ct, text)).catch(() => finish(row, 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));
+            finish(row, method, url, body, 0, 'fetch-error', String(error !== null && typeof error === 'object' && error.message !== undefined ? error.message : error));
           } catch (inner) {}
         });
       } catch (error) {}
@@ -6455,9 +6880,10 @@ var RECORD_ARM_SCRIPT = `(() => {
           xhr.removeEventListener('loadend', xhr.__dshLoadEnd);
         } catch (error) {}
       }
+      const row = begin(xhr.__dshMethod, xhr.__dshUrl, body);
       const onEnd = () => {
         try {
-          record(xhr.__dshMethod, xhr.__dshUrl, body, xhr.status, ctOf(xhr), textOf(xhr));
+          finish(row, xhr.__dshMethod, xhr.__dshUrl, body, xhr.status, ctOf(xhr), textOf(xhr));
         } catch (error) {}
       };
       xhr.__dshLoadEnd = onEnd;
@@ -6467,7 +6893,7 @@ var RECORD_ARM_SCRIPT = `(() => {
     if (hasBeacon) {
       navigator.sendBeacon = function (url, data) {
         try {
-          record('POST', url, data === undefined || data === null ? '' : data, 0, 'beacon', '');
+          begin('POST', url, data === undefined || data === null ? '' : data);
         } catch (error) {}
         return realBeacon.apply(navigator, arguments);
       };
@@ -6536,23 +6962,31 @@ var RECORD_ARM_SCRIPT = `(() => {
   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 shot = 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>开始';
+  shot.type = 'button';
+  shot.setAttribute('title', '拍一张当前页面的截图');
+  shot.setAttribute('aria-label', '拍一张当前页面的截图');
+  shot.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"><path d="M1.5 5V1.5H5M11 1.5h3.5V5M14.5 11v3.5H11M5 14.5H1.5V11"></path><rect x="6" y="6" width="4" height="4" rx="1"></rect></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 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:' + (on ? '#fff' : 'rgba(255,255,255,.45)') + ';background:' + (on ? '#3b82f6' : '#2b3444');
   const paint = () => {
     const phase = state.phase;
-    label.textContent = (phase === 'recording' ? '录制中 · ' : phase === 'finished' ? '录制完成 · ' : '录制 · 等开始 · ') + String(state.calls.length) + ' 条';
+    const taken = typeof state.shots === 'number' ? state.shots : 0;
+    label.textContent = (phase === 'recording' ? '录制中 · ' : phase === 'finished' ? '录制完成 · ' : '录制 · 等开始 · ') + String(state.calls.length) + ' 条' + (taken > 0 ? ' · 已拍 ' + String(taken) + ' 张' : '');
     dot.style.display = phase === 'recording' ? 'inline-block' : 'none';
     start.disabled = phase !== 'armed';
+    shot.disabled = phase !== 'recording';
     end.disabled = phase !== 'recording';
     start.setAttribute('style', look(phase === 'armed'));
+    shot.setAttribute('style', look(phase === 'recording'));
     end.setAttribute('style', look(phase === 'recording'));
   };
   state.__repaint = paint;
@@ -6604,12 +7038,22 @@ var RECORD_ARM_SCRIPT = `(() => {
     state.href = location.href;
     state.calls = [];
     state.dropped = 0;
+    beatOf('start');
+    keep();
+    paint();
+  };
+  shot.onclick = () => {
+    if (state.phase !== 'recording') return;
+    state.shots = (typeof state.shots === 'number' ? state.shots : 0) + 1;
+    state.shotsAt = Date.now();
+    beatOf('shot');
     keep();
     paint();
   };
   end.onclick = () => {
     state.phase = 'finished';
     state.t1 = Date.now();
+    beatOf('stop');
     keep();
     paint();
   };
@@ -6617,15 +7061,17 @@ var RECORD_ARM_SCRIPT = `(() => {
   bar.appendChild(grip);
   bar.appendChild(dot);
   bar.appendChild(label);
+  bar.appendChild(shot);
   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 };
+  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, shots: typeof state.shots === 'number' ? state.shots : 0, shotsAt: typeof state.shotsAt === 'number' ? state.shotsAt : null, dropped: typeof state.dropped === 'number' ? state.dropped : 0 };
 })()`;
-var RECORD_READ_SCRIPT = `(() => {
+var RECORD_READ_SCRIPT = `(async () => {
   const KEY = ${JSON.stringify(RECORD_KEY)};
   const KEEP = ${JSON.stringify(RECORD_KEEP_KEY)};
+  const BEAT_WAIT = 3000;
   let state = window[KEY] !== null && typeof window[KEY] === 'object' ? window[KEY] : null;
   if (state === null) {
     try {
@@ -6635,8 +7081,29 @@ var RECORD_READ_SCRIPT = `(() => {
       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 : [] };
+  if (state === null || typeof state !== 'object') return { ok: false, code: 'not-armed', phase: 'none', calls: [], shots: 0, shotsAt: null, beat: false, beatKind: '' };
+  const from = typeof state.beatSeen === 'number' ? state.beatSeen : 0;
+  let resolveWake = null;
+  const woken = new Promise((resolve) => {
+    resolveWake = resolve;
+  });
+  const onBeat = () => {
+    const go = resolveWake;
+    resolveWake = null;
+    if (go !== null) go();
+  };
+  window.__dshBeatWake = onBeat;
+  const changed = () => (typeof state.beatN === 'number' ? state.beatN : 0) !== from;
+  if (!changed()) {
+    let timer = null;
+    await Promise.race([woken, new Promise((resolve) => { timer = setTimeout(resolve, BEAT_WAIT); })]);
+    if (timer !== null) clearTimeout(timer);
+  }
+  if (window.__dshBeatWake === onBeat) window.__dshBeatWake = null;
+  const after = typeof state.beatN === 'number' ? state.beatN : 0;
+  const beat = after !== from;
+  state.beatSeen = after;
+  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, shots: typeof state.shots === 'number' ? state.shots : 0, shotsAt: typeof state.shotsAt === 'number' ? state.shotsAt : null, beat, beatKind: beat && typeof state.beatKind === 'string' ? state.beatKind : '', calls: Array.isArray(state.calls) ? state.calls : [] };
 })()`;
 var RECORD_STOP_SCRIPT = `(() => {
   const KEY = ${JSON.stringify(RECORD_KEY)};
@@ -6895,6 +7362,10 @@ function recordPageOf(payload) {
 		here: typeof raw["here"] === "string" ? raw["here"] : "",
 		dropped: typeof raw["dropped"] === "number" ? raw["dropped"] : 0,
 		unhooked: raw["unhooked"] === 1 || raw["unhooked"] === true,
+		shots: typeof raw["shots"] === "number" ? raw["shots"] : 0,
+		shotsAt: typeof raw["shotsAt"] === "number" ? raw["shotsAt"] : null,
+		beat: raw["beat"] === true,
+		beatKind: typeof raw["beatKind"] === "string" ? raw["beatKind"] : "",
 		calls
 	};
 }
@@ -6975,21 +7446,43 @@ function sizeText(bytes) {
 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)}）`;
+	const identity = one.key === "" ? `${one.method} ${one.url}` : one.key;
+	const how = one.key === "" ? "无 key" : `at ${String(one.at)}`;
+	return `· [${String(one.index)}]${mark} ${identity}（${where} · 入参 ${one.hasRequest ? "有" : "无"} · 出参 ${sizeText(one.size)} · ${how}）`;
+}
+function shortPath(path) {
+	const at = path.lastIndexOf("shots/");
+	return at >= 0 ? path.slice(at) : path;
+}
+function shotFaultLines(shots) {
+	return shots.filter((one) => one.error !== void 0).map((one) => `（他按了「截图」，但有一张图没落下来：${shortPath(one.path)} —— ${one.error ?? ""}）`);
+}
+function beatLineOf(beats, beatMs) {
+	return beats > 0 ? `门铃：${String(beats)} 次（最近 ${String(beatMs)} 毫秒）` : "";
+}
+function evidenceTailOf(shots, beats, beatMs) {
+	const parts = [];
+	const landed = shots.filter((one) => one.error === void 0).length;
+	if (landed > 0) parts.push(`图 ${String(landed)} 张`);
+	const beat = beatLineOf(beats, beatMs);
+	if (beat !== "") parts.push(beat);
+	return parts.join(" · ");
 }
 function renderRecordRead(input) {
+	const shots = input.shots ?? [];
+	const tail = evidenceTailOf(shots, input.beats ?? 0, input.beatMs ?? 0);
+	const sep = tail === "" ? "" : ` · ${tail}`;
+	const faults = shotFaultLines(shots);
 	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);
+	if (input.phase === "recording") return [`还在录（页面钩子上已经攒了 ${String(input.hookCaught)} 条）—— 等他按「结束录制」。${sep}`, ...faults].join("\n");
+	const marked = input.rows.filter((one) => one.marked);
+	const markShown = 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)} 行那顶帽），是**这一读本身被输出上限截了** —— 读到的只是最近一段，上面那几个捕获数只对读到的这段成立）`);
+	const lines = [...input.capturedTruncated ? [input.capturedTotalLines > input.capturedTailLimit ? `（捕获文件这一场一共落了 ${String(input.capturedTotalLines)} 行，这里只解析了最后 ${String(input.capturedTailLimit)} 行 —— 更早的没看；下面的清单只对最后这段成立）` : `（捕获文件这一场一共落了 ${String(input.capturedTotalLines)} 行（没顶到 ${String(input.capturedTailLimit)} 行那顶帽），是**这一读本身被输出上限截了** —— 读到的只是最近一段，下面的清单只对读到的这段成立）`] : [], ...faults];
+	if (input.rows.length > 0) lines.push(`录完了 · ${String(input.merged)} 条（⭐ ${String(marked.length)}）${sep}`, ...shown.map(rowTextOf));
+	else lines.push(input.capturedTruncated ? `录完了：这一段（就解析到的那部分而言）一条请求都没抓到（页面钩子 0 条 · 解析到的会话捕获里落在这个时间段里 0 条）—— 但捕获文件被截过，见上面那行。${sep}` : `录完了：这一段一条请求都没抓到（页面钩子 0 条 · 会话捕获落在这个时间段里 0 条，两边都是 0 —— 不是筛掉的）。${sep}`);
 	if (input.dropped > 0) lines.push(`（缓冲区满了，最早丢了 ${String(input.dropped)} 条）`);
 	if (input.captureRound === "fail") lines.push("（会话捕获最近一轮没跑成（opencli 那条报了错）—— 这一场可能只有页面钩子。）");
 	else if (input.captureRound === "") lines.push("（会话捕获还没回过一轮 —— 再等一拍再看，别急着下\"没抓到\"的结论。）");
@@ -7010,6 +7503,7 @@ function clip(text, maxBytes) {
 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);
@@ -7064,7 +7558,10 @@ 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)(\\?|$))";
+/**
+* 捕获那一层要滤掉的 URL：静态资源（`data:` 与常见后缀）。用法 `new RegExp(...).test(url)`，命中即丢。
+*/
+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\")}});";
@@ -7089,6 +7586,48 @@ function captureFileOf(packagesDir, unit) {
 function lastCaptureFileOf(file) {
 	return `${file}.last`;
 }
+/**
+* 这一族自己的落图路径：跟 `rec-<unit>.jsonl` 同目录、`rec-shot-` 前缀（工坊那一页的图另有名字）。
+* @param captureFile - 这一场捕获文件；图就落在它旁边。@param unit - 单元名。@param n - 页面「已拍」计数。
+* @returns 形如 `…/shots/rec-shot-<unit>-<n>.png` 的路径。
+*/
+function shotFileOf(captureFile, unit, n) {
+	return join(dirname(captureFile), `rec-shot-${unit}-${n}.png`);
+}
+/**
+* 把这一张现场图落进 `shots/`：argv **只有 `screenshot <path>`，一个视口参数都不给** —— `--full-page` 走
+* `captureBeyondViewport`、`--width` / `--height` 走 `setDeviceMetricsOverride`：真机上按一下页面**看得见地闪**
+* （2026-10-21 两次报过）、还可能让填了一半的表单跳位；调试族那把平时也是这一档（先 `eval` 量盒子再本地 `clip`）。
+* 真机上这个平台整页高与视口一样（1512×698）—— `--full-page` 一点没多给，白闪。
+* @param input - 看护那一拍的依赖（shell / 命令 / 会话 / 台账）。
+* @param held - 当前那份约定（路径按它的 `unit` 拼）。@param n - 页面浮条上那个「已拍」计数。
+*/
+async function takeShotOf(input, held, n) {
+	const path = shotFileOf(input.captureFile, held.unit, n);
+	const at = Date.now();
+	try {
+		const step = await actBrowser(input.shell, input.command, BROWSER_RECORD_SESSION, ["screenshot", path]);
+		if (step.ok) input.store.shotTaken(input.sessionId, {
+			n,
+			at,
+			path
+		}, Date.now());
+		else input.store.shotFailed(input.sessionId, {
+			n,
+			at,
+			path,
+			error: actErrorOf(step)
+		}, Date.now());
+	} catch (error) {
+		const text = error instanceof Error ? error.message : String(error);
+		input.store.shotFailed(input.sessionId, {
+			n,
+			at,
+			path,
+			error: text
+		}, Date.now());
+	}
+}
 async function startRecordCapture(shell, command, session, file) {
 	const bin = command === "" ? "opencli" : command;
 	const arm = backgroundLine(bin, [
@@ -7128,6 +7667,30 @@ async function releaseLeftoversOf(input) {
 		captureFile: input.captureFile
 	});
 }
+async function stopCaptureQuiet(input) {
+	try {
+		return await stopNetworkExact(input.shell, input.captureFile);
+	} catch {
+		return false;
+	}
+}
+async function closeRecordTabQuiet(input) {
+	try {
+		return await closeRecordTab(input.shell, input.command, BROWSER_RECORD_SESSION, input.url);
+	} catch {
+		return false;
+	}
+}
+/**
+* 看护的一拍（= 一圈循环）：读数那一条 `eval` **自己在页面里最多等 `RECORD_WATCH_MS`**（浮条在他按
+* 「开始 / 截图 / 结束」时会唤醒挂在页面上的那个 waiter ⇒ 一按就回来），所以这一轮 = **恰好一条 `eval`**：
+* 命中就立刻做那一拍，没人按就照旧 3 秒一拍 —— 兜底周期一字未变。该落图就落图；认到「结束」就封口、
+* **叫醒 agent**、**关掉录制窗**、收工（关窗排在叫醒之后：关窗慢 / 失败不许拖住叫醒，失败也不抛 ——
+* 那一扇是我们为录制借来的，ADR-0064 补记）。
+* ⚠️ 读数那条**不许**改成 opencli 的 `wait xhr`：它**读一次清一次**那只捕获环（`cdp.js:346-353`），而 reaper
+* 也读同一只环才拿得到 body ⇒ 会把 `rec-<unit>.jsonl` 吃空。理由与实测见 `.scratch/diy-write-record/issues/06-doorbell.md` §1.1。
+* @param input - 看护那一拍的依赖。@returns `stop` = 这条循环可以收了；`delivered` = 这一拍叫醒过 agent。
+*/
 async function watchFinishStepOf(input) {
 	const live = input.store.live(Date.now());
 	if (live === null) {
@@ -7141,11 +7704,15 @@ async function watchFinishStepOf(input) {
 		stop: true,
 		delivered: false
 	};
-	if (live.phase === "finished") return {
-		stop: false,
-		delivered: false
-	};
+	if (live.phase === "finished") {
+		await closeRecordTabQuiet(input);
+		return {
+			stop: true,
+			delivered: false
+		};
+	}
 	let page;
+	const started = Date.now();
 	try {
 		page = recordPageOf((await actBrowser(input.shell, input.command, BROWSER_RECORD_SESSION, ["eval", RECORD_READ_SCRIPT])).payload);
 	} catch {
@@ -7154,6 +7721,7 @@ async function watchFinishStepOf(input) {
 			delivered: false
 		};
 	}
+	if (page.beat) input.store.beat(input.sessionId, Math.max(0, Date.now() - started), Date.now());
 	const held = input.store.live(Date.now());
 	if (held === null) {
 		await releaseLeftoversOf(input);
@@ -7166,22 +7734,31 @@ async function watchFinishStepOf(input) {
 		stop: true,
 		delivered: false
 	};
-	if (held.phase === "finished") return {
-		stop: false,
-		delivered: false
-	};
+	if (held.phase === "finished") {
+		await stopCaptureQuiet(input);
+		await closeRecordTabQuiet(input);
+		return {
+			stop: true,
+			delivered: false
+		};
+	}
 	if (!page.ok) return {
 		stop: false,
 		delivered: false
 	};
+	const due = shotDueOf(held, page.shots);
+	if (due !== null) await takeShotOf(input, held, due);
 	if (page.phase === "finished" && page.t1 !== null) {
 		const now = Date.now();
-		if (held.phase === "recording") input.store.finished(input.sessionId, page.t1, now);
+		if (held.phase === "armed") input.store.started(input.sessionId, page.t0 ?? 0, now);
+		if (input.store.live(Date.now())?.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");
+		await stopCaptureQuiet(input);
+		await closeRecordTabQuiet(input);
 		return {
-			stop: false,
+			stop: true,
 			delivered: true
 		};
 	}
@@ -7191,18 +7768,25 @@ async function watchFinishStepOf(input) {
 		delivered: false
 	};
 }
+/**
+* 看护的一轮（就是 `watchFinishStepOf`，留着这个名字是给测试与调用点一个稳定的形）。
+* @param input - 看护那一拍的依赖。@returns 收不收工、有没有叫醒。
+*/
+async function watchRoundOf(input) {
+	return watchFinishStepOf(input);
+}
 function watchRecordFinish(input) {
 	let misses = 0;
 	const tick = () => {
-		watchFinishStepOf(input).then((out) => {
+		watchRoundOf(input).then((out) => {
 			misses = 0;
-			if (!out.stop) setTimeout(tick, RECORD_WATCH_MS);
+			if (!out.stop) setTimeout(tick, 0);
 		}).catch(() => {
 			misses += 1;
 			if (misses < RECORD_WATCH_TRIES) setTimeout(tick, RECORD_WATCH_MS);
 		});
 	};
-	setTimeout(tick, RECORD_WATCH_MS);
+	setTimeout(tick, 0);
 }
 async function captureLinesOf(shell, file, timeoutMs = START_TIMEOUT_MS) {
 	const step = await runShell(shell, `wc -l < ${quoteShellArg(file)} 2>/dev/null || echo 0`, { timeoutMs });
@@ -7284,30 +7868,12 @@ function detailFactsOf(input) {
 		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: ""
-		})
+		text: renderRecordDetail(input)
 	});
 }
 function detailOfEntry(entry, maxBytes, ambiguous = 1) {
 	return detailFactsOf({
+		found: true,
 		where: DETAIL_WHERE_CAPTURE,
 		key: entry.key,
 		method: entry.method,
@@ -7324,11 +7890,13 @@ function detailOfEntry(entry, maxBytes, ambiguous = 1) {
 		responseSizeExact: entry.responseSizeExact,
 		ambiguous,
 		source: "capture",
-		maxBytes
+		maxBytes,
+		note: ""
 	});
 }
 function detailOfCall(call, maxBytes) {
 	return detailFactsOf({
+		found: true,
 		where: DETAIL_WHERE_HOOK,
 		key: call.key,
 		method: call.method,
@@ -7345,31 +7913,45 @@ function detailOfCall(call, maxBytes) {
 		responseSizeExact: false,
 		ambiguous: 0,
 		source: "hook",
-		maxBytes
+		maxBytes,
+		note: ""
 	});
 }
+function blanksOf(pages, keep) {
+	if (pages === null) return [];
+	return pages.filter((one) => typeof one["url"] === "string" && (one["url"] === "" || one["url"] === "about:blank")).map((one) => typeof one["page"] === "string" ? one["page"] : "").filter((one) => one !== "" && one !== keep);
+}
 function tabsOf(raw) {
 	const start = raw.indexOf("[");
 	const end = raw.lastIndexOf("]");
-	if (start === -1 || end <= start) return [];
+	if (start === -1 || end <= start) return null;
 	try {
 		const parsed = JSON.parse(raw.slice(start, end + 1));
-		if (!Array.isArray(parsed)) return [];
+		if (!Array.isArray(parsed)) return null;
 		return parsed.filter((one) => typeof one === "object" && one !== null);
 	} catch {
-		return [];
+		return null;
 	}
 }
 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];
+	if (pages !== null && pages.length === 0) return true;
+	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;
+		])).ok) {
+			for (const one of blanksOf(pages, page)) await actBrowser(shell, command, session, [
+				"tab",
+				"close",
+				one
+			]);
+			await actBrowser(shell, command, session, ["close"]);
+			return true;
+		}
 	}
 	return (await actBrowser(shell, command, session, ["close"])).ok;
 }
@@ -7391,6 +7973,81 @@ async function releaseQuietly(input) {
 	}
 }
 //#endregion
+//#region src/modules/panels/model/diy-record-open.ts
+var PAGE_HREF_SCRIPT = "JSON.stringify({ href: location.href })";
+/**
+* 两个地址是不是"同一页"：比之前先把查询串 / 锚点 / 末尾斜杠抹掉 —— `open` 导航之后
+* 地址栏常常多一个斜杠或一串 hash，那不算开错了页。
+* @param here - 那一页现在真实所在的地址（`location.href`）。@param want - 我们要它去的地址。@returns 同一页为 `true`。
+*/
+function samePageOf(here, want) {
+	const norm = (one) => one.replace(/[?#].*$/, "").replace(/\/+$/, "");
+	return here !== "" && norm(here) === norm(want);
+}
+async function whereAtOf(input) {
+	const step = await actBrowser(input.shell, input.command, input.session, ["eval", PAGE_HREF_SCRIPT]);
+	const href = step.payload === void 0 ? "" : step.payload["href"];
+	return typeof href === "string" ? href : "";
+}
+async function settleOf(input) {
+	await runBrowserStep(input.shell, input.command, [
+		"browser",
+		input.session,
+		"wait",
+		"time",
+		String(SETTLE_MS / 1e3)
+	], OPEN_TIMEOUT_MS);
+}
+/**
+* 把录制那一页开起来，并且**确认它真的开起来了**才回来。
+*
+* 先收掉这条会话的残留（否则新页会开进上一次留下的那扇旧窗里，不顶前台、看上去"根本没弹窗"）；
+* 再 `tab new --window foreground` 开我们的页；**然后读一次 `location.href` 核实** —— 开出来是空白页
+* 或别的地址时，回落到 opencli 的 `open`（它落在会话租约那个标签上）再核一次；两次都不对就
+* `ok: false`，让调用方把这句话原样报给 agent，**不许在没开起来的页上装浮条说"已开始录制"**。
+* @param input - 这条会话的名字 / 目标地址 / 捕获文件（收残留那一拍要用）。
+* @returns `ok: false` 时 `at` 是那一页现在真实的地址（`''` = 空白页），`why` 是给 agent 看的一句话。
+*/
+async function openRecordPage(input) {
+	await releaseQuietly(input);
+	const opened = await runBrowserStep(input.shell, input.command, [
+		"browser",
+		input.session,
+		"tab",
+		"new",
+		input.url,
+		"--window",
+		"foreground"
+	], OPEN_TIMEOUT_MS);
+	if (!opened.ok) return {
+		ok: false,
+		at: "",
+		why: `开不了录制窗：${opened.stderr || opened.stdout || "opencli 报了个错"}。先让用户把工作台那一页切到前台（第一次要这样），或跑 opencli doctor 看扩展连没连上。`
+	};
+	await settleOf(input);
+	let at = await whereAtOf(input);
+	if (!samePageOf(at, input.url)) {
+		await runBrowserStep(input.shell, input.command, [
+			"browser",
+			input.session,
+			"open",
+			input.url
+		], OPEN_TIMEOUT_MS);
+		await settleOf(input);
+		at = await whereAtOf(input);
+	}
+	if (!samePageOf(at, input.url)) return {
+		ok: false,
+		at,
+		why: `那一页没开起来（现在开的是 ${at === "" ? "一张空白页" : at}）—— 再看一眼 Chrome 里那扇录制窗，或跑 opencli doctor 看扩展连没连上。`
+	};
+	return {
+		ok: true,
+		at,
+		why: ""
+	};
+}
+//#endregion
 //#region src/modules/panels/model/diy-record-tools.ts
 function registerRecordTools(ctx, store) {
 	const tools = ctx.get("tools");
@@ -7400,7 +8057,7 @@ function registerRecordTools(ctx, store) {
 	}
 	const prepareTool = {
 		name: DIY_RECORD_PREPARE_TOOL,
-		description: `开一扇浏览器窗口并顶到最前，让他自己录一次真实的写（开窗要点头一次）；他按开始/结束后用 ${DIY_RECORD_READ_TOOL} 取那一段、${DIY_RECORD_STOP_TOOL} 收工。`,
+		description: `开一扇浏览器窗口并顶到最前，让他自己录一次真实的写（开窗要点头一次）；他按开始/结束后用 ${DIY_RECORD_READ_TOOL} 取那一段、${DIY_RECORD_STOP_TOOL} 收工。他按浮条上的「截图」不用另外点头（同一场同一屏，屏幕在开窗那一拍已经借过）—— 那张图与提交那一刻的快照一起进 ${DIY_RECORD_DETAIL_TOOL} 的字段证据表。`,
 		parameters: {
 			type: "object",
 			properties: {
@@ -7479,23 +8136,14 @@ function registerRecordTools(ctx, store) {
 				now: Date.now()
 			}), held);
 			try {
-				const opened = await runBrowserStep(shell, command, [
-					"browser",
-					BROWSER_RECORD_SESSION,
-					"tab",
-					"new",
+				const opened = await openRecordPage({
+					shell,
+					command,
+					session: BROWSER_RECORD_SESSION,
 					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);
+					captureFile
+				});
+				if (!opened.ok) throw new Error(opened.why);
 				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 || "那一页还在加载"} —— 等他那一页站稳了再试。`);
@@ -7573,32 +8221,39 @@ function registerRecordTools(ctx, store) {
 					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;
+			const over = held.phase === "finished";
+			let stepOk = true;
+			let page = recordPageOf(void 0);
+			if (!over) {
+				await actBrowser(shell, command, BROWSER_RECORD_SESSION, ["eval", RECORD_ARM_SCRIPT]);
+				let step = await actBrowser(shell, command, BROWSER_RECORD_SESSION, ["eval", RECORD_READ_SCRIPT]);
+				page = recordPageOf(step.payload);
+				stepOk = step.ok;
 				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 timedOut = !over && 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 ledger = state.shots;
 			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,
+			const readText = renderRecordRead({
+				phase: stepOk ? page.ok ? page.phase : state.phase : state.phase,
+				armed: over ? true : stepOk ? page.ok : true,
 				hookCaught,
 				rows: bundle.rows,
 				merged: bundle.merged.length,
@@ -7611,11 +8266,17 @@ function registerRecordTools(ctx, store) {
 				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 报了个错"}`;
+				captureRound: bundle.capture.round,
+				shots: ledger,
+				beats: state.beats,
+				beatMs: state.beatMs
+			});
+			const note = over ? ["他按「结束」时那一扇录制窗就收掉了 —— 下面是磁盘上（捕获文件）这一段的清单。"] : [];
+			const said = stepOk ? [readText, timedOut ? `还在录 —— 等他按「结束」（要等就带 waitMs，帽 ${String(WAIT_CAP_MS / 6e4)} 分钟）。` : ""] : ["那一页上读不到了（那一扇录制窗可能已经关了）—— 台账与捕获文件这一段的清单照样在：", readText];
+			const text = [...note, ...said].filter((one) => one !== "").join("\n");
 			return plainJson({
 				workshop: packagesDir,
-				ok: step.ok && page.ok,
+				ok: stepOk && page.ok,
 				phase: state.phase,
 				t0: state.t0,
 				t1: state.t1,
@@ -7629,6 +8290,9 @@ function registerRecordTools(ctx, store) {
 				hookCaught,
 				noBody,
 				nav,
+				shots: ledger,
+				beats: state.beats,
+				beatMs: state.beatMs,
 				waitedMs,
 				timedOut,
 				text
@@ -7706,7 +8370,9 @@ function registerRecordTools(ctx, store) {
 			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);
+			const over = held === null || held.phase === "finished";
+			const livePage = page !== null || over ? page : recordPageOf((await actBrowser(shell, command, BROWSER_RECORD_SESSION, ["eval", RECORD_READ_SCRIPT])).payload);
+			const call = livePage === null ? null : hookCallOf(livePage, key);
 			if (call !== null) return detailOfCall(call, maxBytes);
 			return plainJson({
 				workshop: packagesDir,
@@ -7731,7 +8397,7 @@ function registerRecordTools(ctx, store) {
 					ambiguous: 0,
 					source: "",
 					maxBytes,
-					note: `「${key}」既不在这一场的快照原文（${file}）里，也不在这一页的钩子那一份里`
+					note: over ? `「${key}」不在这一场的快照原文（${file}）里 —— 这一场已经结束 / 收工，那一页也收掉了，钩子那一份问不到` : `「${key}」既不在这一场的快照原文（${file}）里，也不在这一页的钩子那一份里`
 				})
 			});
 		}
@@ -9618,8 +10284,21 @@ function panelsHandoffEntry(target = {}) {
 		key: `path:${path}`
 	};
 }
+function listedRunUnits(result) {
+	const outer = typeof result === "object" && result !== null ? result : {};
+	const unwrapped = outer["value"];
+	const runs = (typeof unwrapped === "object" && unwrapped !== null ? unwrapped : outer)["runs"];
+	if (!Array.isArray(runs)) return [];
+	const units = /* @__PURE__ */ new Set();
+	for (const row of runs) {
+		const unit = typeof row === "object" && row !== null ? row.unit : void 0;
+		if (typeof unit === "string" && unit !== "") units.add(unit);
+	}
+	return [...units];
+}
 function panelsFactsOf(call, manifests) {
 	if (call.source === "workbench_panels_list") return [PANELS_FACT];
+	if (call.source === "workbench_long_tasks_list") return listedRunUnits(call.result).map(runsRouteOf);
 	if (call.source === "workbench_modules_list") return [PANELS_FACT, CAPABILITY_FACT];
 	if (call.source === "workbench_modules_update_workbench") return [PANELS_FACT, CAPABILITY_FACT];
 	if (call.source === "workbench_diy_list") return [PANELS_FACT];
@@ -10183,7 +10862,7 @@ function registerPanelTools(ctx, panels, values) {
 var OWNED = [{
 	unit: panelsUnit.id,
 	manifest: panelsUnit,
-	mount({ ctx, logger, manifests, ownedUnits, installable, opencliCommand, probe, store, values }) {
+	mount({ ctx, logger, manifests, ownedUnits, installable, opencliCommand, probe, store, values, longTaskRuns }) {
 		const ledger = createPluginLedger({
 			store,
 			home: isolatedHome()
@@ -10271,10 +10950,11 @@ var OWNED = [{
 				...registerPanelTools(ctx, panels, values),
 				...registerMarketTools(ctx, market),
 				...registerDiyTools(ctx, market, panels, debug),
-				...registerRecordTools(ctx, record)
+				...registerRecordTools(ctx, record),
+				...registerLongTaskTools(ctx, longTaskRuns)
 			],
 			factsOf: (call) => panelsFactsOf(call, manifests()),
-			needsApproval: panelsApproval,
+			needsApproval: panelsApprovalFor(longTaskRuns),
 			gate: {
 				deniedTools: (context) => {
 					const boards = panels.boards(context.workspace);
@@ -10331,7 +11011,29 @@ function withRunsRoute(result, unit) {
 					runs: path === "" ? [] : runs.current(path)
 				};
 			}
-		}
+		},
+		actions: [...result.actions ?? [], {
+			resource: stopRouteOf(unit),
+			handle(payload) {
+				if (typeof runs.stop !== "function") return {
+					ok: false,
+					text: "这一份外壳还是上一版的注册表，停不了 —— 重新起一下工作台就能停"
+				};
+				const id = payload?.id;
+				if (typeof id !== "string" || id.trim() === "") return {
+					ok: false,
+					text: "要停哪一趟？给一个 id 才成"
+				};
+				if (runs.snapshot(id) === null) return {
+					ok: false,
+					text: "没有这一趟 —— id 对不上，没什么可停的"
+				};
+				return {
+					ok: true,
+					stopped: runs.stop(id)
+				};
+			}
+		}]
 	};
 }
 function declaresNote(definition) {
@@ -10500,6 +11202,7 @@ function mountUnits(units, deps) {
 	const declaredNotes = /* @__PURE__ */ new Set();
 	const skipped = [];
 	const longTaskDisposers = /* @__PURE__ */ new Map();
+	const longTaskRuns = deps.longTaskRuns ?? /* @__PURE__ */ new Map();
 	const ledger = {
 		failed: /* @__PURE__ */ new Set(),
 		failures: []
@@ -10520,7 +11223,8 @@ function mountUnits(units, deps) {
 		const longTasks = deps.longTasks === void 0 ? void 0 : createLongTaskHost({
 			scope: deps.longTasks.scope,
 			unit,
-			bump: deps.longTasks.bump
+			bump: deps.longTasks.bump,
+			...deps.longTasks.notify === void 0 ? {} : { notify: deps.longTasks.notify }
 		});
 		let result;
 		try {
@@ -10535,6 +11239,7 @@ function mountUnits(units, deps) {
 				...deps.probe === void 0 ? {} : { probe: deps.probe },
 				...deps.values === void 0 ? {} : { values: deps.values },
 				...longTasks === void 0 ? {} : { longTasks: longTasks.host },
+				longTaskRuns: () => longTaskRuns,
 				store
 			});
 		} catch (error) {
@@ -10555,6 +11260,8 @@ function mountUnits(units, deps) {
 		};
 		mounted.push(item);
 		if (longTasks !== void 0) longTaskDisposers.set(item, longTasks.dispose);
+		const runs = item.result.longTasks;
+		if (runs !== void 0) longTaskRuns.set(unit, runs);
 	}
 	const collected = collectRoutes(mounted, ledger);
 	const prefs = collectNamed(mounted, ledger, (item) => item.result.prefs === void 0 ? [] : [item.result.prefs], "偏好资源");
@@ -10575,6 +11282,8 @@ function mountUnits(units, deps) {
 		if (!ledger.failed.has(item)) continue;
 		longTaskDisposers.get(item)?.();
 		longTaskDisposers.delete(item);
+		const runs = item.result.longTasks;
+		if (runs !== void 0 && longTaskRuns.get(item.host.manifest.id) === runs) longTaskRuns.delete(item.host.manifest.id);
 	}
 	return {
 		mounted: alive,
@@ -10594,6 +11303,10 @@ function mountUnits(units, deps) {
 		disposeLongTasks: () => {
 			for (const dispose of [...longTaskDisposers.values()]) dispose();
 			longTaskDisposers.clear();
+			for (const item of mounted) {
+				const runs = item.result.longTasks;
+				if (runs !== void 0 && longTaskRuns.get(item.host.manifest.id) === runs) longTaskRuns.delete(item.host.manifest.id);
+			}
 		}
 	};
 }
@@ -11079,6 +11792,37 @@ var DSH_PLUGINS_ROUTE = "dsh-plugins";
 //#region src/shared/api/unit-manifests.ts
 var UNIT_MANIFESTS_ROUTE = "unit-manifests";
 //#endregion
+//#region src/shared/api/long-tasks.ts
+/**
+* 外壳自己的长任务读口：一次把**全进程还在跑的**长任务交出来（不分单元、不分工作区）——
+* 左栏拿它点会话行与项目下拉里那颗 loading 点。
+*/
+var LONG_TASKS_ROUTE = "long-tasks";
+//#endregion
+//#region src/shared/api/host/long-tasks.ts
+/**
+* 把「单元 → 它那把长任务注册表」收成一条条**还在跑**的行（`live()` 已经只给活着的那几趟，
+* 收尾的是面板那一行的事）；注册表是上一版、没有 `live()` 就跳过这个单元 —— 与停止那条动作
+* 同一个理由：那一版里没有这份读口，不是这一版坏了。
+* @param runs 当前挂着的单元各自那把长任务注册表（外壳进程里就这一份）。
+* @returns 正在跑的长任务（含 `needs-login` 那种），每条带上是哪个单元起的。
+*/
+function liveLongTaskRows(runs) {
+	const rows = [];
+	for (const [unit, registry] of runs) {
+		if (typeof registry.live !== "function") continue;
+		for (const snapshot of registry.live()) rows.push({
+			unit,
+			id: snapshot.id,
+			workspace: snapshot.workspace,
+			target: snapshot.target,
+			status: snapshot.status,
+			...snapshot.session === void 0 ? {} : { session: snapshot.session }
+		});
+	}
+	return rows;
+}
+//#endregion
 //#region src/shared/api/host/context-inject.ts
 var CONTEXT_SOURCE_KIND = "workbench";
 function collectContextRefs(messages) {
@@ -11217,8 +11961,6 @@ function createPreflight(options) {
 		at: Date.now()
 	};
 	let running = null;
-	let latest = null;
-	let rerun = false;
 	function set(next) {
 		current = {
 			...current,
@@ -11413,21 +12155,16 @@ function createPreflight(options) {
 			...settled.ok ? {} : { bridgeIssues: settled.issues }
 		});
 	}
+	function freshReady() {
+		return current.phase === "ready" && Date.now() - current.at < 3e4;
+	}
 	async function start(runOptions = {}) {
-		if (running !== null) {
-			if (runOptions.force === true) rerun = true;
-			return running;
-		}
-		if (runOptions.force !== true && latest !== null) return latest;
+		if (running !== null) return running;
+		if (runOptions.hard !== true && freshReady()) return current;
 		const inflight = doRun();
-		latest = inflight;
 		running = inflight;
 		await inflight.catch(() => void 0);
 		running = null;
-		if (rerun) {
-			rerun = false;
-			return start({ force: true });
-		}
 		return inflight;
 	}
 	return {
@@ -11695,10 +12432,31 @@ async function probeReleases(units, options) {
 	}
 	return found;
 }
+var pendingProbes = /* @__PURE__ */ new Map();
 async function probeUnits(options) {
 	const { shell, command = "opencli", units, force = false } = options;
 	const hits = units.map((unit) => unitCache.get(`${command}:${unit.unit}`));
 	if (!force && hits.every((hit) => hit !== void 0)) return hits;
+	const key = `${command}:${units.map((unit) => unit.unit).join("|")}`;
+	if (!force) {
+		const shared = pendingProbes.get(key);
+		if (shared !== void 0) return shared;
+	}
+	const task = loadCapabilities({
+		shell,
+		command,
+		units,
+		force
+	});
+	pendingProbes.set(key, task);
+	try {
+		return await task;
+	} finally {
+		if (pendingProbes.get(key) === task) pendingProbes.delete(key);
+	}
+}
+async function loadCapabilities(options) {
+	const { shell, command, units, force } = options;
 	const result = await runShell(shell, `${command} plugin list -f json`, { timeoutMs: OPENCLI_TIMEOUT_MS }).then((value) => ({
 		kind: "ok",
 		stdout: value.exitCode === 0 ? value.stdout : "",
@@ -12905,6 +13663,64 @@ function warn(ctx, message) {
 	ctx.logger?.warn?.(`[dsh-workbench] ${message}`);
 }
 //#endregion
+//#region src/shared/api/host/approval-call.ts
+/**
+* 把 dsh 交来的那次工具调用折成审批策略要看的那份 call：工作区与发起会话都从 `exec` 现取，取不到就不写那个键。
+* @param exec dsh 交来的执行上下文；没有就只有实参这一格。
+* @param name 工具名；`undefined` = 这次调用没名字，不写这个键。
+* @returns 交给 `approvalFor` 的 `ApprovalCall`。
+*/
+function approvalCallOf(exec, name) {
+	const workspace = sessionWorkspace(exec) ?? void 0;
+	const session = sessionIdOf(exec) ?? void 0;
+	return {
+		...name === void 0 ? {} : { name },
+		arguments: exec?.arguments,
+		...workspace === void 0 ? {} : { workspace },
+		...session === void 0 ? {} : { session }
+	};
+}
+//#endregion
+//#region src/shared/api/host/long-task-notice.ts
+/**
+* 这条 notice 的来源标识（`source.kind`）—— 长任务自己一格，与调试 / 录制分开。
+*/
+var LONG_TASK_NOTICE_KIND = "workbench-long-task";
+/**
+* 判这一趟被停要不要回流给发起它的那个会话，并把话写好。
+* 只有"结算 + `stopped` + 这一趟记得会话 + 不是它自己停的"才回一条；跑完 / 失败 / 界面起的（没记会话）/ 自己停的回 `null`。
+* @param unit 这一趟属于哪个单元（进文案）。
+* @param change 长任务那一次变更；只有 `kind: 'settle'` 且 `snapshot.status === 'stopped'` 才可能成。
+* @returns 该发的那条（带收件会话），或者 `null`（不发）。
+*/
+function longTaskStopNotice(unit, change) {
+	if (change.kind !== "settle") return null;
+	const snapshot = change.snapshot;
+	if (snapshot.status !== "stopped") return null;
+	const session = snapshot.session;
+	if (session === void 0 || session === "") return null;
+	if (change.by === session) return null;
+	const target = snapshot.target;
+	const summary = `长任务：${unit} 的「${target}」被停了`;
+	return {
+		session,
+		summary,
+		message: noticeMessage(`［长任务 · ${unit}］「${target}」那一趟被${change.by === void 0 ? "用户" : "别的会话"}停了 —— 别再把它当"还在跑"；要接着做就重新起一趟（workbench_long_tasks_list 看当前这几趟）。`, summary, LONG_TASK_NOTICE_KIND)
+	};
+}
+/**
+* 把"这一趟被停了"送出去：正在跑的会话 inject 一条、闲着的跳过、没有这个 agent 就当没发生（模式 `drop`）。
+* @param agents 会话表（宿主从 `ctx.get('agents')` 拿）；拿不到就什么都不发。
+* @param unit 这一趟属于哪个单元。
+* @param change 长任务那一次变更。
+* @returns 送出去的结果；判据说不该发（`longTaskStopNotice` 回 `null`）就回 `null`。
+*/
+function notifyLongTaskStop(agents, unit, change) {
+	const notice = longTaskStopNotice(unit, change);
+	if (notice === null) return null;
+	return deliverDebugNotice(agents, notice.session, notice.message, "drop");
+}
+//#endregion
 //#region src/app/host.ts
 var name = "dsh-workbench";
 var inject = ["webServer"];
@@ -13024,9 +13840,14 @@ function apply(ctx) {
 	});
 	const mounted = /* @__PURE__ */ new Map();
 	const mountFailures = /* @__PURE__ */ new Map();
+	const longTaskRuns = /* @__PURE__ */ new Map();
 	const factsOfMap = /* @__PURE__ */ new Map();
 	const routesOfUnitMap = /* @__PURE__ */ new Map();
 	const ownersMap = /* @__PURE__ */ new Map();
+	routes[LONG_TASKS_ROUTE] = () => ({
+		ok: true,
+		runs: liveLongTaskRows(longTaskRuns)
+	});
 	const factsOfUnit = (unit) => [...routesOfUnitMap.get(unit) ?? [], "capability"];
 	const callFacts = (unit, call) => factsOfMap.get(unit)?.(call) ?? factsOfUnit(unit);
 	const deniedNow = (context) => [...new Set([...mounted.values()].flatMap((item) => item.plan.gate?.deniedTools(context) ?? []))];
@@ -13076,8 +13897,10 @@ function apply(ctx) {
 				values,
 				longTasks: {
 					scope: process.env["DSH_HOME"] ?? "",
-					bump: (names) => facts.bump(names)
-				}
+					bump: (names) => facts.bump([...names, LONG_TASKS_ROUTE]),
+					notify: (change) => notifyLongTaskStop(ctx.get("agents"), host.unit, change)
+				},
+				longTaskRuns
 			});
 		} catch (error) {
 			mountFailures.set(id, {
@@ -13255,12 +14078,7 @@ function apply(ctx) {
 			const tool = name === void 0 ? void 0 : unitsOfTool().get(name);
 			const owner = tool === void 0 ? void 0 : mounted.get(tool.unit)?.result;
 			const detailOf = owner === void 0 ? void 0 : (call) => owner.approvalDetail?.(call);
-			const workspace = sessionWorkspace(exec) ?? void 0;
-			const call = {
-				...name === void 0 ? {} : { name },
-				arguments: exec.arguments,
-				...workspace === void 0 ? {} : { workspace }
-			};
+			const call = approvalCallOf(exec, name);
 			const policy = owner?.needsApproval;
 			const declaredNote = name !== void 0 && declaredNoteTools().has(name);
 			return await approvalFor(call, {