如何在 Raycast AI 中创建自定义 AI 命令与快捷预设提升桌面工作流

在开发与日常办公中，频繁在代码编辑器、终端与网页端 AI 对话框之间来回切换，往往会打断专注状态。Raycast AI 通过系统级启动器的形态，将大语言模型深度整合进 macOS 桌面环境。用户无需复制文本、切换浏览器、粘贴提问再搬回结果，只需一个快捷键即可在任何前台应用中完成定制化的 AI 处理。

Raycast AI 为常见高频任务提供了两套互补的核心机制：

1. 自定义 AI 命令（Custom AI Commands）：单次触发的提示词动作，直接作用于当前选中的文本或剪贴板内容，支持在浮动窗口显示结果或原地替换选中文字。
2. AI 预设与智能体（AI Presets / Agents）：面向多轮连续对话的系统提示词模板与角色设定，包含专属模型选择、推理深度与绑定的工具扩展。

本文详细介绍如何创建与调优自定义 AI 命令、配置专属预设智能体、运用动态占位符以及绑定全局快捷键，帮助 macOS 用户与开发者搭建流畅的本地 AI 效率流。

一、创建自定义 AI 命令（AI Commands）

自定义 AI 命令适合处理输入与输出明确的单一环节任务，如代码重构、格式转换、语法润色及错误排查。

详细创建步骤

