workbuddy本地模型（混元lite）能否正常加载，取决于cpu是否支持avx2指令集、内存是否≥2gb可用、claw子系统能否稳定运行；任一不满足即降级为纯api模式，导致响应延迟飙升、文档摘要失败、企业微信指令丢包。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
WorkBuddy本地模型（混元Lite）能否正常加载，直接取决于CPU是否支持AVX2指令集、内存是否留出足够缓冲空间供模型推理调度，以及系统能否稳定维持Claw子系统运行——不满足任一条件，模型将降级为纯API模式，导致响应延迟飙升、文档摘要类Agent初始化失败、企业微信指令丢包。
确认CPU是否支持AVX2指令集
这一步决定混元Lite引擎能否启动。不支持就无法启用本地推理，所有依赖模型理解的技能（如PPT自动生成、会议纪要提炼）将直接失效。
Windows用户：按Win+R→输入cmd→回车→执行：
wmic cpu get name,architecture,extclock
查出CPU型号后，对照确认是否为Intel第4代Core（Haswell）起（如i5-4200U）、AMD Ryzen 1000系列起（如Ryzen 5 1600）。【i3-3220、奔腾G系列、赛扬N系列、Xeon E5-2620 v1、A10-7850K等均不支持AVX2，硬装只会触发Failed to load model: avx2 not supported错误】
Linux/macOS用户：终端执行：
grep -o avx2 /proc/cpuinfo
有输出即表示支持；无输出则无需继续——换设备或改用Web版。
验证可用内存是否≥2GB
WorkBuddy启动后，Claw子系统需独占2GB内存保活，剩余内存才供UI和模型调度。4GB物理内存≠可用内存≥2GB，系统+Chrome+杀毒软件一开，实际可用常跌破1.5GB。
第一步：按Ctrl+Shift+Esc打开任务管理器→切换到“性能”选项卡→点击左侧“内存”→盯住右上角“可用”数值。
第二步：关闭所有浏览器标签页、VS Code、Docker Desktop、微信PC版等高内存程序。
第三步：重启电脑后立刻打开任务管理器，记录“可用”值。若仍【强行安装会导致多步骤任务中断或UI冻结】。
检查系统版本与架构兼容性
方法一：Windows用户按Win+R→输入winver→回车，确认内部版本号≥19041（即Windows 10 2004或更高），且系统类型为“64位操作系统，基于x64的处理器”。
方法二：macOS用户前往“关于本机”→查看系统版本是否≥12.0（Monterey），Apple Silicon或Intel x86_64均可，但10.15（Catalina）仅限基础功能，部分权限控制会缺失。
Linux用户执行：
uname -r
确认内核版本≥5.4.0；再运行：
lsb_release -a
确认发行版为Ubuntu 20.04/22.04或CentOS Stream 9。
验证安装路径与磁盘格式
WorkBuddy首次运行需解压运行时、生成知识索引、写入沙箱快照——这些操作强依赖NTFS/APFS/ext4文件系统的硬链接与POSIX权限能力。
右键点击目标安装盘符→“属性”→查看“文件系统”是否为NTFS（Windows）、APFS（macOS）或ext4（Linux）。
安装路径绝对不能含中文、空格、&、#、%等字符。常见踩坑路径：
C:\Program Files\WorkBuddy（空格触发技能市场403）
D:\我的软件\workbuddy（中文导致沙箱初始化失败）
若已装错，必须卸载后重选路径——【已安装目录不可手动迁移或用符号链接替代】。
