Docs平台设置macOS 安装指南
返回文档
平台设置

macOS 安装指南

在 macOS 上安装和配置 YeePilot，并集成钥匙串

最后更新: 2026年2月28日

概述

YeePilot 在 macOS 上原生运行，同时支持 Intel 和 Apple Silicon Mac。本指南涵盖安装、钥匙串集成、Gatekeeper 权限以及 macOS 特定的注意事项。

系统要求

要求详情
macOS 版本12 (Monterey) 或更高版本
架构Intel (amd64) 或 Apple Silicon (arm64)
终端Terminal.app、iTerm2、Warp、Alacritty 或任何终端模拟器

安装

快速安装（推荐）

安装脚本会自动检测 Mac 的架构并安装正确的二进制文件：

bash
curl -fsSL https://yee.to/install.sh | bash

这将：

  1. 检测您是 Intel 还是 Apple Silicon。
  2. 下载对应的原生二进制文件。
  3. 验证下载校验和。
  4. 将二进制文件安装到 /usr/local/bin/yeepilot。

安装完成后，验证是否正常工作：

bash
yeepilot version

手动安装

  1. 从发布页面 (opens in new tab)下载正确的归档文件：

    • yeepilot-darwin-amd64.tar.gz 适用于 Intel Mac
    • yeepilot-darwin-arm64.tar.gz 适用于 Apple Silicon Mac（M1、M2、M3、M4）

  2. 解压并安装：

bash
tar xzf yeepilot-darwin-arm64.tar.gz
sudo mv yeepilot /usr/local/bin/
sudo chmod +x /usr/local/bin/yeepilot
  1. 验证安装：
bash
yeepilot version

Gatekeeper 权限

macOS Gatekeeper 可能会在首次运行 YeePilot 时阻止它，因为二进制文件未使用 Apple 开发者证书签名。您会看到类似这样的消息："yeepilot" cannot be opened because the developer cannot be verified.

通过系统设置允许

  1. 打开系统设置（或旧版 macOS 上的系统偏好设置）。
  2. 进入隐私与安全性。
  3. 向下滚动到安全性部分。
  4. 您应该看到关于 yeepilot 被阻止的消息。点击仍然允许。
  5. 再次运行 yeepilot version 并在确认对话框中点击打开。

通过终端允许

或者，直接移除隔离属性：

bash
xattr -d com.apple.quarantine /usr/local/bin/yeepilot

这只需要做一次。后续更新可能需要重复此步骤。

初始设置

运行交互式设置以配置 AI 提供商：

bash
yeepilot setup

这会在 ~/.yeepilot/config.yaml 创建配置文件。

凭据存储

YeePilot 自动使用 macOS 钥匙串存储 API 密钥和认证令牌。这提供与系统登录集成的安全加密存储。

  • 凭据存储在默认的登录钥匙串中。
  • 首次存储或检索凭据时，您可能会看到钥匙串访问提示。点击始终允许以避免重复提示。
  • 凭据在钥匙串访问中以 yeepilot 标签标识，便于查找。

查看已存储的凭据

打开钥匙串访问（位于 应用程序 > 实用工具 中）并搜索 yeepilot 查看已存储的凭据。

无需额外设置

与 Linux 不同，macOS 上的凭据存储不需要安装额外的软件包。所有 macOS 安装都自带钥匙串。

沙箱限制

macOS 不支持 Linux 内核命名空间。YeePilot 使用进程级别资源限制替代，提供基本隔离：

  • CPU 时间限制 -- 如果命令超过配置的 CPU 时间，将被终止。
  • 内存限制 -- 进程内存限制在配置的最大值。
  • 文件大小限制 -- 单个文件创建受到限制。

配置沙箱设置：

yaml
# ~/.yeepilot/config.yaml
sandbox:
  enabled: true
  use_namespaces: false  # macOS 上不可用，自动禁用
  max_cpu_seconds: 300
  max_memory_mb: 512
  max_filesize_mb: 100
  max_processes: 64

注意，无论配置值如何，use_namespaces 在 macOS 上都会自动设为 false。您无需采取任何操作。

要获得完整的命名空间隔离，请考虑在 Mac 上的 Linux 虚拟机或 Docker 容器中运行 YeePilot。

Apple Silicon 说明

YeePilot 为 Apple Silicon Mac（M1、M2、M3、M4 系列）提供原生 arm64 二进制文件。这无需 Rosetta 2 转译即可运行，确保最佳性能。

确认您正在运行原生二进制文件：

bash
file $(which yeepilot)

对于 Apple Silicon 您应该看到包含 arm64 的输出，对于 Intel 则是 x86_64。

如果您在 Apple Silicon Mac 上意外安装了 Intel 版本，它仍然可以通过 Rosetta 2 工作，但建议重新安装正确的架构：

bash
curl -fsSL https://yee.to/install.sh | bash

安装脚本始终检测并安装正确的架构。

终端推荐

YeePilot 的 TUI 在支持以下功能的终端上效果最佳：

  • 256 色或真彩色 -- 用于正确的主题渲染。
  • Unicode -- 用于方框绘制字符和状态指示器。
  • 调整大小 -- TUI 适应终端大小变化。

所有流行的 macOS 终端都能良好工作：

终端说明
Terminal.app内置，开箱即用。启用"对粗体文字使用亮色"以获得最佳效果。
iTerm2出色的颜色和 Unicode 支持。推荐使用。
Warp完全支持。
Alacritty完全支持。GPU 加速。
Kitty完全支持。GPU 加速。

更新

更新到最新版本：

bash
yeepilot update

更新后您可能需要在 Gatekeeper 中重新允许该二进制文件（参见上方 Gatekeeper 权限部分）。

卸载

移除 YeePilot 及其所有数据：

bash
yeepilot uninstall --all

或仅移除二进制文件并保留配置：

bash
yeepilot uninstall --binary-only

手动移除：

bash
sudo rm /usr/local/bin/yeepilot
rm -rf ~/.yeepilot

已存储的钥匙串条目可以通过钥匙串访问手动移除，搜索 yeepilot 并删除匹配的条目。

上一篇

Linux 安装指南

Platform Setup

下一篇

Windows 安装指南

Platform Setup