跳到内容
PaneflowPaneflow
文档

在 macOS 上安装 Paneflow

在运行 macOS 13 Ventura 或更新版本的 Apple Silicon Mac 上安装 Paneflow。选择 Homebrew 或 DMG，验证安装并设置终端命令。

Paneflow 需要运行 macOS 13 Ventura 或更新版本的 Apple Silicon Mac。 如果已安装 Homebrew，可使用 Homebrew；也可以下载 .dmg 手动安装。 两种方式都会安装已签名并公证的 PaneFlow.app。无需 Rust 或构建工具。

如何使用 Homebrew 安装 Paneflow？

打开终端并安装 Paneflow cask：

bash
brew install --cask arthjean/paneflow/paneflow

Homebrew 默认将 PaneFlow.app 安装到 /Applications。如果找不到 brew 命令， 使用下方的 DMG 安装步骤。如果 Homebrew 尚未提供刚发布的版本，也可以使用 DMG。

如何从 DMG 安装 Paneflow？

打开 GitHub 上最新的 Paneflow 版本， 或运行以下命令，在浏览器中打开版本页面：

bash
open https://github.com/arthjean/paneflow/releases/latest
  1. 下载名为 paneflow-<version>-aarch64-apple-darwin.dmg 的文件。 <version> 对应页面显示的版本号。
  2. 在 Finder 中打开下载的 .dmg。
  3. 将 PaneFlow.app 拖到磁盘映像中的 Applications 快捷方式上。
  4. 等待复制完成，然后推出磁盘映像。

打开 Paneflow

从“应用程序”打开 PaneFlow.app，或使用 Spotlight（按 Cmd+Space，然后输入 PaneFlow）。 也可以从终端启动应用：

bash
open -a PaneFlow

如果 macOS 要求确认打开从互联网下载的应用，确认是刚安装的副本后选择 打开。 其他提醒信息请参阅下方的 Gatekeeper 说明。

如何验证安装？

直接运行已安装的可执行文件：

bash
/Applications/PaneFlow.app/Contents/MacOS/paneflow --version

命令应显示已安装的版本。还需要确认应用能够打开。 如果找不到文件，检查 PaneFlow.app 是否位于 /Applications，或重新执行安装步骤。

然后按照入门指南启动第一个智能体。 CLI 智能体需要单独安装，并按照各自的说明登录。

在终端中使用 paneflow 命令

安装应用不会自动将可执行文件添加到 shell 的 PATH。 先尝试 paneflow --version。如果显示已安装的版本，可以跳过本节。

否则，为已安装的可执行文件创建符号链接。以下命令会在需要时创建 /usr/local/bin， 并保留任何已有的 paneflow 文件或链接：

bash
sudo mkdir -p /usr/local/bin
sudo ln -s /Applications/PaneFlow.app/Contents/MacOS/paneflow /usr/local/bin/paneflow
/usr/local/bin/paneflow --version

如果 ln 显示 File exists，用 ls -l /usr/local/bin/paneflow 检查现有文件或链接。 如果已指向安装的应用，跳过创建链接的命令。如果指向其他位置， 使用安装验证部分提供的应用完整路径。

如果完整路径可以运行，但仍找不到 paneflow，将 /usr/local/bin 添加到 shell 的 PATH。 在 Bash 或 Zsh 中，运行 export PATH="/usr/local/bin:$PATH"，再尝试 paneflow --version。 要在新终端中保留此设置，将同一行添加到 Zsh 的 ~/.zshrc 或 Bash 登录 shell 的 ~/.bash_profile。

如果 macOS 阻止 PaneFlow.app，该怎么办？

官方 DMG 已签名并公证。如果 macOS 无法验证开发者，先从上方的版本页面重新下载。 确认来源后，如果仍被阻止，按照 Apple 关于打开被阻止应用的说明操作：

  1. 尝试打开 PaneFlow.app 一次。
  2. 打开 系统设置，然后选择 隐私与安全性。
  3. 找到 PaneFlow.app 的提示并选择 仍要打开。
  4. 在下一个对话框中选择 打开。

如果受管理的 Mac 不提供此选项，请联系管理员。 如果 macOS 提示应用已损坏或将损坏电脑，保持阻止状态，并 在 GitHub 上报告安装问题， 附上提醒信息的完整内容、macOS 版本和 Paneflow 版本。

Intel Mac 呢？

Paneflow 不提供适用于 Intel 的 macOS 版本。Apple Silicon DMG 无法在 Intel Mac 上运行。 Linux 安装指南和 Windows 安装指南 介绍了这两个系统的可用版本及支持的处理器。