系统要求
- macOS 10.15 (Catalina) 或更高版本
- 支持 Intel 芯片与 Apple Silicon (M1/M2/M3) 芯片
- 建议预留 500MB 以上磁盘空间
安装步骤
- 下载安装包
访问官网下载页，根据 Mac 芯片类型选择对应版本：
- Intel 芯片 Mac：选择 x64 版本
- Apple Silicon Mac (M1/M2/M3)：选择 ARM64/Apple 芯片版本
下载完成后会得到一个 .dmg 文件。
- 挂载并安装
双击 .dmg 文件，在弹出的窗口中将 CodeBuddy 图标拖拽至右侧的 Applications（应用程序） 文件夹。等待复制完成后，即可关闭挂载窗口。
- 首次启动授权（关键步骤）
从启动台或应用程序文件夹打开 CodeBuddy。由于是第三方应用分发，macOS 可能会拦截并提示"无法打开"。
- macOS Ventura 及以上：前往 系统设置 > 隐私与安全性 > 安全性，在"已阻止使用 CodeBuddy"下方点击 "仍要打开"，随后再次尝试启动。
- macOS Monterey 及更早版本：前往 系统偏好设置 > 安全性与隐私 > 通用，点击左下角的 "仍要打开"。
- 若仍无法启动，可尝试右键点击应用图标，选择 "打开"，在弹出的对话框中确认打开。
- 完成启动
正常进入登录窗口，使用账号或第三方授权登录即可。首次登录后，工具会自动同步云端配置。
卸载说明
如需卸载，直接将 应用程序 文件夹中的 CodeBuddy 拖入废纸篓即可。用户配置与缓存数据位于 ~/Library/Application Support/CodeBuddy，如需彻底清理可手动删除该目录。
常见问题
- 下载错版本导致无法运行：Apple Silicon Mac 误装 Intel 版本时，可能依赖 Rosetta 转译运行（若系统已安装 Rosetta 通常可兼容，但性能稍逊）。建议 Apple Silicon 用户直接下载 ARM64 版本以获得最佳性能。
- 提示文件已损坏：部分安全设置较高的 Mac 会提示"已损坏"。此时需在终端执行
xattr -cr /Applications/CodeBuddy.app，然后重新启动。 - 自动更新失败：若内置更新下载后无法替换旧版本，通常是因为当前应用正在运行或权限不足。完全退出 CodeBuddy 后重新打开，或手动下载最新版
.dmg覆盖安装即可。