yingclaw 2.5.0 → 2.5.1

package/bin/cli.js

@@ -21,7 +21,7 @@ const {
 const { execSync, spawn, spawnSync } = require('child_process');
 const pkg = require('../package.json');
 const { buildMenuStatusLines, buildStatusView } = require('../lib/panel');
-const { buildClaudeInstallCommand } = require('../lib/install');
+const { buildClaudeInstallCommand, checkNodeEnv, getNodeInstallGuide, getInstallFailureHints } = require('../lib/install');
 const { clearClaudeDesktopConfig, isDesktopConfigured, openClaudeDesktop, writeClaudeDesktopConfig } = require('../lib/desktop');
 const { runDoctorChecks, summarize, STATUS_OK, STATUS_FAIL, STATUS_WARN, STATUS_INFO } = require('../lib/doctor');
 
@@ -402,6 +402,31 @@ program
       if (!yes) return;
     } catch {}
 
+    // 检查 npm / Node.js 环境
+    const nodeEnv = checkNodeEnv();
+    if (!nodeEnv.npmOk) {
+      console.log(boxen(
+        chalk.bold.red('未检测到 npm，无法安装 Claude Code\n\n') +
+        chalk.dim('Claude Code 通过 npm 安装，需要先安装 Node.js（含 npm）。\n\n') +
+        chalk.bold('安装方式：\n') +
+        getNodeInstallGuide().map(l => chalk.cyan('  ' + l)).join('\n') +
+        '\n\n' + chalk.dim('安装完成后重新运行 claw install-claude'),
+        { padding: { top: 0, bottom: 0, left: 2, right: 2 }, borderStyle: 'round', borderColor: 'red', margin: { top: 1, bottom: 1 } }
+      ));
+      return;
+    }
+    if (!nodeEnv.nodeOk) {
+      console.log(boxen(
+        chalk.bold.yellow(`Node.js 版本过低（当前 v${nodeEnv.nodeVersion}，需要 ≥18）\n\n`) +
+        chalk.dim('Claude Code 要求 Node.js ≥18，当前版本可能导致安装或运行失败。\n\n') +
+        chalk.bold('升级方式：\n') +
+        getNodeInstallGuide().map(l => chalk.cyan('  ' + l)).join('\n'),
+        { padding: { top: 0, bottom: 0, left: 2, right: 2 }, borderStyle: 'round', borderColor: 'yellow', margin: { top: 1, bottom: 1 } }
+      ));
+      const proceed = await confirm({ message: '仍然尝试安装？', default: false });
+      if (!proceed) return;
+    }
+
     const network = await select({ loop: false,
       message: chalk.cyan('你的网络环境'),
       choices: [
@@ -423,10 +448,9 @@ program
       console.log(chalk.green('\n✔ Claude Code 安装成功！'));
     } else {
       console.log(chalk.red('\n✘ 安装失败'));
+      const hints = getInstallFailureHints(result, chalk);
       console.log(boxen(
-        chalk.bold('手动安装：\n\n') +
-        chalk.cyan('npm config set registry https://registry.npmmirror.com\n') +
-        chalk.cyan('npm install -g @anthropic-ai/claude-code'),
+        hints.join(''),
         { padding: { top: 0, bottom: 0, left: 2, right: 2 }, borderStyle: 'round', borderColor: 'yellow', margin: { top: 1, bottom: 1 } }
       ));
       return;

package/lib/install.js

@@ -1,3 +1,5 @@
+const { execSync } = require('child_process');
+
 function buildClaudeInstallCommand(network) {
   const args = ['install', '-g', '@anthropic-ai/claude-code'];
   if (network === 'cn') {
@@ -6,4 +8,87 @@ function buildClaudeInstallCommand(network) {
   return { command: 'npm', args };
 }
 
-module.exports = { buildClaudeInstallCommand };
+function checkNodeEnv() {
+  const nodeVersion = process.versions.node;
+  const nodeMajor = parseInt(nodeVersion.split('.')[0], 10);
+
+  let npmVersion = null;
+  try {
+    // Windows 上 npm 是 .cmd 文件，必须加 shell: true 才能找到
+    npmVersion = execSync('npm --version', {
+      encoding: 'utf8',
+      stdio: ['ignore', 'pipe', 'ignore'],
+      shell: process.platform === 'win32',
+    }).trim();
+  } catch {}
+
+  return {
+    nodeVersion,
+    nodeMajor,
+    nodeOk: nodeMajor >= 18,
+    npmVersion,
+    npmOk: !!npmVersion,
+  };
+}
+
+function getNodeInstallGuide() {
+  const platform = process.platform;
+  if (platform === 'darwin') {
+    return [
+      'Homebrew:   brew install node',
+      '官方安装包: https://nodejs.org  （选 LTS 版本）',
+    ];
+  }
+  if (platform === 'win32') {
+    return [
+      '官方安装包: https://nodejs.org  （选 LTS 版本）',
+      'winget:     winget install OpenJS.NodeJS.LTS',
+    ];
+  }
+  return [
+    'Ubuntu/Debian: sudo apt install nodejs npm',
+    'CentOS/RHEL:   sudo yum install nodejs npm',
+    'nvm（推荐）:   https://github.com/nvm-sh/nvm',
+  ];
+}
+
+/**
+ * 根据 spawnSync 结果判断失败原因，返回对应的提示内容（chalk 字符串数组）。
+ * @param {object} result spawnSync 返回值
+ * @param {Function} chalk chalk 实例
+ * @returns {string[]}
+ */
+function getInstallFailureHints(result, chalk) {
+  // spawnSync 找不到命令（npm 在执行时消失或环境问题）
+  if (result.status === null && result.error?.code === 'ENOENT') {
+    return [
+      chalk.bold.red('npm 命令未找到\n\n'),
+      chalk.dim('安装 Node.js 后重试：\n'),
+      ...getNodeInstallGuide().map(l => chalk.cyan('  ' + l)),
+    ];
+  }
+
+  // 尝试从 stderr 判断权限错误（stdio inherit 时 stderr 为 null，兜底靠文字提示）
+  const stderr = result.stderr ? result.stderr.toString() : '';
+  if (stderr.includes('EACCES') || stderr.includes('permission denied') || stderr.includes('Access is denied')) {
+    const fixes = process.platform === 'win32'
+      ? ['以管理员身份运行 PowerShell / CMD，然后重试']
+      : [
+          'sudo npm install -g @anthropic-ai/claude-code',
+          '或修复 npm 全局目录权限：https://docs.npmjs.com/resolving-eacces-permissions-errors',
+        ];
+    return [
+      chalk.bold.red('权限不足（EACCES）\n\n'),
+      ...fixes.map(l => chalk.cyan('  ' + l)),
+    ];
+  }
+
+  // 通用失败：显示手动安装命令
+  return [
+    chalk.bold('手动安装：\n\n'),
+    chalk.cyan('npm config set registry https://registry.npmmirror.com\n'),
+    chalk.cyan('npm install -g @anthropic-ai/claude-code'),
+  ];
+}
+
+module.exports = { buildClaudeInstallCommand, checkNodeEnv, getNodeInstallGuide, getInstallFailureHints };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yingclaw",
-  "version": "2.5.0",
+  "version": "2.5.1",
   "description": "Claude Code × 国产大模型一键接入：DeepSeek、Kimi、Qwen、MiniMax、GLM、MiMo",
   "main": "index.js",
   "bin": {