@dsh-workbench/shared 1.1.15 → 1.1.17

package/dist/api/dsh.d.ts

@@ -199,10 +199,40 @@ export interface DshAgentPresetRow {
     readonly broken?: string;
 }
 /**
- * 宿主侧的 agent preset 名册（服务名 `agentPresets`）：只读它的 `list()` —— 启动体检拿它判 DIY 模式挂不挂得起来。
+ * 一条 agent preset 的定义：`@deepseek-ai/dsh-agent-preset` 收的那份配置（`plugins` 是整表插件行）。
+ * DIY 的那一份在启动时从这一轮 dsh 的 `standard` 现场派生，不再有生成物。
+ */
+export interface DshAgentPresetDefinition {
+    readonly id: string;
+    readonly name?: string;
+    readonly description?: string;
+    readonly order?: number;
+    readonly plugins: readonly unknown[];
+}
+/** 注册成功后拿到的注销函数；插件卸载时调它，别把 preset 留在名册里。 */
+export type DshAgentPresetUnregister = () => Promise<void>;
+/**
+ * 宿主侧的 agent preset 名册（服务名 `agentPresets`）：`list()` 给启动体检读，`register()` 给 DIY 注册现场派生出来的那份。
  */
 export interface DshAgentPresetRegistry {
     list(): Promise<readonly DshAgentPresetRow[]>;
+    register?(definition: DshAgentPresetDefinition): Promise<DshAgentPresetUnregister>;
+}
+/**
+ * dsh loader 里的一行：只读插件名与它收到的原始 config。
+ * DIY 从 `standard` 那一行的 config 现场派生；loader 的 `entries()` 递归给出这一轮组合里的所有行。
+ */
+export interface DshLoaderEntry {
+    readonly id?: string;
+    readonly disabled?: boolean;
+    readonly options?: {
+        readonly name?: string;
+        readonly config?: unknown;
+    };
+}
+/** loader 服务（服务名 `loader`）：插件行都在它的 `entries()` 里。 */
+export interface DshLoader {
+    entries(): Iterable<DshLoaderEntry>;
 }
 /**
  * 把相对路径拼成 dsh home 下的绝对路径（服务名 dshHomePath）；外壳存自己的状态用它，不自己拼 home。

package/dist/contract/protocol/bundle-install.d.ts

@@ -66,6 +66,12 @@ export interface BundlePackageResult {
     readonly logPath: string;
     readonly kind?: BundleFailureKind;
 }
+export interface BundleIncompatible {
+    readonly name: string;
+    readonly version: string;
+    readonly runtimeVersion: string;
+    readonly requirements: Readonly<Record<string, string>>;
+}
 export interface BundleChange {
     readonly application: BundleApplication;
     readonly stage: BundleChangeStage;
@@ -75,6 +81,7 @@ export interface BundleChange {
     readonly version?: string;
     readonly errorCode?: string;
     readonly errorDetail?: string;
+    readonly incompatible?: readonly BundleIncompatible[];
     readonly packageResult?: BundlePackageResult;
     readonly pendingBuilds?: readonly string[];
     readonly restartReason?: RestartReason;
@@ -87,6 +94,48 @@ export interface BundleInstallRequest {
     readonly approvedBuilds?: readonly string[];
 }
 export type BundleCancellation = 'cancelled' | 'too-late' | 'not-running';
+export type BundleVersionProblem = 'not-updatable' | 'not-found' | 'network' | 'unknown';
+export interface BundleRegistryAttempt {
+    readonly registry: BundleRegistry;
+    readonly problem?: BundleVersionProblem;
+    readonly reason?: string;
+}
+export interface BundleVersionEntry {
+    readonly version: string;
+    readonly publishedAt?: string;
+    readonly tags: readonly string[];
+    readonly prerelease: boolean;
+    readonly bundle: boolean;
+    readonly deprecated?: string;
+    readonly incompatible?: BundleIncompatible;
+}
+export interface BundleVersionListListed {
+    readonly status: 'listed';
+    readonly installed: string;
+    readonly registry: BundleRegistry;
+    readonly attempts: readonly BundleRegistryAttempt[];
+    readonly versions: readonly BundleVersionEntry[];
+    readonly omitted: number;
+}
+export interface BundleVersionListRefused {
+    readonly status: 'refused';
+    readonly problem: BundleVersionProblem;
+    readonly reason: string;
+    readonly attempts: readonly BundleRegistryAttempt[];
+}
+export type BundleVersionList = BundleVersionListListed | BundleVersionListRefused;
+export type BundleUpdateStep = 'check' | 'remove' | 'install';
+export interface BundleUpdateOutcome {
+    readonly from: string;
+    readonly to: string;
+    readonly step: BundleUpdateStep;
+    readonly change: BundleChange;
+    readonly restore?: BundleChange;
+}
+export interface BundleUpdateRequest {
+    readonly registry?: BundleRegistry;
+    readonly requestId?: string;
+}
 export type BundleSupplyState = 'not-a-module' | 'no-needs' | 'installed' | 'failed' | 'pending-restart';
 export interface BundleModulePayload {
     readonly kind: 'module' | 'not-module' | 'unknown';
@@ -131,6 +180,7 @@ export interface ModuleVersion {
     readonly local?: boolean;
     readonly refused?: readonly string[];
     readonly market?: MarketInstalledModule;
+    readonly versions?: BundleVersionList;
     readonly spec?: string;
     readonly registry?: string;
 }

package/dist/host/adapter-types.d.ts

@@ -1,4 +1,4 @@
-import type { BundleCancellation, BundleChange, BundleInspection, BundleInstallRequest, BundleRegistries, BundleRegistry } from '../contract/protocol/bundle-install.js';
+import type { BundleCancellation, BundleChange, BundleInspection, BundleInstallRequest, BundleRegistries, BundleRegistry, BundleUpdateOutcome, BundleUpdateRequest, BundleVersionList } from '../contract/protocol/bundle-install.js';
 export type InstalledModule = {
     readonly kind: 'module';
     readonly pkg: string;
@@ -34,6 +34,9 @@ export interface BundleManager {
     remove(name: string): Promise<BundleChange | null>;
     setEnabled?(name: string, enabled: boolean): Promise<BundleChange | null>;
     cancel(requestId: string): Promise<BundleCancellation | null>;
+    listVersions?(name: string, registry?: BundleRegistry): Promise<BundleVersionList | null>;
+    updateBundle?(name: string, version: string, request?: BundleUpdateRequest): Promise<BundleUpdateOutcome | null>;
+    waitForInstall?(requestId: string): Promise<BundleChange | null>;
 }
 export interface RegistryEntry {
     readonly scope: string;

package/dist/host/bundle-manager.js

@@ -86,6 +86,7 @@ function asChange(raw) {
     const version = asText(record.version);
     const errorCode = error === undefined ? '' : asText(error.code);
     const errorDetail = error === undefined ? '' : asText(error.diagnostic);
+    const incompatible = asIncompatibleList(error?.incompatible);
     return {
         application,
         stage,
@@ -95,6 +96,7 @@ function asChange(raw) {
         ...(version === '' ? {} : { version }),
         ...(errorCode === '' ? {} : { errorCode }),
         ...(errorDetail === '' ? {} : { errorDetail }),
+        ...(incompatible.length === 0 ? {} : { incompatible }),
         ...(packageResult === undefined ? {} : { packageResult }),
         ...(pendingBuilds.length === 0 ? {} : { pendingBuilds }),
         ...(restartReason === undefined ? {} : { restartReason }),
@@ -139,6 +141,138 @@ function asInspection(raw) {
         ...(host === '' ? {} : { host }),
     };
 }
+const VERSION_PROBLEMS = ['not-updatable', 'not-found', 'network', 'unknown'];
+const UPDATE_STEPS = ['check', 'remove', 'install'];
+function asRequirementMap(value) {
+    const record = asRecord(value);
+    if (record === undefined)
+        return {};
+    const entries = [];
+    for (const [key, raw] of Object.entries(record)) {
+        if (typeof raw === 'string')
+            entries.push([key, raw]);
+    }
+    return Object.fromEntries(entries);
+}
+function asIncompatible(raw) {
+    const record = asRecord(raw);
+    if (record === undefined)
+        return undefined;
+    const name = asText(record.name);
+    const version = asText(record.version);
+    const runtimeVersion = asText(record.runtimeVersion);
+    if (name === '' || version === '' || runtimeVersion === '')
+        return undefined;
+    return { name, version, runtimeVersion, requirements: asRequirementMap(record.requirements) };
+}
+function asIncompatibleList(raw) {
+    if (!Array.isArray(raw))
+        return [];
+    const rows = [];
+    for (const item of raw) {
+        const entry = asIncompatible(item);
+        if (entry !== undefined)
+            rows.push(entry);
+    }
+    return rows;
+}
+function asRegistryAttempt(raw) {
+    const record = asRecord(raw);
+    if (record === undefined)
+        return undefined;
+    const registry = asRegistry(record.registry);
+    if (registry === undefined)
+        return undefined;
+    const problem = pick(VERSION_PROBLEMS, record.problem);
+    const reason = asText(record.reason);
+    return {
+        registry,
+        ...(problem === undefined ? {} : { problem }),
+        ...(reason === '' ? {} : { reason }),
+    };
+}
+function asRegistryAttempts(raw) {
+    if (!Array.isArray(raw))
+        return [];
+    const rows = [];
+    for (const item of raw) {
+        const attempt = asRegistryAttempt(item);
+        if (attempt !== undefined)
+            rows.push(attempt);
+    }
+    return rows;
+}
+function asVersionEntry(raw) {
+    const record = asRecord(raw);
+    if (record === undefined)
+        return null;
+    const version = asText(record.version);
+    if (version === '')
+        return null;
+    const publishedAt = asText(record.publishedAt);
+    const deprecated = asText(record.deprecated);
+    const incompatible = asIncompatible(record.incompatible);
+    return {
+        version,
+        tags: asTextArray(record.tags),
+        prerelease: record.prerelease === true,
+        bundle: record.bundle === true,
+        ...(publishedAt === '' ? {} : { publishedAt }),
+        ...(deprecated === '' ? {} : { deprecated }),
+        ...(incompatible === undefined ? {} : { incompatible }),
+    };
+}
+function asVersionList(raw) {
+    const record = asRecord(raw);
+    if (record === undefined)
+        return null;
+    const status = asText(record.status);
+    const attempts = asRegistryAttempts(record.attempts);
+    if (status === 'refused') {
+        return {
+            status: 'refused',
+            problem: pick(VERSION_PROBLEMS, record.problem) ?? 'unknown',
+            reason: asText(record.reason),
+            attempts,
+        };
+    }
+    if (status !== 'listed')
+        return null;
+    const registry = asRegistry(record.registry);
+    const versions = [];
+    if (Array.isArray(record.versions)) {
+        for (const item of record.versions) {
+            const entry = asVersionEntry(item);
+            if (entry !== null)
+                versions.push(entry);
+        }
+    }
+    return {
+        status: 'listed',
+        installed: asText(record.installed),
+        registry: registry ?? null,
+        attempts,
+        versions,
+        omitted: typeof record.omitted === 'number' ? record.omitted : 0,
+    };
+}
+function asUpdateOutcome(raw) {
+    const record = asRecord(raw);
+    if (record === undefined)
+        return null;
+    const step = pick(UPDATE_STEPS, record.step);
+    const change = asChange(record.result);
+    if (step === undefined || change === null)
+        return null;
+    const restore = record.restore === undefined ? null : asChange(record.restore);
+    return {
+        from: asText(record.from),
+        to: asText(record.to),
+        step,
+        change,
+        ...(restore === null ? {} : { restore }),
+    };
+}
 export function readBundleManager(ctx) {
     const face = ctx.get(MANAGER_SERVICE);
     if (face === undefined)
@@ -177,5 +311,24 @@ export function readBundleManager(ctx) {
                 return null;
             return pick(CANCELLATIONS, (asRecord(await face.cancelInstall(requestId)) ?? {}).status) ?? null;
         },
+        async listVersions(name, registry) {
+            if (typeof face.listVersions !== 'function')
+                return null;
+            return asVersionList(await face.listVersions(name, registry === undefined ? undefined : { registry }));
+        },
+        async updateBundle(name, version, request = {}) {
+            if (typeof face.updateBundle !== 'function')
+                return null;
+            const options = {
+                ...(request.registry === undefined ? {} : { registry: request.registry }),
+                ...(request.requestId === undefined ? {} : { requestId: request.requestId }),
+            };
+            return asUpdateOutcome(await face.updateBundle(name, version, options));
+        },
+        async waitForInstall(requestId) {
+            if (typeof face.waitForInstall !== 'function')
+                return null;
+            return asChange(await face.waitForInstall(requestId));
+        },
     };
 }

package/dist/host/diy-preset.d.ts

@@ -0,0 +1,26 @@
+import type { DshAgentPresetDefinition, DshLoaderEntry } from '../api/dsh.js';
+/** DIY preset 在模式菜单里的名字。 */
+export declare const DIY_PRESET_NAME = "\u5DE5\u4F5C\u53F0 DIY \u6A21\u5F0F";
+/** DIY preset 在模式菜单里的说明。 */
+export declare const DIY_PRESET_DESCRIPTION = "\u770B / \u8C03\u8FD9\u4E2A\u5DE5\u4F5C\u533A\u7684\u9762\u677F\uFF0C\u6216\u8005\u7ED9\u5B83\u9020\u4E00\u5757\u65B0\u5185\u5BB9 \u2014\u2014 \u7528\u5927\u767D\u8BDD\u8BF4\u5C31\u884C\u3002\u4EFB\u4F55\u5DE5\u4F5C\u533A\u90FD\u80FD\u7528\uFF08\u7A7A\u9879\u76EE\u4E5F\u7B97\uFF09\uFF1Bagent \u4F1A\u770B\u9762\u677F\u3001\u6293\u8BF7\u6C42\uFF0C\u5FC5\u8981\u65F6\u628A\u6A21\u5757\u9020\u51FA\u6765\u88C5\u4E0A\u3002\u4E0D\u7528\u5199\u4EE3\u7801\u3002";
+/** DIY preset 在模式菜单里的排序（排在 dsh 出厂的几个模式之后）。 */
+export declare const DIY_PRESET_ORDER = 9;
+/** 这一轮 dsh 的 standard preset 没法派生时抛的错：带上哪一段锚点变了。 */
+export declare class DiyPresetSourceError extends Error {
+    constructor(message: string);
+}
+/**
+ * 从这一轮 dsh 的 `standard` preset 配置派生 `workbench-diy`。
+ *
+ * 差分只有三处：`skill-filesystem` 与 `tool-skill` 一起搬到末尾（前者加 `customSkillDirs` 指向工作台的
+ * `skills/`）、末尾补 `tool-cordis`、`tool-plugin-manager` 打开（工作台只活在 profile 里）。
+ * 其余行原样跟着 dsh 走，所以 dsh 加工具 / 改 config 时不需要重新生成任何文件。
+ * @param standard dsh loader 里 `preset-standard` 那一行收到的 config。
+ * @param skillsDir 工作台的 `skills/` 绝对路径。
+ */
+export declare function diyPresetFrom(standard: unknown, skillsDir: string): DshAgentPresetDefinition;
+/**
+ * 在 loader 的行里找这一轮 dsh 的 `standard` preset 配置；没有（或那一行被关掉）就算不知道。
+ * @param entries loader 的 `entries()`（递归给全部行）。
+ */
+export declare function standardPresetConfigOf(entries: Iterable<DshLoaderEntry>): unknown;

