workbuddy“指令集不支持”提示源于cpu缺少avx2指令集，解决方案包括：一、用cpu-z（win）、sysctl（macos）或grep（linux）确认avx2缺失；二、修改config.yaml启用fallback_mode: api_only降级为纯api模式；三、卸载后安装官方legacy安装包；四、高级用户可手动替换为onnx runtime引擎。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在安装 WorkBuddy 时收到“指令集不支持”提示，说明当前 CPU 缺少 AVX2 指令集，而 WorkBuddy 内置的混元 Lite 推理引擎强制依赖该指令集。以下是针对老旧 CPU 的适配方案：
一、确认 CPU 是否缺失 AVX2
该步骤用于验证错误根源，避免误判为其他兼容性问题。AVX2 是 Intel 第 4 代 Core（Haswell）及 AMD Ryzen 1000 系列起才引入的指令集，老旧处理器如 Intel Core 2 Duo、i3-2100、AMD FX 系列均不支持。
1、Windows 用户：下载并运行 CPU-Z 工具，切换至“Instructions”标签页，查看列表中是否勾选 AVX2；若未勾选，则确认缺失。
2、macOS 用户：在终端执行 sysctl -a | grep machdep.cpu.leaf7_features，输出中若不含 avx2 字样，则不支持。
3、Linux 用户：在终端输入 grep avx2 /proc/cpuinfo，若无任何输出，即表示硬件不支持。
二、启用纯 API 模式降级运行
WorkBuddy 在检测到 AVX2 不可用时，会自动禁用本地推理引擎，转而调用云端 API 执行 AI 任务。该模式无需修改安装包，但需手动触发降级流程以确保配置生效。
1、关闭所有 WorkBuddy 进程，包括系统托盘残留项。
2、在安装目录下找到 config.yaml 文件（路径示例：Windows 为 C:\Program Files\WorkBuddy\config.yaml，macOS 为 /Applications/WorkBuddy.app/Contents/Resources/config.yaml）。
3、用文本编辑器打开该文件，在 engine: 区块下添加或修改字段：fallback_mode: api_only。
4、保存文件后，以管理员身份（Windows）或终端命令（macOS/Linux）启动 WorkBuddy，首次启动将跳过本地模型加载，直接进入 API 绑定流程。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
三、使用 Legacy 安装包绕过检测
官方为无法升级硬件的用户提供了专版 Legacy 安装包，该版本移除了 AVX2 启动校验逻辑，并默认禁用混元 Lite 引擎，仅保留基础自动化与插件调度能力，适用于 Pentium G4560、Core i5-3470 等老平台。
1、访问 WorkBuddy 官方兼容支持页：https://www.codebuddy.cn/work/legacy。
2、根据操作系统选择对应 Legacy 版本（标注含 no-avx2 或 legacy-cpu 字样）。
3、下载后，**必须卸载当前已安装的 WorkBuddy 主程序**，再运行 Legacy 安装包；残留主程序会覆盖配置导致降级失效。
4、安装完成后，在「关于」页面确认版本号末尾含 -legacy 标识，例如 v1.3.2-legacy-20260309。
四、手动替换运行时引擎（高级）
若需保留部分本地推理能力，可替换为轻量级 ONNX Runtime，该引擎仅依赖 SSE4.2，兼容 Sandy Bridge 及以后所有 x86-64 CPU，但需手动部署并调整配置路径。
1、从微软官方 GitHub 下载 onnxruntime-win-x64-1.16.3.zip（Windows）或 onnxruntime-osx-universal2-1.16.3.tar.gz（macOS）。
2、解压后，将其中 onnxruntime.dll（Windows）或 libonnxruntime.dylib（macOS）复制到 WorkBuddy 安装目录下的 engine/ 子目录。
3、编辑 config.yaml，将 engine.type 修改为 onnx，并将 engine.path 指向新复制的动态库文件绝对路径。
4、重启 WorkBuddy，观察日志窗口是否输出 ONNX Runtime initialized successfully 提示。
