AstroBox macOS 安装指南——DMG 拖拽安装与 Gatekeeper 签名绕过

下载前确认

• 系统版本：macOS Sonoma（14）或更高
• 芯片架构：Apple Silicon（M 系列 / A 系列）下载 ARM 版，Intel（Core i 系列）下载 x86 版
• 准备工作：如果之前安装过 AstroBox V1，先卸载 V1

怎么确认芯片架构

1. 点击左上角苹果图标 → 关于本机
2. 如果显示「芯片 Apple Mxx」→ ARM 版
3. 如果显示「处理器 Intel Core」→ x86 版

下载与安装

1. 前往 AstroBox 官方下载页面，选择对应架构的 macOS 版本
2. 下载得到一个 .dmg 文件
3. 双击打开 DMG

关键步骤：绕过 Gatekeeper

从 DMG 拖拽 AstroBox 到应用程序文件夹后，你还需要在终端中执行一条命令，否则 macOS 会因为签名问题拒绝打开：

sudo xattr -r -d com.apple.quarantine /Applications/AstroBox.app

执行过程：

1. 按 Command + 空格 打开 Spotlight 搜索
2. 输入「终端」并回车（或打开「访达 → 应用程序 → 实用工具 → 终端」）
3. 复制上面的命令粘贴进终端
4. 回车执行
5. 系统会要求输入你的 Mac 登录密码——输入过程不会显示任何字符，这是正常的，输完密码直接回车即可

首次打开

不要直接双击打开——右键点击 AstroBox → 打开。这是为了绕过 macOS 的首次运行警告。

过程中 AstroBox 会向系统申请蓝牙权限，点击全部允许即可。

macOS 特色功能

深浅色模式切换动效

2.1 版本引入了 View Transitions 淡化动画，在浅色/深色主题之间切换时有平滑过渡效果。

红绿灯按钮位置校准

2.1 版本修复了深浅色切换后窗口红绿灯按钮位置漂移的问题——通过常驻 watchdog 自动校准。

窗口大小记忆

和 Windows 一样，关闭时记住窗口大小和位置，下次打开自动恢复。

常见问题

终端命令报错「No such file or directory」

大概率是你还没把 AstroBox 拖进「应用程序」文件夹。先完成拖拽，再执行那条 xattr 命令。

「无法打开 AstroBox，因为 Apple 无法验证开发者」

说明你跳过了 xattr 那步。重新执行：

sudo xattr -r -d com.apple.quarantine /Applications/AstroBox.app

然后右键 → 打开。

蓝牙搜不到设备

• 确认系统偏好设置 → 蓝牙已开启
• 穿戴设备进入「连接新手机」模式后再试
• 如果是 MacBook，确认没有在系统设置里禁用蓝牙

首次打开后界面空白 / 闪退

可能是 macOS 版本过低。执行 sw_vers 确认版本号，需要 Sonoma 14 以上。