@dsh-workbench/core 1.1.14-beta.1 → 1.1.14

package/README.md

@@ -203,7 +203,7 @@ HMR 热换插件（不刷新页面），宿主半侧按模块路径热重载。
 | 装法、界面、适合谁 | [根 README](../../README.md) |
 | 架构、两个运行时、槽位、数据通路、门禁 | [ARCHITECTURE.md](../../ARCHITECTURE.md) |
 | 写一个模块 | [DIY 指引](skills/workbench-module-diy/SKILL.md) |
-| 模块的构建与十三条判据 | [module-tools](../module-tools/README.md) |
+| 模块的构建与十四条判据 | [module-tools](../module-tools/README.md) |
 | 共享包（契约、哑组件、宿主工具） | [shared](../shared/README.md) |
 | 最小模块样本 | [module-hello](../module-hello/README.md) |
 | 环境、门禁、提交 | [CONTRIBUTING.md](../../CONTRIBUTING.md) |

package/bin/dsh-workbench

@@ -403,58 +403,12 @@ fi
 # 现在改成：**工作台自己的 patch 是唯一真相**。想要 web 的哪几行，去
 # 设置 → 「配置同步」里勾（它读源 profile 的 cordis.patch.yml，按行搬运，
 # 见 内部设计记录 与 ADR-0044）。启动器只负责把工作台起起来。
-PATCH_ARGS=()
-
-# ── 声明工作台运行时的**可写根**（执行缝的沙箱只放行 process.cwd()）──────────
-#
-# 工作台自己要跑命令：启动体检自动装运行时、模块市场装/升插件、查源上新版。
-# 这些命令走 dsh 的执行缝，而那条缝带**文件沙箱**；插件发起的调用**没有会话**，
-# 回落到部署策略，出厂值是 `workspaceRoot: process.cwd()` —— 安装目标
-# `$DSH_HOME/workbench/...` 不在启动目录下，被拒写（EPERM），"自动装"死在第一步，
-# 界面只能退化成"让用户去终端抄一条命令"。这一层把可写根指到工作台运行时，
-# 那一整棵树（隔离工具链 + npm 缓存 + 模块专属文件夹 + 市场 prefix）就都放行了。
 #
-# 为什么是 `--patch` 叠加而不是改 profile 的 cordis.patch.yml：profile 可能是旧的
-# （交接出去的机器尤其如此），没人会回头重跑 seed；叠加层每次启动都生效。
-# ⚠️ 必须排在 profile 自己那一层**之后**：工作台的可写根要赢。
-SANDBOX_PATCH="$REPO_DIR/profile/sandbox.patch.yml"
-if [ -f "$SANDBOX_PATCH" ]; then
-  PATCH_ARGS+=(--patch "$SANDBOX_PATCH")
-else
-  echo "dsh-workbench: 提醒 —— 找不到 ${SANDBOX_PATCH}，这次不声明可写根（自动装会失败）。" >&2
-fi
-
-# DIY 工坊的目录必须**每次启动都在**：`cordis.patch.yml` 的 hmr 行把它列成一个监听根
-# （工坊里的模块是被 link 进 profile 的仓外目录，Node 解析到的是工坊里的真路径，
-# 所以不把它列进去，模块重建 dist/host.js 就不热换 —— 而且**不报错**）。
-# chokidar 对不存在的根收不到事件，所以这里保住它，不必等用户重跑 setup。
-# 只建目录：骨架与依赖是 seed-profile.sh 第 6 步的事。
+# 工坊骨架 / `dsh-wb-module` 入口 / DIY 指引软链 / 隔离运行时的稳定入口：**一个写口**，
+# 全在宿主自举里（`runtime.seed()` → `scripts/seed-workshop.sh`），三条安装路径每次启动都跑它
+# （独立实例 / `dsh web` / Desktop 插进任意 profile 是同一份实现）。启动器在这里**只保目录**：
+# hmr 行把它当监听根，而 chokidar 对不存在的根收不到事件（模块重建 dist/host.js 就不热换，
+# 而且不报错）。骨架与依赖在建 profile 那一步装（`seed-profile.sh` → `seed-workshop.sh` 完整档）。
 mkdir -p "$WORKBENCH_HOME/diy/packages"
 
