5分钟配好WorkBuddy环境，Node.js + Git + .NET 超详细安装指南

💡 一句话总结： 90%的WorkBuddy技能加载失败，都和三件套没装好有关系。本文手把手教你安装Node.js、Git和.NET Desktop Runtime，从下载到验证，5分钟搞定，让AI真正跑起来。

一、为什么WorkBuddy需要这三件套？

二、Node.js 安装篇（核心运行环境）

Node.js是基于Chrome V8引擎的JavaScript运行时，也是WorkBuddy技能生态的核心支撑。

2.1 下载安装包

1. 访问 Node.js 官方网站：https://nodejs.org/zh-cn/
2. 选择左侧LTS版本（长期支持版），页面自动检测系统，点击 Windows Installer (.msi) 64-bit 下载。

💡 为什么一定要选LTS？ LTS是经过充分测试的稳定版本，适合生产环境使用；Current可能不稳定，普通用户选LTS最保险。

2.2 安装步骤（关键环节）

1. 双击运行 .msi 安装包，勾选接受协议 → 点击“Next”。
2. 🔴 最关键的一步：务必确保 “Add to PATH” 选项处于勾选状态（新版一般默认勾选，但务必核对）。
3. 保持npm默认勾选，点击“Install”，等待完成，点击“Finish”。

2.3 验证安装

按下 Win + R 输入 cmd 回车，依次执行：

node -v npm -v

✅ 预期显示版本号如 v24.11.0 和 11.6.1。若提示“不是内部或外部命令”，请检查PATH勾选或重启电脑。

三、Git 安装篇（技能包下载必备）

Git负责从GitHub等平台安全拉取AI技能包。
下载地址： https://git-scm.com/

3.1 下载与安装

1. 官网自动识别系统，或手动选择64-bit Git for Windows Setup。
2. 运行安装程序，一路点击“Next”，注意安装路径保持默认。
3. 关键步骤：调整PATH环境 → 选择 “Git from the command line and also from 3rd-party software”。
4. 其余选项全部保持默认，完成安装。

3.2 验证安装

git --version

预期输出如 git version 2.42.0，即为成功。

四、.NET Desktop Runtime 安装篇（系统交互关键）

.NET Desktop Runtime 是微软提供的运行环境，负责Excel处理、文件整理等技能。没有它，批量文件操作会直接报错。

4.1 下载安装包

访问微软官方页面：https://dotnet.microsoft.com/zh-cn/download/dotnet
找到.NET 6.0 或 .NET 8.0 栏目 → 点击 “Desktop Runtime”（注意不是SDK）→ 选择 x64 下载。

🔍 版本建议： 推荐直接安装 .NET 8.0 Desktop Runtime，兼容性最好。

4.2 安装步骤

1. 右键安装包 → 选择 “以管理员身份运行”。
2. 保持默认选项，点击“安装”。
3. 安装完成后，程序会自动注册环境变量，无需手动配置。

4.3 验证安装

dotnet --list-runtimes

输出中应包含 Microsoft.NETCore.App 8.0.x 或 6.0.x 条目，说明成功。

💡 安装后必做操作： 完全关闭WorkBuddy主程序（包括系统托盘图标），打开安装目录找到 plugin_dependencies.lock 文件并删除，重启WorkBuddy。

五、✅ 最终验证清单（重启电脑后执行）

📌 重启计算机，打开命令提示符（cmd），依次执行以下命令：

🔹 node -v → 显示版本号如 v24.x.x

🔹 npm -v → 显示版本号如 11.x.x

🔹 git --version → 显示 git version 2.x.x

🔹 dotnet --list-runtimes → 显示 Microsoft.NETCore.App 条目

🎉 如果四条命令全部正常输出版本信息，环境配置圆满完成！ 你的电脑已经准备好运行WorkBuddy的全部技能。

六、常见问题 FAQ

🚀 效率加成： 配置好环境后，WorkBuddy技能市场中的自动化脚本、文件批处理、Excel报表将流畅运行。若还希望进一步提速，可尝试在「技能市场」安装FindSkills技能，系统自动匹配最佳工具。

写在最后

Node.js、Git、.NET Desktop Runtime 这三件套，是让WorkBuddy技能市场真正“活”起来的关键。90%以上的技能加载失败，根源都在三样没装好。把这一课补上，你的AI数字员工就能火力全开了。

🔁 最后再强调一遍： 安装完三个组件后，一定要重启电脑。这一步不做，环境变量不会生效，后续所有配置都是白费功夫。按照本文步骤走完所有流程，你的WorkBuddy将稳定运行各类自动化任务！

作者声明本文无利益相关，欢迎值友理性交流，和谐讨论～