WorkBuddy在Win10老电脑上卡顿或闪退，主因是CPU不支持AVX2指令集、可用内存不足2GB、安装路径非NTFS或含非法字符、网络未放行auth.codebuddy.cn、系统为精简版或版本过低。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Win10老电脑安装WorkBuddy时卡在“正在加载技能市场”或启动后白屏闪退，不是系统太旧，而是CPU不支持AVX2指令集、内存被系统和其他进程挤占到不足2GB可用空间、或安装路径用了FAT32移动硬盘——这些条件不满足，WorkBuddy连本地模型路由模块都拉不起来。
确认CPU是否支持AVX2
这一步决定WorkBuddy能否启用混元Lite本地推理引擎。不支持就只能走纯API模式，延迟飙升、Claw卡顿、文档摘要类Agent直接初始化失败。
Windows用户打开命令提示符（管理员），输入：
wmic cpu get name,architecture,extclock
查出型号后对照：Intel第4代Core（Haswell）起，如i5-4200U；AMD Ryzen 1000系列起，如Ryzen 5 1600。i3-3220、Xeon E5-2620 v1、A10-7850K这类老U均【不支持AVX2】，硬装只会卡死或降级失效。
Linux/macOS用户直接运行：
grep -o avx2 /proc/cpuinfo
有输出才表示支持；没输出就不用继续了——换设备或改用Web版。
检查真实可用内存是否≥2GB
4GB物理内存≠4GB可用。WorkBuddy启动后Claw子系统需独占2GB，系统+Chrome+杀毒软件一开，剩余可用内存常跌破1.5GB，触发Windows内存压缩机制强制终止进程。
第一步：按Ctrl+Shift+Esc打开任务管理器→切换到“性能”选项卡→点击左侧“内存”→盯住右上角“可用”数值。
第二步：关闭所有浏览器标签页、VS Code、Docker Desktop、微信PC版等高内存程序。
第三步：重启电脑后立刻打开任务管理器，记录“可用”值。若仍＜2GB，说明硬件已达硬性瓶颈，【强行安装会导致多步骤任务中断或UI冻结】。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
这一步操作起来很简单，但很多人跳过——直接双击安装包，结果卡在“正在加载技能市场”界面不动。
验证安装路径与磁盘格式
WorkBuddy首次运行要解压运行时、生成知识索引、写入沙箱快照，这些操作必须依赖NTFS文件系统的硬链接与权限控制能力。FAT32/exFAT移动硬盘、含中文或空格的路径（如C:\Program Files (x86)\WorkBuddy），都会让初始化中断或技能市场返回403错误。
方法一：右键点击目标安装盘符→“属性”→查看“文件系统”是否为NTFS。不是？格式化前请备份数据。
方法二：安装路径必须是纯英文、无空格、无符号，推荐格式：
D:\WorkBuddy 或 C:\WB
注意：不要选C:\Users\用户名\Downloads这类默认下载目录——里面常有临时文件锁，会导致权限冲突。
放行域名并禁用精简版系统
首次启动必须直连公网访问auth.codebuddy.cn完成许可证校验，断网或防火墙拦截会卡在“正在加载技能市场”。同时，某些Ghost精简版系统移除了关键API（如CreateProcessAsUser、SetThreadDesktop），WorkBuddy主进程根本无法创建沙箱环境。
打开浏览器，手动访问 https://auth.codebuddy.cn ——能正常打开登录页，说明网络通；打不开则检查代理设置或企业防火墙策略。
在【设置 → 系统 → 关于】中确认“系统类型”为“64位操作系统，基于x64的处理器”，再核对“Windows规格”里版本号≥19041（即Win10 2004）。低于此版本的系统安装包会直接拒绝运行。
如果系统显示“Windows 10 企业版LTSB”或“Windows 10 S模式”，【属于官方明确不支持的变体，必须重装标准版】。
