@dsh-workbench/core 0.2.16 → 0.3.1

package/dist/types/app/client.d.ts

@@ -181,6 +181,7 @@ export declare const kit: {
         STORAGE_KEY_PROJECT: "dsh-workbench.project";
         STORAGE_KEY_RIGHTBAR: "dsh-workbench.rightbar.expanded";
         STORAGE_KEY_RIGHTBAR_COLUMN: "dsh-workbench.rightbar.column";
+        STORAGE_KEY_RIGHTBAR_WIDTH: "dsh-workbench.rightbar.width";
         RIGHTBAR_FULLSCREEN_WIDTH: 768;
         LOCALE_NS: "workbench";
         LOCALES: readonly ["zh", "en"];
@@ -1216,6 +1217,7 @@ export declare const kit: {
         STORAGE_KEY_PROJECT: "dsh-workbench.project";
         STORAGE_KEY_RIGHTBAR: "dsh-workbench.rightbar.expanded";
         STORAGE_KEY_RIGHTBAR_COLUMN: "dsh-workbench.rightbar.column";
+        STORAGE_KEY_RIGHTBAR_WIDTH: "dsh-workbench.rightbar.width";
         RIGHTBAR_FULLSCREEN_WIDTH: 768;
         LOCALE_NS: "workbench";
         LOCALES: readonly ["zh", "en"];
@@ -2246,6 +2248,7 @@ export declare const kit: {
         STORAGE_KEY_PROJECT: "dsh-workbench.project";
         STORAGE_KEY_RIGHTBAR: "dsh-workbench.rightbar.expanded";
         STORAGE_KEY_RIGHTBAR_COLUMN: "dsh-workbench.rightbar.column";
+        STORAGE_KEY_RIGHTBAR_WIDTH: "dsh-workbench.rightbar.width";
         RIGHTBAR_FULLSCREEN_WIDTH: 768;
         LOCALE_NS: "workbench";
         LOCALES: readonly ["zh", "en"];

package/dist/types/app/layouts/rightbar/BoardGrid.d.ts

@@ -0,0 +1,23 @@
+import type { BoardModule, BoardModuleProps, ModuleSummary, PanelStep, SuiteWorld, Translate } from '@dsh-workbench/shared';
+import type { BoardPlan } from './board-plan';
+export declare function workspacePathOf(world: SuiteWorld): string;
+export declare function ModuleHost({ module, step, panelToken, onPanelRefresh, onSummary, ...rest }: {
+    module: BoardModule;
+    step?: string;
+    panelToken: number;
+    onPanelRefresh: () => void;
+} & Omit<BoardModuleProps, 'refreshToken' | 'onRefresh' | 'onSummary'> & {
+    onSummary: (id: string, summary: ModuleSummary) => void;
+}): JSX.Element;
+export declare function BoardGrid({ entries, panelWidth, world, panelToken, onPanelRefresh, onNavigate, onOpenMarket, onSummary, onCardFailure, t, }: {
+    entries: BoardPlan['modules'];
+    panelWidth: number;
+    world: SuiteWorld;
+    panelToken: number;
+    onPanelRefresh: () => void;
+    onNavigate: (step: PanelStep) => void;
+    onOpenMarket: () => void;
+    onSummary: (id: string, summary: ModuleSummary) => void;
+    onCardFailure: (unit: string, reason: string) => void;
+    t: Translate;
+}): JSX.Element | null;

package/dist/types/app/layouts/rightbar/board-columns.d.ts

@@ -2,7 +2,20 @@ export declare const BOARD_COLUMN_MIN_WIDTH = 332;
 export declare const BOARD_COLUMN_GAP = 12;
 export declare const BOARD_PANEL_PADDING = 12;
 export declare const BOARD_COLUMNS_AT: number;
-export declare function boardFitsTwoColumns(panelWidth: number): boolean;
-export type BoardColumns<T> = readonly [readonly T[], readonly T[]];
-export declare function splitBoardColumns<T>(items: readonly T[]): BoardColumns<T>;
-export declare function boardColumnsOf<T>(items: readonly T[], twoColumns: boolean): readonly (readonly T[])[];
+export declare const BOARD_SPLIT_SEARCH_LIMIT = 100000;
+export declare const BOARD_SPLIT_MIN_GAIN = 32;
+export declare const BOARD_SPLIT_QUIET_MS = 600;
+export declare const BOARD_SPLIT_DEADLINE_MS = 3000;
+export declare function boardColumnCount(panelWidth: number, itemCount: number): number;
+export declare function roundRobinIndexes(count: number, columns: number): readonly number[];
+export declare function roundRobinColumns<T>(items: readonly T[], columns: number): readonly (readonly T[])[];
+export declare function boardImproves(current: readonly number[], candidate: readonly number[], heights: readonly number[], columns: number): boolean;
+export declare function boardColumnIndexes(heights: readonly number[], columns: number): readonly number[];
+export declare function boardAssignment(heights: readonly number[], columns: number): readonly number[];
+export declare function boardColumnsByHeight<T>(items: readonly T[], heights: readonly number[], columns: number): readonly (readonly T[])[];
+export interface BoardSlot {
+    readonly index: number;
+    readonly breakBefore: boolean;
+    readonly trailing: boolean;
+}
+export declare function boardLayout(assignment: readonly number[], columns: number): readonly BoardSlot[];

package/dist/types/app/layouts/rightbar/rightbar-width.d.ts

@@ -0,0 +1,16 @@
+import type { DshLayoutPanels } from '@dsh-workbench/shared';
+import { writeText } from '@dsh-workbench/shared';
+export declare const RIGHTBAR_DEFAULT_WIDTH = 420;
+export declare const RIGHTBAR_WIDTH_MAX = 4000;
+export declare function parseRightbarWidth(raw: string | null): number | null;
+export declare function readRightbarWidth(): number | null;
+export declare function writeRightbarWidth(px: number, write?: typeof writeText): void;
+export interface RightbarWidthMemory {
+    seed(px: number): void;
+    dispose(): void;
+}
+export declare function createRightbarWidthMemory(panels: DshLayoutPanels | undefined, write?: (px: number) => void): RightbarWidthMemory;
+export declare function ensureRightbarWidthMemory(panels: DshLayoutPanels | undefined, write?: (px: number) => void): RightbarWidthMemory;
+export declare function releaseRightbarWidthMemory(panels: DshLayoutPanels | undefined): void;
+export declare function restoreRightbarWidth(panels: DshLayoutPanels | undefined, remembered?: number | null): void;
+export declare function seedRightbarWidth(panels: DshLayoutPanels | undefined, remembered?: number | null): void;

package/dist/types/app/layouts/rightbar/use-board-split.d.ts

@@ -0,0 +1,8 @@
+import { type BoardSlot } from './board-columns';
+export interface BoardSplit {
+    readonly root: {
+        current: HTMLDivElement | null;
+    };
+    readonly slots: readonly BoardSlot[] | null;
+}
+export declare function useBoardSplit(keys: readonly string[], columns: number): BoardSplit;

package/dist/types/modules/panels/model/diy-report.d.ts

@@ -1,5 +1,14 @@
 import type { PanelUnitReport } from '@dsh-workbench/shared';
-import type { WorkshopModule } from '../../../shared/api/host/diy-workshop';
+import { type WorkshopModule, type WorkshopSync, type WorkshopToolchain } from '../../../shared/api/host/diy-workshop';
+export declare const SYNC_STALE_MINUTES = 15;
+export declare const SYNC_STALE_MS: number;
+export declare function syncNotice(input: {
+    readonly sync: WorkshopSync | undefined;
+    readonly shellVersion: string | undefined;
+    readonly toolchain: WorkshopToolchain | undefined;
+    readonly now?: number;
+    readonly windowMs?: number;
+}): string | undefined;
 export interface SuiteHealth {
     readonly state: 'ok' | 'failed' | 'absent';
     readonly reason?: string;
@@ -59,5 +68,7 @@ export declare function statusOf(options: {
     readonly open: boolean;
     readonly health: SuiteHealth;
 }): ModuleStatus;
-export declare function renderStatus(packagesDir: string, lines: readonly ModuleStatus[]): string;
+export declare function renderStatus(packagesDir: string, lines: readonly ModuleStatus[], options?: {
+    readonly shellVersion?: string;
+}): string;
 export declare function renderList(packagesDir: string, modules: readonly WorkshopModule[]): string;

package/dist/types/shared/api/host/diy-workshop.d.ts

@@ -10,3 +10,16 @@ export declare function workshopPackagesDir(ctx: DshHostContext): string | null;
 export declare function insideWorkshop(root: string, target: string): boolean;
 export declare function workshopModules(packagesDir: string, installed?: readonly string[]): readonly WorkshopModule[];
 export declare function inWorkshopSession(ctx: DshHostContext, workspace: string | null): boolean;
+export interface WorkshopSync {
+    readonly state: 'ok' | 'syncing' | 'failed';
+    readonly version: string;
+    readonly at: string;
+    readonly reason?: string;
+}
+export declare function workshopSyncOf(workshopRoot: string): WorkshopSync | undefined;
+export interface WorkshopToolchain {
+    readonly core: string;
+    readonly moduleTools: string;
+    readonly shared: string;
+}
+export declare function workshopToolchainOf(workshopRoot: string): WorkshopToolchain | undefined;

package/dist/types/shared/api/host/runtime-seed.d.ts

@@ -1,6 +1,5 @@
 import { spawn } from 'node:child_process';
 import type { DshHostContext } from '@dsh-workbench/shared';
-export declare const WORKSHOP_SKILLS_DIR = "workbench-module-diy";
 export type SeedLog = (message: string) => void;
 export interface RuntimeSeedPaths {
     readonly root: string;
@@ -12,7 +11,6 @@ export interface RuntimeSeedPaths {
     readonly workshop: string;
     readonly workshopPackages: string;
     readonly workshopManifest: string;
-    readonly skillsLink: string;
 }
 export interface RuntimeSeedOptions {
     readonly root: string;

package/docs/HANDOFF.md

@@ -37,7 +37,11 @@
 DIY 工坊骨架、可写根）由**外壳自己**补齐 —— 不用跑 `setup`，也不用起第二个实例。
 
 差别（先跟对方说清）：**会话 / 存储不分家**（接着用他原来那份）、**没有独立端口与进程**、
-**改外壳源码不热重载**、DIY 工坊依赖是首次启动在后台装的。
+**改外壳源码不热重载**、DIY 工坊依赖是首次启动在后台装的。工坊的工具链（那三个
+`@dsh-workbench/*`）此后**每次启动**都会与**正在跑的那份外壳**比一次（基准经 `DSH_WB_SHELL_ROOT`
+显式传入 —— 宿主给加载中那份、启动器给 profile 里那份），不同代就在后台增量同步到同代 ——
+升级外壳不用手动删工坊，**下一次启动**就对上了；同步不上时 `workbench_diy_status` 会说清
+（差在哪、为什么、怎么修），日志在 `$DSH_HOME/workbench/seed.log`。
 
 ## 三、B：两步装（独立 profile，占 :3081）
 
@@ -99,6 +103,12 @@ Settings → 插件里把 `@dsh-workbench/core` 关掉后，工作台会**退化
    就一个字节不写）。为什么单列这一步：`dsh plugin add` 装完的登记**跳过已存在的依赖**，
    所以重跑 setup（包已在清单里）时它不会补 bundle —— 那一档是静默的（起得来、侧边栏
    没入口），现在启动器拿"选中"当硬门禁，这一步就是它给的修复命令。
+6. `scripts/seed-workshop.sh`（`seed-profile.sh:155-160` 调它）—— 建 / 补齐 **DIY 工坊**：
+   骨架缺才建、依赖缺才装、写 `dsh-wb-module` 入口。**这一步不做代际对齐**：代际比对的基准是
+   "正在跑的那份外壳"（`DSH_WB_SHELL_ROOT`），而 `setup` 这趟 profile 里那份还没装 / 还是旧的，
+   所以它**不设基准、这一轮不比对**。**重跑 `setup` 只建骨架 / 装依赖；工坊工具链对上正在跑的那一代
+   发生在下一次启动**（启动器按 profile 里那份、宿主按加载中那份，同一个基准）—— 与 README 的
+   "升级要重启一次"一致，不必手动删工坊。
 
 **设置不在这一步继承**（这里以前快照 web 的 patch、并继承被它点名的依赖）：新机器上
 `setup` 完的工作台**没有模型供应商**，第一次打开去 设置 → 「配置同步」拉一次即可 ——
@@ -202,6 +212,16 @@ manifest；彩排结束、以及「零上传」的失败，都会自动回滚。
 - **工作区不干净** → 默认拒（发布会把它们 `git add -A` 一起提交），`--allow-dirty` 才放行；
 - **目标版本必须高于当前版本**；目标版本若在源上**已完整存在**，直接拒（要补发用 `--resume`）；
 - **npm 没登录** → 就地拉起 `npm login`；
+- **发布产物里零夹具** → 发布构建**之后**、任何上传**之前**跑 `check:release-artifacts --shipped`
+  （`packages/workbench/scripts/check-release-artifacts.mjs`）：逐份扫**真会进 tarball** 的那批文件
+  （`client.js` / `dist/client/*` / `dist/types/**` / `board.css`），内容里出现夹具标记、或文件名本身
+  就是夹具（`dev/**`、`*-mock.*`、`__tests__/*.d.ts`…）就当场拒。这条闸审的是**包内那份**，所以它
+  紧跟发布构建；它要是在构建之后报了红，先看它给的是哪一种 —— 产物**被别的进程重写**了（多半是
+  `pnpm run dev` 的 watcher：审计前后各记一次指纹，对不上就是它）还是**构建出来就脏**。
+  它替掉了原先只看 `client.js`
+  一个文件的那条单文件断言 —— 0.2.16 的 tarball 就是那么漏出去的（`dist/client/index.js` 是残留
+  开发档、`dist/types/**` 带着整棵夹具树）；来历、三条检查与代价见
+  [`../../../.scratch/dev-only-fixtures/spec.md`](../../../.scratch/dev-only-fixtures/spec.md) §9；
 - **彩排不过**（`publish --dry-run` 打不出包）→ 零上传退出。
 
 只能自己盯、脚本不查的两条：
@@ -220,21 +240,33 @@ manifest；彩排结束、以及「零上传」的失败，都会自动回滚。
 ## 八、版本与兼容（实话）
 
 `package.json` 的 `peerDependencies` 里**没有** `@deepseek-ai/dsh`，这是有意的：
-dsh 目前是 `0.1.7-rc.2`（预发布），声明范围会让版本不一致的人**装不上**；不声明则是
-"谁都能装，坏了当场知道"。
+dsh 现在发的是预发布（npm 的 `next` 频道；本仓**验过的**是 `0.2.1-rc.2`，2026-10-18），
+声明范围会让版本不一致的人**装不上**；不声明则是"谁都能装，坏了当场知道"。
 
-代价要清楚：工作台依赖 dsh 的两个注入面（`@deepseek-ai/dsh-client-ui-slots`、
-`@deepseek-ai/dsh-client-locale`，见 `dsh.client.inject`），这两个面在 dsh 升级时会动。
-对方的 dsh 版本和上面验过的差得远时，**先在一台上验一次**再铺开。
+代价要清楚：工作台依赖 dsh 的注入面（`@deepseek-ai/dsh-client-ui-slots`、
+`@deepseek-ai/dsh-client-locale`，见 `dsh.client.inject`）与一批**按名字取的服务**
+（`pluginManager` / `profileContext` / `dshHomePath` / `tools` / `webServer` / `shell`），
+这些面在 dsh 升级时会动。对方的 dsh 版本和上面验过的差得远时，**先在一台上验一次**再铺开。
+每次升级要对账哪些面、上一次对账的结论，见
+[`.scratch/dsh-0.2.1-rc.2/spec.md`](../../../.scratch/dsh-0.2.1-rc.2/spec.md)。
+
+**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.1.7" }
+"peerDependencies": { "@deepseek-ai/dsh": "^0.2.1-rc.2" }
 ```
 
-dsh 会用这条做**安装预检**（`evaluatePluginCompatibility`），不满足就拒绝安装，
+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 更直接。
 
 > `NPM_REGISTRY` 是**你们自己的**内网 npm 源地址（形如 `https://<源主机>/<路径>/`）。
 > 本仓不写它：开源包里不该出现任何内网地址。
@@ -258,8 +290,9 @@ pnpm release:dry        # 同上，但 publish 只 dry-run：零上传，结束
   在同一版上都拉得到才算数（[ADR-0043](../../../docs/adr/0043-version-prompt-waits-for-the-whole-release.md)）。
   所以中断续跑那段窗口里、或镜像还没同步全时，市场**不会**提示更新 —— 铺齐后等 10 分钟，
   或让用户点市场页那颗「重新检查」即可（用户主动的时机一路 `force`，不等缓存）；
-- **发什么** = pnpm 按各包 `files` / `.gitignore` 打包；**打包清单没人替你核**（见上一章
-  「只能自己盯」）。要看清单用 `dsh-wb-module publish`：它只 dry-run、打印清单，不发布。
+- **发什么** = pnpm 按各包 `files` / `.gitignore` 打包；**清单里有没有漏文件仍然没人替你核**（见上一章
+  「只能自己盯」）—— 现在机器核的只是**内容**：`check:release-artifacts --shipped` 盯着这批产物里
+  零夹具。要看清单用 `dsh-wb-module publish`：它只 dry-run、打印清单，不发布。
 
 发布必须走 `pnpm publish`（不是 `npm publish`）：只有 pnpm 会把 `workspace:*` 改写成真实版本，
 `npm pack` / `npm publish` 不会 —— 直接发别人装不上。

package/docs/OPERATIONS.md

@@ -49,6 +49,8 @@
 
 差别：**会话 / 存储不隔离**（接着用你原来那份）、**没有独立端口与进程**、
 **改外壳源码不热重载**、DIY 工坊依赖是首次启动在后台装的（几百 MB，失败只落日志）。
+此后**每次启动**都会比对工坊里那三个 `@dsh-workbench/*` 与**正在跑的那份外壳**的版本，不同代就在后台**增量同步**
+（见下面「工坊工具链怎么跟着外壳走」）。
 
 撤销：Plugins 页卸载 `@dsh-workbench/core`（配置与数据不清）；`~/.dsh/workbench/**` 想清就手删。
 
@@ -158,6 +160,47 @@ WORKBENCH_PORT=3091 pnpm run dev   # 换端口（监听与实例同一个端口
 现在的脚本追加前会先把那行单独的 `[]` 让位（`selfcheck` 有判据钉着）。如果你手上那份 profile 是旧脚本建出来的，
 手工把 `cordis.patch.yml` 里**单独一行**的 `[]` 删掉再起即可（其余内容不用动）。
 
+### 工坊工具链怎么跟着外壳走
+
+工坊（`$DSH_HOME/workbench/diy`）里那三个 `@dsh-workbench/*` 必须与**当前跑着的外壳**同代 ——
+不同代就是"指引是新的、判据与模板是旧的"，报错会指着你的声明而不是指着版本。
+
+- **判据**：工坊 `node_modules/@dsh-workbench/{core,module-tools,shared}/package.json` 里**实装**的
+  `version`，与**基准版本**（见下条）**全等**。不看 `package.json` 里写的范围，也不信 `pnpm` 的退出码 ——
+  装完会按盘上那份复核实装版本，只有真的同代才写 `ok`。
+- **基准 = 正在跑的那份外壳**，由调用者经 `DSH_WB_SHELL_ROOT` 显式传进来：
+  宿主自举给**加载中的那份**（`packageRootOf(import.meta.url)`），启动器给 **profile 里那份**
+  `node_modules/@dsh-workbench/core`（只在它真能读出 `package.json` 时才给）。**谁都没传 → 这一轮不比对**
+  （不读工坊实装版本、不起同步、不写 `.sync.json`、不动工坊一个字节）。
+  ⚠️ **跑脚本的那份副本不算基准**：安装态下启动器与宿主是**两份物理副本**，谁后跑谁说了算会来回漂
+  —— 现在启动器那份落后**不会再**把工坊往回拽（实测那一次：启动器 0.3.0 / profile 0.3.1 / 工坊已跟到
+  0.3.1，旧口径把工坊降级成 0.3.0，见 [ADR-0056](../../../docs/adr/0056-workshop-toolchain-follows-the-shell.md) 补记）。
+- **触发**：每次启动都会比一次（`bin/dsh-workbench` 与宿主自举走的那条 `entry`）。
+  无参那一趟（建骨架 / 重跑 `setup`）**只有带基准时才比** —— 启动器兜底建骨架时带，`setup` 那趟
+  **不设基准 → 空转**。所以**重跑 `setup` 不做代际对齐**，对齐发生在**下一次启动**工作台时
+  （与 README 的"升级要重启一次"一致）。比对是**便宜**的：只读四份 `package.json` 的版本。
+- **不一致 → 后台自愈**：起一个 `nohup` 的 `seed-workshop.sh sync`，把工坊根的 `devDependency`
+  范围与 `pnpm.overrides` 都对齐到基准那一代，再增量 `pnpm install`，跑完复核实装版本。
+  启动路径不等它。
+- **状态文件**：`$DSH_HOME/workbench/diy/.sync.json`（`state` / `version` / `at` / `reason`），四种态：
+  - `ok`：复核过、同代。⚠️ **`ok` 可能是旧版本的记录** —— 判据**永远是实装版本**，
+    `.sync.json` 只用于退避与说人话，别拿它当"装好了"的证据；
+  - `syncing`：正在后台同步；超过 15 分钟还停在这，`workbench_diy_status` 会说
+    「⚠️ 工坊工具链上一次同步没走完（这条停在 <at>，超过 15 分钟了）」；
+  - `failed`：**这一轮没修好**（原因在 `reason` 里），`workbench_diy_status` 会直说
+    「⚠️ 工坊工具链还是上一代（…；外壳已经是 <版本>）：<原因>」并把修法一起给出来；
+  - 文件不在：还没有同步记录（首次 / 天然同代）；**实装版本与外壳同代时不出声**，不同代时显示
+    「⏳ 工坊工具链还是上一代（工坊里 <包> <版本>，外壳 <版本>）—— 下一轮工作台启动时会对齐到 <版本>；一直这样就看 `$DSH_HOME/workbench/seed.log`」。
+- **去哪看**：日志在 `$DSH_HOME/workbench/seed.log`（每次同步都写：比对的实装版本、开始自愈、
+  `pnpm install` 的原话、复核结果）；状态也可以直接问 agent：`workbench_diy_status`。
+- **失败了怎么修**：先照状态里那条命令来 —— `cd "$DSH_HOME/workbench/diy" && pnpm install`；
+  还是不行就把工坊目录删掉再重启一次工作台（骨架会自己重建；`packages/` 下你造的模块先留着或另存）。
+  两句常见原因：PATH 上没有 `pnpm`（装好后 `cd <工坊> && pnpm install`）、
+  工坊根 `package.json` 被手改坏了（修回一份合法 JSON）。
+- **离线 / 装不动**：就停在旧一代，但**看得见**（`failed` + `reason` + 修法）。同一个外壳版本上失败过，
+  一小时内不再重试（`SYNC_BACKOFF_SECONDS=3600`）；外壳换了一代就是新问题，会重新试。
+  自愈锁的过期判据是 15 分钟（`SYNC_LOCK_STALE_MINUTES=15`，持锁者崩了不会被永久锁死）。
+
 ## 排障
 
 | 症状 | 原因 |
@@ -167,8 +210,17 @@ WORKBENCH_PORT=3091 pnpm run dev   # 换端口（监听与实例同一个端口
 | 面板显示"这个项目不是 Coding 仓库" | 该工作区的 git `origin` 不指向 `e.coding.net`（或没有 origin） |
 | 打开面板/按刷新要等 5–8 秒 | 正常：opencli 每次调用有**固定约 5 秒**开销（起浏览器会话；接口本身只要 ~260ms）。**没有缓存**——数据一律实时，列表 = 缺陷 + 状态目录两次调用（限并发 2，实测约 7 秒） |
 | 改了源码没变化 | 忘了 `pnpm run build`，或没刷新页面；改过 `vite.config.ts` 后没重启（正在跑的 watch 用的还是旧配置） |
+| 跑门禁/发版时 `check:release-artifacts` 报「判据自己碰了包内产物」，或 `--shipped` 报一份莫名其妙的产物红 | 多半是**假红** —— 见下面「发版那条闸报红的三种假红」 |
 | 市场页点「卸载」报 `没成功：… 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 位） |
+
+**发版那条闸（`check:release-artifacts`）报红的三种假红**：
+
+| 来路 | 看到什么 |
+|---|---|
+| 环境里带着 `WB_STAGE_DIR`（判据内部的暂存开关） | 发布构建落进临时根、包内那份没动，而 `--shipped` 审的正是包内那份 ⇒ 假红。发版构建会**当场忽略它**并打一行说明；发版环境里别带它 |
+| `pnpm run dev` 的 watcher 在审计中间重写产物 | 发版脚本点名「**被别的进程重写**」（审计前后各记一次指纹，对不上就是它）；门禁那条会说"判据自己碰了包内产物"。先停 watcher 再跑 |
+| 在开发树上直接跑 `--shipped` | 本来就红（包内那份是开发档）：`--shipped` 的前提是**刚跑过发布构建**，判据会自述这一档。自查用默认档 —— 它建到临时根、不碰开发产物 |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-workbench/core",
-  "version": "0.2.16",
+  "version": "0.3.1",
   "description": "个人工作台：Agent 工作台外壳（左栏 + 常驻对话 + 自研右侧数据面板）。",
   "type": "module",
   "icon": "./icon.svg",
@@ -72,7 +72,7 @@
   },
   "devDependencies": {
     "@arch-guard/core": "^0.11.0",
-    "@deepseek-ai/dsh-client-ui-primitives": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.2.1-rc.2",
     "@types/node": "^24.19.0",
     "@types/react": "^19.3.0",
     "@vitest/coverage-v8": "^5.0.2",
@@ -87,7 +87,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@dsh-workbench/shared": "0.2.16"
+    "@dsh-workbench/shared": "0.3.1"
   },
   "scripts": {
     "build": "node scripts/build.mjs && node scripts/build-types.mjs",
@@ -97,6 +97,7 @@
     "arch": "arch-guard",
     "selfcheck": "node scripts/selfcheck.mjs",
     "check:runtimes": "node scripts/check-runtimes.mjs",
+    "check:release-artifacts": "node scripts/check-release-artifacts.mjs",
     "check": "pnpm -w run check",
     "test": "vitest run",
     "coverage": "vitest run --coverage",

package/preset/diy.patch.yml

@@ -124,6 +124,9 @@
           - id: tool-plugin-manager
             name: '@deepseek-ai/dsh-plugin-manager/tools'
             disabled: !!js "!ctx.get('profileContext')"
+          - id: tool-plugin-market
+            name: '@deepseek-ai/dsh-plugin-market/tools'
+            disabled: true
           - id: tool-cordis
             name: '@deepseek-ai/dsh-tool-cordis'
           - id: skill-filesystem