@dsh-workbench/core 0.3.8 → 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

@@ -2781,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 应用商店装扩展",
@@ -2799,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": "这次没热上 —— 不影响用，面板第一次读取会自己补",
@@ -3225,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",
@@ -3243,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",
@@ -7799,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");
@@ -7894,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) {
@@ -7921,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);
@@ -7993,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;
@@ -8057,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;
@@ -8115,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;
@@ -8126,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);
@@ -8148,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) => {

package/dist/client/client.body.js

@@ -2774,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 应用商店装扩展",
@@ -2792,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": "这次没热上 —— 不影响用，面板第一次读取会自己补",
@@ -3218,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",
@@ -3236,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",
@@ -7792,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");
@@ -7887,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) {
@@ -7914,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);
@@ -7986,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;
@@ -8050,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;
@@ -8108,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;
@@ -8119,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);
@@ -8141,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) => {

package/dist/client/index.js

@@ -2777,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 应用商店装扩展",
@@ -2795,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": "这次没热上 —— 不影响用，面板第一次读取会自己补",
@@ -3221,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",
@@ -3239,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",
@@ -7795,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");
@@ -7890,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) {
@@ -7917,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);
@@ -7989,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;
@@ -8053,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;
@@ -8111,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;
@@ -8122,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);
@@ -8144,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) => {

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/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/docs/HANDOFF.md

@@ -19,7 +19,7 @@
 
 | #   | 东西                         | 为什么                                                                                                                               | 怎么有                                       |
 | --- | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------- |
-| 1   | `dsh`                        | 本体。本仓库在 `0.1.7-rc.2` 上验过                                                                                                   | `npm i -g @deepseek-ai/dsh`（公网 npm 上有） |
+| 1   | `dsh`                        | 本体。本仓库在 `0.2.1-rc.2` 上验过，**低于它的会被拒绝** —— 见第八节                                                                 | `npm i -g @deepseek-ai/dsh@latest`（公网 npm 上有） |
 | 2   | `node` + **`pnpm`**          | dsh 的 `plugin` 子命令（以及 web 的 Plugins 页）都是**转发给 pnpm** 的；没有 pnpm 会直接报 `dsh: pnpm was not found`                 | 各自装                                       |
 | 3   | 跑过一次 `dsh web`           | 走 A 需要它给出那个 profile；走 B 时 `setup` 拿 `~/.dsh/profiles/web` 当模板。没有它会**明确报错**，不会静默建出半个 profile          | `dsh web`                                    |
 | 4   | 一个能解析这个包的源         | 包在**公网 npm** 上，默认源即可。只有将来改发内网源时，才要 `npm config set @<scope>:registry …` + `npm login`（带 scope 的包只去 `.npmrc` 里给这个 scope 指的源找） | `npm view @dsh-workbench/core version` 出号即可 |
@@ -239,9 +239,26 @@ manifest；彩排结束、以及「零上传」的失败，都会自动回滚。
 
 ## 八、版本与兼容（实话）
 
-`package.json` 的 `peerDependencies` 里**没有** `@deepseek-ai/dsh`，这是有意的：
-dsh 现在发的是预发布（npm 的 `next` 频道；本仓**验过的**是 `0.2.1-rc.2`，2026-10-18），
-声明范围会让版本不一致的人**装不上**；不声明则是"谁都能装，坏了当场知道"。
+外壳在 `package.json` 里声明了 **`engines.dsh: ">=0.2.1-rc.2"`**（本仓验过的那一代，2026-10-18）。
+这条声明是后补的，来历见
+[`.scratch/dsh-version-floor/spec.md`](../../../.scratch/dsh-version-floor/spec.md)：真实用户装了
+`dsh 0.2.0-rc.2`（当时 npm `latest` 还是它）+ 工作台，工作台照常起得来，**只有 DIY 模式整个不见、
+一句错都不报** —— `preset/diy.patch.yml` 是从 dsh 0.2.1-rc.2 那份 `standard.patch.yml` 派生的，
+里面一行 `tool-schedule` 在 0.2.0 上根本不存在，preset 挂不起来；而 dsh 的模式选择器**只列挂得起来的**
+（healthy presets only），于是"工作台 DIY"从用户面前消失。同一代的 `uiWorkspace.startSession()`
+也**不收** `agentPreset`（0.2.1-alpha.3 才收），所以这不是"少一把工具"的降级档，是 DIY 模式整块不可用。
+
+因此**声明一个下限**（而不是"谁都能装"）：dsh 自 `0.2.1-alpha.4` 起预检**先读 `engines.dsh`**
+（声明了它，peer 就被整体忽略；写 `workspace:` 一律判不兼容；`engines` 不是对象或 `engines.dsh`
+不是字符串会让清单不可读并**直接拒绝**），不满足就拒绝安装，
+可用 `dsh plugin --profile workbench allow-version <包@版本> --dsh-version <版本> --accept-risk` 豁免。
+旧到不认识 `engines.dsh` 的 dsh（0.2.0 及更早只读 `peerDependencies`）由**启动器那道硬门禁**兜
+（`bin/dsh-workbench`，与"bundle 没被选中"同一档：拒绝启动 + 打印升级命令）。
+
+⚠️ **别把下限改写成 `peerDependencies['@deepseek-ai/dsh']`**：pnpm 的 `auto-install-peers`
+（v11 实测：连 `peerDependenciesMeta.optional` 的 peer 也照装）会把**整套 dsh**拖进 profile。
+下限只有一处真相（`package.json` 的 `engines.dsh`），启动器读它、不另写版本号 —— selfcheck 有一条判据
+钉着"下限 = `@deepseek-ai/dsh-client-ui-primitives` 那个 pin"。
 
 代价要清楚：工作台依赖 dsh 的注入面（`@deepseek-ai/dsh-client-ui-slots`、
 `@deepseek-ai/dsh-client-locale`，见 `dsh.client.inject`）与一批**按名字取的服务**
@@ -253,20 +270,8 @@ dsh 现在发的是预发布（npm 的 `next` 频道；本仓**验过的**是 `0
 **devDependency 里的 `@deepseek-ai/dsh-client-ui-primitives` 跟着"验过的 dsh 版本"走**
 （[ADR-0028 §4.1](../../../docs/adr/0028-workbench-ui-uses-dsh-primitives.md)）：它只出类型，
 但类型比运行时旧一代，编译期就替不了你把关。当前两份都钉 `0.2.1-rc.2`
-（`packages/workbench` / `packages/shared`；改完要跑一次 `pnpm install` 更新 `pnpm-lock.yaml`）。
-
-想改成"装的时候就拦住"，在 `package.json` 里声明：
-
-```json
-"peerDependencies": { "@deepseek-ai/dsh": "^0.2.1-rc.2" }
-```
-
-dsh 会用这条做**安装预检**，不满足就拒绝安装，
-可用 `dsh plugin --profile workbench allow-version <包@版本> --dsh-version <版本> --accept-risk` 豁免。
-**自 0.2.1-alpha.4 起预检先读包自己的 `engines.dsh`**：声明了它，上面这条 peer 就被整体忽略
-（只有没有 `engines.dsh` 时才看 peer；`engines.dsh` 里写 `workspace:` 一律判不兼容，
-`engines` 不是对象或 `engines.dsh` 不是字符串会让清单不可读并**直接拒绝**）。要支持一段 dsh 版本，
-写 `engines.dsh` 比写 peer 更直接。
+（`packages/workbench` / `packages/shared`；改完要跑一次 `pnpm install` 更新 `pnpm-lock.yaml`），
+**升这一份时要连 `engines.dsh` 一起升**（selfcheck 那条判据把两者钉在一起）。
 
 > `NPM_REGISTRY` 是**你们自己的**内网 npm 源地址（形如 `https://<源主机>/<路径>/`）。
 > 本仓不写它：开源包里不该出现任何内网地址。

package/docs/OPERATIONS.md

@@ -26,6 +26,9 @@
 `OPENCLI_PIN` 锁），但它连的 **daemon 是整机一个** —— 见下面「隔离边界」。
 
 前提：`dsh` 和 `pnpm` 在 PATH 上（`dsh plugin` 是转发给 pnpm 的），
+**`dsh` 不低于验过的那一代**（`engines.dsh`；旧到不认识它的 dsh 由启动器当场拒绝并给
+`npm i -g @deepseek-ai/dsh@latest` —— 低于它的 dsh 上 DIY 模式整个不出现且不报错，见
+[`.scratch/dsh-version-floor/spec.md`](../../../.scratch/dsh-version-floor/spec.md)），
 且 `~/.dsh/profiles/web` 已存在（跑过一次 `dsh web` 即可）—— seed 拿它当**模板**
 （bundle 清单），之后也是「配置同步」的默认来源。
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-workbench/core",
-  "version": "0.3.8",
+  "version": "0.3.9",
   "description": "个人工作台：Agent 工作台外壳（左栏 + 常驻对话 + 自研右侧数据面板）。",
   "type": "module",
   "icon": "./icon.svg",
@@ -62,6 +62,10 @@
       ]
     }
   },
