@dsh-workbench/core 0.2.6 → 0.2.7

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 后来改了不会自动过来** —— 再打开这一页，那几行会重新以「差异」标签出现在这一页，拉一次即可。
@@ -188,7 +188,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 +208,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,7 +60,7 @@
 | 开发（监听改动 + 起工作台） | `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+,`）。实测过这条降级路径，不是推断 |
@@ -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,7 +166,7 @@ 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` 覆盖了 |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-workbench/core",
-  "version": "0.2.6",
+  "version": "0.2.7",
   "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.7"
   },
   "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

@@ -87,6 +87,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 分家）"