@dsh-workbench/core 0.3.7 → 0.3.9

package/dist/client/index.js

@@ -555,6 +555,16 @@ function longTaskDot(status) {
 	return "idle";
 }
 /**
+* 这一趟还在不在跑（`running` 与 `needs-login` 都算）。
+* 卡片要判"这一行要不要摆停止钮""这套环境里有没有活着的跑"时用这个 —— **不是** `longTaskDot`：
+* 那一件是状态点的**长相**（四档），归 `LongTaskRow` 自己用，不该被调用点拿去当判据。
+* @param status 长任务的五种态。
+* @returns 在跑 `true`；成功 / 失败 / 用户按停都是 `false`。
+*/
+function longTaskIsLive(status) {
+	return status === "running" || status === "needs-login";
+}
+/**
 * 算停止钮现在在哪一档。
 * @param state armed = 已经按过第一下、在等第二下；busy = 停止请求已经在飞。
 * @returns busy 优先（在飞时按不动），其次 armed，否则 idle。
@@ -2767,7 +2777,8 @@ var dictionaries = {
 		"env.stepFailed.shell": "执行通道不可用",
 		"env.bridge.ok": "已连接",
 		"env.bridge.short": "没连上",
-		"env.bridge.why": "面板的数据要走你浏览器里的登录态：这个通道没连上，模块就取不到数据（不拦路，但先修好它）。",
+		"env.bridge.why": "面板的数据要走你浏览器里的登录态：这个通道没连上，模块就取不到数据（不拦路：修好它，或者先进入工作台）。",
+		"env.bridge.hold": "浏览器通道还没连上 —— 按下面修好后点「重试」，也可以先进工作台。",
 		"env.bridge.daemon": "后台服务没起来：正常它会自己起，先在终端跑下面这条命令。",
 		"env.bridge.extension": "浏览器扩展没连上：在 Chrome 应用商店装一次就好（装完回来点「重试」）。已经装过的话，先跑下面这条命令。",
 		"env.bridge.extensionLink": "去 Chrome 应用商店装扩展",
@@ -2785,11 +2796,21 @@ var dictionaries = {
 		"env.fix.network": "网络不通：检查网络或代理设置后重试。",
 		"env.fix.details": "详细输出（排障用）",
 		"env.retry": "重试",
+		"env.bridge.continue": "先进入工作台",
+		"env.diy.ok": "可用",
+		"env.diy.short": "挂不起来",
+		"env.diy.hold": "DIY 模式挂不起来 —— 升级 dsh 后点「重试」，也可以先进工作台。",
+		"env.diy.why": "「工作台 DIY」是 dsh 的一个 agent preset，而它是照这份外壳验过的那一代 dsh 生成的：这台机器上的 dsh 比它旧，其中几行 dsh 根本没有，于是这个模式整个挂不起来。dsh 的模式选择器只列挂得起来的，进去之后它会整个不出现 —— 面板与其它功能不受影响。",
+		"env.diy.rows": "这一代 dsh 缺这几行：{rows}",
+		"env.diy.noRow": "体检没在 dsh 的 preset 名单里看到「工作台 DIY」—— 多半是这份 bundle 的 preset 补丁没生效。",
+		"env.diy.step": "升级 dsh，然后重启一次工作台：",
+		"env.diy.continue": "先进入工作台",
 		"env.copyCommand": "复制命令",
 		"env.copied": "已复制",
 		"env.step.opencli": "检测工作台的 opencli",
 		"env.step.codingPlugin": "检测 coding 插件",
 		"env.step.bridge": "检测浏览器通道",
+		"env.step.diy": "检查 DIY 模式",
 		"env.step.warm": "预热站点登录态",
 		"env.warm.done": "已预热 {n} 个站点",
 		"env.warm.short": "这次没热上 —— 不影响用，面板第一次读取会自己补",
@@ -3211,7 +3232,8 @@ var dictionaries = {
 		"env.stepFailed.shell": "no shell channel",
 		"env.bridge.ok": "Connected",
 		"env.bridge.short": "Not connected",
-		"env.bridge.why": "Panel data goes through the login state in your browser: with this channel down, modules cannot fetch data. It does not block startup, but fix it first.",
+		"env.bridge.why": "Panel data goes through the login state in your browser: with this channel down, modules cannot fetch data. It does not block startup: fix it, or enter the workbench first.",
+		"env.bridge.hold": "The browser bridge is not connected yet — fix it below and hit Retry, or enter the workbench first.",
 		"env.bridge.daemon": "The background service is not running. It usually starts by itself — run the command below in your terminal first.",
 		"env.bridge.extension": "The browser extension is not connected. Install it once from the Chrome Web Store (then hit Retry here). If it is already installed, run the command below first.",
 		"env.bridge.extensionLink": "Get the extension in the Chrome Web Store",
@@ -3229,11 +3251,21 @@ var dictionaries = {
 		"env.fix.network": "Network unreachable: check your network or proxy, then retry.",
 		"env.fix.details": "Details (for troubleshooting)",
 		"env.retry": "Retry",
+		"env.bridge.continue": "Enter the workbench anyway",
+		"env.diy.ok": "Available",
+		"env.diy.short": "Cannot load",
+		"env.diy.hold": "DIY mode cannot load — upgrade dsh, then hit Retry; or enter the workbench first.",
+		"env.diy.why": "“Workbench DIY” is a dsh agent preset, and it is generated from the dsh generation this shell was verified against. The dsh on this machine is older and does not ship some of those rows, so the whole preset fails to mount. dsh lists only the presets that mount, so the mode will simply not appear — panels and everything else are unaffected.",
+		"env.diy.rows": "This dsh is missing these rows: {rows}",
+		"env.diy.noRow": "The health check did not find “Workbench DIY” in dsh’s preset roster — most likely this bundle’s preset patch did not apply.",
+		"env.diy.step": "Upgrade dsh, then restart the workbench:",
+		"env.diy.continue": "Enter the workbench anyway",
 		"env.copyCommand": "Copy command",
 		"env.copied": "Copied",
 		"env.step.opencli": "Checking the workbench opencli",
 		"env.step.codingPlugin": "Checking the coding plugin",
 		"env.step.bridge": "Checking the browser bridge",
+		"env.step.diy": "Checking DIY mode",
 		"env.step.warm": "Warming up site sessions",
 		"env.warm.done": "{n} site(s) warmed up",
 		"env.warm.short": "Not warmed this time — harmless; the panel heals on first read",
@@ -7785,6 +7817,10 @@ function stepDetailText(step, snapshot, t) {
 		if (step.status === "ok") return t("env.bridge.ok");
 		if (step.status === "warn") return t("env.bridge.short");
 	}
+	if (step.id === "diy") {
+		if (step.status === "ok") return t("env.diy.ok");
+		if (step.status === "warn") return t("env.diy.short");
+	}
 	if (step.id === "warm") {
 		if (step.status === "ok") return t("env.warm.done", { n: step.detail ?? "0" });
 		if (step.status === "warn") return t("env.warm.short");
@@ -7880,6 +7916,7 @@ var GIVE_UP_MS = 12e4;
 function stepLabel$1(id, t) {
 	if (id === "opencli") return t("env.step.opencli");
 	if (id === "warm") return t("env.step.warm");
+	if (id === "diy") return t("env.step.diy");
 	return t("env.step.bridge");
 }
 function stepMark(step) {
@@ -7907,6 +7944,18 @@ function createForcePlan() {
 		}
 	};
 }
+/**
+* 拿到这一拍之后门该怎么办：`close` 撤掉放行、`hold` 停在原地等用户动手、`wait` 接着轮询。
+* 桥接坏了（`bridgeIssues` 非空）与 DIY 模式挂不起来（`diyGap` 非空）都是**不拦路**的，
+* 但那块「怎么解决」得先真的画出来 —— 停在原地 + 一颗「先进入工作台」才叫不拦路，
+* 就绪即撤等于把那块提示连同修法一起丢掉，用户进去只会发现「工作台 DIY」整个不在。
+*/
+function gateActionOf(snapshot) {
+	if (snapshot.phase === "failed") return "hold";
+	if (snapshot.phase !== "ready") return "wait";
+	if ((snapshot.bridgeIssues?.length ?? 0) > 0) return "hold";
+	return snapshot.diyGap === void 0 ? "close" : "hold";
+}
 function commandRow(t) {
 	const row = el("div", BootGate_module_default.commandRow);
 	const code = el("code", BootGate_module_default.command);
@@ -7979,13 +8028,32 @@ function createBootGate(ctx, options = {}) {
 	const bridgeCommand = commandRow(t);
 	const bridgeRetry = el("button", BootGate_module_default.button, t("env.retry"));
 	bridgeRetry.setAttribute("type", "button");
+	const bridgeSkip = el("button", BootGate_module_default.button, t("env.bridge.continue"));
+	bridgeSkip.setAttribute("type", "button");
 	const bridgeButtons = el("div", BootGate_module_default.buttons);
-	bridgeButtons.append(bridgeRetry);
+	bridgeButtons.append(bridgeRetry, bridgeSkip);
 	const bridgeRaw = el("details", BootGate_module_default.raw);
 	const bridgeRawText = el("pre", BootGate_module_default.error);
 	bridgeRaw.append(el("summary", BootGate_module_default.rawSummary, t("env.fix.details")), bridgeRawText);
 	bridge.append(bridgeTitle, bridgeWhy, bridgeLines, bridgeCommand.row, bridgeButtons, bridgeRaw);
-	card.append(title, hint, list, progressRow, actions, bridge);
+	const diy = el("div", BootGate_module_default.bridge);
+	diy.hidden = true;
+	const diyTitle = el("h2", BootGate_module_default.fixTitle, t("env.fix.title"));
+	const diyWhy = el("p", BootGate_module_default.hint, t("env.diy.why"));
+	const diyLines = el("ul", BootGate_module_default.bridgeLines);
+	const diyStep = el("p", BootGate_module_default.hint, t("env.diy.step"));
+	const diyCommand = commandRow(t);
+	const diyRetry = el("button", BootGate_module_default.button, t("env.retry"));
+	diyRetry.setAttribute("type", "button");
+	const diySkip = el("button", BootGate_module_default.button, t("env.diy.continue"));
+	diySkip.setAttribute("type", "button");
+	const diyButtons = el("div", BootGate_module_default.buttons);
+	diyButtons.append(diyRetry, diySkip);
+	const diyRaw = el("details", BootGate_module_default.raw);
+	const diyRawText = el("pre", BootGate_module_default.error);
+	diyRaw.append(el("summary", BootGate_module_default.rawSummary, t("env.fix.details")), diyRawText);
+	diy.append(diyTitle, diyWhy, diyLines, diyStep, diyCommand.row, diyButtons, diyRaw);
+	card.append(title, hint, list, progressRow, actions, bridge, diy);
 	overlay.append(card);
 	document.body.append(overlay);
 	const previousInert = root?.inert ?? false;
@@ -8043,7 +8111,7 @@ function createBootGate(ctx, options = {}) {
 		return row;
 	}
 	function render(snapshot) {
-		hint.textContent = snapshot.phase === "installing" ? t("env.installing") : snapshot.phase === "failed" ? t("env.failed") : t("env.checking");
+		hint.textContent = snapshot.phase === "installing" ? t("env.installing") : snapshot.phase === "failed" ? t("env.failed") : gateActionOf(snapshot) === "hold" ? (snapshot.bridgeIssues?.length ?? 0) > 0 ? t("env.bridge.hold") : t("env.diy.hold") : t("env.checking");
 		const items = snapshot.steps.map((step) => {
 			const row = ensureRow(step);
 			row.item.dataset.status = step.status;
@@ -8101,6 +8169,15 @@ function createBootGate(ctx, options = {}) {
 			bridgeRawText.textContent = bridgeStep.detail ?? "";
 			bridgeRaw.hidden = (bridgeStep.detail ?? "") === "";
 		}
+		const gap = snapshot.diyGap;
+		diy.hidden = gap === void 0;
+		if (gap !== void 0) {
+			const lines = gap.rows.length === 0 ? [t("env.diy.noRow")] : [t("env.diy.rows", { rows: gap.rows.join("、") })];
+			diyLines.replaceChildren(...lines.map((text) => el("li", BootGate_module_default.bridgeLine, text)));
+			diyCommand.set(gap.command);
+			diyRawText.textContent = gap.detail;
+			diyRaw.hidden = gap.detail === "";
+		}
 	}
 	async function poll() {
 		if (cancelled) return;
@@ -8112,19 +8189,22 @@ function createBootGate(ctx, options = {}) {
 			return;
 		}
 		render(response);
-		if (response.phase === "ready") {
+		const action = gateActionOf(response);
+		if (action === "close") {
 			close();
 			return;
 		}
-		if (response.phase === "failed") return;
+		if (action === "hold") return;
 		timer = setTimeout(() => void poll(), POLL_MS);
 	}
 	function retryNow() {
 		forcePlan.again();
 		actions.hidden = true;
 		bridge.hidden = true;
+		diy.hidden = true;
 		retry.setAttribute("disabled", "");
 		bridgeRetry.setAttribute("disabled", "");
+		diyRetry.setAttribute("disabled", "");
 		hint.textContent = t("env.checking");
 		if (pinned !== null) {
 			render(pinned);
@@ -8134,6 +8214,9 @@ function createBootGate(ctx, options = {}) {
 	}
 	retry.addEventListener("click", retryNow);
 	bridgeRetry.addEventListener("click", retryNow);
+	bridgeSkip.addEventListener("click", close);
+	diyRetry.addEventListener("click", retryNow);
+	diySkip.addEventListener("click", close);
 	const search = typeof window === "undefined" ? "" : window.location?.search ?? "";
 	if (devSurface.on(search)) {
 		const strip = devSurface.gateStrip({ onPick: (snapshot) => {
@@ -10833,17 +10916,19 @@ function useLongTask(options) {
 			setStopping((current) => current === id ? null : current);
 		}
 	}, [send]);
-	const every = longTaskPollMs(runs.some((run) => longTaskDot(run.status) === "ongoing"), options.pollMs);
+	const every = longTaskPollMs(runs.some((run) => longTaskIsLive(run.status)), options.pollMs);
 	useEffect(() => {
 		if (!enabled) return void 0;
 		const timer = setInterval(() => setTick((count) => count + 1), every);
 		return () => clearInterval(timer);
 	}, [enabled, every]);
+	const refresh = useCallback(() => setTick((count) => count + 1), []);
 	return {
 		runs,
 		stop,
 		stopping,
-		stopFailed: write.failed
+		stopFailed: write.failed,
+		refresh
 	};
 }
 //#endregion
@@ -11099,6 +11184,7 @@ var kit = {
 		...context_chips_exports
 	},
 	lib: {
+		longTaskIsLive,
 		MIN_BUSY_MS: 500,
 		blockerOfCapability,
 		blockerOfError,

package/dist/host/index.js

@@ -2364,6 +2364,9 @@ function createWorkspaceStore(options) {
 		}
 	};
 }
+//#endregion
+//#region src/shared/api/diy.ts
+var DIY_PRESET_ID = "workbench-diy";
 var WORKSHOP_RELATIVE = "workbench/diy";
 var WORKSHOP_TITLE = "工作台DIY";
 //#endregion
@@ -2712,8 +2715,23 @@ function readInstalledModule(profileDir, pkg) {
 		...registry === "" ? {} : { registry }
 	};
 }
+var PACKED_ARTIFACT = /\.(?:tgz|tar\.gz|tar)$/i;
+/**
+* 这份依赖是不是"从一个**打好的包**装的"（`file:/tmp/dsh-workbench-core-0.3.8.tgz`、
+* `./x-0.3.8.tgz`）。它跟 `link:` / 目录装的**不是**一回事：那是工作树（改了立刻生效，
+* 也不可能跟源上比出个新旧），而 tgz 是打包产物 —— 包名与版本就是源上那一套，能比、
+* 也该让人更新。混在一起会把"从文件装的发布产物"说成"本仓正在开发的那一份"，
+* 顺带把版本比对与更新一起关掉。
+*/
+function isPackedArtifactSpec(spec) {
+	const trimmed = spec.trim();
+	const pkgPath = trimmed.startsWith("file:") ? trimmed.slice(5) : trimmed;
+	return PACKED_ARTIFACT.test(pkgPath);
+}
+/** 这份依赖是不是"本仓那份"（`link:` / 目录 / 相对或绝对路径）—— 只有工作树才算。 */
 function isLocalDependencySpec(spec) {
 	const trimmed = spec.trim();
+	if (isPackedArtifactSpec(trimmed)) return false;
 	return trimmed.startsWith("link:") || trimmed.startsWith("file:") || trimmed.startsWith("./") || trimmed.startsWith("../") || trimmed.startsWith("/");
 }
 function readProfilePackage(profileDir, pkg) {
@@ -11891,6 +11909,75 @@ function createContextInjector(options) {
 	} };
 }
 //#endregion
+//#region src/shared/api/host/diy-preset-health.ts
+/**
+* DIY 模式挂不起来时给用户的那条修法：升级 dsh，再重启一次工作台（启动器那道拒绝用的是同一条）。
+*/
+var DIY_UPGRADE_COMMAND = "npm i -g @deepseek-ai/dsh@latest";
+/**
+* 把 dsh 名册里那句 `broken` 原文拆成一项一个行名。
+* @param detail - registry 给的原文，一行一项，形如 `tool-schedule (@deepseek-ai/dsh-tool-schedule): never started`。
+* @returns 每行 `(` 之前那一段；空原文给空数组。
+*/
+function brokenRowsOf(detail) {
+	const rows = [];
+	for (const line of String(detail ?? "").split("\n")) {
+		const text = line.trim();
+		if (text === "") continue;
+		const at = text.indexOf(" (");
+		rows.push(at < 0 ? text : text.slice(0, at));
+	}
+	return rows;
+}
+/**
+* 从 preset 名册判 DIY 模式挂不挂得起来。
+* @param presets - `agentPresets.list()` 的回值。
+* @returns 名册还空着（preset 行还没登记完）给 `undefined` —— 那是"还不知道"，不是故障；否则给结论。
+*/
+function diyPresetVerdictOf(presets) {
+	if (!Array.isArray(presets) || presets.length === 0) return void 0;
+	const mine = presets.find((row) => row?.id === DIY_PRESET_ID);
+	if (mine === void 0) return {
+		ok: false,
+		rows: [],
+		detail: `preset 名单里没有 ${DIY_PRESET_ID}`
+	};
+	const broken = typeof mine.broken === "string" ? mine.broken.trim() : "";
+	if (broken === "") return {
+		ok: true,
+		rows: [],
+		detail: ""
+	};
+	return {
+		ok: false,
+		rows: brokenRowsOf(broken),
+		detail: broken
+	};
+}
+/**
+* 造一个读 preset 名册的探针：名册还没登记完就每 `everyMs` 重读，到 `deadlineMs` 还没读到就放弃。
+* @param ctx - 宿主上下文（取 `agentPresets` 服务；那个服务不在时给一个恒回 `undefined` 的探针）。
+* @param options - 两个时间旋钮（测试用）：多久放弃、隔多久重读。
+* @returns 探针：调一次读一轮，`undefined` 表示"这次没读到"。
+*/
+function createDiyPresetProbe(ctx, options = {}) {
+	const deadlineMs = options.deadlineMs ?? 15e3;
+	const everyMs = options.everyMs ?? 400;
+	return async () => {
+		const registry = ctx.get("agentPresets");
+		if (registry === void 0 || typeof registry.list !== "function") return void 0;
+		const until = Date.now() + deadlineMs;
+		for (;;) {
+			const rows = await registry.list().catch(() => void 0);
+			if (rows === void 0) return void 0;
+			const verdict = diyPresetVerdictOf(rows);
+			if (verdict !== void 0) return verdict;
+			if (Date.now() >= until) return void 0;
+			await new Promise((resolve) => setTimeout(resolve, everyMs));
+		}
+	};
+}
+//#endregion
 //#region src/shared/api/host/preflight.ts
 function classifyFailure(text) {
 	const lower = text.toLowerCase();
@@ -11953,6 +12040,7 @@ function createPreflight(options) {
 	const steps = () => [
 		step("opencli"),
 		step("bridge"),
+		...options.probeDiy === void 0 ? [] : [step("diy")],
 		...warmReads().length === 0 ? [] : [step("warm")]
 	];
 	let current = {
@@ -12067,6 +12155,31 @@ function createPreflight(options) {
 		});
 		return again;
 	}
+	async function settleDiy(started) {
+		if (started === void 0) return void 0;
+		const verdict = await started.catch(() => void 0);
+		if (verdict === void 0) {
+			set({ steps: current.steps.filter((item) => item.id !== "diy") });
+			return;
+		}
+		if (verdict.ok) {
+			patchStep("diy", {
+				status: "ok",
+				detail: verdict.detail
+			});
+			return;
+		}
+		patchStep("diy", {
+			status: "warn",
+			detail: verdict.detail,
+			command: DIY_UPGRADE_COMMAND
+		});
+		return {
+			rows: verdict.rows,
+			detail: verdict.detail,
+			command: DIY_UPGRADE_COMMAND
+		};
+	}
 	async function doRun() {
 		set({
 			phase: "checking",
@@ -12078,6 +12191,8 @@ function createPreflight(options) {
 			status: "running",
 			action: `${command} --version`
 		});
+		const diyStarted = options.probeDiy?.();
+		if (diyStarted !== void 0) patchStep("diy", { status: "running" });
 		let version = await probeVersion();
 		if (!version.ok && !version.missing) {
 			patchStep("opencli", {
@@ -12149,10 +12264,12 @@ function createPreflight(options) {
 			...bridge.command === void 0 ? {} : { command: bridge.command }
 		});
 		const settled = await warmSites(bridge);
+		const diyGap = await settleDiy(diyStarted);
 		logger?.warn?.(`[dsh-workbench] 环境体检：${current.steps.map((item) => `${item.id}=${item.status}`).join(" ")}`);
 		return set({
 			phase: "ready",
-			...settled.ok ? {} : { bridgeIssues: settled.issues }
+			...settled.ok ? {} : { bridgeIssues: settled.issues },
+			...diyGap === void 0 ? {} : { diyGap }
 		});
 	}
 	function freshReady() {
@@ -12175,6 +12292,24 @@ function createPreflight(options) {
 	};
 }
 //#endregion
+//#region src/shared/api/host/preflight-route.ts
+/**
+* 把启动体检接上 `preflight` 那条路由。
+* @param input - 路由表、宿主上下文、执行缝，以及 opencli 命令 / 装它用的命令（可选）与各套件声明的预热读命令。
+* @returns 无（路由挂在 `input.routes.preflight` 上）。
+*/
+function registerPreflight(input) {
+	const preflight = createPreflight({
+		shell: input.shell,
+		command: input.opencliCommand,
+		...input.installCommand === void 0 ? {} : { installCommand: input.installCommand },
+		logger: input.ctx.logger,
+		warmReads: input.warmReads,
+		probeDiy: createDiyPresetProbe(input.ctx)
+	});
+	input.routes.preflight = preflightHandler(preflight);
+}
+//#endregion
 //#region src/shared/api/host/probe-cache.ts
 function createTimedMemo(ttlMs) {
 	const entries = /* @__PURE__ */ new Map();
@@ -13980,13 +14115,14 @@ function apply(ctx) {
 	}
 	if (shell === void 0) ctx.logger?.warn?.("[dsh-workbench] 没有 shell 服务：需要执行缝的套件会降级");
 	else {
-		routes.preflight = preflightHandler(createPreflight({
+		registerPreflight({
+			routes,
+			ctx,
 			shell,
-			command: opencli.command,
+			opencliCommand: opencli.command,
 			...installEnv === void 0 ? {} : { installCommand: installEnv },
-			logger: ctx.logger,
 			warmReads: () => [...mounted.values()].flatMap((item) => item.plan.warmReads())
-		}));
+		});
 		routes.capability = capabilityHandler(async (unit, force) => {
 			if (unit === void 0) return { units: (await probeUnits({
 				shell,

package/dist/types/app/client.d.ts

@@ -9,7 +9,7 @@ import * as capabilityGateModule from '../shared/hooks/use-capability-gate';
 import * as unitBoardModule from '../shared/hooks/use-unit-board';
 import * as visibleBusyModule from '../shared/hooks/use-visible-busy';
 import * as blockerStateModule from '../shared/components/BlockerState';
-import { ActivityAction, ActivityBlock, ActivityLine, ApprovalDetail, ApprovalPlan, Card, CardAnchor, CardBoundary, CardHead, CenteredState, ChoiceGroup, ConfirmBar, EmptyState, Field, Form, FormActions, FormRow, FormRows, IconBrandMark, IconConversation, IconModuleMark, IconNpm, IconOpencli, IconPanelScreen, Link, LongTaskRow, Note, Row, Rows, SaveBar, SelectField, SettingsSection, SkeletonRows, Spinner, Stack, StateBlock, TextField, apiGet, apiPost, blockerOfCapability, blockerOfError, cardIdOf, cx, defaultSelectFilter, duplicateKeysOf, errorReasonOf, excerpt, filterSelectOptions, firstProblemOf, formFirstProblemOf, formValuesOf, holdBusy, parseJsonLoose, parseLocalTimestamp, readText, relativeTime, relativeTimeAgo, relativeTimeBucket, relativeTimeCompact, revealFirstProblem, searchTextOf, selectCursorValue, selectEntries, shortenPath, stepSelectCursor, writeText } from '@dsh-workbench/shared';
+import { ActivityAction, ActivityBlock, ActivityLine, ApprovalDetail, ApprovalPlan, Card, CardAnchor, CardBoundary, CardHead, CenteredState, ChoiceGroup, ConfirmBar, EmptyState, Field, Form, FormActions, FormRow, FormRows, IconBrandMark, IconConversation, IconModuleMark, IconNpm, IconOpencli, IconPanelScreen, Link, LongTaskRow, longTaskIsLive, Note, Row, Rows, SaveBar, SelectField, SettingsSection, SkeletonRows, Spinner, Stack, StateBlock, TextField, apiGet, apiPost, blockerOfCapability, blockerOfError, cardIdOf, cx, defaultSelectFilter, duplicateKeysOf, errorReasonOf, excerpt, filterSelectOptions, firstProblemOf, formFirstProblemOf, formValuesOf, holdBusy, parseJsonLoose, parseLocalTimestamp, readText, relativeTime, relativeTimeAgo, relativeTimeBucket, relativeTimeCompact, revealFirstProblem, searchTextOf, selectCursorValue, selectEntries, shortenPath, stepSelectCursor, writeText } from '@dsh-workbench/shared';
 export declare const kit: {
     hooks: {
         heldPhase(phase: visibleBusyModule.HeldPhase, refreshing: boolean): visibleBusyModule.HeldPhase;
@@ -102,6 +102,7 @@ export declare const kit: {
         apiPost: typeof apiPost;
     };
     lib: {
+        longTaskIsLive: typeof longTaskIsLive;
         MIN_BUSY_MS: number;
         blockerOfCapability: typeof blockerOfCapability;
         blockerOfError: typeof blockerOfError;

package/dist/types/app/layouts/env-gate/boot-gate.d.ts

@@ -1,4 +1,5 @@
 import type { Translate } from '@dsh-workbench/shared';
+import type { PreflightSnapshot } from '../../../shared/api/host/preflight';
 import { apiGet } from '@dsh-workbench/shared';
 /**
  * 每一拍轮询带什么参数：平时什么都不带（宿主那边跟着正在跑的那一轮，刚跑出 `ready` 的直接回上一次），
@@ -14,6 +15,13 @@ export declare function createForcePlan(): {
 export interface BootGate {
     close(): void;
 }
+/**
+ * 拿到这一拍之后门该怎么办：`close` 撤掉放行、`hold` 停在原地等用户动手、`wait` 接着轮询。
+ * 桥接坏了（`bridgeIssues` 非空）与 DIY 模式挂不起来（`diyGap` 非空）都是**不拦路**的，
+ * 但那块「怎么解决」得先真的画出来 —— 停在原地 + 一颗「先进入工作台」才叫不拦路，
+ * 就绪即撤等于把那块提示连同修法一起丢掉，用户进去只会发现「工作台 DIY」整个不在。
+ */
+export declare function gateActionOf(snapshot: PreflightSnapshot): 'close' | 'hold' | 'wait';
 export declare function createBootGate(ctx: {
     locale: {
         bind(namespace: string): Translate;

package/dist/types/shared/api/host/diy-preset-health.d.ts

@@ -0,0 +1,35 @@
+import type { DshAgentPresetRow, DshHostContext } from '@dsh-workbench/shared';
+/**
+ * DIY 模式挂不起来时给用户的那条修法：升级 dsh，再重启一次工作台（启动器那道拒绝用的是同一条）。
+ */
+export declare const DIY_UPGRADE_COMMAND = "npm i -g @deepseek-ai/dsh@latest";
+/**
+ * 一次 DIY 模式体检的结论：`ok` 为真 = 名册里有那一行且挂着；为假时 `rows` 是挂不起来的行名、`detail` 是 dsh 给的原文。
+ */
+export interface DiyPresetVerdict {
+    readonly ok: boolean;
+    readonly rows: readonly string[];
+    readonly detail: string;
+}
+/**
+ * 把 dsh 名册里那句 `broken` 原文拆成一项一个行名。
+ * @param detail - registry 给的原文，一行一项，形如 `tool-schedule (@deepseek-ai/dsh-tool-schedule): never started`。
+ * @returns 每行 `(` 之前那一段；空原文给空数组。
+ */
+export declare function brokenRowsOf(detail: string): readonly string[];
+/**
+ * 从 preset 名册判 DIY 模式挂不挂得起来。
+ * @param presets - `agentPresets.list()` 的回值。
+ * @returns 名册还空着（preset 行还没登记完）给 `undefined` —— 那是"还不知道"，不是故障；否则给结论。
+ */
+export declare function diyPresetVerdictOf(presets: readonly DshAgentPresetRow[]): DiyPresetVerdict | undefined;
+/**
+ * 造一个读 preset 名册的探针：名册还没登记完就每 `everyMs` 重读，到 `deadlineMs` 还没读到就放弃。
+ * @param ctx - 宿主上下文（取 `agentPresets` 服务；那个服务不在时给一个恒回 `undefined` 的探针）。
+ * @param options - 两个时间旋钮（测试用）：多久放弃、隔多久重读。
+ * @returns 探针：调一次读一轮，`undefined` 表示"这次没读到"。
+ */
+export declare function createDiyPresetProbe(ctx: DshHostContext, options?: {
+    deadlineMs?: number;
+    everyMs?: number;
+}): () => Promise<DiyPresetVerdict | undefined>;

package/dist/types/shared/api/host/installed-module.d.ts

@@ -34,6 +34,15 @@ export interface DeclarationGap {
 export declare function declarationGaps(profileDir: string | null): readonly DeclarationGap[] | undefined;
 export declare function declaredPluginCommands(profileDir: string | null): ReadonlyMap<string, ReadonlySet<string>>;
 export declare function readInstalledModule(profileDir: string | null, pkg: string): InstalledModule;
+/**
+ * 这份依赖是不是"从一个**打好的包**装的"（`file:/tmp/dsh-workbench-core-0.3.8.tgz`、
+ * `./x-0.3.8.tgz`）。它跟 `link:` / 目录装的**不是**一回事：那是工作树（改了立刻生效，
+ * 也不可能跟源上比出个新旧），而 tgz 是打包产物 —— 包名与版本就是源上那一套，能比、
+ * 也该让人更新。混在一起会把"从文件装的发布产物"说成"本仓正在开发的那一份"，
+ * 顺带把版本比对与更新一起关掉。
+ */
+export declare function isPackedArtifactSpec(spec: string): boolean;
+/** 这份依赖是不是"本仓那份"（`link:` / 目录 / 相对或绝对路径）—— 只有工作树才算。 */
 export declare function isLocalDependencySpec(spec: string): boolean;
 export interface ProfilePackage {
     readonly pkg: string;

package/dist/types/shared/api/host/preflight-route.d.ts

@@ -0,0 +1,15 @@
+import type { DshHostContext, DshShell } from '@dsh-workbench/shared';
+import type { RouteTable } from '@dsh-workbench/shared/host';
+/**
+ * 把启动体检接上 `preflight` 那条路由。
+ * @param input - 路由表、宿主上下文、执行缝，以及 opencli 命令 / 装它用的命令（可选）与各套件声明的预热读命令。
+ * @returns 无（路由挂在 `input.routes.preflight` 上）。
+ */
+export declare function registerPreflight(input: {
+    routes: RouteTable;
+    ctx: DshHostContext;
+    shell: DshShell;
+    opencliCommand: string;
+    installCommand?: string | undefined;
+    warmReads: () => readonly (readonly string[])[];
+}): void;

package/dist/types/shared/api/host/preflight.d.ts

@@ -1,5 +1,6 @@
 import type { DshShell } from '@dsh-workbench/shared';
-export type PreflightStepId = 'opencli' | 'bridge' | 'warm';
+import type { DiyPresetVerdict } from './diy-preset-health';
+export type PreflightStepId = 'opencli' | 'bridge' | 'diy' | 'warm';
 export type PreflightStepStatus = 'pending' | 'running' | 'ok' | 'warn' | 'failed';
 export interface PreflightStep {
     readonly id: PreflightStepId;
@@ -17,6 +18,14 @@ export declare function readBridgeReport(stdout: string): {
     readonly issues: readonly PreflightBridgeIssue[];
     readonly detail: string;
 };
+/**
+ * DIY 模式挂不起来时随快照送出去的那三件：挂不起来的行、dsh 给的原文、修法（升级 dsh）。
+ */
+export interface PreflightDiyGap {
+    readonly rows: readonly string[];
+    readonly detail: string;
+    readonly command: string;
+}
 export interface PreflightSnapshot {
     readonly phase: 'idle' | 'checking' | 'installing' | 'ready' | 'failed';
     readonly steps: readonly PreflightStep[];
@@ -25,6 +34,7 @@ export interface PreflightSnapshot {
     readonly failure?: PreflightFailure;
     readonly guidance?: PreflightGuidance;
     readonly bridgeIssues?: readonly PreflightBridgeIssue[];
+    readonly diyGap?: PreflightDiyGap;
 }
 /**
  * 环境体检：`run()` 跑一次并回快照，`snapshot()` 看眼下这一拍。`run` 的取舍是：
@@ -61,4 +71,5 @@ export declare function createPreflight(options: {
         detail: string;
     }>) | undefined;
     warmReads?: (() => readonly (readonly string[])[]) | undefined;
+    probeDiy?: (() => Promise<DiyPresetVerdict | undefined>) | undefined;
 }): Preflight;

package/dist/types/shared/hooks/use-long-task.d.ts

@@ -3,12 +3,15 @@ import { type LongTaskStatus, type WriteOutcome } from '@dsh-workbench/shared';
  * 这一单元的长任务清单与停止口：`runs` 是这次读交回的那一批（读数还没回来时是空数组）；
  * `stop(id)` 请外壳停某一趟 —— 回执没成就带回一句人话（调用点自己决定说不说）；
  * `stopping` 是正在请求停止的那一趟 id（没有就是 `null`），`stopFailed` 是上一次停止请求失败那句话（没有就是 `null`）。
+ * `refresh()` 让这一格**立刻**重读一次（不必等下一拍轮询）—— 自己写完/发起完之后用它，
+ * 别去拼读口路由、也别为一个读数去碰事实通道。
  */
 export interface LongTaskFeed<T> {
     readonly runs: readonly T[];
     stop(id: string): Promise<WriteOutcome<unknown>>;
     readonly stopping: string | null;
     readonly stopFailed: string | null;
+    refresh(): void;
 }
 /**
  * 卡片要轮询长任务那一行时调用：有在跑的（`running` / `needs-login`）按 `longTaskPollMs` 走快档、空闲走慢档；