@dsh-workbench/shared 1.1.7 → 1.1.9

package/dist/i18n/zh.d.ts

@@ -82,7 +82,11 @@ export declare const zh: {
     readonly 'time.short.years': "{n}年";
     readonly 'panels.title': "面板模块";
     readonly 'panels.groupBoardless': "无看板模块";
-    readonly 'panels.groupPlugins': "opencli 插件";
+    readonly 'panels.groupPlugins': "插件";
+    readonly 'runtime.plugin': "插件";
+    readonly 'runtime.pluginOf': "运行时提供的插件";
+    readonly 'runtime.pluginThing': "插件";
+    readonly 'runtime.pluginArea': "插件区";
     readonly 'panels.market.defaultHint': "打开后所有工作区默认开启，也可在工作区面板配置中单独关闭";
     readonly 'panels.market.defaultLabel': "全局默认开启";
     readonly 'panels.market.defaultLocked': "这份现在用不了，先更新或卸载";
@@ -160,9 +164,6 @@ export declare const zh: {
     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': "没装上：被系统拦住了";
@@ -202,7 +203,7 @@ export declare const zh: {
     readonly 'panels.market.noSource': "这个模块没声明怎么装，只能自己动手";
     readonly 'panels.market.badSource': "安装方式没写全，只能自己动手";
     readonly 'panels.market.empty': "暂无可用模块";
-    readonly 'panels.market.sectionPlugins': "已安装 opencli 插件";
+    readonly 'panels.market.sectionPlugins': "已安装的插件";
     readonly 'panels.market.moduleOutdated': "有新版";
     readonly 'panels.market.updateNeedsWorkbench': "新版本要先把工作台升级才能用";
     readonly 'panels.market.updateIncompatible': "新版本和当前的工作台不匹配，暂时不能更新";
@@ -240,7 +241,7 @@ export declare const zh: {
     readonly 'panels.market.justNow': "刚刚";
     readonly 'panels.market.minutesAgo': "{n} 分钟前";
     readonly 'panels.market.hoursAgo': "{n} 小时前";
-    readonly 'panels.market.add.description': "输入模块或 opencli 插件的包名、Git 仓库地址或本地目录路径。";
+    readonly 'panels.market.add.description': "输入模块或 {plugin}的包名、Git 仓库地址或本地目录路径。";
     readonly 'panels.market.add.specPlaceholder': "例如 @dsh-workbench/module-hello";
     readonly 'panels.market.add.guideToggle': "模块安装引导和示例";
     readonly 'panels.market.add.guideHide': "收起引导";
@@ -279,12 +280,12 @@ export declare const zh: {
     readonly 'panels.market.add.problemInstalled': "这个模块已经装过了（要换版本请带上 @版本）";
     readonly 'panels.market.add.problemNotFound': "未找到相关模块";
     readonly 'panels.market.add.problemNotPackage': "该路径不存在或不是有效的模块包";
-    readonly 'panels.market.add.problemNotBundle': "这个包装不进这里：{reason}。这个入口按包名认工作台模块和 opencli 插件，两种都能装；但 git 地址和 tarball 判断不出它是什么 —— 要是它其实是这两样之一，请改填包名或本地目录。";
+    readonly 'panels.market.add.problemNotBundle': "这个包装不进这里：{reason}。这个入口按包名认工作台模块和 {plugin}，两种都能装；但 git 地址和 tarball 判断不出它是什么 —— 要是它其实是这两样之一，请改填包名或本地目录。";
     readonly 'panels.market.add.problemNotWorkbenchModule': "这个包跟现在的工作台对不上，装上也用不了。换一个版本，或者找这个模块的作者。";
-    readonly 'panels.market.add.problemNotModuleOrPlugin': "这个包既不是工作台的模块，也不是 opencli 的插件，装了也用不上。换一个版本，或者找这个包的作者。";
-    readonly 'panels.market.add.failureNotModuleOrPlugin': "这个包既不是工作台的模块，也不是 opencli 的插件，装了也用不上";
-    readonly 'panels.market.add.installedPlugin': "装上了：opencli 插件 {name}";
-    readonly 'panels.market.add.pluginPreview': "这是一份 opencli 插件：装进 opencli 的插件区，装完就能用，不用重启。";
+    readonly 'panels.market.add.problemNotModuleOrPlugin': "这个包既不是工作台的模块，也不是 {pluginOf}，装了也用不上。换一个版本，或者找这个包的作者。";
+    readonly 'panels.market.add.failureNotModuleOrPlugin': "这个包既不是工作台的模块，也不是 {pluginOf}，装了也用不上";
+    readonly 'panels.market.add.installedPlugin': "装上了：{plugin} {name}";
+    readonly 'panels.market.add.pluginPreview': "这是一份 {pluginThing}：装进 {pluginArea}，装完就能用，不用重启。";
     readonly 'panels.market.add.pluginAlias': "插件名：{name}";
     readonly 'panels.market.add.problemNetwork': "无法连接模块源，请检查网络后重试";
     readonly 'panels.market.add.problemUnknown': "无法获取模块信息：{reason}";
@@ -380,7 +381,7 @@ export declare const zh: {
     readonly 'panels.discover.missingIndex': "仓库里还没有索引文件 {path}";
     readonly 'panels.discover.initTitle': "把这个仓库初始化成模块市场索引？";
     readonly 'panels.discover.initCta': "初始化成市场索引";
-    readonly 'panels.discover.initWhat': "会在 {branch} 分支写索引目录 market/ 与 README.md，提交一次并推上去；之后从这个工作台发布的模块会把打包好的文件提交到 artifacts/<包名>/<版本>/，条目写到 market/<包名>/<版本>.json。仓库的写权限归它的所有者。";
+    readonly 'panels.discover.initWhat': "会在 {branch} 分支写索引目录 market/ 与 README.md，提交一次并推上去；之后从这个工作台发布的模块会把打包好的文件提交到 artifacts/<包名>/，条目写到 market/<包名>.json。仓库的写权限归它的所有者。";
     readonly 'panels.discover.initBranch': "分支";
     readonly 'panels.discover.initBranchHint': "索引和打包文件都发到这个分支；空仓库会新建它。";
     readonly 'panels.discover.initBranchBad': "分支名只能用字母、数字、点、下划线、斜杠或短横线";
@@ -560,7 +561,7 @@ export declare const zh: {
     readonly 'blocker.forbidden.hint': "账号已登录，但没有这个项目/仓库的权限；申请之后再试。";
     readonly 'blocker.forbidden.open': "打开权限页";
     readonly 'blocker.timeout.hint': "后台浏览器没起来，重试一次通常就好。";
-    readonly 'blocker.exec.hint': "确认 opencli 已经装好、在终端里能直接运行（which opencli）。";
+    readonly 'blocker.exec.hint': "确认运行时已经装好、在终端里能直接跑起来。";
     readonly 'blocker.unknown.title': "出了点问题";
     readonly 'panels.reading': "正在读取面板配置…";
     readonly 'panels.cardBroken': "这个模块起不来：{unit}（{reason}）";
@@ -577,16 +578,11 @@ export declare const zh: {
     readonly 'env.stepFailed.shell': "连不上命令行";
     readonly 'env.toolchain.ok': "正常";
     readonly 'env.toolchain.warn': "还没完全准备好";
-    readonly 'env.opencli.ok': "已就绪";
+    readonly 'env.runtime.ok': "已就绪";
     readonly 'env.bridge.ok': "已连接";
     readonly 'env.bridge.short': "还没连上";
     readonly 'env.bridge.why': "面板的数据要用你浏览器里的登录状态。这个连接没通，模块就取不到数据；不拦路：修好它，或者先进入工作台。";
     readonly 'env.bridge.hold': "浏览器还没连上 —— 按下面修好后点「重试」，也可以先进工作台。";
-    readonly 'env.bridge.daemon': "后台服务没起来：正常它会自己起，先在终端跑下面这条命令。";
-    readonly 'env.bridge.extension': "浏览器扩展没连上：确认浏览器开着、扩展已启用；没装就从商店装一次（装完回来点「重试」）。";
-    readonly 'env.bridge.extensionLink': "去 Chrome 应用商店装扩展";
-    readonly 'env.bridge.profile': "连上了多个浏览器账号，但没选默认的那个：先看有哪些（下面这条命令），再选一个。";
-    readonly 'env.bridge.stale': "默认的浏览器账号已经失效（它记的是上一次的扩展实例）：重新选一个。";
     readonly 'env.bridge.unknown': "没认出是哪种问题：展开原文，按里面的步骤处理。";
     readonly 'env.fix.title': "怎么解决";
     readonly 'env.fix.why': "工作台用它自己那份后台工具（与你在终端里那套分开装，互不影响），这台机器上还没装好它。";
@@ -616,7 +612,8 @@ export declare const zh: {
     readonly 'env.copyCommand': "复制命令";
     readonly 'env.copied': "已复制";
     readonly 'env.step.toolchain': "运行环境";
-    readonly 'env.step.opencli': "后台工具";
+    readonly 'env.step.adapter': "运行时";
+    readonly 'env.step.runtime': "后台工具";
     readonly 'env.step.bridge': "浏览器连接";
     readonly 'env.step.diy': "DIY 模式";
     readonly 'env.step.warm': "站点登录状态";
@@ -711,6 +708,8 @@ export declare const zh: {
     readonly 'approval.publish.version': "版本";
     readonly 'approval.publish.author': "作者";
     readonly 'approval.publish.authorMissing': "未署名";
+    readonly 'approval.publish.labels': "标签";
+    readonly 'approval.publish.labelsMissing': "还没有（发布到市场时补 1–2 个）";
     readonly 'approval.publish.owner': "认领人";
     readonly 'approval.publish.ownerUnowned': "原来没署名";
     readonly 'approval.publish.ownerTaken': "已有主人：{owner}";

package/dist/i18n/zh.js

@@ -74,7 +74,11 @@ export const zh = {
     'time.short.years': '{n}年',
     'panels.title': '面板模块',
     'panels.groupBoardless': '无看板模块',
-    'panels.groupPlugins': 'opencli 插件',
+    'panels.groupPlugins': '插件',
+    'runtime.plugin': '插件',
+    'runtime.pluginOf': '运行时提供的插件',
+    'runtime.pluginThing': '插件',
+    'runtime.pluginArea': '插件区',
     'panels.market.defaultHint': '打开后所有工作区默认开启，也可在工作区面板配置中单独关闭',
     'panels.market.defaultLabel': '全局默认开启',
     'panels.market.defaultLocked': '这份现在用不了，先更新或卸载',
@@ -152,9 +156,6 @@ export const zh = {
     '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': '没装上：被系统拦住了',
@@ -194,7 +195,7 @@ export const zh = {
     'panels.market.noSource': '这个模块没声明怎么装，只能自己动手',
     'panels.market.badSource': '安装方式没写全，只能自己动手',
     'panels.market.empty': '暂无可用模块',
-    'panels.market.sectionPlugins': '已安装 opencli 插件',
+    'panels.market.sectionPlugins': '已安装的插件',
     'panels.market.moduleOutdated': '有新版',
     'panels.market.updateNeedsWorkbench': '新版本要先把工作台升级才能用',
     'panels.market.updateIncompatible': '新版本和当前的工作台不匹配，暂时不能更新',
@@ -232,7 +233,7 @@ export const zh = {
     'panels.market.justNow': '刚刚',
     'panels.market.minutesAgo': '{n} 分钟前',
     'panels.market.hoursAgo': '{n} 小时前',
-    'panels.market.add.description': '输入模块或 opencli 插件的包名、Git 仓库地址或本地目录路径。',
+    'panels.market.add.description': '输入模块或 {plugin}的包名、Git 仓库地址或本地目录路径。',
     'panels.market.add.specPlaceholder': '例如 @dsh-workbench/module-hello',
     'panels.market.add.guideToggle': '模块安装引导和示例',
     'panels.market.add.guideHide': '收起引导',
@@ -271,12 +272,12 @@ export const zh = {
     'panels.market.add.problemInstalled': '这个模块已经装过了（要换版本请带上 @版本）',
     'panels.market.add.problemNotFound': '未找到相关模块',
     'panels.market.add.problemNotPackage': '该路径不存在或不是有效的模块包',
-    'panels.market.add.problemNotBundle': '这个包装不进这里：{reason}。这个入口按包名认工作台模块和 opencli 插件，两种都能装；但 git 地址和 tarball 判断不出它是什么 —— 要是它其实是这两样之一，请改填包名或本地目录。',
+    'panels.market.add.problemNotBundle': '这个包装不进这里：{reason}。这个入口按包名认工作台模块和 {plugin}，两种都能装；但 git 地址和 tarball 判断不出它是什么 —— 要是它其实是这两样之一，请改填包名或本地目录。',
     'panels.market.add.problemNotWorkbenchModule': '这个包跟现在的工作台对不上，装上也用不了。换一个版本，或者找这个模块的作者。',
-    'panels.market.add.problemNotModuleOrPlugin': '这个包既不是工作台的模块，也不是 opencli 的插件，装了也用不上。换一个版本，或者找这个包的作者。',
-    'panels.market.add.failureNotModuleOrPlugin': '这个包既不是工作台的模块，也不是 opencli 的插件，装了也用不上',
-    'panels.market.add.installedPlugin': '装上了：opencli 插件 {name}',
-    'panels.market.add.pluginPreview': '这是一份 opencli 插件：装进 opencli 的插件区，装完就能用，不用重启。',
+    'panels.market.add.problemNotModuleOrPlugin': '这个包既不是工作台的模块，也不是 {pluginOf}，装了也用不上。换一个版本，或者找这个包的作者。',
+    'panels.market.add.failureNotModuleOrPlugin': '这个包既不是工作台的模块，也不是 {pluginOf}，装了也用不上',
+    'panels.market.add.installedPlugin': '装上了：{plugin} {name}',
+    'panels.market.add.pluginPreview': '这是一份 {pluginThing}：装进 {pluginArea}，装完就能用，不用重启。',
     'panels.market.add.pluginAlias': '插件名：{name}',
     'panels.market.add.problemNetwork': '无法连接模块源，请检查网络后重试',
     'panels.market.add.problemUnknown': '无法获取模块信息：{reason}',
@@ -372,7 +373,7 @@ export const zh = {
     'panels.discover.missingIndex': '仓库里还没有索引文件 {path}',
     'panels.discover.initTitle': '把这个仓库初始化成模块市场索引？',
     'panels.discover.initCta': '初始化成市场索引',
-    'panels.discover.initWhat': '会在 {branch} 分支写索引目录 market/ 与 README.md，提交一次并推上去；之后从这个工作台发布的模块会把打包好的文件提交到 artifacts/<包名>/<版本>/，条目写到 market/<包名>/<版本>.json。仓库的写权限归它的所有者。',
+    'panels.discover.initWhat': '会在 {branch} 分支写索引目录 market/ 与 README.md，提交一次并推上去；之后从这个工作台发布的模块会把打包好的文件提交到 artifacts/<包名>/，条目写到 market/<包名>.json。仓库的写权限归它的所有者。',
     'panels.discover.initBranch': '分支',
     'panels.discover.initBranchHint': '索引和打包文件都发到这个分支；空仓库会新建它。',
     'panels.discover.initBranchBad': '分支名只能用字母、数字、点、下划线、斜杠或短横线',
@@ -552,7 +553,7 @@ export const zh = {
     'blocker.forbidden.hint': '账号已登录，但没有这个项目/仓库的权限；申请之后再试。',
     'blocker.forbidden.open': '打开权限页',
     'blocker.timeout.hint': '后台浏览器没起来，重试一次通常就好。',
-    'blocker.exec.hint': '确认 opencli 已经装好、在终端里能直接运行（which opencli）。',
+    'blocker.exec.hint': '确认运行时已经装好、在终端里能直接跑起来。',
     'blocker.unknown.title': '出了点问题',
     'panels.reading': '正在读取面板配置…',
     'panels.cardBroken': '这个模块起不来：{unit}（{reason}）',
@@ -569,16 +570,11 @@ export const zh = {
     'env.stepFailed.shell': '连不上命令行',
     'env.toolchain.ok': '正常',
     'env.toolchain.warn': '还没完全准备好',
-    'env.opencli.ok': '已就绪',
+    'env.runtime.ok': '已就绪',
     'env.bridge.ok': '已连接',
     'env.bridge.short': '还没连上',
     'env.bridge.why': '面板的数据要用你浏览器里的登录状态。这个连接没通，模块就取不到数据；不拦路：修好它，或者先进入工作台。',
     'env.bridge.hold': '浏览器还没连上 —— 按下面修好后点「重试」，也可以先进工作台。',
-    'env.bridge.daemon': '后台服务没起来：正常它会自己起，先在终端跑下面这条命令。',
-    'env.bridge.extension': '浏览器扩展没连上：确认浏览器开着、扩展已启用；没装就从商店装一次（装完回来点「重试」）。',
-    'env.bridge.extensionLink': '去 Chrome 应用商店装扩展',
-    'env.bridge.profile': '连上了多个浏览器账号，但没选默认的那个：先看有哪些（下面这条命令），再选一个。',
-    'env.bridge.stale': '默认的浏览器账号已经失效（它记的是上一次的扩展实例）：重新选一个。',
     'env.bridge.unknown': '没认出是哪种问题：展开原文，按里面的步骤处理。',
     'env.fix.title': '怎么解决',
     'env.fix.why': '工作台用它自己那份后台工具（与你在终端里那套分开装，互不影响），这台机器上还没装好它。',
@@ -608,7 +604,8 @@ export const zh = {
     'env.copyCommand': '复制命令',
     'env.copied': '已复制',
     'env.step.toolchain': '运行环境',
-    'env.step.opencli': '后台工具',
+    'env.step.adapter': '运行时',
+    'env.step.runtime': '后台工具',
     'env.step.bridge': '浏览器连接',
     'env.step.diy': 'DIY 模式',
     'env.step.warm': '站点登录状态',
@@ -703,6 +700,8 @@ export const zh = {
     'approval.publish.version': '版本',
     'approval.publish.author': '作者',
     'approval.publish.authorMissing': '未署名',
+    'approval.publish.labels': '标签',
+    'approval.publish.labelsMissing': '还没有（发布到市场时补 1–2 个）',
     'approval.publish.owner': '认领人',
     'approval.publish.ownerUnowned': '原来没署名',
     'approval.publish.ownerTaken': '已有主人：{owner}',

package/dist/index.d.ts

@@ -42,6 +42,8 @@ export * from './contract/extension.js';
 export * from './contract/lib.js';
 export * from './contract/git.js';
 export * from './contract/command.js';
+export * from './contract/runner.js';
+export * from './contract/plugin-source.js';
 export * from './contract/facts.js';
 export * from './contract/long-task.js';
 export * from './contract/protocol/bundle-install.js';
@@ -57,12 +59,14 @@ export * from './contract/protocol/unit-manifests.js';
 export * from './contract/unit-board.js';
 export * from './contract/unit-declaration.js';
 export * from './contract/unit.js';
+export * from './contract/capabilities.js';
 export * from './contract/needs.js';
 export * from './contract/unit-capability.js';
 export * from './contract/workbench-contract.js';
 export * from './i18n/en.js';
 export * from './i18n/index.js';
 export * from './i18n/merge.js';
+export * from './i18n/runtime-terms.js';
 export * from './i18n/settings.js';
 export * from './i18n/zh.js';
 export * from './lib/blocker-action.js';

package/dist/index.js

@@ -42,6 +42,8 @@ export * from './contract/extension.js';
 export * from './contract/lib.js';
 export * from './contract/git.js';
 export * from './contract/command.js';
+export * from './contract/runner.js';
+export * from './contract/plugin-source.js';
 export * from './contract/facts.js';
 export * from './contract/long-task.js';
 export * from './contract/protocol/bundle-install.js';
@@ -57,12 +59,14 @@ export * from './contract/protocol/unit-manifests.js';
 export * from './contract/unit-board.js';
 export * from './contract/unit-declaration.js';
 export * from './contract/unit.js';
+export * from './contract/capabilities.js';
 export * from './contract/needs.js';
 export * from './contract/unit-capability.js';
 export * from './contract/workbench-contract.js';
 export * from './i18n/en.js';
 export * from './i18n/index.js';
 export * from './i18n/merge.js';
+export * from './i18n/runtime-terms.js';
 export * from './i18n/settings.js';
 export * from './i18n/zh.js';
 export * from './lib/blocker-action.js';

package/dist/testing/fake-adapter-set.d.ts

@@ -0,0 +1,5 @@
+import type { AdapterSet } from '../host/adapters.js';
+export declare const FAKE_ADAPTER_MARKER: {
+    readonly adapterSet: "fake";
+};
+export declare function fakeAdapterSet(overrides?: Partial<AdapterSet>): AdapterSet;

package/dist/testing/fake-adapter-set.js

@@ -0,0 +1,150 @@
+import { ADAPTER_SET_API_VERSION } from '../host/adapters.js';
+import { readBundleManager } from '../host/bundle-manager.js';
+import { declarationGaps, moduleDeclarationOf, profileDirOf, profileModules, readInstalledModule, readProfilePackage, } from '../host/installed-module.js';
+import { isNewerVersion } from '../host/version.js';
+import { refusalReason } from '../host/spec.js';
+import { declarationRefusalOf, pathDeclarationOf } from '../host/local-declaration.js';
+import { createRegistryLookup } from '../host/registry-declaration.js';
+import { createPackageRouter } from '../host/package-route.js';
+import { createReleaseProbe } from '../host/release-probe.js';
+export const FAKE_ADAPTER_MARKER = { adapterSet: 'fake' };
+function result() {
+    return { ok: true, data: FAKE_ADAPTER_MARKER };
+}
+const data = {
+    async read(_request) {
+        return result();
+    },
+    async request(_recipe) {
+        return result();
+    },
+    async requestMany(_recipe, _calls) {
+        return {};
+    },
+    async submit(_recipe) {
+        return result();
+    },
+};
+const supply = {
+    resolvePluginSource: () => ({ ok: false, problem: 'not-declared' }),
+    libInstallCommand: () => '',
+    libUninstallCommand: () => '',
+    pluginInstallPlan: () => ({ ok: false, problem: 'not-declared' }),
+    latestVersion: async () => undefined,
+    missingReleaseParts: async () => [],
+    probeRelease: async () => undefined,
+    splitNpmSpec: () => undefined,
+};
+const modules = {
+    isolatedRoot: () => '/tmp/dsh-workbench-fake',
+    isolatedHome: () => '/tmp/dsh-workbench-fake/home',
+    pluginPackagePrefix: () => 'fake-plugin-',
+    pluginManifestFile: () => 'fake-plugin.json',
+    cliCatalogPath: () => '/tmp/dsh-workbench-fake/catalog.json',
+    vendorPluginsDir: () => '/tmp/dsh-workbench-fake/plugins',
+    runtimeInstallCommand: () => 'npm i -g fake-runtime',
+    afterLibInstall: () => undefined,
+    profileDirOf: (ctx) => profileDirOf(ctx),
+    profileModules,
+    readInstalledModule,
+    readProfilePackage,
+    readBundleManager,
+    createRegistryNotebook: () => ({}),
+    declarationGaps,
+    moduleDeclarationOf,
+    registryDeclarationOf: async () => undefined,
+    pathDeclarationOf,
+    declarationRefusalOf,
+    refusalReason,
+    packageRouteOf: async () => undefined,
+    isNewerVersion,
+    startSelfUpdate: () => ({}),
+};
+const profile = {
+    dirOf: () => null,
+    dshPlugins: () => () => ({ ok: true, plugins: [] }),
+    selfUpdateView: () => undefined,
+};
+const probe = {
+    probeUnits: async () => [],
+    registerPreflight: () => undefined,
+    declaredPluginCommands: () => new Map(),
+};
+const runtimePreset = (capabilities) => ({
+    packageRoot: () => '/tmp/dsh-workbench-fake',
+    capabilities: () => capabilities,
+    profile: () => ({
+        label: 'fake',
+        terms: {
+            plugin: { zh: '插件', en: 'plugin' },
+            pluginOf: { zh: '的插件', en: 'a plugin of' },
+            pluginThing: { zh: '插件', en: 'a plugin' },
+            pluginArea: { zh: '插件区', en: 'the plugin area' },
+        },
+        installHint: { zh: '无', en: 'nothing to install' },
+        diagnose: {},
+    }),
+    commandSurface: () => ({
+        name: 'fake',
+        pluginPrefix: 'fake-plugin-',
+        invoke: (site, command) => (command === undefined ? `fake ${site}` : `fake ${site} ${command}`),
+        help: (site) => `fake ${site} --help`,
+        browser: (verb) => `fake browser ${verb.join(' ')}`,
+    }),
+    commands: () => ({}),
+    runners: () => ({}),
+    health: () => ({}),
+    seed: () => undefined,
+    warnUnwritableRoot: () => undefined,
+});
+const plugins = {
+    declarationLookup: () => () => undefined,
+    createUnits: () => ({
+        refresh: async () => ({ units: [] }),
+        touch: () => undefined,
+        report: () => ({ units: [] }),
+        dispose: () => undefined,
+    }),
+};
+const actions = {
+    configSyncHandler: () => (async () => ({ ok: true })),
+    profileCreateHandler: () => (async () => ({ ok: true })),
+    configSyncAction: () => ({}),
+    profileCreateAction: () => ({}),
+};
+export function fakeAdapterSet(overrides = {}) {
+    const release = createReleaseProbe();
+    const registry = createRegistryLookup();
+    const router = createPackageRouter({ manifestFile: 'fake-plugin.json', dshLookup: registry.registryDshOf });
+    const withRelease = {
+        ...supply,
+        latestVersion: release.latestVersion,
+        missingReleaseParts: release.missingReleaseParts,
+        probeRelease: release.probeRelease,
+    };
+    return {
+        apiVersion: ADAPTER_SET_API_VERSION,
+        id: 'fake-adapter-set',
+        version: '0.0.0',
+        data,
+        supply: {
+            ...withRelease,
+            ...modules,
+            env: withRelease,
+            modules,
+            registryDeclarationOf: registry.registryDeclarationOf,
+            packageRouteOf: router.packageRouteOf,
+        },
+        modules,
+        profile,
+        probe,
+        runtime: runtimePreset({
+            console: false,
+            pluginMarket: false,
+            browserBridge: false,
+        }),
+        plugins,
+        actions,
+        ...overrides,
+    };
+}

package/dist/testing/needs.js

@@ -7,7 +7,7 @@ export const fakeNpmSource = {
 export function extensionNeedOf(name, extra = {}) {
     return {
         kind: 'extension',
-        runtime: 'opencli',
+        runtime: 'fake-runtime',
         name,
         commands: [`${name}-read`],
         purpose: '测试',

package/dist/testing.d.ts

@@ -2,3 +2,4 @@ export * from './testing/host-fakes.js';
 export * from './testing/declaration.js';
 export * from './testing/needs.js';
 export * from './testing/data.js';
+export * from './testing/fake-adapter-set.js';

package/dist/testing.js

@@ -2,3 +2,4 @@ export * from './testing/host-fakes.js';
 export * from './testing/declaration.js';
 export * from './testing/needs.js';
 export * from './testing/data.js';
+export * from './testing/fake-adapter-set.js';

package/package.json

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

package/src/api/__tests__/blocker-table.test.ts

@@ -313,3 +313,28 @@ describe('blockerOfCapability', () => {
     expect(blocker?.actions.map((action) => action.kind)).toEqual(['retry']);
   });
 });
+
+describe('执行类失败的话术由适配器给', () => {
+  it('适配器给了 diagnose.exec 就用它，不再说默认那句', () => {
+    const blocker = blockerOfError(
+      { code: 'cli-exec-failed', message: '跑不起来' },
+      t,
+      { diagnose: { exec: '确认 MCP server 起得来：npx -y chrome-devtools-mcp@latest' } },
+    );
+    expect(blocker.hint).toBe('确认 MCP server 起得来：npx -y chrome-devtools-mcp@latest');
+  });
+
+  it('适配器没给就回词表那句（opencli 那份）', () => {
+    const blocker = blockerOfError({ code: 'cli-exec-failed', message: '跑不起来' }, t);
+    expect(blocker.hint).toBe('blocker.exec.hint');
+  });
+
+  it('错误自己带的 hint 优先级最高', () => {
+    const blocker = blockerOfError(
+      { code: 'cli-exec-failed', message: '跑不起来', hint: '端口被占了' },
+      t,
+      { diagnose: { exec: '确认 MCP server 起得来' } },
+    );
+    expect(blocker.hint).toBe('端口被占了');
+  });
+});

package/src/api/{workbench-client.test.ts → __tests__/workbench-client.test.ts}

@@ -1,6 +1,6 @@
 import { afterEach, describe, expect, it, vi } from 'vitest';
-import { API_PREFIX } from '../config/constants.js';
-import { apiGet } from './workbench-client.js';
+import { API_PREFIX } from '../../config/constants.js';
+import { apiGet } from '../workbench-client.js';
 
 interface FetchRecord {
   url: string;

package/src/api/blocker-table.ts

@@ -22,7 +22,11 @@ function copyAction(t: Translate, text: string): BlockerAction {
 export function blockerOfError(
   error: ApiError | undefined,
   t: Translate,
-  context: { path?: string | null; platform?: string } = {},
+  context: {
+    path?: string | null;
+    platform?: string;
+    diagnose?: Readonly<Partial<Record<'exec' | 'login' | 'bridge', string>>>;
+  } = {},
 ): ModuleBlocker {
   if (error === undefined) {
     return {
@@ -93,7 +97,7 @@ export function blockerOfError(
         id: 'cli-exec-failed',
         severity: 'block',
         title: error.message,
-        hint: error.hint ?? t('blocker.exec.hint'),
+        hint: error.hint ?? context.diagnose?.exec ?? t('blocker.exec.hint'),
         ...(error.detail === undefined ? {} : { detail: error.detail }),
         actions: [retryAction(t)],
       };

package/src/components/SelectField.css

@@ -70,12 +70,6 @@
   justify-content: center;
 }
 
-.wb-selectReveal {
-  display: inline-flex;
-  align-items: center;
-  justify-content: center;
-}
-
 .wb-selectIconOnly .wb-selectIcon {
   width: 100%;
   height: 100%;