SuperAPI AI 工具集

setup-node

部署与运维

查看项目

更新于 10-21 19:58

技能介绍

用途

setup-node 用于为当前用户安装一套可用的 Node.js LTS 环境,包含 npm 和 npx,使 npx、npm install -g 以及依赖它们的命令行工具能够运行。它适用于当 node、npm 或 npx 不可用或版本过低时的场景。

主要能力

  • 先做检查:如果 node --version 输出 v20 或更高,且 npm --version 可用,则直接说明并停止。
  • 识别操作系统:用 uname -s 判断(Darwin 为 macOS,Linux 为 Linux);如果该命令失败或由 PowerShell 响应,则视为 Windows。
  • macOS 上确保 Homebrew 存在:查找 /opt/homebrew/bin/brew(Apple Silicon)或 /usr/local/bin/brew(Intel)。若两者都不存在,需要用户手动运行安装命令,因为安装 Homebrew 需要一次 Mac 密码。
  • 安装 Node:macOS 和 Linux 运行 scripts/install-node.sh;macOS 上使用 brew install node 并把 Homebrew 写入 shell 配置;Linux 或使用 --no-brew 时,将官方 Node LTS 下载到 ~/.local/node,无需管理员密码。Windows 使用 winget install --id OpenJS.NodeJS.LTS -e --accept-source-agreements --accept-package-agreements,然后请用户关闭并重新打开 Claude 会话。
  • 处理当前会话:macOS 上用 eval "$(/opt/homebrew/bin/brew shellenv)"(Intel 为 /usr/local/bin/brew),或对 ~/.local 安装使用 export PATH="$HOME/.local/node/bin:$PATH"。
  • 确保全局安装无需管理员权限:运行 npm config get prefix;若 npm install -g 因 EACCES 失败,运行 npm config set prefix ~/.local 并确保 ~/.local/bin 在 shell 配置中。明确不使用 sudo npm。
  • 验证:运行 node --version && npm --version && npx --version,再用 npx -y cowsay ok 输出一头牛;并用 $SHELL -lic 'node --version' 确认新会话也能找到相同版本,否则先修复 shell 配置。

使用方式

该技能以脚本和命令步骤的形式执行。若从链接而非本地文件夹获取此技能,不要从仓库安装其他内容:仅在某个步骤需要时,用 curl -fsSL https://raw.githubusercontent.com/Melvynx/ai-maxxing-skills/main/skills/setup-node/<path> -o <scratch>/<file> 下载其链接的文件(例如 scripts/install-node.sh),并且只在执行到某一步时才读取它提到的其他技能,地址为 https://raw.githubusercontent.com/Melvynx/ai-maxxing-skills/main/skills/<skill-name>/SKILL.md。

与用户交流时使用对方语言,消息简短,避免术语(不要对用户说 “PATH”、“prefix” 或 “LTS”)。

适用场景

  • 需要 npx、npm install -g 或依赖它们的 CLI 工具正常工作。
  • 在 macOS、Linux 或 Windows 上为当前用户配置 Node.js 环境。
  • 需要避免管理员权限进行全局安装。

限制

  • macOS 上安装 Homebrew 需要用户手动操作并输入一次 Mac 密码,无法由技能自行完成。
  • 如果 Mac 账户不是管理员且安装被拒绝,则跳过 Homebrew,并对每个 setup 技能的安装脚本传入 --no-brew。
  • 当前会话不会立即看到新安装,需要按上述方式调整环境变量。
  • 资料未提供其他平台细节、收费信息或额外功能说明。