@dsh-workbench/core 0.3.8 → 0.3.10

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) {
@@ -9894,7 +9912,7 @@ function stateOf(entry) {
 }
 function stateOfDependency(dep) {
 	switch (dep.status) {
-		case "ok": return "已装";
+		case "ok": return "已就绪";
 		case "outdated": return "有新版";
 		case "unsatisfied": return "版本不对";
 		case "missing": return "未装";
@@ -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/app/layouts/rightbar/market-rows.d.ts

@@ -5,7 +5,7 @@ import type { SharedRow } from './market-shared-rows';
 import type { CapabilityMap } from '../../../shared/hooks/use-capabilities';
 export type { MarketHintKey, MarketNote, MarketRow, MarketRowAction, MarketState, ModuleUpdate, } from './market-row-types';
 export type { SharedRow, SharedState } from './market-shared-rows';
-export { SHARED_DOT, SHARED_STATE_KEY, sharedActions, sharedRows } from './market-shared-rows';
+export { SHARED_STATE_KEY, sharedActions, sharedRows } from './market-shared-rows';
 export declare const MARKET_STATE_KEY: Readonly<Record<MarketState, string>>;
 export declare const MARKET_DOT: Readonly<Record<MarketState, 'ongoing' | 'done' | 'warning' | 'idle' | 'error'>>;
 export type ModuleUpdateMap = Readonly<Record<string, ModuleUpdate>>;

package/dist/types/app/layouts/rightbar/market-shared-rows.d.ts

@@ -3,7 +3,6 @@ import type { CapabilityMap } from '../../../shared/hooks/use-capabilities';
 import type { MarketRowAction } from './market-row-types';
 export type SharedState = 'checking' | 'installed' | 'outdated' | 'unsatisfied' | 'missing' | 'unchecked';
 export declare const SHARED_STATE_KEY: Readonly<Record<SharedState, string>>;
-export declare const SHARED_DOT: Readonly<Record<SharedState, 'ongoing' | 'done' | 'warning' | 'idle'>>;
 export interface SharedRow {
     readonly id: string;
     readonly kind: 'plugin' | 'lib';

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.10",
   "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.10"
   },
   "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 "→ 隔离层已存在，跳过"