@dsh-workbench/shared 1.1.8 → 1.1.9

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}',
@@ -560,7 +560,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}）',
@@ -577,16 +577,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': '工作台用它自己那份后台工具（与你在终端里那套分开装，互不影响），这台机器上还没装好它。',
@@ -616,7 +611,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': '站点登录状态',

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);
-  });
-});

package/src/host/__tests__/opencli-runner.test.ts

@@ -1,120 +0,0 @@
-import { describe, expect, it, vi } from 'vitest';
-import type { DataRequest, DataResult } from '../../contract/data.js';
-import { opencliRunnerOf } from '../opencli-runner.js';
-
-type Read = (request: DataRequest) => Promise<DataResult<unknown>>;
-
-function readerOf(result: DataResult<unknown>): {
-  readonly read: Read;
-  readonly spy: ReturnType<typeof vi.fn>;
-} {
-  const spy = vi.fn(async (_request: DataRequest) => result);
-  return { read: spy as unknown as Read, spy };
-}
-
-describe('opencliRunnerOf', () => {
-  it('把 argv 原样交给读缝，解析后的值序列化回 stdout', async () => {
-    const { read, spy } = readerOf({ ok: true, data: [{ name: 'lsznh' }] });
-    const runner = opencliRunnerOf(read);
-
-    await expect(
-      runner(['argocd', 'application-resource-tree', '--name', 'lsznh']),
-    ).resolves.toEqual({ stdout: JSON.stringify([{ name: 'lsznh' }]) });
-    expect(spy).toHaveBeenCalledWith({
-      kind: 'command',
-      adapter: 'opencli',
-      argv: ['argocd', 'application-resource-tree', '--name', 'lsznh'],
-    });
-  });
-
-  it('timeoutMs 透传给读缝；不传就不出现这一格', async () => {
-    const withTimeout = readerOf({ ok: true, data: [] });
-    await opencliRunnerOf(withTimeout.read, { timeoutMs: 1_800_000 })([
-      'coding',
-      'ci-status',
-    ]);
-    expect(withTimeout.spy).toHaveBeenCalledWith(
-      expect.objectContaining({ timeoutMs: 1_800_000 }),
-    );
-
-    const withoutTimeout = readerOf({ ok: true, data: [] });
-    await opencliRunnerOf(withoutTimeout.read)(['coding', 'ci-status']);
-    expect(withoutTimeout.spy).toHaveBeenCalledWith(
-      expect.not.objectContaining({ timeoutMs: expect.anything() }),
-    );
-  });
-
-  it('未登录还原成 opencli 的约定：退出码 77 + AUTH_REQUIRED + 登录地址', async () => {
-    const { read } = readerOf({
-      ok: false,
-      error: {
-        code: 'auth',
-        pageCode: 'auth-required',
-        message: 'Coding 未登录',
-        helpUrl: 'https://baiguokeji.coding.net/login',
-      },
-    });
-
-    const failure = await opencliRunnerOf(read)(['coding', 'ci-status']).then(
-      () => null,
-      (error: unknown) => error as Error & { code?: number },
-    );
-
-    expect(failure).toBeInstanceOf(Error);
-    expect(failure?.code).toBe(77);
-    expect(failure?.message).toBe(
-      [
-        'Command failed: opencli coding ci-status',
-        'code: AUTH_REQUIRED',
-        'message: Coding 未登录',
-        'help: Please open Chrome or Chromium and log in to https://baiguokeji.coding.net/login',
-      ].join('\n'),
-    );
-  });
-
-  it('其它失败保留 Command failed 外壳与原因 / 细节 / 下一步', async () => {
-    const { read } = readerOf({
-      ok: false,
-      error: {
-        code: 'command',
-        pageCode: 'cli-command-failed',
-        message: 'UNKNOWN：插件里没有这条命令',
-        detail: 'error: unknown command',
-        hint: '升级插件后重试',
-      },
-    });
-
-    const failure = await opencliRunnerOf(read)([
-      'argocd',
-      'application-resource-tree',
-    ]).then(
-      () => null,
-      (error: unknown) => error as Error,
-    );
-
-    expect(failure?.message).toBe(
-      [
-        'Command failed: opencli argocd application-resource-tree',
-        'UNKNOWN：插件里没有这条命令',
-        'error: unknown command',
-        '升级插件后重试',
-      ].join('\n'),
-    );
-  });
-
-  it('没有原因时也有一句能看懂的兜底', async () => {
-    const { read } = readerOf({
-      ok: false,
-      error: { code: 'command', message: '' },
-    });
-
-    const failure = await opencliRunnerOf(read)(['cmdb', 'publish']).then(
-      () => null,
-      (error: unknown) => error as Error,
-    );
-
-    expect(failure?.message).toBe(
-      'Command failed: opencli cmdb publish\nopencli 这条命令没跑通',
-    );
-  });
-});

