跳到主要内容

教程：macOS 设置

本教程将带您完整了解 Rephlo 在 macOS 上的专属上手流程，从安装到执行您的第一个拖选（drag-select）命令。如果您已经完成了通用的安装与设置，本教程会更深入地介绍 macOS 相关细节。

目的​

macOS 有其独特的安全与隐私要求，会影响 Rephlo 的运行方式。与 Windows 上全局热键开箱即用不同，macOS 需要用户明确授予 Accessibility（辅助功能）与 Screen Recording（屏幕录制）权限。本教程将确保您正确完成所有配置，让 Rephlo 从第一天起就能使用全部功能。

前提条件​

要求详情
macOS 版本10.15 Catalina 或更高版本
架构Apple Silicon（M1/M2/M3/M4）或 Intel（x64）
磁盘空间应用程序包约需 250 MB
Ollama（可选）如果您打算使用本地模型，请另行安装 Ollama

步骤 1：下载并安装​

1.1 下载 Rephlo​

访问 https://rephlo.app/download，下载最新的 macOS 安装包：

  • 面向 Apple Silicon Mac（M1/M2/M3/M4）：Rephlo-macos-arm64.dmg
  • 面向 Intel Mac：Rephlo-macos-x64.dmg

1.2 安装到「应用程序」文件夹​

  1. 打开下载好的 .dmg 文件。
  2. 将 Rephlo.app 拖入 /Applications 文件夹。
  3. 弹出该磁盘映像。

1.3 首次启动 — Gatekeeper​

首次打开 Rephlo 时，macOS 的 Gatekeeper 可能会拦截并显示以下提示："Rephlo.app cannot be opened because the developer cannot be verified."

请按以下步骤操作：

  1. 不要直接双击应用图标。而是在 /Applications 中对 Rephlo.app 右键点击（或按住 Control 点击）。
  2. 在右键菜单中选择 "Open"。
  3. 在确认对话框中再次点击 "Open"。

macOS 会记住这次选择。之后再启动时，直接双击即可正常打开。

为什么会这样？ macOS 的 Gatekeeper 会对从 Mac App Store 以外渠道下载的应用发出警告。通过「右键点击 > Open」这一方式，可以为当前应用绕过此项检查。

步骤 2：授予所需权限​

为什么需要这些权限​

Rephlo 需要监听全局热键，并在您触发命令时读取当前选中的文本，这在 macOS 上需要 Accessibility（辅助功能）权限。此外，截图功能还需要单独授予 Screen Recording（屏幕录制）权限。

如果没有这些权限，Rephlo 的系统级集成将无法正常工作。

2.1 PermissionPreCheckDialog（权限预检对话框）​

首次启动后，Rephlo 会立即显示 PermissionPreCheckDialog（权限预检对话框）：

2.2 授予 Accessibility（辅助功能）权限​

  1. 在 PermissionPreCheckDialog 中，点击 Accessibility 旁边的 "Open System Settings"。
  2. macOS 会打开 System Settings > Privacy & Security > Accessibility。
  3. 在应用列表中找到 Rephlo。
  4. 将开关切换为 ON。
  5. 如有提示，请使用您的 macOS 密码或 Touch ID 完成身份验证。
  6. 返回 Rephlo 的对话框。

2.3 授予 Screen Recording（屏幕录制）权限​

  1. 在 PermissionPreCheckDialog 中，点击 Screen Recording 旁边的 "Open System Settings"。
  2. macOS 会打开 System Settings > Privacy & Security > Screen Recording。
  3. 在应用列表中找到 Rephlo。
  4. 将开关切换为 ON。
  5. 如有提示，请完成身份验证。
  6. 返回 Rephlo 的对话框。

2.4 验证并重启​

  1. 回到 Rephlo 的对话框，点击 "Check Again"。
  2. 此时两项权限均应显示为 Granted。
  3. 完全退出 Rephlo（右键点击菜单栏图标 > Exit，或按 Cmd+Q）。
  4. 从 /Applications 重新启动 Rephlo。部分 macOS 权限变更需要完全重启才能生效。

提示：如果切换权限开关后，勾选框仍显示 "Not Granted"，请尝试退出 Rephlo，等待几秒钟后再重新启动。macOS 有时会缓存旧的权限状态。

步骤 3：设置您的第一个提供商​

在获得权限后，请配置一个 AI 提供商，以便 Rephlo 能够处理您的命令。

  1. 点击 菜单栏 中的 Rephlo 图标，然后选择 "Settings"（或打开 Dashboard 并导航到 Settings）。
  2. 进入 Settings > LLM Providers。
  3. 从列表中选择一个提供商：
提供商您需要准备的内容
OpenAI来自 platform.openai.com 的 API key
Anthropic来自 console.anthropic.com 的 API key
Google来自 aistudio.google.dev 的 API key
Groq来自 console.groq.com 的 API key
xAI（Grok）来自 console.x.ai 的 API key
OpenRouter来自 openrouter.ai 的 API key
Azure OpenAI来自您 Azure 门户的 Endpoint URL + API key
Ollama本地安装，无需 key（endpoint：http://localhost:11434）
OpenAI-Compatible任意兼容服务的 Endpoint URL + API key
  1. 输入您的 API Key（如适用，还需输入 endpoint URL）。
  2. 点击 Test Connection 进行验证。
  3. 点击 Save。

