WorkBuddy 仅支持 Windows 10/11（64位，需AVX2且版本≥19041）、macOS 12+（须授予权限）、Ubuntu 20.04+/CentOS 8+（依赖版本严格），安装路径禁中文空格，首次需联网激活 auth.codebuddy.cn。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
WorkBuddy 只支持 Windows 10/11（64 位）、macOS 12+、Ubuntu 20.04+/CentOS 8+ 这三类系统，其他所有组合均未通过官方验证，强行安装大概率启动失败或功能残缺。
Windows 用户必须确认两件事
一是系统版本不低于 Windows 10 2004（即 19041 版本号），旧版如 1903 或 Windows 7/8 直接无法加载主进程；二是 CPU 必须支持 AVX2 指令集——Intel 第 4 代 Core（Haswell）起、AMD Ryzen 1000 系列起才满足，否则 混元 Lite 推理引擎加载失败，自动降级为纯 API 模式，本地 AI 能力基本不可用。
- 检查方法：
winver查版本，cmd中运行coreinfo -f（需提前下载 Sysinternals 工具）看输出是否含AVX2 - 常见错误现象：
Claw 启动失败、AI 指令无响应、日志中反复出现Failed to load model: avx2 not supported - 安装路径不能含中文、空格或
&#%等符号，否则技能市场下载返回403
macOS 用户最容易忽略的权限链
macOS 12 Monterey 是硬性门槛，11.x（Big Sur）及更早版本会卡在启动画面，控制台报错 dyld: symbol not found: _objc_allocWithZone。Apple Silicon（M1/M2/M3）和 Intel 均支持，但首次启动时必须一次性授予三项权限：「辅助功能」「完全磁盘访问」「屏幕录制」——缺一不可，且不能跳过引导流程。
- 若已跳过，必须进主界面点击右上角头像 →
系统权限修复才能重新触发弹窗 - 权限开关藏得深：系统设置 → 隐私与安全性 → 向下滚动才能看到全部条目
- macOS Sonoma/Sequoia 用户注意：Gatekeeper 公证已通过，但若从非 dmg 方式（如 tar.gz 解压）运行，仍会被拦截
Linux 用户请严格对照发行版白名单
仅 Ubuntu 20.04 LTS、22.04 LTS、CentOS 8+ 被官方测试并签名，Arch、Debian、Fedora、openSUSE 等不在支持范围内。即使内核版本达标（≥5.4），也极可能因 GLIBC（要求 ≥2.31）、OpenSSL（≥1.1.1f）或 systemd 版本不匹配导致 segmentation fault 或服务静默退出。
- 检查命令：
cat /etc/os-release确认 ID 和 VERSION_ID；ldd --version和openssl version核对基础依赖 - 安装包必须用官方提供的
.deb（Ubuntu）或.rpm（CentOS），.AppImage仅限测试，不保证沙箱稳定 - systemd 必须启用：
sudo systemctl is-active workbuddy-claw应返回active，否则后台监听（默认端口 8081）不会启动
最常被忽略的是「首次联网激活」这个环节——哪怕系统完全符合，只要 auth.codebuddy.cn 的 443 端口不通（比如企业防火墙拦截、代理未配置、SSL 劫持软件开启），整个初始化流程就会卡死在登录页，后续所有功能都不可用。