-# 工坊的**稳定入口**：每次启动都重写一遍（幂等、几乎不花时间），挂进 PATH。
-# 于是 agent 在工坊里（或任何目录里）都能直接叫 `dsh-wb-module`，不必记着 `pnpm exec` 前缀 ——
-# 指令里那句"工坊里没有全局 dsh-wb-module"是**旧**状态，现在有一个我们自己的转发脚本。
-bash "$REPO_DIR/scripts/seed-workshop.sh" entry || true
-export PATH="$WORKBENCH_HOME/bin:$PATH"
-
-# 骨架不在就**当场建**（不是只提醒）：工坊看着"能用"，可模块的 build / check 会把
-# "不在 workspace 里"说成"声明写错了"——实测就是在这一步卡住过（干净机器上 seed 第 6 步没跑）。
-# 提醒是对人说的，而先撞上它的是 agent：它读到的报错指着别的地方，于是开始自由发挥。
-if [ ! -f "$WORKBENCH_HOME/diy/package.json" ]; then
-  bash "$REPO_DIR/scripts/seed-workshop.sh" || {
-    echo "dsh-workbench: 提醒 —— DIY 工坊的骨架没建起来（$WORKBENCH_HOME/diy/package.json）。" >&2
-    echo "  跑一次 dsh-workbench setup；在那之前工坊里的模块 build / check 都会报错。" >&2
-  }
-fi
-
-# 工坊**自己带着** DIY 的指引（软链到随包出货的那份 `skills/workbench-module-diy/`）。
-# 这条链**不在这里挂** —— 写口只有一处，在 `scripts/seed-workshop.sh` 的 `link_workshop_skills`
-# （上面那次 `entry` 已经跑过它）。为什么收成一处：启动器与宿主自举都跑那个脚本，从前两处
-# 各写一遍（这里一段 bash + 宿主 TS 的 `linkSkills`），目标虽一致，却是**同一件事两个实现** ——
-# 哪天只有一边改了源或判据就会互相改指，而软链指到哪 skill 发现都**不报错**。
-# 运行时的**稳定入口**不在这里建：它属于适配器（隔离包装随适配器出货），
-# 由宿主自举在每次启动时写到自己的隔离根里 —— 写口只有那一处。
-# ⚠️ 顺序有讲究：`--patch` 是 **dsh 本体**的选项，必须排在 `--port`（应用参数）**之前** ——
-# 参数一旦进了应用的透传区（第一个应用自己的选项开始），后面的都直接交给应用，
-# `--patch` 会被应用当成未知选项（实测：`--port` 在前时报 `unknown option '--patch'`）。
-exec dsh "$PROFILE" ${PATCH_ARGS[@]+"${PATCH_ARGS[@]}"} --port "$PORT" ${DSH_ARGS[@]+"${DSH_ARGS[@]}"}
+exec dsh "$PROFILE" --port "$PORT" ${DSH_ARGS[@]+"${DSH_ARGS[@]}"}

package/client.js