package/dist/host/diy-preset.js

@@ -0,0 +1,115 @@
+import { DIY_PRESET_ID } from '../contract/protocol/diy.js';
+const AGENT_PRESET_PLUGIN = '@deepseek-ai/dsh-agent-preset';
+const STANDARD_PRESET_ID = 'standard';
+/** DIY preset 在模式菜单里的名字。 */
+export const DIY_PRESET_NAME = '工作台 DIY 模式';
+/** DIY preset 在模式菜单里的说明。 */
+export const DIY_PRESET_DESCRIPTION = '看 / 调这个工作区的面板，或者给它造一块新内容 —— 用大白话说就行。任何工作区都能用（空项目也算）；agent 会看面板、抓请求，必要时把模块造出来装上。不用写代码。';
+/** DIY preset 在模式菜单里的排序（排在 dsh 出厂的几个模式之后）。 */
+export const DIY_PRESET_ORDER = 9;
+/** 这一轮 dsh 的 standard preset 没法派生时抛的错：带上哪一段锚点变了。 */
+export class DiyPresetSourceError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'DiyPresetSourceError';
+    }
+}
+function isRow(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function rowAt(value, at) {
+    if (!isRow(value))
+        throw new DiyPresetSourceError(`${at} 不是一行插件配置`);
+    return value;
+}
+function standardConfigOf(value) {
+    const standard = rowAt(value, 'dsh 的 standard preset');
+    if (!Array.isArray(standard.plugins)) {
+        throw new DiyPresetSourceError('dsh 的 standard preset 没有 plugins 表 —— 派生不出 DIY 那一份');
+    }
+    return standard;
+}
+function clonedPluginsOf(standard) {
+    let cloned;
+    try {
+        cloned = structuredClone(standard);
+    }
+    catch (error) {
+        throw new DiyPresetSourceError(`dsh 的 standard preset 配置复制不了：${String(error)}`);
+    }
+    const rows = rowAt(cloned, 'dsh 的 standard preset').plugins;
+    if (!Array.isArray(rows)) {
+        throw new DiyPresetSourceError('dsh 的 standard preset 没有 plugins 表 —— 派生不出 DIY 那一份');
+    }
+    return rows.map((row, index) => {
+        const parsed = rowAt(row, `dsh 的 standard preset 第 ${index + 1} 行`);
+        if (typeof parsed.name !== 'string' || parsed.name === '') {
+            throw new DiyPresetSourceError(`dsh 的 standard preset 第 ${index + 1} 行没有插件名`);
+        }
+        return parsed;
+    });
+}
+function takeRow(plugins, id) {
+    const index = plugins.findIndex((row) => row.id === id);
+    if (index < 0) {
+        throw new DiyPresetSourceError(`dsh 的 standard preset 里找不到 \`${id}\` 那一行 —— DIY 的差分锚点变了`);
+    }
+    return plugins.splice(index, 1)[0];
+}
+/**
+ * 从这一轮 dsh 的 `standard` preset 配置派生 `workbench-diy`。
+ *
+ * 差分只有三处：`skill-filesystem` 与 `tool-skill` 一起搬到末尾（前者加 `customSkillDirs` 指向工作台的
+ * `skills/`）、末尾补 `tool-cordis`、`tool-plugin-manager` 打开（工作台只活在 profile 里）。
+ * 其余行原样跟着 dsh 走，所以 dsh 加工具 / 改 config 时不需要重新生成任何文件。
+ * @param standard dsh loader 里 `preset-standard` 那一行收到的 config。
+ * @param skillsDir 工作台的 `skills/` 绝对路径。
+ */
+export function diyPresetFrom(standard, skillsDir) {
+    const plugins = clonedPluginsOf(standardConfigOf(standard));
+    const skillFilesystem = takeRow(plugins, 'skill-filesystem');
+    const toolSkill = takeRow(plugins, 'tool-skill');
+    skillFilesystem.config = {
+        ...(isRow(skillFilesystem.config) ? skillFilesystem.config : {}),
+        customSkillDirs: [skillsDir],
+    };
+    const manager = plugins.find((row) => row.id === 'tool-plugin-manager');
+    if (manager !== undefined)
+        manager.disabled = false;
+    if (!plugins.some((row) => row.id === 'tool-cordis')) {
+        plugins.push({ id: 'tool-cordis', name: '@deepseek-ai/dsh-tool-cordis' });
+    }
+    plugins.push(skillFilesystem, toolSkill);
+    const seen = new Set();
+    for (const row of plugins) {
+        if (typeof row.id !== 'string' || row.id === '')
+            continue;
+        if (seen.has(row.id)) {
+            throw new DiyPresetSourceError(`dsh 的 standard preset 里出现重复的 id：${row.id}`);
+        }
+        seen.add(row.id);
+    }
+    return {
+        id: DIY_PRESET_ID,
+        name: DIY_PRESET_NAME,
+        description: DIY_PRESET_DESCRIPTION,
+        order: DIY_PRESET_ORDER,
+        plugins,
+    };
+}
+/**
+ * 在 loader 的行里找这一轮 dsh 的 `standard` preset 配置；没有（或那一行被关掉）就算不知道。
+ * @param entries loader 的 `entries()`（递归给全部行）。
+ */
+export function standardPresetConfigOf(entries) {
+    for (const entry of entries) {
+        if (entry.disabled === true)
+            continue;
+        if (entry.options?.name !== AGENT_PRESET_PLUGIN)
+            continue;
+        const config = entry.options.config;
+        if (isRow(config) && config.id === STANDARD_PRESET_ID)
+            return config;
+    }
+    return undefined;
+}

package/dist/host.d.ts

@@ -36,6 +36,7 @@ export { configSyncAction, configSyncApply, configSyncHandler, configSyncSnapsho
 export * from './host/profile-create.js';
 export * from './host/context-ref.js';
 export * from './host/diy-debug.js';
+export * from './host/diy-preset.js';
 export * from './host/diy-record.js';
 export * from './host/env-policy.js';
 export * from './host/facts.js';

package/dist/host.js

@@ -36,6 +36,7 @@ export { configSyncAction, configSyncApply, configSyncHandler, configSyncSnapsho
 export * from './host/profile-create.js';
 export * from './host/context-ref.js';
 export * from './host/diy-debug.js';
+export * from './host/diy-preset.js';
 export * from './host/diy-record.js';
 export * from './host/env-policy.js';
 export * from './host/facts.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-workbench/shared",
-  "version": "1.1.15",
+  "version": "1.1.17",
   "description": "工作台与模块共享的纯代码与契约类型：类型、纯逻辑、哑组件、平台解析。宿主侧的东西从 /host 进（不影响浏览器产物）。",
   "license": "MIT",
   "type": "module",
@@ -34,7 +34,7 @@
   },
   "devDependencies": {
     "@arch-guard/core": "^0.11.3",
-    "@deepseek-ai/dsh-client-ui-primitives": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.2.1-rc.5",
     "@types/node": "^24.19.0",
     "@types/react": "^19.0.0",
     "@types/semver": "^7.8.0",

package/src/api/dsh.ts

@@ -195,10 +195,44 @@ export interface DshAgentPresetRow {
 }
 
 /**
- * 宿主侧的 agent preset 名册（服务名 `agentPresets`）：只读它的 `list()` —— 启动体检拿它判 DIY 模式挂不挂得起来。
+ * 一条 agent preset 的定义：`@deepseek-ai/dsh-agent-preset` 收的那份配置（`plugins` 是整表插件行）。
+ * DIY 的那一份在启动时从这一轮 dsh 的 `standard` 现场派生，不再有生成物。
+ */
+export interface DshAgentPresetDefinition {
+  readonly id: string;
+  readonly name?: string;
+  readonly description?: string;
+  readonly order?: number;
+  readonly plugins: readonly unknown[];
+}
+
+/** 注册成功后拿到的注销函数；插件卸载时调它，别把 preset 留在名册里。 */
+export type DshAgentPresetUnregister = () => Promise<void>;
+
+/**
+ * 宿主侧的 agent preset 名册（服务名 `agentPresets`）：`list()` 给启动体检读，`register()` 给 DIY 注册现场派生出来的那份。
  */
 export interface DshAgentPresetRegistry {
   list(): Promise<readonly DshAgentPresetRow[]>;
+  register?(definition: DshAgentPresetDefinition): Promise<DshAgentPresetUnregister>;
+}
+
+/**
+ * dsh loader 里的一行：只读插件名与它收到的原始 config。
+ * DIY 从 `standard` 那一行的 config 现场派生；loader 的 `entries()` 递归给出这一轮组合里的所有行。
+ */
+export interface DshLoaderEntry {
+  readonly id?: string;
+  readonly disabled?: boolean;
+  readonly options?: {
+    readonly name?: string;
+    readonly config?: unknown;
+  };
+}
+
+/** loader 服务（服务名 `loader`）：插件行都在它的 `entries()` 里。 */
+export interface DshLoader {
+  entries(): Iterable<DshLoaderEntry>;
 }
 
 /**

package/src/contract/protocol/bundle-install.ts

@@ -117,6 +117,13 @@ export interface BundlePackageResult {
   readonly kind?: BundleFailureKind;
 }
 
+export interface BundleIncompatible {
+  readonly name: string;
+  readonly version: string;
+  readonly runtimeVersion: string;
+  readonly requirements: Readonly<Record<string, string>>;
+}
+
 export interface BundleChange {
   readonly application: BundleApplication;
   readonly stage: BundleChangeStage;
@@ -126,6 +133,7 @@ export interface BundleChange {
   readonly version?: string;
   readonly errorCode?: string;
   readonly errorDetail?: string;
+  readonly incompatible?: readonly BundleIncompatible[];
   readonly packageResult?: BundlePackageResult;
   readonly pendingBuilds?: readonly string[];
   readonly restartReason?: RestartReason;
@@ -141,6 +149,57 @@ export interface BundleInstallRequest {
 
 export type BundleCancellation = 'cancelled' | 'too-late' | 'not-running';
 
+export type BundleVersionProblem = 'not-updatable' | 'not-found' | 'network' | 'unknown';
+
+export interface BundleRegistryAttempt {
+  readonly registry: BundleRegistry;
+  readonly problem?: BundleVersionProblem;
+  readonly reason?: string;
+}
+
+export interface BundleVersionEntry {
+  readonly version: string;
+  readonly publishedAt?: string;
+  readonly tags: readonly string[];
+  readonly prerelease: boolean;
+  readonly bundle: boolean;
+  readonly deprecated?: string;
+  readonly incompatible?: BundleIncompatible;
+}
+
+export interface BundleVersionListListed {
+  readonly status: 'listed';
+  readonly installed: string;
+  readonly registry: BundleRegistry;
+  readonly attempts: readonly BundleRegistryAttempt[];
+  readonly versions: readonly BundleVersionEntry[];
+  readonly omitted: number;
+}
+
+export interface BundleVersionListRefused {
+  readonly status: 'refused';
+  readonly problem: BundleVersionProblem;
+  readonly reason: string;
+  readonly attempts: readonly BundleRegistryAttempt[];
+}
+
+export type BundleVersionList = BundleVersionListListed | BundleVersionListRefused;
+
+export type BundleUpdateStep = 'check' | 'remove' | 'install';
+
+export interface BundleUpdateOutcome {
+  readonly from: string;
+  readonly to: string;
+  readonly step: BundleUpdateStep;
+  readonly change: BundleChange;
+  readonly restore?: BundleChange;
+}
+
+export interface BundleUpdateRequest {
+  readonly registry?: BundleRegistry;
+  readonly requestId?: string;
+}
+
 export type BundleSupplyState = 'not-a-module' | 'no-needs' | 'installed' | 'failed' | 'pending-restart';
 
 export interface BundleModulePayload {
@@ -198,6 +257,7 @@ export interface ModuleVersion {
   readonly local?: boolean;
   readonly refused?: readonly string[];
   readonly market?: MarketInstalledModule;
+  readonly versions?: BundleVersionList;
   readonly spec?: string;
   readonly registry?: string;
 }

package/src/host/__tests__/diy-preset.test.ts

@@ -0,0 +1,152 @@
+import { describe, expect, it } from 'vitest';
+import { DIY_PRESET_ID } from '../../contract/protocol/diy.js';
+import { DiyPresetSourceError, diyPresetFrom, standardPresetConfigOf } from '../diy-preset.js';
+
+const SKILLS = '/opt/workbench/skills';
+
+function standard(overrides: { plugins?: unknown[] } = {}) {
+  return {
+    id: 'standard',
+    order: 1,
+    plugins: overrides.plugins ?? [
+      { id: 'persona', name: '@deepseek-ai/dsh-persona', config: { prefix: 'x' } },
+      { id: 'tool-fs', name: '@deepseek-ai/dsh-tool-fs', config: { applyPatch: false } },
+      { id: 'skill-filesystem', name: '@deepseek-ai/dsh-skill-filesystem' },
+      { id: 'tool-skill', name: '@deepseek-ai/dsh-tool-skill' },
+      {
+        id: 'tool-plugin-manager',
+        name: '@deepseek-ai/dsh-plugin-manager/tools',
+        disabled: { __jsExpr: "!ctx.get('profileContext')" },
+      },
+    ],
+  };
+}
+
+const idsOf = (value: { plugins: readonly unknown[] }) =>
+  value.plugins.map((row) => (row as { id?: string }).id);
+
+describe('diyPresetFrom（从 dsh 的 standard 现场派生）', () => {
+  it('★ 三处差分都在：skill 两行搬到末尾、tool-cordis 补上、plugin-manager 打开', () => {
+    const derived = diyPresetFrom(standard(), SKILLS);
+    expect(idsOf(derived)).toEqual([
+      'persona',
+      'tool-fs',
+      'tool-plugin-manager',
+      'tool-cordis',
+      'skill-filesystem',
+      'tool-skill',
+    ]);
+    const manager = derived.plugins.find((row) => (row as { id?: string }).id === 'tool-plugin-manager') as {
+      disabled?: unknown;
+    };
+    expect(manager.disabled).toBe(false);
+    const skills = derived.plugins.find((row) => (row as { id?: string }).id === 'skill-filesystem') as {
+      config?: { customSkillDirs?: string[] };
+    };
+    expect(skills.config?.customSkillDirs).toEqual([SKILLS]);
+  });
+
+  it('★ 兄弟行原样跟着走：dsh 加工具 / 改 config 不需要重新生成任何文件', () => {
+    const source = standard();
+    const derived = diyPresetFrom(source, SKILLS);
+    const fs = derived.plugins.find((row) => (row as { id?: string }).id === 'tool-fs') as {
+      config?: { applyPatch?: boolean };
+    };
+    expect(fs.config?.applyPatch).toBe(false);
+    expect(derived.id).toBe(DIY_PRESET_ID);
+    expect(derived.name).toBe('工作台 DIY 模式');
+    expect(derived.order).toBe(9);
+  });
+
+  it('★ 输入的一份都不改（克隆后再动；否则会把 dsh 自己的 standard 也搬走两行）', () => {
+    const source = standard();
+    const manager = source.plugins.find((row) => (row as { id?: string }).id === 'tool-plugin-manager') as {
+      disabled?: unknown;
+    };
+    const skills = source.plugins.find((row) => (row as { id?: string }).id === 'skill-filesystem') as {
+      config?: unknown;
+    };
+    diyPresetFrom(source, SKILLS);
+    expect(idsOf(source)).toEqual([
+      'persona',
+      'tool-fs',
+      'skill-filesystem',
+      'tool-skill',
+      'tool-plugin-manager',
+    ]);
+    expect(manager.disabled).toEqual({ __jsExpr: "!ctx.get('profileContext')" });
+    expect(skills.config).toBeUndefined();
+  });
+
+  it('dsh 已经把 tool-cordis 列进 standard：不再补第二行', () => {
+    const derived = diyPresetFrom(
+      standard({
+        plugins: [
+          { id: 'skill-filesystem', name: '@deepseek-ai/dsh-skill-filesystem' },
+          { id: 'tool-skill', name: '@deepseek-ai/dsh-tool-skill' },
+          { id: 'tool-cordis', name: '@deepseek-ai/dsh-tool-cordis' },
+        ],
+      }),
+      SKILLS,
+    );
+    expect(idsOf(derived).filter((id) => id === 'tool-cordis')).toHaveLength(1);
+  });
+
+  it('★ 锚点变了就当场报错并点名（静默少一行 = DIY 会话少一把工具，且不报错）', () => {
+    expect(() =>
+      diyPresetFrom(
+        standard({ plugins: [{ id: 'tool-skill', name: '@deepseek-ai/dsh-tool-skill' }] }),
+        SKILLS,
+      ),
+    ).toThrow(/skill-filesystem/);
+    expect(() =>
+      diyPresetFrom(
+        standard({ plugins: [{ id: 'skill-filesystem', name: '@deepseek-ai/dsh-skill-filesystem' }] }),
+        SKILLS,
+      ),
+    ).toThrow(/tool-skill/);
+    expect(() => diyPresetFrom({ id: 'standard' }, SKILLS)).toThrow(DiyPresetSourceError);
+  });
+
+  it('★ standard 里出现重复 id 就不派生（别把一份带重复行的 preset 交给 dsh）', () => {
+    expect(() =>
+      diyPresetFrom(
+        standard({
+          plugins: [
+            { id: 'skill-filesystem', name: '@deepseek-ai/dsh-skill-filesystem' },
+            { id: 'tool-skill', name: '@deepseek-ai/dsh-tool-skill' },
+            { id: 'persona', name: '@deepseek-ai/dsh-persona' },
+            { id: 'persona', name: '@deepseek-ai/dsh-persona' },
+          ],
+        }),
+        SKILLS,
+      ),
+    ).toThrow(/persona/);
+  });
+});
+
+describe('standardPresetConfigOf（从 loader 的行里认 standard）', () => {
+  it('★ 认 agent-preset 插件 + config.id=standard，不是靠行 id 的 include 前缀', () => {
+    const found = standardPresetConfigOf([
+      { id: 'include:persona', options: { name: '@deepseek-ai/dsh-persona' } },
+      {
+        id: 'include:preset-standard',
+        options: { name: '@deepseek-ai/dsh-agent-preset', config: standard() },
+      },
+    ]);
+    expect(found).toBeDefined();
+  });
+
+  it('被关掉的那一行不算 / 没有 standard 就不猜', () => {
+    expect(
+      standardPresetConfigOf([
+        {
+          id: 'include:preset-standard',
+          disabled: true,
+          options: { name: '@deepseek-ai/dsh-agent-preset', config: standard() },
+        },
+      ]),
+    ).toBeUndefined();
+    expect(standardPresetConfigOf([])).toBeUndefined();
+  });
+});

package/src/host/adapter-types.ts

@@ -5,6 +5,9 @@ import type {
   BundleInstallRequest,
   BundleRegistries,
   BundleRegistry,
+  BundleUpdateOutcome,
+  BundleUpdateRequest,
+  BundleVersionList,
 } from '../contract/protocol/bundle-install.js';
 
 export type InstalledModule =
@@ -42,6 +45,9 @@ export interface BundleManager {
   remove(name: string): Promise<BundleChange | null>;
   setEnabled?(name: string, enabled: boolean): Promise<BundleChange | null>;
   cancel(requestId: string): Promise<BundleCancellation | null>;
+  listVersions?(name: string, registry?: BundleRegistry): Promise<BundleVersionList | null>;
+  updateBundle?(name: string, version: string, request?: BundleUpdateRequest): Promise<BundleUpdateOutcome | null>;
+  waitForInstall?(requestId: string): Promise<BundleChange | null>;
 }
 
 export interface RegistryEntry {

package/src/host/bundle-manager.ts

@@ -3,9 +3,15 @@ import { RESTART_REASONS } from '../contract/protocol/bundle-install.js';
 import type { BundleManager } from './adapter-types.js';
 import type {
   BundleChange,
+  BundleIncompatible,
   BundleInspection,
   BundleRegistries,
   BundleRegistry,
+  BundleRegistryAttempt,
+  BundleUpdateOutcome,
+  BundleUpdateRequest,
+  BundleVersionEntry,
+  BundleVersionList,
 } from '../contract/protocol/bundle-install.js';
 
 const MANAGER_SERVICE = 'pluginManager';
@@ -17,6 +23,13 @@ interface PluginManagerFace {
   removeBundle?(name: string): Promise<unknown>;
   setBundleEnabled?(name: string, enabled: boolean): Promise<unknown>;
   cancelInstall?(requestId: string): Promise<unknown>;
+  listVersions?(name: string, options?: { readonly registry?: BundleRegistry }): Promise<unknown>;
+  updateBundle?(
+    name: string,
+    version: string,
+    options?: { readonly registry?: BundleRegistry; readonly requestId?: string },
+  ): Promise<unknown>;
+  waitForInstall?(requestId: string): Promise<unknown>;
 }
 
 const APPLICATIONS = ['applied', 'restart-required', 'overridden', 'failed', 'cancelled'] as const;
@@ -107,6 +120,7 @@ function asChange(raw: unknown): BundleChange | null {
   const version = asText(record.version);
   const errorCode = error === undefined ? '' : asText(error.code);
   const errorDetail = error === undefined ? '' : asText(error.diagnostic);
+  const incompatible = asIncompatibleList(error?.incompatible);
   return {
     application,
     stage,
@@ -116,6 +130,7 @@ function asChange(raw: unknown): BundleChange | null {
     ...(version === '' ? {} : { version }),
     ...(errorCode === '' ? {} : { errorCode }),
     ...(errorDetail === '' ? {} : { errorDetail }),
+    ...(incompatible.length === 0 ? {} : { incompatible }),
     ...(packageResult === undefined ? {} : { packageResult }),
     ...(pendingBuilds.length === 0 ? {} : { pendingBuilds }),
     ...(restartReason === undefined ? {} : { restartReason }),
@@ -159,6 +174,130 @@ function asInspection(raw: unknown): BundleInspection | null {
   };
 }
 
+const VERSION_PROBLEMS = ['not-updatable', 'not-found', 'network', 'unknown'] as const;
+const UPDATE_STEPS = ['check', 'remove', 'install'] as const;
+
+function asRequirementMap(value: unknown): Readonly<Record<string, string>> {
+  const record = asRecord(value);
+  if (record === undefined) return {};
+  const entries: [string, string][] = [];
+  for (const [key, raw] of Object.entries(record)) {
+    if (typeof raw === 'string') entries.push([key, raw]);
+  }
+  return Object.fromEntries(entries);
+}
+
+function asIncompatible(raw: unknown): BundleIncompatible | undefined {
+  const record = asRecord(raw);
+  if (record === undefined) return undefined;
+  const name = asText(record.name);
+  const version = asText(record.version);
+  const runtimeVersion = asText(record.runtimeVersion);
+  if (name === '' || version === '' || runtimeVersion === '') return undefined;
+  return { name, version, runtimeVersion, requirements: asRequirementMap(record.requirements) };
+}
+
+function asIncompatibleList(raw: unknown): BundleIncompatible[] {
+  if (!Array.isArray(raw)) return [];
+  const rows: BundleIncompatible[] = [];
+  for (const item of raw) {
+    const entry = asIncompatible(item);
+    if (entry !== undefined) rows.push(entry);
+  }
+  return rows;
+}
+
+function asRegistryAttempt(raw: unknown): BundleRegistryAttempt | undefined {
+  const record = asRecord(raw);
+  if (record === undefined) return undefined;
+  const registry = asRegistry(record.registry);
+  if (registry === undefined) return undefined;
+  const problem = pick(VERSION_PROBLEMS, record.problem);
+  const reason = asText(record.reason);
+  return {
+    registry,
+    ...(problem === undefined ? {} : { problem }),
+    ...(reason === '' ? {} : { reason }),
+  };
+}
+
+function asRegistryAttempts(raw: unknown): BundleRegistryAttempt[] {
+  if (!Array.isArray(raw)) return [];
+  const rows: BundleRegistryAttempt[] = [];
+  for (const item of raw) {
+    const attempt = asRegistryAttempt(item);
+    if (attempt !== undefined) rows.push(attempt);
+  }
+  return rows;
+}
+
+function asVersionEntry(raw: unknown): BundleVersionEntry | null {
+  const record = asRecord(raw);
+  if (record === undefined) return null;
+  const version = asText(record.version);
+  if (version === '') return null;
+  const publishedAt = asText(record.publishedAt);
+  const deprecated = asText(record.deprecated);
+  const incompatible = asIncompatible(record.incompatible);
+  return {
+    version,
+    tags: asTextArray(record.tags),
+    prerelease: record.prerelease === true,
+    bundle: record.bundle === true,
+    ...(publishedAt === '' ? {} : { publishedAt }),
+    ...(deprecated === '' ? {} : { deprecated }),
+    ...(incompatible === undefined ? {} : { incompatible }),
+  };
+}
+
+function asVersionList(raw: unknown): BundleVersionList | null {
+  const record = asRecord(raw);
+  if (record === undefined) return null;
+  const status = asText(record.status);
+  const attempts = asRegistryAttempts(record.attempts);
+  if (status === 'refused') {
+    return {
+      status: 'refused',
+      problem: pick(VERSION_PROBLEMS, record.problem) ?? 'unknown',
+      reason: asText(record.reason),
+      attempts,
+    };
+  }
+  if (status !== 'listed') return null;
+  const registry = asRegistry(record.registry);
+  const versions: BundleVersionEntry[] = [];
+  if (Array.isArray(record.versions)) {
+    for (const item of record.versions) {
+      const entry = asVersionEntry(item);
+      if (entry !== null) versions.push(entry);
+    }
+  }
+  return {
+    status: 'listed',
+    installed: asText(record.installed),
+    registry: registry ?? null,
+    attempts,
+    versions,
+    omitted: typeof record.omitted === 'number' ? record.omitted : 0,
+  };
+}
+
+function asUpdateOutcome(raw: unknown): BundleUpdateOutcome | null {
+  const record = asRecord(raw);
+  if (record === undefined) return null;
+  const step = pick(UPDATE_STEPS, record.step);
+  const change = asChange(record.result);
+  if (step === undefined || change === null) return null;
+  const restore = record.restore === undefined ? null : asChange(record.restore);
+  return {
+    from: asText(record.from),
+    to: asText(record.to),
+    step,
+    change,
+    ...(restore === null ? {} : { restore }),
+  };
+}
+
 export function readBundleManager(ctx: DshHostContext): BundleManager | undefined {
   const face = ctx.get<PluginManagerFace>(MANAGER_SERVICE);
   if (face === undefined) return undefined;
@@ -191,5 +330,21 @@ export function readBundleManager(ctx: DshHostContext): BundleManager | undefine
       if (typeof face.cancelInstall !== 'function') return null;
       return pick(CANCELLATIONS, (asRecord(await face.cancelInstall(requestId)) ?? {}).status) ?? null;
     },
+    async listVersions(name, registry) {
+      if (typeof face.listVersions !== 'function') return null;
+      return asVersionList(await face.listVersions(name, registry === undefined ? undefined : { registry }));
+    },
+    async updateBundle(name, version, request: BundleUpdateRequest = {}) {
+      if (typeof face.updateBundle !== 'function') return null;
+      const options = {
+        ...(request.registry === undefined ? {} : { registry: request.registry }),
+        ...(request.requestId === undefined ? {} : { requestId: request.requestId }),
+      };
+      return asUpdateOutcome(await face.updateBundle(name, version, options));
+    },
+    async waitForInstall(requestId) {
+      if (typeof face.waitForInstall !== 'function') return null;
+      return asChange(await face.waitForInstall(requestId));
+    },
   };
 }

package/src/host/diy-preset.ts

@@ -0,0 +1,129 @@
+import type { DshAgentPresetDefinition, DshLoaderEntry } from '../api/dsh.js';
+import { DIY_PRESET_ID } from '../contract/protocol/diy.js';
+
+const AGENT_PRESET_PLUGIN = '@deepseek-ai/dsh-agent-preset';
+const STANDARD_PRESET_ID = 'standard';
+
+/** DIY preset 在模式菜单里的名字。 */
+export const DIY_PRESET_NAME = '工作台 DIY 模式';
+
+/** DIY preset 在模式菜单里的说明。 */
+export const DIY_PRESET_DESCRIPTION =
+  '看 / 调这个工作区的面板，或者给它造一块新内容 —— 用大白话说就行。任何工作区都能用（空项目也算）；agent 会看面板、抓请求，必要时把模块造出来装上。不用写代码。';
+
+/** DIY preset 在模式菜单里的排序（排在 dsh 出厂的几个模式之后）。 */
+export const DIY_PRESET_ORDER = 9;
+
+/** 这一轮 dsh 的 standard preset 没法派生时抛的错：带上哪一段锚点变了。 */
+export class DiyPresetSourceError extends Error {
+  constructor(message: string) {
+    super(message);
+    this.name = 'DiyPresetSourceError';
+  }
+}
+
+type Row = Record<string, unknown>;
+
+function isRow(value: unknown): value is Row {
+  return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+
+function rowAt(value: unknown, at: string): Row {
+  if (!isRow(value)) throw new DiyPresetSourceError(`${at} 不是一行插件配置`);
+  return value;
+}
+
+function standardConfigOf(value: unknown): Row {
+  const standard = rowAt(value, 'dsh 的 standard preset');
+  if (!Array.isArray(standard.plugins)) {
+    throw new DiyPresetSourceError('dsh 的 standard preset 没有 plugins 表 —— 派生不出 DIY 那一份');
+  }
+  return standard;
+}
+
+function clonedPluginsOf(standard: Row): Row[] {
+  let cloned: unknown;
+  try {
+    cloned = structuredClone(standard);
+  } catch (error) {
+    throw new DiyPresetSourceError(`dsh 的 standard preset 配置复制不了：${String(error)}`);
+  }
+  const rows = rowAt(cloned, 'dsh 的 standard preset').plugins;
+  if (!Array.isArray(rows)) {
+    throw new DiyPresetSourceError('dsh 的 standard preset 没有 plugins 表 —— 派生不出 DIY 那一份');
+  }
+  return rows.map((row, index) => {
+    const parsed = rowAt(row, `dsh 的 standard preset 第 ${index + 1} 行`);
+    if (typeof parsed.name !== 'string' || parsed.name === '') {
+      throw new DiyPresetSourceError(`dsh 的 standard preset 第 ${index + 1} 行没有插件名`);
+    }
+    return parsed;
+  });
+}
+
+function takeRow(plugins: Row[], id: string): Row {
+  const index = plugins.findIndex((row) => row.id === id);
+  if (index < 0) {
+    throw new DiyPresetSourceError(`dsh 的 standard preset 里找不到 \`${id}\` 那一行 —— DIY 的差分锚点变了`);
+  }
+  return plugins.splice(index, 1)[0] as Row;
+}
+
+/**
+ * 从这一轮 dsh 的 `standard` preset 配置派生 `workbench-diy`。
+ *
+ * 差分只有三处：`skill-filesystem` 与 `tool-skill` 一起搬到末尾（前者加 `customSkillDirs` 指向工作台的
+ * `skills/`）、末尾补 `tool-cordis`、`tool-plugin-manager` 打开（工作台只活在 profile 里）。
+ * 其余行原样跟着 dsh 走，所以 dsh 加工具 / 改 config 时不需要重新生成任何文件。
+ * @param standard dsh loader 里 `preset-standard` 那一行收到的 config。
+ * @param skillsDir 工作台的 `skills/` 绝对路径。
+ */
+export function diyPresetFrom(standard: unknown, skillsDir: string): DshAgentPresetDefinition {
+  const plugins = clonedPluginsOf(standardConfigOf(standard));
+
+  const skillFilesystem = takeRow(plugins, 'skill-filesystem');
+  const toolSkill = takeRow(plugins, 'tool-skill');
+  skillFilesystem.config = {
+    ...(isRow(skillFilesystem.config) ? skillFilesystem.config : {}),
+    customSkillDirs: [skillsDir],
+  };
+
+  const manager = plugins.find((row) => row.id === 'tool-plugin-manager');
+  if (manager !== undefined) manager.disabled = false;
+
+  if (!plugins.some((row) => row.id === 'tool-cordis')) {
+    plugins.push({ id: 'tool-cordis', name: '@deepseek-ai/dsh-tool-cordis' });
+  }
+  plugins.push(skillFilesystem, toolSkill);
+
+  const seen = new Set<string>();
+  for (const row of plugins) {
+    if (typeof row.id !== 'string' || row.id === '') continue;
+    if (seen.has(row.id)) {
+      throw new DiyPresetSourceError(`dsh 的 standard preset 里出现重复的 id：${row.id}`);
+    }
+    seen.add(row.id);
+  }
+
+  return {
+    id: DIY_PRESET_ID,
+    name: DIY_PRESET_NAME,
+    description: DIY_PRESET_DESCRIPTION,
+    order: DIY_PRESET_ORDER,
+    plugins,
+  };
+}
+
+/**
+ * 在 loader 的行里找这一轮 dsh 的 `standard` preset 配置；没有（或那一行被关掉）就算不知道。
+ * @param entries loader 的 `entries()`（递归给全部行）。
+ */
+export function standardPresetConfigOf(entries: Iterable<DshLoaderEntry>): unknown {
+  for (const entry of entries) {
+    if (entry.disabled === true) continue;
+    if (entry.options?.name !== AGENT_PRESET_PLUGIN) continue;
+    const config = entry.options.config;
+    if (isRow(config) && config.id === STANDARD_PRESET_ID) return config;
+  }
+  return undefined;
+}

package/src/host.ts

@@ -46,6 +46,7 @@ export {
 export * from './host/profile-create.js';
 export * from './host/context-ref.js';
 export * from './host/diy-debug.js';
+export * from './host/diy-preset.js';
 export * from './host/diy-record.js';
 export * from './host/env-policy.js';
 export * from './host/facts.js';