Raycast 是 macOS 上的效率入口（类似启动器+命令面板），把“打开应用、搜索文件、剪贴板历史、窗口管理、翻译/计算、脚本命令、API 查询”等日常动作统一到一个快捷键里。你可以把它当作 Finder / Spotlight 的“可编排版本”：同样是搜索，但更快、更可控，还能把流程串起来。
本文按“安装 → 权限 → 核心设置 → 常用插件 → 自定义工作流 → 排错”顺序写，你照做一遍，基本就能形成稳定的个人配置。
方式A：官网下载：打开 https://www.raycast.com/ 下载并安装。
方式B：Homebrew 安装（已经装了 Homebrew 的更省事）：在终端执行 brew install --cask raycast。安装完成后在“应用程序”里启动 Raycast。
为了让 Raycast 能稳定调用系统能力，建议启动后立即处理以下权限：
1) 辅助功能：用于窗口管理、模拟快捷键等。路径通常在“系统设置 → 隐私与安全性 → 辅助功能”。
2) 输入监控：用于监听全局唤起快捷键、执行部分自动化动作。路径在“系统设置 → 隐私与安全性 → 输入监控”。
3) 完全磁盘访问权限（可选但推荐）：用于更完整的文件索引与搜索结果。路径在“系统设置 → 隐私与安全性 → 完全磁盘访问权限”。
如果你不想一次给满权限，也可以先只开“辅助功能 + 输入监控”，后续发现某些插件找不到文件/应用再补充。
1) 唤起快捷键：建议使用 Option + Space 或 Command + Space（如果你愿意把 Spotlight 换掉）。关键是：这个键要“随手就能按到”。
2) 搜索范围与优先级：在 Raycast 的设置里把常用应用置顶，把你不需要的搜索源（很少用的建议项）关掉，减少噪音。
3) 结果展示与预览：打开“快速预览/详情面板”，让你在不打开新窗口的情况下就能确认文件/链接是否正确。
下面这些是“装完就能用”的高频功能，建议逐个试一遍，找到你最常用的3-5个：
- Clipboard History：剪贴板历史回溯。复制文本/图片后，随时用 Raycast 搜索并粘贴之前的内容。
- Window Management：把窗口贴到左半屏/右半屏/四分屏等。适合多窗口对照、写文档+查资料。
- Snippets：短语片段（例如邮箱、地址、常用回复模板），输入触发词一键插入。
- Quick s：把常用网页做成“可带参数的快捷入口”，例如搜索某个站内内容。
Raycast 的插件生态很大，但不建议一口气装很多。选择标准只有一个：它能不能减少你在多个应用之间来回切换的次数。
推荐从下面几类开始（按需选择）：
1) 日历/待办：把今天日程、快速创建事件、任务列表放进 Raycast；
2) 翻译/词典：选中文本后快速翻译、复制结果；
3) 开发者工具：JSON 格式化、URL 编解码、 64 编解码（注意仅做编码转换，不涉及任何破解/绕过）；
4) 搜索增强：把 Google / GitHub / 站内搜索统一成一条命令。
插件安装入口通常在 Raycast 设置的 Extensions/Store 中，装完后别忘了把你常用的命令加到“Favorites”或设置别名，减少输入成本。
Raycast 的真正价值在于“编排”。举个常见需求：你每天都要打开同一组应用并进入工作状态（比如：浏览器、笔记、聊天、终端）。你可以做一个快捷命令，把它们串起来。
示例思路（不涉及任何敏感操作）：
- 用 Raycast 创建一个自定义命令，依次启动应用；
- 给命令设置一个短别名，例如 work；
- 再给命令绑定快捷键，做到“按一次就到位”。
这样做的收益是：你不再需要在 Dock、Launchpad、浏览器标签之间“找东西”，而是把注意力留给任务本身。
1) 快捷键无响应：检查是否被其他软件占用；必要时更换为 Option + Space 等不冲突组合。
2) 窗口管理没反应：优先检查“辅助功能”权限是否打开；关闭再打开一次 Raycast。
3) 搜不到文件/结果不全：检查“完全磁盘访问权限”；确认你要搜索的目录是否在系统允许范围内。
4) 插件命令找不到：在 Extensions 里确认启用状态；把常用命令加到 Favorites；必要时给命令加别名。
- Raycast 官网：https://www.raycast.com/
- Raycast 官方文档：https://manual.raycast.com/
