macOS 安装
从 黑洞智能体官方下载页 获取已发布的安装包。当前提供 Apple Silicon（ARM64）与 Intel（x64）两种 macOS 架构，文件为 .zip；具体版本以下载页读取的发布信息为准。
1. 确认芯片类型并下载安装包
点击屏幕左上角 → 关于本机，查看芯片或处理器信息：
- 显示 Apple M 系列芯片：选择下载页的 Apple 入口。
- 显示 Intel 处理器：选择 Intel 入口。
两种架构独立发布，版本号可能不同。按本机芯片选择，不要为了较高版本号下载另一种架构的文件。已核对的发布状态见 平台与兼容性说明。
2. 安装应用
- 下载完成后，双击
.zip文件解压； - 找到解压得到的 BLACK HOLE.app；
- 将它拖入 应用程序（Applications） 文件夹；
- 从“应用程序”文件夹打开 BLACK HOLE。
已有用户更新时，先保存当前工作、停止正在进行的任务并退出客户端，再替换应用。重要资料先完成备份；不要把移动或删除应用当作备份数据的方法。
首次启动提示
如果 macOS 提示无法打开，先确认文件来自上述官网，架构与本机匹配，并记录实际错误。需要系统确认时，在 系统设置 → 隐私与安全性 中按提示操作。不要为来源不明的文件关闭系统保护或执行绕过安全检查的终端命令。
看到主界面表示应用已启动；模型连接、知识库检索和电脑操作还需分别检查，不能仅凭启动成功判断所有功能就绪。
3. 检查需要使用的功能
- 模型对话：核对提供商、API Key 和模型，发送一条短请求并查看实际回复。内置黑洞服务商的默认地址为
https://blackholeagent.cn/v1。 - 知识库：导入少量资料，检查正文和召回结果。
- 电脑控制：在设置中检查状态，并按提示为 BLACK HOLE Computer Use 组件授权辅助功能与屏幕录制。此组件随 BLACK HOLE 安装；仅开启 BLACK HOLE 或 BLACK HOLE 的权限不能代替它的权限。系统授权由用户本人完成。
电脑控制功能开关不等于系统已经授权。完成授权后，按提示刷新状态或重启，再用一个小任务检查实际读取、点击和输入。