+  "//engines": "DIY 模式（preset/diy.patch.yml）是从 **dsh 出厂那份 standard.patch.yml** 派生的，所以这份外壳只跟着它派生的那一代 dsh 走：dsh 太旧时那个 preset 挂不起来，而 dsh 的模式选择器**只列挂得起来的** ⇒ 用户面前「工作台 DIY」整个不见，一句错都不报（实测 0.2.0-rc.2：缺 dsh-tool-schedule）。这里声明下限，让 dsh 自己的兼容性预检在**装的时候**拒绝（自 0.2.1-alpha.4 起 engines.dsh 优先于 peer）。⚠️ **不写 peerDependencies['@deepseek-ai/dsh']**：pnpm 的 auto-install-peers（v11 连 optional 也装）会把整套 dsh 拖进 profile。旧到不认识 engines.dsh 的 dsh（0.2.0 及更早）由启动器那道硬门禁兜 —— 见 bin/dsh-workbench。判据：selfcheck 的「声明下限 = 验过的 dsh 版本」那条。",
+  "engines": {
+    "dsh": ">=0.2.1-rc.2"
+  },
   "peerDependencies": {
     "react": "*"
   },
@@ -87,7 +91,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@dsh-workbench/shared": "0.3.8"
+    "@dsh-workbench/shared": "0.3.9"
   },
   "scripts": {
     "build": "node scripts/build.mjs && node scripts/build-types.mjs",

package/scripts/seed-profile.sh

@@ -28,6 +28,12 @@ DST_PROFILE="$DSH_HOME/profiles/$PROFILE"
 PKG='@dsh-workbench/core'
 REPO_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
 GIT_TOP="$(git -C "$REPO_DIR" rev-parse --show-toplevel 2>/dev/null || true)"
+# 同 bin/dsh-workbench 那一处（那边写清了为什么）：`--show-toplevel` 只说明**某个祖先**是仓库，
+# 装出来的那份可能刚好落在某个仓库里（`$HOME` 是 dotfiles 仓库时最常见）—— 还要证明这份
+# package.json 本身被那个仓库跟踪，才算是仓库副本。
+if [ -n "$GIT_TOP" ] && ! git -C "$REPO_DIR" ls-files --error-unmatch package.json >/dev/null 2>&1; then
+  GIT_TOP=""
+fi
 ISOLATION="$REPO_DIR/profile/isolation.patch.yml"
 
 # `verify.sh` 留在**仓库根**（它证明的是"dsh web 未被动过 / 组合树差异 / 数据分家"，
@@ -134,6 +140,34 @@ fs.writeFileSync(process.env.WB_MANIFEST, JSON.stringify(wb, null, 2) + "\n");
 console.log("→ 已继承 web 的 bundle 列表: " + merged.join(", "));
 '
 
+# ── 第 2.5 步：修掉旧版启动器留下的"装出来的那份被当成仓库副本" ──────────
+#
+# 旧判据只问 `git rev-parse --show-toplevel`（"**某个祖先**是不是仓库"），于是包目录落在任何
+# 仓库里的机器（最常见：`$HOME` 是 dotfiles 仓库，而 npm/nvm 的前缀就在 `$HOME` 下）在 setup
+# 时会把**全局安装目录**以 `link:` 装进 profile —— 市场里工作台那一行因此说「这份是本仓正在
+# 开发的那一份，不从源上取。」（不比对源、不提示更新），而 `npm i -g …@latest` 还会悄悄换掉
+# profile 跑的东西。判据窄到只认那一个坏形状：**我自己是装出来的那份**（GIT_TOP 为空）
+# **且 profile 里那条 `link:` 指着的正是我自己这份目录** —— 指别处的 link:（用户自己链的）不动。
+if [ -z "$GIT_TOP" ] && [ -f "$DST_PROFILE/package.json" ]; then
+  WB_MANIFEST="$DST_PROFILE/package.json" WB_PKG="$PKG" WB_SELF="$REPO_DIR" \
+    WB_TARGET="$PKG@^$(node -p "require('$REPO_DIR/package.json').version" 2>/dev/null || echo 0)" \
+    node -e '
+const fs = require("node:fs");
+const path = require("node:path");
+const file = process.env.WB_MANIFEST;
+const manifest = JSON.parse(fs.readFileSync(file, "utf8"));
+const deps = manifest.dependencies ?? {};
+const spec = String(deps[process.env.WB_PKG] ?? "");
+if (!spec.startsWith("link:")) process.exit(0);
+const real = (p) => { try { return fs.realpathSync(p); } catch { return path.resolve(p); } };
+const target = path.resolve(path.dirname(file), spec.slice("link:".length));
+if (real(target) !== real(process.env.WB_SELF)) process.exit(0);
+manifest.dependencies = Object.assign({}, deps, { [process.env.WB_PKG]: process.env.WB_TARGET });
+fs.writeFileSync(file, JSON.stringify(manifest, null, 2) + "\n");
+console.log("→ profile 里那条 link: 指的是我这份装出来的副本（旧启动器判错的产物）—— 已改回 " + process.env.WB_TARGET);
+'
+fi
+
 # ── 第 3 步：追加会话 / 存储 / 附件隔离层 ───────────────────────────────
 if grep -q 'id: session-persistence-jsonl' "$DST_PATCH"; then
   echo "→ 隔离层已存在，跳过"