WorkBuddy在虚拟机中运行异常的主因是硬件虚拟化未启用，需依次确认宿主机BIOS开启VT-x/AMD-V、虚拟机软件启用嵌套虚拟化与CPU透传、分配8GB固定内存并禁用冲突服务、使用认证操作系统及NTFS/ext4/APFS文件系统、修改launch.json添加--no-sandbox参数绕过虚拟化检测。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试在虚拟机中安装并运行WorkBuddy，但出现启动缓慢、界面卡顿、模型加载失败或长时间无响应等现象，则可能是由于虚拟机未启用硬件虚拟化支持，导致CPU指令集（如AVX2）、GPU直通能力及内存映射机制无法正常工作。以下是针对性的排查与配置步骤：
一、确认宿主机BIOS/UEFI中已开启硬件虚拟化
WorkBuddy依赖AVX2指令集执行本地混元Lite推理引擎，而该指令集在未启用Intel VT-x/AMD-V时无法被虚拟机识别，将强制降级至纯API模式并引发严重性能衰减。必须确保物理CPU的硬件虚拟化功能已在固件层激活。
1、重启宿主机，在开机自检阶段反复按Del、F2、F10或Esc键进入BIOS/UEFI设置界面。
2、切换至“Advanced”、“CPU Configuration”或“Security”选项卡，查找以下任一字段：Intel Virtualization Technology、Intel VT-x、AMD-V、SVM Mode。
3、将其设置为Enabled，保存退出（通常按F10 → Yes）。
4、重新启动后，在Windows宿主机中打开任务管理器 → “性能”选项卡 → 查看右下角是否显示“虚拟化：已启用”；Linux宿主机可在终端执行egrep -c '(vmx|svm)' /proc/cpuinfo，返回值大于0即表示生效。
二、在虚拟机软件中启用嵌套虚拟化与CPU特性透传
即使宿主机已开启VT-x/AMD-V，主流虚拟机平台（如VMware Workstation、VirtualBox、Hyper-V）默认仍屏蔽底层CPU扩展指令，需手动配置以允许Guest OS完整访问AVX2、AES-NI等关键指令集。
1、关闭正在运行的WorkBuddy虚拟机，确保其处于“已关机”状态（非挂起或休眠）。
2、在VMware中：右键虚拟机 → “设置” → “处理器” → 勾选“虚拟化Intel VT-x/EPT或AMD-V/RVI”与“虚拟化CPU性能计数器”；若使用Workstation 17+，还需勾选“启用嵌套虚拟化”。
3、在VirtualBox中：选择虚拟机 → “设置” → “系统” → “加速”选项卡 → 将“硬件虚拟化”下的两项全部勾选（启用VT-x/AMD-V、启用嵌套分页）；再切换至“处理器”选项卡 → 将“处理器数量”设为≥2，并勾选“启用PAE/NX”。
4、在Windows Hyper-V中：以管理员身份运行PowerShell，执行命令：Set-VMProcessor "WorkBuddy-VM" -ExposeVirtualizationExtensions $true，其中“WorkBuddy-VM”为您的虚拟机名称。
三、分配满足最低要求的硬件资源并禁用冲突服务
WorkBuddy在虚拟环境中运行需独占式资源保障，动态内存、共享显存或后台防病毒扫描均会导致调度延迟与I/O抖动，必须固化资源配置并隔离干扰源。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
1、为虚拟机分配至少8GB固定内存（不可启用动态内存），并在操作系统内验证：Windows Guest中打开任务管理器 → “性能” → “内存”，确认“已提交”与“总计”数值一致；Linux Guest中执行free -h，观察“total”与“available”差值小于500MB。
2、显卡设置中禁用3D加速（避免OpenGL兼容性问题），改为分配至少128MB专用视频内存，并确保Guest OS已安装对应虚拟显卡驱动（如VMware Tools或VirtualBox Guest Additions）。
3、在虚拟机内部关闭Windows Defender实时保护、第三方杀软服务及自动更新任务，执行命令：sc stop WinDefend && sc config WinDefend start= disabled（管理员CMD）。
四、验证虚拟机操作系统与文件系统合规性
WorkBuddy官方仅认证特定虚拟环境组合，非标准发行版或不兼容文件系统将触发沙箱初始化失败、缓存写入拒绝等底层错误，必须严格匹配部署规范。
1、虚拟机操作系统必须为：Windows 10 2004+（64位）、macOS 12+（仅Apple Silicon虚拟化方案如UTM）、Ubuntu 22.04 LTS（x86_64）；禁止使用CentOS Stream、Debian Testing、Arch Linux等未经测试版本。
2、安装路径所在磁盘格式必须为：NTFS（Windows）、APFS（macOS）、ext4（Linux）；若使用VirtualBox挂载VHD/VHDX为第二磁盘，请先格式化为目标文件系统，再将WorkBuddy安装至该分区。
3、检查安装路径是否含中文、空格或特殊字符（如C:\Program Files\WorkBuddy中的空格会触发权限异常），应改用类似D:\WB\的纯英文无符号路径。
五、绕过虚拟化检测与沙箱限制机制
WorkBuddy启动时主动探测运行环境，若识别为VMware/VirtualBox/Hyper-V等虚拟平台，将自动禁用Claw远程控制子系统与本地模型路由模块，造成功能缺失与响应迟滞。需通过配置参数抑制该行为。
1、定位WorkBuddy安装目录下的resources\app.asar.unpacked\config\launch.json（Windows/macOS）或/opt/WorkBuddy/resources/app.asar.unpacked/config/launch.json（Linux）。
2、用文本编辑器打开该文件，在"args"数组中新增字符串项："--disable-gpu-sandbox"与"--no-sandbox"。
3、保存文件后，在虚拟机中以命令行方式启动：Windows执行WorkBuddy.exe --disable-gpu-sandbox --no-sandbox；macOS执行open -a "WorkBuddy.app" --args --disable-gpu-sandbox --no-sandbox；Linux执行./WorkBuddy --disable-gpu-sandbox --no-sandbox。
