@dsh-workbench/shared 1.1.8 → 1.1.10

package/src/i18n/en.ts

@@ -79,7 +79,11 @@ export const en: Record<keyof WorkbenchMessages, string> = {
 
   'panels.title': 'Panel modules',
   'panels.groupBoardless': 'No-board modules',
-  'panels.groupPlugins': 'opencli plugins',
+  'panels.groupPlugins': 'Plugins',
+  'runtime.plugin': 'plugin',
+  'runtime.pluginOf': 'a plugin the runtime provides',
+  'runtime.pluginThing': 'a plugin',
+  'runtime.pluginArea': 'the plugin area',
   'panels.market.defaultHint': 'When on, it is on by default in every workspace; you can also turn it off for a single workspace in Panel setup.',
   'panels.market.defaultLabel': 'On by default everywhere',
   'panels.market.defaultLocked': 'Unusable right now — update or uninstall it first',
@@ -159,10 +163,6 @@ export const en: Record<keyof WorkbenchMessages, string> = {
   'panels.market.confirmNo': 'Cancel',
   'panels.market.noMarketSource': 'The index has no newer version of this module (refresh the index and retry)',
   'panels.market.failed': 'Failed: {reason}',
-  'panels.market.askAgent': 'Ask the agent',
-  'panels.market.askAgentCopied': 'Copied',
-  'panels.market.askAgentText':
-    'This workbench module cannot be used: "{name}" (unit {unit}) — {reason}. Work out what is missing and how to add it, then confirm it works.',
   'panels.market.failure.permission': "Didn't install: no write access",
   'panels.market.failure.diskFull': "Didn't install: the disk is full",
   'panels.market.failure.sandbox': "Didn't install: the system blocked it",
@@ -202,7 +202,7 @@ export const en: Record<keyof WorkbenchMessages, string> = {
   'panels.market.noSource': 'This module declares no install method — install it yourself',
   'panels.market.badSource': 'The install method is incomplete — install it yourself',
   'panels.market.empty': 'No modules available',
-  'panels.market.sectionPlugins': 'Installed opencli plugins',
+  'panels.market.sectionPlugins': 'Installed plugins',
   'panels.market.moduleOutdated': 'update available',
   'panels.market.updateNeedsWorkbench': 'this version needs a newer workbench first',
   'panels.market.updateIncompatible': 'the new version does not match this workbench, so it cannot be installed now',
@@ -240,7 +240,7 @@ export const en: Record<keyof WorkbenchMessages, string> = {
   'panels.market.justNow': 'just now',
   'panels.market.minutesAgo': '{n} min ago',
   'panels.market.hoursAgo': '{n} h ago',
-  "panels.market.add.description": "Enter a module or opencli plugin package name, Git repository URL, or local directory path.",
+  "panels.market.add.description": "Enter a module or {plugin} package name, Git repository URL, or local directory path.",
   'panels.market.add.specPlaceholder': 'e.g. @dsh-workbench/module-hello',
   'panels.market.add.guideToggle': 'Install guide and examples',
   'panels.market.add.guideHide': 'Hide guide',
@@ -280,13 +280,13 @@ export const en: Record<keyof WorkbenchMessages, string> = {
   'panels.market.add.problemNotFound': 'No such module found',
   'panels.market.add.problemNotPackage': 'That path does not exist or is not a valid module package',
   'panels.market.add.problemNotBundle':
-    'This package cannot be installed here: {reason}. This entry recognises workbench modules and opencli plugins by package name, and installs either; but a git URL or a tarball does not reveal what it is — if it is really one of those two, use its package name or a local folder instead.',
+    'This package cannot be installed here: {reason}. This entry recognises workbench modules and {plugin}s by package name, and installs either; but a git URL or a tarball does not reveal what it is — if it is really one of those two, use its package name or a local folder instead.',
   'panels.market.add.problemNotWorkbenchModule': 'This package does not match the workbench you are running, so installing it would not work. Pick another version, or ask the module author.',
-  'panels.market.add.problemNotModuleOrPlugin': 'This package is neither a workbench module nor an opencli plugin, so installing it would do nothing. Pick another version, or ask the package author.',
-  'panels.market.add.failureNotModuleOrPlugin': 'This package is neither a workbench module nor an opencli plugin, so installing it would do nothing',
-  'panels.market.add.installedPlugin': 'Installed: the opencli plugin {name}',
+  'panels.market.add.problemNotModuleOrPlugin': 'This package is neither a workbench module nor {pluginOf}, so installing it would do nothing. Pick another version, or ask the package author.',
+  'panels.market.add.failureNotModuleOrPlugin': 'This package is neither a workbench module nor {pluginOf}, so installing it would do nothing',
+  'panels.market.add.installedPlugin': 'Installed: {plugin} {name}',
   'panels.market.add.pluginPreview':
-    'This is an opencli plugin: it goes into the opencli plugin area and works as soon as it is installed — no restart.',
+    'This is {pluginThing}: it goes into {pluginArea} and works as soon as it is installed — no restart.',
   'panels.market.add.pluginAlias': 'Plugin name: {name}',
   'panels.market.add.problemNetwork': 'Cannot reach the module source; check the network and retry',
   'panels.market.add.problemUnknown': 'Cannot fetch module information: {reason}',
@@ -377,6 +377,7 @@ export const en: Record<keyof WorkbenchMessages, string> = {
   'panels.discover.noSourceHint': 'Add a module market index (http address or git repository) to browse and install its modules here',
   'panels.discover.sourcesFailed': 'Could not read the index sources.',
   'panels.discover.unreadable': 'Could not read this index.',
+  'panels.discover.sandbox': 'Blocked by the system: this profile does not allow the workbench to write its own cache directory.',
   'panels.discover.sourceAuth': 'This index source could not be read: this machine has no git credentials for it. Set up credentials (or switch the source to its SSH address), then refresh.',
   'panels.discover.invalid': 'This index is not in a valid format.',
   'panels.discover.emptyRepo': 'This repository has no commits yet.',
@@ -564,7 +565,7 @@ export const en: Record<keyof WorkbenchMessages, string> = {
   'blocker.forbidden.hint': 'You are signed in, but this project/repo is not permitted for your account.',
   'blocker.forbidden.open': 'Open permissions page',
   'blocker.timeout.hint': 'The background browser may not have started; retrying usually helps.',
-  'blocker.exec.hint': 'Make sure opencli is installed and runs from your terminal (which opencli).',
+  'blocker.exec.hint': 'Make sure the runtime is installed and runs from your terminal.',
   'blocker.unknown.title': 'Something went wrong',
   'panels.reading': 'Reading the panel setup…',
   'panels.cardBroken': 'This module will not render: {unit} ({reason})',
@@ -574,6 +575,7 @@ export const en: Record<keyof WorkbenchMessages, string> = {
   'env.title': 'Preparing the workbench',
   'env.checking': 'Getting the runtime ready…',
   'env.installing': 'Installing background tools — the first run takes a moment…',
+  'env.installingToolchain': 'Installing the workbench’s own npm / pnpm — the first run downloads them, so it can take a while.',
   'env.failed': 'One step away',
   'env.elapsed': 'Waiting {seconds}s',
   'env.stepFailed.install': 'install failed',
@@ -581,16 +583,11 @@ export const en: Record<keyof WorkbenchMessages, string> = {
   'env.stepFailed.shell': 'cannot reach the command line',
   'env.toolchain.ok': 'Looks good',
   'env.toolchain.warn': 'Almost ready',
-  'env.opencli.ok': 'Ready',
+  'env.runtime.ok': 'Ready',
   'env.bridge.ok': 'Connected',
   'env.bridge.short': 'Not connected yet',
   'env.bridge.why': 'Panel data uses the login state in your browser. Without this connection, modules cannot fetch data. It does not block startup: fix it, or enter the workbench first.',
   'env.bridge.hold': 'The browser is not connected yet \u2014 fix it below and hit Retry, or enter the workbench first.',
-  'env.bridge.daemon': 'The background service is not running. It usually starts by itself \u2014 run the command below in your terminal first.',
-  'env.bridge.extension': 'The browser extension is not connected. Make sure the browser is running and the extension is enabled; install it once from the store if needed (then hit Retry here).',
-  'env.bridge.extensionLink': 'Get the extension in the Chrome Web Store',
-  'env.bridge.profile': 'Several browser accounts are connected but none is the default: list them (command below), then pick one.',
-  'env.bridge.stale': 'The default browser account is stale (it names an extension instance that no longer exists): pick one again.',
   'env.bridge.unknown': 'Could not tell what went wrong. Expand the raw output and follow the steps in it.',
   'env.fix.title': 'How to fix it',
   'env.fix.why': 'The workbench uses its own background tool (installed separately from the one in your terminal), and it is not set up on this machine yet.',
@@ -619,13 +616,14 @@ export const en: Record<keyof WorkbenchMessages, string> = {
   'env.diy.continue': 'Enter the workbench anyway',
   'env.copyCommand': 'Copy command',
   'env.copied': 'Copied',
-  'env.step.toolchain': 'Runtime',
-  'env.step.opencli': 'Background tools',
-  'env.step.bridge': 'Browser connection',
-  'env.step.diy': 'DIY mode',
-  'env.step.warm': 'Site sign-in',
+  'env.step.toolchain': 'Check the environment',
+  'env.step.adapter': 'Check the runtime',
+  'env.step.runtime': 'Install background tools',
+  'env.step.bridge': 'Connect your browser',
+  'env.step.diy': 'Check DIY mode',
+  'env.step.warm': 'Reach your sites',
   'env.warm.done': 'Ready ({n} sites)',
-  'env.warm.short': 'Could not sign in early this time \u2014 nothing breaks; the first read fills it in',
+  'env.warm.short': 'Could not reach your sites early this time \u2014 nothing breaks; the first read fills it in',
   'env.unit.failed': 'This module cannot start',
   'env.unit.failedHint': 'It failed while starting up; other modules are unaffected.',
   'env.unit.unchecked': 'Cannot check: no command line',

package/src/i18n/runtime-terms.ts

@@ -0,0 +1,26 @@
+import type { Translate } from '../lib/dsh-client.js';
+import type { RuntimeText } from '../contract/capabilities.js';
+
+/**
+ * 把适配器给的 zh / en 两份文案落到当前语言。
+ * @param text 适配器档案里的那段话。
+ * @param resolve dsh 的语言解析器；没有就取中文那份。
+ * @returns 当前语言的那一段。
+ */
+export function resolveRuntimeText(text: RuntimeText, resolve?: (text: RuntimeText) => string): string {
+  return resolve === undefined ? text.zh : resolve(text);
+}
+
+/**
+ * 取当前语言的运行时术语（没给档案时的兜底）。
+ * @param t 文案函数。
+ * @returns `plugin` / `pluginOf` / `pluginThing` / `pluginArea` 四个名词短语。
+ */
+export function runtimeTermsOf(t: Translate): Readonly<Record<string, string>> {
+  return {
+    plugin: t('runtime.plugin'),
+    pluginOf: t('runtime.pluginOf'),
+    pluginThing: t('runtime.pluginThing'),
+    pluginArea: t('runtime.pluginArea'),
+  };
+}

package/src/i18n/zh.ts

@@ -78,7 +78,11 @@ export const zh = {
 
   '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': '这份现在用不了，先更新或卸载',
@@ -156,10 +160,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': '没装上：被系统拦住了',
@@ -199,7 +199,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': '新版本和当前的工作台不匹配，暂时不能更新',
@@ -237,7 +237,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': '收起引导',
@@ -277,13 +277,13 @@ export const zh = {
   'panels.market.add.problemNotFound': '未找到相关模块',
   'panels.market.add.problemNotPackage': '该路径不存在或不是有效的模块包',
   'panels.market.add.problemNotBundle':
-    '这个包装不进这里：{reason}。这个入口按包名认工作台模块和 opencli 插件，两种都能装；但 git 地址和 tarball 判断不出它是什么 —— 要是它其实是这两样之一，请改填包名或本地目录。',
+    '这个包装不进这里：{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.problemNotModuleOrPlugin': '这个包既不是工作台的模块，也不是 {pluginOf}，装了也用不上。换一个版本，或者找这个包的作者。',
+  'panels.market.add.failureNotModuleOrPlugin': '这个包既不是工作台的模块，也不是 {pluginOf}，装了也用不上',
+  'panels.market.add.installedPlugin': '装上了：{plugin} {name}',
   'panels.market.add.pluginPreview':
-    '这是一份 opencli 插件：装进 opencli 的插件区，装完就能用，不用重启。',
+    '这是一份 {pluginThing}：装进 {pluginArea}，装完就能用，不用重启。',
   'panels.market.add.pluginAlias': '插件名：{name}',
   'panels.market.add.problemNetwork': '无法连接模块源，请检查网络后重试',
   'panels.market.add.problemUnknown': '无法获取模块信息：{reason}',
@@ -374,6 +374,7 @@ export const zh = {
   'panels.discover.noSourceHint': '添加一个模块市场索引（http 地址或 git 仓库），即可在这里浏览和安装其中的模块',
   'panels.discover.sourcesFailed': '无法读取索引源',
   'panels.discover.unreadable': '无法读取此索引',
+  'panels.discover.sandbox': '被系统拦住了：这个 profile 的可写根盖不住工作台的缓存目录',
   'panels.discover.sourceAuth': '这个索引源读不了：本机没有它的 git 凭据。配好凭据（或在源里改用 SSH 地址），再点右上角的刷新。',
   'panels.discover.invalid': '此索引的格式无效',
   'panels.discover.emptyRepo': '这个仓库还没有任何提交',
@@ -560,7 +561,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}）',
@@ -570,6 +571,7 @@ export const zh = {
   'env.title': '准备工作台',
   'env.checking': '正在准备运行环境…',
   'env.installing': '正在安装后台工具，第一次会慢一点…',
+  'env.installingToolchain': '正在装工作台自己那份 npm / pnpm —— 第一次要下载，慢一点正常。',
   'env.failed': '还差一步就能用了',
   'env.elapsed': '已等待 {seconds} 秒',
   'env.stepFailed.install': '装不上',
@@ -577,16 +579,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': '工作台用它自己那份后台工具（与你在终端里那套分开装，互不影响），这台机器上还没装好它。',
@@ -615,11 +612,12 @@ export const zh = {
   'env.diy.continue': '先进入工作台',
   'env.copyCommand': '复制命令',
   'env.copied': '已复制',
-  'env.step.toolchain': '运行环境',
-  'env.step.opencli': '后台工具',
-  'env.step.bridge': '浏览器连接',
-  'env.step.diy': 'DIY 模式',
-  'env.step.warm': '站点登录状态',
+  'env.step.toolchain': '检查运行环境',
+  'env.step.adapter': '检查运行时',
+  'env.step.runtime': '安装后台工具',
+  'env.step.bridge': '连接浏览器',
+  'env.step.diy': '检查 DIY 模式',
+  'env.step.warm': '连上站点',
   'env.warm.done': '已就绪（{n} 个站点）',
   'env.warm.short': '这次没提前连上 —— 不影响用，第一次取数会自己补',
   'env.unit.failed': '这个模块起不来',

package/src/index.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/src/lib/{board-fact.test.ts → __tests__/board-fact.test.ts}

@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'vitest';
-import { boardSituation, insideWorkshop, type BoardProbe } from './board-fact.js';
+import { boardSituation, insideWorkshop, type BoardProbe } from '../board-fact.js';
 
 const WORKSHOP = '/w/workbench/diy';
 const FL0XIN = '/w/floxin-app';

package/src/lib/{busy.test.ts → __tests__/busy.test.ts}

@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'vitest';
-import { holdBusy } from './busy.js';
+import { holdBusy } from '../busy.js';
 
 describe('holdBusy', () => {
   it('这一轮忙刚开了头：还要按住，剩下的时长报出来（计时器按它收尾）', () => {

package/src/lib/{form-problem.test.ts → __tests__/form-problem.test.ts}

@@ -1,5 +1,5 @@
 import { describe, expect, it, vi } from 'vitest';
-import { firstProblemOf, revealFirstProblem } from './form-problem.js';
+import { firstProblemOf, revealFirstProblem } from '../form-problem.js';
 
 function rootWith(problem: unknown): { readonly root: ParentNode; readonly queries: string[] } {
   const queries: string[] = [];

package/src/lib/{git-address.test.ts → __tests__/git-address.test.ts}

@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'vitest';
-import { gitAddressOf, gitAddressText, gitTransportCandidates } from './git-address.js';
+import { gitAddressOf, gitAddressText, gitTransportCandidates } from '../git-address.js';
 
 describe('git 地址的两种读法', () => {
   it('https 原样留着，另一条推成 ssh://', () => {

package/src/lib/{react.test.ts → __tests__/react.test.ts}

@@ -1,6 +1,6 @@
 import * as React from 'react';
 import { describe, expect, it } from 'vitest';
-import { Fragment, h, useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState } from './react.js';
+import { Fragment, h, useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState } from '../react.js';
 
 describe('react 入口', () => {
   it('h 就是 React.createElement（同一个引用，不是包装）', () => {

package/src/lib/{text.test.ts → __tests__/text.test.ts}

@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'vitest';
-import { excerpt, parseJsonLoose } from './text.js';
+import { excerpt, parseJsonLoose } from '../text.js';
 
 describe('parseJsonLoose', () => {
   it('干净 JSON 直接解析', () => {

package/src/lib/{ui.test.ts → __tests__/ui.test.ts}

@@ -9,7 +9,7 @@ import {
   relativeTimeCompact,
   shortenPath,
   type TimeTranslate,
-} from './ui.js';
+} from '../ui.js';
 
 const t: TimeTranslate = (key, params) => {
   if (params === undefined) return key;

package/src/testing/__tests__/fake-adapter-set.test.ts

@@ -0,0 +1,28 @@
+import { describe, expect, it } from 'vitest';
+import { adapterContractGaps } from '../../host/adapter-contract.js';
+import { fakeAdapterSet } from '../fake-adapter-set.js';
+
+const ctx = { get: () => undefined } as never;
+
+describe('假集合：证明协议是闭合的', () => {
+  it('一个最小的外来实现（不含任何具体运行时）也能过整份契约', () => {
+    expect(adapterContractGaps(fakeAdapterSet(), ctx)).toEqual([]);
+  });
+
+  it('它声明的能力全是 false —— 外壳不该能从它身上猜到任何具体运行时', () => {
+    expect(fakeAdapterSet().runtime.capabilities(ctx)).toEqual({
+      console: false,
+      pluginMarket: false,
+      browserBridge: false,
+    });
+  });
+
+  it('覆盖项能替换任意成员（测试就地造场景）', () => {
+    const set = fakeAdapterSet({ runtime: { ...fakeAdapterSet().runtime, capabilities: () => ({
+      console: true,
+      pluginMarket: false,
+      browserBridge: false,
+    }) } });
+    expect(set.runtime.capabilities(ctx).console).toBe(true);
+  });
+});

package/src/testing/fake-adapter-set.ts

@@ -0,0 +1,173 @@
+import type { DataReader, DataRequest, DataResult, RecipeCalls, RecipeResults, RequestRecipe } from '../contract/data.js';
+import type { AdapterSet } from '../host/adapters.js';
+import type { EnvSupplyPort, ModulePort, ProbePort, ProfilePort, RuntimePort, SupplyPort } from '../host/port-types.js';
+import type { HostActions } from '../host/port-types.js';
+import type { PluginSurface } from '../host/port-types.js';
+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' } as const;
+
+function result<T>(): DataResult<T> {
+  return { ok: true, data: FAKE_ADAPTER_MARKER as unknown as T };
+}
+
+const data: DataReader = {
+  async read<T = unknown>(_request: DataRequest): Promise<DataResult<T>> {
+    return result<T>();
+  },
+  async request<T = unknown>(_recipe: RequestRecipe): Promise<DataResult<T>> {
+    return result<T>();
+  },
+  async requestMany<T = unknown>(_recipe: RequestRecipe, _calls: RecipeCalls): Promise<RecipeResults<T>> {
+    return {};
+  },
+  async submit<T = unknown>(_recipe: RequestRecipe): Promise<DataResult<T>> {
+    return result<T>();
+  },
+};
+
+const supply: EnvSupplyPort = {
+  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: ModulePort = {
+  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: () => ({}) as never,
+  declarationGaps,
+  moduleDeclarationOf,
+  registryDeclarationOf: async () => undefined,
+  pathDeclarationOf,
+  declarationRefusalOf,
+  refusalReason,
+  packageRouteOf: async () => undefined,
+  isNewerVersion,
+  startSelfUpdate: () => ({}) as never,
+};
+
+const profile: ProfilePort = {
+  dirOf: () => null,
+  dshPlugins: () => () => ({ ok: true, plugins: [] }),
+  selfUpdateView: () => undefined,
+};
+
+const probe: ProbePort = {
+  probeUnits: async () => [],
+  registerPreflight: () => undefined,
+  declaredPluginCommands: () => new Map(),
+};
+
+const runtimePreset = (capabilities: RuntimePort['capabilities'] extends never ? never : ReturnType<RuntimePort['capabilities']>): RuntimePort => ({
+  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: string, command?: string) => (command === undefined ? `fake ${site}` : `fake ${site} ${command}`),
+    help: (site: string) => `fake ${site} --help`,
+    browser: (verb: readonly string[]) => `fake browser ${verb.join(' ')}`,
+  }),
+  commands: () => ({}),
+  runners: () => ({}),
+  health: () => ({}),
+  seed: () => undefined,
+  warnUnwritableRoot: () => undefined,
+});
+
+const plugins: PluginSurface = {
+  declarationLookup: () => () => undefined,
+  createUnits: () => ({
+    refresh: async () => ({ units: [] }),
+    touch: () => undefined,
+    report: () => ({ units: [] }),
+    dispose: () => undefined,
+  }),
+};
+
+const actions: HostActions = {
+  configSyncHandler: () => (async () => ({ ok: true })) as never,
+  profileCreateHandler: () => (async () => ({ ok: true })) as never,
+  configSyncAction: () => ({}) as never,
+  profileCreateAction: () => ({}) as never,
+};
+
+export function fakeAdapterSet(overrides: Partial<AdapterSet> = {}): AdapterSet {
+  const release = createReleaseProbe();
+  const registry = createRegistryLookup();
+  const router = createPackageRouter({ manifestFile: 'fake-plugin.json', dshLookup: registry.registryDshOf });
+  const withRelease: EnvSupplyPort = {
+    ...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,
+    } as SupplyPort,
+    modules,
+    profile,
+    probe,
+    runtime: runtimePreset({
+      console: false,
+      pluginMarket: false,
+      browserBridge: false,
+    }),
+    plugins,
+    actions,
+    ...overrides,
+  };
+}

package/src/testing/needs.ts

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

package/src/testing.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/src/host/__tests__/command-name.test.ts

@@ -1,16 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { commandNamesMatch } from '../command-name.js';
-
-describe('commandNamesMatch：声明的命令名与解析出来的命令路径', () => {
-  it('缺省 opencli 不管写成名字还是绝对路径都算同一个', () => {
-    expect(commandNamesMatch('opencli', '/Users/me/.dsh/workbench/opencli/bin/opencli')).toBe(true);
-    expect(commandNamesMatch('opencli.cmd', 'C:\\dsh\\opencli.cmd')).toBe(true);
-    expect(commandNamesMatch('opencli.exe', 'C:\\dsh\\opencli.exe')).toBe(true);
-    expect(commandNamesMatch('gitops', '/usr/local/bin/gitops')).toBe(true);
-  });
-
-  it('不同的命令不算同一个', () => {
-    expect(commandNamesMatch('gitops', '/usr/local/bin/opencli')).toBe(false);
-    expect(commandNamesMatch('', 'opencli')).toBe(false);
-  });
-});