@wwkit/opm 1.0.21 → 1.0.23

package/docs/managers/mise.md

@@ -0,0 +1,38 @@
+# mise 命令对照表
+
+`@wwkit/opm` 统一命令管理 mise 自身（安装/升级/卸载）。
+
+mise 通过官方 GitHub release 二进制安装（npm 分发的 preinstall 引用的 platform 包在 Windows 上不可用，故不采用）。下载源依次尝试 `active` → 其余预设 → `official`，自动回退到可用镜像（如 `ghproxy.net`）。
+
+## 命令对照
+
+| 统一命令 | 原始命令 | 说明 |
+|---------|---------|------|
+| `opm mise version` | `mise --version` | 查看 mise 版本 |
+| `opm mise install` | `mise use -g node@<version>` | 安装 mise（下载官方 release 二进制到 `~/.local/bin`） |
+| `opm mise upgrade` | `mise self-update` | 更新 mise |
+| `opm mise uninstall` | `npm uninstall -g mise` + 清理数据目录 | 卸载 mise |
+| `opm mise dir` | 返回 `~/.local/bin/mise` | 显示二进制路径 |
+| `opm mise list` | `mise ls --json` | 列出已安装的工具版本 |
+
+## 下载镜像预设
+
+| 预设名 | 地址 |
+|--------|------|
+| `official` | `https://github.com/jdx/mise/releases/download` |
+| `ghproxy` | `https://ghproxy.com/https://github.com/jdx/mise/releases/download` |
+| `gh-proxy` | `https://ghproxy.net/https://github.com/jdx/mise/releases/download` |
+
+> 安装时按 `<base>/v<version>/mise-v<version>-<platform>-<arch>[.exe]` 下载二进制；
+> 依次尝试 `active` → 其余预设 → `official`，首个成功即停。
+
+## 示例
+
+```bash
+opm mise version
+opm mise install
+opm mise upgrade
+opm mise list
+opm mise dir
+opm mise uninstall
+```

package/docs/managers/node.md

@@ -1,25 +1,25 @@
 # node 命令对照表
 
-`@wwkit/opm` 统一命令通过 nvm 管理 Node.js 版本。
+`@wwkit/opm` 统一命令通过 mise 管理 Node.js 版本（mise 是原生跨平台二进制，无需 bash）。
 
 ## 命令对照
 
 | 统一命令 | 原始命令 | 说明 |
 |---------|---------|------|
-| `opm node version` | `nvm current` | 当前激活的 Node.js 版本 |
+| `opm node version` | `mise current node` | 当前激活的 Node.js 版本 |
 | `opm node registry` | 读 `~/.config/opm/config.json5` 的 `node.registry.active` | 查询 Node.js dist 镜像 |
-| `opm node registry set <url\|preset>` | 写 `~/.config/opm/config.json5` | 设置 Node.js dist 镜像（传给 `NVM_NODEJS_ORG_MIRROR`） |
+| `opm node registry set <url\|preset>` | 写 `~/.config/opm/config.json5` | 设置 Node.js dist 镜像（传给 `MISE_NODE_MIRROR_URL`） |
 | `opm node registry presets` | — | 列出可用镜像预设 |
-| `opm node search <version>` | `nvm ls-remote` 过滤 | 查询版本是否可下载 |
-| `opm node view <version>` | `nvm ls` 过滤 | 查询版本是否已安装 |
-| `opm node versions` | `nvm ls-remote` | 列出所有可用版本 |
-| `opm node list` | `nvm ls` | 列出已安装版本 |
-| `opm node install <version>` | `nvm install <version>` | 安装 Node.js 版本 |
-| `opm node uninstall <version>` | `nvm uninstall <version>` | 卸载 Node.js 版本 |
-| `opm node upgrade` | `nvm install --lts` | 安装最新 LTS |
-| `opm node use <version>` | `nvm use <version>` | 切换当前版本 |
-| `opm node current` | `nvm current` | 显示当前版本 |
-| `opm node default <version>` | `nvm alias default <version>` | 设置默认版本 |
+| `opm node search <version>` | `mise ls-remote node` 过滤 | 查询版本是否可下载 |
+| `opm node view <version>` | `mise ls node --json` 过滤 | 查询版本是否已安装 |
+| `opm node versions` | `mise ls-remote node` | 列出所有可用版本 |
+| `opm node list` | `mise ls node --json` | 列出已安装版本 |
+| `opm node install <version>` | `mise install node@<version>` | 安装 Node.js 版本 |
+| `opm node uninstall <version>` | `mise uninstall node@<version>` | 卸载 Node.js 版本 |
+| `opm node upgrade` | `mise install node@lts` | 安装最新 LTS |
+| `opm node use <version>` | `mise use -g node@<version>` | 切换全局版本 |
+| `opm node current` | `mise current node` | 显示当前版本 |
+| `opm node default <version>` | `mise use -g node@<version>` | 设置全局默认版本 |
 
 ## 镜像预设
 
