@dsh-workbench/core 0.2.6 → 0.2.8

package/dist/types/shared/api/bundle-install.d.ts

@@ -111,6 +111,7 @@ export interface WorkbenchVersion {
     readonly pkg: string;
     readonly installed: string;
     readonly latest?: string;
+    readonly running?: string;
     readonly local?: boolean;
 }
 export interface ModuleVersionsPayload {

package/dist/types/shared/api/config-sync.d.ts

@@ -22,13 +22,11 @@ export interface ConfigSyncSnapshot {
     readonly profiles: readonly ConfigSyncProfile[];
     readonly rows: readonly ConfigSyncRow[];
     readonly emptyProviders: boolean;
-    readonly restart: true;
     readonly reason?: string;
 }
 export interface ConfigSyncApplied {
     readonly written: readonly string[];
     readonly skipped: readonly string[];
-    readonly restart: true;
 }
 export interface ConfigSyncRequest {
     readonly source: string;

package/dist/types/shared/api/host/__tests__/post-channels.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/shared/api/host/__tests__/self-update.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/shared/api/host/bundle-manager.d.ts

@@ -5,6 +5,7 @@ export interface BundleManager {
     inspect(spec: string, registry?: BundleRegistry): Promise<BundleInspection | null>;
     install(request: BundleInstallRequest): Promise<BundleChange | null>;
     remove(name: string): Promise<BundleChange | null>;
+    setEnabled?(name: string, enabled: boolean): Promise<BundleChange | null>;
     cancel(requestId: string): Promise<BundleCancellation | null>;
 }
 export declare function readBundleManager(ctx: DshHostContext): BundleManager | undefined;

package/dist/types/shared/api/host/bundle-routes.d.ts

@@ -3,5 +3,5 @@ import { type RouteHandler } from '@dsh-workbench/shared/host';
 export declare function bundleRegistriesHandler(ctx: DshHostContext): RouteHandler;
 export declare function resetRefusalLog(): void;
 export declare function resetHoldLog(): void;
-export declare function moduleVersionsHandler(ctx: DshHostContext, shell: DshShell | undefined): RouteHandler;
+export declare function moduleVersionsHandler(ctx: DshHostContext, shell: DshShell | undefined, running?: string | undefined): RouteHandler;
 export declare function bundleInspectHandler(ctx: DshHostContext): RouteHandler;

package/dist/types/shared/api/host/config-sync.d.ts

@@ -1,4 +1,4 @@
-import type { RouteHandler } from '@dsh-workbench/shared/host';
+import type { PostResource, RouteHandler } from '@dsh-workbench/shared/host';
 import type { ConfigSyncRow, ConfigSyncSnapshot } from '../config-sync.js';
 export interface PatchBlock {
     readonly key: string;
@@ -39,8 +39,8 @@ export declare function configSyncApply(deps: ConfigSyncDeps, payload: unknown):
     ok: true;
     written: string[];
     skipped: string[];
-    restart: true;
 } | {
     ok: false;
     text: string;
 };
+export declare function configSyncAction(deps: ConfigSyncDeps): PostResource;

package/dist/types/shared/api/host/post-channels.d.ts

@@ -0,0 +1,18 @@
+import type { DshHostContext } from '@dsh-workbench/shared';
+import type { PostResource, PostWrite } from '@dsh-workbench/shared/host';
+import { type UnitsPlan } from './mount-units.js';
+export interface PostChannelDeps {
+    readonly ctx: DshHostContext;
+    readonly mounted: ReadonlyMap<string, {
+        readonly plan: UnitsPlan;
+    }>;
+    readonly facts: {
+        bump(names: readonly string[]): unknown;
+    };
+    readonly shellActions: readonly PostResource[];
+}
+export interface PostChannels {
+    rebind(wrote: (resource: string, write: PostWrite) => void): void;
+    dispose(): void;
+}
+export declare function createPostChannels(deps: PostChannelDeps): PostChannels;

package/dist/types/shared/api/host/self-update.d.ts

@@ -0,0 +1,45 @@
+import { spawn } from 'node:child_process';
+import { type SeedCommand } from './runtime-seed';
+export declare const SELF_UPDATE_STATES: readonly ["running", "ok", "rolled-back", "failed"];
+export type SelfUpdateState = (typeof SELF_UPDATE_STATES)[number];
+export interface SelfUpdatePaths {
+    readonly dir: string;
+    readonly script: string;
+    readonly marker: string;
+    readonly log: string;
+}
+export interface SelfUpdateRequest {
+    readonly dshHome: string;
+    readonly profile: string;
+    readonly pkg: string;
+    readonly from: string;
+    readonly to: string;
+    readonly pinned: boolean;
+}
+export interface SelfUpdateMarker extends SelfUpdateRequest {
+    readonly state: SelfUpdateState;
+    readonly version: string;
+    readonly at: string;
+}
+export interface SelfUpdatePlan {
+    readonly paths: SelfUpdatePaths;
+    readonly script: string;
+    readonly marker: SelfUpdateMarker;
+    readonly command: SeedCommand;
+}
+export interface SelfUpdateStart {
+    readonly started: boolean;
+    readonly paths: SelfUpdatePaths;
+    readonly forward: string;
+}
+export declare function runningVersionOf(moduleUrl: string): string | undefined;
+export declare function selfUpdatePaths(dshHome: string): SelfUpdatePaths;
+export declare function recoveryCommand(input: {
+    readonly profile: string;
+    readonly pkg: string;
+    readonly version: string;
+}): string;
+export declare function selfUpdateMarker(request: SelfUpdateRequest, state: SelfUpdateState, version: string, at: string): SelfUpdateMarker;
+export declare function selfUpdateScript(request: SelfUpdateRequest, paths: SelfUpdatePaths): string;
+export declare function planSelfUpdate(request: SelfUpdateRequest, now?: Date): SelfUpdatePlan;
+export declare function startSelfUpdate(request: SelfUpdateRequest, onError: (message: string) => void, spawnImpl?: typeof spawn): SelfUpdateStart;

package/docs/HANDOFF.md

@@ -67,7 +67,7 @@ npx @dsh-workbench/core
 
 - **要配什么就在 `:3081` 配**，落在 `profiles/workbench/cordis.patch.yml` —— 那是它唯一的那份设置文档；
 - **想用 web 那边已经配好的行**（模型供应商 / API key 引用 / 搜索源 / MCP）⇒ `:3081` →
-  `Meta+,` → 「配置同步」→ 选来源 `web` → 勾行 → 同步 → **重启工作台**。
+  `Meta+,` → 「配置同步」→ 选来源 `web` → 勾行 → 同步（即生效，不用重启）。
   它读的是那个 profile 的 `cordis.patch.yml`，按行搬，只搬**显式配过**的行；
   同 id 两边内容不同时**默认不覆盖**，要覆盖得自己勾；行点名的包没装会当场说出来。
 - **web 后来改了不会自动过来** —— 再打开这一页，那几行会重新以「差异」标签出现在这一页，拉一次即可。
@@ -77,7 +77,9 @@ npx @dsh-workbench/core
 Settings → 插件里把 `@dsh-workbench/core` 关掉后，工作台会**退化成原版 dsh web**：
 左栏回到出厂样式、右侧数据面板消失。这是**设计内的降级**（关掉 = 它那份 bundle patch
 整份不再应用，连里面的"禁用出厂左栏"也一并失效），**会话 / 面板配置 / 工作区数据都不丢**。
-恢复：插件页把开关拨回来（或按 `Meta+,` 打开设置）。别把它当成故障去重建 profile。
+恢复：插件页把开关拨回来（或按 `Meta+,` 打开设置）；**进程已经退了的**，启动器读到
+"bundle 没被选中"会直接拒绝启动并打印修复命令 —— 跑 `./bin/dsh-workbench setup` 补回来。
+别把它当成故障去重建 profile。
 
 顺带一条：即使关掉工作台，profile 里剩下那层差异（会话/存储/附件隔离）**仍然生效**
 —— 那是无害且想要的（数据继续分开）。另外启动器每次都会叠一层 `sandbox-policy`，把执行缝的
@@ -91,7 +93,12 @@ Settings → 插件里把 `@dsh-workbench/core` 关掉后，工作台会**退化
 2. 继承 web 的 **bundle 清单**（装没装东西 —— 安装范畴，走 `dsh plugin` 通路）；
 3. 追加**数据隔离层**（会话 / 存储 / 附件各走 `~/.dsh/workbench/**`）；
 4. `dsh plugin --profile workbench add @dsh-workbench/core` —— 走 **dsh 自己的**
-   安装通路（兼容性预检、profile 写锁、装完自动把 bundle 登记进 profile 清单）。
+   安装通路（兼容性预检、profile 写锁、装完自动把 bundle 登记进 profile 清单）；
+5. `./scripts/seed-profile.sh ensure-selected` —— **确保选中**：读 `dsh.profile.bundles`，
+   缺 `@dsh-workbench/core` 就补进去（等价于 dsh 的 `selectBundle(name, true)`，已经在里面
+   就一个字节不写）。为什么单列这一步：`dsh plugin add` 装完的登记**跳过已存在的依赖**，
+   所以重跑 setup（包已在清单里）时它不会补 bundle —— 那一档是静默的（起得来、侧边栏
+   没入口），现在启动器拿"选中"当硬门禁，这一步就是它给的修复命令。
 
 **设置不在这一步继承**（这里以前快照 web 的 patch、并继承被它点名的依赖）：新机器上
 `setup` 完的工作台**没有模型供应商**，第一次打开去 设置 → 「配置同步」拉一次即可 ——
@@ -188,7 +195,7 @@ manifest；彩排结束、以及「零上传」的失败，都会自动回滚。
 `pnpm publish` 的人兜底的（外壳那份 = 整仓门禁）；不关掉它们，pnpm 会在**彩排与真发各再跑
 一遍**整门禁 —— 一次发布就是 3 遍门禁 + 3 遍 vitest + 每个包多两轮构建（实测 pnpm 10.32.1：
 `--dry-run` 一样触发）。来历见
-[`.scratch/dsh-ui-alignment/spec.md`](../../../.scratch/dsh-ui-alignment/spec.md) §18.45。
+[`../../../.scratch/dsh-ui-alignment/issues/12-s18-pduiv2.md`](../../../.scratch/dsh-ui-alignment/issues/12-s18-pduiv2.md) §18.45。
 
 脚本把这几件事变成**硬失败**（都在任何上传之前）：
 
@@ -208,7 +215,7 @@ manifest；彩排结束、以及「零上传」的失败，都会自动回滚。
   自己拥有的转发脚本。这条由外壳 `selfcheck` 的判据钉着（门禁里跑）。
   这类错**本机复现不出来**，只在别人机器上炸
   （0.1.6 就是这么坏在 `seed-profile.sh: Permission denied` 上的，见
-  [`.scratch/dsh-ui-alignment/spec.md`](../../../.scratch/dsh-ui-alignment/spec.md) §18.41）。
+  [`.scratch/dsh-ui-alignment/issues/53-18-41-permission-denied-pnpm.md`](../../../.scratch/dsh-ui-alignment/issues/53-18-41-permission-denied-pnpm.md) §18.41）。
 
 ## 八、版本与兼容（实话）
 

package/docs/OPERATIONS.md

@@ -60,10 +60,10 @@
 | 开发（监听改动 + 起工作台） | `pnpm run dev` —— profile 不对会先 `setup`；`:3081` 已在跑就只监听 |
 | 换端口 | `WORKBENCH_PORT=3091 ./bin/dsh-workbench` |
 | 改工作台设置 | 在 `:3081` 的 Settings 页改，落在 `profiles/workbench/cordis.patch.yml`。**这是工作台唯一的那份设置文档**（没有别处叠在它上面），所以模型供应商 / 搜索源 / MCP 每一行都改得动 |
-| 用 web 那边已经配好的行 | `:3081` → `Meta+,` → 「配置同步」→ 选来源（默认 `web`）→ 勾行 → 同步 → **重启工作台**。只搬你在那个 profile 里**显式配过**的行；行点名的包没装时页面会说出来（ADR-0044） |
+| 用 web 那边已经配好的行 | `:3081` → `Meta+,` → 「配置同步」→ 选来源（默认 `web`）→ 勾行 → 同步（`dsh-hmr` 会重组，**不用重启**）。只搬你在那个 profile 里**显式配过**的行；行点名的包没装时页面会说出来（ADR-0044） |
 | 改 web 设置 | 在 `:3080` 改，落在 `profiles/web/cordis.patch.yml`。工作台**不会**再自动跟着变 —— 要就跟上面那条同步一次；不想跟就不动 |
 | 重建 profile | `mv ~/.dsh/profiles/workbench ~/.dsh/profiles/workbench.bak` 后重跑 seed |
-| **别在设置里关掉工作台** | Settings → 插件里 `@dsh-workbench/core` 那个开关**不要关**。关掉=把它从 profile 的 `bundles` 里移除 → 我们那份 bundle patch（含"禁用出厂左栏"）**整份不再应用** → 页面退化成**原版 dsh web**（左栏回来、右侧面板消失），**数据一个都不丢**。恢复：插件页把开关打开（左栏的「插件」入口也在；进不去设置就按 `Meta+,`）。实测过这条降级路径，不是推断 |
+| **别在设置里关掉工作台** | Settings → 插件里 `@dsh-workbench/core` 那个开关**不要关**。关掉=把它从 profile 的 `bundles` 里移除 → 我们那份 bundle patch（含"禁用出厂左栏"）**整份不再应用** → 页面退化成**原版 dsh web**（左栏回来、右侧面板消失），**数据一个都不丢**。恢复：进程还在时把开关打开（左栏的「插件」入口也在；进不去设置就按 `Meta+,`）；已经重启过的，启动器读到"没选中"会**直接拒绝启动**并给一条修复命令 —— 跑 `./bin/dsh-workbench setup`（幂等，把这一项补回 `dsh.profile.bundles`）即可。实测过这条降级路径，不是推断 |
 
 ## 开发循环（改完不用重启）
 
@@ -86,7 +86,8 @@ WORKBENCH_PORT=3091 pnpm run dev   # 换端口（监听与实例同一个端口
 | 浏览器 | Vite 重建 `client.js` → `dsh-client-hmr` 每 500ms stat-poll 到 mtime/大小变化 → `/plugins/events` 发 `rebuilt` → 浏览器作废旧模块、预取新包、换 fiber | 插件内的 React 状态会丢；会话 / 工作区 / 连接状态保留 |
 | 宿主 | Vite 重建 `dist/host/index.js` → `dsh-hmr` 按模块 realpath 匹配并重载插件 | 插件重建，进程与其它插件不受影响 |
 
-**只有这两种改动要重启**：`cordis.patch.yml`（组合层）与 `package.json` 的 `dsh.profile.bundles`。
+`cordis.patch.yml`（组合层）与 `package.json` 的 `dsh.profile.bundles` **也在监听里**：`dsh-hmr` 变了就 `recomposeProfile`，
+不用重启（它报 `restartReason` 时才按提示重启）。仍然要重启的是改 `vite.config.ts`。
 
 宿主侧监听为什么要环境变量：出厂 `hmr` 的 `root` 默认是 `[]`（不监听），
 而相对路径以 profile 目录为基准 —— 我们的包在 profile 里只是一个指向本仓库的符号链接，
@@ -128,6 +129,35 @@ WORKBENCH_PORT=3091 pnpm run dev   # 换端口（监听与实例同一个端口
 | opencli **daemon** | ❌ **整机一个，隔离不了** | 端口 **19825 被扩展写死**（`background.js` 里 `DAEMON_PORT = 19825`；CLI 侧 `OPENCLI_DAEMON_PORT` 设非默认值直接报错）。所以本机的全局 opencli 与工作台的隔离运行时**抢同一个 daemon**：两边版本不一致时，谁的命令后跑谁就把 daemon 重启成自己那版 |
 | profile 的 pnpm 源（私有 scope） | ⚠️ **由工作台写进去** | `<profile>/.npmrc` 里的 `@scope:registry=…`，前面带一行 `# dsh-workbench 写的…` 标记。**为什么在工作台这一侧写**：dsh 的卸载没有源参数（`runPnpm(['remove', name])`），pnpm 只能从 profile 的 `.npmrc` 链知道源；不写它，装私有源的模块能成、卸不了。规则与边界见 [ADR-0030](../../../docs/adr/0030-private-registries-live-in-the-profile-pnpm-config.md)：只加不改、只写 scope 行、不碰 `~/.npmrc`。**删了会怎样**：下次从这个源装会再写回来；已经装着的那种，点卸载时撞 404 会自愈补回再重试一次 |
 
+## 工作台自己怎么升级、出事怎么救
+
+工作台那一行的「更新」**不会把自己摘掉**（见 [ADR-0045](../../docs/adr/0045-workbench-self-update-runs-outside-the-workbench.md)）：
+点下去之后工作台把现场写到 `$DSH_HOME/workbench/self-update.sh|json|log`，然后起一个**独立进程**去做
+`dsh plugin --profile <profile> add @dsh-workbench/core@<版本>` —— 就地换版本，一行都不摘，
+所以它换的就是工作台自己也没关系（换的是外头那个进程）。
+
+- 成功：`self-update.json` 里 `state: "ok"`，`version` 是新版；**重启一次 dsh** 才用得上（面板会这么说）。
+- 换版没成：脚本自己把旧版本装回去，`state: "rolled-back"` —— 工作台不会因此消失。
+- 回滚也没成：`state: "failed"`，日志最后一行给出救法。终端敲这一条即可：
+  `dsh plugin --profile <profile> add @dsh-workbench/core@<版本>`（`<版本>` 取源上最新，或 `latest`）。
+
+两种安装形态的差别：
+
+| 怎么装的 | profile 里那一条 | 市场自更新 |
+|---|---|---|
+| `npm i -g @dsh-workbench/core` 然后 `dsh-workbench setup` | `@dsh-workbench/core@^x.y.z`（源上） | 能（就是上面那一条） |
+| 仓库副本（`pnpm run dev` / `link:` 本目录） | `link:…` | 拒：不把开发副本换成源上那份 |
+
+全局那一份**启动器**不会跟着升级（它只是启动器：真正加载的是 profile 里那份）。换 profile 或重建之前，
+先 `npm i -g @dsh-workbench/core@latest`；已经在跑的 profile 走市场那一颗「更新」。
+
+### 起不来：`failed to parse overlay …/cordis.patch.yml`（YAMLException: end of the stream …）
+
+早期版本 `seed-profile.sh` 会把隔离层直接接到 dsh 新模板的 patch 后面，而那份模板的内容是「横幅注释 +
+一个空数组 `[]`」—— 空数组本身是一个**完整的 YAML 文档**，后面再接序列就解析不了，profile 一条都组不起来。
+现在的脚本追加前会先把那行单独的 `[]` 让位（`selfcheck` 有判据钉着）。如果你手上那份 profile 是旧脚本建出来的，
+手工把 `cordis.patch.yml` 里**单独一行**的 `[]` 删掉再起即可（其余内容不用动）。
+
 ## 排障
 
 | 症状 | 原因 |
@@ -136,8 +166,9 @@ WORKBENCH_PORT=3091 pnpm run dev   # 换端口（监听与实例同一个端口
 | 面板一直空着、`/workbench/api/issues` 返回 `coding-not-logged-in` | opencli 登录态失效：在终端跑 `opencli coding team-current` 完成登录 |
 | 面板显示"这个项目不是 Coding 仓库" | 该工作区的 git `origin` 不指向 `e.coding.net`（或没有 origin） |
 | 打开面板/按刷新要等 5–8 秒 | 正常：opencli 每次调用有**固定约 5 秒**开销（起浏览器会话；接口本身只要 ~260ms）。**没有缓存**——数据一律实时，列表 = 缺陷 + 状态目录两次调用（限并发 2，实测约 7 秒） |
-| 改了源码没变化 | 忘了 `pnpm run build`，或没重启进程（宿主缓存已加载的包） |
+| 改了源码没变化 | 忘了 `pnpm run build`，或没刷新页面；改过 `vite.config.ts` 后没重启（正在跑的 watch 用的还是旧配置） |
 | 市场页点「卸载」报 `没成功：… ERR_PNPM_FETCH_404 GET https://registry.npmjs.org/@你的私有 scope/…` 之类 | 这个 profile 里的私有包不在 pnpm 默认源上，而 dsh 的卸载**不带源**。工作台会自己补上 `<profile>/.npmrc` 的 `@scope:registry=` 再重试一次（[ADR-0030](../../../docs/adr/0030-private-registries-live-in-the-profile-pnpm-config.md)）；**还失败**说明那个包没有 scope（一行 scope 行表达不了），这时才需要人/agent 上手：`dsh plugin --profile <p> remove '<包名>' --config.registry=<那个源>`（`pnpm remove` 不认 `--registry=`），或者给 profile 自己配一行默认 `registry=` |
 | 体检那屏「检测浏览器通道 · 没连上」，可面板照样能用 | 本机全局 opencli 与隔离运行时版本不一致 ⇒ daemon 被顶成对方那版（`Stale daemon detected: daemon vX != CLI vY`）。下一条浏览器命令会自动把它重启回来，体检也会复检后改回「已连接」（[ADR-0024](../../../docs/adr/0024-warm-the-sites-before-the-panel.md) §3.2.1）。**要彻底不抖**：让两边同版本 —— 把 `OPENCLI_PIN`（`src/shared/config/constants.ts`）对齐到 `opencli --version`，再 `npm i --prefix ~/.dsh/workbench/opencli/toolchain @jackwener/opencli@<那个版本> --cache ~/.dsh/workbench/opencli/npm-cache` |
 | Settings 页报 `overridden by a home patch` | 想在 Settings 里改的行被 `$DSH_HOME/cordis.patch.yml` 或 `--patch` 覆盖了 |
+| `./bin/dsh-workbench` 直接拒绝启动，说 `@dsh-workbench/core 不在 dsh.profile.bundles 里` | 包装着但**没被选中**（在 Settings → 插件里关过；或装到一半：`dsh plugin add` 的 pnpm 那半成功、装完的登记跳过了已存在的依赖）。这一档以前是静默的 —— 起得来、只是侧边栏没有工作台。现在拒绝启动是为了不给你一台"什么都对但没入口"的实例：跑它打印的那条 `./bin/dsh-workbench setup`（幂等，`seed-profile.sh ensure-selected` 会把这一项补回去） |
 | **别人机器上** `npx @dsh-workbench/core setup` 报 `scripts/seed-profile.sh: Permission denied`（或体检永远说"隔离运行时没装好"） | 发出去的包里**随包脚本丢了 x 位**：`pnpm publish` 只给 `package.json#bin` 点名那条文件 755，其余一律 644（`npm pack` 会保留，而 `git` 里的 x 位不进 tarball —— 所以**本机永远复现不出来**）。0.1.6 的已知缺陷：应急 `chmod +x <包目录>/{scripts/seed-profile.sh,bin/opencli-isolated}`，正规解是升到 0.1.7（启动器与 `selfcheck` 已改成不吃 x 位） |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-workbench/core",
-  "version": "0.2.6",
+  "version": "0.2.8",
   "description": "个人工作台：Agent 工作台外壳（左栏 + 常驻对话 + 自研右侧数据面板）。",
   "type": "module",
   "icon": "./icon.svg",
@@ -42,7 +42,7 @@
     "title": "Workbench",
     "description": "个人工作台"
   },
-  "//scripts": "包内不跑 check:docs —— 那份文档管理块住在仓库根的 docs/ARCHITECTURE.md，由根 `pnpm run check` 用 --config 指到本包的 arch.config.mjs 校验。prepublishOnly 走 -w 跑根那一整套。",
+  "//scripts": "包内不跑 check:docs —— 那份文档管理块住在仓库根的 docs/ARCHITECTURE.md，由根 `pnpm run check` 用 --config 指到本包的 arch.config.mjs 校验。check 与 prepublishOnly 都走 -w 跑根那一整套：包内自己串一份会漏掉 lint（react-hooks 那几条规则只在这里跑）、check:docs 与模块工具包的十一条判据 —— 2026-10-16 实测踩到（渲染期写 ref，包内全绿、根上一跑就红）。",
   "//dsh.bundle.patch": "一份 preset 就是一个补丁层：它 insert 一行 @deepseek-ai/dsh-agent-preset，config.plugins 是整表插件清单。diy.patch.yml 是**生成的**（scripts/gen-diy-preset.mjs，从 dsh 出厂那份 standard.patch.yml 派生），selfcheck 有一条判据盯着它有没有过期。",
   "dsh": {
     "bundle": {
@@ -87,7 +87,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@dsh-workbench/shared": "0.2.6"
+    "@dsh-workbench/shared": "0.2.8"
   },
   "scripts": {
     "build": "node scripts/build.mjs && node scripts/build-types.mjs",
@@ -97,7 +97,7 @@
     "arch": "arch-guard",
     "selfcheck": "node scripts/selfcheck.mjs",
     "check:runtimes": "node scripts/check-runtimes.mjs",
-    "check": "npm run typecheck && npm run coverage && npm run arch && npm run check:runtimes && npm run selfcheck",
+    "check": "pnpm -w run check",
     "test": "vitest run",
     "coverage": "vitest run --coverage",
     "dev": "node scripts/dev.mjs",

package/scripts/seed-profile.sh

@@ -15,6 +15,9 @@
 # 用法:
 #   ./scripts/seed-profile.sh
 #   WORKBENCH_PROFILE=wb2 ./scripts/seed-profile.sh   # 建到别的 profile 名下（试装用）
+#   ./scripts/seed-profile.sh ensure-selected         # 只做"确保选中"这一步：
+#                                                     # 把工作台 bundle 补进 dsh.profile.bundles
+#                                                     # （setup 在 `dsh plugin add` **之后**调它）
 
 set -euo pipefail
 
@@ -22,6 +25,7 @@ DSH_HOME="${DSH_HOME:-$HOME/.dsh}"
 PROFILE="${WORKBENCH_PROFILE:-workbench}"
 SRC_PROFILE="$DSH_HOME/profiles/web"
 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)"
 ISOLATION="$REPO_DIR/profile/isolation.patch.yml"
@@ -36,6 +40,53 @@ die() {
   exit 1
 }
 
+# ── 确保工作台 bundle 被**选中**（`ensure-selected` 子命令，幂等）──────────────
+#
+# 为什么单独一步、还要排在 `dsh plugin add` **之后**：装包与"选中"在 dsh 那侧是两件事。
+# `dsh plugin add` 的 pnpm 那半把包装进 profile；登记 `dsh.profile.bundles` 是它装完后的
+# 对账，而那条对账**跳过已存在的依赖** —— 所以依赖已经在清单里时（重跑 setup、上次装到
+# 一半），bundle 名单永远缺那一项。症状是静默的：profile 照常组起来、服务照常监听，
+# 只是侧边栏什么也不出现。启动器现在拿"选中"当硬门禁（拒绝启动 + 打印修复命令），
+# 这一步就是那条修复命令的落点。
+#
+# 与 dsh 自己的 `selectBundle(name, true)` 等价：已经在清单里就一个字节都不写；
+# 补之前先确认包真的装着（`dsh plugin add` 落了 dependencies）—— 把没装的包塞进
+# bundles 只会让 profile 组不起来，比"面板不出现"更糟。
+ensure_selected() {
+  local manifest="$DST_PROFILE/package.json"
+  [ -f "$manifest" ] ||
+    die "找不到 $manifest —— 先跑一次 '$REPO_DIR/bin/dsh-workbench setup'。"
+
+  WB_MANIFEST="$manifest" WB_PKG="$PKG" node -e '
+const fs = require("node:fs");
+const manifestPath = process.env.WB_MANIFEST;
+const pkg = process.env.WB_PKG;
+const manifest = JSON.parse(fs.readFileSync(manifestPath, "utf8"));
+const dependencies = manifest.dependencies || {};
+if (!Object.hasOwn(dependencies, pkg)) {
+  console.error("seed-profile: dependencies 里没有 " + pkg + " —— dsh plugin add 那一步没成，先重装一遍。");
+  process.exit(1);
+}
+const profile = (manifest.dsh || {}).profile || {};
+const bundles = Array.isArray(profile.bundles) ? profile.bundles : [];
+if (bundles.includes(pkg)) {
+  console.log("→ 工作台 bundle 已选中: " + pkg);
+  process.exit(0);
+}
+manifest.dsh = Object.assign({}, manifest.dsh, {
+  profile: Object.assign({}, profile, { bundles: bundles.concat([pkg]) }),
+});
+fs.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2) + "\n");
+console.log("→ 已把工作台 bundle 补进 dsh.profile.bundles: " + pkg);
+' ||
+    die "'$PKG' 没被选中，也没能补上（原因见上一行）。"
+}
+
+if [ "${1:-}" = "ensure-selected" ]; then
+  ensure_selected
+  exit 0
+fi
+
 [ -f "$SRC_PROFILE/package.json" ] ||
   die "找不到 $SRC_PROFILE —— 请先跑一次 'dsh web'，让 web profile 落地。"
 [ -f "$ISOLATION" ] || die "找不到 $ISOLATION"
