若安装workbuddy时提示“node.js版本不支持”，需用nvm切换至v18.20.4等兼容lts版本：先卸载系统级node.js，再安装nvm，接着安装并设为默认版本，清理缓存后重装依赖，最后可选创建.nvmrc实现项目级版本锁定。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在安装WorkBuddy时收到“Node.js版本不支持”的提示，则说明当前系统中安装的Node.js运行时版本与WorkBuddy要求的版本范围不匹配。以下是使用nvm（Node Version Manager）切换和管理Node.js版本的具体操作步骤：
一、确认当前Node.js版本并卸载系统自带版本
nvm无法管理通过官网安装包、Homebrew（macOS）或apt（Linux）直接安装的Node.js，必须先移除这些全局安装的版本，避免路径冲突和版本覆盖异常。
1、在终端中执行 node -v 和 which node，记录当前版本号及可执行文件路径。
2、若输出路径包含 /usr/local/bin/node 或 /opt/homebrew/bin/node（macOS）或 /usr/bin/node（Linux），说明为系统级安装，需手动卸载。
3、macOS上执行 sudo rm -rf /usr/local/bin/node /usr/local/bin/npm /usr/local/lib/node_modules；Linux上执行 sudo apt remove nodejs npm --purge（Debian/Ubuntu）或 sudo dnf remove nodejs npm（Fedora）。
4、关闭并重新打开终端，再次运行 which node，应返回空结果，表示系统级Node.js已清除。
二、安装nvm并验证环境
nvm是一个独立于系统Node.js的版本管理工具，它将不同版本的Node.js安装到用户目录下，并通过shell配置动态切换PATH，确保多版本共存且互不干扰。
1、访问nvm官方GitHub仓库，复制安装脚本地址，或直接在终端中运行：curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash。
2、根据安装脚本末尾提示，在终端中执行对应命令加载nvm，例如：export NVM_DIR="$HOME/.nvm" && [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"。
3、将nvm初始化代码添加至shell配置文件：对bash用户编辑 ~/.bashrc，对zsh用户编辑 ~/.zshrc，追加以下三行：
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"
4、执行 source ~/.bashrc 或 source ~/.zshrc 使配置生效，再运行 nvm --version 确认输出版本号。
三、安装并切换至WorkBuddy兼容的Node.js版本
WorkBuddy通常要求Node.js v18.x或v20.x长期支持版（LTS），使用nvm可精确安装指定版本，并设为默认，确保后续所有终端会话均使用该版本。
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表，就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
1、运行 nvm list-remote 查看所有可用版本，查找以 v18.20.4 或 v20.15.1 结尾的LTS版本标识（如 v18.20.4 (Latest LTS: Hydrogen)）。
2、执行 nvm install 18.20.4 完成下载、编译与安装；等待提示 Now using node v18.20.4 (npm v10.7.0)。
3、运行 nvm alias default 18.20.4 将该版本设为默认，新打开的终端将自动启用此版本。
4、新开一个终端窗口，执行 node -v 和 npm -v，确认输出为 v18.20.4 和对应npm版本。
四、重试WorkBuddy安装并验证依赖兼容性
在正确版本的Node.js环境下，WorkBuddy的依赖解析器（如pnpm或npm）能准确识别peer dependencies和engines字段，避免因版本校验失败导致的安装中断。
1、进入WorkBuddy项目根目录，执行 rm -rf node_modules package-lock.json 清除旧依赖缓存。
2、运行 npm install 或 pnpm install（依据项目实际使用的包管理器）。
3、若仍报错，检查项目根目录下的 package.json 文件中 "engines" 字段，确认其指定的Node.js范围是否与当前nvm所用版本一致。
4、如需临时切换版本测试，可执行 nvm use 20.15.1，再重复安装步骤。
五、设置项目级Node.js版本锁定（可选但推荐）
为防止团队协作中因本地Node.js版本不一致引发构建失败，可在项目根目录创建 .nvmrc 文件，显式声明所需版本，使nvm能自动适配。
1、在WorkBuddy项目根目录中执行：echo "18.20.4" > .nvmrc。
2、进入该项目目录后，运行 nvm use（不带参数），nvm将自动读取 .nvmrc 并切换至指定版本。
3、将 .nvmrc 提交至Git仓库，确保所有协作者执行 nvm use 时获得统一运行时环境。
4、验证效果：退出项目目录后执行 nvm current 显示全局默认版本；重新进入项目目录后再次执行，应显示 v18.20.4。
