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

package/.dsh-plugin/shared/tool-install-preferences.mjs

@@ -113,9 +113,9 @@ function keepKnownToolIds(raw, known, subject) {
  * Throws with a user-facing message on the first bad value, so the settings
  * form and the installer fail the same way.
  */
-export function parseInstallPreferences(config = {}, { tools = [] } = {}) {
+export function parseInstallPreferences(config = {}, { tools = [], home = '', env = {} } = {}) {
   const known = new Set(tools.map(tool => tool.id))
-  const installDir = expandInstallDir(valueOf(config, 'toolInstallDir', ''))
+  const installDir = expandInstallDir(valueOf(config, 'toolInstallDir', ''), { home, env })
   const registry = normalizeSourceUrl(valueOf(config, 'toolNpmRegistry', DEFAULT_NPM_REGISTRY), 'npm 源') || DEFAULT_NPM_REGISTRY
   const methodRaw = keepKnownToolIds(
     parseJsonObject(valueOf(config, 'toolInstallMethodsJson', '{}'), '安装方式覆盖'), known, '安装方式覆盖')
@@ -126,9 +126,11 @@ export function parseInstallPreferences(config = {}, { tools = [] } = {}) {
   for (const [id, methodId] of Object.entries(methodRaw)) methods[id] = methodId.trim()
   for (const [id, url] of Object.entries(scriptRaw)) scriptUrls[id] = normalizeSourceUrl(url, `${id} 安装脚本源`)
   for (const [id, methodId] of Object.entries(methods)) {
-    if (!installMethodFor({ id, installMethods: tools.find(tool => tool.id === id)?.installMethods }, methodId)) {
+    const selected = installMethodFor({ id, installMethods: tools.find(tool => tool.id === id)?.installMethods }, methodId)
+    if (!selected) {
       throw new Error(`${id} 不支持安装方式 ${methodId}。`)
     }
+    methods[id] = selected.id
   }
   return {
     installDir,
@@ -141,26 +143,46 @@ export function parseInstallPreferences(config = {}, { tools = [] } = {}) {
 }
 
 /** Where a script install puts the binary: the user's directory, else the vendor default. */
-export function scriptInstallDir(tool, preferences, { home = '', method = null } = {}) {
-  if (!vendorScriptRelative(tool, method)) return ''
-  return preferences?.installDir || vendorScriptDir(tool, { home, method })
+export function scriptInstallDir(tool, preferences, { home = '', env = {}, method } = {}) {
+  const binaryDir = vendorScriptDir(tool, { home, env, method })
+  if (!binaryDir) return ''
+  if (preferences?.installDir) return method?.installDirSubdir ? joinPath(preferences.installDir, method.installDirSubdir) : preferences.installDir
+  // Environment-only installers take a root and then add their own bin suffix.
+  const suffix = String(method?.installDirSuffix ?? '')
+  return suffix && new RegExp(`[\\\\/]${suffix}$`).test(binaryDir) ? binaryDir.slice(0, -suffix.length - 1) : binaryDir
 }
 
-function vendorScriptRelative(tool, method) {
-  return String(method?.defaultInstallDir || tool?.defaultScriptInstallDir || '')
+/** The location the vendor script uses on its own, ignoring any configured directory. */
+export function vendorScriptDir(tool, { home = '', env = {}, method } = {}) {
+  const value = method?.defaultScriptInstallDir ?? tool?.defaultScriptInstallDir
+  const root = method?.defaultScriptInstallDirEnv ? env[method.defaultScriptInstallDirEnv] || home : home
+  return value ? joinPath(root, ...String(value).split('/').filter(Boolean)) : ''
 }
 
-/** The location the vendor script uses on its own, ignoring any configured directory. */
-export function vendorScriptDir(tool, { home = '', method = null } = {}) {
-  return joinPath(home, ...vendorScriptRelative(tool, method).split('/').filter(Boolean))
+/** The directory containing the package manager's global command shims. */
+export function packageManagerBinDir(installDir, { platform = 'linux' } = {}) {
+  return installDir ? (platform === 'win32' ? installDir : joinPath(installDir, 'bin')) : ''
 }
 
-/** argv for a package-manager method, honouring the configured registry and prefix. */
-export function packageManagerArgs(method, preferences, { installDir = '' } = {}) {
+function packageManagerDirectoryArgs(method, installDir, options) {
+  if (!installDir) return []
+  if (method.manager !== 'pnpm') return ['--prefix', installDir]
+  // pnpm does not implement npm's global --prefix layout. Its package tree and
+  // bin directory are separate settings; the config namespace works for add,
+  // install, remove and bin commands across pnpm 10.
+  return [
+    `--config.global-dir=${joinPath(installDir, '.pnpm', 'global')}`,
+    `--config.global-bin-dir=${packageManagerBinDir(installDir, options)}`,
+    `--config.store-dir=${joinPath(installDir, '.pnpm', 'store')}`,
+  ]
+}
+
+/** argv for a package-manager method, honouring its actual global layout. */
+export function packageManagerArgs(method, preferences, { installDir = '', platform = 'linux' } = {}) {
   const registry = preferences?.registry || DEFAULT_NPM_REGISTRY
   const args = method.installArgs.filter(arg => !arg.startsWith('--registry='))
   args.push(`--registry=${registry}`)
-  if (installDir) args.push('--prefix', installDir)
+  args.push(...packageManagerDirectoryArgs(method, installDir, { platform }))
   return [...args]
 }
 
@@ -171,6 +193,13 @@ function baseUrlOf(scriptUrl) {
   } catch { return '' }
 }
 
+/** MiniMax's official installer itself accepts exactly these npm registries. */
+export function minimaxScriptRegistry(registry) {
+  const raw = String(registry ?? '').trim()
+  const normalized = raw && !raw.endsWith('/') ? `${raw}/` : raw
+  return normalized === 'https://registry.npmjs.org/' || normalized === 'https://registry.npmmirror.com/' ? normalized : ''
+}
+
 /**
  * The method to use: the requested one, else the user's saved choice, else the
  * registry default — and if none of those run on this platform, the first
@@ -181,14 +210,11 @@ function pickMethod(tool, methodId, preferences, platform) {
   const requested = methodId ?? preferences?.methods?.[tool.id]
   if (!requested) {
     const available = installMethodsFor(tool).filter(method => !installMethodBlockReason(method, platform))
-    // An installed Windows MiniMax lives in the official installer layout.
-    // npm does not move that copy, so the unpinned one-click update is the
-    // vendor PowerShell script. Pinning npm or pnpm still runs that manager.
-    if (platform === 'win32' && tool?.id === 'minimax-code' && preferences?.allowScriptInstall !== false) {
-      const powershell = available.find(method => method.id === 'script-powershell')
-      if (powershell) return powershell
-    }
-    return available[0] ?? defaultInstallMethod(tool)
+    const allowed = method => !installMethodBlockReason(method, platform)
+      && !(method.kind === 'script' && preferences?.allowScriptInstall === false)
+    const platformDefault = installMethodFor(tool, tool.defaultMethodsByPlatform?.[platform])
+    if (platformDefault && allowed(platformDefault)) return platformDefault
+    return available.find(allowed) ?? available[0] ?? defaultInstallMethod(tool)
   }
   // A named method is never silently swapped. If the tool does not declare it,
   // or it does not run here, the caller gets the reason instead of a surprise.
@@ -207,7 +233,7 @@ function unsupportedMethodError(tool) {
  * One concrete plan for one tool and one method. A thrown Error means the user
  * asked for something this tool cannot do, with a reason they can act on.
  */
-export function resolveInstallPlan(tool, methodId, preferences = {}, { platform = 'linux', home = '' } = {}) {
+export function resolveInstallPlan(tool, methodId, preferences = {}, { platform = 'linux', home = '', env = {} } = {}) {
   if (!tool || tool.unsupported) throw new Error(tool?.unsupportedReason ?? '此工具不支持一键安装。')
   const method = pickMethod(tool, methodId, preferences, platform)
   if (!method) throw new Error(unsupportedMethodError(tool))
@@ -219,12 +245,14 @@ export function resolveInstallPlan(tool, methodId, preferences = {}, { platform
   const installDir = preferences?.installDir || ''
   if (method.kind === 'script') {
     const scriptUrl = preferences?.scriptUrls?.[tool.id] || method.scriptUrl
-    const target = methodHonoursInstallDir(method) ? scriptInstallDir(tool, preferences, { home, method }) : ''
-    const notices = []
-    if (!target && installDir) {
-      notices.push(`${method.label} 无法使用自定义安装目录（官方脚本写死了安装路径），将安装到 ${vendorScriptDir(tool, { home, method })}。`)
-    }
-    if (method.env?.includes('MCODE_NPM_REGISTRY') && preferences?.registry && !minimaxScriptRegistry(preferences.registry)) {
+    const target = methodHonoursInstallDir(method) ? scriptInstallDir(tool, preferences, { home, env, method }) : ''
+    const binDir = target
+      ? (method.installDirSuffix ? joinPath(target, method.installDirSuffix) : target)
+      : vendorScriptDir(tool, { home, env, method })
+    const notices = target ? [] : installDir
+      ? [`${method.label} 无法使用自定义安装目录（官方脚本写死了安装路径），将安装到 ${vendorScriptDir(tool, { home, env, method })}。`]
+      : []
+    if (method.registryEnv === 'MCODE_NPM_REGISTRY' && preferences.registry && !minimaxScriptRegistry(preferences.registry)) {
       notices.push('MiniMax 官方脚本只接受 https://registry.npmjs.org/ 或 https://registry.npmmirror.com/，本次不改写它的 npm 源。')
     }
     return {
@@ -235,12 +263,12 @@ export function resolveInstallPlan(tool, methodId, preferences = {}, { platform
       label: method.label,
       shell: method.shell,
       scriptUrl,
+      downloadUrls: preferences?.scriptUrls?.[tool.id] ? [scriptUrl] : [...new Set([scriptUrl, ...(method.scriptFallbackUrls ?? [])])],
       verify: method.verify,
       installArg: method.installArgs,
-      installDirEnv: method.installDirEnv || (method.env?.includes('STEP_INSTALL_DIR') ? 'STEP_INSTALL_DIR' : ''),
       installDir: target,
-      relatives: scriptRelatives(tool, method),
-      env: scriptEnv(method, { installDir: target, scriptUrl, registry: preferences?.registry }),
+      binDir,
+      env: scriptEnv(method, { installDir: target, scriptUrl, registry: preferences.registry }),
       notices,
     }
   }
@@ -251,8 +279,9 @@ export function resolveInstallPlan(tool, methodId, preferences = {}, { platform
     kind: 'package-manager',
     label: method.label,
     manager: method.manager,
-    args: packageManagerArgs(method, preferences, { installDir }),
+    args: packageManagerArgs(method, preferences, { installDir, platform }),
     installDir,
+    binDir: packageManagerBinDir(installDir, { platform }),
     env: {},
     notices: [],
   }
@@ -267,6 +296,7 @@ export function resolveUninstallPlan(tool, methodId, preferences = {}, options =
     : `${tool?.label ?? '此工具'} 没有可用的卸载方式。`)
   const blocked = installMethodBlockReason(method, platform)
   if (blocked) throw new Error(`${tool.label}：${blocked}`)
+  if (method.uninstallUnsupportedReason) throw new Error(method.uninstallUnsupportedReason)
   if (method.kind === 'script') {
     return { toolId: tool.id, method, methodId: method.id, kind: 'script', label: method.label, ...resolveInstallLocation(tool, method, preferences, options) }
   }
@@ -280,67 +310,41 @@ export function resolveUninstallPlan(tool, methodId, preferences = {}, options =
     args: [
       ...method.uninstallArgs,
       ...(preferences?.registry ? [`--registry=${preferences.registry}`] : []),
-      ...(preferences?.installDir ? ['--prefix', preferences.installDir] : []),
+      ...packageManagerDirectoryArgs(method, preferences?.installDir || '', { platform }),
     ],
     installDir: preferences?.installDir || '',
+    binDir: packageManagerBinDir(preferences?.installDir || '', { platform }),
   }
 }
 
-/** Paths under the install directory that an uninstall may delete. No `..`. */
-export function scriptRelatives(tool, method) {
-  const listed = method?.binaryRelatives?.length
-    ? method.binaryRelatives
-    : tool?.scriptBinaryRelatives?.length
-      ? tool.scriptBinaryRelatives
-      : tool?.scriptBinaryNames
-  return [...(listed ?? [])]
-}
-
 /** Where the tool's binary lives, so a later uninstall can find it. */
-export function resolveInstallLocation(tool, method, preferences = {}, { home = '' } = {}) {
+export function resolveInstallLocation(tool, method, preferences = {}, { home = '', platform = 'linux', env = {} } = {}) {
   if (!method) return null
   if (method.kind === 'script') {
     // A method that cannot honour the configured directory always lands in the
     // vendor's own location, whatever the user typed.
     const dir = methodHonoursInstallDir(method)
-      ? scriptInstallDir(tool, preferences, { home, method })
-      : vendorScriptDir(tool, { home, method })
-    return {
-      kind: 'script',
-      dir,
-      binaries: [...(tool.scriptBinaryNames ?? [])],
-      relatives: scriptRelatives(tool, method),
-    }
+      ? scriptInstallDir(tool, preferences, { home, env, method })
+      : vendorScriptDir(tool, { home, env, method })
+    const binDir = methodHonoursInstallDir(method) && method.installDirSuffix ? joinPath(dir, method.installDirSuffix) : dir
+    return { kind: 'script', dir: binDir, installDir: dir, binaries: [...(method.scriptBinaryNames ?? tool.scriptBinaryNames ?? [])] }
   }
-  return { kind: 'package-manager', dir: preferences?.installDir || '', binaries: [], relatives: [] }
-}
-
-/** MiniMax's installer rejects every registry except these two. */
-const MINIMAX_SCRIPT_REGISTRIES = new Set([
-  'https://registry.npmjs.org/',
-  'https://registry.npmmirror.com/',
-])
-
-export function minimaxScriptRegistry(registry) {
-  const value = String(registry ?? '').trim()
-  if (!value) return ''
-  const normalized = value.endsWith('/') ? value : `${value}/`
-  return MINIMAX_SCRIPT_REGISTRIES.has(normalized) ? normalized : ''
+  return { kind: 'package-manager', dir: packageManagerBinDir(preferences?.installDir || '', { platform }), installDir: preferences?.installDir || '', binaries: [] }
 }
 
 function scriptEnv(method, { installDir, scriptUrl, registry }) {
   const env = {}
-  const dirEnv = method.installDirEnv || (method.env?.includes('STEP_INSTALL_DIR') ? 'STEP_INSTALL_DIR' : '')
-  if (installDir && dirEnv) env[dirEnv] = installDir
+  if (installDir && method.installDirEnv) env[method.installDirEnv] = installDir
+  if (registry && method.registryEnv) {
+    const allowed = method.registryEnv === 'MCODE_NPM_REGISTRY' ? minimaxScriptRegistry(registry) : registry
+    if (allowed) env[method.registryEnv] = allowed
+  }
+  if (installDir && method.env?.includes('STEP_INSTALL_DIR')) env.STEP_INSTALL_DIR = installDir
   // The step installers read their release base from this variable, so a mirror
   // URL also moves the binaries and the checksum manifest, not just the script.
   if (method.env?.includes('STEP_RELEASE_BASE_URL') && scriptUrl) {
     const base = baseUrlOf(scriptUrl)
     if (base) env.STEP_RELEASE_BASE_URL = base
   }
-  if (method.env?.includes('MCODE_NPM_REGISTRY')) {
-    const allowed = minimaxScriptRegistry(registry)
-    if (allowed) env.MCODE_NPM_REGISTRY = allowed
-  }
   return env
 }

package/.dsh-plugin/shared/vendor-mimo-grok-adapter.mjs

@@ -17,11 +17,11 @@ import { createReadStream } from 'node:fs'
 import { createHash } from 'node:crypto'
 import { npmAttestor } from './npm-attestation.mjs'
 import { isReleaseVersion } from './latest-versions.mjs'
-import { readFile, realpath, stat } from 'node:fs/promises'
+import { readFile, readdir, realpath, stat } from 'node:fs/promises'
 import { createBrotliDecompress } from 'node:zlib'
 import { homedir } from 'node:os'
 import { basename, delimiter, isAbsolute, join, relative, resolve, sep } from 'node:path'
-import { ensureNpmPrefixOnPath } from './official-tools-runtime.mjs'
+import { ensureNpmPrefixOnPath, preferredToolDirectories } from './official-tools-runtime.mjs'
 import { usageFromEvents } from './task-executors.mjs'
 
 const TOOL_IDS = Object.freeze(['mimo-code', 'grok-build'])
@@ -50,18 +50,37 @@ function inside(parent, child) {
 
 function packagePath(modules, name) { return join(modules, ...name.split('/')) }
 
-function moduleRoots() {
-  const path = process.env.PATH ?? process.env.Path ?? ''
+/** npm prefixes and pnpm's versioned global tree share fixed package names. */
+export async function installedModuleRoots(directories, { manager = null } = {}) {
   const roots = new Set()
-  for (const raw of path.split(delimiter)) {
+  for (const raw of directories) {
     const directory = raw.trim().replace(/^"|"$/g, '')
     if (!directory) continue
-    roots.add(join(directory, 'node_modules'))
-    if (basename(directory).toLowerCase() === '.bin') roots.add(resolve(directory, '..'))
+    if (manager !== 'pnpm') {
+      roots.add(join(directory, 'node_modules'))
+      if (basename(directory).toLowerCase() === '.bin') roots.add(resolve(directory, '..'))
+      if (process.platform !== 'win32') roots.add(resolve(directory, '..', 'lib', 'node_modules'))
+    }
+    if (manager !== 'npm') {
+      if (/[\\/]global[\\/]\d+[\\/]node_modules[\\/]\.bin$/i.test(directory)) roots.add(resolve(directory, '..'))
+      const prefix = process.platform !== 'win32' && basename(directory).toLowerCase() === 'bin' ? resolve(directory, '..') : directory
+      for (const globalRoot of [join(prefix, '.pnpm', 'global'), join(prefix, 'global')]) {
+        try {
+          for (const entry of await readdir(globalRoot, { withFileTypes: true })) {
+            if (entry.isDirectory() && /^\d+$/.test(entry.name)) roots.add(join(globalRoot, entry.name, 'node_modules'))
+          }
+        } catch { /* this command directory has no pnpm global tree */ }
+      }
+    }
   }
   return [...roots]
 }
 
+function entryDirectories(toolId) {
+  const preferred = preferredToolDirectories(toolId)
+  return preferred.length ? preferred : (process.env.PATH ?? process.env.Path ?? '').split(delimiter)
+}
+
 async function manifestAt(directory, name, version = null) {
   try {
     const root = await realpath(directory)
@@ -91,24 +110,29 @@ async function realFileWithin(root, candidate, workspace) {
 }
 
 async function optionalPackage(wrapper, platform, modules, workspace) {
+  const boundary = await realpath(modules).catch(() => null)
+  if (!boundary || !inside(boundary, wrapper.root) || wrapper.root === workspace || inside(workspace, wrapper.root)) return null
   // The wrapper pins its platform package to its own version.
   const version = wrapper.manifest.optionalDependencies?.[platform.package]
   if (version !== wrapper.manifest.version) return null
   const candidates = [
     packagePath(join(wrapper.root, 'node_modules'), platform.package),
+    // pnpm links an optional dependency beside the real wrapper in the
+    // virtual store, rather than inside the wrapper's own node_modules.
+    packagePath(resolve(wrapper.root, '..', '..'), platform.package),
     packagePath(modules, platform.package),
   ]
   for (const candidate of candidates) {
     const optional = await manifestAt(candidate, platform.package, version)
-    if (!optional || optional.root === workspace || inside(workspace, optional.root)) continue
+    if (!optional || !inside(boundary, optional.root) || optional.root === workspace || inside(workspace, optional.root)) continue
     return optional
   }
   return null
 }
 
-async function findMiMoExecutable(workspace, platform, attestor, problems) {
+async function findMiMoExecutable(workspace, platform, attestor, problems, modulesRoots) {
   const wrapperInfo = WRAPPERS['mimo-code']
-  for (const modules of moduleRoots()) {
+  for (const modules of modulesRoots) {
     const wrapper = await manifestAt(packagePath(modules, wrapperInfo.name), wrapperInfo.name)
     if (!wrapper || String(wrapper.manifest.bin?.[wrapperInfo.command]).replace(/^\.\//, '') !== wrapperInfo.bin) continue
     const optional = await optionalPackage(wrapper, platform, modules, workspace)
@@ -129,9 +153,9 @@ async function grokHome() {
   catch { return join(homedir(), '.grok') }
 }
 
-async function findGrokExecutable(workspace, platform, attestor, problems) {
+async function findGrokExecutable(workspace, platform, attestor, problems, modulesRoots) {
   const wrapperInfo = WRAPPERS['grok-build']
-  for (const modules of moduleRoots()) {
+  for (const modules of modulesRoots) {
     const wrapper = await manifestAt(packagePath(modules, wrapperInfo.name), wrapperInfo.name)
     if (!wrapper || String(wrapper.manifest.bin?.[wrapperInfo.command]).replace(/^\.\//, '') !== wrapperInfo.bin) continue
     const optional = await optionalPackage(wrapper, platform, modules, workspace)
@@ -167,7 +191,7 @@ async function findGrokExecutable(workspace, platform, attestor, problems) {
  * process runner, or an unsupported reason. The Host retains its own task,
  * workspace, model, approval, timeout, and cancellation validation.
  */
-export async function resolveMiMoGrokLaunch({ toolId, workspace, mode, modelId, task, attestor = npmAttestor }) {
+export async function resolveMiMoGrokLaunch({ toolId, workspace, mode, modelId, task, attestor = npmAttestor, directories, moduleRoots, manager = null }) {
   if (!TOOL_IDS.includes(toolId)) return { unsupported: '未知的 MiMo/Grok 官方工具 ID。' }
   if (process.platform !== 'win32') return { unsupported: 'MiMo/Grok 原生入口目前仅完成 Windows 适配。' }
   if (!isAbsolute(workspace) || !['read-only', 'workspace-write'].includes(mode)) {
@@ -181,12 +205,13 @@ export async function resolveMiMoGrokLaunch({ toolId, workspace, mode, modelId,
   }
   const platform = PLATFORMS[toolId][process.arch]
   if (!platform) return { unsupported: '当前 Windows CPU 架构没有核验的官方原生程序。' }
-  await ensureNpmPrefixOnPath()
+  if (!Array.isArray(moduleRoots) && !directories && preferredToolDirectories(toolId).length === 0) await ensureNpmPrefixOnPath()
   const directory = await realpath(workspace)
+  const modulesRoots = Array.isArray(moduleRoots) ? moduleRoots : await installedModuleRoots(directories ?? entryDirectories(toolId), { manager })
   const problems = []
   const found = toolId === 'mimo-code'
-    ? await findMiMoExecutable(directory, platform, attestor, problems)
-    : await findGrokExecutable(directory, platform, attestor, problems)
+    ? await findMiMoExecutable(directory, platform, attestor, problems, modulesRoots)
+    : await findGrokExecutable(directory, platform, attestor, problems, modulesRoots)
   if (!found) {
     return { unsupported: problems.length
       ? `官方原生程序未通过 npm registry 摘要核验：${problems[0]}`

package/CHANGELOG.md

@@ -1,6 +1,16 @@
 # Changelog
 
-## Unreleased
+## 0.18.0 — 2026-10-12
+
+Stable minor under the npm latest tag. Fully quit Harness, including the tray or WebUI host process, and restart after upgrading. Existing releases remain unchanged.
+
+- Add verified vendor curl/irm channels for Kimi, Claude, Codex, MiniMax, MiMo and Grok. Gemini retains npm/pnpm, OpenCode adds its Unix script, Step uses vendor scripts, and ZCode opens its signed Windows installer. Fixed vendor paths and unsupported platform methods are explained on each row.
+- Fix MiniMax’s official Windows installer rejection: leading PowerShell `<# ... #>` help is accepted; HTML pages and missing vendor markers are still refused. Legacy MiniMax updates preserve the discovered native install root, including attested repair-release pointers.
+- Correct pnpm global package/bin/store directory options and retain MiniMax native dependency build flags. Updates probe the selected directory, never accept an unrelated newer PATH copy, and refuse known downgrades. Queued jobs keep their selected method, source and directory snapshot.
+- Make shared installation settings an explicit Save/Discard form. Pending edits, saves and summary refreshes block install actions; saved unavailable methods retain their explanation. Removal stays available when future script installations are disabled.
+- Resolve restricted execution entries from the selected installation. Claude/Codex native Windows files require publisher verification. Kimi/MiMo/Grok standalone script installations currently lack npm-file attestation and report this execution limit; npm/pnpm execution remains supported. Do not delete the Windows Codex standalone junction through generic script uninstall.
+- Vendor downloads remain size-limited, staged and marker-checked. Windows retries through the system network/proxy transport when Node cannot retrieve an installer; the downloaded response is never executed during transport.
+- Validation results are recorded in the release notes. Verification uses automated regressions, current official script downloads without execution, and the actual-component mock UI. No real vendor CLI installation or paid model request is part of release acceptance.
 
 ## 0.17.1 — 2026-10-11
 

package/README.md

@@ -1,9 +1,11 @@
 # Model Router · DeepSeek Harness Desktop
 
-Version: **0.16.4**. See [routing research](docs/ROUTING_RESEARCH.zh.md), [mathematical derivation and experiments](docs/ROUTING_DERIVATION_EXPERIMENTS.zh.md), and the [LiveBench evidence audit and validation protocol](docs/ROUTING_LIVEBENCH_VALIDATION.zh.md). The latest public 2026-06-25 score/cost tables are aggregates; its paired question-quality/cost matrix has not been obtained, and no real routing gain is claimed.
+Version: **0.18.0**. See [routing research](docs/ROUTING_RESEARCH.zh.md), [mathematical derivation and experiments](docs/ROUTING_DERIVATION_EXPERIMENTS.zh.md), and the [LiveBench evidence audit and validation protocol](docs/ROUTING_LIVEBENCH_VALIDATION.zh.md). The latest public 2026-06-25 score/cost tables are aggregates; its paired question-quality/cost matrix has not been obtained, and no real routing gain is claimed.
 
 A cost-aware model-routing workbench for **DeepSeek Harness Desktop**. Describe a task, compare your configured models, inspect the plan, and explicitly choose when to execute it.
 
+**0.18.0:** expands official vendor installer choices alongside npm/pnpm, preserves the configured install destination during updates, and verifies the target copy instead of an older PATH copy. MiniMax Windows scripts beginning with PowerShell `<# ... #>` help comments are accepted; HTML error pages remain rejected. Save unified install settings before installing or updating.
+
 **0.16.4:** PATH probes keep command output even when no install log callback is attached. 0.16.3 captured stdout only inside `onOutput?.(...)`, so `where` and `--version` looked empty and every PATH CLI was reported not-installed. MiniMax and ZCode were unaffected because they do not use that probe.
 
 **0.16.3:** restores official-tools detection and install for every registry card. Windows probes and `npm` are spawned with separate arguments again, so cmd no longer launches Node against a missing script. A version banner still counts as installed, one card's probe error stays on that row, and a CLI that is already current is not sent through “修复官方执行入口”.
@@ -14,7 +16,7 @@ A cost-aware model-routing workbench for **DeepSeek Harness Desktop**. Describe
 
 **0.16.0:** [dynamic data and adaptive feedback](docs/ROUTING_ADAPTIVE_LEARNING.zh.md) adds opt-in public benchmark/curated fixed-USD pricing refresh and task-specific, time-decayed, shrinkage-regularized subjective utility. Objective proxy quality floors remain separate. Public sources default off; preferences are shared within one local DSH_HOME and limited to the latest 200 runs. This is not a universal vendor-price scraper or evidence of real quality–cost gains.
 
-Current version: **0.16.4** (`@ljwei-stak/dsh-model-router`). Its declared host compatibility is **DeepSeek Harness Desktop 0.2.0-rc.1 / 0.2.0-rc.2**. The router and [GAL](https://github.com/Alice-Marx/deepseek-harness-galgame) have been independent plugins since 0.12.0.
+Current version: **0.18.0** (`@ljwei-stak/dsh-model-router`). Its declared host compatibility is **DeepSeek Harness Desktop 0.2.0-rc.1 / 0.2.0-rc.2**. The router and [GAL](https://github.com/Alice-Marx/deepseek-harness-galgame) have been independent plugins since 0.12.0.
 
 **0.15.0 changes:** a four-tab workbench with routing advice directly below task planning, protection against stale execution previews, preserved spending totals across history pruning and retries, and a standalone mock UI preview for source development.
 
@@ -31,7 +33,7 @@ For self-testing, follow the [desktop acceptance and quality–cost experiment s
 | Routing presets | Economy, balanced and quality-first presets; quality floors, estimated token costs and bounded assignment search. Missing prices stay unknown. |
 | Read-only execution | Preview and confirm a routed run from the workbench, or invoke it in an official Harness session. Supported headless CLIs and model-directory API calls return recorded results. |
 | Editable CLI execution | One supported official CLI or a sequential CLI team, using approved isolated Git worktrees and conditional patch integration. |
-| Official tools | Detect, install/update, check launch readiness and inspect login status for eight registry tools; installation jobs have logs and cancellation. |
+| Official tools | Detect, install/update, check launch readiness and inspect login status for ten registry tools; installation jobs have logs and cancellation. |
 | Interactive terminal | PowerShell/system shell and seven CLI targets, including fixed login commands, live output and multiple sessions. |
 | Costs and subscriptions | Daily/monthly budget checks, economy downgrade or pause, subscription-first routing, quota cooldown and explicit handling of other subscription failures. |
 | History and quality | Per-package results, dependency views, failure details, rerun/reassignment, ratings and optional stronger-model review. |
@@ -46,16 +48,16 @@ Generating a route recommendation is local: it does not start a vendor CLI or ma
 Open **Plugins → Add plugin** and enter:
 
 ```text
-@ljwei-stak/dsh-model-router@0.16.4
+@ljwei-stak/dsh-model-router@0.18.0
 ```
 
-Use the official HTTPS npm source `https://registry.npmjs.org/` when a mirror lacks that exact version. Enable the plugin, then fully quit Harness (including its tray process) and restart it. Plugin details should show **0.16.4** and the sidebar should contain **模型路由** (Model Router). A global `npm install -g` alone does not register a Desktop plugin.
+Use the official HTTPS npm source `https://registry.npmjs.org/` when a mirror lacks that exact version. Enable the plugin, then fully quit Harness (including its tray process) and restart it. Plugin details should show **0.18.0** and the sidebar should contain **模型路由** (Model Router). A global `npm install -g` alone does not register a Desktop plugin.
 
 You can instead install a local `.tgz` archive or its extracted inner `package` directory through the plugin manager. Both must contain `package.json` and `.dsh-plugin`. See [releases](https://github.com/Alice-Marx/dsh-model-router/releases) for archived builds, or build your own checkout below.
 
 ### Upgrade from the old package name
 
-The old name `@ljwei-stak/model-router-galgame` ended at 0.13.0. Remove that plugin entry while retaining your profile/application data, then add `@ljwei-stak/dsh-model-router@0.16.4`. Do not keep both entries installed: they share the internal plugin id `model-router-galgame` and tool names. The retained id lets existing router settings and history carry over.
+The old name `@ljwei-stak/model-router-galgame` ended at 0.13.0. Remove that plugin entry while retaining your profile/application data, then add `@ljwei-stak/dsh-model-router@0.18.0`. Do not keep both entries installed: they share the internal plugin id `model-router-galgame` and tool names. The retained id lets existing router settings and history carry over.
 
 For the combined 0.11.x package, back up the profile and export the GAL saves you want to preserve before upgrading. Story playback, artwork, music and saves now belong to the independent `@ljwei-stak/dsh-galgame` package. The detailed save limitations are in [MIGRATION.md](docs/archive/MIGRATION.md).
 
@@ -151,9 +153,16 @@ Installers use fixed official npm packages at each vendor's `@latest`, the vendo
 
 **Unified install settings.** The top of the **官方工具** page (also in the plugin settings form) sets the install address for every tool at once: one install directory (empty means each vendor's default location), an npm source, and per-tool overrides for vendor installer-script mirrors. Directories must be absolute; sources must be https. Each row picks its own install method from `npm`, `pnpm` or the vendor script (`curl | bash` or `irm | iex`); a method that cannot run on this platform says so on the row instead of being silently swapped. The exact command is shown above the buttons before anything runs.
 
-**Script installs never pipe remote content into an interpreter.** The plugin downloads the vendor script, checks it is still that vendor's official installer (vendor markers required, HTML pages and other vendors' scripts refused), and runs the local copy. A mirror may rehost the same script; it may not substitute a different program. Step Code's script accepts an install directory; the OpenCode script hardcodes `~/.opencode/bin`, so a custom directory only applies to it through npm/pnpm's `--prefix`. Script installs can be switched off entirely, leaving only the package managers.
+**Script installs never pipe remote content into an interpreter.** The plugin downloads the vendor script, checks it is still that vendor's official installer (vendor markers required, HTML pages and other vendors' scripts refused), and runs the local copy. A mirror may rehost the same script; it may not substitute a different program. Step Code's script accepts an install directory; the OpenCode script hardcodes `~/.opencode/bin`, so a custom directory only applies to it through the package managers' configured global directories. Script installs can be switched off entirely, leaving only the package managers.
+
+
+**Update destination.** Click **保存安装设置** after changing the shared directory or sources. Tool actions wait until saving and command refresh finish. npm uses `--prefix`; pnpm uses its own `global-dir`, `global-bin-dir` and store settings. Install jobs retain the chosen configuration even if another settings page changes it while they are queued. Updates check the selected command directory, so a different current copy on PATH cannot make a missing target look installed. Vendor scripts with fixed paths explain their actual destination; ZCode still requires directory selection in its signed installer window.
+
+The [workbench guide](./docs/WORKBENCH_USER_GUIDE.zh.md#厂商安装渠道) lists each vendor’s actual channels and native-install execution limits.
+
+With no shared directory, ordinary checks discover the selected manager's packages on PATH. An install, update, repair or removal job resolves and locks that manager's default global destination before comparing versions. If that destination cannot be resolved safely, set and save a shared directory first.
 
-**One-click repair and uninstall.** Repair re-runs the same fixed official command, which is what a broken install needs even when it already reports the latest version. Uninstall removes only the program: a package-manager install goes back through the same manager, and a script install deletes just the executable the vendor installer placed plus that install's own PATH entry in the shell profile. **Configuration, credentials and session history are always kept.**
+**One-click repair and uninstall.** Repair re-runs the same fixed official command, which is what a broken install needs even when it already reports the latest version. Uninstall removes only the program: a package-manager install goes back through the same manager, and a script install removes its registered command entries and supported PATH records; vendor version directories may remain. The Windows Codex native directory junction has no generic delete-based uninstall. The row explains this limitation. **Configuration, credentials and session history are always kept.**
 
 Installation, trusted launch readiness, account login and model entitlement are separate checks. An unknown login status is not proof of logout. On Windows, supported managed launch entries are checked against publisher signatures or official npm-tarball attestations; ZCode also records trust for its bundled script per signed build. See [the registry](.dsh-plugin/shared/official-tool-registry.mjs) and [executor](.dsh-plugin/shared/official-tool-executor.mjs) for the exact platform rules.
 

package/README.zh.md

@@ -1,9 +1,11 @@
 # Model Router · DeepSeek Harness 模型路由插件
 
-版本：**0.16.4**。选模求解器概览见[路由研究说明](docs/ROUTING_RESEARCH.zh.md)；公式、条件证明与实验见[数学推导与实验记录](docs/ROUTING_DERIVATION_EXPERIMENTS.zh.md)。[LiveBench 最新证据与验证协议](docs/ROUTING_LIVEBENCH_VALIDATION.zh.md)已核查 2026-06-25 聚合评分/费用；最新逐题质量—费用矩阵尚未取得，不声称真实路由收益。
+版本：**0.18.0**。选模求解器概览见[路由研究说明](docs/ROUTING_RESEARCH.zh.md)；公式、条件证明与实验见[数学推导与实验记录](docs/ROUTING_DERIVATION_EXPERIMENTS.zh.md)。[LiveBench 最新证据与验证协议](docs/ROUTING_LIVEBENCH_VALIDATION.zh.md)已核查 2026-06-25 聚合评分/费用；最新逐题质量—费用矩阵尚未取得，不声称真实路由收益。
 
 为 **DeepSeek Harness Desktop** 提供任务规划、成本感知的模型分配和官方工具执行工作台。输入任务，比较已配置模型，审阅计划，再明确选择是否执行。
 
+**0.18.0**：补齐厂商提供的 curl/irm 安装方式，安装与更新复用已保存的目录、方式和下载源，并核验目标目录里的版本。修复 MiniMax 官方 PowerShell 脚本以 `<# ... #>` 帮助注释开头时被误判为 HTML 的问题。统一安装设置改为明确保存后生效。
+
 **0.16.4**：PATH 探测在没有安装日志回调时也会保留命令输出。0.16.3 把 stdout 写进了 `onOutput?.(...)`，`where` 和 `--version` 因此变成空字符串，PATH 上的 CLI 全被报成未安装。MiniMax 与 ZCode 不走这条探测，所以仍能显示。
 
 **0.16.3**：恢复全部官方工具卡片的检测和安装。Windows 上的探测与 `npm` 再次按独立参数启动，避免 cmd 把 Node 指到不存在的脚本。只要输出版本号就视为已安装；单张卡片的检测错误留在该行；已经是最新版的 CLI 不再被收成「修复官方执行入口」。
@@ -14,7 +16,7 @@
 
 **0.16.0 新增**：[动态数据与持续反馈](docs/ROUTING_ADAPTIVE_LEARNING.zh.md)：可选公开价格/LiveBench快照刷新；按任务类型、时间衰减和低样本收缩调整个人偏好，质量门槛独立保留。设置在“预算与安全”，公开源默认关闭；价格源需提供按官方文档核对的固定USD单价JSON，不是通用官网抓价器。本地DSH_HOME共享、最近200运行窗口，暂无真实收益证明。
 
-当前版本为 **0.16.4**，包名为 `@ljwei-stak/dsh-model-router`；声明兼容的宿主为 **DeepSeek Harness Desktop 0.2.0-rc.1 / 0.2.0-rc.2**。自 0.12.0 起，路由与 [GAL](https://github.com/Alice-Marx/deepseek-harness-galgame) 已拆成两个独立插件。
+当前版本为 **0.18.0**，包名为 `@ljwei-stak/dsh-model-router`；声明兼容的宿主为 **DeepSeek Harness Desktop 0.2.0-rc.1 / 0.2.0-rc.2**。自 0.12.0 起，路由与 [GAL](https://github.com/Alice-Marx/deepseek-harness-galgame) 已拆成两个独立插件。
 
 **0.15.0 更新**：工作台分为四页，路由建议紧接任务规划展示；执行输入变化时丢弃旧预览；裁剪历史或重试后仍保留费用累计；源码开发新增独立模拟 UI 预览。
 
@@ -31,7 +33,7 @@
 | 路由方案 | 省钱优先、均衡、效果优先；按质量门槛、预估 token 成本与有限组合搜索分配模型。未知价格保持未知。 |
 | 只读执行 | 工作台先预览、再确认执行；也可在官方会话调用工具。支持的无界面 CLI 或模型目录 API 返回结果并留存记录。 |
 | 可编辑执行 | 通过官方会话启动单个 CLI 或顺序 CLI 团队，经审批在独立 Git 工作树修改，满足条件后整合补丁。 |
-| 官方工具 | 八个固定注册表工具的检测、安装/更新、可信入口与登录体检；安装有日志和取消操作。 |
+| 官方工具 | 十个固定注册表工具的检测、安装/更新、可信入口与登录体检；安装有日志和取消操作。 |
 | 交互终端 | 系统终端/PowerShell 与七个 CLI，含固定登录命令、多会话和实时输出。 |
 | 成本与订阅 | 每日/月度预算检查、自动尝试省钱方案或暂停、订阅优先、额度冷却，以及其他订阅失败的确认流程。 |
 | 执行与质量记录 | 逐工作包结果、依赖图、失败详情、重跑/改派、用户评价与可选强模型复核。 |
@@ -46,16 +48,16 @@
 打开 **插件 → 添加插件**，填写：
 
 ```text
-@ljwei-stak/dsh-model-router@0.16.4
+@ljwei-stak/dsh-model-router@0.18.0
 ```
 
-镜像缺少该精确版本时使用官方 HTTPS npm 源 `https://registry.npmjs.org/`。安装并启用后，完全退出 Harness（包括托盘进程）再启动。插件详情应显示 **0.16.4**，侧栏出现**模型路由**。仅运行全局 `npm install -g` 不会把插件注册到桌面版 profile。
+镜像缺少该精确版本时使用官方 HTTPS npm 源 `https://registry.npmjs.org/`。安装并启用后，完全退出 Harness（包括托盘进程）再启动。插件详情应显示 **0.18.0**，侧栏出现**模型路由**。仅运行全局 `npm install -g` 不会把插件注册到桌面版 profile。
 
 也可在插件管理器填写本地 `.tgz` 文件的绝对路径，或解压后的内层 `package` 目录；其中应包含 `package.json` 与 `.dsh-plugin`。[历史发布页](https://github.com/Alice-Marx/dsh-model-router/releases)提供归档；已克隆源码的开发方式见下文。
 
 ### 从旧包名升级
 
-`@ljwei-stak/model-router-galgame` 的最后版本为 0.13.0。保留 profile 与应用数据，移除旧插件条目，再添加 `@ljwei-stak/dsh-model-router@0.16.4`。不要同时安装两个包：它们共用内部插件 id `model-router-galgame` 与工具名；id 保留使已有路由设置和执行历史能够延续。
+`@ljwei-stak/model-router-galgame` 的最后版本为 0.13.0。保留 profile 与应用数据，移除旧插件条目，再添加 `@ljwei-stak/dsh-model-router@0.18.0`。不要同时安装两个包：它们共用内部插件 id `model-router-galgame` 与工具名；id 保留使已有路由设置和执行历史能够延续。
 
 从 0.11.x 合并版迁移时，先备份 profile 并导出希望保留的 GAL 进度。剧情、立绘、音乐、自由模式和存档属于独立 `@ljwei-stak/dsh-galgame` 插件。导出范围及同 profile 迁移的限制见 [MIGRATION.md](docs/archive/MIGRATION.md)。
 
@@ -151,9 +153,16 @@ CLI 团队是插件自有的顺序依赖执行器。Harness 内建 Agent Teams
 
 **统一安装设置。** 在**官方工具**页顶部（或插件设置页）可以一次设定所有工具的安装目录与下载源：统一安装目录（留空=各厂商默认位置）、npm 源地址，以及按工具 ID 覆盖厂商安装脚本的镜像地址。目录必须是绝对路径，下载地址必须是 https。每个工具都可以在**安装方式**下拉框里单独选择 `npm`、`pnpm`、厂商安装脚本（`curl | bash` 或 `irm | iex`）；选了某个平台不支持的方式时，行内会写明原因而不是悄悄换成别的。每行上方实时显示将要执行的完整命令。
 
-**脚本方式不会把远程内容直接管道给解释器。** 插件先下载厂商安装脚本、核对它仍然是该厂商的官方脚本（校验厂商标记、拒绝 HTML 页面和其他厂商的脚本），再执行本地副本。镜像可以重新托管同一个脚本，但不能替换成别的程序。阶跃的脚本还支持安装目录参数，OpenCode 的官方脚本写死了 `~/.opencode/bin`，因此自定义安装目录对它只能通过 npm/pnpm 的 `--prefix` 生效。脚本方式可以整体关闭，只保留包管理器方式。
+**脚本方式不会把远程内容直接管道给解释器。** 插件先下载厂商安装脚本、核对它仍然是该厂商的官方脚本（校验厂商标记、拒绝 HTML 页面和其他厂商的脚本），再执行本地副本。镜像可以重新托管同一个脚本，但不能替换成别的程序。阶跃的脚本还支持安装目录参数，OpenCode 的官方脚本写死了 `~/.opencode/bin`，因此自定义安装目录对它只能通过 npm/pnpm 的全局目录参数 生效。脚本方式可以整体关闭，只保留包管理器方式。
+
+
+**更新位置。** 修改统一目录或下载源后，点击**保存安装设置**。保存和命令刷新完成前，安装与更新暂不可用。npm 使用 `--prefix`；pnpm 使用自身的全局包目录、命令目录和存储目录。排队中的任务保留点击时的配置快照。更新优先核验所选目录中的命令，避免 PATH 上另一份最新版让目标安装被误判为已完成。厂商固定目录的脚本会说明实际位置；ZCode 仍需在官方安装窗口选择目录。
+
+完整渠道与原生安装执行限制见[工作台指南](./docs/WORKBENCH_USER_GUIDE.zh.md#厂商安装渠道)。
+
+未设统一目录时，普通体检会从 PATH 发现所选管理器的安装；安装、更新、修复和卸载任务则先确定并锁定该管理器的默认全局目录，再比较版本。无法可靠确定默认目录时，请先填写并保存统一目录。
 
-**一键修复与一键卸载。** 修复会用同一条固定官方命令重新安装一遍，适合修复损坏或不完整的安装；卸载只删除程序本身——包管理器安装走同一个管理器卸载，脚本安装只删除厂商安装器放下的那一个可执行文件，并顺带清掉它在 shell 配置里写的 PATH 记录。**配置、登录信息和历史记录一律保留**，重新安装后仍在。
+**一键修复与一键卸载。** 修复会用同一条固定官方命令重新安装一遍，适合修复损坏或不完整的安装；卸载只删除程序本身——包管理器安装走同一个管理器卸载，脚本安装移除登记的命令入口，并按厂商支持清理 PATH 记录，可能保留版本目录。Windows Codex 原生目录联接不使用通用删除卸载，界面会给出说明。**配置、登录信息和历史记录一律保留**，重新安装后仍在。
 
 **已安装、可信入口就绪、账号已登录、模型有权限是不同状态。** 登录未知不代表已退出。在 Windows，托管入口按发布者签名或官方 npm tarball 校验；ZCode 另对签名构建中的脚本记录首次信任摘要。平台细则见[注册表](.dsh-plugin/shared/official-tool-registry.mjs)和[执行器](.dsh-plugin/shared/official-tool-executor.mjs)。