@@ -29,7 +29,7 @@
 | `taobao` | `https://npmmirror.com/mirrors/node` |
 | `tsinghua` | `https://mirrors.tuna.tsinghua.edu.cn/nodejs-release/` |
 
-> 镜像通过 `NVM_NODEJS_ORG_MIRROR` 环境变量传递给 nvm install。
+> 镜像通过 `MISE_NODE_MIRROR_URL` 环境变量传递给 mise install。
 
 ## 示例
 
@@ -42,8 +42,8 @@ opm node install 20
 opm node install --lts
 opm node use 20
 opm node default 20
-opm node search v20.20.2
-opm node view v20.20.2
+opm node search v24.21.0
+opm node view v24.21.0
 opm node uninstall 18
 opm node upgrade
 ```

package/docs/opm.html

@@ -101,9 +101,9 @@
 <a class="menu-item" href="#" onclick="show('managers_config');return false;">config</a>
 <a class="menu-item" href="#" onclick="show('managers_dnf');return false;">dnf</a>
 <a class="menu-item" href="#" onclick="show('managers_git');return false;">git</a>
+<a class="menu-item" href="#" onclick="show('managers_mise');return false;">mise</a>
 <a class="menu-item" href="#" onclick="show('managers_node');return false;">node</a>
 <a class="menu-item" href="#" onclick="show('managers_npm');return false;">npm</a>
-<a class="menu-item" href="#" onclick="show('managers_nvm');return false;">nvm</a>
 <a class="menu-item" href="#" onclick="show('managers_php');return false;">php</a>
 <a class="menu-item" href="#" onclick="show('managers_phpenv');return false;">phpenv</a>
 <a class="menu-item" href="#" onclick="show('managers_pip');return false;">pip</a>
@@ -363,13 +363,28 @@ opm git export -d /path/to/repo    # 指定仓库目录
 # diff 导入
 opm git import changes-abc-to-def.diff  # 导入 diff 文件
 opm git import file.diff -d /repo       # 导入到指定仓库</code></pre></div>
+<div id="managers_mise" class="doc-content" style="display:none;"><h1>mise 命令对照表</h1>
+<p><code>@wwkit/opm</code> 统一命令管理 mise 自身（安装/升级/卸载）。</p>
+<p>mise 通过官方 GitHub release 二进制安装（npm 分发的 preinstall 引用的 platform 包在 Windows 上不可用，故不采用）。下载源依次尝试 <code>active</code> → 其余预设 → <code>official</code>，自动回退到可用镜像（如 <code>ghproxy.net</code>）。</p>
+<h2>命令对照</h2>
+<table><thead><tr><th>统一命令</th><th>原始命令</th><th>说明</th></tr></thead><tbody><tr><td><code>opm mise version</code></td><td><code>mise --version</code></td><td>查看 mise 版本</td></tr><tr><td><code>opm mise install</code></td><td><code>mise use -g node@&lt;version&gt;</code></td><td>安装 mise（下载官方 release 二进制到 <code>~/.local/bin</code>）</td></tr><tr><td><code>opm mise upgrade</code></td><td><code>mise self-update</code></td><td>更新 mise</td></tr><tr><td><code>opm mise uninstall</code></td><td><code>npm uninstall -g mise</code> + 清理数据目录</td><td>卸载 mise</td></tr><tr><td><code>opm mise dir</code></td><td>返回 <code>~/.local/bin/mise</code></td><td>显示二进制路径</td></tr><tr><td><code>opm mise list</code></td><td><code>mise ls --json</code></td><td>列出已安装的工具版本</td></tr></tbody></table>
+<h2>下载镜像预设</h2>
+<table><thead><tr><th>预设名</th><th>地址</th></tr></thead><tbody><tr><td><code>official</code></td><td><code>https://github.com/jdx/mise/releases/download</code></td></tr><tr><td><code>ghproxy</code></td><td><code>https://ghproxy.com/https://github.com/jdx/mise/releases/download</code></td></tr><tr><td><code>gh-proxy</code></td><td><code>https://ghproxy.net/https://github.com/jdx/mise/releases/download</code></td></tr></tbody></table>
+<blockquote>安装时按 <code>&lt;base&gt;/v&lt;version&gt;/mise-v&lt;version&gt;-&lt;platform&gt;-&lt;arch&gt;[.exe]</code> 下载二进制；<br>依次尝试 <code>active</code> → 其余预设 → <code>official</code>，首个成功即停。</blockquote>
+<h2>示例</h2>
+<pre><code class="lang-bash">opm mise version
+opm mise install
+opm mise upgrade
+opm mise list
+opm mise dir
+opm mise uninstall</code></pre></div>
 <div id="managers_node" class="doc-content" style="display:none;"><h1>node 命令对照表</h1>
-<p><code>@wwkit/opm</code> 统一命令通过 nvm 管理 Node.js 版本。</p>
+<p><code>@wwkit/opm</code> 统一命令通过 mise 管理 Node.js 版本（mise 是原生跨平台二进制，无需 bash）。</p>
 <h2>命令对照</h2>
-<table><thead><tr><th>统一命令</th><th>原始命令</th><th>说明</th></tr></thead><tbody><tr><td><code>opm node version</code></td><td><code>nvm current</code></td><td>当前激活的 Node.js 版本</td></tr><tr><td><code>opm node registry</code></td><td>读 <code>~/.config/opm/config.json5</code> 的 <code>node.registry.active</code></td><td>查询 Node.js dist 镜像</td></tr><tr><td><code>opm node registry set &lt;url|preset&gt;</code></td><td>写 <code>~/.config/opm/config.json5</code></td><td>设置 Node.js dist 镜像（传给 <code>NVM_NODEJS_ORG_MIRROR</code>）</td></tr><tr><td><code>opm node registry presets</code></td><td>—</td><td>列出可用镜像预设</td></tr><tr><td><code>opm node search &lt;version&gt;</code></td><td><code>nvm ls-remote</code> 过滤</td><td>查询版本是否可下载</td></tr><tr><td><code>opm node view &lt;version&gt;</code></td><td><code>nvm ls</code> 过滤</td><td>查询版本是否已安装</td></tr><tr><td><code>opm node versions</code></td><td><code>nvm ls-remote</code></td><td>列出所有可用版本</td></tr><tr><td><code>opm node list</code></td><td><code>nvm ls</code></td><td>列出已安装版本</td></tr><tr><td><code>opm node install &lt;version&gt;</code></td><td><code>nvm install &lt;version&gt;</code></td><td>安装 Node.js 版本</td></tr><tr><td><code>opm node uninstall &lt;version&gt;</code></td><td><code>nvm uninstall &lt;version&gt;</code></td><td>卸载 Node.js 版本</td></tr><tr><td><code>opm node upgrade</code></td><td><code>nvm install --lts</code></td><td>安装最新 LTS</td></tr><tr><td><code>opm node use &lt;version&gt;</code></td><td><code>nvm use &lt;version&gt;</code></td><td>切换当前版本</td></tr><tr><td><code>opm node current</code></td><td><code>nvm current</code></td><td>显示当前版本</td></tr><tr><td><code>opm node default &lt;version&gt;</code></td><td><code>nvm alias default &lt;version&gt;</code></td><td>设置默认版本</td></tr></tbody></table>
+<table><thead><tr><th>统一命令</th><th>原始命令</th><th>说明</th></tr></thead><tbody><tr><td><code>opm node version</code></td><td><code>mise current node</code></td><td>当前激活的 Node.js 版本</td></tr><tr><td><code>opm node registry</code></td><td>读 <code>~/.config/opm/config.json5</code> 的 <code>node.registry.active</code></td><td>查询 Node.js dist 镜像</td></tr><tr><td><code>opm node registry set &lt;url|preset&gt;</code></td><td>写 <code>~/.config/opm/config.json5</code></td><td>设置 Node.js dist 镜像（传给 <code>MISE_NODE_MIRROR_URL</code>）</td></tr><tr><td><code>opm node registry presets</code></td><td>—</td><td>列出可用镜像预设</td></tr><tr><td><code>opm node search &lt;version&gt;</code></td><td><code>mise ls-remote node</code> 过滤</td><td>查询版本是否可下载</td></tr><tr><td><code>opm node view &lt;version&gt;</code></td><td><code>mise ls node --json</code> 过滤</td><td>查询版本是否已安装</td></tr><tr><td><code>opm node versions</code></td><td><code>mise ls-remote node</code></td><td>列出所有可用版本</td></tr><tr><td><code>opm node list</code></td><td><code>mise ls node --json</code></td><td>列出已安装版本</td></tr><tr><td><code>opm node install &lt;version&gt;</code></td><td><code>mise install node@&lt;version&gt;</code></td><td>安装 Node.js 版本</td></tr><tr><td><code>opm node uninstall &lt;version&gt;</code></td><td><code>mise uninstall node@&lt;version&gt;</code></td><td>卸载 Node.js 版本</td></tr><tr><td><code>opm node upgrade</code></td><td><code>mise install node@lts</code></td><td>安装最新 LTS</td></tr><tr><td><code>opm node use &lt;version&gt;</code></td><td><code>mise use -g node@&lt;version&gt;</code></td><td>切换全局版本</td></tr><tr><td><code>opm node current</code></td><td><code>mise current node</code></td><td>显示当前版本</td></tr><tr><td><code>opm node default &lt;version&gt;</code></td><td><code>mise use -g node@&lt;version&gt;</code></td><td>设置全局默认版本</td></tr></tbody></table>
 <h2>镜像预设</h2>
 <table><thead><tr><th>预设名</th><th>地址</th></tr></thead><tbody><tr><td><code>official</code></td><td><code>https://nodejs.org/dist</code></td></tr><tr><td><code>taobao</code></td><td><code>https://npmmirror.com/mirrors/node</code></td></tr><tr><td><code>tsinghua</code></td><td><code>https://mirrors.tuna.tsinghua.edu.cn/nodejs-release/</code></td></tr></tbody></table>
-<blockquote>镜像通过 <code>NVM_NODEJS_ORG_MIRROR</code> 环境变量传递给 nvm install。</blockquote>
+<blockquote>镜像通过 <code>MISE_NODE_MIRROR_URL</code> 环境变量传递给 mise install。</blockquote>
 <h2>示例</h2>
 <pre><code class="lang-bash">opm node current
 opm node version
@@ -379,8 +394,8 @@ opm node install 20
 opm node install --lts
 opm node use 20
 opm node default 20
-opm node search v20.20.2
-opm node view v20.20.2
+opm node search v24.21.0
+opm node view v24.21.0
 opm node uninstall 18
 opm node upgrade</code></pre></div>
 <div id="managers_npm" class="doc-content" style="display:none;"><h1>npm 命令对照表</h1>
@@ -437,20 +452,6 @@ opm npm cache clean
 
 # 显示帮助
 opm npm help</code></pre></div>
-<div id="managers_nvm" class="doc-content" style="display:none;"><h1>nvm 命令对照表</h1>
-<p><code>@wwkit/opm</code> 统一命令管理 nvm 自身（安装/升级/卸载）。</p>
-<h2>命令对照</h2>
-<table><thead><tr><th>统一命令</th><th>原始命令</th><th>说明</th></tr></thead><tbody><tr><td><code>opm nvm version</code></td><td><code>nvm --version</code></td><td>查看 nvm 版本</td></tr><tr><td><code>opm nvm registry</code></td><td>读 <code>~/.config/opm/config.json5</code> 的 <code>nvm.registry.active</code></td><td>查询 nvm git 镜像</td></tr><tr><td><code>opm nvm registry set &lt;url|preset&gt;</code></td><td>写 <code>~/.config/opm/config.json5</code></td><td>设置 nvm git 镜像</td></tr><tr><td><code>opm nvm registry presets</code></td><td>—</td><td>列出可用镜像预设</td></tr><tr><td><code>opm nvm install</code></td><td><code>git clone &lt;mirror&gt; ~/.nvm</code> + 写 shell profile</td><td>安装 nvm</td></tr><tr><td><code>opm nvm upgrade</code></td><td><code>cd ~/.nvm &amp;&amp; git pull --tags</code></td><td>更新 nvm</td></tr><tr><td><code>opm nvm uninstall</code></td><td><code>rm -rf ~/.nvm</code></td><td>卸载 nvm</td></tr><tr><td><code>opm nvm dir</code></td><td>返回 <code>~/.nvm</code> 安装目录</td></tr><tr><td><code>opm nvm list</code></td><td><code>nvm ls --no-colors</code></td><td>列出已安装 Node.js 版本</td></tr></tbody></table>
-<h2>镜像预设</h2>
-<table><thead><tr><th>预设名</th><th>地址</th></tr></thead><tbody><tr><td><code>official</code></td><td><code>https://github.com/nvm-sh/nvm.git</code></td></tr><tr><td><code>gitee</code></td><td><code>https://gitee.com/mirrors/nvm.git</code></td></tr></tbody></table>
-<h2>示例</h2>
-<pre><code class="lang-bash">opm nvm version
-opm nvm registry set gitee
-opm nvm install
-opm nvm upgrade
-opm nvm list
-opm nvm dir
-opm nvm uninstall</code></pre></div>
 <div id="managers_php" class="doc-content" style="display:none;"><h1>php 命令对照表</h1>
 <p><code>@wwkit/opm</code> 统一命令通过 phpenv 管理 PHP 版本。</p>
 <h2>命令对照</h2>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wwkit/opm",
-  "version": "1.0.21",
+  "version": "1.0.23",
   "author": "bluesliu <langcai163@163.com>",
   "description": "Unified CLI — package management (npm/pip/dnf/apt) + config view + opencode maintenance",
   "type": "module",
@@ -35,7 +35,7 @@
     "basic-ftp": "^6.2.1",
     "extract-zip": "^2.0.1",
     "systeminformation": "^5.23.0",
-    "@wwkit/shared": "1.0.26"
+    "@wwkit/shared": "1.0.28"
   },
   "devDependencies": {
     "jest": "^29.7.0"
@@ -54,8 +54,10 @@
     "postinstall": "node scripts/postinstall.js",
     "check": "node --check bin/index.js",
     "start": "node bin/index.js",
-    "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js --no-cache tests",
-    "test:all": "node --experimental-vm-modules node_modules/jest/bin/jest.js --no-cache tests",
+    "ut": "node ../../scripts/run-tests.js unit",
+    "it": "node ../../scripts/run-tests.js integration",
+    "e2e": "node ../../scripts/run-tests.js e2e",
+    "test": "pnpm run ut",
     "doc": "node -e \"import('./src/cli/doc.js').then(m => m.generateDocHtml({ open: false }))\"",
     "release": "node ../../packages/shared/bin/release-pkg.js"
   }

package/src/cli/groups/mise.js

@@ -0,0 +1,128 @@
+/**
+ * mise 命令组 — 管理 mise 自身
+ *
+ * mise 是原生跨平台二进制（Rust），安装方式为下载官方 GitHub release 二进制
+ * （见 managers/node.js installMise）；upgrade = mise self-update；
+ * uninstall = 删二进制 + 清理数据目录。
+ * 无 registry 概念（node 镜像在 opm node 组管理，传给 MISE_NODE_MIRROR_URL）。
+ */
+
+import { execSync } from 'node:child_process'
+import fs from 'node:fs'
+import path from 'node:path'
+import os from 'node:os'
+import { ToolManagerGroup } from './version-manager.js'
+import { getMiseBin, installMise } from '../../managers/node.js'
+
+/**
+ * 获取 mise 数据目录（Unix ~/.local/share/mise，Windows %LOCALAPPDATA%\mise）
+ * @returns {string}
+ */
+export function getMiseDataDir() {
+  if (process.platform === 'win32') {
+    return process.env.LOCALAPPDATA
+      ? path.join(process.env.LOCALAPPDATA, 'mise')
+      : path.join(os.homedir(), 'AppData', 'Local', 'mise')
+  }
+  return process.env.XDG_DATA_HOME
+    ? path.join(process.env.XDG_DATA_HOME, 'mise')
+    : path.join(os.homedir(), '.local', 'share', 'mise')
+}
+
+/**
+ * 获取 mise shims 目录（Windows %LOCALAPPDATA%\mise\shims，Unix ~/.local/share/mise/shims）
+ *
+ * mise 为激活的工具（如 node/npm）在 shims 目录创建 shim（Windows 下含 .cmd），
+ * 把该目录加入用户 PATH 后，任意新 shell 即可直接调用 mise 管理的命令。
+ * @returns {string}
+ */
+export function getMiseShimsDir() {
+  return path.join(getMiseDataDir(), 'shims')
+}
+
+/**
+ * 解析 mise ls --json 输出为已安装工具版本列表
+ * 输出为对象 keyed by tool name，值是版本记录数组（含 installed/active）。
+ * @param {string} out
+ * @returns {{ name: string, version: string, current: boolean }[]}
+ */
+export function parseMiseLsAll(out) {
+  let data
+  try {
+    data = JSON.parse(out)
+  } catch {
+    return []
+  }
+  if (!data || typeof data !== 'object' || Array.isArray(data)) return []
+  const items = []
+  for (const [tool, records] of Object.entries(data)) {
+    if (!Array.isArray(records)) continue
+    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: `${tool} ${version}`, version, current: !!rec.active })
+    }
+  }
+  return items
+}
+
+export class MiseGroup extends ToolManagerGroup {
+  constructor() {
+    super({
+      name: 'mise',
+      desc: 'mise version manager (manage mise itself)',
+      hasRegistry: false,
+      isInstalled: () => {
+        try {
+          execSync(`${getMiseBin()} --version`, { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] })
+          return true
+        } catch {
+          return false
+        }
+      },
+      getPath: () => getMiseBin(),
+      versionCmd: () => `${getMiseBin()} --version`,
+      parseVersion: (out) => out.trim(),
+      listCmd: () => `${getMiseBin()} ls --json`,
+      parseList: parseMiseLsAll,
+      install: (proxy) => installMise(proxy),
+      upgrade: () => {
+        execSync(`${getMiseBin()} self-update`, { stdio: 'inherit' })
+        return { action: 'upgraded' }
+      },
+      uninstall: () => {
+        // mise 由 installMise 下载 release 二进制到 ~/.local/bin，非 npm 全局安装
+        const binPath = getMiseBin()
+        if (binPath !== 'mise' && fs.existsSync(binPath)) {
+          fs.rmSync(binPath, { force: true })
+        }
+        const dataDir = getMiseDataDir()
+        if (fs.existsSync(dataDir)) {
+          fs.rmSync(dataDir, { recursive: true, force: true })
+        }
+        return { action: 'uninstalled', hint: 'mise removed (binary + data dir)' }
+      },
+      usage: 'opm mise <action> [options]',
+      actions: [
+        ['version', 'Show mise version'],
+        ['installed', 'Check if mise is installed'],
+        ['install', 'Install mise (download GitHub release binary)'],
+        ['upgrade', 'Update mise (mise self-update)'],
+        ['uninstall', 'Remove mise (binary + data dir)'],
+        ['dir', 'Show mise binary path'],
+        ['list', 'List installed tool versions (mise ls --json)'],
+        ['help', 'Show this help'],
+      ],
+      examples: [
+        'opm mise version',
+        'opm mise installed',
+        'opm mise install',
+        'opm mise upgrade',
+        'opm mise dir',
+        'opm mise list',
+        'opm mise uninstall',
+      ],
+    })
+  }
+}

package/src/cli/groups/package.js

@@ -5,6 +5,7 @@
  * 新增包管理器：实现 src/managers/base.js 接口后在此 MANAGERS 注册。
  */
 
+import { spawnSync } from 'node:child_process'
 import { parseFlags } from '../helpers/args.js'
 import { NpmManager } from '../../managers/npm.js'
 import { PipManager } from '../../managers/pip.js'
@@ -14,7 +15,8 @@ import { BrewManager } from '../../managers/brew.js'
 import { ComposerManager } from '../../managers/composer.js'
 import { BunManager } from '../../managers/bun.js'
 import { WingetManager } from '../../managers/winget.js'
-import { NodeManager } from '../../managers/node.js'
+import { NodeManager, getMiseInstallDir, isMiseInstalled, detectSystemNodeConflict, prependSystemPathDirs } from '../../managers/node.js'
+import { getMiseShimsDir } from './mise.js'
 import { PhpManager } from '../../managers/php.js'
 import { PythonManager } from '../../managers/python.js'
 import { getPresets } from '../../presets.js'
@@ -65,7 +67,7 @@ const MANAGER_DESC = {
   composer: 'composer package manager (PHP)',
   bun: 'bun package manager (Bun runtime)',
   winget: 'winget package manager (Windows)',
-  node: 'node version manager (via nvm)',
+  node: 'node version manager (via mise)',
   php: 'php version manager (via phpenv)',
   python: 'python version manager (via uv)',
 }
@@ -350,16 +352,16 @@ Examples:
 const RUNTIME_META = {
   node: {
     label: 'Node.js',
-    tool: 'nvm',
-    versionsHint: 'nvm ls-remote',
-    listHint: 'nvm ls',
-    useHint: 'nvm use',
-    currentHint: 'nvm current',
-    defaultHint: 'nvm alias default',
+    tool: 'mise',
+    versionsHint: 'mise ls-remote node',
+    listHint: 'mise ls node --json',
+    useHint: 'mise use node@<version>',
+    currentHint: 'mise current node',
+    defaultHint: 'mise use -g node@<version>',
     latest: 'LTS',
     installExample: '20',
     useExample: '20',
-    searchExample: 'v20.20.2',
+    searchExample: 'v24.21.0',
     uninstallExample: '18',
   },
   php: {
@@ -411,7 +413,7 @@ export class RuntimeGroup extends PackageGroup {
       return
     }
 
-    const runtimeActions = new Set(['use', 'current', 'default', 'installed', 'dir', 'install', 'upgrade', 'search', 'versions', 'version', 'view', 'list', 'info', 'cache'])
+    const runtimeActions = new Set(['use', 'current', 'default', 'installed', 'dir', 'install', 'upgrade', 'search', 'versions', 'version', 'view', 'list', 'info', 'cache', 'fix-path'])
     if (runtimeActions.has(action)) {
       const manager = MANAGERS[this.name]()
       const parsed = parseFlags(rest)
@@ -479,6 +481,26 @@ export class RuntimeGroup extends PackageGroup {
         break
       }
 
+      case 'fix-path': {
+        // 仅 node（mise 场景）有效：把 mise 目录前置到系统 PATH（HKLM），
+        // 让新终端优先用 mise 管理的 node，而非系统残留的旧版 node。
+        if (this.name !== 'node') {
+          console.error(`fix-path 仅对 node（mise 管理）有效`)
+          process.exit(1)
+        }
+        const r = this._fixPath()
+        if (r.status === 'mise-missing') {
+          console.error('mise 未安装，无需 fix-path')
+          process.exit(1)
+        }
+        if (r.status === 'needs-admin') {
+          console.error(`系统 PATH 修改需要管理员权限。请以管理员身份运行：\n  opm ${this.name} fix-path\n或手动编辑系统环境变量，把以下目录前置到 Path：\n  ${r.dirs.join('\n  ')}`)
+          process.exit(1)
+        }
+        output({ name: this.name, action: 'fix-path', ...r })
+        break
+      }
+
       case 'install': {
         const version = positional[0] || (manager.getDefaultVersion ? manager.getDefaultVersion() : '')
         if (!version) {
@@ -555,6 +577,28 @@ export class RuntimeGroup extends PackageGroup {
     }
   }
 
+  /**
+   * 修复系统 PATH 冲突：把 mise 目录（安装目录 + shims）前置到系统 PATH（HKLM）。
+   *
+   * Windows 新终端 PATH = 系统 PATH + 用户 PATH，系统 PATH 优先。系统 PATH 若有
+   * 旧版 node 会抢先于 mise shims，导致用户终端 node 与 webwork install 使用的不一致。
+   * 写 HKLM 需管理员权限；失败返回 needs-admin 由调用方提示。
+   *
+   * @param {object} [deps] - 可注入依赖（测试用）
+   * @param {Function} [deps.spawnSyncImpl] - spawnSync 实现（reg 读写走数组参数，不经 cmd）
+   * @param {Function} [deps.isMiseOk] - mise 安装检测
+   * @param {string[]} [deps.dirs] - 需前置的目录
+   * @returns {{ status: 'mise-missing'|'no-conflict'|'fixed'|'needs-admin', systemNode?: string, prepended?: string[], dirs?: string[], message?: string }}
+   */
+  _fixPath({ spawnSyncImpl = spawnSync, isMiseOk = isMiseInstalled, dirs = [getMiseInstallDir(), getMiseShimsDir()] } = {}) {
+    if (!isMiseOk()) return { status: 'mise-missing' }
+    const sysNode = detectSystemNodeConflict(spawnSyncImpl)
+    if (!sysNode) return { status: 'no-conflict', message: '系统 PATH 无旧版 node，无需修复' }
+    const ok = prependSystemPathDirs(dirs, spawnSyncImpl)
+    if (!ok) return { status: 'needs-admin', systemNode: sysNode, dirs }
+    return { status: 'fixed', systemNode: sysNode, prepended: dirs, message: '已把 mise 目录前置到系统 PATH，新终端将优先用 mise 管理的 node（需重启终端生效）' }
+  }
+
   /**
    * 依据元数据生成一致的运行时帮助文本
    */

package/src/cli/groups/version-manager.js

@@ -1,5 +1,5 @@
 /**
- * 版本管理器自身命令组基类（nvm / phpenv / uv 共用）
+ * 版本管理器自身命令组基类（mise / phpenv / uv 共用）
  *
  * 三个版本管理器均提供 version / registry / install / upgrade / uninstall / view 动作，
  * 差异仅在底层命令与安装/升级/卸载方式，故抽象为数据驱动基类。
@@ -21,7 +21,7 @@ const shell = new Shell()
  * @property {string} desc - 顶层帮助描述
  * @property {boolean} [hasRegistry=true] - 是否支持 registry 动作（uv 为 false）
  * @property {() => boolean} isInstalled
- * @property {boolean} [needsBash=false] - versionCmd 是否需要 bash（nvm source / phpenv 脚本）；uv 为 false
+ * @property {boolean} [needsBash=false] - versionCmd 是否需要 bash（phpenv 脚本）；mise/uv 为 false
  * @property {() => string} getPath - view 展示的安装路径
  * @property {() => string} versionCmd - 返回查询版本的 shell 命令
  * @property {(out: string) => string} [parseVersion] - 解析版本输出

package/src/cli/index.js

@@ -11,7 +11,7 @@ import { pathToFileURL } from 'node:url'
 import { realpathSync, readFileSync } from 'node:fs'
 import { PackageGroup, RuntimeGroup } from './groups/package.js'
 import { ConfigGroup } from './groups/config.js'
-import { NvmGroup } from './groups/nvm.js'
+import { MiseGroup } from './groups/mise.js'
 import { PhpenvGroup } from './groups/phpenv.js'
 import { UvGroup } from './groups/uv.js'
 import { HomebrewGroup } from './groups/homebrew.js'
@@ -54,7 +54,7 @@ const GROUPS = {
   bun: new PackageGroup('bun'),
   winget: new PackageGroup('winget'),
   node: new RuntimeGroup('node'),
-  nvm: new NvmGroup(),
+  mise: new MiseGroup(),
   php: new RuntimeGroup('php'),
   phpenv: new PhpenvGroup(),
   python: new RuntimeGroup('python'),

package/src/config.json5

@@ -95,17 +95,7 @@
     },
   },
 
-  // nvm 自身镜像预设（git clone 地址）
-  nvm: {
-    registry: {
-      official: "https://github.com/nvm-sh/nvm.git",
-      gitee: "https://gitee.com/mirrors/nvm.git",
-      huawei: "https://gitee.com/mirrors/nvm.git",
-      active: "huawei",
-    },
-  },
-
-  // node（Node.js）镜像预设（dist 下载地址，传给 NVM_NODEJS_ORG_MIRROR）
+  // node（Node.js）镜像预设（dist 下载地址，传给 MISE_NODE_MIRROR_URL）
   node: {
     defaultVersion: "24",
     registry: {
@@ -117,6 +107,20 @@
     },
   },
 
+  // mise 自身（版本管理器二进制）下载镜像预设（GitHub release 资产 base URL）
+  // install 时按 <base>/v<version>/mise-v<version>-<platform>-<arch>[.exe] 下载二进制，
+  // 依次尝试 active → 其余预设 → official，直到成功（自动回退到可用镜像）。
+  // 官方 npm 分发（npm install -g mise）的 preinstall 引用的 platform 包在 Windows 上不可用，
+  // 故默认直接下载官方 release 二进制；无法直连 GitHub 时会自动回退到 ghproxy.net 等镜像。
+  mise: {
+    registry: {
+      official: "https://github.com/jdx/mise/releases/download",
+      ghproxy: "https://ghproxy.com/https://github.com/jdx/mise/releases/download",
+      "gh-proxy": "https://ghproxy.net/https://github.com/jdx/mise/releases/download",
+      active: "gh-proxy",
+    },
+  },
+
   // phpenv 自身镜像预设（git clone 地址）
   phpenv: {
     registry: {

package/src/index.js

@@ -2,7 +2,7 @@
  * @wwkit/opm 库入口
  *
  * 统一命令行工具（包管理 npm/pip/dnf/apt/brew/composer/bun + 运行时版本管理
- * node/php/python + 版本管理器 nvm/phpenv/uv + opencode 运维），
+ * node/php/python + 版本管理器 mise/phpenv/uv + opencode 运维），
  * CLI 与各组件的可复用 API 均从此导出。
  */
 
@@ -14,7 +14,7 @@ export { opencodeHarness } from './harnesses/opencode/index.js'
 export { harnessCfg } from './harnesses/harness/index.js'
 export { BinaryGroup } from './binaries/base.js'
 export { CftGroup } from './binaries/cft/index.js'
-export { NvmGroup } from './cli/groups/nvm.js'
+export { MiseGroup } from './cli/groups/mise.js'
 export { PhpenvGroup } from './cli/groups/phpenv.js'
 export { UvGroup } from './cli/groups/uv.js'
 export { HomebrewGroup } from './cli/groups/homebrew.js'
@@ -40,7 +40,7 @@ export { AptManager } from './managers/apt.js'
 export { BrewManager } from './managers/brew.js'
 export { ComposerManager } from './managers/composer.js'
 export { BunManager } from './managers/bun.js'
-export { NodeManager, isNvmInstalled, getNvmSh } from './managers/node.js'
+export { NodeManager, isMiseInstalled, getMiseBin } from './managers/node.js'
 export { PhpManager, isPhpenvInstalled, getPhpenvBin } from './managers/php.js'
 export { PythonManager, isUvInstalled, getUvBin } from './managers/python.js'
 export {
@@ -57,7 +57,7 @@ export {
 
 export {
   NPM_PRESETS, PIP_PRESETS, DNF_PRESETS, APT_PRESETS, BREW_PRESETS, COMPOSER_PRESETS,
-  BUN_PRESETS, NVM_PRESETS, NODE_PRESETS, PHPENV_PRESETS, PHP_PRESETS, PYTHON_PRESETS,
+  BUN_PRESETS, NODE_PRESETS, PHPENV_PRESETS, PHP_PRESETS, PYTHON_PRESETS,
   UV_PRESETS, DOCKER_PRESETS, HOMEBREW_PRESETS,
   getPresets, resolveRegistryInput,
 } from './presets.js'