INSTALL.md

安装、更新与故障排查

安装

1. 从 GitHub Releases 下载 macOS arm64 ZIP。

2. 解压，双击 install.command。

3. 安装器会检测 /Applications/ChatGPT.app，找不到时再检测 /Applications/Codex.app。

4. 安装器把原始 app.asar 备份到：

   ~/Library/Application Support/CodexPetInstaller/world-cup-messi-anime/

5. 桌宠安装到：

   ~/.codex/pets/world-cup-messi-anime/

6. 完全退出并重新打开 App，在“设置 → 宠物”中选择桌宠。

macOS 提示“无法验证开发者”

右键 install.command，选择“打开”，再确认运行。安装脚本是纯文本，可以在执行前直接查看。

点击没有声音

• 先确认中文气泡是否出现。
• 打开“系统设置 → 辅助功能/语音内容”检查中文系统语音。
• 没有中文语音时，浏览器语音引擎可能使用系统默认声音；气泡不受影响。

App 更新后交互消失

官方更新会替换 app.asar。下载最新版安装包或重新运行当前 install.command。补丁使用精确结构匹配；遇到不兼容的新版本会停止，不会覆盖无法识别的 App 资源。

卸载

双击 uninstall.command。它会：

1. 删除 ~/.codex/pets/world-cup-messi-anime。
2. 恢复最近一次安装前备份的 app.asar。
3. 重新签名并验证 App。

卸载后完全退出并重新打开 App。

安全说明

• 安装器只修改本机 Codex/ChatGPT 的 app.asar 和当前用户的 .codex/pets 目录。
• 不读取或上传 Codex 对话、账号令牌或其他个人数据。
• 需要管理员权限时，密码由 macOS sudo 直接处理，脚本不会读取或保存密码。