yymaxapi 1.0.22 → 1.0.24

package/bin/yymaxapi.js

@@ -507,15 +507,15 @@ function getConfigPath() {
           // 将 WSL 配置复制到 Windows 侧，保持同步
           const winDest = path.join(openclawStateDir, path.basename(wp));
           try {
-            const content = execFileSync('wsl', ['bash', '-c', `cat '${wp}'`], { encoding: 'utf8', timeout: 10000 });
+            const content = execFileSync('wsl', ['bash', '-c', `cat '${wp}'`], { encoding: 'utf8', timeout: 10000, stdio: 'pipe' });
             if (!fs.existsSync(openclawStateDir)) fs.mkdirSync(openclawStateDir, { recursive: true });
             fs.writeFileSync(winDest, content, 'utf8');
             if (!candidates.includes(winDest)) candidates.unshift(winDest);
-          } catch {}
+          } catch { }
           break;
         }
       }
-    } catch {}
+    } catch { }
   }
 
   const defaultConfig = preferMoltbot
@@ -618,7 +618,7 @@ function isWslAvailable() {
 function getWslHome() {
   if (_wslHomeCache !== undefined) return _wslHomeCache;
   try {
-    _wslHomeCache = execFileSync('wsl', ['bash', '-c', 'echo $HOME'], { encoding: 'utf8', timeout: 5000 }).trim() || null;
+    _wslHomeCache = execFileSync('wsl', ['bash', '-c', 'echo $HOME'], { encoding: 'utf8', timeout: 5000, stdio: 'pipe' }).trim() || null;
   } catch { _wslHomeCache = null; }
   return _wslHomeCache;
 }
@@ -630,12 +630,12 @@ function getWslCliBinary() {
   if (_wslCliBinaryCache !== undefined) return _wslCliBinaryCache;
   for (const name of ['openclaw', 'clawdbot', 'moltbot']) {
     try {
-      const result = execFileSync('wsl', ['bash', '-lc', `which ${name} 2>/dev/null`], { encoding: 'utf8', timeout: 5000 }).trim();
+      const result = execFileSync('wsl', ['bash', '-lc', `which ${name} 2>/dev/null`], { encoding: 'utf8', timeout: 5000, stdio: 'pipe' }).trim();
       if (result && result.startsWith('/')) {
         _wslCliBinaryCache = result;
         return _wslCliBinaryCache;
       }
-    } catch {}
+    } catch { }
   }
   _wslCliBinaryCache = null;
   return null;
@@ -663,7 +663,7 @@ function detectGatewayEnv(port = 18789) {
         }
       }
     }
-  } catch {}
+  } catch { }
   // Fallback: Windows 没有原生 OpenClaw CLI，但 WSL 里有 → 判定为 WSL
   const nativeCli = resolveCliBinary();
   if (!nativeCli) {
@@ -705,7 +705,7 @@ function syncConfigToWsl(windowsConfigPath) {
     if (!match) return;
     const wslSrc = `/mnt/${match[1].toLowerCase()}/${match[2]}`;
     const wslDest = `${wslHome}/.openclaw/openclaw.json`;
-    execFileSync('wsl', ['bash', '-c', `mkdir -p "${wslHome}/.openclaw" && cp "${wslSrc}" "${wslDest}"`], { timeout: 10000, stdio: 'ignore' });
+    execFileSync('wsl', ['bash', '-c', `mkdir -p "${wslHome}/.openclaw" && cp "${wslSrc}" "${wslDest}"`], { timeout: 10000, stdio: 'pipe' });
   } catch { /* best-effort */ }
 }
 
@@ -880,7 +880,7 @@ function readAuthStore(authProfilesPath) {
     for (const [k, v] of Object.entries(raw)) {
       if (v && typeof v === 'object' && v.type) store.profiles[k] = v;
     }
-  } catch {}
+  } catch { }
   return store;
 }
 
@@ -1037,7 +1037,7 @@ function resolveCliBinary() {
       if (fs.existsSync(override) && fs.statSync(override).isFile()) {
         return override;
       }
-    } catch {}
+    } catch { }
   }
 
   // Validate that a found binary is a real gateway CLI, not yymaxapi itself
@@ -1078,7 +1078,7 @@ function resolveCliBinary() {
           if (fs.existsSync(full) && fs.statSync(full).isFile() && isRealCli(full)) {
             return full;
           }
-        } catch {}
+        } catch { }
       }
     }
   }
@@ -1104,7 +1104,7 @@ function resolveCliBinary() {
       if (fs.existsSync(candidate) && fs.statSync(candidate).isFile()) {
         return candidate;
       }
-    } catch {}
+    } catch { }
   }
 
   // Fallback: use login shell to find the binary (loads .zshrc/.bashrc PATH)
