WorkBuddy要求Node.js 24.13.0及以上版本，推荐使用fnm管理多版本，其次可选nvm-windows，受限环境可直接部署预编译二进制包。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试运行WorkBuddy应用，但启动失败或提示兼容性错误，则可能是由于Node.js运行环境版本不符合要求。以下是针对WorkBuddy所依赖的Node.js版本限制及对应环境管理方案的详细说明：
一、WorkBuddy官方Node.js版本要求
根据最新兼容性验证，WorkBuddy明确要求运行环境必须满足Node.js 24.13.0及以上版本。该要求源于其底层构建工具链与安全模块对V8引擎特性的强依赖，低于此版本将导致模块加载失败、加密API不可用或进程异常退出。低于24.13.0的任意版本（包括24.12.x、24.11.x等）均不被支持。
二、使用fnm进行多版本管理
Fast Node Manager（fnm）是当前最轻量、跨平台且启动极快的Rust编写的Node.js版本管理器，特别适用于需频繁切换版本的WorkBuddy开发与测试场景。它原生支持Windows PowerShell、Linux Bash及macOS Zsh，并自动识别项目级版本配置文件。
1、访问GitHub发布页下载fnm最新Windows二进制包：https://github.com/Schniz/fnm/releases
2、将下载的fnm.exe文件放入系统PATH路径（如C:\tools\），并确保PowerShell可执行.ps1脚本：执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
3、在PowerShell中初始化fnm：运行fnm install 24.13.0 --node-dist-mirror https://npmmirror.com/mirrors/node以加速国内下载
4、设置项目级版本：在WorkBuddy项目根目录创建.node-version文件，内容仅写入24.13.0
5、进入项目目录后执行fnm use，即可自动激活指定版本并校验node -v输出为v24.13.0
三、使用nvm-windows替代方案
nvm-windows是专为Windows平台设计的Node.js版本管理工具，采用批处理与注册表机制实现版本隔离，与传统Windows开发工具链（如WebStorm、VS Code终端）兼容性极佳，适合已习惯CMD/PowerShell原生命令流的用户。
1、卸载系统中所有已存在的Node.js安装（通过控制面板彻底移除，并删除%APPDATA%\npm与%APPDATA%\npm-cache）
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
2、从https://github.com/coreybutler/nvm-windows/releases下载nvm-setup.zip并解压运行安装程序
3、安装完成后重启PowerShell，执行nvm list available查看可安装版本列表
4、执行nvm install 24.13.0下载并安装目标版本
5、执行nvm use 24.13.0激活该版本，随后运行node -v确认输出结果
四、直接部署预编译二进制包
当开发环境受限（如无管理员权限、企业防火墙禁止脚本执行）时，可跳过版本管理器，直接部署符合要求的Node.js独立运行时。该方式不修改系统PATH，避免与现有工具链冲突，适用于CI/CD临时构建节点或受限终端。
1、前往Node.js官网镜像站（https://npmmirror.com/mirrors/node/）下载node-v24.13.0-win-x64.zip
2、解压至非系统盘路径（如D:\workbuddy\node24），确保路径不含空格与中文
3、在WorkBuddy项目目录下新建start.bat，内容为：D:\workbuddy\node24\node.exe .\index.js
4、双击运行start.bat，进程将严格使用该路径下的Node.js二进制文件启动
