@wwkit/opm 1.0.21 → 1.0.23

package/src/managers/node.js

@@ -1,117 +1,305 @@
 /**
- * node（Node.js）版本管理器实现（基于 nvm）
+ * node（Node.js）版本管理器实现（基于 mise）
  *
- * 通过 nvm CLI 管理多个 Node.js 版本。nvm 是 shell function，需通过
- * bash -c 'source $NVM_DIR/nvm.sh && nvm ...' 调用。
+ * 通过 mise CLI 管理多个 Node.js 版本。mise 是原生跨平台二进制（Rust），
+ * 非 shell function，直接调用即可（无需 bash）。
  *
- * 源查询使用 nvm ls-remote，本地查询使用 nvm ls。
- * 镜像通过 NVM_NODEJS_ORG_MIRROR 环境变量传递给 nvm install。
+ * 源查询使用 mise ls-remote node，本地查询使用 mise ls node --json（机器可读）。
+ * 镜像通过 MISE_NODE_MIRROR_URL 环境变量传递给 mise（node 后端 mirror_url）。
+ * proxy 通过 HTTP(S)_PROXY 环境变量传递（RuntimeManager._buildEnv 已处理）。
  */
 
 import fs from 'node:fs'
 import path from 'node:path'
 import os from 'node:os'
-import { execSync } from 'node:child_process'
+import { execSync, spawnSync } from 'node:child_process'
 import { RuntimeManager } from './runtime.js'
-import { Shell } from '@wwkit/shared'
-import { getActiveRegistry } from '../config.js'
+import { downloadToFile, fetchText } from '@wwkit/shared'
+import { getConfig } from '../config.js'
 
-const shell = new Shell()
+/** mise 官方 release 下载 base URL（config mise.registry.active 覆盖） */
+const MISE_DEFAULT_BASE = 'https://github.com/jdx/mise/releases/download'
+/** 单次下载超时（mise 二进制约 20MB，镜像下载较慢，给足余量） */
+const MISE_DOWNLOAD_TIMEOUT = 180000
+
+/** 平台名映射（mise release 资产命名：windows / linux / macos） */
+const MISE_PLATFORM = { win32: 'windows', linux: 'linux', darwin: 'macos' }
 
 /**
- * 获取 nvm 目录
+ * 获取 mise 安装目录（~/.local/bin，跨平台与 uv 一致）
  * @returns {string}
  */
