@dsh-workbench/core 0.3.7 → 0.3.9

package/README.md

@@ -23,7 +23,7 @@ dsh web (:3080)                       dsh workbench (:3081)
 
 | 要有 | 为什么 | 怎么有 |
 | --- | --- | --- |
-| `dsh` | 本体。本包在 `0.1.7-rc.2` 上验过 | `npm i -g @deepseek-ai/dsh` |
+| `dsh` | 本体。本包在 `0.2.1-rc.2` 上验过；**更旧的会被拒绝**（`engines.dsh`，旧到不认识它的 dsh 由启动器当场拒绝并给升级命令）—— DIY 模式是从那一代 dsh 的 preset 清单派生的，旧一代它会整个不出现且不报错 | `npm i -g @deepseek-ai/dsh@latest` |
 | `node` + `pnpm` | dsh 的 `plugin` 子命令是**转发给 pnpm** 的；没有 pnpm 会直接报 `dsh: pnpm was not found` | 各自装 |
 | 跑过一次 `dsh web` | `setup` 拿 `~/.dsh/profiles/web` 当模板（**bundle 清单**：这台机器上装了哪些 bundle），也是「配置同步」的默认来源。没有它会**明确报错**，不会静默建出半个 profile | `dsh web`，起来就行，然后 Ctrl-C |
 
@@ -111,6 +111,7 @@ npx @dsh-workbench/core                       # ② 起工作台，默认 :3081
 | 一切正常，但左栏是出厂样子、右边没有面板 | 工作台插件在 Settings 里被关了（见上一条 ⚠️）。**重启之后**启动器不会再让你拿到这种实例：它读到 `dsh.profile.bundles` 里没有它就直接拒绝启动，并打印 `./bin/dsh-workbench setup` |
 | 模型列表里只有出厂的几个、没有自己配的供应商 | 新装的 profile 不带设置（ADR-0044）：设置 → 「配置同步」→ 选来源 → 勾 `llm-` 那几行 → 同步（即生效）|
 | 「配置同步」里某一行说 `@x 还没装` | 那一行点名的包不在这个 profile 的 `node_modules` 里：`dsh plugin --profile workbench add @x`（或在模块市场装），（装完 dsh 会自行重组；它报 `restartReason` 时才重启）|
