@ljwei-stak/dsh-model-router 0.16.4 → 0.17.1

package/.dsh-plugin/shared/official-tool-registry.mjs

@@ -1,16 +1,77 @@
 /**
  * Fixed registry of official model CLI tools, shared by the Host runtime
- * (probe + install) and the Desktop panel (display). Pure data: no Node or
- * browser APIs, so both sides and the test suite import it unchanged.
+ * (probe + install + uninstall + repair) and the Desktop panel (display).
+ * Pure data: no Node or browser APIs, so both sides and the test suite import
+ * it unchanged.
  *
  * The registry is fail-closed by design: installer sources are fixed (the
- * official npm registry, the vendor's signed installer) and clients can only
- * name a registry id — never an arbitrary package or command. Versions are not
- * pinned: installs take each vendor's latest release (`@latest`), and the
- * executor trusts entries by publisher signature or registry-attested digest
- * rather than by version.
+ * official npm registry, the vendor's published installer script) and clients
+ * can only name a registry id and one of that tool's declared install methods
+ * — never an arbitrary package, URL or command. Versions are not pinned:
+ * installs take each vendor's latest release (`@latest`, the vendor script's
+ * own `latest`), and the executor trusts entries by publisher signature or
+ * registry-attested digest rather than by version.
+ *
+ * Every tool declares `installMethods`: the complete, closed list of ways this
+ * plugin may obtain the tool. `manager` / `installArgs` / `uninstallArgs` on the
+ * tool itself stay the default (first) method, so existing callers and tests
+ * keep working. Script methods are never piped straight into an interpreter:
+ * the runtime downloads the vendor script, checks it still is that script, and
+ * runs the staged copy (same pattern as the MiniMax Windows installer).
  */
 
