@dsh-workbench/core 1.1.4 → 1.1.5

package/dist/types/app/layouts/approval-detail.d.ts

@@ -1,4 +1,4 @@
-import type { ApprovalInput, ReactNode, Translate } from '@dsh-workbench/shared';
+import type { ApprovalInput, ReactNode, Translate, UnitManifest, UnitToolOpencli } from '@dsh-workbench/shared';
 import type { MarketSourcesPayload, PublishPreview } from '../../kernel/contract/market-index';
 export interface ApprovalRow {
     readonly label: string;
@@ -12,6 +12,9 @@ export interface ApprovalPlanView {
     readonly warn?: string | undefined;
 }
 export declare function marketSourceRows(tool: string, args: Readonly<Record<string, unknown>>, payload: MarketSourcesPayload | null | undefined, t: Translate): readonly ApprovalRow[];
+export declare function pluginToolIndexOf(manifests: readonly UnitManifest[]): ReadonlyMap<string, UnitToolOpencli>;
+export declare function pluginApprovalRows(origin: UnitToolOpencli, args: Readonly<Record<string, unknown>>, t: Translate): readonly ApprovalRow[];
+export declare function shellApprovalRenderer(manifests: () => readonly UnitManifest[]): (input: ApprovalInput, t: Translate) => ReactNode;
 export declare function shellClaimsApprovalDetail(tool: string): boolean;
-export declare function shellApprovalPlan(input: ApprovalInput, t: Translate): ApprovalPlanView | undefined;
-export declare function shellApprovalDetail(input: ApprovalInput, t: Translate): ReactNode;
+export declare function shellApprovalPlan(input: ApprovalInput, t: Translate, pluginTools?: ReadonlyMap<string, UnitToolOpencli> | undefined): ApprovalPlanView | undefined;
+export declare function shellApprovalDetail(input: ApprovalInput, t: Translate, pluginTools?: ReadonlyMap<string, UnitToolOpencli> | undefined): ReactNode;

package/dist/types/app/layouts/market/add-module-registry-prefs.d.ts

@@ -0,0 +1,11 @@
+import { type RegistryChoice, type RegistryOption } from './add-module-text';
+export interface RegistryPrefs {
+    readonly choice: RegistryChoice;
+    readonly custom: string;
+}
+export declare const DEFAULT_REGISTRY_CHOICE: RegistryChoice;
+export declare function parseRegistryChoice(raw: string | null): RegistryChoice;
+export declare function readRegistryPrefs(): RegistryPrefs;
+export declare function writeRegistryChoice(choice: RegistryChoice): void;
+export declare function writeRegistryCustom(value: string): void;
+export declare function reconcileRegistryChoice(choice: RegistryChoice, choices: readonly RegistryOption[]): RegistryChoice;

package/dist/types/app/layouts/market/market-check.d.ts

@@ -1,10 +1,12 @@
 import type { Translate } from '@dsh-workbench/shared';
+import type { LatestCheckSummary } from '../rightbar/market-rows';
 export interface MarketCheckProps {
     readonly t: Translate;
     readonly checkedAt: number | null;
+    readonly latestCheck?: LatestCheckSummary | undefined;
     readonly checking: boolean;
     readonly failed: boolean;
     readonly disabled: boolean;
     readonly onCheck: () => void;
 }
-export declare function MarketCheck({ t, checkedAt, checking, failed, disabled, onCheck }: MarketCheckProps): JSX.Element;
+export declare function MarketCheck({ t, checkedAt, latestCheck, checking, failed, disabled, onCheck, }: MarketCheckProps): JSX.Element;

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

@@ -0,0 +1,6 @@
+import type { Translate } from '@dsh-workbench/shared';
+export declare function AskAgentButton({ t, text, label, }: {
+    readonly t: Translate;
+    readonly text: string;
+    readonly label: string;
+}): JSX.Element;

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

@@ -0,0 +1,8 @@
+import type { Translate } from '@dsh-workbench/shared';
+import type { InstallFailure } from '@dsh-workbench/shared';
+export declare function FailureCard({ t, failure, onRecheck, rechecking, }: {
+    readonly t: Translate;
+    readonly failure: InstallFailure;
+    readonly onRecheck: () => void;
+    readonly rechecking: boolean;
+}): JSX.Element;

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

@@ -28,8 +28,9 @@ export interface MarketViewProps {
     readonly selfUpdate?: WorkbenchSelfUpdate | null | undefined;
     readonly plugins?: readonly InstalledPlugin[] | null | undefined;
     readonly settling?: ReadonlySet<string> | undefined;
+    readonly installing?: boolean | undefined;
     readonly mock?: MarketMock | undefined;
     readonly defaults?: readonly string[] | undefined;
     readonly changed?: Readonly<Record<string, number>> | undefined;
 }
-export declare function MarketView({ t, titleOf, manifests, installable, capabilities, freshness, onChanged, onPending, updates, updatesCheckedAt, updatesFailed, installed, installedRead, workbench, selfUpdate, plugins, settling, mock, defaults, changed, }: MarketViewProps): JSX.Element;
+export declare function MarketView({ t, titleOf, manifests, installable, capabilities, freshness, onChanged, onPending, updates, updatesCheckedAt, updatesFailed, installed, installedRead, workbench, selfUpdate, plugins, settling, installing, mock, defaults, changed, }: MarketViewProps): JSX.Element;

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

@@ -1,11 +1,14 @@
 import type { Translate } from '@dsh-workbench/shared';
 import { type SharedRow } from './market-rows';
+import type { MarketFailure } from './market-row-types';
 import { type Pending } from './market-view-text';
 import type { MarketRowAction } from './market-rows';
-export declare function SharedSection({ t, rows, pending, failureOf, act, }: {
+export declare function SharedSection({ t, rows, pending, failureOf, act, onRecheck, rechecking, }: {
     readonly t: Translate;
     readonly rows: readonly SharedRow[];
     readonly pending: Pending | null;
-    readonly failureOf: (id: string) => string | null;
+    readonly failureOf: (id: string) => MarketFailure | null;
     readonly act: (id: string, action: MarketRowAction) => Promise<void>;
+    readonly onRecheck: () => void;
+    readonly rechecking: boolean;
 }): JSX.Element | null;

package/dist/types/app/layouts/rightbar/failure-card-text.d.ts

@@ -0,0 +1,14 @@
+import type { InstallFailure, Translate } from '@dsh-workbench/shared';
+export interface FailureCardModel {
+    readonly title: string;
+    readonly fact: string;
+    readonly fixLabel: string;
+    readonly fix: string;
+    readonly copiedHint: string;
+    readonly command: string;
+    readonly output: string;
+    readonly exitCode: number | null;
+}
+export declare function shellPath(path: string): string;
+export declare function ownerLabel(uid: number): string;
+export declare function failureCardOf(failure: InstallFailure, t: Translate): FailureCardModel;

package/dist/types/app/layouts/rightbar/market-act.d.ts

@@ -1,15 +1,12 @@
 import type { Translate, WriteOutcome } from '@dsh-workbench/shared';
-import type { MarketRow } from './market-row-types';
+import type { MarketFailure, MarketRow } from './market-row-types';
 import { type MarketRowAction } from './market-rows';
 import { type HeldRow, type Pending } from './market-view-text';
 export interface MarketActSeats {
     readonly setPending: (next: Pending | null) => void;
     readonly setHeld: (next: HeldRow | undefined) => void;
     readonly setConfirming: (next: string | null) => void;
-    readonly setFailed: (next: {
-        readonly id: string;
-        readonly message: string;
-    } | null) => void;
+    readonly setFailed: (next: MarketFailure | null) => void;
     readonly setNotice: (next: string | null) => void;
 }
 export interface MarketActOptions {

package/dist/types/app/layouts/rightbar/market-change.d.ts

@@ -2,3 +2,4 @@ import type { Translate } from '@dsh-workbench/shared';
 import type { BundleChange } from '../../../kernel/contract/bundle-install';
 export declare function changeOf(value: unknown): BundleChange | undefined;
 export declare function changeFailure(change: BundleChange | undefined, t: Translate): string | undefined;
+export declare function appliedUnitsOf(value: unknown): readonly string[];

package/dist/types/app/layouts/rightbar/market-hint.d.ts

@@ -13,5 +13,7 @@ export interface MarketHintInput {
     readonly plugins?: readonly InstalledPlugin[] | null | undefined;
     readonly workbench?: WorkbenchVersion | null | undefined;
     readonly busy?: ReadonlySet<string> | undefined;
+    readonly installing?: boolean | undefined;
+    readonly applied?: ReadonlySet<string> | undefined;
 }
 export declare function marketHintOf(input: MarketHintInput): PanelHint | null;

package/dist/types/app/layouts/rightbar/market-install.d.ts

@@ -0,0 +1,11 @@
+export interface MarketInstallState {
+    readonly installing: boolean;
+    readonly applied: ReadonlySet<string>;
+}
+export declare function marketInstallState(): MarketInstallState;
+export declare function subscribeMarketInstall(listener: () => void): () => void;
+export declare function publishMarketInstalling(token: string, active: boolean): void;
+export declare function publishMarketApplied(units: readonly string[]): void;
+export declare function resetMarketInstall(): void;
+export declare function useMarketInstallState(): MarketInstallState;
+export declare function usePublishMarketInstalling(token: string, active: boolean): void;

package/dist/types/app/layouts/rightbar/market-row-types.d.ts

@@ -1,9 +1,15 @@
 import type { ModuleUpdateBlock } from '../../../kernel/contract/bundle-install';
 import type { MarketInstalledModule } from '../../../kernel/contract/market-index';
+import type { InstallFailure } from '@dsh-workbench/shared';
+export interface MarketFailure {
+    readonly id: string;
+    readonly message: string;
+    readonly failure?: InstallFailure;
+}
 export type MarketRowAction = 'install' | 'update' | 'update-bundle' | 'install-version' | 'remove-bundle' | 'uninstall' | 'update-dependency' | 'update-plugin' | 'uninstall-plugin' | 'update-workbench' | 'migrate-workbench' | 'dismiss-followup';
 export type MarketState = 'checking' | 'installed' | 'inactive' | 'unusable' | 'broken' | 'outdated' | 'pending-restart' | 'pending-followup' | 'missing' | 'unchecked' | 'unknown';
 export interface MarketNote {
-    readonly key: 'panels.market.needEnv' | 'panels.market.noSource' | 'panels.market.badSource' | 'panels.market.needCommands' | 'panels.market.needBinary' | 'panels.market.needLib' | 'panels.market.moduleRefused' | 'panels.market.moduleRestartHint' | 'panels.market.pluginAlsoKnownAs' | 'panels.market.pluginBroken';
+    readonly key: 'panels.market.needEnv' | 'panels.market.noSource' | 'panels.market.badSource' | 'panels.market.needCommands' | 'panels.market.needBinary' | 'panels.market.needLib' | 'panels.market.moduleRefused' | 'panels.market.moduleRestartHint' | 'panels.market.pluginAlsoKnownAs' | 'panels.market.pluginBroken' | 'panels.market.latestNoRegistry' | 'panels.market.latestProbeFailed';
     readonly params: Readonly<Record<string, string>>;
     readonly tone?: 'plain' | 'alert';
 }

package/dist/types/app/layouts/rightbar/market-rows.d.ts

@@ -1,4 +1,4 @@
-import type { ModuleUpdateBlock, ModuleVersion } from '../../../kernel/contract/bundle-install';
+import type { LatestUnavailable, ModuleUpdateBlock, ModuleVersion } from '../../../kernel/contract/bundle-install';
 import type { MarketInstalledModule } from '../../../kernel/contract/market-index';
 import type { Translate, UnitManifest, UnitTitle } from '@dsh-workbench/shared';
 import type { MarketNameMap } from './market-names';
@@ -19,6 +19,7 @@ export interface InstalledWorkbenchModule {
     readonly title?: UnitTitle | undefined;
     readonly latest?: string | undefined;
     readonly latestBlocked?: ModuleUpdateBlock | undefined;
+    readonly latestUnavailable?: LatestUnavailable | undefined;
     readonly local?: boolean | undefined;
     readonly refused?: readonly string[] | undefined;
     readonly clientRefused?: readonly string[] | undefined;
@@ -31,8 +32,14 @@ export declare function withClientRefusals(modules: readonly InstalledWorkbenchM
 }[]): readonly InstalledWorkbenchModule[];
 export declare function refusalReasons(host: readonly string[] | undefined, client: readonly string[] | undefined): readonly string[];
 export declare function installedIdSet(installed: readonly InstalledWorkbenchModule[] | undefined): ReadonlySet<string> | null;
+export interface LatestCheckSummary {
+    readonly checked: number;
+    readonly unknown: number;
+}
+export declare function latestCheckSummary(modules: readonly InstalledWorkbenchModule[] | undefined): LatestCheckSummary;
 export declare function installedRows(modules: readonly InstalledWorkbenchModule[], manifests: readonly UnitManifest[], listed: ReadonlySet<string>, names?: MarketNameMap | undefined, defaults?: ReadonlySet<string>, changed?: Readonly<Record<string, number>>): MarketRow[];
 export declare function marketSwitchLocked(row: MarketRow): boolean;
+export declare function marketAsksAgent(row: MarketRow): boolean;
 export declare function marketActions(row: MarketRow): MarketRowAction[];
 export declare function capabilityOutdated(capabilities: CapabilityMap | null, unit: string): boolean;
 export declare function marketCatalog(manifests: readonly UnitManifest[], installable: ReadonlySet<string> | null | undefined): readonly UnitManifest[];
@@ -46,4 +53,8 @@ export interface MarketSection {
 }
 export declare function marketOrder(rows: readonly MarketRow[], titleOf: (row: MarketRow) => string): MarketRow[];
 export declare function marketSections(rows: readonly MarketRow[]): MarketSection[];
+export declare function checkingRows(rows: readonly MarketRow[], scope: {
+    readonly all: boolean;
+    readonly units: ReadonlySet<string>;
+}): MarketRow[];
 export declare function marketRows(manifests: readonly UnitManifest[], capabilities: CapabilityMap | null, updates?: ModuleUpdateMap, defaults?: ReadonlySet<string>, changed?: Readonly<Record<string, number>>): MarketRow[];

package/dist/types/app/layouts/rightbar/market-section.d.ts

@@ -1,15 +1,15 @@
 import type { ReactNode, Translate } from '@dsh-workbench/shared';
-import type { MarketRow } from './market-row-types';
+import type { MarketFailure, MarketRow } from './market-row-types';
 import { type MarketRowAction } from './market-rows';
 import type { MarketSectionIcon } from './market-section-icon';
 import { type Pending } from './market-view-text';
-export declare function MarketSection({ t, titleKey, icon, rows, pending, failureOf, act, confirmActions, onConfirming, onDefault, boardBusy, headAction, keepHead, }: {
+export declare function MarketSection({ t, titleKey, icon, rows, pending, failureOf, act, confirmActions, onConfirming, onDefault, boardBusy, headAction, keepHead, onRecheck, rechecking, }: {
     readonly t: Translate;
     readonly titleKey?: string;
     readonly icon?: MarketSectionIcon;
     readonly rows: readonly MarketRow[];
     readonly pending: Pending | null;
-    readonly failureOf: (id: string) => string | null;
+    readonly failureOf: (id: string) => MarketFailure | null;
     readonly act: (id: string, action: MarketRowAction) => Promise<void>;
     readonly onDefault?: ((id: string, next: boolean) => void) | undefined;
     readonly boardBusy?: boolean | undefined;
@@ -17,4 +17,6 @@ export declare function MarketSection({ t, titleKey, icon, rows, pending, failur
     readonly onConfirming: (id: string | null) => void;
     readonly headAction?: ReactNode;
     readonly keepHead?: boolean;
+    readonly onRecheck: () => void;
+    readonly rechecking: boolean;
 }): JSX.Element | null;

package/dist/types/app/layouts/rightbar/market-transient-state.d.ts

@@ -1,18 +1,13 @@
 import type { MarketMock } from './market-mock';
 import type { Pending } from './market-view-text';
+import type { MarketFailure } from './market-row-types';
 export interface MarketTransient {
     readonly pending: Pending | null;
     readonly setPending: (next: Pending | null) => void;
     readonly confirming: string | null;
     readonly setConfirming: (next: string | null) => void;
-    readonly failed: {
-        readonly id: string;
-        readonly message: string;
-    } | null;
-    readonly setFailed: (next: {
-        readonly id: string;
-        readonly message: string;
-    } | null) => void;
+    readonly failed: MarketFailure | null;
+    readonly setFailed: (next: MarketFailure | null) => void;
     readonly notice: string | null;
     readonly setNotice: (next: string | null) => void;
 }

package/dist/types/app/layouts/rightbar/market-view-text.d.ts

@@ -48,3 +48,5 @@ export declare function pendingRowOf(input: {
     readonly rows: readonly MarketRow[];
     readonly names: MarketNameMap;
 }): MarketRow | undefined;
+export declare function askAgentReason(row: MarketRow, t: Translate): string;
+export declare function askAgentText(row: MarketRow, t: Translate): string;

package/dist/types/kernel/client/registry.d.ts

@@ -11,6 +11,7 @@ export interface ClientUnitRegistry {
     register(face: UnitClientFace): () => void;
     all(): readonly UnitClientFace[];
     manifests(): readonly UnitManifest[];
+    declared(): readonly UnitManifest[];
     installable(): ReadonlySet<string> | null;
     refusals(): readonly ClientUnitRefusal[];
     setManifests(manifests: readonly UnitManifest[], installable?: readonly string[]): void;

package/dist/types/kernel/contract/bundle-install.d.ts

@@ -1,2 +1,2 @@
 export { BUNDLE_REGISTRIES_ROUTE, BUNDLE_INSPECT_ROUTE, BUNDLE_REGISTRY_DEFAULT, MODULE_VERSIONS_ROUTE, SELF_UPDATE_STATES, RESTART_REASONS } from '@dsh-workbench/shared/contract/protocol/bundle-install';
-export type { BundleRegistry, BundleRegistries, BundleInspectProblem, BundleSpecKind, BundleInspectionAccepted, BundleInspectionRefused, BundleInspectionPlugin, BundleInspection, BundleRegistriesPayload, BundleInspectionPayload, BundleApplication, SelfUpdateState, WorkbenchSelfUpdate, RestartReason, BundleChangeStage, BundleFailureKind, BundlePackageResult, BundleChange, BundleInstallRequest, BundleCancellation, BundleSupplyState, BundleModulePayload, BundleSupplyPayload, BundleInstalledPlugin, BundleInstallPayload, BundleRemovePayload, BundleCancellationPayload, ModuleVersion, ModuleUpdateBlock, WorkbenchVersion, ModuleVersionsPayload } from '@dsh-workbench/shared/contract/protocol/bundle-install';
+export type { BundleRegistry, BundleRegistries, BundleInspectProblem, BundleSpecKind, BundleInspectionAccepted, BundleInspectionRefused, BundleInspectionPlugin, BundleInspection, BundleRegistriesPayload, BundleInspectionPayload, BundleApplication, SelfUpdateState, WorkbenchSelfUpdate, RestartReason, BundleChangeStage, BundleFailureKind, BundlePackageResult, BundleChange, BundleInstallRequest, BundleCancellation, BundleSupplyState, BundleModulePayload, BundleSupplyPayload, BundleInstalledPlugin, BundleInstallPayload, BundleRemovePayload, BundleCancellationPayload, LatestUnavailable, ModuleVersion, ModuleUpdateBlock, WorkbenchVersion, ModuleVersionsPayload } from '@dsh-workbench/shared/contract/protocol/bundle-install';

package/dist/types/modules/panels/model/market-install-error.d.ts

@@ -0,0 +1,3 @@
+import type { InstallFailure } from '@dsh-workbench/shared';
+import { WorkbenchDataError } from '@dsh-workbench/shared/host';
+export declare function installError(failure: InstallFailure): WorkbenchDataError;

package/dist/types/modules/panels/model/market-install-error.test.d.ts

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

package/dist/types/modules/panels/model/market-registry.d.ts

@@ -3,10 +3,11 @@ import type { BundleManager } from '@dsh-workbench/shared/host';
 import type { RegistryNotebook } from '@dsh-workbench/shared/host';
 export interface RegistryFixDeps {
     readonly registries?: RegistryNotebook | undefined;
+    readonly profileDir?: string | null | undefined;
     readonly logger?: {
         info?(message: string): void;
         warn?(message: string): void;
     } | undefined;
 }
-export declare function rememberInstalledSource(deps: RegistryFixDeps, manager: BundleManager, pkg: string, registry: string | undefined): Promise<void>;
+export declare function rememberInstalledSource(deps: RegistryFixDeps, manager: BundleManager, pkg: string, registry: string | undefined, version?: string | undefined): Promise<void>;
 export declare function retryAfterRegistryFix(deps: RegistryFixDeps, manager: BundleManager, pkg: string, change: BundleChange): Promise<BundleChange>;

package/dist/types/modules/panels/model/market-remove.d.ts

@@ -0,0 +1,13 @@
+import type { BundleChange } from '../../../kernel/contract/bundle-install';
+import type { BundleManager } from '@dsh-workbench/shared/host';
+import { type RegistryFixDeps } from './market-registry';
+export interface RemoveBundleOptions {
+    readonly manager: BundleManager;
+    readonly pkg: string;
+    readonly profileDir?: string | null | undefined;
+    readonly registryFix: RegistryFixDeps;
+    readonly logger?: {
+        warn?(message: string): void;
+    } | undefined;
+}
+export declare function removeDshBundle(options: RemoveBundleOptions): Promise<BundleChange>;

package/dist/types/modules/panels/model/market-remove.test.d.ts

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

package/dist/types/modules/panels/model/market-route.d.ts

@@ -22,7 +22,7 @@ export interface BundleInstallDeps {
     readonly ledger?: PluginLedger | undefined;
     readonly runAll: (commands: readonly PluginSourceCommand[]) => Promise<void>;
     readonly supplyAfter: (module: InstalledModule, change: BundleChange) => Promise<BundleSupply>;
-    readonly rememberSource: (manager: BundleManager, pkg: string, registry: string | undefined) => Promise<void>;
+    readonly rememberSource: (manager: BundleManager, pkg: string, registry: string | undefined, version?: string | undefined) => Promise<void>;
     readonly remove?: ((pkg: string) => Promise<BundleChange>) | undefined;
 }
 export declare function bundleNameOf(change: BundleChange, spec: string): string;

package/dist/types/modules/panels/model/market.d.ts

@@ -25,6 +25,7 @@ export declare function createMarketService(options: {
     modules?: (() => readonly ProfileModule[]) | undefined;
     workbench?: ((pkg: string) => ProfilePackage | undefined) | undefined;
     registries?: RegistryNotebook | undefined;
+    profileDir?: string | null | undefined;
     ledger?: PluginLedger | undefined;
     references?: (() => PluginReferences) | undefined;
     dshHome?: (() => string) | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-workbench/core",
-  "version": "1.1.4",
+  "version": "1.1.5",
   "description": "个人工作台：Agent 工作台（左栏 + 常驻对话 + 自研右侧数据面板）。",
   "type": "module",
   "icon": "./icon.svg",
@@ -100,8 +100,8 @@
     "proper-lockfile": "^4.1.2",
     "which": "^7.0.0",
     "write-file-atomic": "^8.0.0",
-    "@dsh-workbench/shared": "1.1.4",
-    "@dsh-workbench/adapters-default": "1.1.4"
+    "@dsh-workbench/shared": "1.1.5",
+    "@dsh-workbench/adapters-default": "1.1.5"
   },
   "license": "MIT",
   "repository": {

package/skills/workbench-module-diy/TOOLS.md

@@ -108,18 +108,27 @@
     ]
   },
   { "kind": "lib", "name": "opencli-workflow", "purpose": "发布编排" },
-  { "kind": "bin", "name": "acme", "purpose": "平台命令" },
+  {
+    "kind": "bin",
+    "name": "acme",
+    "purpose": "平台命令",
+    "install": { "kind": "command", "line": "brew install acme/tap/cli", "platforms": ["darwin"] },
+    "docs": "https://internal/acme-cli"
+  },
   { "kind": "env", "name": "ACME_TOKEN", "purpose": "访问令牌", "secret": true }
 ]
 ```
 
 - `sources` 按顺序试（本地 → 私有 → 公共）。没写 `sources` 就是「我自己装，你只帮我判」——外壳只探不代装。
+- `bin` 想让人一键装，就写 `install.line`（一条能直接粘进终端的命令，`platforms` 可限定平台）；
+  不写就只显示「缺这条命令」，按钮都不会有。`docs` 是给人和 agent 看的补充链接。
 - `extension` 的 `sources[].kind` 只有 `npm` / `git` / `local`；`lib` 只认 `npm`。
   未知 `kind` 或 `source.kind` 判红；need 里未知字段只警告，`x-` 前缀忽略。
 - 未装好文案由模块写：`libInstallCommand({ need, source })`（`@dsh-workbench/shared/host`）拼好源与缓存目录，
   原样输出；放进失败态。
 - `contracts` 判据：`apiVersion` 必须是 3；`needs` 走同一份 `NEED_KINDS` 注册表校验（`purpose` 必填、
-  `bin`/`env` 不许带 `sources`、`lib` 只认 npm 源）；声明了 `lib` 必须用 `libInstallCommand`。
+  `bin`/`env` 不许带 `sources`（`bin` 要代装就写 `install`）、`lib` 只认 npm 源）；
+  声明了 `lib` 必须用 `libInstallCommand`。
   未知 `runtime` 不判红：探针会给「这个运行时工作台还不认识」的 `unchecked`，等运行时 provider 补上。
 
 ## 9 长任务