@dsh-workbench/core 0.3.0 → 0.3.1

package/dist/host/index.js

@@ -1,10 +1,10 @@
 import { createHash, randomUUID } from "node:crypto";
-import fs, { chmodSync, closeSync, existsSync, mkdirSync, openSync, readFileSync, readdirSync, readlinkSync, realpathSync, renameSync, rmSync, statSync, symlinkSync, unlinkSync, writeFileSync } from "node:fs";
+import fs, { chmodSync, closeSync, existsSync, mkdirSync, openSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, statSync, unlinkSync, writeFileSync } from "node:fs";
 import path, { basename, delimiter, dirname, join, resolve, sep } from "node:path";
 import { deflateSync, inflateSync } from "node:zlib";
-import os from "node:os";
 import { spawn } from "node:child_process";
 import { fileURLToPath } from "node:url";
+import os from "node:os";
 //#region ../shared/dist/config/constants.js
 var PLUGIN_ID = "@dsh-workbench/core";
 var RELEASE_SIBLINGS = ["@dsh-workbench/shared", "@dsh-workbench/module-tools"];
@@ -2965,6 +2965,43 @@ 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$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/modules/panels/unit.ts
 var PANELS_LIST_TOOL = "workbench_panels_list";
@@ -5761,134 +5798,425 @@ function moduleBuildFacts(dir) {
 	};
 }
 //#endregion