@@ -1136,7 +1136,7 @@ function resolveCliBinary() {
       const full = path.join(npmBin, name);
       try {
         if (fs.existsSync(full) && fs.statSync(full).isFile() && isRealCli(full)) return full;
-      } catch {}
+      } catch { }
     }
   }
 
@@ -1155,14 +1155,14 @@ function resolveCliBinary() {
         extraSearchDirs.push(path.join(nvmVersionsDir, entry, 'bin'));
       }
     }
-  } catch {}
+  } catch { }
 
   for (const dir of extraSearchDirs) {
     for (const name of candidates) {
       const full = path.join(dir, name);
       try {
         if (fs.existsSync(full) && fs.statSync(full).isFile() && isRealCli(full)) return full;
-      } catch {}
+      } catch { }
     }
   }
 
@@ -1204,7 +1204,7 @@ function findCompatibleNode(minMajor = 22) {
       for (const entry of entries) {
         candidates.push(path.join(nvmVersionsDir, entry, 'bin', 'node'));
       }
-    } catch {}
+    } catch { }
   }
 
   const seen = new Set();
@@ -1220,7 +1220,7 @@ function findCompatibleNode(minMajor = 22) {
       if (major && major >= minMajor) {
         return { path: candidate, version: version.trim(), major };
       }
-    } catch {}
+    } catch { }
   }
 
   return null;
@@ -1350,7 +1350,7 @@ function installMacGatewayDaemon() {
     const domain = `gui/${uid}`;
     const service = `${domain}/${label}`;
 
-    try { execFileSync('launchctl', ['bootout', service], { stdio: 'ignore' }); } catch {}
+    try { execFileSync('launchctl', ['bootout', service], { stdio: 'ignore' }); } catch { }
     execFileSync('launchctl', ['bootstrap', domain, plistPath], { stdio: 'ignore' });
     execFileSync('launchctl', ['kickstart', '-k', service], { stdio: 'ignore' });
 
@@ -1550,14 +1550,14 @@ async function quickSetup(paths, args = {}) {
   const { relayType } = initialType
     ? { relayType: initialType }
     : await inquirer.prompt([{
-        type: 'list',
-        name: 'relayType',
-        message: '选择类型:',
-        choices: [
-          { name: 'Claude', value: 'claude' },
-          { name: 'Codex / GPT', value: 'codex' }
-        ]
-      }]);
+      type: 'list',
+      name: 'relayType',
+      message: '选择类型:',
+      choices: [
+        { name: 'Claude', value: 'claude' },
+        { name: 'Codex / GPT', value: 'codex' }
+      ]
+    }]);
 
   const type = relayType;
   const typeLabel = type === 'claude' ? 'Claude' : 'Codex';
