# 在 macOS 上安装

> 在 Apple 芯片或 Intel 的 Mac 上安装 NeuroSquad——在终端里一行命令，或者用 .dmg——以及首次打开时 macOS 会询问什么。

Source: https://docs.neurosquad.ai/zh/getting-started/macos

NeuroSquad 支持 **macOS 12 Monterey 及更新版本**，**Apple 芯片**（M1、M2、M3、M4 及更新）和
**Intel** 芯片的 Mac 各有一个版本。不确定你的 Mac 是哪种？打开苹果菜单 → **关于本机**：
“芯片：Apple M…”是 Apple 芯片，“处理器：Intel”是 Intel。

[前往下载页面](https://neurosquad.ai/zh/download/#macos)

## 在终端中安装（推荐）

一行命令会选择适合你 Mac 的版本，按公布的 SHA-256 校验和进行校验，把 **NeuroSquad.app** 放进
**应用程序**并打开：

```bash
curl -fsSL https://neurosquad.ai/install.sh | bash
```

如果你的账户无法写入 `/Applications`，脚本会改为安装到 `~/Applications`——两种情况都不需要管理员
密码。这样安装的副本可以直接打开，连下文所说的首次打开询问都不会出现。再次运行这行命令即可更新已安装的版本。

## 使用 Homebrew 安装

如果你使用 [Homebrew](https://brew.sh)，可以从我们自己的 tap 安装 NeuroSquad：

```bash
brew install --cask glmn-ai/neurosquad/neurosquad
```

它会安装适合你芯片的版本，按 SHA-256 校验和进行校验，并去掉下载标记，因此打开应用时不会出现
首次打开询问。之后 NeuroSquad 会自行更新，所以 `brew upgrade` 不会动它（`brew upgrade --greedy`
也会更新它）。`brew uninstall --cask neurosquad` 会删除应用；加上 `--zap` 还会删除你的 NeuroSquad 数据。

## 使用 .dmg 安装

**1. 下载适合你 Mac 的 .dmg**

在[下载页面](https://neurosquad.ai/zh/download/#macos)中，点击 **Apple 芯片**或 **Intel** 下方的
**下载 .dmg**（页面会高亮浏览器报告的那一个）。直接链接：
[Apple 芯片](https://neurosquad.ai/downloads/NeuroSquad-arm64.dmg)、
[Intel](https://neurosquad.ai/downloads/NeuroSquad-x64.dmg)；校验和见
[SHA256SUMS-mac.txt](https://neurosquad.ai/downloads/SHA256SUMS-mac.txt)。

**2. 把 NeuroSquad 拖进“应用程序”**

打开 .dmg，把 **NeuroSquad** 拖到旁边的 **Applications** 文件夹上。

**3. 首次打开：点击“打开”**

NeuroSquad 使用 Apple Developer ID 签名并经过 Apple 公证。首次打开通过浏览器下载的副本时，macOS
会像对待任何从互联网下载的应用一样询问：**“NeuroSquad”是从互联网下载的应用。你确定要打开它吗？**
——并说明 Apple 已检查过它，未发现恶意软件。点击**打开**即可，之后 macOS 不会再问。

> 这个询问与下载方式有关，而不是应用本身：浏览器会把每个下载的文件标记为“来自互联网”。终端安装、
> Homebrew 和 NeuroSquad 自身的更新下载时不带这个标记，所以连这个询问都不会出现。

### 如果 macOS 仍然无法打开

0.1.218 之前的版本没有经过公证。如果 macOS 提示未打开“NeuroSquad”、Apple 无法验证它，或者提示它已损坏，
你手上很可能是这样的旧副本：把它移到废纸篓，从[下载页面](https://neurosquad.ai/zh/download/#macos)重新下载
.dmg，或者用上文的终端命令或 Homebrew 安装。你的数据不会受影响。

## 听写所需的权限

语音听写需要 macOS 的两项权限。**设置 → 听写**会显示还缺少什么，并提供**允许**按钮和打开系统设置对应页面的入口：

- **麦克风**——用于录制你的声音。第一次听写时 macOS 会询问。
- **辅助功能**——用于在任何应用中都有效的全局听写快捷键。请在**系统设置 → 隐私与安全性 → 辅助功能**
中打开 **NeuroSquad**；允许后快捷键立即生效。

更新后这些权限会保留。只有一个例外：如果你安装过 0.1.214（第一个 Mac 版本），更新到 0.1.218 后
macOS 会再询问一次麦克风和辅助功能权限，因为从这个版本起应用的签名换成了 Apple Developer ID。

## 登录和设置向导

其余步骤与 Windows 相同——请参阅[安装](https://docs.neurosquad.ai/zh/getting-started/installation)中关于登录和设置向导的部分。
在 Mac 上，向导通过 npm 安装智能体命令行工具；没有 npm 时，会把 Node.js LTS 安装到 `~/.neurosquad/node`
（不修改 shell 配置文件）；Git 无法无人值守安装，向导会给出它的下载页面（使用 Homebrew：`brew install git`）。终端卡片使用你的登录 shell（`$SHELL`，默认是 zsh）；
即使从程序坞启动的应用只拿到最小的 `PATH`，NeuroSquad 也能找到通过 Homebrew、npm、bun、cargo 等安装的命令行工具。

## 更新

和 Windows 一样，NeuroSquad 会自动更新：新版本在后台下载，按 SHA-256 校验和校验，并在重启时安装——应用会在
原文件夹中被替换并重新打开。菜单栏中的 **NeuroSquad → 检查更新…** 可以立即检查。

如果 NeuroSquad 无法写入自己所在的文件夹（例如它在 `/Applications` 中，而你的账户不是管理员），它会把更新
解压到**下载**文件夹并在访达中显示：退出 NeuroSquad，把新的副本拖进“应用程序”并替换旧版本。

## 关闭和退出

红色关闭按钮只会隐藏窗口：NeuroSquad 和它的智能体继续运行，点击程序坞中的图标即可找回窗口。用 **Cmd+Q**
（或 **NeuroSquad → 退出 NeuroSquad**）退出——这会停止智能体的终端。

## 卸载

退出 NeuroSquad，把 **NeuroSquad.app** 从“应用程序”移到废纸篓。你的数据——工作区、智能体、设置、听写模型——
保存在 `~/Library/Application Support/NeuroSquad`；如果想全部清除，也请删除该文件夹。你的项目文件夹永远不会被改动。
参见[数据存放在哪里](https://docs.neurosquad.ai/zh/help/data)。