-//#region src/modules/panels/model/diy-report.ts
-function healthOf(options) {
-	const { registry, unit, installed } = options;
-	const refused = registry?.refusals().find((one) => one.unit === unit);
-	if (refused !== void 0) return {
-		state: "failed",
-		reason: refused.reasons.join("；")
+//#region src/shared/api/host/runtime-seed.ts
+function runtimeSeedPaths(root) {
+	const opencliRoot = join(root, "opencli");
+	const opencliBinDir = join(opencliRoot, "bin");
+	const workshop = join(root, "diy");
+	return {
+		root,
+		entryDir: join(root, "bin"),
+		opencliRoot,
+		opencliBinDir,
+		opencliBin: join(opencliBinDir, "opencli"),
+		opencliHome: join(opencliRoot, "home"),
+		workshop,
+		workshopPackages: join(workshop, "packages"),
+		workshopManifest: join(workshop, "package.json")
 	};
-	const failed = registry?.failureOf(unit);
-	if (failed !== void 0) return {
-		state: "failed",
-		reason: failed
+}
+function runtimeSeedRootOf(ctx) {
+	const homePath = ctx.get("dshHomePath");
+	if (typeof homePath !== "function") return null;
+	try {
+		return homePath("workbench");
+	} catch {
+		return null;
+	}
+}
+function packageRootOf(moduleUrl) {
+	return dirname(dirname(dirname(fileURLToPath(moduleUrl))));
+}
+function isInstalledCopy(packageRoot) {
+	return packageRoot.split(sep).includes("node_modules");
+}
+function opencliWrapperScript(packageRoot, home) {
+	const script = join(packageRoot, "bin", "opencli-isolated");
+	return `#!/bin/sh\nexec env DSH_HOME=${quoteShellArg(home)} bash ${quoteShellArg(script)} "$@"\n`;
+}
+function workshopSeedPlan(packageRoot, home, root) {
+	const script = join(packageRoot, "scripts", "seed-workshop.sh");
+	const env = {
+		DSH_HOME: home,
+		DSH_WB_SHELL_ROOT: packageRoot
 	};
-	if (registry?.all().some((one) => one.unit === unit) === true) return { state: "ok" };
+	const log = join(root, "seed.log");
 	return {
-		state: "absent",
-		reason: installed ? "工作台还没读到它的声明 —— 新装的模块要重启一次工作台" : "还没装"
+		entry: {
+			file: "bash",
+			args: [script, "entry"],
+			env,
+			log
+		},
+		full: {
+			file: "bash",
+			args: [script],
+			env,
+			log
+		}
 	};
 }
-function healthText(health) {
-	if (health.state === "ok") return "是";
-	if (health.state === "failed") return `不是 —— ${health.reason ?? "(没给原因)"}`;
-	return `还没有（${health.reason ?? "还不知道"}）`;
+function runDetached(command, onError, spawnImpl = spawn) {
+	let fd = null;
+	try {
+		fd = openSync(command.log, "a");
+		const child = spawnImpl(command.file, [...command.args], {
+			env: {
+				...process.env,
+				...command.env
+			},
+			detached: true,
+			stdio: [
+				"ignore",
+				fd,
+				fd
+			]
+		});
+		child.on("error", (error) => onError(`自举脚本没跑起来（${command.file}）：${String(error)}`));
+		child.unref();
+	} catch (error) {
+		onError(`自举脚本没跑起来（${command.file}）：${String(error)}`);
+	} finally {
+		if (fd !== null) closeQuietly(fd);
+	}
 }
-function ageText(at, now) {
-	const seconds = Math.max(0, Math.round((now - at) / 1e3));
-	if (seconds < 10) return "刚刚";
-	if (seconds < 60) return `${String(seconds)} 秒前`;
-	const minutes = Math.round(seconds / 60);
-	if (minutes < 60) return `${String(minutes)} 分钟前`;
-	return `${String(Math.round(minutes / 60))} 小时前`;
+function closeQuietly(fd) {
+	try {
+		closeSync(fd);
+	} catch {
+		return;
+	}
 }
-function stampOf(at) {
-	return `${new Date(at).toISOString().slice(11, 19)}Z`;
+function prependPath(entryDir, env = process.env) {
+	const parts = (env.PATH ?? "").split(delimiter).filter((part) => part !== "");
+	if (parts.includes(entryDir)) return false;
+	env.PATH = [entryDir, ...parts].join(delimiter);
+	return true;
 }
-function readText$1(read, now) {
-	const when = `${stampOf(read.at)} · ${ageText(read.at, now)}`;
-	if (read.phase === "ready") return `${read.route} 读到了（${when}）`;
-	if (read.phase === "loading") return `${read.route} 正在读（${when}）`;
-	if (read.phase === "idle") return `${read.route} 没在取数（${when}）`;
-	const code = read.error?.code ?? "unknown";
-	const message = read.error?.message ?? "";
-	return `${read.route} 读不到（${code}）${message === "" ? "" : `：${message}`}（${when}）`;
+function seedRuntimeFiles(options) {
+	const paths = runtimeSeedPaths(options.root);
+	const done = [];
+	try {
+		for (const dir of [
+			paths.entryDir,
+			paths.opencliBinDir,
+			paths.opencliHome,
+			paths.workshopPackages
+		]) mkdirSync(dir, { recursive: true });
+		const wanted = opencliWrapperScript(options.packageRoot, options.home);
+		if (readText$1(paths.opencliBin) !== wanted) {
+			rmSync(paths.opencliBin, { force: true });
+			writeFileSync(paths.opencliBin, wanted, "utf8");
+			chmodSync(paths.opencliBin, 493);
+			done.push(paths.opencliBin);
+		}
+	} catch (error) {
+		options.log?.(`自举没做完：${String(error)}`);
+	}
+	return done;
 }
-function renderPanel(options) {
-	const { packagesDir, workspace, rows, board, at, now } = options;
-	const head = `工坊：${packagesDir}\n这个工作区：${workspace ?? "(会话不在任何工作区上)"}`;
-	const note = at === 0 ? "\n还没有一条面板运行态上报 —— 面板上一个取数 / 渲染都没发生过：要么这个工作区的面板上没开卡片，要么用户那一页还是刷新前的旧版本（上报要页面刷一次才带上）。" : `\n面板上有 ${String(board.length)} 张卡｜运行态来自用户那一页（最后一次上报 ${stampOf(at)} · ${ageText(at, now)}）`;
-	const body = rows.map((row) => {
-		const title = `—— ${row.unit}${row.name === "" ? "" : `（${row.name}）`} · ${healthText(row.health)}`;
-		const report = row.report;
-		if (report === void 0) return [title, `   没上报：卡片没渲染出来，或者用户那一页还没刷新到带这份补丁的版本`].join("\n");
-		const reads = report.cards.slice(0, 6).map((one) => `   数据 · ${readText$1(one, now)}`);
-		const more = report.cards.length > 6 ? [`   数据 · …还有 ${String(report.cards.length - 6)} 条`] : [];
-		const crash = report.crash === void 0 ? "   崩过：没有" : `   崩过：是 —— ${report.crash.reason}（${stampOf(report.crash.at)} · 共 ${String(report.crash.count)} 次）`;
-		return [
-			title,
-			...reads,
-			...more,
-			crash
-		].join("\n");
-	});
-	return body.length === 0 ? `${head}${note}` : `${head}${note}\n${body.join("\n")}`;
+function readText$1(file) {
+	try {
+		return readFileSync(file, "utf8");
+	} catch {
+		return null;
+	}
 }
-function statusOf(options) {
-	const { dir, unit, name, installed, known, open, health } = options;
-	const facts = moduleBuildFacts(dir);
-	const next = health.state === "failed" ? `它起不来：${health.reason ?? "(没给原因)"} —— 先把这一条修掉（改模块源码 → build；改了 package.json / cordis.patch.yml 要重启工作台），别去重装` : !installed ? "装：workbench_diy_install（第一次，会让用户点头一次）" : !known ? "面板还不认得这个单元 —— 重启一次工作台（新装的模块要重启才注册进面板），重启后再 workbench_diy_show" : !open ? "上板：workbench_diy_show（只上板，不重装）" : !facts.builtAll ? "还没构建：pnpm exec dsh-wb-module build" : facts.stale ? "源码比产物新：pnpm exec dsh-wb-module build（宿主侧秒级热换；改了 client.js 刷新页面）" : "都在生效：改源码 → build（宿主侧秒级热换；改了 client.js 刷新页面），不要再装一遍";
+//#endregion
+//#region src/shared/api/host/self-update.ts
+function runningVersionOf(moduleUrl) {
+	try {
+		const read = JSON.parse(readFileSync(new URL("../../package.json", moduleUrl), "utf8"));
+		return typeof read.version === "string" && read.version !== "" ? read.version : void 0;
+	} catch {
+		return;
+	}
+}
+function selfUpdatePaths(dshHome) {
+	const dir = join(dshHome, "workbench");
 	return {
-		unit,
-		name,
 		dir,
-		installed,
-		known,
-		open,
-		artifacts: facts.artifacts,
-		stale: facts.stale,
-		health,
-		next
+		script: join(dir, "self-update.sh"),
+		marker: join(dir, "self-update.json"),
+		log: join(dir, "self-update.log")
 	};
 }
-function renderStatus(packagesDir, lines) {
-	if (lines.length === 0) return renderList(packagesDir, []);
-	return `工坊：${packagesDir}\n${lines.map((one) => {
-		const head = `—— ${one.unit}（${one.name}）`;
-		const facts = `   装：${one.installed ? "是" : "没有"} · 面板认得：${one.known ? "是" : "不是"} · 这个项目上开着：${one.open ? "是" : "没有"}`;
-		const artifacts = one.artifacts.length === 0 ? "   产物：没有" : `   产物：${one.artifacts.map((item) => `${item.path}${item.at === null ? "（缺）" : ` ${item.at.slice(11, 19)}Z`}`).join(" · ")} · 源码比产物新：${one.stale ? "是" : "没有"}`;
-		return [
-			head,
-			facts,
-			`   起得来：${healthText(one.health)}`,
-			artifacts,
-			`   下一步：${one.next}`
-		].join("\n");
-	}).join("\n")}`;
-}
-function renderList(packagesDir, modules) {
-	if (modules.length === 0) return `工坊里还没有模块（${packagesDir}）—— 在里面造一个：pnpm exec dsh-wb-module init <名字> --dir <工坊>/packages/module-<名字> --template diy`;
-	const lines = modules.map((one) => `${one.unit} · ${one.installed ? "已装" : "没装"} · ${one.name}` + (one.description === "" ? "" : `\n${" ".repeat(one.unit.length)}      ${one.description}`));
-	const footer = modules.filter((one) => !one.installed).length === 0 ? "都已装过 —— **不要再装**：改源码 + dsh-wb-module build（宿主侧秒级热换；改了 client.js 刷新一下页面）。" : "装：workbench_diy_install（unit=<上面那个 unit>）";
-	return `工坊：${packagesDir}\n${lines.join("\n")}\n\n${footer}`;
+function recoveryCommand(input) {
+	return `dsh plugin --profile ${input.profile} add ${input.pkg}@${input.version}`;
 }
-//#endregion
-//#region src/modules/panels/model/diy-tools.ts
-function registerDiyTools(ctx, market, panels, debug) {
-	const tools = ctx.get("tools");
-	if (tools === void 0) {
-		ctx.logger?.info?.("[dsh-workbench] 没有 tools 服务，跳过 DIY 工坊工具注册");
-		return [];
-	}
-	const listTool = {
-		name: DIY_LIST_TOOL,
-		description: "DIY 工坊里有哪些模块、装没装 —— 先跑它拿到 unit。普通项目里装模块用 workbench_modules_install。",
-		parameters: {
-			type: "object",
-			properties: {},
-			additionalProperties: false
-		},
-		output: OUTPUT$2,
-		async execute(_raw, exec) {
-			const { packagesDir } = workshopOf(ctx, exec);
-			const { modules } = modulesOf(ctx, packagesDir);
-			return plainJson({
-				workshop: packagesDir,
-				modules,
-				text: renderList(packagesDir, modules)
-			});
-		}
+function selfUpdateMarker(request, state, version, at) {
+	return {
+		...request,
+		state,
+		version,
+		at
+	};
+}
+function quoted(value) {
+	return `'${value.replaceAll("'", "'\\''")}'`;
+}
+function selfUpdateScript(request, paths) {
+	const rescue = recoveryCommand({
+		profile: request.profile,
+		pkg: request.pkg,
+		version: request.from
+	});
+	const lastsOne = recoveryCommand({
+		profile: request.profile,
+		pkg: request.pkg,
+		version: request.to === "" ? "latest" : request.to
+	});
+	const target = request.to === "" ? "latest" : request.to;
+	const landed = request.to === "" ? "is_other" : "is_to";
+	return `#!/usr/bin/env bash
+set -uo pipefail
+DSH_HOME=${quoted(request.dshHome)}
+PKG=${quoted(request.pkg)}
+PROFILE=${quoted(request.profile)}
+FROM=${quoted(request.from)}
+TO=${quoted(target)}
+MARKER=${quoted(paths.marker)}
+LOG=${quoted(paths.log)}
+PROFILE_DIR="$DSH_HOME/profiles/$PROFILE"
+say() { printf '%s %s\\n' "$(date '+%F %T')" "$*" >>"$LOG"; }
+on_disk() {
+  node -e 'const p=process.argv[1];try{process.stdout.write(require(p).version)}catch(e){}' \\
+    "$PROFILE_DIR/node_modules/$PKG/package.json" 2>/dev/null
+}
+write_marker() {
+  printf '{"pkg":"%s","profile":"%s","from":"%s","to":"%s","state":"%s","version":"%s","at":"%s"}\\n' \\
+    "$PKG" "$PROFILE" "$FROM" "$TO" "$1" "$2" "$(date -u '+%FT%TZ')" >"$MARKER"
+}
+install() { dsh plugin --profile "$PROFILE" add "$PKG@$1" >>"$LOG" 2>&1; }
+is_to() { [ "$(on_disk)" = "$TO" ]; }
+is_other() { [ -n "$(on_disk)" ] && [ "$(on_disk)" != "$FROM" ]; }
+if ! command -v dsh >/dev/null 2>&1; then
+  say "PATH 上没有 dsh —— 这一跳没跑。救法：${rescue}"
+  write_marker failed "$FROM"
+  exit 1
+fi
+say "开始 \${FROM} -> \${TO}（不卸任何一行）"
+write_marker running "$FROM"
+if install "$TO" && ${landed}; then
+  say "换好了：$(on_disk) 在盘上（目标 \${TO}），重启一次 dsh 才用得上"
+  write_marker ok "$(on_disk)"
+  exit 0
+fi
+say "换版没成（盘上 $(on_disk)）—— 把 \${FROM} 装回去"
+if install "$FROM" && [ "$(on_disk)" = "$FROM" ]; then
+  say "已回滚：\${FROM} 还在盘上，工作台这一行没被动过"
+  write_marker rolled-back "$FROM"
+  exit 0
+fi
+say "回滚也没成。救法：${rescue}（或 ${lastsOne}）"
+write_marker failed "$(on_disk)"
+exit 1
+`;
+}
+function planSelfUpdate(request, now = /* @__PURE__ */ new Date()) {
+	const paths = selfUpdatePaths(request.dshHome);
+	return {
+		paths,
+		script: selfUpdateScript(request, paths),
+		marker: selfUpdateMarker(request, "running", request.from, now.toISOString()),
+		command: {
+			file: "bash",
+			args: [paths.script],
+			env: {},
+			log: paths.log
+		}
+	};
+}
+function startSelfUpdate(request, onError, spawnImpl = spawn) {
+	const plan = planSelfUpdate(request);
+	mkdirSync(plan.paths.dir, { recursive: true });
+	writeFileSync(plan.paths.script, plan.script, { mode: 493 });
+	chmodSync(plan.paths.script, 493);
+	writeFileSync(plan.paths.marker, `${JSON.stringify(plan.marker)}\n`);
+	runDetached(plan.command, onError, spawnImpl);
+	const forward = recoveryCommand({
+		profile: request.profile,
+		pkg: request.pkg,
+		version: request.to === "" ? "latest" : request.to
+	});
+	return {
+		started: true,
+		paths: plan.paths,
+		forward
+	};
+}
+function fixText() {
+	return "   修法：cd \"$DSH_HOME/workbench/diy\" && pnpm install；还不行就把这个工坊目录删掉再重启一次工作台（骨架会自己重建；`packages/` 下你造的模块先留着或另存）。";
+}
+function syncingStillRunning(at, now, windowMs) {
+	const started = Date.parse(at);
+	if (!Number.isFinite(started)) return true;
+	return now - started <= windowMs;
+}
+function toolchainGap(toolchain, shellVersion) {
+	if (toolchain === void 0) return void 0;
+	const gaps = [
+		["core", toolchain.core],
+		["module-tools", toolchain.moduleTools],
+		["shared", toolchain.shared]
+	].filter((one) => one[1] !== shellVersion);
+	return gaps.length === 0 ? void 0 : gaps.map((one) => `${one[0]} ${one[1]}`).join(" / ");
+}
+function syncNotice(input) {
+	const { sync, shellVersion, toolchain } = input;
+	const now = input.now ?? Date.now();
+	const windowMs = input.windowMs ?? 9e5;
+	if (shellVersion === void 0) return void 0;
+	const gap = toolchainGap(toolchain, shellVersion);
+	if (toolchain !== void 0 && gap === void 0) return void 0;
+	const about = sync !== void 0 && sync.version === shellVersion ? sync : void 0;
+	if (about === void 0 && gap === void 0) return void 0;
+	const where = gap === void 0 ? "工坊里读不到那三个包的版本" : `工坊里 ${gap}`;
+	if (about !== void 0 && about.state === "failed") return [`⚠️ 工坊工具链还是上一代（${where}；外壳已经是 ${shellVersion}）：${about.reason ?? "(没给原因)"}`, fixText()].join("\n");
+	if (about !== void 0 && about.state === "syncing") {
+		if (syncingStillRunning(about.at, now, windowMs)) return `⏳ 工坊工具链正在后台同步到 ${shellVersion} —— 这段期间按上一代在跑，不用等它。`;
+		return [`⚠️ 工坊工具链上一次同步没走完（这条停在 ${about.at}，超过 ${String(Math.round(windowMs / 6e4))} 分钟了）：${where}，外壳已经是 ${shellVersion}。`, fixText()].join("\n");
+	}
+	if (gap === void 0) return void 0;
+	return `⏳ 工坊工具链还是上一代（工坊里 ${gap}，外壳 ${shellVersion}）—— 下一轮工作台启动时会对齐到 ${shellVersion}；一直这样就看 $DSH_HOME/workbench/seed.log。`;
+}
+function healthOf(options) {
+	const { registry, unit, installed } = options;
+	const refused = registry?.refusals().find((one) => one.unit === unit);
+	if (refused !== void 0) return {
+		state: "failed",
+		reason: refused.reasons.join("；")
+	};
+	const failed = registry?.failureOf(unit);
+	if (failed !== void 0) return {
+		state: "failed",
+		reason: failed
+	};
+	if (registry?.all().some((one) => one.unit === unit) === true) return { state: "ok" };
+	return {
+		state: "absent",
+		reason: installed ? "工作台还没读到它的声明 —— 新装的模块要重启一次工作台" : "还没装"
+	};
+}
+function healthText(health) {
+	if (health.state === "ok") return "是";
+	if (health.state === "failed") return `不是 —— ${health.reason ?? "(没给原因)"}`;
+	return `还没有（${health.reason ?? "还不知道"}）`;
+}
+function ageText(at, now) {
+	const seconds = Math.max(0, Math.round((now - at) / 1e3));
+	if (seconds < 10) return "刚刚";
+	if (seconds < 60) return `${String(seconds)} 秒前`;
+	const minutes = Math.round(seconds / 60);
+	if (minutes < 60) return `${String(minutes)} 分钟前`;
+	return `${String(Math.round(minutes / 60))} 小时前`;
+}
+function stampOf(at) {
+	return `${new Date(at).toISOString().slice(11, 19)}Z`;
+}
+function readText(read, now) {
+	const when = `${stampOf(read.at)} · ${ageText(read.at, now)}`;
+	if (read.phase === "ready") return `${read.route} 读到了（${when}）`;
+	if (read.phase === "loading") return `${read.route} 正在读（${when}）`;
+	if (read.phase === "idle") return `${read.route} 没在取数（${when}）`;
+	const code = read.error?.code ?? "unknown";
+	const message = read.error?.message ?? "";
+	return `${read.route} 读不到（${code}）${message === "" ? "" : `：${message}`}（${when}）`;
+}
+function renderPanel(options) {
+	const { packagesDir, workspace, rows, board, at, now } = options;
+	const head = `工坊：${packagesDir}\n这个工作区：${workspace ?? "(会话不在任何工作区上)"}`;
+	const note = at === 0 ? "\n还没有一条面板运行态上报 —— 面板上一个取数 / 渲染都没发生过：要么这个工作区的面板上没开卡片，要么用户那一页还是刷新前的旧版本（上报要页面刷一次才带上）。" : `\n面板上有 ${String(board.length)} 张卡｜运行态来自用户那一页（最后一次上报 ${stampOf(at)} · ${ageText(at, now)}）`;
+	const body = rows.map((row) => {
+		const title = `—— ${row.unit}${row.name === "" ? "" : `（${row.name}）`} · ${healthText(row.health)}`;
+		const report = row.report;
+		if (report === void 0) return [title, `   没上报：卡片没渲染出来，或者用户那一页还没刷新到带这份补丁的版本`].join("\n");
+		const reads = report.cards.slice(0, 6).map((one) => `   数据 · ${readText(one, now)}`);
+		const more = report.cards.length > 6 ? [`   数据 · …还有 ${String(report.cards.length - 6)} 条`] : [];
+		const crash = report.crash === void 0 ? "   崩过：没有" : `   崩过：是 —— ${report.crash.reason}（${stampOf(report.crash.at)} · 共 ${String(report.crash.count)} 次）`;
+		return [
+			title,
+			...reads,
+			...more,
+			crash
+		].join("\n");
+	});
+	return body.length === 0 ? `${head}${note}` : `${head}${note}\n${body.join("\n")}`;
+}
+function statusOf(options) {
+	const { dir, unit, name, installed, known, open, health } = options;
+	const facts = moduleBuildFacts(dir);
+	const next = health.state === "failed" ? `它起不来：${health.reason ?? "(没给原因)"} —— 先把这一条修掉（改模块源码 → build；改了 package.json / cordis.patch.yml 要重启工作台），别去重装` : !installed ? "装：workbench_diy_install（第一次，会让用户点头一次）" : !known ? "面板还不认得这个单元 —— 重启一次工作台（新装的模块要重启才注册进面板），重启后再 workbench_diy_show" : !open ? "上板：workbench_diy_show（只上板，不重装）" : !facts.builtAll ? "还没构建：pnpm exec dsh-wb-module build" : facts.stale ? "源码比产物新：pnpm exec dsh-wb-module build（宿主侧秒级热换；改了 client.js 刷新页面）" : "都在生效：改源码 → build（宿主侧秒级热换；改了 client.js 刷新页面），不要再装一遍";
+	return {
+		unit,
+		name,
+		dir,
+		installed,
+		known,
+		open,
+		artifacts: facts.artifacts,
+		stale: facts.stale,
+		health,
+		next
+	};
+}
+function renderStatus(packagesDir, lines, options = {}) {
+	const root = dirname(packagesDir);
+	const notice = syncNotice({
+		sync: workshopSyncOf(root),
+		shellVersion: options.shellVersion ?? runningVersionOf(import.meta.url),
+		toolchain: workshopToolchainOf(root)
+	});
+	if (lines.length === 0) {
+		const list = renderList(packagesDir, []);
+		return notice === void 0 ? list : `${notice}\n${list}`;
+	}
+	const block = lines.map((one) => {
+		const head = `—— ${one.unit}（${one.name}）`;
+		const facts = `   装：${one.installed ? "是" : "没有"} · 面板认得：${one.known ? "是" : "不是"} · 这个项目上开着：${one.open ? "是" : "没有"}`;
+		const artifacts = one.artifacts.length === 0 ? "   产物：没有" : `   产物：${one.artifacts.map((item) => `${item.path}${item.at === null ? "（缺）" : ` ${item.at.slice(11, 19)}Z`}`).join(" · ")} · 源码比产物新：${one.stale ? "是" : "没有"}`;
+		return [
+			head,
+			facts,
+			`   起得来：${healthText(one.health)}`,
+			artifacts,
+			`   下一步：${one.next}`
+		].join("\n");
+	});
+	return `${notice === void 0 ? `工坊：${packagesDir}` : `工坊：${packagesDir}\n${notice}`}\n${block.join("\n")}`;
+}
+function renderList(packagesDir, modules) {
+	if (modules.length === 0) return `工坊里还没有模块（${packagesDir}）—— 在里面造一个：pnpm exec dsh-wb-module init <名字> --dir <工坊>/packages/module-<名字> --template diy`;
+	const lines = modules.map((one) => `${one.unit} · ${one.installed ? "已装" : "没装"} · ${one.name}` + (one.description === "" ? "" : `\n${" ".repeat(one.unit.length)}      ${one.description}`));
+	const footer = modules.filter((one) => !one.installed).length === 0 ? "都已装过 —— **不要再装**：改源码 + dsh-wb-module build（宿主侧秒级热换；改了 client.js 刷新一下页面）。" : "装：workbench_diy_install（unit=<上面那个 unit>）";
+	return `工坊：${packagesDir}\n${lines.join("\n")}\n\n${footer}`;
+}
+//#endregion
+//#region src/modules/panels/model/diy-tools.ts
+function registerDiyTools(ctx, market, panels, debug) {
+	const tools = ctx.get("tools");
+	if (tools === void 0) {
+		ctx.logger?.info?.("[dsh-workbench] 没有 tools 服务，跳过 DIY 工坊工具注册");
+		return [];
+	}
+	const listTool = {
+		name: DIY_LIST_TOOL,
+		description: "DIY 工坊里有哪些模块、装没装 —— 先跑它拿到 unit。普通项目里装模块用 workbench_modules_install。",
+		parameters: {
+			type: "object",
+			properties: {},
+			additionalProperties: false
+		},
+		output: OUTPUT$2,
+		async execute(_raw, exec) {
+			const { packagesDir } = workshopOf(ctx, exec);
+			const { modules } = modulesOf(ctx, packagesDir);
+			return plainJson({
+				workshop: packagesDir,
+				modules,
+				text: renderList(packagesDir, modules)
+			});
+		}
 	};
 	const statusTool = {
 		name: DIY_STATUS_TOOL,
@@ -6857,276 +7185,6 @@ async function installRouted(deps) {
 	});
 }
 //#endregion
-//#region src/shared/api/host/runtime-seed.ts
-var WORKSHOP_SKILLS_DIR = "workbench-module-diy";
-function runtimeSeedPaths(root) {
-	const opencliRoot = join(root, "opencli");
-	const opencliBinDir = join(opencliRoot, "bin");
-	const workshop = join(root, "diy");
-	return {
-		root,
-		entryDir: join(root, "bin"),
-		opencliRoot,
-		opencliBinDir,
-		opencliBin: join(opencliBinDir, "opencli"),
-		opencliHome: join(opencliRoot, "home"),
-		workshop,
-		workshopPackages: join(workshop, "packages"),
-		workshopManifest: join(workshop, "package.json"),
-		skillsLink: join(workshop, ".agents", "skills", WORKSHOP_SKILLS_DIR)
-	};
-}
-function runtimeSeedRootOf(ctx) {
-	const homePath = ctx.get("dshHomePath");
-	if (typeof homePath !== "function") return null;
-	try {
-		return homePath("workbench");
-	} catch {
-		return null;
-	}
-}
-function packageRootOf(moduleUrl) {
-	return dirname(dirname(dirname(fileURLToPath(moduleUrl))));
-}
-function isInstalledCopy(packageRoot) {
-	return packageRoot.split(sep).includes("node_modules");
-}
-function opencliWrapperScript(packageRoot, home) {
-	const script = join(packageRoot, "bin", "opencli-isolated");
-	return `#!/bin/sh\nexec env DSH_HOME=${quoteShellArg(home)} bash ${quoteShellArg(script)} "$@"\n`;
-}
-function workshopSeedPlan(packageRoot, home, root) {
-	const script = join(packageRoot, "scripts", "seed-workshop.sh");
-	const env = { DSH_HOME: home };
-	const log = join(root, "seed.log");
-	return {
-		entry: {
-			file: "bash",
-			args: [script, "entry"],
-			env,
-			log
-		},
-		full: {
-			file: "bash",
-			args: [script],
-			env,
-			log
-		}
-	};
-}
-function runDetached(command, onError, spawnImpl = spawn) {
-	let fd = null;
-	try {
-		fd = openSync(command.log, "a");
-		const child = spawnImpl(command.file, [...command.args], {
-			env: {
-				...process.env,
-				...command.env
-			},
-			detached: true,
-			stdio: [
-				"ignore",
-				fd,
-				fd
-			]
-		});
-		child.on("error", (error) => onError(`自举脚本没跑起来（${command.file}）：${String(error)}`));
-		child.unref();
-	} catch (error) {
-		onError(`自举脚本没跑起来（${command.file}）：${String(error)}`);
-	} finally {
-		if (fd !== null) closeQuietly(fd);
-	}
-}
-function closeQuietly(fd) {
-	try {
-		closeSync(fd);
-	} catch {
-		return;
-	}
-}
-function prependPath(entryDir, env = process.env) {
-	const parts = (env.PATH ?? "").split(delimiter).filter((part) => part !== "");
-	if (parts.includes(entryDir)) return false;
-	env.PATH = [entryDir, ...parts].join(delimiter);
-	return true;
-}
-function seedRuntimeFiles(options) {
-	const paths = runtimeSeedPaths(options.root);
-	const done = [];
-	try {
-		for (const dir of [
-			paths.entryDir,
-			paths.opencliBinDir,
-			paths.opencliHome,
-			paths.workshopPackages
-		]) mkdirSync(dir, { recursive: true });
-		const wanted = opencliWrapperScript(options.packageRoot, options.home);
-		if (readText(paths.opencliBin) !== wanted) {
-			rmSync(paths.opencliBin, { force: true });
-			writeFileSync(paths.opencliBin, wanted, "utf8");
-			chmodSync(paths.opencliBin, 493);
-			done.push(paths.opencliBin);
-		}
-		if (linkSkills(paths.skillsLink, join(options.packageRoot, "skills", "workbench-module-diy"), options.log)) done.push(paths.skillsLink);
-	} catch (error) {
-		options.log?.(`自举没做完：${String(error)}`);
-	}
-	return done;
-}
-function readText(file) {
-	try {
-		return readFileSync(file, "utf8");
-	} catch {
-		return null;
-	}
-}
-function readLink(link) {
-	try {
-		return readlinkSync(link);
-	} catch {
-		return null;
-	}
-}
-function linkSkills(link, source, log) {
-	if (!existsSync(source) || readLink(link) === source) return false;
-	try {
-		mkdirSync(dirname(link), { recursive: true });
-		rmSync(link, {
-			force: true,
-			recursive: true
-		});
-		symlinkSync(source, link, "dir");
-		return true;
-	} catch (error) {
-		log?.(`DIY 指引没挂上（${link}）：${String(error)}`);
-		return false;
-	}
-}
-//#endregion
-//#region src/shared/api/host/self-update.ts
-function runningVersionOf(moduleUrl) {
-	try {
-		const read = JSON.parse(readFileSync(new URL("../../package.json", moduleUrl), "utf8"));
-		return typeof read.version === "string" && read.version !== "" ? read.version : void 0;
-	} catch {
-		return;
-	}
-}
-function selfUpdatePaths(dshHome) {
-	const dir = join(dshHome, "workbench");
-	return {
-		dir,
-		script: join(dir, "self-update.sh"),
-		marker: join(dir, "self-update.json"),
-		log: join(dir, "self-update.log")
-	};
-}
-function recoveryCommand(input) {
-	return `dsh plugin --profile ${input.profile} add ${input.pkg}@${input.version}`;
-}
-function selfUpdateMarker(request, state, version, at) {
-	return {
-		...request,
-		state,
-		version,
-		at
-	};
-}
-function quoted(value) {
-	return `'${value.replaceAll("'", "'\\''")}'`;
-}
-function selfUpdateScript(request, paths) {
-	const rescue = recoveryCommand({
-		profile: request.profile,
-		pkg: request.pkg,
-		version: request.from
-	});
-	const lastsOne = recoveryCommand({
-		profile: request.profile,
-		pkg: request.pkg,
-		version: request.to === "" ? "latest" : request.to
-	});
-	const target = request.to === "" ? "latest" : request.to;
-	const landed = request.to === "" ? "is_other" : "is_to";
-	return `#!/usr/bin/env bash
-set -uo pipefail
-DSH_HOME=${quoted(request.dshHome)}
-PKG=${quoted(request.pkg)}
-PROFILE=${quoted(request.profile)}
-FROM=${quoted(request.from)}
-TO=${quoted(target)}
-MARKER=${quoted(paths.marker)}
-LOG=${quoted(paths.log)}
-PROFILE_DIR="$DSH_HOME/profiles/$PROFILE"
-say() { printf '%s %s\\n' "$(date '+%F %T')" "$*" >>"$LOG"; }
-on_disk() {
-  node -e 'const p=process.argv[1];try{process.stdout.write(require(p).version)}catch(e){}' \\
-    "$PROFILE_DIR/node_modules/$PKG/package.json" 2>/dev/null
-}
-write_marker() {
-  printf '{"pkg":"%s","profile":"%s","from":"%s","to":"%s","state":"%s","version":"%s","at":"%s"}\\n' \\
-    "$PKG" "$PROFILE" "$FROM" "$TO" "$1" "$2" "$(date -u '+%FT%TZ')" >"$MARKER"
-}
-install() { dsh plugin --profile "$PROFILE" add "$PKG@$1" >>"$LOG" 2>&1; }
-is_to() { [ "$(on_disk)" = "$TO" ]; }
-is_other() { [ -n "$(on_disk)" ] && [ "$(on_disk)" != "$FROM" ]; }
-if ! command -v dsh >/dev/null 2>&1; then
-  say "PATH 上没有 dsh —— 这一跳没跑。救法：${rescue}"
-  write_marker failed "$FROM"
-  exit 1
-fi
-say "开始 \${FROM} -> \${TO}（不卸任何一行）"
-write_marker running "$FROM"
-if install "$TO" && ${landed}; then
-  say "换好了：$(on_disk) 在盘上（目标 \${TO}），重启一次 dsh 才用得上"
-  write_marker ok "$(on_disk)"
-  exit 0
-fi
-say "换版没成（盘上 $(on_disk)）—— 把 \${FROM} 装回去"
-if install "$FROM" && [ "$(on_disk)" = "$FROM" ]; then
-  say "已回滚：\${FROM} 还在盘上，工作台这一行没被动过"
-  write_marker rolled-back "$FROM"
-  exit 0
-fi
-say "回滚也没成。救法：${rescue}（或 ${lastsOne}）"
-write_marker failed "$(on_disk)"
-exit 1
-`;
-}
-function planSelfUpdate(request, now = /* @__PURE__ */ new Date()) {
-	const paths = selfUpdatePaths(request.dshHome);
-	return {
-		paths,
-		script: selfUpdateScript(request, paths),
-		marker: selfUpdateMarker(request, "running", request.from, now.toISOString()),
-		command: {
-			file: "bash",
-			args: [paths.script],
-			env: {},
-			log: paths.log
-		}
-	};
-}
-function startSelfUpdate(request, onError, spawnImpl = spawn) {
-	const plan = planSelfUpdate(request);
-	mkdirSync(plan.paths.dir, { recursive: true });
-	writeFileSync(plan.paths.script, plan.script, { mode: 493 });
-	chmodSync(plan.paths.script, 493);
-	writeFileSync(plan.paths.marker, `${JSON.stringify(plan.marker)}\n`);
-	runDetached(plan.command, onError, spawnImpl);
-	const forward = recoveryCommand({
-		profile: request.profile,
-		pkg: request.pkg,
-		version: request.to === "" ? "latest" : request.to
-	});
-	return {
-		started: true,
-		paths: plan.paths,
-		forward
-	};
-}
-//#endregion
 //#region src/modules/panels/model/market-workbench-update.ts
 async function updateWorkbenchOnce(deps) {
 	const asked = deps.asked.trim();