1. 按下 ⌥ Space（或你设定的 Raycast 呼出快捷键）唤起启动器。
2. 在搜索框中输入 Create AI Command 并回车。（也可以在 Search AI Commands 中选中官方预设命令，按 ⌘D 进行复制修改）。
3. 填写命令配置表单：
   • Name & Icon（名称与图标）：设置清晰易识别的名称（如 Refactor to TypeScript 或 Explain SQL Query），并挑选对应图标。
   • Prompt（提示词指令）：输入给模型的具体指令。键入 { 可唤出动态占位符，键入 @ 可引入工具扩展。
   • Model（模型）：指定该命令执行的底座模型（如 Claude 3.5 Sonnet、GPT-4o 或具备深度思考能力的 o1/o3-mini）。若留空则自动继承全局设置（Settings → AI → Models & Providers）。
   • Creativity（发散度 / 随机度）：分为 None、Low、Medium、High 与 Maximum 五档。对于代码重构、接口类型推导、格式化等严谨任务，建议选择 None 或 Low。
   • Reasoning Effort（推理深度）：当选用支持推理预算的模型时，可按需调节思考时长。
   • Output Behavior（输出行为）：
     • Open in Raycast：在独立的 Raycast 悬浮窗中呈现结果，便于查看与复制，按 ⌘J 可将内容直接导入完整 AI Chat 中继续深入探讨。
     • Replace Selection：执行后直接在当前激活的软件中用生成结果替换原选中文本，非常适合文档润色与原地重构。
   • Highlight Editing Changes（高亮变动）：勾选后，在原地替换时会直观标出修改细节。
4. 按下 ⌘ Enter 保存。该命令即可在根搜索栏中即时检索与运行。

二、掌握动态占位符与上下文变量

Raycast 内置丰富的动态占位符（Dynamic Placeholders），使命令能够自动捕获屏幕上的实时上下文，无需手动复制粘贴。

管道修饰符（Modifiers）

占位符支持链式修饰符以规范输入内容：

• {clipboard | trim}：去除剪贴板内容首尾的多余空格与换行。
• {selection | lowercase} 或 {selection | uppercase}：统一文本大小写。
• {selection | json-stringify}：对文本进行转义处理，安全嵌入 JSON 结构体中。
• {clipboard | raw}：防止系统默认附加包裹引号。

开发者实战命令示例

示例 1：原地生成 TypeScript 类型与 JSDoc 注释

• 输出行为：Replace Selection
• Creativity：Low
• Prompt 内容：

Analyze the following code selection:
{selection}

Add strict TypeScript types, explicit interface definitions, and JSDoc documentation. Return only the updated code block without surrounding explanations or markdown wrappers.

示例 2：交互式 Git Commit 信息生成器

• 输出行为：Open in Raycast
• Prompt 内容：

Write a concise, conventional git commit message based on the following diff or staged summary:
{clipboard}

Focus on type: {argument name="Commit Type" default="feat"}.
Format as:
<type>(<scope>): <summary>

- Optional body explaining the why behind the change.

三、配置 AI 预设（Presets）与专属智能体（Agents）

单次执行的 AI 命令适合离散任务，而在多轮复杂研发或创作中，用户往往需要固定的角色设定、特定的编码规范与受控的工具调用权限。

在 Raycast v1 中，这一功能被称为 AI Chat Presets；在 Raycast v2 中，该功能全面升级并定名为 Agents（智能体），并完全兼容现有的预设资源库与社区 Preset Explorer。

创建自定义 Agent / 预设

1. 进入 Settings → AI → Agents（或在主界面运行 Search Agents 并选择 Create Agent）。
2. 配置智能体各项属性：
   • Name & Icon：设定鲜明的身份名称（如 PostgreSQL 调优专家 或 前端代码审查员）。
   • Model：绑定专用模型或选择 Inherit 继承当前对话框所选模型。
   • Instructions（系统指令）：输入长效系统 Prompt，界定其角色立场、架构偏好、语法规范与禁忌事项。
   • AI Extensions（工具扩展）：勾选允许该 Agent 调用的系统与第三方插件工具（如 @calendar、@github 等）。
3. 按下 ⌘ Enter 保存。

呼出与切换预设

• AI 对话窗内快速切换：在 AI Chat 输入框中键入 / 呼出智能体快捷切换菜单，或按 ⌘K → Change Agent。
• 主启动器直达：在根搜索栏直接输入 Agent 名称，回车即可打开预置该角色的独立对话窗口。
• 社区预设导入：访问 presets.ray.so 挑选优质开源预设，一键导入本地 Raycast。

四、全局快捷键绑定与 Quick Fix 极速修正

为了实现指尖上的零阻力操作，可将高频命令与智能体映射为全局快捷键：

1. 绑定独立 Hotkey：

   • 前往 Settings → Extensions → AI（或在任何命令上按 ⌘K → Configure Command）。
   • 在对应命令或 Agent 条目的 Hotkey 一栏中录入快捷键（如为 Git 提交生成器绑定 ⌃⌥C，为代码原地重构绑定 ⌃⌥R）。
   • 配置后，在 VS Code、Xcode 或文本编辑器中选中文本，直接按下 ⌃⌥R 即可原地完成替换，全程无需打开主搜索界面。

2. 活用 Quick Fix 原地语法修正：

   • Raycast 内置了专为文本快速纠错设计的 Quick Fix 功能。
   • 默认双击 右侧 Shift 键（Double Right Shift），即可就地对当前输入框或选中文本进行拼写与语法纠偏。
   • 在 Settings → AI → Quick Fix 中开启 Preserve Formatting（保持格式），可在 Slack、Notion 等富文本工具中纠错时完整保留粗体、行内链接和特定排版。

五、系统权限、费用机制与模型接入注意点

辅助功能权限配置

Replace Selection（原地替换文本）与 Quick Fix 依赖 macOS 辅助功能接口进行模拟输入。初次使用时需前往：

• 系统设置 → 隐私与安全性 → 辅助功能（macOS 27 及更新系统为“设备控制与数据访问”）。
• 确认勾选并允许 Raycast 的控制权限。

订阅机制与 BYOK 自带密钥

• Raycast 基础版：核心启动器功能免费（计算器、剪贴板历史、快捷短语、基础扩展）。
• Raycast Pro（10 美元/月 或 96 美元/年）：包含 Raycast AI，提供每月固定额度的 AI Credits、云端同步与自定义命令功能。
• Pro+ 与 Max 进阶方案：面向重度开发者的更充沛积分额度与高算力模型支持。
• BYOK（自带 API 密钥）与订阅直连：Pro 级以上付费订阅用户支持接入 OpenAI、Anthropic、Google 及 OpenRouter 的独立 API Key，或直接绑定现有的 ChatGPT / Claude 个人订阅，在享受 Raycast 系统级桌交互的同时根据自身需求灵活调度模型算力。

通过合理搭配单步执行的自定义命令与面向深度交互的角色预设，开发者能够在 macOS 系统任意层级无缝调用前沿模型能力，彻底告别繁琐的窗口切换与复制粘贴。

参考资料

• AI Commands | Raycast Manual
• Dynamic Placeholders | Raycast Manual
• Agents | Raycast Manual
• AI Chat | Raycast Manual