+/** npm registry every fixed npm method installs from unless the user overrides it. */
+export const DEFAULT_NPM_REGISTRY = 'https://registry.npmjs.org/'
+
+/** Shared shape of a "package manager" method: argv only, no script staging. */
+function packageManagerMethod(id, label, manager, spec, { registryFlag = '--registry=' } = {}) {
+  return Object.freeze({
+    id,
+    label,
+    kind: 'package-manager',
+    manager,
+    spec,
+    registryFlag,
+    installArgs: Object.freeze(['install', '-g', spec]),
+    uninstallArgs: Object.freeze(['uninstall', '-g', spec.replace(/@latest$/, '')]),
+    /** npm/pnpm both accept --prefix to place a global install off the default. */
+    supportsInstallDir: true,
+    supportsRegistry: true,
+  })
+}
+
+/**
+ * Vendor installer script run from a verified local copy.
+ * A directory is passed either as `installArg` (`--install-dir`) or as
+ * `installDirEnv` (`MCODE_INSTALL_DIR`, `CODEX_INSTALL_DIR`, …). Scripts that
+ * hardcode their own path set neither and `supportsInstallDir` stays false.
+ */
+function scriptMethod(id, label, {
+  shell, scriptUrl, verify, installArg = [], env = [], platforms,
+  installDirEnv = '', defaultInstallDir = '',
+}) {
+  return Object.freeze({
+    id,
+    label,
+    kind: 'script',
+    shell,
+    scriptUrl,
+    verify,
+    /** Passed after the staged script path; empty means the script takes no argument. */
+    installArgs: Object.freeze(installArg),
+    /** Environment the vendor script itself documents for this install. */
+    env: Object.freeze(env),
+    /** When set, the configured directory is this environment variable, not an argv flag. */
+    installDirEnv,
+    /** Home-relative directory the vendor uses when the user sets none. Slashes only. */
+    defaultInstallDir,
+    platforms: Object.freeze(platforms),
+    /** Whether the vendor script honours a caller-chosen directory at all. */
+    supportsInstallDir: Boolean(installDirEnv) || installArg.length > 0,
+    supportsRegistry: false,
+  })
+}
+
 export const OFFICIAL_TOOLS = Object.freeze([
   Object.freeze({
     id: 'kimi-code',
@@ -20,9 +81,41 @@ export const OFFICIAL_TOOLS = Object.freeze([
     package: '@moonshot-ai/kimi-code',
     manager: 'npm',
     installArgs: ['install', '-g', '@moonshot-ai/kimi-code@latest', '--registry=https://registry.npmjs.org/'],
+    uninstallArgs: ['uninstall', '-g', '@moonshot-ai/kimi-code'],
     probeExecutables: ['kimi'],
     probeNote: 'kimi 与旧 Python 版 kimi-cli 同名；请核对可执行文件来源和版本。',
     providerHints: ['moonshot', 'kimi'],
+    scriptBinaryNames: Object.freeze(['kimi', 'kimi.exe']),
+    scriptBinaryRelatives: Object.freeze(['bin/kimi', 'bin/kimi.exe']),
+    defaultScriptInstallDir: '.kimi-code',
+    installMethods: Object.freeze([
+      packageManagerMethod('npm', 'npm', 'npm', '@moonshot-ai/kimi-code@latest'),
+      packageManagerMethod('pnpm', 'pnpm', 'pnpm', '@moonshot-ai/kimi-code@latest'),
+      scriptMethod('script-bash', 'curl | bash', {
+        shell: 'bash',
+        scriptUrl: 'https://code.kimi.com/kimi-code/install.sh',
+        platforms: ['linux', 'darwin'],
+        installDirEnv: 'KIMI_INSTALL_DIR',
+        defaultInstallDir: '.kimi-code',
+        env: ['KIMI_INSTALL_DIR'],
+        verify: Object.freeze({
+          mustInclude: ['code.kimi.com/kimi-code', 'KIMI_INSTALL_DIR'],
+          mustNotInclude: ['downloads.claude.ai/claude-code-releases', '@minimax-ai/code'],
+        }),
+      }),
+      scriptMethod('script-powershell', 'irm | iex', {
+        shell: 'powershell',
+        scriptUrl: 'https://code.kimi.com/kimi-code/install.ps1',
+        platforms: ['win32'],
+        installDirEnv: 'KIMI_INSTALL_DIR',
+        defaultInstallDir: '.kimi-code',
+        env: ['KIMI_INSTALL_DIR'],
+        verify: Object.freeze({
+          mustInclude: ['code.kimi.com/kimi-code', 'KIMI_INSTALL_DIR'],
+          mustNotInclude: ['downloads.claude.ai/claude-code-releases', '@minimax-ai/code'],
+        }),
+      }),
+    ]),
   }),
   Object.freeze({
     id: 'claude-code',
@@ -32,8 +125,36 @@ export const OFFICIAL_TOOLS = Object.freeze([
     package: '@anthropic-ai/claude-code',
     manager: 'npm',
     installArgs: ['install', '-g', '@anthropic-ai/claude-code@latest', '--registry=https://registry.npmjs.org/'],
+    uninstallArgs: ['uninstall', '-g', '@anthropic-ai/claude-code'],
     probeExecutables: ['claude'],
     providerHints: ['anthropic', 'claude'],
+    // The native installer always lands in ~/.local/bin; it has no directory flag.
+    scriptBinaryNames: Object.freeze(['claude', 'claude.exe']),
+    defaultScriptInstallDir: '.local/bin',
+    installMethods: Object.freeze([
+      packageManagerMethod('npm', 'npm', 'npm', '@anthropic-ai/claude-code@latest'),
+      packageManagerMethod('pnpm', 'pnpm', 'pnpm', '@anthropic-ai/claude-code@latest'),
+      scriptMethod('script-bash', 'curl | bash', {
+        shell: 'bash',
+        scriptUrl: 'https://claude.ai/install.sh',
+        platforms: ['linux', 'darwin'],
+        defaultInstallDir: '.local/bin',
+        verify: Object.freeze({
+          mustInclude: ['downloads.claude.ai/claude-code-releases', 'claude.ai/install.sh'],
+          mustNotInclude: ['@minimax-ai/code', 'releases.openai.com/codex'],
+        }),
+      }),
+      scriptMethod('script-powershell', 'irm | iex', {
+        shell: 'powershell',
+        scriptUrl: 'https://claude.ai/install.ps1',
+        platforms: ['win32'],
+        defaultInstallDir: '.local/bin',
+        verify: Object.freeze({
+          mustInclude: ['downloads.claude.ai/claude-code-releases'],
+          mustNotInclude: ['@minimax-ai/code', 'releases.openai.com/codex'],
+        }),
+      }),
+    ]),
   }),
   Object.freeze({
     id: 'codex',
@@ -41,11 +162,42 @@ export const OFFICIAL_TOOLS = Object.freeze([
     vendor: 'OpenAI',
     purpose: 'OpenAI 官方编程 CLI，提供 codex 命令。',
     package: '@openai/codex',
-    installArgs: ['install', '-g', '@openai/codex@latest', '--registry=https://registry.npmjs.org/'],
     manager: 'npm',
+    installArgs: ['install', '-g', '@openai/codex@latest', '--registry=https://registry.npmjs.org/'],
+    uninstallArgs: ['uninstall', '-g', '@openai/codex'],
     probeExecutables: ['codex'],
     probeNote: 'Codex 版本横幅由适配层宽匹配；安装时取 npm 最新版。',
     providerHints: ['openai', 'gpt', 'codex'],
+    scriptBinaryNames: Object.freeze(['codex', 'codex.exe']),
+    installMethods: Object.freeze([
+      packageManagerMethod('npm', 'npm', 'npm', '@openai/codex@latest'),
+      packageManagerMethod('pnpm', 'pnpm', 'pnpm', '@openai/codex@latest'),
+      scriptMethod('script-bash', 'curl | bash', {
+        shell: 'bash',
+        scriptUrl: 'https://chatgpt.com/codex/install.sh',
+        platforms: ['linux', 'darwin'],
+        installDirEnv: 'CODEX_INSTALL_DIR',
+        defaultInstallDir: '.local/bin',
+        env: ['CODEX_INSTALL_DIR'],
+        verify: Object.freeze({
+          mustInclude: ['releases.openai.com/codex', 'CODEX_INSTALL_DIR'],
+          mustNotInclude: ['downloads.claude.ai/claude-code-releases', '@minimax-ai/code'],
+        }),
+      }),
+      scriptMethod('script-powershell', 'irm | iex', {
+        shell: 'powershell',
+        scriptUrl: 'https://chatgpt.com/codex/install.ps1',
+        platforms: ['win32'],
+        installDirEnv: 'CODEX_INSTALL_DIR',
+        // %LOCALAPPDATA%\Programs\OpenAI\Codex\bin under a normal user profile.
+        defaultInstallDir: 'AppData/Local/Programs/OpenAI/Codex/bin',
+        env: ['CODEX_INSTALL_DIR'],
+        verify: Object.freeze({
+          mustInclude: ['releases.openai.com/codex', 'CODEX_INSTALL_DIR'],
+          mustNotInclude: ['downloads.claude.ai/claude-code-releases', '@minimax-ai/code'],
+        }),
+      }),
+    ]),
   }),
   Object.freeze({
     id: 'minimax-code',
@@ -55,8 +207,46 @@ export const OFFICIAL_TOOLS = Object.freeze([
     package: '@minimax-ai/code',
     manager: 'npm',
     installArgs: ['install', '-g', '@minimax-ai/code@latest', '--registry=https://registry.npmjs.org/', '--ignore-scripts=false', '--include=optional', '--allow-scripts=@minimax-ai/code,better-sqlite3'],
+    uninstallArgs: ['uninstall', '-g', '@minimax-ai/code'],
     probeExecutables: ['mcode'],
     providerHints: ['minimax'],
+    scriptBinaryNames: Object.freeze([
+      'mcode', 'mcode.exe', 'mcode.cmd', 'mcode.ps1',
+      'mcode-tools', 'mcode-tools.cmd', 'mcode-tools.ps1',
+    ]),
+    scriptBinaryRelatives: Object.freeze([
+      'mcode.cmd', 'mcode.ps1', 'mcode-tools.cmd', 'mcode-tools.ps1',
+      'bin/mcode', 'bin/mcode-tools',
+    ]),
+    defaultScriptInstallDir: '.minimax-code',
+    installMethods: Object.freeze([
+      packageManagerMethod('npm', 'npm', 'npm', '@minimax-ai/code@latest'),
+      packageManagerMethod('pnpm', 'pnpm', 'pnpm', '@minimax-ai/code@latest'),
+      scriptMethod('script-bash', 'curl | bash', {
+        shell: 'bash',
+        scriptUrl: 'https://filecdn.minimax.chat/public/install.sh',
+        platforms: ['linux', 'darwin'],
+        installDirEnv: 'MCODE_INSTALL_DIR',
+        defaultInstallDir: '.minimax-code',
+        env: ['MCODE_INSTALL_DIR', 'MCODE_NPM_REGISTRY'],
+        verify: Object.freeze({
+          mustInclude: ['@minimax-ai/code', 'MCODE_INSTALL_DIR', 'MiniMax Code'],
+          mustNotInclude: ['downloads.claude.ai/claude-code-releases', 'releases.openai.com/codex'],
+        }),
+      }),
+      scriptMethod('script-powershell', 'irm | iex', {
+        shell: 'powershell',
+        scriptUrl: 'https://filecdn.minimax.chat/public/install.ps1',
+        platforms: ['win32'],
+        installDirEnv: 'MCODE_INSTALL_DIR',
+        defaultInstallDir: '.minimax-code',
+        env: ['MCODE_INSTALL_DIR', 'MCODE_NPM_REGISTRY'],
+        verify: Object.freeze({
+          mustInclude: ['@minimax-ai/code', 'MCODE_INSTALL_DIR', 'MiniMax Code'],
+          mustNotInclude: ['downloads.claude.ai/claude-code-releases', 'releases.openai.com/codex'],
+        }),
+      }),
+    ]),
   }),
   Object.freeze({
     id: 'mimo-code',
@@ -66,8 +256,38 @@ export const OFFICIAL_TOOLS = Object.freeze([
     package: '@mimo-ai/cli',
     manager: 'npm',
     installArgs: ['install', '-g', '@mimo-ai/cli@latest', '--registry=https://registry.npmjs.org/'],
+    uninstallArgs: ['uninstall', '-g', '@mimo-ai/cli'],
     probeExecutables: ['mimo'],
     providerHints: ['mimo', 'xiaomi'],
+    scriptBinaryNames: Object.freeze(['mimo', 'mimo.exe']),
+    defaultScriptInstallDir: '.mimocode/bin',
+    installMethods: Object.freeze([
+      packageManagerMethod('npm', 'npm', 'npm', '@mimo-ai/cli@latest'),
+      packageManagerMethod('pnpm', 'pnpm', 'pnpm', '@mimo-ai/cli@latest'),
+      // The Unix script hardcodes ~/.mimocode/bin and ignores MIMOCODE_INSTALL_DIR.
+      scriptMethod('script-bash', 'curl | bash', {
+        shell: 'bash',
+        scriptUrl: 'https://mimo.xiaomi.com/install',
+        platforms: ['linux', 'darwin'],
+        defaultInstallDir: '.mimocode/bin',
+        verify: Object.freeze({
+          mustInclude: ['MiMoCode', 'mimo.xiaomi.com'],
+          mustNotInclude: ['@minimax-ai/code', 'downloads.claude.ai/claude-code-releases'],
+        }),
+      }),
+      scriptMethod('script-powershell', 'irm | iex', {
+        shell: 'powershell',
+        scriptUrl: 'https://mimo.xiaomi.com/install.ps1',
+        platforms: ['win32'],
+        installDirEnv: 'MIMOCODE_INSTALL_DIR',
+        defaultInstallDir: '.mimocode/bin',
+        env: ['MIMOCODE_INSTALL_DIR'],
+        verify: Object.freeze({
+          mustInclude: ['MiMoCode', 'mimo.xiaomi.com', 'MIMOCODE_INSTALL_DIR'],
+          mustNotInclude: ['@minimax-ai/code', 'downloads.claude.ai/claude-code-releases'],
+        }),
+      }),
+    ]),
   }),
   Object.freeze({
     id: 'grok-build',
@@ -77,8 +297,39 @@ export const OFFICIAL_TOOLS = Object.freeze([
     package: '@xai-official/grok',
     manager: 'npm',
     installArgs: ['install', '-g', '@xai-official/grok@latest', '--registry=https://registry.npmjs.org/'],
+    uninstallArgs: ['uninstall', '-g', '@xai-official/grok'],
     probeExecutables: ['grok'],
     providerHints: ['xai', 'grok'],
+    scriptBinaryNames: Object.freeze(['grok', 'grok.exe', 'agent', 'agent.exe']),
+    defaultScriptInstallDir: '.grok/bin',
+    installMethods: Object.freeze([
+      packageManagerMethod('npm', 'npm', 'npm', '@xai-official/grok@latest'),
+      packageManagerMethod('pnpm', 'pnpm', 'pnpm', '@xai-official/grok@latest'),
+      scriptMethod('script-bash', 'curl | bash', {
+        shell: 'bash',
+        scriptUrl: 'https://x.ai/cli/install.sh',
+        platforms: ['linux', 'darwin'],
+        installDirEnv: 'GROK_BIN_DIR',
+        defaultInstallDir: '.grok/bin',
+        env: ['GROK_BIN_DIR'],
+        verify: Object.freeze({
+          mustInclude: ['x.ai/cli', 'GROK_BIN_DIR'],
+          mustNotInclude: ['@minimax-ai/code', 'downloads.claude.ai/claude-code-releases'],
+        }),
+      }),
+      scriptMethod('script-powershell', 'irm | iex', {
+        shell: 'powershell',
+        scriptUrl: 'https://x.ai/cli/install.ps1',
+        platforms: ['win32'],
+        installDirEnv: 'GROK_BIN_DIR',
+        defaultInstallDir: '.grok/bin',
+        env: ['GROK_BIN_DIR'],
+        verify: Object.freeze({
+          mustInclude: ['x.ai/cli', 'GROK_BIN_DIR'],
+          mustNotInclude: ['@minimax-ai/code', 'downloads.claude.ai/claude-code-releases'],
+        }),
+      }),
+    ]),
   }),
   Object.freeze({
     id: 'gemini',
@@ -88,11 +339,91 @@ export const OFFICIAL_TOOLS = Object.freeze([
     package: '@google/gemini-cli',
     manager: 'npm',
     installArgs: ['install', '-g', '@google/gemini-cli@latest', '--registry=https://registry.npmjs.org/'],
+    uninstallArgs: ['uninstall', '-g', '@google/gemini-cli'],
     probeExecutables: ['gemini'],
     providerHints: ['gemini', 'google'],
     // Headless runs go through the task adapter. The signed sandbox runner does
     // not launch this CLI; a missing or failed process falls back to the API.
     headlessAdapter: true,
+    installMethods: Object.freeze([
+      packageManagerMethod('npm', 'npm', 'npm', '@google/gemini-cli@latest'),
+      packageManagerMethod('pnpm', 'pnpm', 'pnpm', '@google/gemini-cli@latest'),
+    ]),
+  }),
+  Object.freeze({
+    id: 'opencode',
+    label: 'OpenCode',
+    vendor: 'anomalyco / SST',
+    purpose: '开源终端编程代理，提供 opencode 命令；可用 npm/pnpm 或官方安装脚本获取。',
+    package: 'opencode-ai',
+    manager: 'npm',
+    installArgs: ['install', '-g', 'opencode-ai@latest', '--registry=https://registry.npmjs.org/'],
+    uninstallArgs: ['uninstall', '-g', 'opencode-ai'],
+    probeExecutables: ['opencode'],
+    probeNote: 'opencode 命令由 npm 全局包或官方脚本安装的二进制提供；脚本安装固定落在 ~/.opencode/bin。',
+    providerHints: ['opencode', 'anomalyco'],
+    /** File an uninstall may delete, when the copy came from a script install. */
+    scriptBinaryNames: Object.freeze(['opencode', 'opencode.exe']),
+    /** Where the vendor script puts the binary when the user sets no directory. */
+    defaultScriptInstallDir: '.opencode/bin',
+    installMethods: Object.freeze([
+      packageManagerMethod('npm', 'npm', 'npm', 'opencode-ai@latest'),
+      packageManagerMethod('pnpm', 'pnpm', 'pnpm', 'opencode-ai@latest'),
+      // The published script hardcodes $HOME/.opencode/bin, so it cannot honour
+      // a custom install directory; the npm/pnpm methods above can.
+      scriptMethod('script-bash', 'curl | bash', {
+        shell: 'bash',
+        scriptUrl: 'https://opencode.ai/install',
+        platforms: ['linux', 'darwin'],
+        defaultInstallDir: '.opencode/bin',
+        verify: Object.freeze({
+          mustInclude: ['anomalyco/opencode', 'opencode.ai'],
+          mustNotInclude: ['static-openapi.stepfun.com'],
+        }),
+      }),
+    ]),
+  }),
+  Object.freeze({
+    id: 'stepcode',
+    label: 'Step Code',
+    vendor: 'StepFun 阶跃星辰',
+    purpose: '阶跃星辰开源终端编程代理，提供 step 命令；官方只发布安装脚本，没有 npm 包。',
+    manager: 'script-installer',
+    installArgs: [],
+    uninstallArgs: [],
+    probeExecutables: ['step'],
+    probeNote: 'step 命令来自阶跃官方安装脚本，校验和写入 ~/.stepcode；配置与凭据同在该目录，卸载只删除可执行文件。',
+    providerHints: ['stepfun', 'stepcode'],
+    scriptBinaryNames: Object.freeze(['step', 'step.exe']),
+    defaultScriptInstallDir: '.stepcode/bin',
+    /** The vendor installer writes this marked block into the shell profile. */
+    pathProfileMarkers: Object.freeze(['# stepcode']),
+    installMethods: Object.freeze([
+      scriptMethod('script-bash', 'curl | bash', {
+        shell: 'bash',
+        scriptUrl: 'https://static-openapi.stepfun.com/stepcode/install.sh',
+        platforms: ['linux', 'darwin'],
+        installArg: ['--install-dir'],
+        env: ['STEP_INSTALL_DIR', 'STEP_RELEASE_BASE_URL'],
+        defaultInstallDir: '.stepcode/bin',
+        verify: Object.freeze({
+          mustInclude: ['static-openapi.stepfun.com', 'stepcode installer'],
+          mustNotInclude: ['anomalyco/opencode'],
+        }),
+      }),
+      scriptMethod('script-powershell', 'irm | iex', {
+        shell: 'powershell',
+        scriptUrl: 'https://static-openapi.stepfun.com/stepcode/install.ps1',
+        platforms: ['win32'],
+        installArg: ['-InstallDir'],
+        env: ['STEP_INSTALL_DIR', 'STEP_RELEASE_BASE_URL'],
+        defaultInstallDir: '.stepcode/bin',
+        verify: Object.freeze({
+          mustInclude: ['static-openapi.stepfun.com', 'stepcode'],
+          mustNotInclude: ['anomalyco/opencode'],
+        }),
+      }),
+    ]),
   }),
   Object.freeze({
     id: 'zcode',
@@ -101,6 +432,7 @@ export const OFFICIAL_TOOLS = Object.freeze([
     purpose: '智谱官方 ZCode 桌面版，内含 GLM 编程代理。Windows 安装器可选择 D 盘目录。',
     manager: 'signed-windows-installer',
     installArgs: [],
+    uninstallArgs: [],
     probeExecutables: [],
     probeNote: '检测经过有效签名的 ZCode.exe 和同目录 GLM 资源；桌面安装器需人工选择安装位置。',
     providerHints: ['zai', 'z.ai', 'zcode', 'glm', 'zhipu', 'bigmodel'],
@@ -123,11 +455,60 @@ export function toolForProvider(provider) {
   return null
 }
 
-/** Human-readable install command line for one registry entry. */
+/** Every install method a tool declares, or an empty list for the desktop installer. */
+export function installMethodsFor(tool) {
+  return Array.isArray(tool?.installMethods) ? tool.installMethods : []
+}
+
+/** One closed method id of one tool; null when the tool does not offer it. */
+export function installMethodFor(tool, methodId) {
+  const wanted = String(methodId ?? '').trim()
+  if (!wanted) return null
+  return installMethodsFor(tool).find(method => method.id === wanted) ?? null
+}
+
+/** The tool's default method, kept identical to `manager` / `installArgs`. */
+export function defaultInstallMethod(tool) {
+  return installMethodsFor(tool)[0] ?? null
+}
+
+/** Why a method cannot run here, or null when the current platform can run it. */
+export function installMethodBlockReason(method, platform = 'linux') {
+  if (!method?.platforms) return null
+  return method.platforms.includes(platform) ? null : `此安装方式仅支持 ${method.platforms.join(' / ')}。`
+}
+
+/**
+ * A method able to place the tool in the user's chosen directory. npm and pnpm
+ * take --prefix; the opencode script hardcodes its own path and cannot.
+ */
+export function methodHonoursInstallDir(method) {
+  return method?.supportsInstallDir === true
+}
+
+/** Human-readable install command line for one registry entry (default method). */
 export function installCommandLine(tool) {
   if (!tool || tool.unsupported) return null
+  // The signed desktop installer is not a command; it is its own thing.
   if (tool.manager === 'signed-windows-installer') return '打开官方签名安装器（选择安装目录）'
-  return tool.manager === 'npm'
-    ? `npm ${tool.installArgs.join(' ')}`
-    : `${tool.manager} ${tool.installArgs.join(' ')}`
+  return installCommandLineFor(tool, defaultInstallMethod(tool))
+}
+
+/** Human-readable command line for one specific method of one tool. */
+export function installCommandLineFor(tool, method) {
+  if (!tool || tool.unsupported) return null
+  if (!method) return null
+  if (method.kind === 'script') {
+    const piped = method.shell === 'powershell' ? `irm ${method.scriptUrl} | iex` : `curl -fsSL ${method.scriptUrl} | bash`
+    return method.installArgs.length ? `${piped} ${method.installArgs[0]} <安装目录>` : piped
+  }
+  return `${method.manager} ${method.installArgs.join(' ')}`
+}
+
+/** Human-readable uninstall command line, or null when removal is not a command. */
+export function uninstallCommandLineFor(tool, method) {
+  if (!tool || tool.unsupported || !method) return null
+  if (tool.manager === 'signed-windows-installer') return null
+  if (method.kind === 'script') return '删除官方安装的可执行文件（保留配置与登录信息）'
+  return `${method.manager} ${method.uninstallArgs.join(' ')}`
 }

package/.dsh-plugin/shared/official-tools-remote.mjs

@@ -5,7 +5,7 @@
  * the Host Typert registry owns the matching strict descriptors. No endpoint
  * accepts a command, package name, URL, argument vector, or executable path.
  */
-import { getOfficialTool } from './official-tool-registry.mjs'
+import { getOfficialTool, installMethodsFor } from './official-tool-registry.mjs'
 import {
   parseTerminalRead,
   parseTerminalResize,
@@ -35,6 +35,40 @@ const toolIdCodec = strictCodec(`${OFFICIAL_TOOLS_REMOTE_PACKAGE}#OfficialToolId
   return value
 })
 
+const MAX_METHOD_ID_CHARS = 40
+
+const text = value => (typeof value === 'string' ? value.trim() : '')
+
+/**
+ * One install/uninstall request: a registry id plus, optionally, which of that
+ * tool's declared install methods to use. The install directory, the npm source
+ * and the installer-script source are Host settings and never travel on this
+ * call, so a compromised client cannot redirect an install at a package or URL
+ * of its choosing.
+ */
+const toolActionCodec = strictCodec(`${OFFICIAL_TOOLS_REMOTE_PACKAGE}#OfficialToolAction`, value => {
+  const request = plainObject(value, 'tool action request')
+  // Closed shape: an unknown key is refused rather than ignored, so a client
+  // cannot smuggle a command, URL or argument list past the codec.
+  for (const key of Object.keys(request)) {
+    if (key !== 'tool' && key !== 'method') throw new TypeError(`unknown field ${key} in tool action request`)
+  }
+  const tool = getOfficialTool(text(request.tool))
+  if (!tool) throw new TypeError('tool must name a fixed official tool')
+  const method = request.method === undefined || request.method === null || request.method === ''
+    ? null
+    : text(request.method)
+  if (method !== null) {
+    if (method.length > MAX_METHOD_ID_CHARS || !/^[A-Za-z0-9-]+$/.test(method)) {
+      throw new TypeError('method must be one of the tool\'s declared install methods')
+    }
+    if (!installMethodsFor(tool).some(item => item.id === method)) {
+      throw new TypeError(`${tool.label} does not offer the install method ${method}`)
+    }
+  }
+  return method === null ? { tool: tool.id } : { tool: tool.id, method }
+})
+
 const listResultCodec = strictCodec(`${OFFICIAL_TOOLS_REMOTE_PACKAGE}#OfficialToolList`, value => {
   const result = plainObject(value, 'tool list result')
   if (!Array.isArray(result.tools)) throw new TypeError('tool list result needs a tools array')
@@ -159,7 +193,9 @@ const jsonParameter = (name, codec) => Object.freeze({ name, wire: name, source:
 
 export const OFFICIAL_TOOLS_REMOTE_DESCRIPTORS = Object.freeze([
   descriptor('list', [], listResultCodec),
-  descriptor('installTool', [toolIdParameter], installResultCodec),
+  descriptor('installTool', [jsonParameter('request', toolActionCodec)], installResultCodec),
+  descriptor('uninstallTool', [jsonParameter('request', toolActionCodec)], installResultCodec),
+  descriptor('repairTool', [jsonParameter('request', toolActionCodec)], installResultCodec),
   descriptor('cancel', [toolIdParameter], installResultCodec),
   descriptor('status', [toolIdParameter], statusResultCodec),
   // Workbench: onboarding health check, run ledger, ratings, step retry, security boundaries.