Alter Actions

​

什么是 Alter Action？

• AI 指令 — 定义 AI 行为方式的系统提示词
• 触发器 — 语音命令、热键或条件执行
• 上下文 — 访问选中文本、文件、活动应用
• 工具 — 与 Mac 及 2000+ 外部服务的集成配置
• 输出 — 结果的展示方式（Markdown、代码、内联插入）

​

打开「我的操作」

​

方法 1：键盘快捷键（最快）

​

方法 2：窗口菜单

1. 打开任意 Alter 窗口（Hub、QuickHub 或工具与操作）
2. 选择 窗口 → 我的操作

​

方法 3：工具与操作侧边栏

1. 按 ⌘⇧T（Command + Shift + T）打开 工具与操作
2. 在侧边栏中选择 我的操作

​

「我的操作」布局

​

操作列表

• 搜索（⌘F）— 匹配操作名称及已索引的资源属性（工具、Gateways、快速操作及类似关联资源）
• 筛选（筛选图标）— 按后台任务、计划、警告、已修改操作、已发布列表、已禁用操作或特定文件夹缩小范围
• 折叠或展开 文件夹、重命名 文件夹，以及 拖拽操作 在文件夹间移动
• 多选操作 进行批量导出、移动、启用/禁用或删除
• 从工具栏 创建文件夹，然后通过拖放或行上下文菜单添加操作

• 图标和名称 — 双击名称（或选中一行后按 Return）打开操作文档
• 语音触发 指示器（已配置语音短语时显示）
• 由你修改 徽章（自定义了内置操作时显示）
• 后台任务 指示器
• Marketplace 指示器（操作来自列表时显示）
• 警告 指示器（诊断发现配置问题时显示）

​

内联行控件

​

行上下文菜单

​

编辑器聊天

​

在聊天中可以做什么

• 创建 新操作（例如：「做一个每天早上 9 点运行的每日站会摘要操作」）
• 编辑 所选操作的提示词、参数、可见性、模型、工具、计划或 Gateways
• 启用或限定工具 范围（全局或针对单个操作）
• 配置快速操作 — Alter 会打开经过审核的表单，用于 Webhook、AppleScript/JXA、快捷指令及类似设置
• 通过原生批准表单 连接 Connected Applications 和 MCP 服务器
• 安装或启用 Skills
• 诊断警告（单个操作或扫描整个库）
• 查找操作（按名称、描述或关联资源，例如：「哪些操作使用了 Discord Gateway？」）
• 复制回调 URL 用于自动化

​

批准与敏感设置

​

用于建议的个人资料上下文

​

操作文档

• 在列表中双击操作名称
• 选中一个操作并按 Return
• 右键 → 编辑
• 从其他 Alter 窗口，在当前操作可用时选择 在操作编辑器中编辑

​

1. 常规

• 已启用 — 开启或关闭操作
• 模式 — 在 Hub 输入区域将此操作显示为可选模式
• 包含个人资料 — 在 AI 上下文中包含用户个人资料信息
• 保存到历史记录 — 保留此操作的对话到历史记录，便于稍后重新打开和搜索
• 名称、描述、类别、图标
• Workspace — 运行此操作时始终将 workspace 加入上下文
• 全局键盘快捷键 — 在 Mac 任意位置触发此操作
• 语音触发 — 听写期间运行此操作的短语

• 仅在运行时显示 — 仅当所选应用正在运行时才显示操作
• 仅在活跃时显示 — 仅当所选应用获得焦点时才显示操作
• Workspace 上下文 — 限制哪些 workspace 能看到此操作

​

2. 系统提示词

# IDENTITY AND PURPOSE
You are an expert software engineer who explains code clearly
and accessibly to developers of all skill levels.

# STEPS
1. Analyze the provided code
2. Identify its purpose and key components
3. Explain each section in simple terms

# OUTPUT INSTRUCTIONS
- Use markdown formatting
- Include code examples where helpful
- Keep language clear and non-technical

​

3. 用户提示词

Please explain this code:

{{ textSelection }}

Explanation detail: {{ detailLevel }};

• {{ textSelection }} — 当前选中的文本
• {{ filePath }} — 所选文件的路径
• {{ clipboard }} — 剪贴板内容
• 在系统提示词中定义的自定义参数