快速上手建议：如果您是第一次接触 AI API，OpenAI 或 Anthropic 是最容易上手的选择。如果您更看重完全的隐私、不依赖云端，可以安装 Ollama 并使用本地模型。

步骤 4：了解 macOS 热键​

Rephlo 会针对不同平台使用各自的默认热键。以下是 macOS 默认热键与 Windows/Linux 的对比：

操作macOSWindows / Linux
右键菜单悬浮窗（Context Menu Overlay）Shift+Cmd+CCtrl+Shift+Alt+C
截图捕获（Screenshot Capture）Shift+Cmd+SCtrl+Shift+Alt+S
拖选修饰键（Drag-Select Modifier）CmdCtrl
放大（Zoom In）Cmd+PlusCtrl+Plus
缩小（Zoom Out）Cmd+MinusCtrl+Minus
重置缩放（Reset Zoom）Cmd+0Ctrl+0

自定义热键​

所有热键均可完全自定义：

  1. 打开 Settings > Hotkeys。
  2. 点击您想要修改的热键字段。
  3. 按下您想要设置的组合键。
  4. 点击 Save。

提示：如果某个热键与其他应用（例如 Spotlight、Alfred 或 Raycast）冲突，请选择其他组合键。如果所选热键已被系统占用，Rephlo 会向您发出警告。

步骤 5：使用拖选（Drag-Select）功能进行测试​

拖选是在 macOS 上使用 Rephlo 最快捷的方式。我们来试一试：

5.1 打开任意文本类应用​

打开 TextEdit、Notes、Safari，或任何包含可选中文本的应用。

5.2 执行拖选操作​

  1. 按住 Cmd 键（macOS 上默认的拖选修饰键）。
  2. 在按住 Cmd 的同时，点击并拖动鼠标划过一段文本，将其选中。
  3. 松开鼠标按键后，Rephlo 悬浮窗会立即出现在光标附近。

5.3 执行命令​

  1. 在悬浮窗中点击 "Summarize"（或任意命令）。
  2. Rephlo 会将选中的文本发送给您所配置的 AI 提供商。
  3. 结果会显示在悬浮窗中。
  4. 点击 Copy 将结果复制到剪贴板，或点击 Insert 用结果替换原文本。

注意：拖选修饰键是可以自定义的。如果您希望将其从 Cmd 改为其他按键，请前往 Settings > Hotkeys > Text Selection Trigger 进行修改。

macOS 专属问题排查​

热键不起作用​

症状：按下 Shift+Cmd+C 没有任何反应，悬浮窗不会出现。

原因：未授予 Accessibility 权限，或授予权限后未重启应用。

解决方法：

  1. 打开 System Settings > Privacy & Security > Accessibility。
  2. 确认 Rephlo 的开关已切换为 ON。
  3. 如果开关本来就是开启状态，请先切换为 OFF，再重新切换为 ON。
  4. 退出并重新启动 Rephlo。

截图捕获不起作用​

症状：截图类命令执行失败，或生成空白图片。

原因：未授予 Screen Recording 权限。

解决方法：

  1. 打开 System Settings > Privacy & Security > Screen Recording。
  2. 确认 Rephlo 的开关已切换为 ON。
  3. 退出并重新启动 Rephlo。

悬浮窗未出现​

症状：按下热键或执行拖选操作后，没有出现悬浮窗口。

可能的原因及解决方法：

可能原因解决方法
未授予 Accessibility 权限授予 Accessibility 权限并重启应用
未以 .app 包的形式运行应用从 /Applications/Rephlo.app 启动，而不要通过 dotnet run
热键与其他应用冲突在 Settings > Hotkeys 中检查冲突并更改组合键
应用处于暂停状态右键点击菜单栏图标；如果出现 "Resume Rephlo"，点击它

每次启动都被 Gatekeeper 拦截​

症状：macOS 反复显示"无法验证开发者身份"的警告。

解决方法：请确认您在首次启动时是通过右键点击并选择 "Open"。如果问题仍然存在：

  1. 打开 System Settings > Privacy & Security。
  2. 向下滚动到 Security（安全性）部分。
  3. 您应该会看到一条关于 Rephlo 被拦截的提示信息，点击 "Open Anyway"。

权限列表中未显示 Rephlo​

症状：打开 System Settings > Accessibility 后，未看到 Rephlo。

解决方法：请至少启动一次 Rephlo。只有当应用首次尝试使用受保护的功能后，macOS 才会将其添加到权限列表中。启动应用后，请再次查看权限列表。

后续步骤​

现在，您已经完成了 macOS 上的完整设置。以下是推荐的后续步骤：

  • 首次使用演练 — 按步骤运行您的第一个 AI 命令。
  • Commands — 了解如何创建和自定义属于您自己的命令。
  • Spaces — 添加您的文档作为 AI 上下文，获得有据可依的回答。
  • Template Gallery — 浏览面向常见任务的预置命令。
  • 进阶用例 — 高阶用户的工作流与自动化技巧。