WorkBuddy在macOS首次启动弹出“无法验证开发者”警告是Gatekeeper对未公证应用的正常拦截，非程序损坏；必须从官网下载.dmg并校验SHA256，再用Control+右键“打开”授权，必要时清除quarantine属性并授予完全磁盘访问与辅助功能权限。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
WorkBuddy在macOS上首次启动时弹出“无法验证开发者”警告，不是程序损坏或存在风险，而是苹果Gatekeeper安全机制对未上架App Store且未完成公证（notarization）的应用实施的默认拦截——你必须主动向系统声明信任，才能让WorkBuddy正常运行。
确认安装包来源与完整性
这一步跳过会导致后续所有操作无效。必须从官网https://www.codebuddy.cn/work/直接下载.dmg镜像，不能点第三方链接、搜索引擎快照或社交平台转发页。浏览器地址栏左侧锁形图标点击后，证书颁发者需为DigiCert Global Root G2，连接状态显示“连接是私密的”。
下载完成后，打开终端，执行：shasum -a 256 ~/Downloads/WorkBuddy-darwin-arm64-*.dmg，比对结果是否与官网公示的SHA256值完全一致。不一致就立刻删掉重下，哪怕只差一个字符也不行。
别用unzip、7-Zip或任何第三方工具解压.dmg文件——它不是压缩包，是磁盘映像，必须双击由系统原生挂载。挂载失败时，去Finder左侧边栏「位置」→「已挂载的磁盘映像」里找WorkBuddy条目；没有就说明挂载失败，重下。
用Control+右键强制触发用户授权路径
这是最可靠、成功率最高的方法，比进系统设置点“仍要打开”更底层、更稳定，尤其适用于签名完好但未公证的应用。
第一步：在Finder中定位到/Applications/WorkBuddy.app（不是桌面、不是Downloads文件夹，必须是Applications目录下的完整.app包）。
第二步：按住Control键不放，再用鼠标右键点击WorkBuddy.app图标。
第三步：在弹出菜单中，【必须按住Control键的同时】点击「打开」选项——注意不是左键双击，也不是Dock或启动台里的图标右键（那些路径不触发同级授权）。
第四步：弹出二次确认对话框后，点击「打开」。此时系统会记录“该应用已获用户明确授权”，之后双击即可正常启动。
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表，就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
如果右键菜单里「打开」是灰色的，说明WorkBuddy.app的签名元数据已损坏或被剥离。常见原因是用unzip解压了.zip包却没加-X参数，或拖拽时只拖了内部可执行文件而非整个.app包。此时请删掉现有WorkBuddy.app及所有残留，重新下载官方.dmg并挂载后拖入Applications。
备选方案：终端清除隔离属性
仅在确认安装包来自官网.dmg、已拖入/Applications、且Control+右键仍失败时使用。这条命令治标不治本，不能修复损坏签名，只能移除系统附加的隔离标记。
打开终端，输入：sudo xattr -rd com.apple.quarantine /Applications/WorkBuddy.app
回车后输入管理员密码（输入时不显示字符，输完直接回车）。执行完毕后，【仍需执行一次Control+右键→打开】，否则首次启动仍可能卡在权限检查。
注意：命令目标必须是.app本身，不是.dmg文件，也不是其父目录。写错路径会导致其他软件权限异常。
补充授权：启用完全磁盘访问与辅助功能
WorkBuddy启动后若卡在“正在配置辅助功能权限”界面，说明它需要macOS的系统级控制能力来执行自动化任务（比如自动填表、截图、跨应用操作），这步不可跳过。
弹窗出现时，必须点「打开系统设置」→ 进入「隐私与安全性」→ 「辅助功能」→ 左侧列表滚动到底部，找到WorkBuddy并勾选复选框。勾选后返回WorkBuddy窗口点「确认」。
如果列表里找不到WorkBuddy，重启应用再试；极少数情况需手动添加，但普通用户无需操作此步骤。
另外，前往「隐私与安全性」→ 「完全磁盘访问」，解锁后把WorkBuddy.app拖入并启用——否则它无法读取桌面、文档、下载等关键文件夹，后续所有文件操作都会失败。
