workbuddy为原生windows桌面应用，官方不支持wsl2；推荐在windows原生环境部署，需满足系统版本、硬件配置等要求；wsl2仅限调试依赖环境，不可运行主程序。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在Windows子系统WSL2中运行WorkBuddy，但发现其官方支持明确要求无需WSL，则需注意：WorkBuddy为原生桌面应用，设计上不依赖Linux子系统，直接在Windows主机环境部署即可完成全部功能。强行在WSL2中尝试部署将导致GUI缺失、端口绑定失败、文件系统权限异常及辅助功能不可用等问题。以下是符合官方规范且可稳定运行的两种替代路径：
一、在Windows原生环境部署WorkBuddy（推荐）
该方式完全遵循官方兼容性要求，避免WSL2层带来的抽象隔离与API限制，确保文件访问、系统通知、串口通信及自动化操作等核心能力正常启用。
1、确认操作系统为Windows 10或Windows 11（64位），版本号不低于Build 19041。
2、检查硬件配置：CPU为Intel i5-8250U或同级及以上，内存≥8GB，磁盘预留≥2GB可用空间。
3、下载WorkBuddy最新安装包（.exe格式），从官网获取，禁止使用第三方镜像源。
4、右键安装包 → 选择“以管理员身份运行”，在UAC弹窗中点击“是”。
5、安装向导启动后，在权限设置页手动勾选“桌面”“文档”“下载”及自定义工作目录的“文件和文件夹访问权限”。
6、完成安装后，启动WorkBuddy，首次运行时按提示释放3001与3002端口，并关闭SSL劫持类软件（如Fiddler、Charles）。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
二、在WSL2中模拟基础依赖（仅限调试用途）
此方案不启动WorkBuddy主程序，仅复现其部分后端依赖环境，适用于开发者验证Python脚本、API对接逻辑或本地技能模块单元测试，所有操作均在无GUI的终端内进行。
1、确保WSL2已启用并默认版本设为2：wsl --set-default-version 2，且Ubuntu发行版（如22.04）已成功安装并可启动。
2、进入WSL终端，执行系统更新与基础工具安装：sudo apt update && sudo apt upgrade -y && sudo apt install -y python3 python3-pip curl wget gnupg2。
3、创建专用工作目录并切换：mkdir -p ~/workbuddy-dev && cd ~/workbuddy-dev。
4、安装WorkBuddy技能开发所需的核心Python包：sudo pip3 install --upgrade pip && pip3 install requests pydantic python-dotenv。
5、若需调用串口设备（如USB调试器），需在Windows侧将设备接入，并在WSL2中挂载对应端口：sudo usermod -aG dialout $USER，然后重启WSL实例（wsl --shutdown后再重新打开）。
6、验证环境可用性：新建test_env.py，写入import sys; print(sys.version)，执行python3 test_env.py，输出应显示Python 3.10+版本号。
