Skip to Content
快速入门在 macOS 上安装

在 macOS 上安装

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

前往下载页面

在终端中安装(推荐)

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

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

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

使用 Homebrew 安装

如果你使用 Homebrew ,可以从我们自己的 tap 安装 NeuroSquad:

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

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

使用 .dmg 安装

下载适合你 Mac 的 .dmg

在下载页面 中,点击 Apple 芯片或 Intel 下方的 下载 .dmg(页面会高亮浏览器报告的那一个)。直接链接: Apple 芯片 、 Intel ;校验和见 SHA256SUMS-mac.txt 。

把 NeuroSquad 拖进“应用程序”

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

首次打开:点击“打开”

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

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

如果 macOS 仍然无法打开

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

听写所需的权限

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

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

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

登录和设置向导

其余步骤与 Windows 相同——请参阅安装中关于登录和设置向导的部分。 在 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;如果想全部清除,也请删除该文件夹。你的项目文件夹永远不会被改动。 参见数据存放在哪里。