@@ -1877,11 +1877,11 @@ async function presetClaude(paths, args = {}) {
   const shouldTestGateway = args.test !== undefined
     ? !['false', '0', 'no'].includes(String(args.test).toLowerCase())
     : await inquirer.prompt([{
-        type: 'confirm',
-        name: 'testGateway',
-        message: '是否立即通过 OpenClaw Gateway 测试？',
-        default: true
-      }]).then(r => r.testGateway);
+      type: 'confirm',
+      name: 'testGateway',
+      message: '是否立即通过 OpenClaw Gateway 测试？',
+      default: true
+    }]).then(r => r.testGateway);
 
   if (shouldTestGateway) {
     await testConnection(paths, args);
@@ -2067,11 +2067,11 @@ async function presetCodex(paths, args = {}) {
   const shouldTestGateway = args.test !== undefined
     ? !['false', '0', 'no'].includes(String(args.test).toLowerCase())
     : await inquirer.prompt([{
-        type: 'confirm',
-        name: 'testGateway',
-        message: '是否立即通过 OpenClaw Gateway 测试？',
-        default: true
-      }]).then(r => r.testGateway);
+      type: 'confirm',
+      name: 'testGateway',
+      message: '是否立即通过 OpenClaw Gateway 测试？',
+      default: true
+    }]).then(r => r.testGateway);
 
   if (shouldTestGateway) {
     await testConnection(paths, args);
@@ -2405,7 +2405,7 @@ async function testConnection(paths, args = {}) {
 
   // 步骤1: 先重启 Gateway 使配置生效
   console.log(chalk.cyan('步骤 1/2: 重启 Gateway 使配置生效...'));
-  await restartGateway();
+  const restartOk = await restartGateway();
 
   // 等待 Gateway 启动
   const gwSpinner = ora({ text: '等待 Gateway 启动...', spinner: 'dots' }).start();
@@ -2428,6 +2428,12 @@ async function testConnection(paths, args = {}) {
 
   gwSpinner.succeed('Gateway 已启动');
 
+  if (!restartOk) {
+    console.log(chalk.yellow('⚠️ Gateway 未能通过常规方式重启，当前使用的可能是之前的 Gateway 进程'));
+    console.log(chalk.yellow('   新配置可能未生效。如 bot 不回复，请手动重启 Gateway：'));
+    console.log(chalk.gray('   openclaw gateway restart 或 clawdbot gateway restart'));
+  }
+
   // 步骤2: 通过 Gateway 端点测试（优先使用 CLI agent）
   console.log(chalk.cyan(`\n步骤 2/2: 测试 Gateway API 端点...`));
 
@@ -2555,12 +2561,12 @@ async function restartGateway() {
     const wslCli = getWslCliBinary();
     return new Promise((resolve) => {
       const wslCmds = wslCli
-        ? [`wsl -- bash -c "${wslCli} gateway restart"`]
+        ? [`wsl -- bash -lc "${wslCli} gateway restart"`]
         : [
-            'wsl -- bash -lc "openclaw gateway restart"',
-            'wsl -- bash -lc "clawdbot gateway restart"',
-            'wsl -- bash -lc "moltbot gateway restart"',
-          ];
+          'wsl -- bash -lc "openclaw gateway restart"',
+          'wsl -- bash -lc "clawdbot gateway restart"',
+          'wsl -- bash -lc "moltbot gateway restart"',
+        ];
       let tried = 0;
       const tryNext = () => {
         if (tried >= wslCmds.length) {
@@ -2569,11 +2575,15 @@ async function restartGateway() {
           return;
         }
         const cmd = wslCmds[tried++];
-        exec(cmd, { timeout: 30000 }, (error) => {
-          if (error) { tryNext(); }
-          else {
+        exec(cmd, { timeout: 30000 }, (error, stdout, stderr) => {
+          const errStr = (stderr || '').toLowerCase();
+          const wslGarbled = errStr.includes('wsl:') && errStr.includes('localhost') && errStr.includes('nat');
+
+          if (error || errStr.includes('/usr/bin/env:') || wslGarbled) {
+            tryNext();
+          } else {
             console.log(chalk.green('Gateway 已重启 (WSL)'));
-            resolve();
+            resolve(true);
           }
         });
       };
@@ -2584,6 +2594,103 @@ async function restartGateway() {
   return restartGatewayNative();
 }
 
+// 强制重启 Gateway：杀掉旧进程，再用已找到的 CLI 路径启动新 Gateway
+async function forceRestartGateway(resolved, nodeInfo, useNode, env, gatewayPort = 18789) {
+  console.log(chalk.yellow('\n🔄 尝试强制重启 Gateway（杀旧进程 → 启动新进程）...'));
+
+  // 1. 杀掉旧 Gateway 进程
+  try {
+    if (process.platform === 'win32') {
+      // Windows: 通过 taskkill 杀掉占用端口的 node 进程
+      const findPid = safeExec(`netstat -ano | findstr ":${gatewayPort}"`, { timeout: 5000 });
+      if (findPid.ok && findPid.output) {
+        const lines = findPid.output.split('\n').filter(l => l.includes('LISTENING'));
+        for (const line of lines) {
+          const pid = line.trim().split(/\s+/).pop();
+          if (pid && /^\d+$/.test(pid)) {
+            safeExec(`taskkill /F /PID ${pid}`, { timeout: 5000 });
+          }
+        }
+      }
+      // Windows + WSL: 也清理 WSL 内的 gateway 进程
+      if (isWslAvailable()) {
+        for (const name of ['openclaw', 'clawdbot', 'moltbot']) {
+          safeExec(`wsl -- bash -c "pkill -f '${name}.*gateway' 2>/dev/null || true"`, { timeout: 5000 });
+        }
+        safeExec(`wsl -- bash -c "lsof -ti :${gatewayPort} 2>/dev/null | xargs -r kill -9 2>/dev/null || true"`, { timeout: 5000 });
+      }
+    } else {
+      // Linux/macOS: pkill gateway 相关进程
+      for (const name of ['openclaw', 'clawdbot', 'moltbot']) {
+        safeExec(`pkill -f '${name}.*gateway' 2>/dev/null || true`);
+      }
+      // 备用：通过端口找进程并杀掉
+      const lsof = safeExec(`lsof -ti :${gatewayPort} 2>/dev/null`);
+      if (lsof.ok && lsof.output) {
+        for (const pid of lsof.output.trim().split('\n').filter(Boolean)) {
+          if (/^\d+$/.test(pid.trim())) {
+            safeExec(`kill -9 ${pid.trim()} 2>/dev/null || true`);
+          }
+        }
+      }
+    }
+    console.log(chalk.gray('   已尝试清理旧 Gateway 进程'));
+  } catch { /* ignore */ }
+
+  // 2. 等待端口释放
+  await new Promise(resolve => setTimeout(resolve, 2000));
+
+  // 3. 用已找到的 CLI 路径启动新 Gateway
+  const startCmds = [];
+
+  // 优先用已解析的完整路径
+  if (resolved) {
+    if (useNode && nodeInfo) {
+      startCmds.push(`"${nodeInfo.path}" "${resolved}" gateway`);
+    } else {
+      startCmds.push(`"${resolved}" gateway`);
+    }
+  }
+
+  // Fallback: login shell 方式（加载 nvm 等 PATH）
+  if (process.platform !== 'win32') {
+    for (const name of ['openclaw', 'clawdbot', 'moltbot']) {
+      startCmds.push(`bash -lc '${name} gateway'`);
+    }
+  } else {
+    // Windows: 先尝试原生命令
+    startCmds.push('openclaw gateway', 'clawdbot gateway', 'moltbot gateway');
+    // Windows + WSL: 也尝试通过 WSL 启动 gateway
+    if (isWslAvailable()) {
+      const wslCli = getWslCliBinary();
+      if (wslCli) {
+        startCmds.push(`wsl -- bash -lc "${wslCli} gateway"`);
+      }
+      for (const name of ['openclaw', 'clawdbot', 'moltbot']) {
+        startCmds.push(`wsl -- bash -lc "${name} gateway"`);
+      }
+    }
+  }
+
+  for (const cmd of [...new Set(startCmds)].filter(Boolean)) {
+    console.log(chalk.gray(`   尝试启动: ${cmd}`));
+    if (spawnDetached(cmd, env)) {
+      // 等待新 Gateway 启动
+      if (await waitForGateway(gatewayPort, '127.0.0.1', 12000)) {
+        console.log(chalk.green('✅ Gateway 已强制重启成功'));
+        console.log(chalk.gray('   现在可以在 Web/Telegram/Discord 等渠道测试对话了'));
+        return true;
+      }
+    }
+  }
+
+  console.log(chalk.red('❌ 强制重启也失败了'));
+  console.log(chalk.gray('   请手动重启 Gateway:'));
+  console.log(chalk.gray('   1. 关闭旧进程: pkill -f "gateway" 或 taskkill'));
+  console.log(chalk.gray('   2. 启动新进程: openclaw gateway / clawdbot gateway / moltbot gateway'));
+  return false;
+}
+
 async function restartGatewayNative() {
   const { cliBinary: resolved, nodeMajor } = getCliMeta();
   const nodeInfo = findCompatibleNode(nodeMajor);
@@ -2593,16 +2700,27 @@ async function restartGatewayNative() {
   // 尝试多种命令
   const commands = resolved
     ? [
-        useNode ? `"${nodeInfo.path}" "${resolved}" gateway restart` : `"${resolved}" gateway restart`
-      ]
+      useNode ? `"${nodeInfo.path}" "${resolved}" gateway restart` : `"${resolved}" gateway restart`
+    ]
     : [
-        'openclaw gateway restart',
-        'clawdbot gateway restart',
-        'moltbot gateway restart',
-        'npx openclaw gateway restart',
-        'npx clawdbot gateway restart',
-        'npx moltbot gateway restart'
-      ];
+      'openclaw gateway restart',
+      'clawdbot gateway restart',
+      'moltbot gateway restart',
+      'npx openclaw gateway restart',
+      'npx clawdbot gateway restart',
+      'npx moltbot gateway restart'
+    ];
+
+  // Windows + WSL: 追加 WSL 命令作为额外回退
+  if (process.platform === 'win32' && isWslAvailable()) {
+    const wslCli = getWslCliBinary();
+    if (wslCli) {
+      commands.push(`wsl -- bash -lc "${wslCli} gateway restart"`);
+    }
+    for (const name of ['openclaw', 'clawdbot', 'moltbot']) {
+      commands.push(`wsl -- bash -lc "${name} gateway restart"`);
+    }
+  }
 
   return new Promise((resolve) => {
     let tried = 0;
@@ -2621,8 +2739,8 @@ async function restartGatewayNative() {
           const which = safeExec(process.platform === 'win32' ? `where ${name} 2>nul` : `/bin/zsh -lc "command -v ${name}" 2>/dev/null || /bin/bash -lc "command -v ${name}" 2>/dev/null`);
           if (which.ok && which.output) console.log(chalk.gray(`   [诊断] ${name} -> ${which.output.split('\n')[0].trim()}`));
         }
-        console.log(chalk.gray(`   [诊断] 等待 Gateway 启动...`));
-        resolve();
+        // 尝试强制重启
+        forceRestartGateway(resolved, nodeInfo, useNode, env).then(resolve);
         return;
       }
 
@@ -2635,7 +2753,7 @@ async function restartGatewayNative() {
         } else {
           console.log(chalk.green(`✅ Gateway 已重启`));
           console.log(chalk.gray(`   现在可以在 Web/Telegram/Discord 等渠道测试对话了`));
-          resolve();
+          resolve(true);
         }
       });
     };
@@ -2650,13 +2768,13 @@ function testGatewayApi(port, token, model, endpoint = '/v1/responses') {
     const isChatCompletions = endpoint.includes('chat/completions');
     const postData = isChatCompletions
       ? JSON.stringify({
-          model: model,
-          messages: [{ role: 'user', content: '你是什么模型？' }]
-        })
+        model: model,
+        messages: [{ role: 'user', content: '你是什么模型？' }]
+      })
       : JSON.stringify({
-          model: model,
-          input: '你是什么模型？'
-        });
+        model: model,
+        input: '你是什么模型？'
+      });
 
     const options = {
       hostname: '127.0.0.1',
@@ -2768,6 +2886,18 @@ function testGatewayViaAgent(model) {
     exec(cmd, execOpts, (error, stdout, stderr) => {
       // 过滤 stderr 中的 Node.js DeprecationWarning 噪音
       const cleanStderr = (stderr || '').replace(/\(node:\d+\) \[DEP\d+\] DeprecationWarning:.*(\n.*trace-deprecation.*)?/g, '').trim();
+      const errStr = cleanStderr.toLowerCase();
+
+      const wslGarbled = errStr.includes('wsl:') && errStr.includes('localhost') && errStr.includes('nat');
+
+      if (gwEnv === 'wsl' && (errStr.includes('/usr/bin/env: ‘node’: no such file') || wslGarbled)) {
+        resolve({
+          success: false,
+          usedCli: true,
+          error: 'WSL 子系统中未安装 Node.js。请使用 `wsl -u root apt install nodejs` 修复环境。\nGateway 可能暂无法在 WSL 内使用 CLI 诊断。'
+        });
+        return;
+      }
 
       if (error) {
         // 即使 exec 报错，stdout 中可能仍有有效 JSON（如 CLI 输出了结果但 exit code 非零）
@@ -2865,9 +2995,9 @@ function sanitizeModelReply(message, options = {}) {
 
   const tailPattern = tokens.length
     ? new RegExp(
-        `[（(][^）)]*(?:${tokens.join('|')}|[A-Za-z0-9_.-]+\\/[A-Za-z0-9_.-]+)[^）)]*[）)]\\s*$`,
-        'i'
-      )
+      `[（(][^）)]*(?:${tokens.join('|')}|[A-Za-z0-9_.-]+\\/[A-Za-z0-9_.-]+)[^）)]*[）)]\\s*$`,
+      'i'
+    )
     : /[（(][^）)]*[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+[^）)]*[）)]\s*$/i;
 
   text = text
@@ -3308,7 +3438,64 @@ async function restore(paths) {
   }
 }
 
+// ============ 环境自检 & 自动安装 ============
+function ensureGit() {
+  const hasGit = safeExec('git --version');
+  if (hasGit.ok) return;
+
+  console.log(chalk.yellow('\n⚠ 未检测到 Git，正在尝试自动安装...\n'));
+  const platform = os.platform();
+
+  if (platform === 'win32') {
+    // Windows: winget 优先
+    const hasWinget = safeExec('winget --version');
+    if (hasWinget.ok) {
+      console.log(chalk.cyan('→ 通过 winget 安装 Git...'));
+      const result = safeExec('winget install Git.Git --accept-source-agreements --accept-package-agreements --silent', { stdio: 'inherit', timeout: 300000 });
+      if (result.ok) {
+        console.log(chalk.green('✓ Git 安装成功，请重新打开终端后再次运行'));
+        process.exit(0);
+      }
+    }
+    console.log(chalk.red('✗ 自动安装失败，请手动安装 Git: https://git-scm.com'));
+    process.exit(1);
+  }
+
+  if (platform === 'darwin') {
+    // macOS: xcode-select
+    console.log(chalk.cyan('→ 通过 Xcode Command Line Tools 安装 Git...'));
+    const result = safeExec('xcode-select --install', { stdio: 'inherit', timeout: 600000 });
+    if (!result.ok && !result.stderr?.includes('already installed')) {
+      console.log(chalk.yellow('  请在弹出窗口中点击「安装」，完成后重新运行'));
+    }
+    process.exit(0);
+  }
+
+  // Linux / WSL
+  const pmCmds = [
+    { check: 'apt-get', install: 'sudo apt-get update -qq && sudo apt-get install -y -qq git' },
+    { check: 'dnf', install: 'sudo dnf install -y git' },
+    { check: 'yum', install: 'sudo yum install -y git' },
+    { check: 'pacman', install: 'sudo pacman -S --noconfirm git' },
+    { check: 'apk', install: 'sudo apk add git' },
+    { check: 'zypper', install: 'sudo zypper install -y git' },
+  ];
+  for (const pm of pmCmds) {
+    if (safeExec(`command -v ${pm.check}`).ok) {
+      console.log(chalk.cyan(`→ 通过 ${pm.check} 安装 Git...`));
+      const result = safeExec(pm.install, { stdio: 'inherit', timeout: 300000 });
+      if (result.ok && safeExec('git --version').ok) {
+        console.log(chalk.green('✓ Git 安装成功'));
+        return;
+      }
+    }
+  }
+  console.log(chalk.red('✗ 自动安装失败，请手动安装 Git: https://git-scm.com'));
+  process.exit(1);
+}
+
 // 启动
+ensureGit();
 main().catch(error => {
   exitWithError('CONFIG_FAILED', error.message, [
     '检查网络连接',

package/install.ps1

@@ -0,0 +1,126 @@
+# ============================================================
+# maxapi 一键环境安装脚本（Windows PowerShell）
+# 用法（Node.js 不存在时，先装 Node.js 再 npx）:
+#   .\install.ps1
+#   $env:PACKAGE='llmaxapi'; .\install.ps1
+# ============================================================
+
+$ErrorActionPreference = "Stop"
+$PACKAGE = if ($env:PACKAGE) { $env:PACKAGE } else { "yymaxapi" }
+$MIN_NODE_MAJOR = 18
+
+# ---------- 颜色输出 ----------
+function Write-Ok($msg)   { Write-Host "  $msg" -ForegroundColor Green }
+function Write-Info($msg)  { Write-Host "  $msg" -ForegroundColor Cyan }
+function Write-Warn($msg)  { Write-Host "  $msg" -ForegroundColor Yellow }
+function Write-Fail($msg)  { Write-Host "  $msg" -ForegroundColor Red; exit 1 }
+
+Write-Host ""
+Write-Host "  maxapi 一键环境安装 ($PACKAGE)" -ForegroundColor Cyan
+Write-Host "  ========================================" -ForegroundColor Cyan
+Write-Host ""
+
+# ---------- 工具函数 ----------
+function Test-Command($cmd) {
+    return [bool](Get-Command $cmd -ErrorAction SilentlyContinue)
+}
+
+function Get-NodeMajor {
+    if (-not (Test-Command "node")) { return 0 }
+    $ver = (node -v) -replace '^v','' -split '\.'
+    return [int]$ver[0]
+}
+
+function Refresh-Path {
+    $env:Path = [System.Environment]::GetEnvironmentVariable("Path", "Machine") + ";" +
+                [System.Environment]::GetEnvironmentVariable("Path", "User")
+}
+
+function Test-HasWinget {
+    return [bool](Get-Command "winget" -ErrorAction SilentlyContinue)
+}
+
+# ---------- 安装 Git ----------
+function Install-GitIfNeeded {
+    if (Test-Command "git") {
+        Write-Ok "Git $(git --version) 已安装"
+        return
+    }
+    Write-Info "安装 Git..."
+    if (Test-HasWinget) {
+        winget install Git.Git --accept-source-agreements --accept-package-agreements --silent
+        Refresh-Path
+    } else {
+        Write-Warn "未检测到 winget，尝试下载 Git 安装包..."
+        $gitUrl = "https://github.com/git-for-windows/git/releases/latest/download/Git-64-bit.exe"
+        $gitInstaller = "$env:TEMP\git-installer.exe"
+        Invoke-WebRequest -Uri $gitUrl -OutFile $gitInstaller -UseBasicParsing
+        Start-Process -FilePath $gitInstaller -ArgumentList "/VERYSILENT","/NORESTART" -Wait
+        Remove-Item $gitInstaller -Force -ErrorAction SilentlyContinue
+        Refresh-Path
+    }
+    if (Test-Command "git") { Write-Ok "Git 安装成功" }
+    else { Write-Fail "Git 安装失败，请手动安装: https://git-scm.com" }
+}
+
+# ---------- 安装 Node.js ----------
+function Install-NodeIfNeeded {
+    if ((Get-NodeMajor) -ge $MIN_NODE_MAJOR) {
+        Write-Ok "Node.js $(node -v) 已安装"
+        return
+    }
+    if (Test-Command "node") {
+        Write-Warn "Node.js $(node -v) 版本过低，需要 >= $MIN_NODE_MAJOR"
+    }
+    Write-Info "安装 Node.js LTS..."
+    if (Test-HasWinget) {
+        winget install OpenJS.NodeJS.LTS --accept-source-agreements --accept-package-agreements --silent
+        Refresh-Path
+    } else {
+        Write-Info "未检测到 winget，尝试下载 Node.js 安装包..."
+        $arch = if ([Environment]::Is64BitOperatingSystem) { "x64" } else { "x86" }
+        $nodeUrl = "https://nodejs.org/dist/latest-v22.x/node-v22.0.0-${arch}.msi"
+        # 获取实际最新 LTS 版本
+        try {
+            $versions = Invoke-RestMethod "https://nodejs.org/dist/index.json" -UseBasicParsing
+            $lts = ($versions | Where-Object { $_.lts -ne $false } | Select-Object -First 1).version
+            $nodeUrl = "https://nodejs.org/dist/${lts}/node-${lts}-${arch}.msi"
+        } catch {
+            Write-Warn "无法获取最新版本号，使用默认版本"
+        }
+        $nodeInstaller = "$env:TEMP\node-installer.msi"
+        Invoke-WebRequest -Uri $nodeUrl -OutFile $nodeInstaller -UseBasicParsing
+        Start-Process msiexec.exe -ArgumentList "/i","$nodeInstaller","/qn","/norestart" -Wait
+        Remove-Item $nodeInstaller -Force -ErrorAction SilentlyContinue
+        Refresh-Path
+    }
+    if ((Get-NodeMajor) -ge $MIN_NODE_MAJOR) {
+        Write-Ok "Node.js $(node -v) 安装成功"
+    } else {
+        Write-Fail "Node.js 安装失败，请手动安装: https://nodejs.org"
+    }
+}
+
+# ========== 主流程 ==========
+
+# 修复执行策略（仅当前用户）
+try {
+    Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned -Force -ErrorAction SilentlyContinue
+} catch {}
+
+Install-GitIfNeeded
+Install-NodeIfNeeded
+
+Write-Host ""
+Write-Host "  ========================================" -ForegroundColor Green
+Write-Host "  环境安装完成!" -ForegroundColor Green
+Write-Host "  ========================================" -ForegroundColor Green
+Write-Host ""
+Write-Ok "Git:  $(git --version)"
+Write-Ok "Node: $(node -v)"
+Write-Ok "npm:  $(npm -v)"
+Write-Host ""
+
+Write-Info "正在启动 ${PACKAGE}..."
+Write-Host ""
+& npx.cmd "${PACKAGE}@latest"

package/install.sh

@@ -0,0 +1,188 @@
+#!/usr/bin/env bash
+# ============================================================
+# maxapi 一键环境安装脚本（macOS / Linux / WSL）
+# 用法（Node.js 不存在时，先装 Node.js 再 npx）:
+#   bash install.sh
+#   bash install.sh llmaxapi
+#   bash install.sh --no-run
+# ============================================================
+set -euo pipefail
+
+# ---------- 配置 ----------
+PACKAGE="${1:-yymaxapi}"
+NO_RUN=false
+MIN_NODE_MAJOR=18
+
+for arg in "$@"; do
+  case "$arg" in
+    --no-run) NO_RUN=true ;;
+    yymaxapi|llmaxapi) PACKAGE="$arg" ;;
+  esac
+done
+
+# ---------- 颜色 ----------
+RED='\033[0;31m'; GREEN='\033[0;32m'
+YELLOW='\033[1;33m'; CYAN='\033[0;36m'; NC='\033[0m'
+
+ok()   { echo -e "${GREEN}✓${NC} $1"; }
+info() { echo -e "${CYAN}→${NC} $1"; }
+warn() { echo -e "${YELLOW}⚠${NC} $1"; }
+fail() { echo -e "${RED}✗${NC} $1"; exit 1; }
+
+# ---------- 平台检测 ----------
+OS="$(uname -s)"
+ARCH="$(uname -m)"
+IS_WSL=false
+grep -qiE '(microsoft|wsl)' /proc/version 2>/dev/null && IS_WSL=true
+
+echo ""
+echo -e "${CYAN}╔══════════════════════════════════════╗${NC}"
+echo -e "${CYAN}║   maxapi 一键环境安装 (${PACKAGE})     ${NC}"
+echo -e "${CYAN}╚══════════════════════════════════════╝${NC}"
+echo ""
+info "系统: ${OS} ${ARCH}$($IS_WSL && echo ' (WSL)' || true)"
+echo ""
+
+# ---------- 工具函数 ----------
+has_cmd() { command -v "$1" &>/dev/null; }
+
+node_version_ok() {
+  if ! has_cmd node; then return 1; fi
+  local ver
+  ver="$(node -v | tr -d 'v' | cut -d. -f1)"
+  [ "$ver" -ge "$MIN_NODE_MAJOR" ] 2>/dev/null
+}
+
+detect_pkg_manager() {
+  if has_cmd apt-get;  then echo "apt";    return; fi
+  if has_cmd dnf;      then echo "dnf";    return; fi
+  if has_cmd yum;      then echo "yum";    return; fi
+  if has_cmd pacman;   then echo "pacman"; return; fi
+  if has_cmd apk;      then echo "apk";    return; fi
+  if has_cmd zypper;   then echo "zypper"; return; fi
+  if has_cmd brew;     then echo "brew";   return; fi
+  echo "unknown"
+}
+
+# ---------- 安装 Git ----------
+install_git() {
+  if has_cmd git; then
+    ok "Git $(git --version | awk '{print $3}') 已安装"
+    return
+  fi
+  info "安装 Git..."
+  case "$OS" in
+    Darwin)
+      if has_cmd brew; then
+        brew install git
+      else
+        info "通过 Xcode Command Line Tools 安装..."
+        xcode-select --install 2>/dev/null || true
+        warn "请在弹出窗口中点击「安装」，完成后重新运行此脚本"
+        exit 0
+      fi ;;
+    Linux)
+      local pm; pm="$(detect_pkg_manager)"
+      case "$pm" in
+        apt)    sudo apt-get update -qq && sudo apt-get install -y -qq git ;;
+        dnf)    sudo dnf install -y git ;;
+        yum)    sudo yum install -y git ;;
+        pacman) sudo pacman -S --noconfirm git ;;
+        apk)    sudo apk add git ;;
+        zypper) sudo zypper install -y git ;;
+        *)      fail "无法自动安装 Git，请手动安装: https://git-scm.com" ;;
+      esac ;;
+    *) fail "不支持的操作系统: $OS" ;;
+  esac
+  has_cmd git && ok "Git 安装成功" || fail "Git 安装失败"
+}
+
+# ---------- 安装 Node.js ----------
+install_node() {
+  if node_version_ok; then
+    ok "Node.js $(node -v) 已安装"
+    return
+  fi
+
+  if has_cmd node; then
+    warn "Node.js $(node -v) 版本过低，需要 >= ${MIN_NODE_MAJOR}"
+  fi
+
+  info "安装 Node.js (via fnm)..."
+
+  # fnm: 快速 Node 版本管理器，单二进制，跨平台
+  if ! has_cmd fnm; then
+    curl -fsSL https://fnm.vercel.app/install | bash -s -- --skip-shell
+  fi
+
+  # 加载 fnm 到当前 shell
+  export FNM_DIR="${FNM_DIR:-$HOME/.local/share/fnm}"
+  if [ -d "$FNM_DIR" ]; then
+    export PATH="$FNM_DIR:$PATH"
+  elif [ -d "$HOME/.fnm" ]; then
+    export PATH="$HOME/.fnm:$PATH"
+  fi
+  eval "$(fnm env)" 2>/dev/null || true
+
+  fnm install --lts
+  fnm use lts-latest
+  eval "$(fnm env)" 2>/dev/null || true
+
+  if node_version_ok; then
+    ok "Node.js $(node -v) 安装成功"
+  else
+    fail "Node.js 安装失败，请手动安装: https://nodejs.org"
+  fi
+
+  # 提示用户添加 fnm 到 shell profile
+  local shell_profile=""
+  case "${SHELL:-}" in
+    */zsh)  shell_profile="$HOME/.zshrc" ;;
+    */bash) shell_profile="$HOME/.bashrc" ;;
+    */fish) shell_profile="$HOME/.config/fish/config.fish" ;;
+  esac
+
+  if [ -n "$shell_profile" ] && ! grep -q 'fnm env' "$shell_profile" 2>/dev/null; then
+    warn "建议将以下内容添加到 ${shell_profile}:"
+    echo '  eval "$(fnm env --use-on-cd --shell '"${SHELL##*/}"')"'
+  fi
+}
+
+# ---------- 安装 curl（极少数 Linux 缺失） ----------
+install_curl() {
+  if has_cmd curl; then return; fi
+  info "安装 curl..."
+  local pm; pm="$(detect_pkg_manager)"
+  case "$pm" in
+    apt)    sudo apt-get update -qq && sudo apt-get install -y -qq curl ;;
+    dnf)    sudo dnf install -y curl ;;
+    yum)    sudo yum install -y curl ;;
+    pacman) sudo pacman -S --noconfirm curl ;;
+    apk)    sudo apk add curl ;;
+    *)      fail "请先手动安装 curl" ;;
+  esac
+}
+
+# ========== 主流程 ==========
+install_curl
+install_git
+install_node
+
+echo ""
+echo -e "${GREEN}╔══════════════════════════════════════╗${NC}"
+echo -e "${GREEN}║   环境安装完成!                       ${NC}"
+echo -e "${GREEN}╚══════════════════════════════════════╝${NC}"
+echo ""
+ok "Git:    $(git --version | awk '{print $3}')"
+ok "Node:   $(node -v)"
+ok "npm:    $(npm -v)"
+echo ""
+
+if [ "$NO_RUN" = true ]; then
+  info "跳过运行 ${PACKAGE}（--no-run）"
+  info "手动运行: npx ${PACKAGE}@latest"
+else
+  info "正在启动 ${PACKAGE}..."
+  echo ""
+  npx "${PACKAGE}@latest"
+fi

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yymaxapi",
-  "version": "1.0.22",
+  "version": "1.0.24",
   "description": "跨平台 OpenClaw/Clawdbot 配置管理工具 - 管理中转地址、模型切换、API Keys、测速优化",
   "main": "bin/yymaxapi.js",
   "bin": {
@@ -26,7 +26,9 @@
     "bin/",
     "lib/",
     "README.md",
-    "config/API节点设置.md"
+    "config/API节点设置.md",
+    "install.sh",
+    "install.ps1"
   ],
   "dependencies": {
     "inquirer": "^8.2.5",