---
title: "感知上下文的 Orylo Actions"
description: "让可复用的 Actions 在合适的上下文中出现，组合所需输入，并精确选择运行方式和结果交付方式。"
locale: "zh-CN"
canonical: "https://orylo.io/zh-CN/docs/actions"
product_status: "in-development"
last_reviewed: "2026-10-12"
---

# 感知上下文的 Orylo Actions

让可复用的 Actions 在合适的上下文中出现，组合所需输入，并精确选择运行方式和结果交付方式。

<a id="context-aware"></a>

## 根据当前上下文提供操作

一个 Orylo Action 包含三项决定：何时可用、执行什么，以及将结果送到哪里。Action Bar（操作栏）会将当前上下文与每个已启用 Action 的规则进行匹配；你无需先把所有内容复制到新对话中。

感知上下文是指将捕获的上下文与你配置的规则进行匹配，并不意味着持续监视屏幕或自动运行 Action。由你选择运行哪个匹配的 Action。

| 上下文 | 提供的内容 |
| --- | --- |
| Selected Text（选中文字） | 你选中的文字，适用于改写、翻译或 Promptize。 |
| 文件、文件夹或图片 | 根据配置的输入，提供选中的文件或图片，或文件夹路径。 |
| Web Page（网页） | 当前页面的 URL，不会自动复制网页正文。 |
| Focused Window（焦点窗口） | 应用标识、可获取的窗口标题，以及按需截取的屏幕截图；捕获需要权限。 |
| Application（应用） | 当前活跃应用的标识，可选用指定应用的条件。 |

<a id="match-rules"></a>

## 决定 Action 何时出现

选择一个 Primary Context（主要上下文）：这是必选项，用于定义主要输入。如果要求所有附加上下文都存在，请添加 All Of（全部满足）条件；如果要求至少存在一种备选上下文，请添加 Any Of（任一满足）条件。AI Actions 会收到所有已配置且实际可用的上下文，而不只是第一个匹配的备选项。

例如，同时要求 Selected Text 和 Web Page，就能让 Action 仅在文字和页面 URL 同时可用时出现。若要将 Action 限定在某个应用中，请将 Application 设为必需条件，并选择该应用；仅将 Application 设为可选条件，并不能保证 Action 只在该应用中可用。

这些规则控制的是可用性，不会授予文件访问或屏幕录制权限。如果某个 Action 没有出现，请检查它是否已启用、所需上下文是否齐全，以及来源应用和捕获权限。

<a id="operations"></a>

## 选择操作和结果交付方式

对于 AI 结果，可以选择发送到结果面板、剪贴板或 Composer（输入区），替换原先选中的文字，或不自动交付。后台命令的输出可以发送到面板、剪贴板或 Composer；在新 Terminal 窗口中运行时，不会将输出收集到 Orylo。打开网页操作只会打开配置的 URL。

除了行为，你还可以自定义 Action 的名称、描述、图标、启用状态和排序。运行命令前请先检查：命令会在你的 Mac 上执行，并不会仅仅因为被配置为 Action 就变得安全。

| 操作 | 自定义选项与边界 |
| --- | --- |
| AI Action | 选择 Assistant 并设置指令。它会收到主要上下文，以及已配置且可用的附加上下文。Chat Assistant 根据提供的内容生成结果；Agent Assistant 可以使用为其配置的工具。 |
| Open Web Page（打开网页） | 设置 URL 模板。选中文字或页面 URL 可经编码后填入模板的上下文占位符。附加条件只决定可用性，不会传入 URL。 |
| Run Command（运行命令） | 设置脚本、工作目录、超时时间，以及在后台还是新 Terminal 窗口中执行。只有主要输入会作为数据传入；应用或窗口输入目前不会向脚本提供上下文文本。 |

<a id="create"></a>

## 使用 Create with Chat，或自行配置

1. **描述工作流程** — 打开 Settings（设置）→ Actions → 添加 → Create with Chat。指定主要输入、必需的上下文、操作、需要时使用的 Assistant，以及交付方式。创建时需要一个已能正常工作的 Agent Assistant。
2. **检查拟议配置** — 要求先提供预览，并确认匹配条件、指令或命令、目标 Assistant 和输出位置。只保存你想要的配置；保存不会执行 Action。
3. **用一个小例子试用** — 回到目标应用并准备好上下文，打开 Action Bar，主动运行已保存的 Action。你可以在 Settings 中调整，也可以继续创建时的对话。还可以使用 Create Manually（手动创建）。

<a id="groups"></a>

## 用 Action Groups 整理选项

Action Group 是一组备选操作的菜单，不是依次运行所有子项的执行序列。例如，针对选中文字的分组可以提供 AI 解释、网页搜索和本地命令。你打开分组后，从中选择一个 Action。

子项共用分组的输入和显示条件，但可以采用不同的操作和结果交付位置。分组不能嵌套。完全禁用的分组不会有可用入口。

<a id="sharing"></a>

## 分享与深度定制 Action 定义

Action 和 Action Group 支持 JSON 导入、导出。使用导入的定义前，检查匹配条件、指令、命令和输出位置。引用的 Assistant 必须能在接收方 Mac 上解析，显示名称相同并不足够。

JSON 格式还支持排除条件（None Of），但当前可视化编辑器没有提供该入口。指定了固定本地工作目录的命令暂不支持导出。可分享的定义不包含捕获到的输入、执行历史或本地排序偏好。

<a id="run"></a>

## 运行并查看执行情况

1. **准备上下文** — 选中所需的文字、文件、文件夹或图片，或让相关应用或窗口获得焦点。使用 Settings 中配置的快捷键打开 Action Bar。
2. **选择匹配的 Action** — 运行前先检查它的用途。AI Action 使用独立的执行会话，不会使用当前打开对话的历史记录。不要假定它包含之前聊天的上下文。
3. **查看进度和输出** — 从展开的 Action Bar 中打开 Action Executions（操作执行记录），查看正在运行的任务、近期结果、部分输出和错误。隐藏操作栏不会取消运行；如需停止，请在执行详情中明确停止。

<a id="control"></a>

## 掌控交付方式和权限

自动替换仅适用于以选中文字为主要输入的 AI Action。它取决于来源应用，以及原始选区是否仍然有效且可编辑。如果交付失败，请查看保留的结果，不要直接重新运行可能产生副作用的任务。

Actions 不提供交互式权限审批流程。需要新批准的请求不会被悄悄放行；需要此类交互的工作，请在普通对话中完成。现有的 Agent 权限仍然适用。

执行记录只在当前应用会话中临时保留，不属于永久对话历史，应用重启后也不会保留。需要长期保留的结果，请复制或保存。可选的 Action 建议功能默认关闭，只会生成可供检查的草稿，不会自动启用或执行 Actions。

## 继续探索

- [Create with Chat](https://orylo.io/zh-CN/docs/create-with-chat)
- [文本、文件与上下文](https://orylo.io/zh-CN/docs/context-attachments)
- [使用 Skills](https://orylo.io/zh-CN/docs/skills)
- [权限与控制](https://orylo.io/zh-CN/docs/permissions)
- [Orylo Intelligence](https://orylo.io/zh-CN/docs/orylo-intelligence)