@dsh-workbench/core 0.3.4 → 0.3.5

package/dist/host/index.js

@@ -6,36 +6,71 @@ import { deflateSync, inflateSync } from "node:zlib";
 import { spawn } from "node:child_process";
 import os from "node:os";
 //#region ../shared/dist/config/constants.js
+/** 外壳插件的包名：浏览器模块表与宿主按它注册、认领这枚插件。 */
 var PLUGIN_ID = "@dsh-workbench/core";
+/** 与外壳同批发布的兄弟包名：`release.ts` 用它判一版三包是否都已在源上。 */
 var RELEASE_SIBLINGS = ["@dsh-workbench/shared", "@dsh-workbench/module-tools"];
+/** 外壳宿主 HTTP API 的根前缀；prefs / actions / provision 等路由都挂在它下面。 */
 var API_PREFIX = "/workbench/api";
+/** 模块偏好读写的路由前缀，挂在外壳 API 下：走写通道，拒写回 write-refused。 */
 var PREFS_PREFIX = `${API_PREFIX}/prefs`;
+/** 事实（facts）SSE 事件流的端点路径；前端 `EventSource` 按它带 `since` 游标续传。 */
 var EVENTS_PATH = "/workbench/events";
+/** 写动作的路由前缀，挂在外壳 API 下：模块的写通道 POST 到这里。 */
 var ACTIONS_PREFIX = `${API_PREFIX}/actions`;
+/** 机器供给（provision）的路由前缀：只收 POST，装机时用它铺一份运行环境。 */
 var PROVISION_PREFIX = `${API_PREFIX}/provision`;
+/** 面板运行态上报的路径段：崩溃与卡片收尾分别 POST 到 `panel-state/crash`、`panel-state/cards`。 */
 var PANEL_STATE_PATH = "panel-state";
+/** DIY 调试动作的路径段；宿主按它登记 `/workbench/api/diy-debug` 前缀。 */
 var DIY_DEBUG_PATH = "diy-debug";
 `${DIY_DEBUG_PATH}`;
+/** DIY 录制交接的路径段；宿主按它登记 `/workbench/api/diy-record` 前缀。 */
 var DIY_RECORD_PATH = "diy-record";
 `${DIY_RECORD_PATH}`;
+/** 面板运行态的路由前缀，挂在外壳 API 下：上报口用它，拒报回 report-refused。 */
 var PANEL_STATE_PREFIX = `${API_PREFIX}/${PANEL_STATE_PATH}`;
+/** 钉住的 opencli 插件版本：`opencli-runtime` 按它校验、取那一份。 */
 var OPENCLI_PIN = "1.8.8";
+/** 面板套件的 dsh 服务名（`workbenchPanels`）：宿主经它取套件公布的清单与订阅。 */
 var PANELS_SERVICE = "workbenchPanels";
+/** 单元花名册服务的 dsh 服务名（`workbenchUnits`）：模块经它认领自己的单元。 */
 var UNITS_SERVICE = "workbenchUnits";
+/** 面板运行态服务的 dsh 服务名（`workbenchPanelState`）：宿主注册，读口按它取。 */
 var PANEL_STATE_SERVICE = "workbenchPanelState";
+/** DIY 调试约定服务的 dsh 服务名（`workbenchDiyDebug`）：调试动作走它，不走 HTTP。 */
 var DIY_DEBUG_SERVICE = "workbenchDiyDebug";
+/** DIY 录制交接服务的 dsh 服务名（`workbenchDiyRecord`）：`diy-acts.ts` 经它收发录制三拍。 */
 var DIY_RECORD_SERVICE = "workbenchDiyRecord";
+/** 会话投影服务的 dsh 服务名（`sessionProjections`）：宿主经 `stateOf(session, 'agentPreset')` 读那一档。 */
+var SESSION_PROJECTIONS_SERVICE = "sessionProjections";
+/** 单次 opencli 调用的默认超时（毫秒）；调用点没传 `timeoutMs` 时按它算。 */
 var OPENCLI_TIMEOUT_MS = 12e4;
+/** 启动预热站点那一跳的超时（毫秒）；超时按未热对待，不挡面板。 */
 var WARM_TIMEOUT_MS = 2e4;
+/** 装 / 卸模块包的超时（毫秒）：pnpm 与取包内容都按它算。 */
 var INSTALL_TIMEOUT_MS = 3e5;
+/** 查 registry 版本那一次请求的超时（毫秒）。 */
 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 = /[.,;:!?]+$/;
+/**
+* 把引用拼回标记体里的那一段文本（不含 @ 与标记名）。
+* @param ref 要拼的引用。
+* @returns 形如 kind:part/part；分段里的 / 不转义，所以分段名本身不能含 /。
+*/
 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;
@@ -48,6 +83,11 @@ function decodeRef(text) {
 		parts
 	};
 }
+/**
+* 从一段文本里按出现顺序捞出所有标记引用，同一个引用只留第一次。
+* @param text 任意文本；null / undefined 当空串。
+* @returns 解析不出来的标记会被丢掉，所以结果只含合法引用，可能为空数组。
+*/
 function parseMarkers(text) {
 	const seen = /* @__PURE__ */ new Set();
 	const refs = [];
@@ -63,10 +103,21 @@ function parseMarkers(text) {
 }
 //#endregion
 //#region ../shared/dist/api/unit.js
+/**
+* 判这个模块要不要往外装东西。
+* @param manifest 模块清单。
+* @returns 插件与共用库两张表都空时给 false。
+*/
 function hasEnvSupply(manifest) {
 	return (manifest.env?.plugins ?? []).length > 0 || (manifest.env?.libs ?? []).length > 0;
 }
+/**
+* 外壳愿意认的协议版本；不在表里的模块当场被拒，不猜语义。
+*/
 var SUPPORTED_API_VERSIONS = [1];
+/**
+* 协议认得的全部键；写了别的键不会被采纳（外壳静默忽略），所以字段名拼错不会有提示。
+*/
 var DECLARATION_KEYS = [
 	"apiVersion",
 	"unit",
@@ -75,6 +126,9 @@ var DECLARATION_KEYS = [
 	"host",
 	"env"
 ];
+/**
+* 协议要求必写的键；env 不在其中（没有环境需要就不写）。
+*/
 var DECLARATION_REQUIRED_KEYS = [
 	"apiVersion",
 	"unit",
@@ -106,6 +160,12 @@ 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;
@@ -167,6 +227,12 @@ function declarationProblemsOf(subject, raw) {
 	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 };
@@ -193,19 +259,40 @@ function readDeclaration(subject, raw) {
 		}
 	};
 }
+/**
+* 由单元 id 拼出它那一族事实的范围名。
+* @param unit 单元 id，不带后缀。
+* @returns <unit>* —— 永远是范围名，不是某一条事实。
+*/
 function unitFactScope(unit) {
 	return `${unit}*`;
 }
 //#endregion
 //#region ../shared/dist/api/long-task.js
+/**
+* 单元的长任务读口路由。
+* @param unit 单元 id。
+* @returns <unit>/runs。
+*/
 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 末尾若干行、去首尾空行后的文本；原文行数不够就全给，空输入给空串。
+*/
 function tailLines(text, lines = 6) {
 	return String(text ?? "").trim().split("\n").slice(-lines).join("\n");
 }
@@ -223,6 +310,11 @@ function candidateStarts(raw) {
 	}
 	return starts;
 }
