@dsh-workbench/core 0.1.15 → 0.1.17

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

@@ -8,7 +8,7 @@ export interface BundleRegistries {
     readonly fallbackRegistries: readonly BundleRegistry[];
     readonly resolved: string | null;
 }
-export type BundleInspectProblem = 'invalid-spec' | 'already-installed' | 'not-found' | 'not-a-package' | 'not-a-bundle' | 'network' | 'unknown';
+export type BundleInspectProblem = 'invalid-spec' | 'already-installed' | 'not-found' | 'not-a-package' | 'not-a-bundle' | 'not-a-workbench-module' | 'not-a-module-or-plugin' | 'network' | 'unknown';
 export type BundleSpecKind = 'registry' | 'path' | 'git' | 'tarball';
 export interface BundleInspectionAccepted {
     readonly status: 'accepted';
@@ -74,10 +74,16 @@ export interface BundleSupplyPayload {
     readonly state: BundleSupplyState;
     readonly reason?: string;
 }
+export interface BundleInstalledPlugin {
+    readonly kind: 'opencli-plugin';
+    readonly pkg: string;
+    readonly name?: string;
+}
 export interface BundleInstallPayload {
     readonly change: BundleChange;
     readonly module: BundleModulePayload;
     readonly supply: BundleSupplyPayload;
+    readonly plugin?: BundleInstalledPlugin;
 }
 export interface BundleRemovePayload {
     readonly change: BundleChange;
@@ -92,6 +98,7 @@ export interface ModuleVersion {
     readonly installed: string;
     readonly latest?: string;
     readonly local?: boolean;
+    readonly refused?: readonly string[];
 }
 export interface ModuleVersionsPayload {
     readonly modules: readonly ModuleVersion[];

package/dist/types/shared/api/host/__tests__/registry-declaration.test.d.ts

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

package/dist/types/shared/api/host/__tests__/unit-roster-facts.test.d.ts

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

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

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

package/dist/types/shared/api/host/installed-module.d.ts

@@ -22,5 +22,12 @@ export interface ProfileModule {
     readonly registry?: string;
     readonly local?: boolean;
 }
+export declare function profileManifestOf(profileDir: string | null): Readonly<Record<string, unknown>> | undefined;
 export declare function profileModules(profileDir: string | null): readonly ProfileModule[];
+export declare function moduleDeclarationOf(profileDir: string | null, pkg: string): unknown;
+export interface DeclarationGap {
+    readonly pkg: string;
+    readonly problems: readonly string[];
+}
+export declare function declarationGaps(profileDir: string | null): readonly DeclarationGap[] | undefined;
 export declare function readInstalledModule(profileDir: string | null, pkg: string): InstalledModule;

package/dist/types/shared/api/host/mount-units.d.ts

@@ -1,14 +1,15 @@
 import type { DshHostContext } from '@dsh-workbench/shared';
 import type { UnitManifest } from '@dsh-workbench/shared/host';
 import { type RouteTable } from '@dsh-workbench/shared/host';
-import type { ContextRenderer, UnitHostFace, UnitMountDeps, UnitMountResult, UnitCall } from '@dsh-workbench/shared/host';
+import type { ContextRenderer, UnitMountDeps, UnitMountResult, UnitCall } from '@dsh-workbench/shared/host';
+import type { HostUnit } from './unit-registry';
 import { type UnitReadiness } from './unit-readiness';
 export interface UnitFailure {
     readonly id: string;
     readonly reason: string;
 }
 export interface MountedUnit {
-    readonly face: UnitHostFace;
+    readonly host: HostUnit;
     readonly result: UnitMountResult;
     readonly readiness: UnitReadiness;
 }
@@ -40,13 +41,14 @@ interface NamedEntry {
     handle(payload: unknown): unknown;
 }
 export declare function failureReasonOf(error: unknown): string;
-export declare function mountUnits(faces: readonly UnitHostFace[], deps: {
+export declare function mountUnits(units: readonly HostUnit[], deps: {
     ctx: DshHostContext;
     logger?: {
         info?(m: string): void;
         warn?(m: string): void;
     } | undefined;
     manifests: () => readonly UnitManifest[];
+    ownedUnits?: () => readonly string[];
     opencliCommand?: string;
     probe?: UnitMountDeps['probe'];
     store?: UnitMountDeps['store'];

package/dist/types/shared/api/host/package-content.d.ts

@@ -0,0 +1,6 @@
+import type { DshShell } from '@dsh-workbench/shared';
+export declare function withPackageDir<T>(options: {
+    readonly shell?: DshShell | undefined;
+    readonly spec: string;
+    readonly registry?: string | undefined;
+}, visit: (dir: string) => T): Promise<T | undefined>;

package/dist/types/shared/api/host/package-content.test.d.ts

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

package/dist/types/shared/api/host/package-kind.d.ts

@@ -0,0 +1,21 @@
+export type PackageKind = 'opencli-plugin' | 'dsh-bundle' | 'both' | 'neither';
+export interface PackageVerdict {
+    readonly kind: PackageKind;
+    readonly pkg?: string;
+    readonly pluginName?: string;
+}
+export interface NpmRef {
+    readonly name: string;
+    readonly version?: string;
+}
+export declare const OPENCLI_MANIFEST_FILE = "opencli-plugin.json";
+export declare function splitNpmSpec(spec: string): NpmRef | undefined;
+export declare function isCommandFile(name: string): boolean;
+export declare function pluginManifestOf(dir: string): Readonly<Record<string, unknown>> | undefined;
+export declare function hasCommandFile(dir: string): boolean;
+export declare function pluginAt(dir: string): {
+    readonly name?: string;
+} | undefined;
+export declare function dshMarkersOf(raw: unknown): boolean;
+export declare function verdictOf(dir: string): PackageVerdict | undefined;
+export declare function refusalReason(): string;

package/dist/types/shared/api/host/package-kind.test.d.ts

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

package/dist/types/shared/api/host/package-route.d.ts

@@ -0,0 +1,23 @@
+import type { DshShell } from '@dsh-workbench/shared';
+import { type ResolvedPluginSource } from '@dsh-workbench/shared/host';
+export type PackageRouteKind = 'opencli-plugin' | 'dsh-bundle' | 'neither';
+export interface PackageRoute {
+    readonly kind: PackageRouteKind;
+    readonly pkg?: string;
+    readonly pluginName?: string;
+}
+export declare const LOCAL_PLUGIN_ENV = "DSH_WB_OPENCLI_PLUGIN_PATH";
+export declare const PLUGIN_REGISTRY_ENV = "DSH_WB_OPENCLI_PLUGIN_REGISTRY";
+export declare function packageRouteOf(options: {
+    readonly spec: string;
+    readonly shell?: DshShell | undefined;
+    readonly registry?: string | undefined;
+    readonly force?: boolean;
+}): Promise<PackageRoute | undefined>;
+export declare function resetPackageRouteCache(): void;
+export declare function pluginInstallPlan(options: {
+    readonly spec: string;
+    readonly command: string;
+    readonly registry?: string | undefined;
+    readonly pluginName?: string | undefined;
+}): ResolvedPluginSource;

package/dist/types/shared/api/host/package-route.test.d.ts

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

package/dist/types/shared/api/host/registry-declaration.d.ts

@@ -0,0 +1,23 @@
+import type { DshShell } from '@dsh-workbench/shared';
+export declare function localDirOf(spec: string): string | undefined;
+export declare function packageManifestOf(dir: string): Readonly<Record<string, unknown>> | undefined;
+export declare function dshRecordOf(dir: string): unknown | undefined;
+export declare function packageNameOf(dir: string): string | undefined;
+export declare function pathDeclarationOf(spec: string): unknown | undefined;
+export interface RegistryDshLookup {
+    readonly readable: boolean;
+    readonly raw: unknown;
+}
+export declare function registryDshOf(options: {
+    shell: DshShell;
+    name: string;
+    registry?: string | undefined;
+    force?: boolean;
+}): Promise<RegistryDshLookup>;
+export declare function registryDeclarationOf(options: {
+    shell: DshShell;
+    name: string;
+    registry: string;
+    force?: boolean;
+}): Promise<unknown | undefined>;
+export declare function declarationRefusalOf(name: string, raw: unknown): readonly string[];

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

@@ -0,0 +1,40 @@
+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;
+    readonly entryDir: string;
+    readonly opencliRoot: string;
+    readonly opencliBinDir: string;
+    readonly opencliBin: string;
+    readonly opencliHome: string;
+    readonly workshop: string;
+    readonly workshopPackages: string;
+    readonly workshopManifest: string;
+    readonly skillsLink: string;
+}
+export interface RuntimeSeedOptions {
+    readonly root: string;
+    readonly home: string;
+    readonly packageRoot: string;
+    readonly log?: SeedLog;
+}
+export declare function runtimeSeedPaths(root: string): RuntimeSeedPaths;
+export declare function runtimeSeedRootOf(ctx: DshHostContext): string | null;
+export declare function packageRootOf(moduleUrl: string): string;
+export declare function isInstalledCopy(packageRoot: string): boolean;
+export declare function opencliWrapperScript(packageRoot: string, home: string): string;
+export interface SeedCommand {
+    readonly file: string;
+    readonly args: readonly string[];
+    readonly env: Readonly<Record<string, string>>;
+    readonly log: string;
+}
+export declare function workshopSeedPlan(packageRoot: string, home: string, root: string): {
+    readonly entry: SeedCommand;
+    readonly full: SeedCommand;
+};
+export declare function runDetached(command: SeedCommand, onError: SeedLog, spawnImpl?: typeof spawn): void;
+export declare function prependPath(entryDir: string, env?: NodeJS.ProcessEnv): boolean;
+export declare function seedRuntimeFiles(options: RuntimeSeedOptions): readonly string[];

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

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

package/dist/types/shared/api/host/unit-registry.d.ts

@@ -1,9 +1,38 @@
 import type { UnitManifest } from '@dsh-workbench/shared';
-import type { UnitHostFace } from '@dsh-workbench/shared/host';
+import type { UnitModuleFace, UnitOwnedFace } from '@dsh-workbench/shared/host';
+export interface UnitRefusal {
+    readonly unit: string;
+    readonly pkg?: string;
+    readonly reasons: readonly string[];
+}
+export type UnitSource = {
+    readonly kind: 'package';
+    readonly pkg: string;
+} | {
+    readonly kind: 'owned';
+};
+export interface HostUnit {
+    readonly unit: string;
+    readonly manifest: UnitManifest;
+    readonly face: UnitModuleFace;
+    readonly source: UnitSource;
+}
+export interface UnitDeclarationSource {
+    readonly pkg: string;
+    readonly declaration: unknown;
+}
 export interface UnitRegistry {
-    register(face: UnitHostFace): () => void;
-    all(): readonly UnitHostFace[];
+    register(face: UnitModuleFace): () => void;
+    registerOwned(face: UnitOwnedFace): () => void;
+    all(): readonly HostUnit[];
+    owned(): readonly string[];
+    refusals(): readonly UnitRefusal[];
     manifests(): readonly UnitManifest[];
     subscribe(listener: () => void): () => void;
 }
-export declare function createUnitRegistry(): UnitRegistry;
+export declare function createUnitRegistry(options: {
+    declarationOf: (unit: string) => UnitDeclarationSource | undefined;
+    logger?: {
+        warn?(message: string): void;
+    } | undefined;
+}): UnitRegistry;

package/dist/types/shared/api/host/unit-roster-facts.d.ts

@@ -0,0 +1,5 @@
+import type { UnitRegistry } from './unit-registry';
+export declare function bindRosterFacts(options: {
+    readonly units: UnitRegistry;
+    readonly bump: (facts: readonly string[]) => void;
+}): () => void;

package/dist/types/shared/api/installed-plugins.d.ts

@@ -0,0 +1,12 @@
+export declare const INSTALLED_PLUGINS_ROUTE = "panels/plugins";
+export interface InstalledPlugin {
+    readonly pkg: string;
+    readonly name?: string;
+    readonly installed?: string;
+    readonly latest?: string;
+    readonly local?: boolean;
+    readonly broken?: boolean;
+}
+export interface InstalledPluginsPayload {
+    readonly plugins: readonly InstalledPlugin[];
+}

package/dist/types/shared/api/unit-manifests.d.ts

@@ -0,0 +1,5 @@
+import type { UnitManifest } from '@dsh-workbench/shared';
+export declare const UNIT_MANIFESTS_ROUTE = "unit-manifests";
+export interface UnitManifestsPayload {
+    readonly manifests: readonly UnitManifest[];
+}

package/dist/types/shared/api/unit-manifests.test.d.ts

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

package/dist/types/shared/hooks/bundle-queries.d.ts

@@ -1,5 +1,7 @@
 import type { ApiResponse } from '@dsh-workbench/shared';
 import { type BundleInspectionPayload, type BundleRegistriesPayload, type ModuleVersionsPayload } from '../api/bundle-install';
+import { type InstalledPluginsPayload } from '../api/installed-plugins';
 export declare function readBundleRegistries(): Promise<ApiResponse<BundleRegistriesPayload>>;
 export declare function readBundleInspection(spec: string, registry?: string): Promise<ApiResponse<BundleInspectionPayload>>;
 export declare function readModuleVersions(force?: boolean): Promise<ApiResponse<ModuleVersionsPayload>>;
+export declare function readInstalledPlugins(force?: boolean): Promise<ApiResponse<InstalledPluginsPayload>>;

package/dist/types/shared/hooks/use-facts.d.ts

@@ -1,2 +1,3 @@
 export declare function useFactRevision(fact: string): number;
+export declare function subscribeFactRevision(fact: string, listener: () => void): () => void;
 export declare function useFactInvalidate(): (fact?: string) => void;

package/docs/HANDOFF.md

@@ -1,37 +1,55 @@
 # 把工作台给别人用
 
-工作台是一个 **dsh 插件包**，发在内网源上（地址只写在 `package.json` 的
-`publishConfig.registry` 一处）。别人装的是**独立 profile**（`workbench`）——
-他自己那份 `dsh web` 一行不改，两边可以同时开着。
+工作台是一个 **dsh 插件包**，现在发在**公网 npm** 上：`@dsh-workbench/core`
+（实测 `npm view @dsh-workbench/core version` 出号，`npm pack` 的产物里
+`dsh.bundle.patch` / `cordis.patch.yml` / `client.js` / `dist/host/index.js` 都在）。
+所以**对方不需要配任何私有源**就能装。
 
-一句话：**登录内网源 → `setup` → 起**。
+两种给法，先挑一种：
+
+| 给法 | 对方要做的事 | 换来的 |
+| --- | --- | --- |
+| **A. 装进他自己的 `dsh web`**（最短） | Plugins → Add plugin → `@dsh-workbench/core` → Enable now → **刷新页面** | 就在那份 web 里换成工作台；**同一个 profile、同一份会话**、同一个端口 |
+| **B. 独立实例**（要数据分家就选它） | `npx --yes @dsh-workbench/core@latest setup` → `npx @dsh-workbench/core` | 另一个 profile、另一个端口（:3081），他自己那份 `dsh web` **一行不改** |
+
+一条路径一句话：**A = 点一下装（单 profile）；B = `setup` 然后起（双 profile）**。
+取舍与代价见 [`docs/adr/0037`](../../../docs/adr/0037-workbench-installs-into-any-profile.md)。
 
 ## 一、对方机器上要有的
 
 | #   | 东西                         | 为什么                                                                                                                               | 怎么有                                       |
 | --- | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------- |
 | 1   | `dsh`                        | 本体。本仓库在 `0.1.7-rc.2` 上验过                                                                                                   | `npm i -g @deepseek-ai/dsh`（公网 npm 上有） |
-| 2   | `node` + **`pnpm`**          | dsh 的 `plugin` 子命令是**转发给 pnpm** 的；没有 pnpm 会直接报 `dsh: pnpm was not found`                                             | 各自装                                       |
-| 3   | 跑过一次 `dsh web`           | `setup` 拿 `~/.dsh/profiles/web` 当模板（bundle 清单 + 设置快照 + patch 点名的依赖）。没有它会**明确报错**，不会静默建出半个 profile | `dsh web`                                    |
-| 4   | 内网源登录                   | 包带 `@pagoda` scope，公网上没有它                                                                                                   | 见第二节                                     |
-| 5   | Coding 账号 + opencli 登录态 | 面板的数据来自 opencli 的 coding 插件                                                                                                | 见第四节                                     |
+| 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` 出号即可 |
+| 5   | Coding 账号 + opencli 登录态 | 面板的数据来自 opencli 的 coding 插件                                                                                                | 见第五节                                     |
 
-## 二、两步装
+## 二、A：装进他自己的 `dsh web`（插件页，一条龙）
 
-```bash
-# ① 让 pnpm/npx 知道 @pagoda 这个 scope 在哪个源，并登录（各一次）
-npm config set @pagoda:registry "$NPM_REGISTRY"
-npm login --registry=$NPM_REGISTRY
+在 `dsh web`（:3080）里：
+
+1. 侧栏 **Plugins → Add plugin**，填 `@dsh-workbench/core`；
+2. **Install → Enable now**；
+3. **刷新一次页面**（客户端 bundle 是页面加载时装进去的）。
+
+装完左栏就是工作台、右侧多出面板列。缺的那几件（隔离 opencli 的入口、`dsh-wb-module`、
+DIY 工坊骨架、可写根）由**外壳自己**补齐 —— 不用跑 `setup`，也不用起第二个实例。
+
+差别（先跟对方说清）：**会话 / 存储不分家**（接着用他原来那份）、**没有独立端口与进程**、
+**改外壳源码不热重载**、DIY 工坊依赖是首次启动在后台装的。
 
-# ② 建 profile + 把工作台装进去，然后起（占 :3081，dsh web 继续用 :3080）
+## 三、B：两步装（独立 profile，占 :3081）
+
+```bash
+# ① 建 profile + 把工作台装进去，然后起（占 :3081，dsh web 继续用 :3080）
 npx --yes @dsh-workbench/core@latest setup
 npx @dsh-workbench/core
 ```
 
-**为什么必须有 `@pagoda:registry` 那一行**：不带 scope 的 `dsh-workbench`
-公网上已经有别人的一个（`lee259/dsh-workbench`），所以我们的包必须带 scope；
-而带 scope 的包，pnpm / npx 只会去 `.npmrc` 里**给这个 scope 指的那个源**找它 ——
-不设这一行，症状是 `404 Not Found - GET https://registry.npmjs.org/@pagoda%2fdsh-workbench`。
+> 若团队后来把包改发到内网源，这两条命令之前要各加一次：
+> `npm config set @<scope>:registry "$NPM_REGISTRY"` 与 `npm login --registry=$NPM_REGISTRY`。
+> 不设的话症状是 `404 Not Found - GET https://registry.npmjs.org/@<scope>%2F…`。
 
 > ⚠️ **0.1.6 的已知缺陷**：`setup` 可能死在
 > `…/@dsh-workbench/core/scripts/seed-profile.sh: Permission denied`（发出去的包里随包脚本丢了
@@ -76,7 +94,7 @@ Settings → 插件里把 `@dsh-workbench/core` 关掉后，工作台会**退化
 要重新同步得重跑 `setup`。有意共享的只有两样：**API 凭据**（`~/.dsh/.credentials.yaml`，
 一机一把 key）和 `$DSH_HOME/cordis.patch.yml`（机器公共层，对所有 profile 实时生效）。
 
-## 三、不想用 npx？仓库副本也可以
+## 四、不想用 npx？仓库副本也可以
 
 `bin/dsh-workbench` 认得出自己是不是仓库副本（看有没有 `.git`）：
 
@@ -88,7 +106,7 @@ git clone <仓库> && cd dsh-workbench && pnpm install
 
 两种身份装出来的东西**同一个包名**，所以对方以后换成正装也不会打架。
 
-## 四、数据通路（面板要有数据）
+## 五、数据通路（面板要有数据）
 
 1. **opencli 隔离运行时**。第一次打开工作台，启动体检会**自己装**它（`@jackwener/opencli`，
    公网包），落在 `$DSH_HOME/workbench/opencli/toolchain/`，**与对方本机的 `opencli` 完全隔离**
@@ -142,35 +160,52 @@ git clone <仓库> && cd dsh-workbench && pnpm install
    装的时候 `bin/opencli-isolated` 会把 `~/.npmrc` 指回去，就为了拿到源的 token；
    npm 缓存则一律落在那台机器自己的隔离运行时里（**不碰** `~/.npm`）。
 
-## 五、不用管的
+## 六、不用管的
 
 - **`dsh web` 一行不改**：`./scripts/verify.sh` 是外部证据 —— 比对 web 的 profile 哈希、
   两个 profile 的组合树差异、数据是否分家，而不是自证。
 - 会话 / 存储 / 附件各自独立；工作台是**另一个端口、另一个进程**，可与 `dsh web` 同开。
 - 改工作台设置只落在 `profiles/workbench/cordis.patch.yml`。
 
-## 六、发版（发起人）
+## 七、发版（发起人）
 
 ```bash
 cd <仓库根>
-pnpm release:dry   # 门禁 + 发布计划 + 打包清单校验，不联网、不真发
-pnpm release             # 真发（发前会再跑一次门禁）
+pnpm release:dry   # 彩排：门禁 → 选版本号 → 构建 → publish --dry-run；不上传，结束回滚版本号
+pnpm release       # 真发：上面那一串 + 逐包上传 + git 收尾（提交 / tag / 推送）
 ```
 
-提版本号之后再发：`npm version patch`。脚本把几个坑写成了**硬失败**：
+不用先 `npm version`：版本号由脚本选（交互，或 `--target 0.2.0`），同步到根与所有包的
+manifest；彩排结束、以及「零上传」的失败，都会自动回滚。
+
+**门禁整次发布只跑一遍**（preflight 那次 `pnpm run check`；`--resume` 也跑）。发布走
+`pnpm -r publish --ignore-scripts`：各包的 `prepublishOnly` / `prepack` 是留给**手敲**
+`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。
+
+脚本把这几件事变成**硬失败**（都在任何上传之前）：
+
+- **工作区不干净** → 默认拒（发布会把它们 `git add -A` 一起提交），`--allow-dirty` 才放行；
+- **目标版本必须高于当前版本**；目标版本若在源上**已完整存在**，直接拒（要补发用 `--resume`）；
+- **npm 没登录** → 就地拉起 `npm login`；
+- **彩排不过**（`publish --dry-run` 打不出包）→ 零上传退出。
+
+只能自己盯、脚本不查的两条：
 
 - **`dist/` 在 `.gitignore` 里**：npm 打包的兜底就是 `.gitignore`，不在 `files` 里显式列出
-  就会漏掉构建产物 —— 症状不是报错，而是"别人装上后宿主侧起不来"；
-- 版本号在源上已被占（pnpm 到最后一步才报，白等一轮门禁）；
-- `private: true` 没摘；
+  就会漏掉构建产物 —— 症状不是报错，而是"别人装上后宿主侧起不来"（外壳与 `module-hello` 的
+  `files` 都显式列了 `dist` / `client.js`，但发布脚本不核这件事）；
 - **随包脚本的可执行位**：`pnpm publish` 只给 `package.json#bin` 点名的那**一个**文件 755，
   其余在 tarball 里一律 644（`npm pack` 会保留，而 git 里的 x 位不进 tarball）——
   所以随包脚本一律不吃 x 位：启动器里 `bash` 呼 `seed-profile.sh`、opencli 那条稳定路径写成
-  自己拥有的转发脚本，`selfcheck` 有一条判据钉着。这类错**本机复现不出来**，只在别人机器上炸
+  自己拥有的转发脚本。这条由外壳 `selfcheck` 的判据钉着（门禁里跑）。
+  这类错**本机复现不出来**，只在别人机器上炸
   （0.1.6 就是这么坏在 `seed-profile.sh: Permission denied` 上的，见
   [`.scratch/dsh-ui-alignment/spec.md`](../../../.scratch/dsh-ui-alignment/spec.md) §18.41）。
 
-## 七、版本与兼容（实话）
+## 八、版本与兼容（实话）
 
 `package.json` 的 `peerDependencies` 里**没有** `@deepseek-ai/dsh`，这是有意的：
 dsh 目前是 `0.1.7-rc.2`（预发布），声明范围会让版本不一致的人**装不上**；不声明则是
@@ -195,29 +230,31 @@ dsh 会用这条做**安装预检**（`evaluatePluginCompatibility`），不满
 ## 发布（一个脚本，一条命令）
 
 ```bash
-pnpm release            # 门禁 → 计划 → 逐包：登录 → 版本没被占 → 打包清单 → 发
-pnpm release:dry        # 不联网：门禁 → 计划 → 打包清单校验
+pnpm release            # 门禁 → 选版本号 → 构建 → 彩排 → 逐包上传 → git 收尾
+pnpm release:dry        # 同上，但 publish 只 dry-run：零上传，结束回滚版本号
 ```
 
-`scripts/release.mjs` 是**唯一**的发布入口（曾经的 `publish.sh` + `release-plan.mjs` 已合并进来）。
-谁要发、发到哪、要发什么，全部从各包自述清单读，不写死名单：
+`scripts/release.mjs` 是**唯一**的发布入口。发什么、发到哪、谁先谁后，都从各包自述清单读：
 
-- **发不发** = 有 `publishConfig.registry`，或 `publishConfig.access === 'public'`（默认 npmjs）；`private: true` 一律不发；
-- **发什么** = 包自己声明的 `exports` / `bin` / `dsh.bundle.patch` 那几份文件必须在（`dist/`、`client.js` 在 `.gitignore` 里，漏了 `files` 的症状是"装上后宿主侧起不来"，不是报错）；
-- **什么顺序** = 依赖优先（`shared` → `core` → 用到它们的模块）；依赖的包这次不发就报错；
-- **公网包**用 `--access public`，内网源不加这个参数。
+- **发不发** = `packages/*` 一级目录里，非 `private` 且自述了 `publishConfig`（`access` 或 `registry`）；
+  私有模块必须显式写发布目标这条，由门禁的 `contracts` 判据守着（不许默认落到公网）；
+- **发到哪** = 包自己的 `publishConfig.registry`（pnpm 在 recursive publish 里逐包取它），没写的
+  落到脚本顶部的 `REGISTRY`（npmjs）；本仓现在这 4 个包都发公网，命令一律带 `--access public`。
+  注意 `inspectTarget` **只查 npmjs** —— "这个版本发出去没有"对发内网源的包看不准；
+- **什么顺序** = pnpm 自己拓扑排序（`shared` → `core` → 用到它们的模块）；
+- **发什么** = pnpm 按各包 `files` / `.gitignore` 打包；**打包清单没人替你核**（见上一章
+  「只能自己盯」）。要看清单用 `dsh-wb-module publish`：它只 dry-run、打印清单，不发布。
 
-它替你把四件事变成硬失败：**门禁绿 · 计划成立 · 打包清单真的有产物 · 这个版本号在源上还没人占**。
-发布用 `pnpm publish`（不是 `npm publish`）：只有 pnpm 会把 `workspace:*` 改写成真实版本，
+发布必须走 `pnpm publish`（不是 `npm publish`）：只有 pnpm 会把 `workspace:*` 改写成真实版本，
 `npm pack` / `npm publish` 不会 —— 直接发别人装不上。
 
-### 版本同步规则（脚本会替你拦）
+### 版本同步规则（约定 —— 门禁只守其中一条）
 
 | 关系 | 规则 |
 | --- | --- |
-| 模块 ↔ 外壳 | 模块 `peerDependencies['@dsh-workbench/core'] = ^0.1.0`。**`^0.x` 锁次版本**：外壳升到 `0.2.0` 时 `^0.1.0` 不再满足，脚本当场报 —— 要把每个模块的范围一起改（或一起升） |
+| 模块 ↔ 外壳 | 模块 `peerDependencies['@dsh-workbench/core'] = ^0.1.0`。**`^0.x` 锁次版本**：外壳升到 `0.2.0` 时 `^0.1.0` 不再满足 —— 要把每个模块的范围一起改（或一起升）。门禁只守"peer 依赖存在"（`contracts` 判据），**范围合不合体没人替你算**，靠自觉 |
 | `shared` ↔ 外壳/模块 | 依赖写的是 `workspace:*`，发布时会被改写成**当时那个版本号** → `shared` 必须先发；`shared` 升版后，用到它的包要重新发一次才会带上新范围 |
-| `module-tools` ↔ `init` 模板 | 模板里 `@dsh-workbench/core` / `module-tools` 的范围要跟着本仓版本走，否则 `init` 生成的是过期范围（脚本已检查这一条） |
+| `module-tools` ↔ `init` 模板 | 模板里 `@dsh-workbench/core` / `module-tools` 的范围要跟着本仓版本走，否则 `init` 生成的是过期范围 —— **现在没有任何判据检查它**（上一版 release 脚本查过，换成现在这份之后这条没了），升外壳次版本时记得一起改 |
 
 ### 中断了怎么续跑（发布是可中断的）
 
@@ -228,7 +265,8 @@ pnpm release:resume      # 从现场恢复；**已在源上的包自动跳过**
 ```
 
 - **不带 `--resume` 重跑会被拒**：目标版本必须高于当前版本；源上若已有同名同版本，脚本会说"先提版本号"。这正是为续跑设计的语义（不是 bug）。
+- **`--resume` 照样跑一遍门禁**：断了之后很可能改过包，而门禁整次发布只有 preflight 那一处。真要跳过用 `--skip-gate`（发布不会再补跑一遍）。
 - `pnpm release:dry` 是**彩排**：改版本号 → 构建 → `publish --dry-run` → **回滚本地版本号**，不上传。
 - 发布**成功之后**才做 git 收尾：`git add -A` → `commit -m "chore: 发布版本 v<ver>"` → `tag v<ver>` → `push` → `push origin v<ver>`。git 收尾失败时包已经发出去了，脚本会把该手打的命令打出来，并提示可以 `pnpm release:resume`。
-- 常用旗标：`--target <ver>` 跳出版本选择 · `-y/--yes` 跳过确认 · `--allow-dirty` · `--skip-gate`（不推荐） · `--skip-rehearsal`（不推荐）。
+- 常用旗标：`--target <ver>` 跳出版本选择 · `-y/--yes` 跳过确认 · `--allow-dirty` · `--skip-gate` / `--skip-rehearsal`（都不推荐） · `--skip-build`（用磁盘上现有产物 —— `prepack` 已关，不再兜底重建）。
 - 依赖：`enquirer`（交互选择版本）与 `semver`（版本比较）是根上的 devDependencies。

package/docs/OPERATIONS.md

@@ -28,7 +28,28 @@
 前提：`dsh` 和 `pnpm` 在 PATH 上（`dsh plugin` 是转发给 pnpm 的），
 且 `~/.dsh/profiles/web` 已存在（跑过一次 `dsh web` 即可）。
 
-**给别人用**（发包到内网源、对方要登录内网源 / Coding）见 [`HANDOFF.md`](HANDOFF.md)。
+**给别人用**（两条路：插件页装进他自己的 web / 独立实例 `setup`；包在公网 npm 上）见 [`HANDOFF.md`](HANDOFF.md)。
+
+### 变体：装进**当前** profile（在 `dsh web` 里装，不起第二个实例）
+
+`dsh web` 侧栏 **Plugins → Add plugin** → 填 `@dsh-workbench/core`（公网 npm 上有，默认源即可）
+→ **Install → Enable now** → **刷新页面**。装的就是 `dsh web` 自己那个 profile。
+
+**完成判据**：刷新后左栏是工作台的、右侧出现面板列；`$DSH_HOME/workbench/opencli/bin/opencli`
+存在且指向本包 `bin/opencli-isolated`；`$DSH_HOME/workbench/bin/dsh-wb-module` 可执行
+（这三条不再依赖启动器 —— 宿主自举写的）。
+
+这条路上没有启动器，缺的几件由**宿主自举**补齐（建目录、写隔离 opencli 入口、前插 `PATH`、
+后台建 DIY 工坊骨架），可写根由 bundle 层那一行 `sandbox-policy` 放行 —— 见
+[ADR-0037](../../../docs/adr/0037-workbench-installs-into-any-profile.md)。
+
+自举是**静默**的：它写了什么只在宿主日志里，后台脚本（工坊骨架 / 依赖）的输出在
+`$DSH_HOME/workbench/seed.log`。DIY 那个工坊“怎么都没建起来”时先看这两个地方。
+
+差别：**会话 / 存储不隔离**（接着用你原来那份）、**没有独立端口与进程**、
+**改外壳源码不热重载**、DIY 工坊依赖是首次启动在后台装的（几百 MB，失败只落日志）。
+
+撤销：Plugins 页卸载 `@dsh-workbench/core`（配置与数据不清）；`~/.dsh/workbench/**` 想清就手删。
 
 ## 日常
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-workbench/core",
-  "version": "0.1.15",
+  "version": "0.1.17",
   "description": "个人工作台：Agent 工作台外壳（左栏 + 常驻对话 + 自研右侧数据面板）。",
   "type": "module",
   "icon": "./icon.svg",
@@ -22,7 +22,7 @@
   "bin": {
     "dsh-workbench": "./bin/dsh-workbench"
   },
-  "//files": "npm 的兜底是 .gitignore —— 而 dist/ 在 .gitignore 里，不显式列出就会**漏掉宿主入口**（exports['.'] 指向它）。发出去之前用 npm pack --dry-run 数一遍 dist/ 有几条。skills/ 是 DIY 模式挂给 agent 的指引（经 skill-filesystem 的 customSkillDirs 挂载），漏了不报错、只是 DIY 的 agent 什么都不知道 —— selfcheck 有一条判据盯着它。",
+  "//files": "npm 的兜底是 .gitignore —— 而 dist/ 在 .gitignore 里，不显式列出就会**漏掉宿主入口**（exports['.'] 指向它）。发出去之前用 npm pack --dry-run 数一遍 dist/ 有几条。skills/ 是 DIY 模式挂给 agent 的指引（经 skill-filesystem 的 customSkillDirs 挂载），漏了不报错、只是 DIY 的 agent 什么都不知道 —— selfcheck 有一条判据盯着它。scripts/ 下是**随包出货的脚本**：启动器与宿主自举都要跑它们（seed-profile.sh / seed-workshop.sh），漏一个的症状是「仓库里怎么都对、装出去那台静默什么也没做」。",
   "files": [
     "dist",
     "client.js",
@@ -33,6 +33,7 @@
     "skills",
     "preset",
     "scripts/seed-profile.sh",
+    "scripts/seed-workshop.sh",
     "README.md",
     "docs/HANDOFF.md",
     "docs/OPERATIONS.md"
@@ -81,12 +82,12 @@
     "vite": "^8.3.1",
     "vitest": "^5.0.2"
   },
-  "//publishConfig": "只影响**发布这个包**，不影响别人解析依赖。内网源地址在这一处（交接文档里写给对方的也是这一条）。",
+  "//publishConfig": "只影响**发布这个包**，不影响别人解析依赖。现在发**公网 npm**（scripts/release.mjs 走 registry.npmjs.org），所以这里只有 access；哪天真要改发内网源，地址写在这一段的 registry 里（release.mjs 会优先读它）。",
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
-    "@dsh-workbench/shared": "0.1.15"
+    "@dsh-workbench/shared": "0.1.17"
   },
   "scripts": {
     "build": "node scripts/build.mjs && node scripts/build-types.mjs",