workbuddy 必须运行于原生 arm64 架构并手动授予辅助功能、完全磁盘访问、屏幕录制三项权限，否则ai推理卡顿、自动化失效、录屏不可用；首次启动需访问 auth.codebuddy.cn 绑定许可证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
WorkBuddy 在 Apple Silicon（M1/M2/M3）上必须以原生 arm64 架构运行，否则会触发 Rosetta 2 翻译层，导致 AI 推理卡顿、屏幕录制权限失效、Claw 自动化模块无法启动——这不是性能问题，而是 macOS 对辅助功能权限的硬性限制：只有原生应用才能获得「辅助功能」和「屏幕录制」授权。
确认你下载的是 ARM64 版本安装包
官方页面虽会自动识别芯片，但 Safari 有时缓存旧 UA 导致误推 x86_64 包。务必手动校验：
- 下载完成后，打开「访达」，右键
WorkBuddy.dmg→ 「显示简介」→ 查看「通用」标签页中「种类」是否为「应用程序（ARM）」；若写的是「应用程序（Intel）」，说明下错了 - 或终端执行：
file /Applications/WorkBuddy.app/Contents/MacOS/WorkBuddy，输出含arm64才正确；若含x86_64，立刻删掉重下 - 官方唯一可信入口是 https://www.php.cn/link/34a167480f1ee9328cf6f555ef1b7940，其他带「ai」或「download」子域名的均为镜像或钓鱼站
绕过 macOS 的“已损坏”提示与隔离属性
macOS 会对首次运行的第三方签名应用施加 com.apple.quarantine 属性，导致弹窗报错「已损坏，无法打开」，这不是病毒警告，而是 Gatekeeper 的默认拦截行为。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
- 挂载
WorkBuddy.dmg后，把WorkBuddy.app拖进「应用程序」文件夹 - 打开「终端」，粘贴并执行：
xattr -d com.apple.quarantine /Applications/WorkBuddy.app - 若提示「Operation not permitted」，说明系统完整性保护（SIP）未完全放行——此时不要关终端，直接前往「系统设置 → 隐私与安全性 → 安全性」，在底部点击「仍要打开」
必须手动授予三项核心权限
WorkBuddy 的本地自动化能力（如自动整理文件、控制其他 App、生成 PPT）依赖 macOS 底层接口，缺一不可。系统不会一次性弹出全部请求，需主动补全：
- 「辅助功能」：允许 WorkBuddy 模拟键盘鼠标、操作其他程序。路径：「系统设置 → 隐私与安全性 → 辅助功能 → + → 选中 WorkBuddy」
- 「完全磁盘访问」：用于读写任意位置的文档、桌面、下载目录。路径：同上 →「完全磁盘访问」→ 添加
- 「屏幕录制」：这是最易被忽略的一项，AI 解读截图、生成操作反馈、录屏讲解都靠它。路径：同上 →「屏幕录制」→ 添加
- 授予权限后，必须**完全退出 WorkBuddy（右键菜单栏图标 → 退出），再重新启动**，否则权限不生效
首次启动失败？检查 auth.codebuddy.cn 是否可达
WorkBuddy 不需要持续联网，但首次启动必须访问 auth.codebuddy.cn 完成轻量级许可证绑定。企业网络、校园网或某些路由器会拦截该域名：
- 终端执行：
curl -v https://auth.codebuddy.cn/health，若返回 200 OK 即通；若超时或拒绝连接，需联系 IT 部门放行该域名及 TCP 443 端口 - 不要尝试用代理或修改 hosts 绕过——该服务使用腾讯云 TLS 证书链，自签名或中间人代理会导致校验失败，直接卡在登录界面转圈
- 微信扫码登录比手机号更稳定，因不依赖短信网关；若扫码无响应，重启 WorkBuddy 并确保微信客户端已登录同一账号
真正卡住的地方往往不是安装步骤，而是权限没给全、或用了非 ARM64 包却以为自己装对了——这两点没法靠重装解决，必须回到终端和系统设置里逐项核对。