-function getNvmDir() {
-  return process.env.NVM_DIR || path.join(os.homedir(), '.nvm')
+export function getMiseInstallDir() {
+  return path.join(os.homedir(), '.local', 'bin')
 }
 
 /**
- * 获取 nvm.sh 路径
+ * 获取 mise 二进制路径（优先 ~/.local/bin，否则依赖 PATH）
  * @returns {string}
  */
-export function getNvmSh() {
-  return path.join(getNvmDir(), 'nvm.sh')
+export function getMiseBin() {
+  const name = process.platform === 'win32' ? 'mise.exe' : 'mise'
+  const local = path.join(getMiseInstallDir(), name)
+  if (fs.existsSync(local)) return local
+  return 'mise'
 }
 
 /**
- * 检查 nvm 是否已安装
+ * 检查 mise 是否已安装
  * @returns {boolean}
  */
-export function isNvmInstalled() {
-  return fs.existsSync(getNvmSh())
+export function isMiseInstalled() {
+  try {
+    execSync(`${getMiseBin()} --version`, { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] })
+    return true
+  } catch {
+    return false
+  }
+}
+
+/**
+ * 获取 mise 最新版本号
+ * 优先 npm registry 镜像（快且稳，走配置的 npm 镜像），回退 GitHub API。
+ * @param {string} [proxy]
+ * @returns {Promise<string>} 版本号（如 2026.9.13）；获取失败返回空串
+ * @private
+ */
+async function _latestMiseVersion(proxy) {
+  try {
+    const out = execSync('npm view mise version', {
+      encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'], timeout: 30000,
+    })
+    const v = out.trim()
+    if (v) return v
+  } catch {}
+  try {
+    const text = await fetchText('https://api.github.com/repos/jdx/mise/releases/latest', { proxy })
+    const data = JSON.parse(text)
+    return (data.tag_name || '').replace(/^v/, '')
+  } catch {}
+  return ''
+}
+
+/**
+ * 构造 mise release 资产 URL：<base>/v<version>/mise-v<version>-<platform>-<arch>[.exe]
+ * @param {string} version
+ * @param {string} base
+ * @returns {string}
+ * @private
+ */
+function _miseAssetUrl(version, base) {
+  const platform = MISE_PLATFORM[process.platform] || process.platform
+  const arch = process.arch
+  const ext = process.platform === 'win32' ? '.exe' : ''
+  return `${base}/v${version}/mise-v${version}-${platform}-${arch}${ext}`
+}
+
+/**
+ * 生成 mise release 下载 base 尝试顺序：active → 其余预设（去重） → official
+ * @returns {string[]}
+ * @private
+ */
+function _miseBases() {
+  const reg = getConfig().mise?.registry || {}
+  const ordered = []
+  const add = (u) => { if (u && !ordered.includes(u)) ordered.push(u) }
+  const active = reg.active ? (reg[reg.active] || reg.active) : ''
+  add(active)
+  for (const [key, url] of Object.entries(reg)) {
+    if (key === 'active') continue
+    add(url)
+  }
+  add(MISE_DEFAULT_BASE)
+  return ordered
 }
 
 /**
- * 安装 nvm（git clone + 写 shell profile）
+ * 安装 mise（下载官方 GitHub release 二进制；npm 分发在 Windows 上不可用，故直接用 release 资产）
+ *
+ * 镜像：config mise.registry 预设，依次尝试 active → 其余预设 → official，
+ *      首个下载成功即停（自动回退到可用镜像，如 ghproxy.net）；
+ * proxy：downloadToFile 走 opts.proxy。
+ * 下载到 ~/.local/bin/mise[.exe]，Unix 下 chmod +x。
  * @param {string} [proxy] - 代理地址
- * @returns {{ action: string, profile: string, hint: string }}
+ * @returns {Promise<{ action: string, version: string, path: string, base: string, hint: string }>}
  */
-export function installNvm(proxy) {
-  const mirror = getActiveRegistry('nvm')
-  const nvmDir = getNvmDir()
-  const env = { ...process.env }
-  if (proxy) {
-    env.http_proxy = proxy
-    env.https_proxy = proxy
+export async function installMise(proxy) {
+  const version = await _latestMiseVersion(proxy)
+  if (!version) {
+    throw new Error('mise: 无法获取最新版本（npm registry 与 GitHub API 均不可用）')
   }
-  execSync(`git clone "${mirror}" "${nvmDir}"`, { stdio: shell.stdioForExec(true), shell: shell.resolveBash(), env })
-  const lines = [
-    `export NVM_DIR="${nvmDir}"`,
-    `[ -s "\\$NVM_DIR/nvm.sh" ] && \\. "\\$NVM_DIR/nvm.sh"`,
-  ]
-  const wroteProfile = shell.writeProfile('NVM_DIR', 'nvm', lines)
-  return {
-    action: 'installed',
-    profile: wroteProfile ? shell.getProfile() : '(already configured)',
-    hint: `Restart shell or run: source "${path.join(nvmDir, 'nvm.sh')}"`,
+  const binDir = getMiseInstallDir()
+  const binPath = path.join(binDir, process.platform === 'win32' ? 'mise.exe' : 'mise')
+  fs.mkdirSync(binDir, { recursive: true })
+
+  const bases = _miseBases()
+  let lastError = null
+  for (const base of bases) {
+    const url = _miseAssetUrl(version, base)
+    try {
+      fs.rmSync(binPath, { force: true })
+      await downloadToFile(url, binPath, { proxy, timeout: MISE_DOWNLOAD_TIMEOUT })
+      if (process.platform !== 'win32') {
+        fs.chmodSync(binPath, 0o755)
+      }
+      return {
+        action: 'installed',
+        version,
+        path: binPath,
+        base,
+        hint: `mise ${version} installed at ${binPath} (source: ${base}); ensure ${binDir} is on PATH`,
+      }
+    } catch (err) {
+      lastError = err
+      fs.rmSync(binPath, { force: true })
+    }
+  }
+  throw new Error(`mise: 所有下载源均失败，最后错误: ${lastError ? lastError.message : 'unknown'}`)
+}
+
+/**
+ * 读取系统 PATH（HKLM，Windows）
+ *
+ * 用 spawnSync 数组参数直调 reg（不经 cmd），避免 cmd 对值中 %VAR% 的展开与引号问题。
+ * @param {Function} [spawnSyncImpl] - 可注入的 spawnSync（测试用）
+ * @returns {string} 系统 PATH 字符串；读取失败返回空串
+ */
+export function getSystemPath(spawnSyncImpl = spawnSync) {
+  try {
+    const r = spawnSyncImpl(
+      'reg', ['query', 'HKLM\\SYSTEM\\CurrentControlSet\\Control\\Session Manager\\Environment', '/v', 'Path'],
+      { encoding: 'utf8' }
+    )
+    if (r.status !== 0) return ''
+    const m = String(r.stdout || '').match(/^\s*Path\s+REG_\w+\s+(.*)$/m)
+    return m ? m[1].trim() : ''
+  } catch {
+    return ''
   }
 }
 
 /**
- * 解析 nvm ls 输出为已安装版本列表
+ * 检测系统 PATH（HKLM）中是否含 node.exe 的目录（Windows）
+ *
+ * Windows 新进程 PATH = 系统 PATH + 用户 PATH，系统 PATH 优先。若系统 PATH 有
+ * 旧版 node（如 D:\library\nodejs\node.exe），会抢先于用户 PATH 的 mise shims，
+ * 导致新终端中 node 仍是旧版。返回该目录路径；无冲突返回空串。
+ * @param {Function} [spawnSyncImpl] - 可注入的 spawnSync（测试用）
+ * @returns {string}
+ */
+export function detectSystemNodeConflict(spawnSyncImpl = spawnSync) {
+  if (process.platform !== 'win32') return ''
+  const sysPath = getSystemPath(spawnSyncImpl)
+  for (const entry of sysPath.split(';')) {
+    const dir = entry.trim()
+    if (!dir) continue
+    try {
+      if (fs.existsSync(path.join(dir, 'node.exe'))) return dir
+    } catch {}
+  }
+  return ''
+}
+
+/**
+ * 把指定目录前置到系统 PATH（HKLM，Windows，幂等）
+ *
+ * 已在系统 PATH 则移到最前（不重复）；写回保留 REG_EXPAND_SZ 类型。
+ * 用 spawnSync 数组参数直调 reg（不经 cmd），避免系统 PATH 中的 %VAR% 被
+ * cmd 先行展开（写回会丢失变量引用）及引号破坏命令。
+ * 写 HKLM 需管理员权限，失败（Access denied 等）返回 false，由调用方决定提示策略。
+ * @param {string[]} dirs - 需前置的目录（按序前置，最后一个在最前）
+ * @param {Function} [spawnSyncImpl] - 可注入的 spawnSync（测试用）
+ * @returns {boolean} 是否写入成功
+ */
+export function prependSystemPathDirs(dirs, spawnSyncImpl = spawnSync) {
+  const sysPath = getSystemPath(spawnSyncImpl)
+  if (!sysPath) return false
+  const key = (e) => String(e || '').replace(/[\\/]+$/, '').toLowerCase()
+  let entries = sysPath.split(';').map((e) => e.trim()).filter(Boolean)
+  for (const d of dirs) {
+    const needle = key(d)
+    entries = entries.filter((e) => key(e) !== needle)
+    entries.unshift(d)
+  }
+  try {
+    const r = spawnSyncImpl(
+      'reg', ['add', 'HKLM\\SYSTEM\\CurrentControlSet\\Control\\Session Manager\\Environment',
+        '/v', 'Path', '/t', 'REG_EXPAND_SZ', '/d', entries.join(';'), '/f'],
+      { encoding: 'utf8' }
+    )
+    return r.status === 0
+  } catch {
+    return false
+  }
+}
+
+/**
+ * 解析 mise ls node --json 输出为已安装版本列表
+ * 输出为 JSON 数组，每项含 version / requested_version / install_path / installed / active。
  * @param {string} out
  * @returns {{ name: string, version: string, current: boolean }[]}
  */
-export function parseNvmInstalled(out) {
+export function parseMiseInstalled(out) {
+  let records
+  try {
+    records = JSON.parse(out)
+  } catch {
+    return []
+  }
+  if (!Array.isArray(records)) return []
   const items = []
-  for (const line of out.split('\n')) {
-    const m = line.match(/^(->)?\s*v(\d+\.\d+\.\d+)\b/)
-    if (m) {
-      items.push({ name: `v${m[2]}`, version: m[2], current: !!m[1] })
-    }
+  for (const rec of records) {
+    if (!rec || typeof rec.version !== 'string') continue
+    if (rec.installed === false) continue
+    const version = rec.version.replace(/^v/, '')
+    items.push({ name: `v${version}`, version, current: !!rec.active })
   }
   return items
 }
 
+/**
+ * 解析 mise ls-remote node 输出为可用版本列表
+ * 输出为文本，每行一个版本（如 v24.21.0）。
+ * @param {string} out
+ * @returns {string[]}
+ */
+export function parseMiseRemote(out) {
+  const versions = []
+  for (const line of out.split('\n')) {
+    const m = line.trim().match(/^v?(\d+\.\d+\.\d+)$/)
+    if (m) versions.push(`v${m[1]}`)
+  }
+  return versions
+}
+
 export class NodeManager extends RuntimeManager {
   constructor() {
     super({
       name: 'node',
-      mirrorEnv: 'NVM_NODEJS_ORG_MIRROR',
-      prefix: `source "${getNvmSh()}" && nvm`,
-      needsBash: true,
-      isInstalled: () => isNvmInstalled(),
-      installTool: () => installNvm(),
-      toolName: 'nvm',
-      toolMissingMsg: 'nvm not installed, run `opm nvm install` first',
-      listCmd: ['ls', '--no-colors'],
-      listRemoteCmd: ['ls-remote', '--no-colors'],
-      currentCmd: ['current'],
+      mirrorEnv: 'MISE_NODE_MIRROR_URL',
+      prefix: getMiseBin(),
+      needsBash: false,
+      isInstalled: () => isMiseInstalled(),
+      installTool: () => installMise(),
+      toolName: 'mise',
+      toolMissingMsg: 'mise not installed, run `opm mise install` first',
+      listCmd: ['ls', 'node', '--json'],
+      listRemoteCmd: ['ls-remote', 'node'],
+      currentCmd: ['current', 'node'],
       parseCurrent: (out) => {
-        const c = out.trim()
+        const c = out.trim().replace(/^v/, '')
         return c && c !== 'system' && c !== 'none' ? c : ''
       },
-      installCmd: (v) => ['install', v],
-      uninstallCmd: (n) => ['uninstall', n.startsWith('v') ? n : `v${n}`],
+      installCmd: (v) => ['install', `node@${v}`],
+      uninstallCmd: (n) => ['uninstall', `node@${n.startsWith('v') ? n.slice(1) : n}`],
       resultName: (v) => `v${v}`,
-      upgradeLts: ['install', '--lts'],
-      useCmd: (v) => ['use', v],
-      useAction: 'switched',
-      defaultCmd: (v) => ['alias', 'default', v],
-      noCacheMsg: 'no cache for nvm-managed node',
-      installUsage: 'Usage: opm node install <version> (e.g. 18, 20, v24.19.0, --lts)',
-      notInstalledHint: 'nvm not installed or no node version active, run `opm nvm install` and `opm node install <version>`',
+      upgradeLts: ['install', 'node@lts'],
+      useCmd: (v) => ['use', '-g', `node@${v}`],
+      useAction: 'switched (global)',
+      defaultCmd: (v) => ['use', '-g', `node@${v}`],
+      noCacheMsg: 'no cache for mise-managed node',
+      installUsage: 'Usage: opm node install <version> (e.g. 20, 24, v24.19.0, --lts)',
+      notInstalledHint: 'mise not installed or no node version active, run `opm mise install` and `opm node install <version>`',
       upgradeNoVersionMsg: 'No Node.js version available to upgrade to',
       info: {
         description: 'Node.js JavaScript runtime',
@@ -129,37 +317,34 @@ export class NodeManager extends RuntimeManager {
    */
   getInstallDir() {
     try {
-      const out = this._exec(['which', 'current'], { allowNonZero: true }).trim()
-      if (!out || out === 'system' || out === 'none') return ''
-      return path.dirname(path.dirname(out))
+      const out = this._exec(['ls', 'node', '--json'], { allowNonZero: true })
+      const items = parseMiseInstalled(out)
+      const current = items.find((i) => i.current)
+      if (current) {
+        const rec = JSON.parse(out).find((r) => r.version.replace(/^v/, '') === current.version)
+        if (rec && rec.install_path) return rec.install_path
+      }
     } catch {}
     return ''
   }
 
   /**
-   * 解析 nvm ls 输出为已安装版本列表
+   * 解析 mise ls node --json 输出为已安装版本列表
    * @param {string} out
    * @returns {{ name: string, version: string, current: boolean }[]}
    * @private
    */
   _parseInstalled(out) {
-    return parseNvmInstalled(out)
+    return parseMiseInstalled(out)
   }
 
   /**
-   * 解析 nvm ls-remote 输出为可用版本列表
+   * 解析 mise ls-remote node 输出为可用版本列表
    * @param {string} out
    * @returns {string[]}
    * @private
    */
   _parseRemote(out) {
-    const versions = []
-    for (const line of out.split('\n')) {
-      const m = line.match(/^\s*(->)?\s*v(\d+\.\d+\.\d+)\b/)
-      if (m) {
-        versions.push(`v${m[2]}`)
-      }
-    }
-    return versions
+    return parseMiseRemote(out)
   }
 }

package/src/managers/runtime.js

@@ -1,7 +1,7 @@
 /**
  * 运行时版本管理器基类（node / php / python 共用）
  *
- * 三个运行时均通过底层版本管理工具（nvm / phpenv / uv）管理多版本，
+ * 三个运行时均通过底层版本管理工具（mise / phpenv / uv）管理多版本，
  * 接口一致（registry/search/view/info/versions/list/install/uninstall/upgrade/use/current/default）。
  * 差异（命令前缀、镜像环境变量、动作命令参数、解析函数）通过 cfg 配置注入；
  * 解析函数由子类实现。python 的 getVersion/currentVersion/setDefault 等差异较大，
@@ -19,8 +19,8 @@ const shell = new Shell()
  * @typedef {Object} RuntimeConfig
  * @property {string} name
  * @property {string} mirrorEnv - dist 镜像环境变量名
- * @property {string} prefix - 工具调用前缀（如 `source ".../nvm.sh" && nvm`、bin 路径）
- * @property {boolean} [needsBash=false] - 命令是否需要 bash（nvm source / phpenv 脚本）；原生二进制（uv）为 false
+ * @property {string} prefix - 工具调用前缀（如 `mise`、`source ".../phpenv"`、bin 路径）
+ * @property {boolean} [needsBash=false] - 命令是否需要 bash（phpenv 脚本）；mise/uv 原生二进制为 false
  * @property {() => boolean} isInstalled
  * @property {string} toolMissingMsg
  * @property {string[]} listCmd - 列出已安装版本的参数
@@ -243,7 +243,7 @@ export class RuntimeManager extends PackageManager {
     }
     if (!this.cfg.isInstalled() && this.cfg.installTool) {
       console.log(`[opm] ${this.cfg.toolName} not installed, auto-installing...`)
-      this.cfg.installTool()
+      await this.cfg.installTool()
     }
     this._execInherit(this.cfg.installCmd(version), { proxy: opts.proxy })
     return { name: this.cfg.resultName(version), version, action: 'installed' }

package/src/presets.js

@@ -14,7 +14,6 @@ export const APT_PRESETS = _getPresets('apt')
 export const BREW_PRESETS = _getPresets('brew')
 export const COMPOSER_PRESETS = _getPresets('composer')
 export const BUN_PRESETS = _getPresets('bun')
-export const NVM_PRESETS = _getPresets('nvm')
 export const NODE_PRESETS = _getPresets('node')
 export const PHPENV_PRESETS = _getPresets('phpenv')
 export const PHP_PRESETS = _getPresets('php')