+| 左栏没有「工作台DIY」那一项、模式下拉里也没有「工作台 DIY」 | 多半是 dsh 太旧（DIY 模式是从 **dsh 0.2.1-rc.2** 的 preset 清单派生的；旧一代那个 preset 挂不起来，而 dsh 的模式选择器**只列挂得起来的** ⇒ 整个不见且不报错）。**启动体检会把它摆出来并停在那一页**（「检查 DIY 模式 · 挂不起来」+ 缺哪几行 + 升级命令 + 一颗「先进入工作台」）；启动器更早一步：dsh 太旧就直接拒绝启动/安装并打印 `npm i -g @deepseek-ai/dsh@latest`，装完**重启工作台**即可。想自己核对是哪一行挂不起来：`dsh` 的 设置 → 「Agent presets」里那一行会带红标与原因 |
 
 排障全表在仓库的 [`docs/OPERATIONS.md`](https://github.com/code-farmer-i/dsh-workbench/blob/main/packages/workbench/docs/OPERATIONS.md)；
 把工作台装到别人机器上的前置清单见 [`docs/HANDOFF.md`](https://github.com/code-farmer-i/dsh-workbench/blob/main/packages/workbench/docs/HANDOFF.md)。

package/bin/dsh-workbench

@@ -15,7 +15,9 @@
 #   · **仓库副本**（这个包落在一个 git 工作树里）：开发用。bundle 以 link 方式装本目录，
 #     改源码立刻生效（配合 `pnpm run dev`）。
 #   · **安装包**（从内网源下下来的）：`setup` 把 **registry 上那个包** 装进 profile。
-# 判据是「git 顶层在不在」—— `npm pack` 的产物里不含 .git（见 package.json 的 files）。
+# 判据是「**这个包的 package.json 被那个 git 顶层跟踪**」—— `npm pack` 的产物里不含 .git
+# （见 package.json 的 files）；只问"顶层在不在"不够：装出来的那份完全可能落在某个仓库里
+# （`$HOME` 是 dotfiles 仓库、而 npm 前缀就在 `$HOME` 下，实测踩过 —— 症状见下面 GIT_TOP 那段）。
 # ⚠️ 不能判 `$REPO_DIR/.git`：workspace 之后 .git 在**仓库根**，不在这个包里（实测踩过，
 #    判错的症状是"仓库副本却去源上装"，改源码不再生效，而且不报错）。
 
@@ -38,12 +40,76 @@ while [ -L "$SELF" ]; do
 done
 REPO_DIR="$(cd "$(dirname "$SELF")/.." && pwd -P)"
 GIT_TOP="$(git -C "$REPO_DIR" rev-parse --show-toplevel 2>/dev/null || true)"
+# `rev-parse --show-toplevel` 只说明"**某个祖先目录**是个仓库"—— 装出来的那份完全可能刚好落在
+# 某个仓库里：最常见的是 `$HOME` 本身就是 dotfiles 仓库，而 npm 的前缀（`~/.nvm/...`、
+# `~/.npm-global`…）就在 `$HOME` 下。那会把"装出来的那份"当成仓库副本，以 link 装进 profile：
+# 市场里工作台那一行会说「这份是本仓正在开发的那一份」，而 `npm i -g …@latest` 之后 profile
+# 指向的东西还会悄悄变。所以还得证明**这份 package.json 本身被那个仓库跟踪**（仓库副本才有的事；
+# 与 seed-workshop.sh 那条"工作树里真有 packages/workbench + packages/module-tools"同旨）。
+if [ -n "$GIT_TOP" ] && ! git -C "$REPO_DIR" ls-files --error-unmatch package.json >/dev/null 2>&1; then
+  GIT_TOP=""
+fi
 
 if ! command -v dsh >/dev/null 2>&1; then
   echo "dsh-workbench: PATH 上没有 dsh。先装：npm i -g @deepseek-ai/dsh" >&2
   exit 1
 fi
 
+# ── 硬门禁：dsh 太旧就别起（DIY 模式会整个不见，而且一句错都不报）────────────
+#
+# DIY 模式就是 `preset/diy.patch.yml` 那一行 agent preset，而它是**从 dsh 出厂那份
+# `standard.patch.yml` 派生的**（scripts/gen-diy-preset.mjs）—— 所以它跟的是**派生那一刻的
+# dsh**。dsh 旧到那份清单里有几个包它根本没有时（实测 0.2.0-rc.2 缺
+# `@deepseek-ai/dsh-tool-schedule`），preset 挂不起来；dsh 的模式选择器**只列挂得起来的**
+# （healthy presets only），于是「工作台 DIY」在用户面前整个消失，界面与终端都不吭声。
+# 同一代 dsh 0.2.0 的 `uiWorkspace.startSession()` 也**不收** `agentPreset`（0.2.1-alpha.3 才收），
+# 所以就算 preset 挂上了，「造一个模块」也落不到 DIY 模式 —— 这一档没有"少一把工具"的降级空间。
+#
+# 为什么门禁写在启动器、而不只写 package.json 的 `engines.dsh`：
+# engines.dsh 只有 **0.2.1-alpha.4 起**的 dsh 才读（见 HANDOFF §八），而这台机器上那份 dsh
+# 恰恰可能就是旧到不认识的（0.2.0-rc.2 只读 peerDependencies，而 peer 不能写 ——
+# pnpm 的 auto-install-peers 会把整套 dsh 拖进 profile）。所以旧 dsh 由这里兜。
+#
+# 下限只有一处真相：package.json 的 engines.dsh。这里只读它，别在这儿另写一个版本号。
+DSH_FLOOR="$(WB_MANIFEST="$REPO_DIR/package.json" node -e 'const p = require(process.env.WB_MANIFEST); const e = p.engines ?? {}; process.stdout.write(typeof e.dsh === "string" ? e.dsh : "");' 2>/dev/null || true)"
+DSH_VERSION="$(dsh --version 2>/dev/null | tr -d '[:space:]' | sed 's/^v//' || true)"
+
+if [ -n "$DSH_FLOOR" ] && [ -n "$DSH_VERSION" ]; then
+  # `>=X.Y.Z[-pre]` 一档：与 dsh 自己那条预检同一口径（semver + includePrerelease）。
+  # 认不出的下限形状就不拦 —— 这条是给用户的诊断门，权威仍是 dsh 自己的预检。
+  DSH_FLOOR="$DSH_FLOOR" DSH_VERSION="$DSH_VERSION" node -e '
+const floor = /^>=\s*(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?$/.exec((process.env.DSH_FLOOR ?? "").trim());
+const got = /^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?/.exec((process.env.DSH_VERSION ?? "").trim());
+if (floor === null || got === null) process.exit(0);
+const want = { nums: [+floor[1], +floor[2], +floor[3]], pre: floor[4] === undefined ? [] : floor[4].split(".") };
+const have = { nums: [+got[1], +got[2], +got[3]], pre: got[4] === undefined ? [] : got[4].split(".") };
+for (let i = 0; i < 3; i += 1) {
+  if (have.nums[i] !== want.nums[i]) process.exit(have.nums[i] > want.nums[i] ? 0 : 1);
+}
+if (have.pre.length === 0) process.exit(0);
+if (want.pre.length === 0) process.exit(1);
+for (let i = 0; i < Math.max(have.pre.length, want.pre.length); i += 1) {
+  const a = have.pre[i];
+  const b = want.pre[i];
+  if (a === undefined) process.exit(1);
+  if (b === undefined) process.exit(0);
+  const an = /^\d+$/.test(a);
+  const bn = /^\d+$/.test(b);
+  if (an && bn) { if (+a !== +b) process.exit(+a > +b ? 0 : 1); continue; }
+  if (an !== bn) process.exit(an ? 1 : 0);
+  if (a !== b) process.exit(a > b ? 0 : 1);
+}
+process.exit(0);
+' || DSH_FLOOR_GUARD=$?
+  if [ "${DSH_FLOOR_GUARD:-0}" -eq 1 ]; then
+    echo "dsh-workbench: 这台机器上的 dsh 是 ${DSH_VERSION}，这份外壳要 ${DSH_FLOOR}。" >&2
+    echo "  低于它时 DIY 模式（会话里的「工作台 DIY」）挂不起来，而 dsh 的模式选择器只列挂得起来的" >&2
+    echo "  —— 它会**整个不出现**，不报错。所以这里直接拒绝启动。" >&2
+    echo "  升级 dsh（再重启一次工作台）: npm i -g @deepseek-ai/dsh@latest" >&2
+    exit 1
+  fi
+fi
+
 pkg_version() {
   node -p "require('$REPO_DIR/package.json').version" 2>/dev/null || echo "0.0.0"
 }

package/client.js

@@ -559,6 +559,16 @@ window.__ModuleLoader__.load({
       	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。
@@ -2771,7 +2781,8 @@ window.__ModuleLoader__.load({
       		"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 应用商店装扩展",
@@ -2789,11 +2800,21 @@ window.__ModuleLoader__.load({
       		"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": "这次没热上 —— 不影响用，面板第一次读取会自己补",
@@ -3215,7 +3236,8 @@ window.__ModuleLoader__.load({
       		"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",
@@ -3233,11 +3255,21 @@ window.__ModuleLoader__.load({
       		"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",
@@ -7789,6 +7821,10 @@ window.__ModuleLoader__.load({
       		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");
@@ -7884,6 +7920,7 @@ window.__ModuleLoader__.load({
       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) {
@@ -7911,6 +7948,18 @@ window.__ModuleLoader__.load({
       		}
       	};
       }
+      /**
+      * 拿到这一拍之后门该怎么办：`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);
@@ -7983,13 +8032,32 @@ window.__ModuleLoader__.load({
       	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;
@@ -8047,7 +8115,7 @@ window.__ModuleLoader__.load({
       		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;
@@ -8105,6 +8173,15 @@ window.__ModuleLoader__.load({
       			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;
@@ -8116,19 +8193,22 @@ window.__ModuleLoader__.load({
       			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);
@@ -8138,6 +8218,9 @@ window.__ModuleLoader__.load({
       	}
       	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) => {
@@ -10837,17 +10920,19 @@ window.__ModuleLoader__.load({
       			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
@@ -11103,6 +11188,7 @@ window.__ModuleLoader__.load({
       		...context_chips_exports
       	},
       	lib: {
+      		longTaskIsLive,
       		MIN_BUSY_MS: 500,
       		blockerOfCapability,
       		blockerOfError,

package/dist/client/client.body.js

@@ -552,6 +552,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。
@@ -2764,7 +2774,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 应用商店装扩展",
@@ -2782,11 +2793,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": "这次没热上 —— 不影响用，面板第一次读取会自己补",
@@ -3208,7 +3229,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",
@@ -3226,11 +3248,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",
@@ -7782,6 +7814,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");
@@ -7877,6 +7913,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) {
@@ -7904,6 +7941,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);
@@ -7976,13 +8025,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;
@@ -8040,7 +8108,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;
@@ -8098,6 +8166,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;
@@ -8109,19 +8186,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);
@@ -8131,6 +8211,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) => {
@@ -10830,17 +10913,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
@@ -11096,6 +11181,7 @@ var kit = {
 		...context_chips_exports
 	},
 	lib: {
+		longTaskIsLive,
 		MIN_BUSY_MS: 500,
 		blockerOfCapability,
 		blockerOfError,