+/**
+* 宽松解析一段前后可能夹着人话的 JSON：整段不通就从行首的 `[` / `{` 起、截到最后一个闭合符再试。
+* @param text - 原文；`null` / `undefined` 当空串。
+* @returns 解析出的值（对象 / 数组 / 标量都原样）；空输入或怎么都解析不出给 `undefined`，调用方据此报「输出认不出」。
+*/
 function parseJsonLoose(text) {
 	const raw = String(text ?? "").trim();
 	if (!raw) return void 0;
@@ -245,6 +337,9 @@ function parseJsonLoose(text) {
 var DAY = 864e5;
 30 * DAY;
 365 * DAY;
+/**
+* 上报文本字段的截断长度（2000 字符；workspace / reason / message 共用）。
+*/
 var PANEL_STATE_MAX_TEXT = 2e3;
 var PHASES = [
 	"idle",
@@ -252,10 +347,10 @@ var PHASES = [
 	"ready",
 	"error"
 ];
-function asRecord$10(value) {
+function asRecord$8(value) {
 	return typeof value === "object" && value !== null ? value : void 0;
 }
-function textOf$8(value, max) {
+function textOf$6(value, max) {
 	if (typeof value !== "string") return "";
 	const trimmed = value.trim();
 	return trimmed.length > max ? trimmed.slice(0, max) : trimmed;
@@ -266,23 +361,29 @@ function atOf(value) {
 	return Math.trunc(value);
 }
 function errorOf(raw) {
-	const record = asRecord$10(raw);
+	const record = asRecord$8(raw);
 	if (record === void 0) return void 0;
-	const code = textOf$8(record["code"], 120);
-	const message = textOf$8(record["message"], PANEL_STATE_MAX_TEXT);
+	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
 	};
 }
+/**
+* 收一批卡片读数上报。
+* @param payload - `POST` 的请求体。
+* @returns 至少收到一条能认的卡片才 `ok: true`；请求体不是对象、`workspace` 为空、`cards` 不是数组，
+*   或一条都认不出（`unit` / `route` / `phase` / `at` 缺一）时 `ok: false` + 中文原因；认不出的单条静默跳过。
+*/
 function parseCardsReport(payload) {
-	const record = asRecord$10(payload);
+	const record = asRecord$8(payload);
 	if (record === void 0) return {
 		ok: false,
 		message: "请求体要是一个对象"
 	};
-	const workspace = textOf$8(record["workspace"], PANEL_STATE_MAX_TEXT);
+	const workspace = textOf$6(record["workspace"], PANEL_STATE_MAX_TEXT);
 	if (workspace === "") return {
 		ok: false,
 		message: "workspace 不能是空的 —— 面板按工作区存"
@@ -294,11 +395,11 @@ function parseCardsReport(payload) {
 	};
 	const cards = [];
 	for (const item of raw.slice(0, 32)) {
-		const card = asRecord$10(item);
+		const card = asRecord$8(item);
 		if (card === void 0) continue;
-		const unit = textOf$8(card["unit"], 200);
-		const route = textOf$8(card["route"], 400);
-		const phase = textOf$8(card["phase"], 20);
+		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"]);
@@ -322,15 +423,20 @@ function parseCardsReport(payload) {
 		}
 	};
 }
+/**
+* 收一次卡片崩溃上报。
+* @param payload - `POST` 的请求体。
+* @returns `workspace` / `unit` / `reason` 都不能空，缺一给 `ok: false` + 中文原因；`at` 缺省或不合法时取当前时间。
+*/
 function parseCrashReport(payload) {
-	const record = asRecord$10(payload);
+	const record = asRecord$8(payload);
 	if (record === void 0) return {
 		ok: false,
 		message: "请求体要是一个对象"
 	};
-	const workspace = textOf$8(record["workspace"], PANEL_STATE_MAX_TEXT);
-	const unit = textOf$8(record["unit"], 200);
-	const reason = textOf$8(record["reason"], PANEL_STATE_MAX_TEXT);
+	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 不能是空的"
@@ -353,6 +459,10 @@ function parseCrashReport(payload) {
 		}
 	};
 }
+/**
+* 造一份面板运行态的留存（进程内存、按工作区分桶，带上面那几条上限的 LRU）。
+* @returns 留存口：`cards` / `crash` 收上报，`snapshot(workspace)` 取全量；没存过的工作区（含 `null`）给一份空的。
+*/
 function createPanelStateStore() {
 	const workspaces = /* @__PURE__ */ new Map();
 	function trim(entry, max) {
@@ -443,17 +553,35 @@ function createPanelStateStore() {
 }
 //#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);
 }
+/**
+* 把一次探针读数归成椅面归属。
+* @param probe - 探针读数。
+* @param workshop - 当前工作区根路径；`null` 表示还不知道当前是哪个工作区。
+* @returns 外壳不在、或板路径与工作区缺一 → `unknown`；右栏没开或没画出来 → `hidden`；板在本工作区 → `workshop`，否则 `other`。
+*/
 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";
 }
+/**
+* 把探针读数归成左栏那句人话的档位。
+* @param probe - 探针读数。
+* @param workshop - 当前工作区根路径；`null` 一律 `unknown`。
+* @returns 椅面画着 → 本板 `ok` / 别板 `other-board`；没画着 → 页面已走 `off-workspace`，否则 `panel-closed`。
+*/
 function boardSituation(probe, workshop) {
 	if (!probe.workbench || workshop === null) return "unknown";
 	if (probe.bar && probe.open && probe.drawn) {
@@ -465,6 +593,11 @@ function boardSituation(probe, workshop) {
 }
 //#endregion
 //#region ../shared/dist/lib/diy-debug.js
+/**
+* 把工具入参收成人话动作。
+* @param value - 任意入参值。
+* @returns `'pause'` / `'resume'` / `'stop'` 原样；别的值（含 `undefined`、多余空白、大小写不同）给 `null`，由调用方拒。
+*/
 function parseDebugIntent(value) {
 	return value === "pause" || value === "resume" || value === "stop" ? value : null;
 }
@@ -477,6 +610,10 @@ function ownerOf$1(state, sessionId, now) {
 	if (held === null) return "none";
 	return held.sessionId === sessionId ? held : "not-owner";
 }
+/**
+* 造一份新的调试约定存储（进程内存，同一时刻只可能有一份有效约定）。
+* @returns 存取口；动作成不成都在返回的 `DebugMove` 里，不抛异常。
+*/
 function createDebugStore() {
 	let held = null;
 	const live = (now) => alive$1(held, now);
@@ -491,7 +628,8 @@ function createDebugStore() {
 			const state = {
 				phase: "debugging",
 				sessionId: pact.sessionId,
-				workspace: pact.workspace,
+				workspacePath: pact.workspacePath,
+				title: pact.title,
 				board: pact.board,
 				unit: pact.unit,
 				name: pact.name,
@@ -560,6 +698,11 @@ function createDebugStore() {
 		}
 	};
 }
+/**
+* 把工具入参收成人话动作。
+* @param raw - 任意入参值。
+* @returns `'peek'` / `'halt'` / `'stop'` 原样；别的值（含 `undefined`、多余空白）给 `null`，由调用方拒。
+*/
 function parseRecordIntent(raw) {
 	return raw === "peek" || raw === "halt" || raw === "stop" ? raw : null;
 }
@@ -572,6 +715,10 @@ function ownerOf(state, sessionId, now) {
 	if (held === null) return "none";
 	return held.sessionId === sessionId ? held : "not-owner";
 }
+/**
+* 造一份新的录制约定存储（进程内存，同一时刻只可能有一份有效约定）。
+* @returns 存取口；动作成不成都在返回的 `RecordMove` 里，不抛异常。
+*/
 function createRecordStore() {
 	let held = null;
 	const live = (now) => alive(held, now);
@@ -706,481 +853,8 @@ async function runShell(shell, command, options = {}) {
 //#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";
-var DEFAULT_TIMEOUT_MS$2 = 25e3;
-var DEFAULT_RETRY_MS = 1200;
-var DEFAULT_SETTLE_MS$1 = 900;
-var AUTH_CODES = /* @__PURE__ */ new Set([
-	"NOT_LOGGED_IN",
-	"NOT_LOGIN",
-	"AUTH_FAILED",
-	"AUTH_REQUIRED",
-	"UNAUTHENTICATED",
-	"UNAUTHORIZED",
-	"TOKEN_EXPIRED"
-]);
-var PERMISSION_CODES = /* @__PURE__ */ new Set([
-	"FORBIDDEN",
-	"PERMISSION_DENIED",
-	"NO_PERMISSION",
-	"EACCES"
-]);
-function asRecord$9(value) {
-	return typeof value === "object" && value !== null ? value : void 0;
-}
-function textOf$7(value) {
-	return typeof value === "string" ? value.trim() : "";
-}
-function codeOf(page) {
-	const record = asRecord$9(page);
-	return record === void 0 ? "" : textOf$7(record["code"]);
-}
-function messageOf$2(page) {
-	const record = asRecord$9(page);
-	return record === void 0 ? "" : textOf$7(record["message"]);
-}
-function hintOf$1(page) {
-	const record = asRecord$9(page);
-	const hint = record === void 0 ? "" : textOf$7(record["hint"]);
-	return hint === "" ? void 0 : hint;
-}
-function pageFailed(page) {
-	const record = asRecord$9(page);
-	return record !== void 0 && record["ok"] === false;
-}
-function blockerFor(code) {
-	const normalized = code.trim().toUpperCase().replace(/-/g, "_");
-	if (normalized === "") return void 0;
-	const matches = (set) => [...set].some((one) => normalized === one || normalized.endsWith(`_${one}`));
-	if (matches(PERMISSION_CODES)) return "permission-denied";
-	if (matches(AUTH_CODES) || normalized.includes("UNAUTH")) return "auth-required";
-}
-function sleep$1(ms) {
-	return new Promise((resolve) => setTimeout(resolve, ms));
-}
-async function shellRun(shell, command, argv, timeoutMs) {
-	const result = await runShell(shell, backgroundLine(command, argv), { timeoutMs });
-	if (result.timedOut) return {
-		kind: "timeout",
-		detail: `没在 ${Math.round(timeoutMs / 1e3)} 秒内返回`,
-		stderr: result.stderr
-	};
-	if (result.exitCode !== 0) return {
-		kind: "failed",
-		detail: tailLines(result.stderr || result.stdout, 4),
-		stderr: result.stderr
-	};
-	return {
-		kind: "ok",
-		stdout: result.stdout
-	};
-}
-async function evalOnce(shell, command, session, script, timeoutMs, retryMs) {
-	const run = async () => {
-		let attempt;
-		try {
-			attempt = await shellRun(shell, command, [
-				"browser",
-				session,
-				"eval",
-				script,
-				"--window",
-				"background"
-			], timeoutMs);
-		} catch (error) {
-			return {
-				kind: "failure",
-				result: {
-					ok: false,
-					code: "cli-exec-failed",
-					message: "读不了：opencli 起不来",
-					hint: "确认这台机器上 opencli 能跑（工作台会自己把它挂好）",
-					detail: error instanceof Error ? error.message : String(error)
-				}
-			};
-		}
-		if (attempt.kind === "timeout") return {
-			kind: "failure",
-			result: {
-				ok: false,
-				code: "cli-timeout",
-				message: "这次没读到（等超时了）",
-				hint: "稍后重试",
-				detail: attempt.detail
-			}
-		};
-		if (attempt.kind === "failed") {
-			const normalized = attempt.stderr.trim().toUpperCase().replace(/-/g, "_");
-			const forbidden = [...PERMISSION_CODES].some((one) => normalized.includes(one));
-			return {
-				kind: "failure",
-				result: {
-					ok: false,
-					code: forbidden ? "permission-denied" : "cli-exec-failed",
-					message: forbidden ? "没有权限在这台机器上读" : "读不了（命令失败）",
-					hint: forbidden ? "换一个有权限的账号，或让用户开权限" : "把下面这段原始输出看一眼再重试",
-					detail: attempt.detail
-				}
-			};
-		}
-		const value = parseJsonLoose(attempt.stdout);
-		if (value === void 0) return {
-			kind: "failure",
-			result: {
-				ok: false,
-				code: "cli-exec-failed",
-				message: "读到了、但不是 JSON",
-				hint: "脚本必须回 JSON",
-				detail: tailLines(attempt.stdout, 4)
-			}
-		};
-		return {
-			kind: "value",
-			value
-		};
-	};
-	const first = await run();
-	if (first.kind === "value") return first;
-	if (first.result.code !== "cli-exec-failed") return first;
-	await sleep$1(retryMs);
-	return run();
-}
-async function openOnce$1(shell, command, session, url, timeoutMs) {
-	let attempt;
-	try {
-		attempt = await shellRun(shell, command, [
-			"browser",
-			session,
-			"open",
-			url,
-			"--window",
-			"background"
-		], timeoutMs);
-	} catch (error) {
-		return {
-			ok: false,
-			code: "cli-exec-failed",
-			message: "打不开那个页面",
-			hint: "确认 opencli 能跑起来",
-			detail: error instanceof Error ? error.message : String(error),
-			helpUrl: url
-		};
-	}
-	if (attempt.kind === "ok") return void 0;
-	return {
-		ok: false,
-		code: attempt.kind === "timeout" ? "cli-timeout" : "cli-exec-failed",
-		message: "打不开那个页面",
-		hint: "在浏览器里手动打开一次，然后重试",
-		detail: attempt.detail,
-		helpUrl: url
-	};
-}
-async function browserRead(options) {
-	const { shell, script, url, loginUrl, open = true } = options;
-	const command = options.command ?? "opencli";
-	const session = options.session ?? "workbench-read";
-	const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS$2;
-	const retryMs = options.retryMs ?? DEFAULT_RETRY_MS;
-	const settleMs = options.settleMs ?? DEFAULT_SETTLE_MS$1;
-	const at = Date.now();
-	const first = await evalOnce(shell, command, session, script, timeoutMs, retryMs);
-	if (first.kind === "failure") return {
-		...first.result,
-		at
-	};
-	let page = first.value;
-	if (codeOf(page) === "not-on-site") {
-		if (!open || url === void 0) return {
-			ok: false,
-			code: "cli-exec-failed",
-			at,
-			message: "没停在那套系统上",
-			hint: "先在那个浏览器里把它打开，再读一次",
-			detail: JSON.stringify(page),
-			...url === void 0 ? {} : { helpUrl: url }
-		};
-		const opened = await openOnce$1(shell, command, session, url, timeoutMs);
-		if (opened !== void 0) return {
-			...opened,
-			at
-		};
-		await sleep$1(settleMs);
-		const second = await evalOnce(shell, command, session, script, timeoutMs, retryMs);
-		if (second.kind === "failure") return {
-			...second.result,
-			at
-		};
-		page = second.value;
-		if (codeOf(page) === "not-on-site") return {
-			ok: false,
-			code: "cli-exec-failed",
-			at,
-			message: "打开了页面、又读了一遍，仍然不在那套系统上",
-			hint: "确认这个地址就是那套系统（或者它跳到了别的域）",
-			detail: JSON.stringify(page),
-			helpUrl: url
-		};
-	}
-	if (!pageFailed(page)) return {
-		ok: true,
-		code: "ok",
-		at,
-		value: page,
-		message: "读到了"
-	};
-	const pageCode = codeOf(page) || "read-failed";
-	const message = messageOf$2(page) || `读不到（${pageCode}）`;
-	const blocker = blockerFor(pageCode);
-	if (blocker === "auth-required") return {
-		ok: false,
-		code: blocker,
-		at,
-		pageCode,
-		message,
-		hint: "去登录一次，再重试",
-		detail: JSON.stringify(page),
-		...loginUrl === void 0 && url === void 0 ? {} : { helpUrl: loginUrl ?? url }
-	};
-	if (blocker === "permission-denied") return {
-		ok: false,
-		code: blocker,
-		at,
-		pageCode,
-		message,
-		hint: "这个账号没有权限",
-		detail: JSON.stringify(page),
-		...loginUrl === void 0 && url === void 0 ? {} : { helpUrl: loginUrl ?? url }
-	};
-	return {
-		ok: false,
-		code: pageCode,
-		at,
-		pageCode,
-		message,
-		detail: JSON.stringify(page),
-		...hintOf$1(page) === void 0 ? {} : { hint: hintOf$1(page) }
-	};
-}
-//#endregion
-//#region ../shared/dist/host/browser-find.js
-var DEFAULT_TIMEOUT_MS$1 = 25e3;
-var DEFAULT_SETTLE_MS = 2500;
-var URL_TIMEOUT_MS = 8e3;
-var DEFAULT_LIMIT = 50;
-var DEFAULT_TEXT_MAX = 200;
-function asRecord$8(value) {
-	return typeof value === "object" && value !== null ? value : void 0;
-}
-function textOf$6(value) {
-	return typeof value === "string" ? value.trim() : "";
-}
-function entriesOf(value) {
-	const record = asRecord$8(value);
-	const raw = record === void 0 ? void 0 : record["entries"];
-	if (!Array.isArray(raw)) return [];
-	const entries = [];
-	for (const one of raw) {
-		const item = asRecord$8(one);
-		if (item === void 0) continue;
-		const nth = typeof item["nth"] === "number" ? item["nth"] : entries.length;
-		entries.push({
-			text: textOf$6(item["text"]),
-			tag: textOf$6(item["tag"]),
-			nth
-		});
-	}
-	return entries;
-}
-function reasonOf(stdout, stderr) {
-	const parsed = asRecord$8(parseJsonLoose(stdout));
-	const error = parsed === void 0 ? void 0 : asRecord$8(parsed["error"]);
-	const message = error === void 0 ? "" : textOf$6(error["message"]);
-	if (message !== "") return message;
-	const lines = (stderr.trim() === "" ? stdout : stderr).split("\n").map((one) => one.trim()).filter((one) => one !== "");
-	return (lines[lines.length - 1] ?? "").slice(-200);
-}
-function hintOf(stdout) {
-	const parsed = asRecord$8(parseJsonLoose(stdout));
-	const error = parsed === void 0 ? void 0 : asRecord$8(parsed["error"]);
-	const hint = error === void 0 ? "" : textOf$6(error["hint"]);
-	return hint === "" ? void 0 : hint;
-}
-function sameOrigin(left, right) {
-	try {
-		return new URL(left).origin === new URL(right).origin;
-	} catch {
-		return false;
-	}
-}
-function urlOf(stdout) {
-	const bare = (stdout.split("\n").map((one) => one.trim()).filter((one) => one !== "")[0] ?? "").replace(/^url:\s*/i, "").trim().replace(/^["']+|["']+$/g, "");
-	if (bare.startsWith("{")) {
-		const parsed = asRecord$8(parseJsonLoose(bare));
-		const url = parsed === void 0 ? "" : textOf$6(parsed["url"]);
-		if (url !== "") return url;
-	}
-	return bare;
-}
-async function currentUrl(shell, command, session) {
-	const line = backgroundLine(command, [
-		"browser",
-		session,
-		"get",
-		"url",
-		"--window",
-		"background"
-	]);
-	try {
-		const result = await runShell(shell, line, { timeoutMs: URL_TIMEOUT_MS });
-		if (result.exitCode !== 0) return "";
-		return urlOf(result.stdout);
-	} catch {
-		return "";
-	}
-}
-function sleep(ms) {
-	return new Promise((resolve) => setTimeout(resolve, ms));
-}
-async function findOnce(shell, command, session, css, limit, textMax, timeoutMs) {
-	const result = await runShell(shell, backgroundLine(command, [
-		"browser",
-		session,
-		"find",
-		"--css",
-		css,
-		"--limit",
-		String(limit),
-		"--text-max",
-		String(textMax),
-		"--window",
-		"background"
-	]), { timeoutMs });
-	if (result.timedOut) return {
-		kind: "timeout",
-		detail: `没在 ${Math.round(timeoutMs / 1e3)} 秒内返回`
-	};
-	if (result.exitCode !== 0) return {
-		kind: "failed",
-		detail: reasonOf(result.stdout, result.stderr),
-		...hintOf(result.stdout) === void 0 ? {} : { hint: hintOf(result.stdout) }
-	};
-	return {
-		kind: "ok",
-		entries: entriesOf(parseJsonLoose(result.stdout)),
-		stdout: result.stdout
-	};
-}
-async function openOnce(shell, command, session, url, timeoutMs) {
-	const line = backgroundLine(command, [
-		"browser",
-		session,
-		"open",
-		url,
-		"--window",
-		"background"
-	]);
-	let result;
-	try {
-		result = await runShell(shell, line, { timeoutMs });
-	} catch (error) {
-		return error instanceof Error ? error.message : String(error);
-	}
-	if (result.timedOut) return `没在 ${Math.round(timeoutMs / 1e3)} 秒内打开`;
-	if (result.exitCode !== 0) {
-		const reason = reasonOf(result.stdout, result.stderr);
-		return reason === "" ? `opencli 打开失败（退出码 ${String(result.exitCode ?? "?")}）` : reason;
-	}
-}
-async function browserFind(options) {
-	const { shell, css, url, open = true } = options;
-	const command = options.command ?? "opencli";
-	const session = options.session ?? "workbench-read";
-	const limit = options.limit ?? DEFAULT_LIMIT;
-	const textMax = options.textMax ?? DEFAULT_TEXT_MAX;
-	const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS$1;
-	const settleMs = options.settleMs ?? DEFAULT_SETTLE_MS;
-	const at = Date.now();
-	const find = async () => {
-		try {
-			return await findOnce(shell, command, session, css, limit, textMax, timeoutMs);
-		} catch (error) {
-			return {
-				kind: "failed",
-				detail: error instanceof Error ? error.message : String(error),
-				hint: "确认这台机器上 opencli 能跑（工作台会自己把它挂好）"
-			};
-		}
-	};
-	const canMove = open && url !== void 0;
-	if (canMove) {
-		const here = await currentUrl(shell, command, session);
-		if (here !== "" && !sameOrigin(here, url)) {
-			const opened = await openOnce(shell, command, session, url, timeoutMs);
-			if (opened !== void 0) return {
-				ok: false,
-				code: "cli-exec-failed",
-				at,
-				entries: [],
-				count: 0,
-				message: "打不开那个页面",
-				hint: "在浏览器里手动打开一次，然后重试",
-				detail: opened,
-				helpUrl: url
-			};
-			await sleep(settleMs);
-		}
-	}
-	let outcome = await find();
-	if (outcome === void 0) return {
-		ok: false,
-		code: "cli-exec-failed",
-		at,
-		entries: [],
-		count: 0,
-		message: "没找到元素"
-	};
-	if (outcome.kind === "failed" && canMove) {
-		if (await openOnce(shell, command, session, url, timeoutMs) === void 0) {
-			await sleep(settleMs);
-			const second = await find();
-			if (second !== void 0) outcome = second;
-		}
-	}
-	if (outcome.kind === "timeout") return {
-		ok: false,
-		code: "cli-timeout",
-		at,
-		entries: [],
-		count: 0,
-		message: "这次没找到元素（等超时了）",
-		hint: "稍后重试",
-		detail: outcome.detail,
-		...url === void 0 ? {} : { helpUrl: url }
-	};
-	if (outcome.kind === "failed") {
-		const detail = outcome.detail;
-		return {
-			ok: false,
-			code: "cli-exec-failed",
-			at,
-			entries: [],
-			count: 0,
-			message: detail === "" ? "没找到元素（opencli 命令失败）" : `没找到元素：${detail}`,
-			...outcome.hint === void 0 ? {} : { hint: outcome.hint },
-			...detail === "" ? {} : { detail },
-			...url === void 0 ? {} : { helpUrl: url }
-		};
-	}
-	return {
-		ok: true,
-		code: "ok",
-		at,
-		entries: outcome.entries,
-		count: outcome.entries.length,
-		message: outcome.entries.length === 0 ? "页面上没有匹配的元素" : `找到 ${String(outcome.entries.length)} 个元素`
-	};
-}
 //#endregion
 //#region ../shared/dist/host/cli-error.js
 function unquote(raw) {
@@ -2552,6 +2226,8 @@ function createWorkspaceStore(options) {
 		}
 	};
 }
+var WORKSHOP_RELATIVE = "workbench/diy";
+var WORKSHOP_TITLE = "工作台DIY";
 //#endregion
 //#region src/shared/api/bundle-install.ts
 var BUNDLE_REGISTRIES_ROUTE = "bundle-registries";
@@ -3068,110 +2744,6 @@ function createRegistryNotebook(dir) {
 	};
 }
 //#endregion
-//#region src/shared/api/diy.ts
-var WORKSHOP_RELATIVE = "workbench/diy";
-var WORKSHOP_TITLE = "工作台DIY";
-//#endregion
-//#region src/shared/api/host/diy.ts
-function workshopPathOf(ctx) {
-	const homePath = ctx.get("dshHomePath");
-	if (typeof homePath !== "function") return null;
-	try {
-		return homePath(WORKSHOP_RELATIVE);
-	} catch {
-		return null;
-	}
-}
-//#endregion
-//#region src/shared/api/host/diy-workshop.ts
-function asRecord$4(value) {
-	return typeof value === "object" && value !== null ? value : void 0;
-}
-function asText$3(value) {
-	return typeof value === "string" ? value.trim() : "";
-}
-function workshopPackagesDir(ctx) {
-	const root = workshopPathOf(ctx);
-	return root === null ? null : join(root, "packages");
-}
-function insideWorkshop(root, target) {
-	return insideWorkshop$1(existsSync(root) ? realpathSync(root) : resolve(root), existsSync(target) ? realpathSync(target) : resolve(target));
-}
-function workshopModules(packagesDir, installed = []) {
-	if (!existsSync(packagesDir)) return [];
-	const already = new Set(installed);
-	return readdirSync(packagesDir, { withFileTypes: true }).filter((entry) => entry.isDirectory() || entry.isSymbolicLink()).flatMap((entry) => {
-		const dir = join(packagesDir, entry.name);
-		let manifest;
-		try {
-			manifest = JSON.parse(readFileSync(join(dir, "package.json"), "utf8"));
-		} catch {
-			return [];
-		}
-		const record = asRecord$4(manifest);
-		const declared = record === void 0 ? void 0 : asRecord$4(asRecord$4(record.dsh)?.workbench);
-		const unit = declared === void 0 ? "" : asText$3(declared.unit);
-		if (unit === "") return [];
-		return [{
-			unit,
-			name: asText$3(record?.name),
-			description: asText$3(record?.description),
-			dir,
-			installed: already.has(unit)
-		}];
-	}).sort((left, right) => left.unit.localeCompare(right.unit));
-}
-function readDesignOfModule(dir) {
-	const file = join(dir, "design.json");
-	if (!existsSync(file)) return void 0;
-	try {
-		return JSON.parse(readFileSync(file, "utf8"));
-	} catch {
-		return;
-	}
-}
-function inWorkshopSession(ctx, workspace) {
-	const root = workshopPathOf(ctx);
-	return root !== null && workspace !== null && insideWorkshop(root, workspace);
-}
-function workshopSyncOf(workshopRoot) {
-	let parsed;
-	try {
-		parsed = JSON.parse(readFileSync(join(workshopRoot, ".sync.json"), "utf8"));
-	} catch {
-		return;
-	}
-	if (typeof parsed !== "object" || parsed === null) return void 0;
-	const record = parsed;
-	const state = asText$3(record["state"]);
-	if (state !== "ok" && state !== "syncing" && state !== "failed") return void 0;
-	const reason = asText$3(record["reason"]);
-	return {
-		state,
-		version: asText$3(record["version"]),
-		at: asText$3(record["at"]),
-		...reason === "" ? {} : { reason }
-	};
-}
-function workshopToolchainOf(workshopRoot) {
-	const versionOf = (name) => {
-		try {
-			return asText$3(JSON.parse(readFileSync(join(workshopRoot, "node_modules", "@dsh-workbench", name, "package.json"), "utf8")).version);
-		} catch {
-			return "";
-		}
-	};
-	const core = versionOf("core");
-	const moduleTools = versionOf("module-tools");
-	const shared = versionOf("shared");
-	if (core === "" || moduleTools === "" || shared === "") return void 0;
-	return {
-		core,
-		moduleTools,
-		shared
-	};
-}
-//#endregion
 //#region src/modules/panels/unit.ts
 var PANELS_LIST_TOOL = "workbench_panels_list";
 var PANELS_SHOW_TOOL = "workbench_panels_show";
@@ -3194,7 +2766,6 @@ var DIY_PANEL_TOOL = "workbench_diy_panel";
 var DIY_COMPONENTS_TOOL = "workbench_diy_components";
 var DIY_RECON_TOOL = "workbench_diy_recon";
 var DIY_SPEC_TOOL = "workbench_diy_spec";
-var DIY_PROBE_TOOL = "workbench_diy_probe";
 var DIY_INSTALL_TOOL = "workbench_diy_install";
 var DIY_SHOW_TOOL = "workbench_diy_show";
 var DIY_STATE_TOOL = "workbench_diy_state";
@@ -3231,7 +2802,6 @@ var READ_TOOLS = [
 	DIY_COMPONENTS_TOOL,
 	DIY_RECON_TOOL,
 	DIY_SPEC_TOOL,
-	DIY_PROBE_TOOL,
 	DIY_STATE_TOOL,
 	DIY_HTML_TOOL,
 	DIY_FIND_TOOL,
@@ -3282,7 +2852,6 @@ var DIY_TOOLS = [
 	DIY_COMPONENTS_TOOL,
 	DIY_RECON_TOOL,
 	DIY_SPEC_TOOL,
-	DIY_PROBE_TOOL,
 	DIY_INSTALL_TOOL,
 	DIY_SHOW_TOOL,
 	DIY_STATE_TOOL,
@@ -3412,7 +2981,7 @@ var panelsApproval = (call) => {
 		const starting = call.name === DIY_DEBUG_START_TOOL;
 		const unit = argsOf$2(call)["unit"];
 		const target = typeof unit === "string" && unit !== "" ? ` [${unit}]` : "";
-		return askOf(`${call.name}${target} takes over the user's screen to debug a workbench module`, pair(starting ? "要在「工作台DIY」那块板上开始调试 —— 调试中请留在那一屏，允许吗？" : "要接着调试 —— 请回到「工作台DIY」那一屏，允许吗？", starting ? "it takes over your screen to debug on the workshop board — please stay on that screen. Allow?" : "it needs your screen again to keep debugging — please go back to the workshop board. Allow?"), pair(starting ? "agent 要占用你的屏幕开始调试工作台模块，允许吗？" : "agent 要接着占用你的屏幕，继续调试工作台模块，允许吗？", starting ? "The agent wants to take over your screen to start debugging a workbench module. Allow?" : "The agent wants your screen again to keep debugging a workbench module. Allow?"));
+		return askOf(`${call.name}${target} takes over the user's screen to debug a workbench module`, pair(starting ? "要在这个工作区的那块板上开始调试 —— 调试中请留在那一屏，允许吗？" : "要接着调试 —— 请回到那一屏，允许吗？", starting ? "it takes over your screen to debug on this workspace's board — please stay on that screen. Allow?" : "it needs your screen again to keep debugging — please go back to that screen. Allow?"), pair(starting ? "agent 要占用你的屏幕开始调试工作台模块，允许吗？" : "agent 要接着占用你的屏幕，继续调试工作台模块，允许吗？", starting ? "The agent wants to take over your screen to start debugging a workbench module. Allow?" : "The agent wants your screen again to keep debugging a workbench module. Allow?"));
 	}
 	if (call.name === "workbench_diy_debug_pause" || call.name === "workbench_diy_debug_stop") return { kind: "allow" };
 	if (call.name === "workbench_diy_record_prepare") {
@@ -3650,21 +3219,38 @@ function toolchainBinOf(root) {
 	const script = join(root, "node_modules", "@dsh-workbench", "module-tools", "bin", "dsh-wb-module.mjs");
 	return existsSync(script) ? script : null;
 }
+function toolchainBinAmong(root, dirs) {
+	const direct = toolchainBinOf(root);
+	if (direct !== null) return direct;
+	for (const dir of dirs) {
+		const bin = toolchainBinOf(dir);
+		if (bin !== null) return bin;
+	}
+	return null;
+}
 function queryCommandOf(bin, only) {
 	return `${quoteShellArg(bin)} check --only ${only} --json`;
 }
-async function runSurfaceQuery(shell, bin, only, root) {
+async function runSurfaceQuery(shell, bin, only, root, fallbackBin) {
 	const result = await runShell(shell, queryCommandOf(bin, only), {
 		workdir: root,
 		timeoutMs: SURFACE_TIMEOUT_MS
 	});
 	const parsed = jsonOf$1(result.stdout);
 	if (parsed !== null) return withoutProblems(parsed);
+	const retry = fallbackBin === void 0 || fallbackBin === bin ? void 0 : fallbackBin;
+	if (retry !== void 0) {
+		const secondParsed = jsonOf$1((await runShell(shell, queryCommandOf(retry, only), {
+			workdir: root,
+			timeoutMs: SURFACE_TIMEOUT_MS
+		})).stdout);
+		if (secondParsed !== null) return withoutProblems(secondParsed);
+	}
 	if (result.exitCode !== 0) {
 		const tail = `${result.stderr}\n${result.stdout}`.trim().split("\n").slice(-3).join(" | ");
 		throw new Error(`工坊工具链的 \`check --only ${only} --json\` 没跑通（exit ${String(result.exitCode)}）—— 这不是工具链坏了，是工坊里有模块过不了判据，所以连清单也没打出来${tail === "" ? "" : `：${tail}`}`);
 	}
-	throw new Error(`工坊工具链的 \`check --only ${only} --json\` 没回 JSON：${result.stdout.trim().split("\n").slice(-2).join(" | ")}`);
+	throw new Error(`工坊工具链的 \`check --only ${only} --json\` 没回 JSON：${result.stdout.trim().split("\n").slice(-2).join(" | ")}` + (retry === void 0 ? ` —— 这份工具链可能太旧（没有 --json）：在 ${root} 里把 @dsh-workbench/module-tools 升到 ^0.3.4（pnpm install）` : " —— 连跑着的那份外壳自带的工具链也没回 JSON，这条得问人"));
 }
 function jsonOf$1(stdout) {
 	try {
@@ -3682,7 +3268,7 @@ function withoutProblems(payload) {
 function recordOf$1(value) {
 	return typeof value === "object" && value !== null ? value : {};
 }
-function asText$2(value) {
+function asText$3(value) {
 	return typeof value === "string" ? value : "";
 }
 function stringsOf$3(value) {
@@ -3764,43 +3350,18 @@ function excerptAt(file, maxLines = 60) {
 		return "（打不开那份类型文件 —— 照上面的路径自己看一眼）";
 	}
 }
+/** 指引目录：从宿主产物往上找 `skills/workbench-module-diy`（找不到回 `null`）。 */
 function skillDirOf(from) {
 	let dir = from;
 	for (let hop = 0; hop < 6; hop += 1) {
 		const candidate = join(dir, "skills", "workbench-module-diy");
-		if (existsSync(join(candidate, "HOOKS.md"))) return candidate;
+		if (existsSync(candidate)) return candidate;
 		const parent = dirname(dir);
 		if (parent === dir) break;
 		dir = parent;
 	}
 	return null;
 }
-function symbolsIn(heading) {
-	return [...heading.matchAll(/`([^`]+)`/g)].map((one) => (one[1] ?? "").trim()).map((one) => one.replace(/[<({[].*$/u, "").trim()).map((one) => one.replace(/[.:：,，\s].*$/u, "").trim()).filter((one) => /^[\w$]+$/u.test(one));
-}
-function sectionOf(text, name) {
-	const rows = text.split("\n");
-	const at = rows.findIndex((row) => row.startsWith("### ") && symbolsIn(row).includes(name));
-	if (at === -1) return "";
-	const rest = rows.slice(at + 1).findIndex((row) => row.startsWith("## ") || row.startsWith("### "));
-	return rows.slice(at, rest === -1 ? rows.length : at + 1 + rest).join("\n").trim();
-}
-function docSectionOf(name, dir) {
-	if (dir === null) return null;
-	for (const doc of ["HOOKS.md", "KIT.md"]) {
-		const file = join(dir, doc);
-		try {
-			const lines = sectionOf(readFileSync(file, "utf8"), name);
-			if (lines !== "") return {
-				file,
-				lines
-			};
-		} catch {
-			continue;
-		}
-	}
-	return null;
-}
 function truncated(names, all) {
 	if (all || names.length <= 12) return names.join(", ");
 	return `${names.slice(0, 12).join(", ")} …+${String(names.length - 12)}`;
@@ -3823,48 +3384,105 @@ function byLocationOf(payload) {
 function isComponents(where) {
 	return where.split("/").at(-1) === "components";
 }
+function kitBucketsOf(payload) {
+	const groups = byLocationOf(payload);
+	const components = groups.filter((one) => isComponents(one.where)).flatMap((one) => one.names).sort();
+	return [...components.length === 0 ? [] : [{
+		label: "组件",
+		key: "components",
+		names: components
+	}], ...groups.filter((one) => !isComponents(one.where)).map((one) => ({
+		label: one.where,
+		key: one.where,
+		names: one.names
+	}))];
+}
+function matchesBucket(where, bucket) {
+	const wanted = bucket.trim().toLowerCase();
+	if (wanted === "") return false;
+	const one = where.trim().toLowerCase();
+	return one === wanted || one.split("/").at(-1) === wanted;
+}
+function primitiveBucketsOf(payload) {
+	return Object.entries(recordOf$1(payload["onlyPrimitives"])).map(([bucket, value]) => ({
+		bucket,
+		names: [...stringsOf$3(value)].sort()
+	})).filter((one) => one.names.length > 0);
+}
+function bucketNamesOf(query) {
+	const out = [];
+	if (query.kit !== void 0) {
+		const keys = kitBucketsOf(query.kit).map((one) => one.key);
+		if (keys.length > 0) out.push({
+			face: "kit",
+			keys
+		});
+	}
+	if (query.primitives !== void 0) {
+		const keys = primitiveBucketsOf(query.primitives).map((one) => one.bucket);
+		if (keys.length > 0) out.push({
+			face: "primitives",
+			keys
+		});
+	}
+	return out;
+}
+var TWO_FACE_ALL = "⚠️ 两个面一起不给全表 —— 要全表就指名一面：scope=kit 或 scope=primitives。";
+function refusesEvery(scope, all, focused) {
+	return all && scope === "all" && !focused;
+}
 function renderSurfaceText(query, options) {
+	const bucket = (options.bucket ?? "").trim();
+	const focused = bucket !== "";
+	if (refusesEvery(options.scope, options.all, focused)) return TWO_FACE_ALL;
+	const both = options.scope === "all";
+	const every = options.all && !both;
+	let hit = false;
 	const lines = [];
 	const kitNames = Object.keys(filesOf$1(query.kit)).sort();
 	if (query.kit !== void 0) {
 		const groups = byLocationOf(query.kit);
 		if (kitNames.length === 0 && groups.length === 0) {
 			const anyNames = [...new Set(Object.values(recordOf$1(query.kit["buckets"])).flatMap((value) => stringsOf$3(value)))].sort();
-			lines.push(anyNames.length === 0 ? "kit：读不到（没找到 client.js）" : `kit：类型面扫不到，只有名字 ${truncated(anyNames, options.all)}`);
+			lines.push(anyNames.length === 0 ? "kit：读不到（没找到 client.js）" : `kit：类型面扫不到，只有名字 ${truncated(anyNames, every)}`);
 		} else {
-			const componentNames = groups.filter((one) => isComponents(one.where)).flatMap((one) => one.names).sort();
-			const countOf = (one) => `${isComponents(one.where) ? "组件" : one.where} ${one.names.length}`;
-			const counts = [...componentNames.length === 0 ? [] : [`组件 ${componentNames.length}`], ...groups.filter((one) => !isComponents(one.where)).map(countOf)];
-			lines.push(`kit ${kitNames.length}：${counts.join(" · ")}`);
-			if (componentNames.length > 0) lines.push(`  组件(${componentNames.length})：${truncated(componentNames, options.all)}`);
-			for (const group of groups) {
-				if (isComponents(group.where)) continue;
-				lines.push(`  ${group.where}(${group.names.length})：${truncated(group.names, options.all)}`);
-			}
+			const buckets = kitBucketsOf(query.kit);
+			lines.push(`kit ${kitNames.length}：${buckets.map((one) => `${one.label} ${one.names.length}`).join(" · ")}`);
+			if (focused) {
+				const matched = buckets.filter((one) => matchesBucket(one.key, bucket));
+				for (const one of matched) lines.push(`  ${one.label}(${one.names.length})：${one.names.join(", ")}`);
+				if (matched.length > 0) hit = true;
+			} else for (const one of buckets) lines.push(`  ${one.label}(${one.names.length})：${truncated(one.names, every)}`);
 		}
 	}
 	if (query.primitives !== void 0) {
 		const version = installedVersionOf(query.primitives);
-		const only = Object.entries(recordOf$1(query.primitives["onlyPrimitives"])).map(([bucket, value]) => ({
-			bucket,
-			names: [...stringsOf$3(value)].sort()
-		})).filter((one) => one.names.length > 0);
+		const only = primitiveBucketsOf(query.primitives);
 		const covered = (Array.isArray(query.primitives["kitCovered"]) ? query.primitives["kitCovered"] : []).map((one) => recordOf$1(one)["name"]).filter((one) => typeof one === "string");
 		if (version === null) {
-			const want = asText$2(recordOf$1(recordOf$1(query.primitives["snippet"])["devDependency"])["version"]);
+			const want = asText$3(recordOf$1(recordOf$1(query.primitives["snippet"])["devDependency"])["version"]);
 			lines.push(`原语：没装 —— devDependencies 加 "${PRIMITIVES_PKG}": "${want === "" ? "<外壳钉的那版>" : want}" 再 pnpm install`);
-		} else lines.push(`原语 ${version}${only.length === 0 ? "" : `：只有它有 ${only.map((one) => `${one.bucket} ${truncated(one.names, options.all)}`).join(" · ")}`}`);
+		} else if (focused) {
+			lines.push(`原语 ${version}${only.length === 0 ? "" : `：只有它有 ${only.map((one) => `${one.bucket} ${one.names.length}`).join(" · ")}`}`);
+			const matched = only.filter((one) => matchesBucket(one.bucket, bucket));
+			for (const one of matched) lines.push(`  ${one.bucket}(${one.names.length})：${one.names.join(", ")}`);
+			if (matched.length > 0) hit = true;
+		} else lines.push(`原语 ${version}${only.length === 0 ? "" : `：只有它有 ${only.map((one) => `${one.bucket} ${truncated(one.names, every)}`).join(" · ")}`}`);
 		if (only.length > 0 && version !== null) lines.push("（只有原语有的，用之前先在 dsh.client.external 里声明）");
 		if (covered.length > 0) lines.push(`kit 里已有：${covered.join(", ")}`);
 	}
+	if (focused && !hit) {
+		const keys = bucketNamesOf(query);
+		lines.push(keys.length === 0 ? `没有「${bucket}」这一桶，这次也读不到任何桶。` : `没有「${bucket}」这一桶。可用的桶：${keys.map((one) => `${one.face} → ${one.keys.join(" / ")}`).join("；")}`);
+	}
 	const roots = [...Object.entries(rootsOf(query.kit)).map(([key, dir]) => `${key}=${dir}`), ...Object.entries(rootsOf(query.primitives)).map(([key, dir]) => `${key}=${dir}`)];
 	if (roots.length > 0) lines.push(`类型面：${roots.join(" · ")}`);
-	lines.push(faceStateOf(query, "primitives") === "unreadable" ? "name=<件> 看它怎么用 · all=true 出全表（原语装过才能问原语那类）" : "name=<件> 看它怎么用 · all=true 出全表");
 	const text = lines.join("\n");
 	if (text.length <= 8192) return text;
+	const commands = (options.scope === "all" ? ["kit", "primitives"] : [options.scope]).map((one) => `\`dsh-wb-module check --only ${one} --all\``).join(" 或 ");
 	return [
-		`⚠️ 这份清单 ${String(text.length)} 字符，超过 ${String(PRUNE_CHARS)} 会被修剪器裁掉中间：`,
-		`   一件件问（name=<件>）或到 shell 里跑 \`dsh-wb-module check --only ${options.scope === "all" ? "primitives|kit" : options.scope} --all\` 再 grep。`,
+		`⚠️ 这份清单 ${String(text.length)} 字符，超过 ${String(PRUNE_CHARS)} 会被修剪器裁掉中间 —— 按桶问装得下；要一份全的走 shell：${commands} 再 grep。`,
+		"   （shell 那份按 barrel 列，计数比这里的落点分组大 —— 两边口径不同。）",
 		"",
 		text
 	].join("\n");
@@ -3876,7 +3494,7 @@ function listedNamesOf(query) {
 		for (const value of Object.values(recordOf$1(payload["buckets"]))) for (const one of stringsOf$3(value)) out.add(one);
 		for (const value of Object.values(recordOf$1(payload["onlyPrimitives"]))) for (const one of stringsOf$3(value)) out.add(one);
 		for (const one of Array.isArray(payload["kitCovered"]) ? payload["kitCovered"] : []) {
-			const covered = asText$2(recordOf$1(one)["name"]);
+			const covered = asText$3(recordOf$1(one)["name"]);
 			if (covered !== "") out.add(covered);
 		}
 	}
@@ -3893,8 +3511,8 @@ function faceStateOf(query, face) {
 }
 function installSnippetOf(query) {
 	const dependency = recordOf$1(recordOf$1(query.primitives?.["snippet"])["devDependency"]);
-	const name = asText$2(dependency["name"]) || "@deepseek-ai/dsh-client-ui-primitives";
-	const version = asText$2(dependency["version"]);
+	const name = asText$3(dependency["name"]) || "@deepseek-ai/dsh-client-ui-primitives";
+	const version = asText$3(dependency["version"]);
 	return `devDependencies 加 "${name}": "${version === "" ? "<外壳钉的那版>" : version}" 再 pnpm install`;
 }
 function renderNameText(name, found, query) {
@@ -3912,23 +3530,156 @@ function renderNameText(name, found, query) {
 		return lines.join("\n");
 	}
 	const body = excerptAt(found.file);
+	const head = `${name} → ${found.file}（${found.from === "kit" ? "kit" : "原语"}）`;
 	if (body.includes("/**")) return [
-		`${name} → ${found.file}（${found.from === "kit" ? "kit" : "原语"}）`,
+		head,
 		"",
 		body,
 		"",
-		found.from === "kit" ? "（上面就是它的声明；@param 写着默认值。kit 件最小写法：KIT.md）" : "（上面就是它的声明；@param 写着默认值。原语件要先在 dsh.client.external 里声明它）"
+		found.from === "kit" ? "（上面就是它的声明与 JSDoc —— 用法、默认值、边界都在里面。跨件的口径与最小写法看 KIT.md）" : "（上面就是它的声明与 JSDoc —— 用法与默认值都在里面。原语件要先在 dsh.client.external 里声明它）"
 	].join("\n");
-	const skillDir = skillDirOf(dirname(fileURLToPath(import.meta.url)));
-	const doc = docSectionOf(name, skillDir);
+	const second = skillDirOf(dirname(fileURLToPath(import.meta.url))) === null ? "这份外壳连指引也没装 —— 升级它。" : `跨件的口径看 KIT.md（组件怎么拼）· LINKAGE.md / PANEL.md / TOOLS.md（取数 / 写 / 长任务）。`;
 	return [
-		`${name} → ${found.file}（${found.from === "kit" ? "kit" : "原语"}）`,
+		head,
 		"",
 		body,
 		"",
-		doc === null ? `（声明没说明文字；${skillDir === null ? "指引也没装" : `指引里没有专门讲「${name}」的一节`} —— 源码零注释，tsc 不 emit JSDoc。用法看 KIT.md / HOOKS.md / LINKAGE.md / PANEL.md / TOOLS.md。）` : `（声明没说明文字（零注释）；语义出自 ${basename(doc.file)}：）\n\n${doc.lines}`
+		found.from === "kit" ? `（声明没说明文字（没有 JSDoc）—— kit 的每个成员都该有，selfcheck 里有一条自检钉着；多半是你手上这份外壳比工具旧，升级外壳与工坊工具链再看。${second}）` : `（声明没说明文字（没有 JSDoc）—— 装机那份原语本该自带；升级它再看。${second}）`
 	].join("\n");
 }
+//#endregion
+//#region src/shared/api/host/diy.ts
+function workshopPathOf(ctx) {
+	const homePath = ctx.get("dshHomePath");
+	if (typeof homePath !== "function") return null;
+	try {
+		return homePath(WORKSHOP_RELATIVE);
+	} catch {
+		return null;
+	}
+}
+//#endregion
+//#region src/shared/api/host/diy-workshop.ts
+function asRecord$4(value) {
+	return typeof value === "object" && value !== null ? value : void 0;
+}
+function asText$2(value) {
+	return typeof value === "string" ? value.trim() : "";
+}
+function insideWorkshop(root, target) {
+	return insideWorkshop$1(existsSync(root) ? realpathSync(root) : resolve(root), existsSync(target) ? realpathSync(target) : resolve(target));
+}
+function workshopModules(packagesDir, installed = []) {
+	if (!existsSync(packagesDir)) return [];
+	const already = new Set(installed);
+	return readdirSync(packagesDir, { withFileTypes: true }).filter((entry) => entry.isDirectory() || entry.isSymbolicLink()).flatMap((entry) => {
+		const dir = join(packagesDir, entry.name);
+		let manifest;
+		try {
+			manifest = JSON.parse(readFileSync(join(dir, "package.json"), "utf8"));
+		} catch {
+			return [];
+		}
+		const record = asRecord$4(manifest);
+		const declared = record === void 0 ? void 0 : asRecord$4(asRecord$4(record.dsh)?.workbench);
+		const unit = declared === void 0 ? "" : asText$2(declared.unit);
+		if (unit === "") return [];
+		return [{
+			unit,
+			name: asText$2(record?.name),
+			description: asText$2(record?.description),
+			dir,
+			installed: already.has(unit)
+		}];
+	}).sort((left, right) => left.unit.localeCompare(right.unit));
+}
+function readDesignOfModule(dir) {
+	const file = join(dir, "design.json");
+	if (!existsSync(file)) return void 0;
+	try {
+		return JSON.parse(readFileSync(file, "utf8"));
+	} catch {
+		return;
+	}
+}
+function workshopSyncOf(workshopRoot) {
+	let parsed;
+	try {
+		parsed = JSON.parse(readFileSync(join(workshopRoot, ".sync.json"), "utf8"));
+	} catch {
+		return;
+	}
+	if (typeof parsed !== "object" || parsed === null) return void 0;
+	const record = parsed;
+	const state = asText$2(record["state"]);
+	if (state !== "ok" && state !== "syncing" && state !== "failed") return void 0;
+	const reason = asText$2(record["reason"]);
+	return {
+		state,
+		version: asText$2(record["version"]),
+		at: asText$2(record["at"]),
+		...reason === "" ? {} : { reason }
+	};
+}
+function workshopToolchainOf(workshopRoot) {
+	const versionOf = (name) => {
+		try {
+			return asText$2(JSON.parse(readFileSync(join(workshopRoot, "node_modules", "@dsh-workbench", name, "package.json"), "utf8")).version);
+		} catch {
+			return "";
+		}
+	};
+	const core = versionOf("core");
+	const moduleTools = versionOf("module-tools");
+	const shared = versionOf("shared");
+	if (core === "" || moduleTools === "" || shared === "") return void 0;
+	return {
+		core,
+		moduleTools,
+		shared
+	};
+}
+//#endregion
+//#region src/shared/api/host/workshop-root.ts
+function rootAt(root, title) {
+	return {
+		root,
+		packagesDir: join(root, "packages"),
+		title
+	};
+}
+async function resolveAt(registry, dir) {
+	try {
+		return await registry.resolveByPath(dir);
+	} catch {
+		return;
+	}
+}
+function looksLikeWorkshop(dir) {
+	return existsSync(join(dir, "packages")) || existsSync(join(dir, "pnpm-workspace.yaml"));
+}
+async function workshopRootOf(ctx, workspace) {
+	const start = typeof workspace === "string" ? workspace.trim() : "";
+	if (start === "") return null;
+	const registry = ctx.get("workspaceRegistry");
+	if (registry !== void 0) {
+		let dir = start;
+		for (;;) {
+			const hit = await resolveAt(registry, dir);
+			if (hit !== void 0) return rootAt(hit.path, hit.title);
+			const parent = dirname(dir);
+			if (parent === dir) break;
+			dir = parent;
+		}
+	}
+	let dir = start;
+	for (;;) {
+		if (looksLikeWorkshop(dir)) return rootAt(dir, basename(dir));
+		const parent = dirname(dir);
+		if (parent === dir) return null;
+		dir = parent;
+	}
+}
 var OUTPUT$2 = {
 	schema: {
 		type: "object",
@@ -3988,26 +3739,6 @@ function verdictOf$1(change) {
 	const tail = (change.packageResult?.output ?? "").trim().split("\n").slice(-3).join(" | ");
 	return `没装上（${change.errorCode ?? "failed"}）${tail === "" ? "" : `：${tail}`}`;
 }
-function renderProbe(out) {
-	if (out.ok) return `读到了 —— 这就是那条读的返回值，把它固化成模块宿主半侧的那一条：\n${(JSON.stringify(out.value, null, 2) ?? "undefined").slice(0, 2e3)}`;
-	const lines = [`没读到（${out.code}）：${out.message}`];
-	if (out.hint !== void 0) lines.push(`照做：${out.hint}`);
-	if (out.helpUrl !== void 0) lines.push(`入口：${out.helpUrl}`);
-	if (out.pageCode !== void 0) lines.push(`页面自己回的码：${out.pageCode}`);
-	return lines.join("\n");
-}
-function renderFind(out) {
-	if (!out.ok) {
-		const lines = [`没找到（${out.code}）：${out.message}`];
-		if (out.hint !== void 0) lines.push(`照做：${out.hint}`);
-		if (out.helpUrl !== void 0) lines.push(`入口：${out.helpUrl}`);
-		return lines.join("\n");
-	}
-	if (out.count === 0) return "找到了 0 个元素 —— 选择器没匹配到东西。先确认停在哪一页（probe 会自己问页面），再把选择器放宽一点（例如 table tr 而不是某个 id）。";
-	const head = out.entries.slice(0, 20).map((one, index) => `${String(index + 1)}. ${one.text.replace(/\n+/g, " | ").slice(0, 200)}`);
-	const more = out.entries.length > 20 ? `\n… 还有 ${String(out.entries.length - 20)} 个` : "";
-	return `找到了 ${String(out.count)} 个元素 —— 每行的单元格按换行拼在 text 里；把它固化成模块宿主半侧的那一条（host 的 browserFind + 切格 + 按列序取值）：\n${head.join("\n")}${more}`;
-}
 function showOrReason(panels, unit, workspace) {
 	try {
 		panels.show(unit, workspace);
@@ -4019,14 +3750,14 @@ function showOrReason(panels, unit, workspace) {
 		};
 	}
 }
-function workshopOf(ctx, exec) {
-	const packagesDir = workshopPackagesDir(ctx);
-	if (packagesDir === null) throw new Error("算不出 DIY 工坊在哪（这台机器没给出 dshHomePath）—— 让用户跑一次 dsh-workbench setup");
+async function workshopOf(ctx, exec) {
 	const session = sessionWorkspace(exec);
-	if (!inWorkshopSession(ctx, session)) throw new Error(`这把工具只在 DIY 工坊里用：当前会话不在工坊里（这个会话的工作区 ${session ?? "(不知道)"}）—— 普通项目里装模块用 workbench_modules_install，工坊的入口是左栏那一行「工作台DIY」`);
+	const root = await workshopRootOf(ctx, session);
+	if (root === null) throw new Error(`这个工作区没有模块包可落地：DIY 工具把模块放在会话工作区的 packages/ 下（这个会话的工作区 ${session ?? "(不知道)"}）—— 换到一个有模块包的工作区，或者按工程域在仓库里用 dsh-wb-module 新建一个模块包`);
 	return {
-		packagesDir,
-		workspace: session
+		packagesDir: root.packagesDir,
+		workspace: root.root,
+		title: root.title
 	};
 }
 function modulesOf(ctx, packagesDir) {
@@ -4036,6 +3767,9 @@ function modulesOf(ctx, packagesDir) {
 		modules: workshopModules(packagesDir, installed)
 	};
 }
+function moduleDirsOf(packagesDir) {
+	return workshopModules(packagesDir).map((one) => one.dir);
+}
 function panelEntriesOf(panels, workspace) {
 	try {
 		return panels.list(workspace);
@@ -4048,7 +3782,7 @@ function panelEntriesOf(panels, workspace) {
 function componentsTool(ctx) {
 	return {
 		name: DIY_COMPONENTS_TOOL,
-		description: "工坊里能用什么：dsh 原语与外壳 kit 的清单、每件的类型文件在哪（给 name 连 JSDoc 与 prop 一起回）。",
+		description: "工坊里能用什么：dsh 原语与外壳 kit 的清单、每件的类型文件在哪（给 name 连 JSDoc 与 prop 一起回；给 bucket 把那一桶列全 —— 桶名见清单）。",
 		parameters: {
 			type: "object",
 			properties: {
@@ -4058,33 +3792,48 @@ function componentsTool(ctx) {
 				},
 				scope: {
 					type: "string",
-					enum: [
-						"all",
-						"primitives",
-						"kit"
-					],
-					description: "只看某一面（默认 all）。"
+					enum: ["kit", "primitives"],
+					description: "只看某一面；不填就两个面都给目录。"
+				},
+				bucket: {
+					type: "string",
+					description: "只看某一桶并列全（例 components / icons / shared/hooks；桶名以清单里那份为准）。"
 				},
 				all: {
 					type: "boolean",
-					description: "列全表（默认每组前 12 个）。"
+					description: "列全表（默认每组前 12 个）—— 只在指名 scope 时生效；不指名 scope 时只回一句提示，不带目录。"
 				}
 			},
 			additionalProperties: false
 		},
 		output: OUTPUT$2,
 		async execute(raw, exec) {
-			const { packagesDir } = workshopOf(ctx, exec);
+			const { packagesDir } = await workshopOf(ctx, exec);
 			const root = dirname(packagesDir);
-			const bin = toolchainBinOf(root);
-			if (bin === null) throw new Error(`工坊里还没装工具链（${join(root, "node_modules")} 里没有 dsh-wb-module）—— 在工坊根目录跑一次 pnpm install 就有了；workbench_diy_status 会告诉你卡在哪一步`);
-			const shell = ctx.get("shell");
-			if (shell === void 0) throw new Error("这台机器没给 shell 服务，读不了组件清单");
 			const args = asRecord$3(raw);
 			const scope = scopeOf$1(asText$1(args["scope"]));
 			const name = asText$1(args["name"]);
+			const bucket = asText$1(args["bucket"]);
 			const all = args["all"] === true;
-			const [primitives, kit] = await Promise.all([wantsPrimitives(scope) ? runSurfaceQuery(shell, bin, "primitives", root) : Promise.resolve(void 0), wantsKit(scope) ? runSurfaceQuery(shell, bin, "kit", root) : Promise.resolve(void 0)]);
+			if (name === "" && refusesEvery(scope, all, bucket !== "")) return plainJson({
+				workshop: root,
+				scope,
+				name,
+				bucket,
+				all,
+				file: null,
+				from: null,
+				primitives: null,
+				kit: null,
+				text: TWO_FACE_ALL
+			});
+			const bin = toolchainBinAmong(root, moduleDirsOf(packagesDir));
+			if (bin === null) throw new Error(`工坊里还没装工具链（${join(root, "node_modules")} 与各模块自己的 node_modules 里都没有 dsh-wb-module）—— 在工坊根目录跑一次 pnpm install 就有了；workbench_diy_status 会告诉你卡在哪一步`);
+			const shell = ctx.get("shell");
+			if (shell === void 0) throw new Error("这台机器没给 shell 服务，读不了组件清单");
+			const builtin = workshopPathOf(ctx);
+			const fallbackBin = builtin === null ? void 0 : toolchainBinOf(builtin) ?? void 0;
+			const [primitives, kit] = await Promise.all([wantsPrimitives(scope) ? runSurfaceQuery(shell, bin, "primitives", root, fallbackBin) : Promise.resolve(void 0), wantsKit(scope) ? runSurfaceQuery(shell, bin, "kit", root, fallbackBin) : Promise.resolve(void 0)]);
 			const query = {
 				...primitives === void 0 ? {} : { primitives },
 				...kit === void 0 ? {} : { kit }
@@ -4092,12 +3841,14 @@ function componentsTool(ctx) {
 			const found = name === "" ? null : findFileOf(name, query);
 			const text = name === "" ? renderSurfaceText(query, {
 				scope,
-				all
+				all,
+				bucket
 			}) : renderNameText(name, found, query);
 			return plainJson({
 				workshop: root,
 				scope,
 				name,
+				bucket,
 				all,
 				file: found?.file ?? null,
 				from: found?.from ?? null,
@@ -4274,8 +4025,9 @@ function debugForeignPactText(held) {
 	return `另一场调试正占着那块屏（${held.sessionId} 在调试 ${held.unit}）—— 一台机器同时只允许一场：让它先 workbench_diy_debug_stop，或等它收工。`;
 }
 function debugOffBoardText(held, situation = "other-board") {
-	const what = situation === "off-workspace" ? "用户现在不在 DIY 工作区（外壳选中的是别的工作区）" : situation === "panel-closed" ? "工作台面板没画在屏上（右栏收着，或那一列让给了别的面板）" : "你现在这一页画的不是工坊那块板";
-	const next = situation === "off-workspace" ? "让用户在左栏切回「工作台DIY」那个工作区" : situation === "panel-closed" ? "让用户把「工作台面板」切回来（或把右栏展开）" : "让用户把那一页切回「工作台DIY」";
+	const where = held.title === "" ? "这一场调试所在的工作区" : `「${held.title}」`;
+	const what = situation === "off-workspace" ? `用户现在不在${where}（外壳选中的是别的工作区）` : situation === "panel-closed" ? "工作台面板没画在屏上（右栏收着，或那一列让给了别的面板）" : `你现在这一页画的不是${where}那块板`;
+	const next = situation === "off-workspace" ? `让用户在左栏切回${where}` : situation === "panel-closed" ? "让用户把「工作台面板」切回来（或把右栏展开）" : `让用户把那一页切回${where}`;
 	return `${what} —— 看 / 动 / 网络这一族现在发不出去，我不拿别的板当目标。${held.unit} 这场调试仍然**进行中**（我没有自动替你落 paused）：${next}；要停下来就自己 workbench_diy_debug_pause（不问审批），页面切回来了就接着看。`;
 }
 function boardProbeOf(page) {
@@ -4291,13 +4043,14 @@ function boardProbeOf(page) {
 function boardStateOf(page, workshop) {
 	return boardFactOf(boardProbeOf(page), workshop);
 }
-function boardGateText(situation, unit, page) {
-	if (situation === "off-workspace") return `用户现在不在 DIY 工作区 —— 外壳选中的是 ${page.where || "(问不出来是哪一块)"}。工坊那块板没在屏上，${unit} 的这张卡我看不到，也不拿别的板当目标。让用户在左栏切回「工作台DIY」；这之前我可以继续改源码 / build / 跑门禁。`;
+function boardGateText(situation, unit, page, title = "") {
+	const where = title === "" ? "这一场调试所在的工作区" : `「${title}」`;
+	if (situation === "off-workspace") return `用户现在不在${where} —— 外壳选中的是 ${page.where || "(问不出来是哪一块)"}。${where}那块板没在屏上，${unit} 的这张卡我看不到，也不拿别的板当目标。让用户在左栏切回${where}；这之前我可以继续改源码 / build / 跑门禁。`;
 	if (situation === "panel-closed") return `工作台面板没画在屏上（右栏收着，或者这一页让给了别的面板：文件预览、模块市场等）。让用户把「工作台面板」切回来（或把右栏展开），我再接着看 ${unit}。`;
-	return `你现在这一页画的是 ${page.board || "(不知道哪一块)"} 的面板，工坊那块板没在这一屏 —— ${unit} 的这张卡不在屏上，我不拿别的板当目标。请用户在左栏切回「工作台DIY」；这之前我可以继续改源码 / build / 跑门禁。`;
+	return `你现在这一页画的是 ${page.board || "(不知道哪一块)"} 的面板，${where}那块板没在这一屏 —— ${unit} 的这张卡不在屏上，我不拿别的板当目标。请用户在左栏切回${where}；这之前我可以继续改源码 / build / 跑门禁。`;
 }
 async function pageAt(ctx, exec, raw, options = {}) {
-	const { packagesDir } = workshopOf(ctx, exec);
+	const { packagesDir, workspace, title } = await workshopOf(ctx, exec);
 	const args = asRecord$3(raw);
 	const asked = asText$1(args["unit"]);
 	const modules = modulesOf(ctx, packagesDir).modules;
@@ -4320,11 +4073,10 @@ async function pageAt(ctx, exec, raw, options = {}) {
 		const { page } = handshake;
 		throw new Error(`你现在这一页不是工作台（${page.title || "(没有标题)"} ${page.url}）—— 把工作台那一页切到前台，再喊我一次。我只看用户正在看的那一页。`);
 	}
-	const workshop = workshopPathOf(ctx);
-	const board = boardStateOf(handshake.page, workshop);
-	const situation = boardSituation(boardProbeOf(handshake.page), workshop);
+	const board = boardStateOf(handshake.page, workspace);
+	const situation = boardSituation(boardProbeOf(handshake.page), workspace);
 	if (options.requirePact !== false && held !== null && (board === "other" || board === "hidden")) throw new Error(debugOffBoardText(held, situation));
-	if (options.requireBoard !== false && (board === "other" || board === "hidden")) throw new Error(boardGateText(situation, wanted, handshake.page));
+	if (options.requireBoard !== false && (board === "other" || board === "hidden")) throw new Error(boardGateText(situation, wanted, handshake.page, title));
 	return {
 		packagesDir,
 		unit: wanted,
@@ -4365,7 +4117,7 @@ function renderDebugPause(state) {
 	return [`调试暂停了（${state.unit}）—— 动作族关闸，不再拿屏当目标。`, "改源码 / build / 跑门禁照常；要看屏再 workbench_diy_debug_resume（会再要用户点头一次）。"].join("\n");
 }
 function renderDebugResume(state) {
-	return [`继续调试 ${state.unit} —— 请用户回到「工作台DIY」那一屏。`, "卡不在屏上时我会当场拒（不拿别的板当目标）。"].join("\n");
+	return [`继续调试 ${state.unit} —— 请用户回到「${state.title}」那一屏。`, "卡不在屏上时我会当场拒（不拿别的板当目标）。"].join("\n");
 }
 function renderDebugStop(state) {
 	return `收工了：${state.unit} 的调试态清掉了（占用解除）。`;
@@ -4389,7 +4141,7 @@ function registerDebugTools(ctx, tools, store) {
 		},
 		output: OUTPUT$2,
 		async execute(raw, exec) {
-			const { packagesDir, workspace } = workshopOf(ctx, exec);
+			const { packagesDir, workspace, title } = await workshopOf(ctx, exec);
 			const unit = asText$1(asRecord$3(raw)["unit"]);
 			if (unit === "") {
 				const { modules } = modulesOf(ctx, packagesDir);
@@ -4402,7 +4154,8 @@ function registerDebugTools(ctx, tools, store) {
 			});
 			const state = moveOrThrow$1(store.begin({
 				sessionId: sessionIdOf(exec) ?? "",
-				workspace: workspace ?? "",
+				workspacePath: workspace ?? "",
+				title,
 				board: page.boardPath,
 				unit,
 				name: modulesOf(ctx, packagesDir).modules.find((one) => one.unit === unit)?.name ?? unit,
@@ -4424,7 +4177,7 @@ function registerDebugTools(ctx, tools, store) {
 		parameters: EMPTY,
 		output: OUTPUT$2,
 		async execute(_raw, exec) {
-			const { packagesDir } = workshopOf(ctx, exec);
+			const { packagesDir } = await workshopOf(ctx, exec);
 			const held = store.live(Date.now());
 			const state = moveOrThrow$1(store.pause(sessionIdOf(exec) ?? "", Date.now()), held);
 			return plainJson({
@@ -4438,11 +4191,11 @@ function registerDebugTools(ctx, tools, store) {
 	};
 	const resumeTool = {
 		name: DIY_DEBUG_RESUME_TOOL,
-		description: "继续调试（要点头一次）：请用户回到「工作台DIY」那一屏。",
+		description: "继续调试（要点头一次）：请用户回到这一场调试所在的那一屏。",
 		parameters: EMPTY,
 		output: OUTPUT$2,
 		async execute(_raw, exec) {
-			const { packagesDir } = workshopOf(ctx, exec);
+			const { packagesDir } = await workshopOf(ctx, exec);
 			const held = store.live(Date.now());
 			const page = await pageAt(ctx, exec, { unit: held?.unit ?? "" }, {
 				requireBoard: false,
@@ -4466,7 +4219,7 @@ function registerDebugTools(ctx, tools, store) {
 		parameters: EMPTY,
 		output: OUTPUT$2,
 		async execute(_raw, exec) {
-			const { packagesDir } = workshopOf(ctx, exec);
+			const { packagesDir } = await workshopOf(ctx, exec);
 			const held = store.live(Date.now());
 			const state = moveOrThrow$1(store.stop(sessionIdOf(exec) ?? "", Date.now()), held);
 			await store.settle?.();
@@ -5149,7 +4902,11 @@ function parametersOf(row) {
 		},
 		timeoutMs: {
 			type: "number",
-			description: "超时毫秒（默认 30000；≤0 或非数也按默认算）。"
+			description: "超时毫秒（默认 30000）。"
+		},
+		read: {
+			type: "string",
+			description: "只读线：给站点地址（不碰你那一屏、不要调试约定）。"
 		}
 	};
 	if (row.css !== void 0) properties["scope"] = {
@@ -5217,7 +4974,80 @@ function needsCardOf(row, raw) {
 	if (row.css !== void 0 && asText$1(raw["scope"]) === "card") return true;
 	return stringsOf$2(raw["args"]).some((one) => one.includes(CARD_TOKEN));
 }
+function hostOf$1(url) {
+	try {
+		return new URL(url).host;
+	} catch {
+		return "";
+	}
+}
+async function onSiteOnce(shell, command, site) {
+	const step = await runBrowserStep(shell, command, [
+		"browser",
+		BROWSER_READ_SESSION,
+		"get",
+		"url",
+		"--window",
+		"background"
+	], LOOK_TIMEOUT_MS);
+	const want = hostOf$1(site);
+	if (want === "" || hostOf$1(step.stdout.trim()) === want) return false;
+	await runBrowserStep(shell, command, [
+		"browser",
+		BROWSER_READ_SESSION,
+		"open",
+		site,
+		"--window",
+		"background"
+	], LOOK_TIMEOUT_MS);
+	return true;
+}
+function loginHintOf(stdout, site) {
+	const code = jsonOf(stdout)?.["code"];
+	if (code === "not-logged-in") return `没登录：去 ${site} 登一次再重跑（读线的约定：脚本回 { ok: false, code: "not-logged-in" }）。`;
+	if (code === "not-on-site") return `还不在 ${site} 上：我开过一次了 —— 让用户在那扇窗里切过去登一次，再重跑。`;
+	return "";
+}
+function readRefusalOf(row, raw) {
+	if (asText$1(raw["unit"]) !== "" || asText$1(raw["scope"]) === "card" || asText$1(raw["in"]) === "card" || stringsOf$2(raw["args"]).some((one) => one.includes("$card"))) return "只读线上没有「用户那张卡」：unit / scope=card / in=card / $card 只在屏那一档能用。";
+	return row.clip === true ? "只读线不截图裁剪 —— clip 是屏那一档的事（要图走 _screenshot）。" : "";
+}
+async function runReadTool(row, ctx, raw, site) {
+	const refused = readRefusalOf(row, raw);
+	if (refused !== "") throw new Error(refused);
+	const shell = ctx.get("shell");
+	if (shell === void 0) throw new Error("这台机器上没有 shell 服务，驱动不了浏览器");
+	const command = opencliCommandOf(ctx).command;
+	const requested = asNumber(raw["timeoutMs"]);
+	const timeoutMs = requested !== void 0 && requested > 0 ? requested : DEFAULT_TIMEOUT_MS;
+	const argv = stringsOf$2(raw["args"]);
+	const opened = await onSiteOnce(shell, command, site);
+	const step = await runBrowserStep(shell, command, [
+		"browser",
+		BROWSER_READ_SESSION,
+		...row.verb,
+		...argv,
+		"--window",
+		"background"
+	], timeoutMs);
+	const hint = row.tool === "workbench_diy_eval" ? loginHintOf(step.stdout, site) : "";
+	return {
+		session: BROWSER_READ_SESSION,
+		verb: row.verb.join(" "),
+		argv,
+		opened,
+		ok: step.ok,
+		exitCode: step.exitCode,
+		timedOut: step.timedOut,
+		truncated: step.truncated,
+		stdout: hint === "" ? step.stdout : `${step.stdout}\n${hint}`,
+		stderr: step.stderr
+	};
+}
 async function runBrowserTool(row, ctx, raw, exec) {
+	const args = asRecord$3(raw);
+	const read = asText$1(args["read"]);
+	if (read !== "") return runReadTool(row, ctx, args, read);
 	const page = await pageAt(ctx, exec, raw, { requireUnit: false });
 	if (needsCardOf(row, page.args) && page.unit === "") throw new Error("要卡作用域（scope=card / $card / in=card）就得给一个 unit —— 工坊里不止一个模块时，我不知道你说哪一张卡。");
 	const requested = asNumber(page.args["timeoutMs"]);
@@ -5525,7 +5355,7 @@ function nextOf(answer) {
 	}
 	const plugin = answer.plugins[0];
 	if (plugin !== void 0) return `这台机器另装的插件 ${plugin.name} 里有匹配：opencli ${plugin.name} --help 看全部命令`;
-	return "这台机器上没有现成的 —— 两条路：① 给这个站点写 adapter：opencli skills read opencli-adapter-author；② 只读一次：workbench_diy_probe（script 读接口 / css 读 DOM）";
+	return "这台机器上没有现成的 —— 两条路：① 给这个站点写 adapter：opencli skills read opencli-adapter-author；② 只读一次：workbench_diy_eval / _find 带 read=<地址>（在 workbench-read 上跑，借用户已登录的那扇窗）";
 }
 function signatureOf$1(args) {
 	const shown = args.slice(0, ARG_LIMIT).map((one) => {
@@ -6055,7 +5885,7 @@ function registerDiyTools(ctx, market, panels, debug) {
 		},
 		output: OUTPUT$2,
 		async execute(_raw, exec) {
-			const { packagesDir } = workshopOf(ctx, exec);
+			const { packagesDir } = await workshopOf(ctx, exec);
 			const { modules } = modulesOf(ctx, packagesDir);
 			return plainJson({
 				workshop: packagesDir,
@@ -6078,7 +5908,7 @@ function registerDiyTools(ctx, market, panels, debug) {
 		},
 		output: OUTPUT$2,
 		async execute(raw, exec) {
-			const { packagesDir, workspace } = workshopOf(ctx, exec);
+			const { packagesDir, workspace } = await workshopOf(ctx, exec);
 			const { modules } = modulesOf(ctx, packagesDir);
 			const registry = ctx.get(UNITS_SERVICE);
 			const panelEntries = panelEntriesOf(panels, workspace);
@@ -6118,7 +5948,7 @@ function registerDiyTools(ctx, market, panels, debug) {
 		},
 		output: OUTPUT$2,
 		async execute(raw, exec) {
-			const { packagesDir, workspace } = workshopOf(ctx, exec);
+			const { packagesDir, workspace } = await workshopOf(ctx, exec);
 			const { installed, modules } = modulesOf(ctx, packagesDir);
 			const panelState = ctx.get(PANEL_STATE_SERVICE);
 			const registry = ctx.get(UNITS_SERVICE);
@@ -6186,7 +6016,7 @@ function registerDiyTools(ctx, market, panels, debug) {
 		},
 		output: OUTPUT$2,
 		async execute(raw, exec) {
-			const { packagesDir } = workshopOf(ctx, exec);
+			const { packagesDir } = await workshopOf(ctx, exec);
 			const args = asRecord$3(raw);
 			const keywords = keywordsOf(asText$1(args["keyword"]), asText$1(args["url"]));
 			if (keywords.length === 0) throw new Error("recon 要一个关键词（站点名 / 系统名 / 域名都行）：先拿它去 opencli 自带的那份目录里找有没有现成的能力，别一上来就自己写 adapter；用户不知道 opencli 是什么，这一步别问他。");
@@ -6199,96 +6029,6 @@ function registerDiyTools(ctx, market, panels, debug) {
 			});
 		}
 	};
-	const probeTool = {
-		name: DIY_PROBE_TOOL,
-		description: "用用户浏览器里现有的登录探一条读：script 读接口 / css 读 DOM。不在站点上会自己打开 url。",
-		parameters: {
-			type: "object",
-			properties: {
-				script: {
-					type: "string",
-					description: "与 css 二选一：页面里跑一段回 JSON 的脚本。不在站点回 { ok: false, code: \"not-on-site\" }，登录过期回 \"not-logged-in\"，成功回 { ok: true, ...数据 }。"
-				},
-				css: {
-					type: "string",
-					description: "与 script 二选一：给一个 CSS 选择器，宿主回匹配到的元素文本（每行单元格按换行拼在 text 里）。"
-				},
-				limit: {
-					type: "number",
-					description: "配 css 用：最多回几个元素（默认 50）。"
-				},
-				textMax: {
-					type: "number",
-					description: "配 css 用：每个元素文本最多留几个字（默认 200）。"
-				},
-				url: {
-					type: "string",
-					description: "那套系统的地址（不在站点上时自己打开它再读一遍）。"
-				},
-				loginUrl: {
-					type: "string",
-					description: "要登录时那颗\"去登录\"该去哪（默认用 url）。"
-				},
-				session: {
-					type: "string",
-					description: "会话名（默认读那条，一般不用填）。"
-				},
-				open: {
-					type: "boolean",
-					description: "不在站点上时要不要顺手打开（默认要）。"
-				}
-			},
-			additionalProperties: false
-		},
-		output: OUTPUT$2,
-		async execute(raw, exec) {
-			const { packagesDir } = workshopOf(ctx, exec);
-			const args = asRecord$3(raw);
-			const script = asText$1(args["script"]);
-			const css = asText$1(args["css"]);
-			if (script === "" && css === "") throw new Error("probe 要 script（页面脚本，回 JSON）或 css（读 DOM 那一行的选择器）之一。script 的约定：不在那个站点上就回 { ok: false, code: \"not-on-site\" }（我会自己把它打开再读一遍）；登录过期回 { ok: false, code: \"not-logged-in\" }；成功回 { ok: true, ...数据 }。页面里压根没有接口时给 css，别写 document.querySelectorAll（宿主产物不许出现 DOM 字样）。");
-			const shell = ctx.get("shell");
-			if (shell === void 0) throw new Error("这台机器上没有 shell 服务，probe 跑不了");
-			const url = asText$1(args["url"]);
-			const loginUrl = asText$1(args["loginUrl"]);
-			const session = asText$1(args["session"]);
-			if (session === "workbench") throw new Error(`"${BROWSER_SCREEN_SESSION}" 是用户那一屏那条会话 —— probe 只读自己的线（不填就落在读那条上，想给自己一条专线就传自己的 unit）。要看 / 动他那一屏走 workbench_diy_state / _find / _click 那一族，而且要先 workbench_diy_debug_start（会请他点头一次）。`);
-			const open = typeof args["open"] === "boolean" ? args["open"] : void 0;
-			if (css !== "") {
-				const limit = asNumber(args["limit"]);
-				const textMax = asNumber(args["textMax"]);
-				const found = await browserFind({
-					shell,
-					css,
-					command: opencliCommandOf(ctx).command,
-					...url === "" ? {} : { url },
-					...session === "" ? {} : { session },
-					...open === void 0 ? {} : { open },
-					...limit === void 0 ? {} : { limit },
-					...textMax === void 0 ? {} : { textMax }
-				});
-				return plainJson({
-					workshop: packagesDir,
-					...found,
-					text: renderFind(found)
-				});
-			}
-			const out = await browserRead({
-				shell,
-				script,
-				command: opencliCommandOf(ctx).command,
-				...url === "" ? {} : { url },
-				...loginUrl === "" ? {} : { loginUrl },
-				...session === "" ? {} : { session },
-				...open === void 0 ? {} : { open }
-			});
-			return plainJson({
-				workshop: packagesDir,
-				...out,
-				text: renderProbe(out)
-			});
-		}
-	};
 	function unitOf(packagesDir, raw, label) {
 		const { modules } = modulesOf(ctx, packagesDir);
 		const unit = asText$1(asRecord$3(raw)["unit"]);
@@ -6312,7 +6052,7 @@ function registerDiyTools(ctx, market, panels, debug) {
 		},
 		output: OUTPUT$2,
 		async execute(raw, exec) {
-			const { packagesDir, workspace } = workshopOf(ctx, exec);
+			const { packagesDir, workspace } = await workshopOf(ctx, exec);
 			const found = unitOf(packagesDir, raw, "workbench_diy_show");
 			if (!found.installed) throw new Error(`${found.unit} 还没装 —— 只上板的前提是它装过了。先用 workbench_diy_install（第一次）`);
 			const panel = showOrReason(panels, found.unit, workspace);
@@ -6340,7 +6080,7 @@ function registerDiyTools(ctx, market, panels, debug) {
 		},
 		output: OUTPUT$2,
 		async execute(raw, exec) {
-			const { packagesDir, workspace } = workshopOf(ctx, exec);
+			const { packagesDir, workspace } = await workshopOf(ctx, exec);
 			const found = unitOf(packagesDir, raw, "workbench_diy_install");
 			if (found.installed) {
 				const panel = showOrReason(panels, found.unit, workspace);
@@ -6385,7 +6125,6 @@ function registerDiyTools(ctx, market, panels, debug) {
 		...registerComponentsTool(ctx, tools),
 		tools.register(reconTool),
 		...registerSpecTool(ctx, tools),
-		tools.register(probeTool),
 		...registerLogTools(ctx, tools),
 		...registerBrowserTools(ctx, tools),
 		...registerDebugTools(ctx, tools, debug),
@@ -6395,14 +6134,13 @@ function registerDiyTools(ctx, market, panels, debug) {
 }
 //#endregion
 //#region src/modules/panels/model/diy-observers.ts
-async function stopObservers(ctx, session = BROWSER_SCREEN_SESSION) {
-	const packagesDir = workshopPackagesDir(ctx);
+async function stopObservers(ctx, workspace, session = BROWSER_SCREEN_SESSION) {
 	const shell = ctx.get("shell");
-	if (packagesDir === null || shell === void 0) return {
+	if (workspace === null || workspace === void 0 || workspace === "" || shell === void 0) return {
 		net: false,
 		logs: false
 	};
-	const file = join(dirname(packagesDir), "shots", `net-${session}.jsonl`);
+	const file = join(workspace, "shots", `net-${session}.jsonl`);
 	const command = opencliCommandOf(ctx).command;
 	const [net, step] = await Promise.all([stopNetworkExact(shell, file), actBrowser(shell, command, session, ["eval", LOGS_STOP_SCRIPT], SWEEP_TIMEOUT_MS)]);
 	return {
@@ -6413,13 +6151,13 @@ async function stopObservers(ctx, session = BROWSER_SCREEN_SESSION) {
 function withObserverCleanup(store, cleanup, logger) {
 	let pending = Promise.resolve();
 	let epoch = 0;
-	const sweep = async (at) => {
+	const sweep = async (at, workspace) => {
 		if (epoch !== at) {
 			logger?.warn?.("收工那一拍：已经有新的调试约定开始了 —— 跳过收观察（新那一场自己收）");
 			return;
 		}
 		try {
-			const out = await cleanup();
+			const out = await cleanup(workspace);
 			if (!out.net || !out.logs) logger?.warn?.(`收工那一拍没把观察收干净（网络 ${String(out.net)} / 日志 ${String(out.logs)}）—— 网络那条最多 15 分钟自己收工，日志钩子随页面刷新消失`);
 		} catch (error) {
 			logger?.warn?.(`收工那一拍收观察抛了：${error instanceof Error ? error.message : String(error)}`);
@@ -6437,7 +6175,8 @@ function withObserverCleanup(store, cleanup, logger) {
 			const move = store.stop(sessionId, now);
 			if (move.ok) {
 				const at = epoch;
-				pending = pending.then(() => sweep(at));
+				const workspace = move.state.workspacePath;
+				pending = pending.then(() => sweep(at, workspace));
 			}
 			return move;
 		},
@@ -6494,13 +6233,13 @@ var INTENT_WORD$1 = {
 	stop: "结束"
 };
 function debugNoticeText(intent, state) {
-	const head = `［工作台 DIY］用户按了「${INTENT_WORD$1[intent]}」：`;
+	const head = `［调试 · ${state.title === "" ? "工作区" : state.title}］用户按了「${INTENT_WORD$1[intent]}」：`;
 	if (intent === "pause") return `${head}${state.unit} 这场调试暂停了 —— 现在别再把那一屏当目标（看 / 动 / 网络那一族发不出去）。要接着看屏就等用户按「继续」；在那之前照常改源码 / build / 跑门禁。`;
 	if (intent === "resume") return `${head}${state.unit} 这场调试重新开始了 —— 那一屏又归你看。屏 / 板不对的话照旧会被拒，拒了就照实说清是哪种不对。`;
 	return `${head}${state.unit} 这场调试收工了（占用解除）。要再调试就重新 start 一场。`;
 }
 function debugNoticeSummary(intent, state) {
-	return `工作台 DIY：用户按了${INTENT_WORD$1[intent]}（${state.unit}）`;
+	return `调试：用户按了${INTENT_WORD$1[intent]}（${state.unit}）`;
 }
 function debugNotice(intent, state) {
 	const summary = debugNoticeSummary(intent, state);
@@ -7702,7 +7441,7 @@ function registerRecordTools(ctx, store) {
 		},
 		output: OUTPUT$2,
 		async execute(raw, exec) {
-			const { packagesDir, workspace } = workshopOf(ctx, exec);
+			const { packagesDir, workspace } = await workshopOf(ctx, exec);
 			const args = asRecord$3(raw);
 			const unit = asText$1(args["unit"]);
 			const modules = modulesOf(ctx, packagesDir).modules;
@@ -7811,7 +7550,7 @@ function registerRecordTools(ctx, store) {
 		},
 		output: OUTPUT$2,
 		async execute(raw, exec) {
-			const { packagesDir } = workshopOf(ctx, exec);
+			const { packagesDir } = await workshopOf(ctx, exec);
 			const shell = ctx.get("shell");
 			if (shell === void 0) throw new Error("这台机器上没有 shell 服务，读不了录制");
 			const sessionId = sessionIdOf(exec) ?? "";
@@ -7927,7 +7666,7 @@ function registerRecordTools(ctx, store) {
 		},
 		output: OUTPUT$2,
 		async execute(raw, exec) {
-			const { packagesDir } = workshopOf(ctx, exec);
+			const { packagesDir } = await workshopOf(ctx, exec);
 			const shell = ctx.get("shell");
 			if (shell === void 0) throw new Error("这台机器上没有 shell 服务，取不了详情");
 			const args = asRecord$3(raw);
@@ -8007,7 +7746,7 @@ function registerRecordTools(ctx, store) {
 		},
 		output: OUTPUT$2,
 		async execute(_raw, exec) {
-			const { packagesDir } = workshopOf(ctx, exec);
+			const { packagesDir } = await workshopOf(ctx, exec);
 			const shell = ctx.get("shell");
 			if (shell === void 0) throw new Error("这台机器上没有 shell 服务，收不了工");
 			const sessionId = sessionIdOf(exec) ?? "";
@@ -10457,7 +10196,7 @@ var OWNED = [{
 			logger
 		});
 		ctx.provide(PANELS_SERVICE, panels);
-		const debug = withObserverCleanup(createDebugStore(), () => stopObservers(ctx), logger);
+		const debug = withObserverCleanup(createDebugStore(), (workspace) => stopObservers(ctx, workspace), logger);
 		ctx.provide(DIY_DEBUG_SERVICE, debug);
 		const record = {
 			...createRecordStore(),
@@ -10537,13 +10276,13 @@ var OWNED = [{
 			factsOf: (call) => panelsFactsOf(call, manifests()),
 			needsApproval: panelsApproval,
 			gate: {
-				deniedTools: (workspace) => {
-					const boards = panels.boards(workspace);
+				deniedTools: (context) => {
+					const boards = panels.boards(context.workspace);
 					const owned = new Set(ownedUnits());
 					return [...manifests().flatMap((manifest) => owned.has(manifest.id) || resolveScope({
 						id: manifest.id,
 						boards
-					}) ? [] : manifest.tools.map((tool) => tool.name)), ...inWorkshopSession(ctx, workspace) ? [] : [
+					}) ? [] : manifest.tools.map((tool) => tool.name)), ...context.preset === "workbench-diy" ? [] : [
 						...DIY_TOOLS,
 						...DIY_DEBUG_TOOLS,
 						...DIY_RECORD_TOOLS
@@ -13038,9 +12777,15 @@ function configSyncAction(deps) {
 function agentOf(value) {
 	return typeof value === "object" && value !== null ? value : void 0;
 }
-function workspaceOf(handle) {
-	const cwd = handle.session?.header?.cwd;
-	return typeof cwd === "string" && cwd !== "" ? cwd : null;
+function contextOf(handle, options) {
+	const header = handle.session?.header;
+	const cwd = header?.cwd;
+	const declared = header?.agentPreset;
+	const read = options.presetOf?.(handle);
+	return {
+		workspace: typeof cwd === "string" && cwd !== "" ? cwd : null,
+		preset: read ?? (typeof declared === "string" && declared !== "" ? declared : null)
+	};
 }
 function createToolScope(options) {
 	const applied = /* @__PURE__ */ new WeakMap();
@@ -13057,9 +12802,9 @@ function createToolScope(options) {
 			options.logger?.warn?.("[dsh-workbench] 拿不到 agent 作用域的工具面：这次不收窄（下次再试）");
 			return;
 		}
-		const workspace = workspaceOf(handle);
-		const deny = [...options.deniedTools(workspace)];
-		const signature = `${workspace ?? ""}\u0000${deny.join(",")}`;
+		const context = contextOf(handle, options);
+		const deny = [...options.deniedTools(context)];
+		const signature = `${context.workspace ?? ""}\u0000${context.preset ?? ""}\u0000${deny.join(",")}`;
 		const previous = applied.get(handle);
 		if (previous !== void 0 && previous.signature === signature) return;
 		if (previous === void 0) seen.add(new WeakRef(handle));
@@ -13069,12 +12814,13 @@ function createToolScope(options) {
 			applied.delete(handle);
 			return;
 		}
+		const where = context.preset === null ? context.workspace : `${context.workspace ?? "(未知工作区)"} · ${context.preset}`;
 		try {
 			applied.set(handle, {
 				signature,
 				dispose: tools.restrict({ deny })
 			});
-			options.logger?.info?.(`[dsh-workbench] 按工作区收窄工具面：${workspace ?? "(未知工作区)"} 里收起 ${deny.length} 个工具（${deny.join(", ")}）`);
+			options.logger?.info?.(`[dsh-workbench] 按会话收窄工具面：${where ?? "(未知工作区)"} 里收起 ${deny.length} 个工具（${deny.join(", ")}）`);
 		} catch (error) {
 			options.logger?.warn?.(`[dsh-workbench] 收窄工具面失败：${String(error)}`);
 		}
@@ -13089,7 +12835,7 @@ function createToolScope(options) {
 			const handle = agentOf(agent);
 			const tools = assembly?.tools;
 			if (handle === void 0 || tools === void 0) return assembly;
-			const deny = new Set(options.deniedTools(workspaceOf(handle)));
+			const deny = new Set(options.deniedTools(contextOf(handle, options)));
 			if (deny.size === 0) return assembly;
 			const kept = tools.filter((tool) => !deny.has(tool.name));
 			return kept.length === tools.length ? assembly : {
@@ -13116,6 +12862,41 @@ function createToolScope(options) {
 	};
 }
 //#endregion
+//#region src/shared/api/host/preset-scope.ts
+var PRESET_KEY = "agentPreset";
+function presetOf(ctx, handle) {
+	const projections = ctx.get(SESSION_PROJECTIONS_SERVICE);
+	if (projections === void 0 || handle.session === void 0) return null;
+	try {
+		const preset = projections.stateOf(handle.session, PRESET_KEY);
+		return typeof preset === "string" && preset !== "" ? preset : null;
+	} catch (error) {
+		ctx.logger?.warn?.(`[dsh-workbench] 读 preset 投影失败，退回会话创建事实：${String(error)}`);
+		return null;
+	}
+}
+function watchPreset(ctx, listener) {
+	ctx.inject([SESSION_PROJECTIONS_SERVICE], (scoped) => {
+		const projections = scoped.get(SESSION_PROJECTIONS_SERVICE);
+		if (projections === void 0) return;
+		scoped.effect(() => {
+			const off = projections.onChanged((_session, key) => {
+				if (key === PRESET_KEY) listener();
+			});
+			return () => off?.();
+		}, "dsh-workbench: preset 选中就重算工具面（新会话屏是先建会话、再把选择 select 上去）");
+	});
+}
+function createPresetScope(options) {
+	const scope = createToolScope({
+		deniedTools: options.deniedTools,
+		presetOf: (handle) => presetOf(options.ctx, handle),
+		logger: options.logger
+	});
+	watchPreset(options.ctx, () => scope.reapply());
+	return scope;
+}
+//#endregion
 //#region src/shared/api/host/host-args.ts
 function asArgs(value) {
 	return typeof value === "object" && value !== null ? value : {};
@@ -13219,8 +13000,9 @@ function apply(ctx) {
 	};
 	const store = createWorkspaceStore({ logger: ctx.logger });
 	const unitsOfTool = () => toolUnits(liveManifests());
-	const toolScope = createToolScope({
-		deniedTools: (workspace) => deniedNow(workspace),
+	const toolScope = createPresetScope({
+		ctx,
+		deniedTools: (context) => deniedNow(context),
 		logger: ctx.logger
 	});
 	const pluginTools = shell === void 0 ? void 0 : createPluginUnits({
@@ -13247,7 +13029,7 @@ function apply(ctx) {
 	const ownersMap = /* @__PURE__ */ new Map();
 	const factsOfUnit = (unit) => [...routesOfUnitMap.get(unit) ?? [], "capability"];
 	const callFacts = (unit, call) => factsOfMap.get(unit)?.(call) ?? factsOfUnit(unit);
-	const deniedNow = (workspace) => [...new Set([...mounted.values()].flatMap((item) => item.plan.gate?.deniedTools(workspace) ?? []))];
+	const deniedNow = (context) => [...new Set([...mounted.values()].flatMap((item) => item.plan.gate?.deniedTools(context) ?? []))];
 	const declaredNoteTools = () => declaredNotesOf([...mounted.values()].map((item) => item.plan));
 	const wrote = (resource, write) => {
 		const unit = ownersMap.get(resource);