package/src/host/channel-plugin.ts

@@ -1,55 +0,0 @@
-import { existsSync, readFileSync } from 'node:fs';
-import { join } from 'node:path';
-import { isolatedHome, toolchainOpencliDir, vendorPeerLink, vendorPluginsDir } from './paths.js';
-import { quoteShellArg } from './shell-text.js';
-
-export const CHANNEL_PLUGIN_NAME = 'opencli-plugin-workbench';
-export const CHANNEL_PLUGIN_SITE = 'workbench';
-
-export interface ChannelPluginPlan {
-  readonly dest: string;
-  readonly version: string;
-  readonly commands: readonly string[];
-  readonly line: string;
-}
-
-function textOf(value: unknown): string {
-  return typeof value === 'string' ? value.trim() : '';
-}
-
-export function channelVersionOf(dir: string): string | undefined {
-  try {
-    const parsed: unknown = JSON.parse(readFileSync(join(dir, 'opencli-plugin.json'), 'utf8'));
-    if (typeof parsed !== 'object' || parsed === null) return undefined;
-    const version = textOf((parsed as Record<string, unknown>)['version']);
-    return version === '' ? undefined : version;
-  } catch {
-    return undefined;
-  }
-}
-
-export function channelPluginPlan(options: {
-  readonly channelDir: string;
-  readonly command?: string;
-}): ChannelPluginPlan | undefined {
-  const version = channelVersionOf(options.channelDir);
-  if (version === undefined) return undefined;
-  const command = options.command ?? 'opencli';
-  const dest = join(vendorPluginsDir(), CHANNEL_PLUGIN_NAME);
-  const peer = vendorPeerLink();
-  const commands = [
-    `rm -rf ${quoteShellArg(dest)} && mkdir -p ${quoteShellArg(dest)} && cp -R ${quoteShellArg(options.channelDir)}/. ${quoteShellArg(dest)}/`,
-    `rm -rf ${quoteShellArg(peer.dir)} && mkdir -p ${quoteShellArg(peer.parent)} && ln -s ${quoteShellArg(toolchainOpencliDir())} ${quoteShellArg(peer.dir)}`,
-    `(${quoteShellArg(command)} plugin uninstall ${quoteShellArg(CHANNEL_PLUGIN_SITE)} || true)`,
-    `${quoteShellArg(command)} plugin install ${quoteShellArg(dest)}`,
-  ];
-  return { dest, version, commands, line: commands.join(' && ') };
-}
-
-export function channelInstalledVersion(): string | undefined {
-  return channelVersionOf(join(vendorPluginsDir(), CHANNEL_PLUGIN_NAME));
-}
-
-export function channelSiteInstalled(): boolean {
-  return existsSync(join(isolatedHome(), '.opencli', 'plugins', CHANNEL_PLUGIN_SITE));
-}

package/src/host/command-name.ts

@@ -1,15 +0,0 @@
-function baseName(value: string): string {
-  const parts = value.trim().split(/[\\/]/);
-  return parts[parts.length - 1] ?? '';
-}
-
-function isOpencli(name: string): boolean {
-  return name === 'opencli' || name === 'opencli.cmd' || name === 'opencli.exe';
-}
-
-export function commandNamesMatch(declared: string, resolved: string): boolean {
-  const left = baseName(declared);
-  const right = baseName(resolved);
-  if (left === '' || right === '') return false;
-  return left === right || (isOpencli(left) && isOpencli(right));
-}