- 张芷铭的个人博客

Raycast 是 Mac 平台上一款强大的生产力工具，既能替代系统 Spotlight，还可通过内置功能、扩展插件和脚本命令实现高效操作。下面这份指南从基础配置到高级用法全面覆盖，助力快速上手并提升使用效率：

这部分是使用 Raycast 的基础，做好初始设置能大幅降低后续操作成本。

初始设置
1. 呼出与替换：默认呼出快捷键为 ⌥ + 空格，若想替代 Spotlight 的 ⌘ + 空格，可在系统设置中修改 Spotlight 快捷键，避免冲突。
2. 基础配置：按下 ⌘ , 快速打开设置界面，可调整主题、模糊搜索灵敏度、快捷键等；在 Advanced > Root Search Sensitivity 中还能调节搜索精准度，适配不同搜索习惯。
核心面板操作

Raycast 内置诸多实用功能，覆盖文件管理、剪贴板、系统控制等常见场景，无需额外软件即可满足需求。

搜索相关
应用与功能搜索：呼出主面板后直接输入应用、插件或命令名称，支持中文、拼音及模糊搜索，回车即可启动对应内容。
文件搜索：输入 sf 回车进入文件搜索模式，默认按更新时间倒序展示结果；支持特殊语法，如 .pdf certificate 搜索含“certificate”的 PDF 文件，.txt in ~/desktop 搜索桌面的文本文件。选中文件后按 ⌘ ↵ 可在访达中打开，⌘ ⇧ , 可复制文件路径。
书签搜索：输入 sbb 回车，能搜索浏览器书签并直接打开，还可在设置中指定搜索的浏览器来源。
效率工具
剪贴板历史：可记录至多 256 条剪贴内容，数据本地存储且加密。按 ⌘ ⇧ P 可固定常用内容；⌃ X 删除选中记录，⌃ ⇧ X 清空所有记录。若需快速呼出，可在设置中自定义专属快捷键。
计算器：主面板直接输入计算式即可得出结果，不仅支持基础数学运算，还能实现汇率、日期、单位转换等功能。
系统控制：通过主面板搜索系统相关命令，可快速控制 Mac 状态，比如搜索“Lock Screen”锁定屏幕、“Set Volume to 50%”将音量调到 50%、“Toggle Bluetooth”开关蓝牙，还有重启、睡眠、切换系统明暗模式等操作。

覆盖基础导航、功能调用、任务管理等高频场景，按使用场景分类，方便快速查阅：

功能场景	操作说明	快捷键（Mac）
核心面板	打开/关闭操作面板	⌘ K
	搜索框聚焦（面板打开时）	Tab
	退出当前面板/返回上一级	Esc
操作选择	上下浏览操作列表	↑ / ↓ 方向键
	确认选择当前操作	Enter
	快速搜索特定操作	面板打开后直接输入关键词
任务管理	标记任务为已完成	打开面板 → 搜索“Mark as Complete”（或设置自定义快捷键）
应用/命令管理	打开应用程序	面板搜索应用名称 → Enter
	运行脚本命令（Script Commands）	面板搜索脚本名称 → Enter
	执行自定义快捷方式（Shortcuts）	面板搜索快捷方式名称 → Enter
效率提升	查看操作的快捷键提示	面板中选中操作 → 悬停查看底部提示
	自定义操作快捷键	Raycast 设置 → Commands → 选择操作 → 编辑 Shortcut
全局控制	显示 Raycast 主窗口	⌥ 空格（默认，可修改）
	隐藏 Raycast 所有窗口	⌘ H

补充说明：

Raycast 支持扩展和脚本，能根据需求自定义功能，适配开发者等进阶用户的场景。

扩展插件（Extension）
1. 安装扩展：在主面板搜索“Store”打开扩展商店，可按分类筛选插件，带⭐图标的为 AI 扩展。比如安装 Spotify 扩展控制音乐播放，安装 Calendar 扩展管理日程。
2. AI 扩展使用：输入 @ 可呼出所有 AI 扩展，例如 @calendar 可协助创建日程，@raycast-focus 能设置专注模式。还可在聊天设置中添加 AI 扩展预设，自定义使用规则，如设置日程中会议链接的添加规则。
脚本命令与管道命令
1. 脚本命令：搜索“Create Script Command”可生成新脚本，支持多种编程语言。脚本可实现个性化需求，比如编写脚本快速打开指定网页。
2. 管道命令：用于处理选中文本或剪贴板内容。创建脚本时将 @raycast.mode 设为 pipe 即可。例如编写格式化 JSON 的脚本，选中混乱的 JSON 文本后，通过管道命令执行脚本，就能快速整理格式。
自定义快捷键：除默认快捷键外，可在 设置 > Commands 中为常用操作设置专属快捷键；也能调整收藏项目顺序，通过 ⌘ ⌥ ↑/⌘ ⌥ ↓ 上下移动收藏项。