​

4. 显示时机

• 已安装应用 — 仅在特定应用中显示操作（VSCode、Xcode、Safari 等）
• 应用正在运行 — 操作要求应用正在运行
• 应用获得焦点 — 仅当应用在前台时才可用
• Web 浏览器标签页包含 — 浏览特定域名时显示操作
• 有内容 — 仅当有可用上下文时才显示操作

​

5. 自动化

• 后台任务 — 在后台运行操作，不显示 UI
• 后台 Markdown 渲染 — 后台模式下粘贴时将 Markdown 渲染为 HTML
• 发送系统通知 — 后台任务完成后不久发送通知
• 计划 — 在特定时间执行操作（例如「每周一上午 9 点」）
• 快速操作 — 在首次助手回复后自动执行关联的快速操作

​

6. 工具

• 禁用工具 — 关闭时，仅所选工具可用；开启时，工具访问受限
• 启用工具访问且选择为空时：所有全局激活的工具均可用
• 已配置时：仅所选工具可用

• 减少 AI 决策开销（聚焦相关工具）
• 加快操作执行
• 提升安全性（限制操作可访问的内容）

​

7. 模型

• 模型 — 可搜索的选择器，分组为 当前、收藏 和 其他模型。留空则使用用户的默认模型设置，或为该操作固定特定模型。
  • 每行显示上下文长度、视觉支持和收藏状态
  • 模型支持时，可内联调整 思考力度（低、平衡、最大）
• Temperature — 调整创意与精确度
  • 0.0 — 确定性（一致、可预测）
  • 0.5 — 平衡（默认）
  • 1.0 — 创意（不可预测、探索性）

​

8. Gateways

​

诊断与警告

• 点击行或分区上的警告徽章查看详情和建议修复
• 将列表筛选为 警告 以审计需要关注的操作
• 让编辑器聊天「修复此操作的警告」或「扫描所有操作的问题」

​

最佳实践

​

常见操作示例

​

示例 1：代码解释器

• 名称： 解释代码
• 类别： code
• 已安装应用： VSCode、Xcode
• 系统提示词： 你是一位能清晰解释代码的专家程序员
• 用户提示词： Please explain this code:\n\n{{ textSelection }}
• Consumer： markdown
• Temperature： 0.5

​

示例 2：邮件草稿创建器

• 名称： 起草邮件
• 类别： productivity
• 显示时机： Mail 应用活跃
• 系统提示词： 你是一位专业的商务沟通者
• 用户提示词： Transform this into a professional email:\n\n{{ textSelection }}
• 工具： 仅启用 Mail
• Consumer： in-place
• Temperature： 0.6

​

示例 3：计划每日简报

• 名称： 每日简报
• 类别： productivity
• 自动化： 计划每天上午 9:00
• 后台任务： 已启用
• 系统提示词： 生成每日优先级简报

​

语音触发

​

x-callback-url 集成

​

什么是 x-callback-url？

• 入站 — 从其他应用触发 Alter 操作（快捷指令、备忘录、Safari 等）
• 出站 — 在 Alter 中创建打开其他应用的链接（Bear、OmniFocus、Drafts 等）

​

获取操作的回调 URL

alter://action/{action-id}?input=VALUE&param2=VALUE

​

从其他应用触发 Alter 操作

alter://action/ask-web?input=What+is+Alter+MacOS

alter://action/explain-code?input=const+hello+%3D+%28%29+%3D%3E+%7B%7D

1. 创建新快捷指令
2. 添加「打开 URL」操作
3. 粘贴你的 alter:// URL
4. 运行快捷指令以触发操作

​

使用场景

​

键盘快捷键

​

全局

​

「我的操作」（工具与操作窗口，已选中「我的操作」）

​

操作文档窗口

​

故障排除

​

相关指南

• 创建可复用操作 — 几分钟内完成第一个操作
• 管理工具 — 连接操作使用的集成
• 工具与集成 — 操作可用的工具
• URL 回调 — 深入 x-callback-url 自动化
• 语音与听写 — 设置语音触发
• 设置 — 配置全局模型和语音设置