@dsh-workbench/shared 1.1.3 → 1.1.5

package/dist/i18n/zh.d.ts

@@ -155,7 +155,42 @@ export declare const zh: {
     readonly 'panels.market.confirmUninstallAck': "我明白：卸载后想再用，得重新装一遍。";
     readonly 'panels.market.confirmYes': "卸载";
     readonly 'panels.market.confirmNo': "取消";
+    readonly 'panels.market.noMarketSource': "索引里没有这个模块的新版本（刷新一次索引再试）";
     readonly 'panels.market.failed': "没成功：{reason}";
+    readonly 'panels.market.askAgent': "问 agent";
+    readonly 'panels.market.askAgentCopied': "已复制";
+    readonly 'panels.market.askAgentText': "工作台里「{name}」（单元 {unit}）用不了：{reason}。帮我查清缺什么、怎么补，补完确认真能用。";
+    readonly 'panels.market.failure.permission': "没装上：没有写入权限";
+    readonly 'panels.market.failure.diskFull': "没装上：磁盘满了";
+    readonly 'panels.market.failure.sandbox': "没装上：被系统拦住了";
+    readonly 'panels.market.failure.unknown': "没装上：原因没认出来";
+    readonly 'panels.market.failure.factOwner': "{path} 属于 {owner}，当前账号（{me}）写不进去。把它还给自己就行（会要开机密码）。";
+    readonly 'panels.market.failure.factMode': "{path} 的权限是 {mode}，当前账号没有写权限。";
+    readonly 'panels.market.failure.factSpace': "{path} 所在的磁盘满了。";
+    readonly 'panels.market.failure.factStuck': "这条命令跑在受限环境里，写不进 {path}。";
+    readonly 'panels.market.failure.nowhere': "（没认出是哪个目录）";
+    readonly 'panels.market.failure.copyFix': "复制修复命令";
+    readonly 'panels.market.failure.copied': "已复制";
+    readonly 'panels.market.failure.copiedHint': "粘到终端跑一次，回来点「再检测」。";
+    readonly 'panels.market.failure.askAgent': "复制给 agent";
+    readonly 'panels.market.failure.askAgentText': "装这个模块时写不进去：`{command}` 退出码 {code}，卡在 {path}。帮我看看是被沙箱拦的还是权限问题，换一条能写进去的路再装。";
+    readonly 'panels.market.failure.askAgentHint': "粘到对话里，让 agent 接着弄。";
+    readonly 'panels.market.failure.recheck': "再检测";
+    readonly 'panels.market.failure.showOutput': "查看安装输出";
+    readonly 'panels.market.failure.hideOutput': "收起安装输出";
+    readonly 'panels.market.failure.term.commandLine': "第 {line} 行的命令";
+    readonly 'panels.market.failure.term.signal': "被 {signal} 终止";
+    readonly 'panels.market.failure.term.exitCode': "退出码 {exitCode}";
+    readonly 'panels.market.failure.term.noExitCode': "没有退出码";
+    readonly 'panels.market.failure.term.running': "在跑";
+    readonly 'panels.market.failure.term.failed': "没跑通";
+    readonly 'panels.market.failure.term.done': "跑完了";
+    readonly 'panels.market.failure.term.copy': "复制";
+    readonly 'panels.market.failure.term.copied': "已复制";
+    readonly 'panels.market.failure.term.noOutput': "没有输出";
+    readonly 'panels.market.failure.term.collapse': "收起";
+    readonly 'panels.market.failure.term.expandAria': "展开剩下的 {hidden} 行";
+    readonly 'panels.market.failure.term.expand': "展开 {hidden} 行";
     readonly 'panels.market.needEnv': "先在启动工作台的终端里设 {env}";
     readonly 'panels.market.needCommands': "缺这几条命令：{commands}";
     readonly 'panels.market.needBinary': "先装 {command} 命令";
@@ -191,9 +226,13 @@ export declare const zh: {
     readonly 'panels.market.pluginBroken': "这份插件装坏了：认不出它是什么。可以先卸载，再让 agent 按包名重装一次。";
     readonly 'panels.market.restartNeeded': "新版装好了，重启一次才生效。";
     readonly 'panels.market.foot': "装好后到那个项目的面板页勾选它，模块才会出现。";
-    readonly 'panels.market.recheck': "重新检查更新";
     readonly 'panels.market.checkUpdates': "检查更新";
+    readonly 'panels.market.checkingNow': "正在检查…";
+    readonly 'panels.market.checkFailed': "最近一次没查到，检查网络后重试";
     readonly 'panels.market.checkedAt': "最近检查：{time}";
+    readonly 'panels.market.latestPartial': "{n} 个模块没查成";
+    readonly 'panels.market.latestNoRegistry': "没配来源，未检查新版";
+    readonly 'panels.market.latestProbeFailed': "问不到源，稍后重试";
     readonly 'panels.market.justNow': "刚刚";
     readonly 'panels.market.minutesAgo': "{n} 分钟前";
     readonly 'panels.market.hoursAgo': "{n} 小时前";
@@ -370,6 +409,9 @@ export declare const zh: {
     readonly 'panels.discover.transportTest': "试这个地址";
     readonly 'panels.discover.transportPlaceholder': "或贴一个别的地址（公司镜像、别名）";
     readonly 'panels.discover.transportNeedsAuth': "这个仓库要凭证：先在终端里把它 clone 一次，或配好 SSH key / 凭据助手；配好后再点安装。";
+    readonly 'panels.discover.transportChange': "换一个地址";
+    readonly 'panels.discover.transportChangeHide': "收起";
+    readonly 'panels.discover.transportNone': "没有可读的地址";
     readonly 'panels.discover.expand': "展开版本";
     readonly 'panels.discover.collapse': "收起版本";
     readonly 'panels.discover.versionCount': "{n} 个版本";
@@ -655,6 +697,9 @@ export declare const zh: {
     readonly 'approval.record.noSwitch': "录完不会替你切回来（左栏底部会亮一条状态）";
     readonly 'approval.longTask.what': "要停的那次任务";
     readonly 'approval.longTask.signal': "停了只是让工作台发出中断信号 —— 这次任务怎么收尾由模块自己负责";
+    readonly 'approval.plugin.name': "插件";
+    readonly 'approval.plugin.command': "命令";
+    readonly 'approval.plugin.note': "agent 说";
     readonly 'approval.publish.module': "模块";
     readonly 'approval.publish.target': "目标";
     readonly 'approval.publish.version': "版本";

package/dist/i18n/zh.js

@@ -147,7 +147,42 @@ export const zh = {
     'panels.market.confirmUninstallAck': '我明白：卸载后想再用，得重新装一遍。',
     'panels.market.confirmYes': '卸载',
     'panels.market.confirmNo': '取消',
+    'panels.market.noMarketSource': '索引里没有这个模块的新版本（刷新一次索引再试）',
     'panels.market.failed': '没成功：{reason}',
+    'panels.market.askAgent': '问 agent',
+    'panels.market.askAgentCopied': '已复制',
+    'panels.market.askAgentText': '工作台里「{name}」（单元 {unit}）用不了：{reason}。帮我查清缺什么、怎么补，补完确认真能用。',
+    'panels.market.failure.permission': '没装上：没有写入权限',
+    'panels.market.failure.diskFull': '没装上：磁盘满了',
+    'panels.market.failure.sandbox': '没装上：被系统拦住了',
+    'panels.market.failure.unknown': '没装上：原因没认出来',
+    'panels.market.failure.factOwner': '{path} 属于 {owner}，当前账号（{me}）写不进去。把它还给自己就行（会要开机密码）。',
+    'panels.market.failure.factMode': '{path} 的权限是 {mode}，当前账号没有写权限。',
+    'panels.market.failure.factSpace': '{path} 所在的磁盘满了。',
+    'panels.market.failure.factStuck': '这条命令跑在受限环境里，写不进 {path}。',
+    'panels.market.failure.nowhere': '（没认出是哪个目录）',
+    'panels.market.failure.copyFix': '复制修复命令',
+    'panels.market.failure.copied': '已复制',
+    'panels.market.failure.copiedHint': '粘到终端跑一次，回来点「再检测」。',
+    'panels.market.failure.askAgent': '复制给 agent',
+    'panels.market.failure.askAgentText': '装这个模块时写不进去：`{command}` 退出码 {code}，卡在 {path}。帮我看看是被沙箱拦的还是权限问题，换一条能写进去的路再装。',
+    'panels.market.failure.askAgentHint': '粘到对话里，让 agent 接着弄。',
+    'panels.market.failure.recheck': '再检测',
+    'panels.market.failure.showOutput': '查看安装输出',
+    'panels.market.failure.hideOutput': '收起安装输出',
+    'panels.market.failure.term.commandLine': '第 {line} 行的命令',
+    'panels.market.failure.term.signal': '被 {signal} 终止',
+    'panels.market.failure.term.exitCode': '退出码 {exitCode}',
+    'panels.market.failure.term.noExitCode': '没有退出码',
+    'panels.market.failure.term.running': '在跑',
+    'panels.market.failure.term.failed': '没跑通',
+    'panels.market.failure.term.done': '跑完了',
+    'panels.market.failure.term.copy': '复制',
+    'panels.market.failure.term.copied': '已复制',
+    'panels.market.failure.term.noOutput': '没有输出',
+    'panels.market.failure.term.collapse': '收起',
+    'panels.market.failure.term.expandAria': '展开剩下的 {hidden} 行',
+    'panels.market.failure.term.expand': '展开 {hidden} 行',
     'panels.market.needEnv': '先在启动工作台的终端里设 {env}',
     'panels.market.needCommands': '缺这几条命令：{commands}',
     'panels.market.needBinary': '先装 {command} 命令',
@@ -183,9 +218,13 @@ export const zh = {
     'panels.market.pluginBroken': '这份插件装坏了：认不出它是什么。可以先卸载，再让 agent 按包名重装一次。',
     'panels.market.restartNeeded': '新版装好了，重启一次才生效。',
     'panels.market.foot': '装好后到那个项目的面板页勾选它，模块才会出现。',
-    'panels.market.recheck': '重新检查更新',
     'panels.market.checkUpdates': '检查更新',
+    'panels.market.checkingNow': '正在检查…',
+    'panels.market.checkFailed': '最近一次没查到，检查网络后重试',
     'panels.market.checkedAt': '最近检查：{time}',
+    'panels.market.latestPartial': '{n} 个模块没查成',
+    'panels.market.latestNoRegistry': '没配来源，未检查新版',
+    'panels.market.latestProbeFailed': '问不到源，稍后重试',
     'panels.market.justNow': '刚刚',
     'panels.market.minutesAgo': '{n} 分钟前',
     'panels.market.hoursAgo': '{n} 小时前',
@@ -362,6 +401,9 @@ export const zh = {
     'panels.discover.transportTest': '试这个地址',
     'panels.discover.transportPlaceholder': '或贴一个别的地址（公司镜像、别名）',
     'panels.discover.transportNeedsAuth': '这个仓库要凭证：先在终端里把它 clone 一次，或配好 SSH key / 凭据助手；配好后再点安装。',
+    'panels.discover.transportChange': '换一个地址',
+    'panels.discover.transportChangeHide': '收起',
+    'panels.discover.transportNone': '没有可读的地址',
     'panels.discover.expand': '展开版本',
     'panels.discover.collapse': '收起版本',
     'panels.discover.versionCount': '{n} 个版本',
@@ -647,6 +689,9 @@ export const zh = {
     'approval.record.noSwitch': '录完不会替你切回来（左栏底部会亮一条状态）',
     'approval.longTask.what': '要停的那次任务',
     'approval.longTask.signal': '停了只是让工作台发出中断信号 —— 这次任务怎么收尾由模块自己负责',
+    'approval.plugin.name': '插件',
+    'approval.plugin.command': '命令',
+    'approval.plugin.note': 'agent 说',
     'approval.publish.module': '模块',
     'approval.publish.target': '目标',
     'approval.publish.version': '版本',

package/dist/index.d.ts

@@ -35,6 +35,7 @@ export * from './components/board-module.js';
 export * from './components/icons.js';
 export * from './config/constants.js';
 export * from './config/storage.js';
+export * from './contract/approval.js';
 export * from './contract/blocker.js';
 export * from './contract/data.js';
 export * from './contract/extension.js';

package/dist/index.js

@@ -35,6 +35,7 @@ export * from './components/board-module.js';
 export * from './components/icons.js';
 export * from './config/constants.js';
 export * from './config/storage.js';
+export * from './contract/approval.js';
 export * from './contract/blocker.js';
 export * from './contract/data.js';
 export * from './contract/extension.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-workbench/shared",
-  "version": "1.1.3",
+  "version": "1.1.5",
   "description": "工作台与模块共享的纯代码与契约类型：类型、纯逻辑、哑组件、平台解析。宿主侧的东西从 /host 进（不影响浏览器产物）。",
   "license": "MIT",
   "type": "module",

package/src/api/host-write.ts

@@ -1,3 +1,5 @@
+import type { InstallFailure } from '../contract/command.js';
+
 /**
  * 宿主写口的五条通道（偏好、动作、供给、工坊调试、工坊录制），是写路由的第一段。
  */
@@ -9,7 +11,8 @@ export type WriteChannel =
   | 'diy-record';
 
 /**
- * 写通道统一的结果：成了带值，没成带一句能给人看的话（可选明细与帮助链接）。
+ * 写通道统一的结果：成了带值，没成带一句能给人看的话（可选明细与帮助链接）；
+ * 安装类的失败多带一份结构化现场，界面据此给修法。
  */
 export type WriteOutcome<T> =
   | { readonly ok: true; readonly value: T }
@@ -18,4 +21,5 @@ export type WriteOutcome<T> =
       readonly message: string;
       readonly detail?: string;
       readonly helpUrl?: string;
+      readonly failure?: InstallFailure;
     };

package/src/api/workbench-client.ts

@@ -1,4 +1,5 @@
 import { API_PREFIX } from '../config/constants.js';
+import type { InstallFailure } from '../contract/command.js';
 
 /**
  * 宿主读口 / 写口回的错误：code 给判据分档，message 给人看，helpUrl 有就去点。
@@ -9,6 +10,7 @@ export interface ApiError {
   readonly detail?: string;
   readonly hint?: string;
   readonly helpUrl?: string;
+  readonly failure?: InstallFailure;
 }
 
 /**

package/src/components/ApprovalPlan.css

@@ -10,22 +10,21 @@
   color: var(--dsw-alias-label-secondary);
 }
 .wb-approvalRows {
-  display: flex;
-  flex-direction: column;
-  gap: var(--wb-len-2);
+  display: grid;
+  grid-template-columns: minmax(var(--wb-len-56), auto) minmax(0, 1fr);
+  column-gap: var(--wb-len-8);
+  row-gap: var(--wb-len-2);
+  align-items: baseline;
   margin: 0;
 }
 .wb-approvalRow {
-  display: flex;
-  align-items: baseline;
-  gap: var(--wb-len-8);
+  display: contents;
 }
 .wb-approvalLabel {
-  flex: none;
-  width: var(--wb-len-56);
   font-size: var(--dsw-font-xxs-12-font-size);
   line-height: var(--wb-line-18);
   color: var(--dsw-alias-label-tertiary);
+  overflow-wrap: anywhere;
 }
 .wb-approvalValue {
   margin: 0;

package/src/config/constants.ts

@@ -109,6 +109,12 @@ export const STORAGE_KEY_RIGHTBAR_COLUMN = "dsh-workbench.rightbar.column";
 /** 记住右栏宽度（像素数字的字符串）的 localStorage 键。 */
 export const STORAGE_KEY_RIGHTBAR_WIDTH = "dsh-workbench.rightbar.width";
 
+/** 记住「添加模块」浮层选过的安装源的 localStorage 键。 */
+export const STORAGE_KEY_MARKET_REGISTRY = "dsh-workbench.market.registry";
+
+/** 记住「添加模块」浮层上次填过的自定义源地址的 localStorage 键。 */
+export const STORAGE_KEY_MARKET_REGISTRY_CUSTOM = "dsh-workbench.market.registry.custom";
+
 /** 右栏宽度达到或超过多少像素就按全屏对待（阈值，像素）。 */
 export const RIGHTBAR_FULLSCREEN_WIDTH = 768;
 

package/src/contract/__tests__/needs.test.ts

@@ -37,6 +37,59 @@ describe('needs 校验矩阵', () => {
     );
   });
 
+  it('bin 声明 install → 过；install 写歪了要判红并点名', () => {
+    expect(
+      errorsOf({
+        kind: 'bin',
+        name: 'gitops',
+        purpose: '平台命令',
+        install: { kind: 'command', line: 'brew install pagoda/tap/gitops', platforms: ['darwin'] },
+        docs: 'https://internal/gitops',
+      }),
+    ).toEqual([]);
+
+    expect(errorsOf({ kind: 'bin', name: 'x', purpose: 'p', install: { kind: 'brew', line: 'x' } }).join(' ')).toContain(
+      'install.kind 只认 command',
+    );
+    expect(errorsOf({ kind: 'bin', name: 'x', purpose: 'p', install: { kind: 'command', line: '' } }).join(' ')).toContain(
+      'install.line 没写',
+    );
+    expect(
+      errorsOf({ kind: 'bin', name: 'x', purpose: 'p', install: { kind: 'command', line: 'x', platforms: ['mac'] } }).join(' '),
+    ).toContain('darwin / linux / win32');
+    expect(errorsOf({ kind: 'bin', name: 'x', purpose: 'p', install: { kind: 'command', line: 'x', url: 'y' } }).join(' ')).toContain(
+      'install 有不认识的字段 url',
+    );
+  });
+
+  it('bin 的 install 也可以是一个 npm 包（命令由包提供，装进隔离运行时）', () => {
+    expect(
+      errorsOf({
+        kind: 'bin',
+        name: 'gitops',
+        purpose: '平台命令',
+        install: {
+          kind: 'npm',
+          package: 'opencli-workflow',
+          registryEnv: 'ACME_REGISTRY',
+          registryDefault: 'https://registry.test/',
+        },
+      }),
+    ).toEqual([]);
+
+    expect(errorsOf({ kind: 'bin', name: 'x', purpose: 'p', install: { kind: 'npm' } }).join(' ')).toContain(
+      'install.package 没写',
+    );
+    expect(
+      errorsOf({
+        kind: 'bin',
+        name: 'x',
+        purpose: 'p',
+        install: { kind: 'npm', package: 'x', registryDefault: 'ftp://x' },
+      }).join(' '),
+    ).toContain('registryDefault 要是 http(s):// 或 file:// 的源地址');
+  });
+
   it('bin / env 写了 sources → 红（没有安装路径）', () => {
     expect(errorsOf({ kind: 'bin', name: 'x', purpose: '测试', sources: [npm] }).join(' ')).toContain(
       '不支持 sources',

package/src/contract/approval.ts

@@ -0,0 +1,4 @@
+/**
+ * agent 自己那句"这次想干什么"的参数名：插件命令族必填，审批屏把它画在详情座里，不进标题。
+ */
+export const APPROVAL_NOTE_ARG = 'approval_note';

package/src/contract/command.ts

@@ -23,3 +23,25 @@ export interface CommandResult {
 export interface CommandReader {
   run(request: CommandRequest): Promise<CommandResult>;
 }
+
+export const INSTALL_FAILURE_KINDS = ['permission', 'disk-full', 'sandbox', 'unknown'] as const;
+
+export type InstallFailureKind = (typeof INSTALL_FAILURE_KINDS)[number];
+
+export type InstallFix =
+  | { readonly kind: 'chown'; readonly path: string; readonly uid: number; readonly gid: number }
+  | { readonly kind: 'chmod'; readonly path: string }
+  | { readonly kind: 'space'; readonly path: string }
+  | { readonly kind: 'handoff' };
+
+export interface InstallFailure {
+  readonly kind: InstallFailureKind;
+  readonly command: string;
+  readonly exitCode: number | null;
+  readonly output: string;
+  readonly path?: string | undefined;
+  readonly mode?: string | undefined;
+  readonly owner?: { readonly uid: number; readonly gid: number } | undefined;
+  readonly current: { readonly uid: number; readonly gid: number };
+  readonly fix: InstallFix;
+}

package/src/contract/needs.ts

@@ -41,12 +41,31 @@ export interface NeedCommon {
   readonly id?: string;
 }
 
+/**
+ * 一条装这个可执行文件的命令；模块作者写，工作台照抄执行。
+ */
+export type BinInstall =
+  | {
+      readonly kind: 'command';
+      readonly line: string;
+      readonly platforms?: readonly string[] | undefined;
+    }
+  | {
+      readonly kind: 'npm';
+      readonly package: string;
+      readonly registryEnv?: string | undefined;
+      readonly registryDefault?: string | undefined;
+      readonly platforms?: readonly string[] | undefined;
+    };
+
 /**
  * 机器上要有一个可执行文件；探法是 `command -v` / `where`。
  */
 export interface BinNeed extends NeedCommon {
   readonly kind: 'bin';
   readonly name: string;
+  readonly install?: BinInstall | undefined;
+  readonly docs?: string | undefined;
 }
 
 /**
@@ -107,6 +126,8 @@ export const NEED_KEYS: readonly string[] = [
   'version',
   'sources',
   'secret',
+  'install',
+  'docs',
 ];
 
 /**
@@ -188,7 +209,7 @@ function sourcesProblemsOf(
   if (!Array.isArray(raw)) return [`${at}.sources 要是数组`];
   if (raw.length === 0) return [`${at}.sources 是空数组 —— 不代装就整条删掉`];
   if (allowed.length === 0) {
-    return [`${at} 这种需要不支持 sources —— 它没有「从哪装」这回事`];
+    return [`${at} 这种需要不支持 sources —— 要代装就写 install（一条命令）`];
   }
   const errors: string[] = [];
   raw.forEach((source, index) => {
@@ -214,6 +235,38 @@ function commonProblemsOf(raw: Readonly<Record<string, unknown>>, at: string): r
   return errors;
 }
 
+export function binInstallProblemsOf(raw: unknown, at: string): readonly string[] {
+  if (raw === undefined) return [];
+  if (!isRecord(raw)) return [`${at}.install 要是对象`];
+  const errors: string[] = [];
+  for (const key of Object.keys(raw)) {
+    if (!['kind', 'line', 'platforms', 'package', 'registryEnv', 'registryDefault'].includes(key)) {
+      errors.push(`${at}.install 有不认识的字段 ${key}`);
+    }
+  }
+  const kind = text(raw['kind']);
+  if (kind !== 'command' && kind !== 'npm') {
+    errors.push(`${at}.install.kind 只认 command（一条命令）或 npm（一个包，装进隔离运行时）`);
+  }
+  if (kind === 'command' && text(raw['line']) === '') {
+    errors.push(`${at}.install.line 没写 —— 要一条能直接粘进终端的命令`);
+  }
+  if (kind === 'npm' && text(raw['package']) === '') {
+    errors.push(`${at}.install.package 没写 —— 这个命令由哪个 npm 包提供`);
+  }
+  if (raw['registryDefault'] !== undefined && !REGISTRY_PATTERN.test(text(raw['registryDefault']))) {
+    errors.push(`${at}.install.registryDefault 要是 http(s):// 或 file:// 的源地址`);
+  }
+  if (raw['platforms'] !== undefined) {
+    if (!Array.isArray(raw['platforms']) || raw['platforms'].length === 0) {
+      errors.push(`${at}.install.platforms 要是非空数组`);
+    } else if (raw['platforms'].some((one) => !['darwin', 'linux', 'win32'].includes(text(one)))) {
+      errors.push(`${at}.install.platforms 只认 darwin / linux / win32`);
+    }
+  }
+  return errors;
+}
+
 function perKindProblemsOf(
   kind: NeedKind,
   raw: Readonly<Record<string, unknown>>,
@@ -223,6 +276,8 @@ function perKindProblemsOf(
   if (kind === 'bin' || kind === 'lib' || kind === 'env') {
     if (text(raw['name']) === '') errors.push(`${at}.name 没写`);
   }
+  if (kind === 'bin') errors.push(...binInstallProblemsOf(raw['install'], at));
+  if (raw['docs'] !== undefined && text(raw['docs']) === '') errors.push(`${at}.docs 是空串`);
   if (kind === 'extension') {
     if (text(raw['runtime']) === '') errors.push(`${at}.runtime 没写 —— 扩展属于哪个运行时（如 opencli）`);
     if (text(raw['name']) === '') errors.push(`${at}.name 没写`);

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

@@ -1,3 +1,4 @@
+import type { MarketInstalledModule } from './market-index.js';
 import type { UnitTitle } from '../unit.js';
 
 export const BUNDLE_REGISTRIES_ROUTE = 'bundle-registries';
@@ -178,6 +179,8 @@ export interface BundleCancellationPayload {
 
 export type ModuleUpdateBlock = 'needs-workbench' | 'incompatible';
 
+export type LatestUnavailable = 'local' | 'no-registry' | 'not-registry' | 'probe-failed';
+
 export interface ModuleVersion {
   readonly unit: string;
   readonly pkg: string;
@@ -185,8 +188,10 @@ export interface ModuleVersion {
   readonly title?: UnitTitle;
   readonly latest?: string;
   readonly latestBlocked?: ModuleUpdateBlock;
+  readonly latestUnavailable?: LatestUnavailable;
   readonly local?: boolean;
   readonly refused?: readonly string[];
+  readonly market?: MarketInstalledModule;
 }
 
 export interface WorkbenchVersion {

package/src/contract/protocol/market-index.ts

@@ -3,6 +3,7 @@ export const MARKET_INDEX_PATH = 'market.json';
 export const MARKET_DISCOVER_ROUTE = 'panels/market-discover';
 export const MARKET_DOC_ROUTE = 'panels/market-doc';
 export const MARKET_GIT_PROBE_ROUTE = 'panels/git-probe';
+export const MARKET_INSTALLED_ROUTE = 'panels/market-installed';
 export const MARKET_PUBLISH_PREVIEW_ROUTE = 'panels/market-publish-preview';
 export const MARKET_SOURCES_RESOURCE = 'market-sources';
 export const MARKET_SOURCES_ROUTE = 'panels/market-sources';
@@ -217,9 +218,25 @@ export interface DiscoverFilter {
   readonly label?: string;
 }
 
+export type GitTransportKind = 'https' | 'ssh';
+
 export interface MarketSourcesPayload {
   readonly sources: readonly MarketSourceConfig[];
   readonly selected: string | null;
+  readonly transports?: Readonly<Record<string, GitTransportKind>>;
+}
+
+export interface MarketInstalledModule {
+  readonly pkg: string;
+  readonly unit: string;
+  readonly version: string;
+  readonly sourceId: string;
+  readonly sourceLabel: string;
+  readonly source: MarketIndexSource;
+}
+
+export interface MarketInstalledPayload {
+  readonly modules: readonly MarketInstalledModule[];
 }
 
 export interface MarketPublishDestination {

package/src/contract/unit.ts

@@ -24,12 +24,23 @@ export interface UnitCard {
   readonly order: number;
 }
 
+/**
+ * 合成工具背后那条 opencli 命令：插件名与命令名都是 opencli 那边的原名，`args` 是命令自己声明的参数名（按声明顺序）。
+ */
+export interface UnitToolOpencli {
+  readonly plugin: string;
+  readonly command: string;
+  readonly args: readonly string[];
+}
+
 /**
  * 一条工具在清单里的样子：全名加会不会写；审批按 writes 认领。
+ * `opencli` 只有「按已装插件合成」的单元写，手写模块的工具没有这一格。
  */
 export interface UnitTool {
   readonly name: string;
   readonly writes: boolean;
+  readonly opencli?: UnitToolOpencli;
 }
 
 /**

package/src/host/adapter-types.ts

@@ -25,6 +25,7 @@ export interface ProfileModule {
   readonly version: string;
   readonly registry?: string;
   readonly local?: boolean;
+  readonly fromRegistry?: boolean;
 }
 
 export interface ProfilePackage {
@@ -51,6 +52,7 @@ export interface RegistryEntry {
 export interface RegistryNotebook {
   sources(): readonly RegistryEntry[];
   remember(entries: readonly RegistryEntry[]): readonly string[];
+  swapScope?(scope: string, registry: string): () => void;
 }
 
 export interface SelfUpdatePaths {

package/src/host/data-error.ts

@@ -4,11 +4,12 @@ export class WorkbenchDataError extends Error {
   readonly hint?: string;
   readonly project?: unknown;
   readonly helpUrl?: string;
+  readonly failure?: unknown;
 
   constructor(
     code: string,
     message: string,
-    extra: { detail?: string; hint?: string; project?: unknown; helpUrl?: string } = {},
+    extra: { detail?: string; hint?: string; project?: unknown; helpUrl?: string; failure?: unknown } = {},
   ) {
     super(message);
     this.name = 'WorkbenchDataError';
@@ -17,5 +18,6 @@ export class WorkbenchDataError extends Error {
     if (extra.hint !== undefined) this.hint = extra.hint;
     if (extra.project !== undefined) this.project = extra.project;
     if (extra.helpUrl !== undefined) this.helpUrl = extra.helpUrl;
+    if (extra.failure !== undefined) this.failure = extra.failure;
   }
 }

package/src/host/http.ts

@@ -49,6 +49,7 @@ function toErrorPayload(error: unknown): Record<string, unknown> {
       ...(data.hint === undefined ? {} : { hint: data.hint }),
       ...(data.helpUrl === undefined ? {} : { helpUrl: data.helpUrl }),
       ...(data.project === undefined ? {} : { project: data.project }),
+      ...(data.failure === undefined ? {} : { failure: data.failure }),
     };
   }
   return { code: 'internal', message: error instanceof Error ? error.message : String(error) };