@@ -3595,9 +3595,8 @@ window.__ModuleLoader__.load({
       	"env.title": "Preparing the workbench",
       	"env.checking": "Getting the runtime ready…",
       	"env.installing": "Installing background tools — the first run takes a moment…",
-      	"env.installingToolchain": "Installing the workbench’s own npm / pnpm — the first run downloads them, so it can take a while.",
+      	"env.installingToolchain": "Installing the workbench’s own pnpm — the first run downloads it, so it can take a while.",
       	"env.failed": "One step away",
-      	"env.elapsed": "Waiting {seconds}s",
       	"env.stepFailed.install": "install failed",
       	"env.stepFailed.path": "installed but not found",
       	"env.stepFailed.shell": "cannot reach the command line",
@@ -3616,14 +3615,15 @@ window.__ModuleLoader__.load({
       	"env.fix.whyShell": "The workbench cannot reach the command line on this machine, so it cannot fetch data — you cannot install this from here; someone needs to fix the background environment.",
       	"env.fix.whyHost": "The workbench runs a few checks on the command line and collects what they return; this time the command went out and nothing came back. The tools themselves are most likely fine — reinstalling Node / npm / pnpm will not help.",
       	"env.fix.step": "Run this in a terminal, then hit Retry:",
+      	"env.fix.stepRetry": "Hit Retry to try again; if it still fails you can enter the workbench anyway and restart it once the install succeeds.",
       	"env.fix.stepPath": "Open a new terminal window (or make sure npm’s global bin directory is on PATH), then hit Retry.",
       	"env.fix.stepShell": "Restart the workbench (or dsh); if it keeps happening, the workbench still cannot reach the command line.",
       	"env.fix.stepHost": "Quit the workbench completely (including the tray icon), clear the dsh-* leftovers in the system temp folder, then open it again. If it keeps happening, update dsh.",
       	"env.fix.permission": "Permission denied: rerun with sudo, or point npm’s global directory at your home.",
       	"env.fix.network": "Network unreachable: check your network or proxy, then retry.",
       	"env.fix.details": "Details (for troubleshooting)",
-      	"env.log": "Detailed output",
       	"env.retry": "Retry",
+      	"env.failed.continue": "Enter workbench anyway",
       	"env.wake": "Open browser",
       	"env.wake.opening": "Opening the browser…",
       	"env.wake.browserOpen": "The browser is already running but the extension is not connected — check that it is enabled.",
@@ -4365,9 +4365,8 @@ window.__ModuleLoader__.load({
       		"env.title": "准备工作台",
       		"env.checking": "正在准备运行环境…",
       		"env.installing": "正在安装后台工具，第一次会慢一点…",
-      		"env.installingToolchain": "正在装工作台自己那份 npm / pnpm —— 第一次要下载，慢一点正常。",
+      		"env.installingToolchain": "正在装工作台自己那份 pnpm —— 第一次要下载，慢一点正常。",
       		"env.failed": "还差一步就能用了",
-      		"env.elapsed": "已等待 {seconds} 秒",
       		"env.stepFailed.install": "装不上",
       		"env.stepFailed.path": "装了但还找不到",
       		"env.stepFailed.shell": "连不上命令行",
@@ -4386,14 +4385,15 @@ window.__ModuleLoader__.load({
       		"env.fix.whyShell": "工作台拿不到这台机器的命令行，所以取不了数据 —— 这一步你装不了，需要有人处理后台环境。",
       		"env.fix.whyHost": "工作台要靠命令行跑几条检查，再把结果收回来；这次命令发出去了，结果一直没回来。工具本身多半是好的 —— 重装 Node / npm / pnpm 不会有帮助。",
       		"env.fix.step": "在终端里运行下面这条命令，装好之后点「重试」：",
+      		"env.fix.stepRetry": "点「重试」再装一次；还装不上也可以先进入工作台 —— 装好之后重启工作台就会用上。",
       		"env.fix.stepPath": "新开一个终端窗口（或确认 npm 的全局 bin 目录在 PATH 里），然后点「重试」。",
       		"env.fix.stepShell": "重启一次工作台（或 dsh）；如果反复出现，说明工作台还是拿不到命令行。",
       		"env.fix.stepHost": "完全退出工作台（托盘图标也要退），清掉系统临时目录里 dsh- 开头的残留，再重新打开；反复出现就升级 dsh。",
       		"env.fix.permission": "权限不够：在命令前加 sudo 重跑，或先把 npm 的全局目录配到你的用户目录。",
       		"env.fix.network": "网络不通：检查网络或代理设置后重试。",
       		"env.fix.details": "详细输出（排障用）",
-      		"env.log": "详细输出",
       		"env.retry": "重试",
+      		"env.failed.continue": "先进入工作台",
       		"env.wake": "打开浏览器",
       		"env.wake.opening": "正在打开浏览器…",
       		"env.wake.browserOpen": "浏览器已经开着，但扩展没连上 —— 检查扩展是否启用。",
@@ -13018,10 +13018,16 @@ window.__ModuleLoader__.load({
       }
       //#endregion
       //#region src/app/units/manifests.ts
+      var DEFAULT_RETRY_DELAY_MS = 1e3;
+      var DEFAULT_MAX_RETRIES = 30;
       function createUnitManifestLoader(options = {}) {
       	let inFlight = false;
       	let queued = false;
       	let watching = false;
+      	let retries = 0;
+      	let timer = null;
+      	const retryDelayMs = options.retryDelayMs ?? DEFAULT_RETRY_DELAY_MS;
+      	const maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;
       	const subscribeFacts = options.subscribeFacts ?? subscribeFactRevision;
       	const load = async (registry) => {
       		if (inFlight) {
@@ -13029,11 +13035,23 @@ window.__ModuleLoader__.load({
       			return;
       		}
       		inFlight = true;
+      		let settled = false;
       		try {
       			const response = await apiGet(UNIT_MANIFESTS_ROUTE).catch(() => null);
-      			if (response?.ok === true && Array.isArray(response.manifests)) registry.setManifests(response.manifests, Array.isArray(response.installable) ? response.installable : void 0);
+      			if (response?.ok === true && Array.isArray(response.manifests)) {
+      				registry.setManifests(response.manifests, Array.isArray(response.installable) ? response.installable : void 0);
+      				settled = !registry.refusals().some((item) => item.kind === "no-manifest");
+      			}
       		} finally {
       			inFlight = false;
+      			if (settled) retries = 0;
+      			else if (retries < maxRetries && timer === null) {
+      				retries += 1;
+      				timer = setTimeout(() => {
+      					timer = null;
+      					load(registry);
+      				}, retryDelayMs);
+      			}
       			if (queued) {
       				queued = false;
       				load(registry);
@@ -13043,7 +13061,10 @@ window.__ModuleLoader__.load({
       	return (registry) => {
       		if (!watching) {
       			watching = true;
-      			subscribeFacts(factOfRoute(UNIT_MANIFESTS_ROUTE), () => void load(registry));
+      			subscribeFacts(factOfRoute(UNIT_MANIFESTS_ROUTE), () => {
+      				retries = 0;
+      				load(registry);
+      			});
       		}
       		load(registry);
       	};
@@ -13088,7 +13109,7 @@ window.__ModuleLoader__.load({
       	if (guidance === "host") return t("env.stepFailed.host");
       	return t("env.stepFailed.install");
       }
-      function guidanceTextOf(guidance, t) {
+      function guidanceTextOf(guidance, t, hasCommand = true) {
       	if (guidance === "path") return {
       		why: t("env.fix.whyPath"),
       		step: t("env.fix.stepPath")
@@ -13103,7 +13124,7 @@ window.__ModuleLoader__.load({
       	};
       	return {
       		why: t("env.fix.why"),
-      		step: t("env.fix.step")
+      		step: hasCommand ? t("env.fix.step") : t("env.fix.stepRetry")
       	};
       }
       function stepDetailText(step, snapshot, t) {
@@ -13128,6 +13149,19 @@ window.__ModuleLoader__.load({
       	};
       	return { text: t("env.bridge.unknown") };
       }
+      function bridgeAdviceLines(issues, t, fixes) {
+      	const listed = issues.length === 0 ? ["unknown"] : issues;
+      	const seen = /* @__PURE__ */ new Set();
+      	const out = [];
+      	for (const issue of listed) {
+      		const advice = bridgeAdvice(issue, t, fixes);
+      		const key = `${advice.text}|${advice.link?.href ?? ""}`;
+      		if (seen.has(key)) continue;
+      		seen.add(key);
+      		out.push(advice);
+      	}
+      	return out;
+      }
       //#endregion
       //#region src/app/layouts/env-gate/gate-deadline.ts
       function createGateDeadline(giveUpMs, expire) {
@@ -13288,8 +13322,10 @@ window.__ModuleLoader__.load({
       	const buttons = el("div", BootGate_module_default.buttons);
       	const retry = el("button", BootGate_module_default.button, t("env.retry"));
       	retry.setAttribute("type", "button");
+      	const failedSkip = el("button", BootGate_module_default.button, t("env.failed.continue"));
+      	failedSkip.setAttribute("type", "button");
       	const fixCommand = commandRow(t);
-      	buttons.append(retry);
+      	buttons.append(retry, failedSkip);
       	actions.append(fixTitle, fixWhy, fixStep, fixCommand.row, fixAdvice, buttons);
       	const bridge = el("div", BootGate_module_default.bridge);
       	bridge.hidden = true;
@@ -13333,6 +13369,8 @@ window.__ModuleLoader__.load({
       	let cancelled = false;
       	const forcePlan = createForcePlan();
       	let pinned = null;
+      	let lastSnapshot = null;
+      	let runtimeProfile;
       	function close() {
       		if (closed) return;
       		closed = true;
@@ -13389,6 +13427,7 @@ window.__ModuleLoader__.load({
       		return row;
       	}
       	function render(snapshot) {
+      		lastSnapshot = snapshot;
       		wakeNote.hidden = true;
       		if (bootHintShown && (snapshot.phase !== "idle" || snapshot.steps.length > 0)) {
       			bootHintShown = false;
@@ -13429,10 +13468,10 @@ window.__ModuleLoader__.load({
       		bridgeRetry.removeAttribute("disabled");
       		const commandText = snapshot.steps.find((step) => step.status === "failed" && step.command !== void 0)?.command;
       		const guidance = snapshot.guidance ?? "install";
-      		const advice = guidanceTextOf(guidance, t);
+      		const showCommand = guidance === "install" && commandText !== void 0;
+      		const advice = guidanceTextOf(guidance, t, showCommand);
       		fixWhy.textContent = advice.why;
       		fixStep.textContent = advice.step;
-      		const showCommand = guidance === "install" && commandText !== void 0;
       		fixCommand.set(showCommand ? commandText : void 0);
       		fixAdvice.textContent = !showCommand ? "" : snapshot.failure === "permission" ? t("env.fix.permission") : snapshot.failure === "network" ? t("env.fix.network") : "";
       		const bridgeStep = snapshot.steps.find((step) => step.id === "bridge");
@@ -13440,9 +13479,7 @@ window.__ModuleLoader__.load({
       		const bridgeBroken = bridgeIssues.length > 0 || bridgeStep !== void 0 && (bridgeStep.status === "warn" || bridgeStep.status === "failed");
       		bridge.hidden = !bridgeBroken;
       		if (bridgeBroken) {
-      			const listed = bridgeIssues.length === 0 ? ["unknown"] : bridgeIssues;
-      			bridgeLines.replaceChildren(...listed.map((issue) => {
-      				const advice = bridgeAdvice(issue, t, runtimeProfileValue()?.bridge);
+      			bridgeLines.replaceChildren(...bridgeAdviceLines(bridgeIssues, t, runtimeProfile?.bridge ?? runtimeProfileValue()?.bridge).map((advice) => {
       				const item = el("li", BootGate_module_default.bridgeLine, advice.text);
       				if (advice.link !== void 0) {
       					const link = document.createElement("a");
@@ -13524,6 +13561,7 @@ window.__ModuleLoader__.load({
       		wakeNote.hidden = false;
       	}
       	retry.addEventListener("click", retryNow);
+      	failedSkip.addEventListener("click", close);
       	bridgeWake.addEventListener("click", () => void wakeBrowserNow());
       	bridgeRetry.addEventListener("click", retryNow);
       	bridgeSkip.addEventListener("click", close);
@@ -13541,6 +13579,11 @@ window.__ModuleLoader__.load({
       		} });
       		if (strip !== null) overlay.append(strip);
       	}
+      	readRuntimeCapabilities().then((answer) => {
+      		runtimeProfile = answer.ok ? answer.runtimeProfile ?? void 0 : void 0;
+      		if (pinned !== null) render(pinned);
+      		else if (lastSnapshot !== null) render(lastSnapshot);
+      	}).catch(() => void 0);
       	poll();
       	return { close };
       }

package/cordis.patch.yml

@@ -134,12 +134,11 @@
 # `file-upload` 注销 resolver 赛跑 —— 启用当场把 session-controller 打成 failed，
 # 之后每次新建会话都是 `gateway/service-unavailable`（连 toggle 都救不回来，只能重启）。
 #
-# 证据与 A/B：ADR-0037 的 2026-10-22 补记。自带 profile 的可写根仍有两处：启动器每次启动
-# 叠的 `--patch profile/sandbox.patch.yml`，以及 `profile/isolation.patch.yml` 里同值的那一行
-# （seed-profile.sh 追加进 profile，给不带启动器的 `dsh workbench`）。装进别人的 profile 时，
-# 请把那一行写进那个 profile 的 `cordis.patch.yml` 再**重启**（在线写同一行也会撞同一个竞态）。
-# 少了它只会让"无会话的插件命令"被沙箱挡，不会再动会话接口；宿主启动时会就此打一条 warn
-# （见 runtime-seed 的 coversWritableRoot）。
+# 现在可写根由**产品代码自己声明**（`src/shared/api/host/workbench-shell.ts` 的
+# `provideWorkbenchShell`：`mode: 'workspace-write'`、`workspaceRoot: dshHome()`），
+# 既不在 bundle、也不在 profile、也不需要启动器的 `--patch`：三条安装路径
+# （独立实例 / `dsh web` / Desktop 插件页）行为一致。
+# 证据与 A/B：ADR-0037 的 2026-10-22 补记；宿主启动时会打一行 info 说明实际可写根。
 
 - insert:
     - id: workbench

package/dist/client/client.body.js

@@ -3588,9 +3588,8 @@ var en = {
 	"env.title": "Preparing the workbench",
 	"env.checking": "Getting the runtime ready…",
 	"env.installing": "Installing background tools — the first run takes a moment…",
-	"env.installingToolchain": "Installing the workbench’s own npm / pnpm — the first run downloads them, so it can take a while.",
+	"env.installingToolchain": "Installing the workbench’s own pnpm — the first run downloads it, so it can take a while.",
 	"env.failed": "One step away",
-	"env.elapsed": "Waiting {seconds}s",
 	"env.stepFailed.install": "install failed",
 	"env.stepFailed.path": "installed but not found",
 	"env.stepFailed.shell": "cannot reach the command line",
@@ -3609,14 +3608,15 @@ var en = {
 	"env.fix.whyShell": "The workbench cannot reach the command line on this machine, so it cannot fetch data — you cannot install this from here; someone needs to fix the background environment.",
 	"env.fix.whyHost": "The workbench runs a few checks on the command line and collects what they return; this time the command went out and nothing came back. The tools themselves are most likely fine — reinstalling Node / npm / pnpm will not help.",
 	"env.fix.step": "Run this in a terminal, then hit Retry:",
+	"env.fix.stepRetry": "Hit Retry to try again; if it still fails you can enter the workbench anyway and restart it once the install succeeds.",
 	"env.fix.stepPath": "Open a new terminal window (or make sure npm’s global bin directory is on PATH), then hit Retry.",
 	"env.fix.stepShell": "Restart the workbench (or dsh); if it keeps happening, the workbench still cannot reach the command line.",
 	"env.fix.stepHost": "Quit the workbench completely (including the tray icon), clear the dsh-* leftovers in the system temp folder, then open it again. If it keeps happening, update dsh.",
 	"env.fix.permission": "Permission denied: rerun with sudo, or point npm’s global directory at your home.",
 	"env.fix.network": "Network unreachable: check your network or proxy, then retry.",
 	"env.fix.details": "Details (for troubleshooting)",
-	"env.log": "Detailed output",
 	"env.retry": "Retry",
+	"env.failed.continue": "Enter workbench anyway",
 	"env.wake": "Open browser",
 	"env.wake.opening": "Opening the browser…",
 	"env.wake.browserOpen": "The browser is already running but the extension is not connected — check that it is enabled.",
@@ -4358,9 +4358,8 @@ var dictionaries = {
 		"env.title": "准备工作台",
 		"env.checking": "正在准备运行环境…",
 		"env.installing": "正在安装后台工具，第一次会慢一点…",
-		"env.installingToolchain": "正在装工作台自己那份 npm / pnpm —— 第一次要下载，慢一点正常。",
+		"env.installingToolchain": "正在装工作台自己那份 pnpm —— 第一次要下载，慢一点正常。",
 		"env.failed": "还差一步就能用了",
-		"env.elapsed": "已等待 {seconds} 秒",
 		"env.stepFailed.install": "装不上",
 		"env.stepFailed.path": "装了但还找不到",
 		"env.stepFailed.shell": "连不上命令行",
@@ -4379,14 +4378,15 @@ var dictionaries = {
 		"env.fix.whyShell": "工作台拿不到这台机器的命令行，所以取不了数据 —— 这一步你装不了，需要有人处理后台环境。",
 		"env.fix.whyHost": "工作台要靠命令行跑几条检查，再把结果收回来；这次命令发出去了，结果一直没回来。工具本身多半是好的 —— 重装 Node / npm / pnpm 不会有帮助。",
 		"env.fix.step": "在终端里运行下面这条命令，装好之后点「重试」：",
+		"env.fix.stepRetry": "点「重试」再装一次；还装不上也可以先进入工作台 —— 装好之后重启工作台就会用上。",
 		"env.fix.stepPath": "新开一个终端窗口（或确认 npm 的全局 bin 目录在 PATH 里），然后点「重试」。",
 		"env.fix.stepShell": "重启一次工作台（或 dsh）；如果反复出现，说明工作台还是拿不到命令行。",
 		"env.fix.stepHost": "完全退出工作台（托盘图标也要退），清掉系统临时目录里 dsh- 开头的残留，再重新打开；反复出现就升级 dsh。",
 		"env.fix.permission": "权限不够：在命令前加 sudo 重跑，或先把 npm 的全局目录配到你的用户目录。",
 		"env.fix.network": "网络不通：检查网络或代理设置后重试。",
 		"env.fix.details": "详细输出（排障用）",
-		"env.log": "详细输出",
 		"env.retry": "重试",
+		"env.failed.continue": "先进入工作台",
 		"env.wake": "打开浏览器",
 		"env.wake.opening": "正在打开浏览器…",
 		"env.wake.browserOpen": "浏览器已经开着，但扩展没连上 —— 检查扩展是否启用。",
@@ -13011,10 +13011,16 @@ function createClientUnitRegistry(options = {}) {
 }
 //#endregion
 //#region src/app/units/manifests.ts
+var DEFAULT_RETRY_DELAY_MS = 1e3;
+var DEFAULT_MAX_RETRIES = 30;
 function createUnitManifestLoader(options = {}) {
 	let inFlight = false;
 	let queued = false;
 	let watching = false;
+	let retries = 0;
+	let timer = null;
+	const retryDelayMs = options.retryDelayMs ?? DEFAULT_RETRY_DELAY_MS;
+	const maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;
 	const subscribeFacts = options.subscribeFacts ?? subscribeFactRevision;
 	const load = async (registry) => {
 		if (inFlight) {
@@ -13022,11 +13028,23 @@ function createUnitManifestLoader(options = {}) {
 			return;
 		}
 		inFlight = true;
+		let settled = false;
 		try {
 			const response = await apiGet(UNIT_MANIFESTS_ROUTE).catch(() => null);
-			if (response?.ok === true && Array.isArray(response.manifests)) registry.setManifests(response.manifests, Array.isArray(response.installable) ? response.installable : void 0);
+			if (response?.ok === true && Array.isArray(response.manifests)) {
+				registry.setManifests(response.manifests, Array.isArray(response.installable) ? response.installable : void 0);
+				settled = !registry.refusals().some((item) => item.kind === "no-manifest");
+			}
 		} finally {
 			inFlight = false;
+			if (settled) retries = 0;
+			else if (retries < maxRetries && timer === null) {
+				retries += 1;
+				timer = setTimeout(() => {
+					timer = null;
+					load(registry);
+				}, retryDelayMs);
+			}
 			if (queued) {
 				queued = false;
 				load(registry);
@@ -13036,7 +13054,10 @@ function createUnitManifestLoader(options = {}) {
 	return (registry) => {
 		if (!watching) {
 			watching = true;
-			subscribeFacts(factOfRoute(UNIT_MANIFESTS_ROUTE), () => void load(registry));
+			subscribeFacts(factOfRoute(UNIT_MANIFESTS_ROUTE), () => {
+				retries = 0;
+				load(registry);
+			});
 		}
 		load(registry);
 	};
@@ -13081,7 +13102,7 @@ function failedStepText(guidance, t) {
 	if (guidance === "host") return t("env.stepFailed.host");
 	return t("env.stepFailed.install");
 }
-function guidanceTextOf(guidance, t) {
+function guidanceTextOf(guidance, t, hasCommand = true) {
 	if (guidance === "path") return {
 		why: t("env.fix.whyPath"),
 		step: t("env.fix.stepPath")
@@ -13096,7 +13117,7 @@ function guidanceTextOf(guidance, t) {
 	};
 	return {
 		why: t("env.fix.why"),
-		step: t("env.fix.step")
+		step: hasCommand ? t("env.fix.step") : t("env.fix.stepRetry")
 	};
 }
 function stepDetailText(step, snapshot, t) {
@@ -13121,6 +13142,19 @@ function bridgeAdvice(issue, t, fixes) {
 	};
 	return { text: t("env.bridge.unknown") };
 }
+function bridgeAdviceLines(issues, t, fixes) {
+	const listed = issues.length === 0 ? ["unknown"] : issues;
+	const seen = /* @__PURE__ */ new Set();
+	const out = [];
+	for (const issue of listed) {
+		const advice = bridgeAdvice(issue, t, fixes);
+		const key = `${advice.text}|${advice.link?.href ?? ""}`;
+		if (seen.has(key)) continue;
+		seen.add(key);
+		out.push(advice);
+	}
+	return out;
+}
 //#endregion
 //#region src/app/layouts/env-gate/gate-deadline.ts
 function createGateDeadline(giveUpMs, expire) {
@@ -13281,8 +13315,10 @@ function createBootGate(ctx, options = {}) {
 	const buttons = el("div", BootGate_module_default.buttons);
 	const retry = el("button", BootGate_module_default.button, t("env.retry"));
 	retry.setAttribute("type", "button");
+	const failedSkip = el("button", BootGate_module_default.button, t("env.failed.continue"));
+	failedSkip.setAttribute("type", "button");
 	const fixCommand = commandRow(t);
-	buttons.append(retry);
+	buttons.append(retry, failedSkip);
 	actions.append(fixTitle, fixWhy, fixStep, fixCommand.row, fixAdvice, buttons);
 	const bridge = el("div", BootGate_module_default.bridge);
 	bridge.hidden = true;
@@ -13326,6 +13362,8 @@ function createBootGate(ctx, options = {}) {
 	let cancelled = false;
 	const forcePlan = createForcePlan();
 	let pinned = null;
+	let lastSnapshot = null;
+	let runtimeProfile;
 	function close() {
 		if (closed) return;
 		closed = true;
@@ -13382,6 +13420,7 @@ function createBootGate(ctx, options = {}) {
 		return row;
 	}
 	function render(snapshot) {
+		lastSnapshot = snapshot;
 		wakeNote.hidden = true;
 		if (bootHintShown && (snapshot.phase !== "idle" || snapshot.steps.length > 0)) {
 			bootHintShown = false;
@@ -13422,10 +13461,10 @@ function createBootGate(ctx, options = {}) {
 		bridgeRetry.removeAttribute("disabled");
 		const commandText = snapshot.steps.find((step) => step.status === "failed" && step.command !== void 0)?.command;
 		const guidance = snapshot.guidance ?? "install";
-		const advice = guidanceTextOf(guidance, t);
+		const showCommand = guidance === "install" && commandText !== void 0;
+		const advice = guidanceTextOf(guidance, t, showCommand);
 		fixWhy.textContent = advice.why;
 		fixStep.textContent = advice.step;
-		const showCommand = guidance === "install" && commandText !== void 0;
 		fixCommand.set(showCommand ? commandText : void 0);
 		fixAdvice.textContent = !showCommand ? "" : snapshot.failure === "permission" ? t("env.fix.permission") : snapshot.failure === "network" ? t("env.fix.network") : "";
 		const bridgeStep = snapshot.steps.find((step) => step.id === "bridge");
@@ -13433,9 +13472,7 @@ function createBootGate(ctx, options = {}) {
 		const bridgeBroken = bridgeIssues.length > 0 || bridgeStep !== void 0 && (bridgeStep.status === "warn" || bridgeStep.status === "failed");
 		bridge.hidden = !bridgeBroken;
 		if (bridgeBroken) {
-			const listed = bridgeIssues.length === 0 ? ["unknown"] : bridgeIssues;
-			bridgeLines.replaceChildren(...listed.map((issue) => {
-				const advice = bridgeAdvice(issue, t, runtimeProfileValue()?.bridge);
+			bridgeLines.replaceChildren(...bridgeAdviceLines(bridgeIssues, t, runtimeProfile?.bridge ?? runtimeProfileValue()?.bridge).map((advice) => {
 				const item = el("li", BootGate_module_default.bridgeLine, advice.text);
 				if (advice.link !== void 0) {
 					const link = document.createElement("a");
@@ -13517,6 +13554,7 @@ function createBootGate(ctx, options = {}) {
 		wakeNote.hidden = false;
 	}
 	retry.addEventListener("click", retryNow);
+	failedSkip.addEventListener("click", close);
 	bridgeWake.addEventListener("click", () => void wakeBrowserNow());
 	bridgeRetry.addEventListener("click", retryNow);
 	bridgeSkip.addEventListener("click", close);
@@ -13534,6 +13572,11 @@ function createBootGate(ctx, options = {}) {
 		} });
 		if (strip !== null) overlay.append(strip);
 	}
+	readRuntimeCapabilities().then((answer) => {
+		runtimeProfile = answer.ok ? answer.runtimeProfile ?? void 0 : void 0;
+		if (pinned !== null) render(pinned);
+		else if (lastSnapshot !== null) render(lastSnapshot);
+	}).catch(() => void 0);
 	poll();
 	return { close };
 }