@@ -87,6 +138,15 @@ console.log("→ 已继承 web 的 bundle 列表: " + merged.join(", "));
 if grep -q 'id: session-persistence-jsonl' "$DST_PATCH"; then
   echo "→ 隔离层已存在，跳过"
 else
+  # dsh 生成的 profile patch 是「三行横幅注释 + 一个空数组 []」。空数组本身是一个**完整的
+  # YAML 文档**，往后直接接一个序列，解析就会在最外层报
+  # "end of the stream or a document separator is expected"，profile 直接起不来
+  # （实测 dsh 0.2.1-alpha.3：setup 出来的 profile 报这条，去掉那行 [] 才起）。
+  # 所以追加之前先把那行单独的 [] 拿掉；本来就没有（或已经是序列）时这一步什么都不做。
+  if grep -qx '\[\]' "$DST_PATCH"; then
+    grep -vx '\[\]' "$DST_PATCH" >"$DST_PATCH.tmp" && mv "$DST_PATCH.tmp" "$DST_PATCH"
+    echo "→ 模板 patch 里的空数组 [] 已让位（否则接不上隔离层）"
+  fi
   printf '\n' >>"$DST_PATCH"
   cat "$ISOLATION" >>"$DST_PATCH"
   echo "→ 已追加隔离层（sessions / storages / attachments 分家）"
@@ -105,7 +165,7 @@ bash "$REPO_DIR/scripts/seed-workshop.sh"
 if [ -n "$GIT_TOP" ]; then
   BUNDLE_TARGET="$REPO_DIR"
 else
-  BUNDLE_TARGET="@dsh-workbench/core@^$(node -p "require('$REPO_DIR/package.json').version" 2>/dev/null || echo 0)"
+  BUNDLE_TARGET="$PKG@^$(node -p "require('$REPO_DIR/package.json').version" 2>/dev/null || echo 0)"
 fi
 
 cat <<EOF