macOS 安装指南

BotHub 目前尚未完成 Apple 开发者签名，首次在 macOS 打开时系统可能会提示：

"BotHub.app" 已损坏，无法打开。你应该将它移到废纸篓。

或者：

无法打开 "BotHub.app"，因为 Apple 无法检查其中是否包含恶意软件。

这并不代表应用真的损坏或有毒。只是 macOS Gatekeeper 对未签名应用的默认保护机制。BotHub 所有代码开源在仓库可查，可以放心按下面任一方法放行。

方法 A：系统设置放行（推荐，最简单）

适用于 macOS 13 Ventura 及更新版本。

1. 先双击一次 BotHub.app，让系统拦截并报 "已损坏"
2. 点对话框上的 取消（不要点「移到废纸篓」）
3. 打开 系统设置 → 隐私与安全性
4. 滚动到底部，应该会看到一行：
   "BotHub.app 已被阻止使用，因为它不是来自可识别的开发者"
5. 点击右侧的 仍要打开
6. 输入开机密码或 Touch ID 确认
7. 再次双击 BotHub.app 启动，这次会正常打开

之后每次打开都会正常，不需要重复。

方法 B：终端命令放行（方法 A 失败时用）

如果「系统设置」里没有出现「仍要打开」的按钮，或者点了仍然报错，打开 终端（Terminal.app）执行：

sudo xattr -rd com.apple.quarantine /Applications/BotHub.app
sudo codesign --force --deep --sign - /Applications/BotHub.app

• 第一行：移除系统对"下载文件"的隔离标记
• 第二行：给应用打一个本地临时签名（ad-hoc signing），让 Gatekeeper 接受

需要输入开机密码。执行完再双击打开 BotHub。

如果第一行报 Operation not permitted，说明你的终端没有「完全磁盘访问权限」。去 系统设置 → 隐私与安全性 → 完全磁盘访问权限 把终端加进去，然后重启终端重试。

方法 C：关闭 Gatekeeper（终极方案，不推荐作为常规手段）

如果 A 和 B 都失败，或者你经常需要装各种未签名应用，可以在终端执行：

sudo spctl --master-disable

然后进 系统设置 → 隐私与安全性 → 允许以下来源的应用程序，会多出一个 任何来源 选项，选它。

此后所有未签名应用都能直接双击打开。这会降低系统安全性，只在你清楚自己在做什么的前提下使用。如需恢复：

sudo spctl --master-enable

安装位置

推荐拖入 Applications（/应用程序）文件夹。拖入其他目录也能用，但 Finder 里的搜索和 Dock 固定会更方便。

卸载

• 方法 1：Finder 打开 Applications，把 BotHub.app 拖到废纸篓
• 方法 2：用 AppCleaner 之类的卸载工具一并清理偏好设置和数据缓存

BotHub 的用户数据默认位于：

~/Library/Application Support/BotHub/

完全卸载时可以连同这个目录一起删除。

仍然打不开？

如果三个方法都失败，可能是下载文件本身损坏。尝试：

1. 重新从官网下载 .dmg
2. 对比 SHA256 校验值（如果发布页提供了）
3. 切换到 arm64 / x86_64 对应的版本（新 Mac 用 arm64，Intel Mac 用 x86_64）

仍然有问题请到 常见问题 或提交 issue 反馈。