Craft 快捷指令操作参考

本文介绍 iPhone、iPad 和 Mac 上 Apple“快捷指令”App 中的 Craft 操作。操作按你在“快捷指令”中看到的类别分组。展开某个操作，可查看它的参数和返回值。使用文档和文件夹操作时，请先选择空间，再打开文档或文件夹选择器。选择空间之前，选择器是空的。部分操作可以根据前一个操作传入的文档推断空间；目标为每日笔记时，仍需明确选择空间。文档或文件夹必须属于该空间。要使用前面步骤的结果，请通过变量选择器插入。当操作要求提供文档、文件夹或任务时，请从列表中选择，或传入前一个 Craft 操作的结果。输入标题或粘贴链接无效。Siri 操作则使用 Apple 的命名：笔记即 Craft 文档，提醒即 Craft 任务。

文档

创建文档

在空间中创建新文档，可选择放在某个文件夹内。每次运行都会创建一个新文档，即使已有同名文档。

参数

参数	类型	必填	默认值	说明
空间	Craft 空间	是	无	创建文档所在的空间。
文件夹	Craft 文件夹	否	未分类	所选空间中的目标文件夹。可以传入“创建文件夹”返回的文件夹。
标题	文本	否	空	文档标题。
内容	文本	否	空	正文内容。Markdown 会转换为带格式的 Craft 块。
图片	图片文件列表	否	空	添加到正文中“内容”之后的图片。不会设置文档封面。
打开应用	布尔值	否	关	创建后打开新文档。

返回值

Craft 文档：新文档。可将其传给“添加到文档”“重命名文档”或“打开文档”。相关示例：导入文本文件并生成标题。

添加到文档

将内容添加到文档或页面的开头或末尾。现有内容和标题保持不变。每次运行都会再次添加内容，即使内容已经存在。

参数

参数	类型	必填	默认值	说明
空间	Craft 空间	否	所选文档所在的空间	目标空间。目标为每日笔记时请选择。
文档	Craft 文档或页面	是	无	目标文档或页面。可以传入前一个操作的结果。
内容	文本	否	空	要添加的文本。Markdown 会转换为带格式的 Craft 块。
图片	图片文件列表	否	空	添加在“内容”之后的图片。
位置	追加或前置	否	追加	将内容添加到目标的末尾或开头。
打开应用	布尔值	否	关	完成后打开目标。

每日笔记（今天）、每日笔记（昨天）、每日笔记（明天），在快捷指令运行时始终指向正确的那一天。如果当天的每日笔记还不存在，Craft 会创建它。要添加到文档中的某个页面，请将“查找页面”的结果作为“文档”传入。如果“内容”和“图片”都为空，则不会添加任何内容。

返回值

Craft 文档：接收内容的文档。如果添加到的是页面，返回的是它所属的文档，而不是该页面或新添加的块。相关示例：语音收件箱。

重命名文档

更改文档的标题。文档的内容和所在文件夹保持不变。重命名的是整个文档，而不是其中的页面或小标题。

参数

参数	类型	必填	默认值	说明
空间	Craft 空间	是	无	文档所在的空间。
文档	Craft 文档	是	无	要重命名的文档。选择一个文档，或插入前一个操作的结果。
标题	文本	是	无	新标题。按原样使用，包括其中的引号或格式。
打开应用	布尔值	否	关	完成后打开文档。

“重命名文档”的选择器中不显示每日笔记。传入子页面而不是整个文档，会导致操作失败。

返回值

Craft 文档：重命名后的文档。相关示例：导入文本文件并生成标题。

打开文档

在 Craft 中打开文档或页面。

参数

参数	类型	必填	默认值	说明
空间	Craft 空间	否	所选文档所在的空间	文档所在的空间。
文档	Craft 文档或页面	是	无	要打开的文档或页面。

返回值

无。

打开每日笔记

打开今天、明天、昨天或指定日期的每日笔记。

参数

参数	类型	必填	默认值	说明
空间	Craft 空间	是	无	每日笔记所在的空间。
日期	选项	否	今天	今天、明天、昨天或自定义日期。
日期 (yyyy-MM-dd)	文本	“日期”为“自定义日期”时	无	要打开的日期，例如 2026-10-13。

返回值

无。

移动文档

将文档移到同一空间中的另一个文件夹。文档的标题和内容保持不变。

参数

参数	类型	必填	默认值	说明
空间	Craft 空间	是	无	文档所在的空间。
文档	Craft 文档	是	无	要移动的文档。
文件夹	Craft 文件夹	否	未分类	目标文件夹。留空则将文档移到“未分类”。
打开应用	布尔值	否	关	完成后打开移动后的文档。

传入子页面而不是整个文档，会导致操作失败。

返回值

Craft 文档：移动后的文档。

删除文档

将文档移到回收站；如果开启“永久删除”，则永久删除文档。

参数

参数	类型	必填	默认值	说明
空间	Craft 空间	是	无	文档所在的空间。
文档	Craft 文档	是	无	要删除的文档。
永久删除	布尔值	否	关	关闭时将文档移到回收站。开启时永久删除文档。
打开应用	布尔值	否	关	完成后打开 Craft。

传入子页面而不是整个文档，会导致操作失败。

返回值

无。

查找页面

在文档或页面中查找你输入的标题，包括嵌套内容。匹配时比较完整标题，不区分大小写，并先检查页面，再检查其他块。每次查找都返回从上往下的第一个匹配项。

参数

参数	类型	必填	默认值	说明
空间	Craft 空间	是	无	文档所在的空间。
文档	Craft 文档或页面	是	无	要搜索的文档或页面。可以传入前一个操作的结果。
标题	文本	是	无	要匹配的完整标题，不区分大小写。部分标题无法匹配。
打开应用	布尔值	否	关	完成后打开匹配的页面或块。

如果没有匹配的页面，“查找页面”会在其他块中搜索匹配的文本。它只搜索所选文档或页面及其嵌套内容，不会搜索整个空间。如果没有任何匹配，操作会失败，并显示“无法找到子页面”。

返回值

Craft 文档或页面：匹配的块。可将其传给“添加到文档”或“打开文档”。

向文档添加子页面

在文档或页面中创建新页面。

参数

参数	类型	必填	默认值	说明
空间	Craft 空间	否	所选文档所在的空间	目标为每日笔记时请选择。
文档	Craft 文档或页面	是	无	要添加新页面的文档或页面。可以传入前一个操作的结果。
标题	文本	是	无	新页面的标题。
内容	文本	否	空	新页面的内容。Markdown 会转换为带格式的 Craft 块。
图片	图片文件列表	否	空	添加在“内容”之后的图片。
位置	追加或前置	否	追加	将页面添加到目标的末尾或开头。
打开应用	布尔值	否	关	完成后打开新子页面。

目标为每日笔记时，在快捷指令运行时始终指向正确的那一天；如果该每日笔记还不存在，Craft 会创建它。

返回值

Craft 文档：指向新子页面（而不是其所属文档）的文档值。可将其传给接受文档或页面的操作。

获取第一级块

返回文档或页面中顶层块的文本。不包含嵌套块。

参数

参数	类型	必填	默认值	说明
空间	Craft 空间	是	无	文档所在的空间。
文档	Craft 文档或页面	是	无	要读取的文档或页面。可以传入前一个操作的结果。
数字	整数	否	所有顶层块	从顶部开始读取的块数。为 0 时返回空文本。

只返回文本块。代码、表格、链接、图片和文件会被跳过，但仍计入“数字”。不包含文档标题。

返回值

文本：每个块的文本，每行一个。

文件夹

创建文件夹

在空间中创建文件夹，可选择放在另一个文件夹内。

参数

参数	类型	必填	默认值	说明
空间	Craft 空间	是	无	创建文件夹所在的空间。
名称	文本	是	无	文件夹名称。不能为空。
父文件夹	Craft 文件夹	否	无（顶层）	新文件夹所在的文件夹。
打开应用	布尔值	否	关	完成后打开新文件夹。

返回值

Craft 文件夹：新文件夹。

打开文件夹

在 Craft 中打开文件夹。

参数

参数	类型	必填	默认值	说明
空间	Craft 空间	是	无	文件夹所在的空间。
文件夹	Craft 文件夹	是	无	要打开的文件夹。

返回值

无。

重命名文件夹

更改文件夹的名称。

参数

参数	类型	必填	默认值	说明
空间	Craft 空间	是	无	文件夹所在的空间。
文件夹	Craft 文件夹	是	无	要重命名的文件夹。
名称	文本	是	无	新名称。不能为空。
打开应用	布尔值	否	关	完成后打开重命名后的文件夹。

返回值

Craft 文件夹：重命名后的文件夹。

移动文件夹

将文件夹移入同一空间中的另一个文件夹，或移到顶层。

参数

参数	类型	必填	默认值	说明
空间	Craft 空间	是	无	文件夹所在的空间。
文件夹	Craft 文件夹	是	无	要移动的文件夹。
父文件夹	Craft 文件夹	否	无（顶层）	要移入的文件夹。留空则移到顶层。
打开应用	布尔值	否	关	完成后打开移动后的文件夹。

返回值

Craft 文件夹：移动后的文件夹。

删除文件夹

删除文件夹及其子文件夹。其中的文档不会被删除，而是移到上一级文件夹；如果该文件夹位于顶层，则移到“未分类”。

参数

参数	类型	必填	默认值	说明
空间	Craft 空间	是	无	文件夹所在的空间。
文件夹	Craft 文件夹	是	无	要删除的文件夹。
打开应用	布尔值	否	关	完成后打开 Craft。

内置文件夹无法删除。

返回值

无。

参数	类型	必填	默认值	说明
空间	Craft 空间	否	上次使用的空间	要打开的空间。
位置	选项	否	无	所有文档、标签、收藏、任务或日历。

参数	类型	必填	默认值	说明
空间	Craft 空间	是	无	要搜索的空间。
查询	文本	否	空	搜索词。留空则打开搜索，不填入搜索词。

参数	类型	必填	默认值	说明
空间	Craft 空间	是	无	条目要添加到的空间。
模式	选项	否	新建文档	新建文档、新建任务、添加到每日笔记或追加到文档。
文件夹	Craft 文件夹	否	未分类	新文档所在的文件夹。仅用于“新建文档”。
文档	Craft 文档	用于“追加到文档”时	用于“新建任务”时因平台而异	“追加到文档”或“新建任务”的目标位置。使用“新建任务”且未指定文档时，Mac 使用“未归档”；iPhone 和 iPad 使用 Quick Entry 上次保存的任务位置，如果没有，则使用“未归档”。
计划日期 (yyyy-MM-dd)	文本	否	无	“新建任务”的计划日期。
日期	选项	否	今天	“添加到每日笔记”使用的每日笔记：今天、明天、昨天或自定义日期。
日期 (yyyy-MM-dd)	文本	“日期”为“自定义日期”时	无	“添加到每日笔记”使用的每日笔记日期。
内容	文本	否	空	要填入的文本。

在 Mac 上，这会打开 Quick Entry 窗口。在 iPhone 和 iPad 上，这会在 Craft 中打开 Quick Entry。快捷指令不会取回你创建的项目。

返回值

无。

参数	类型	必填	默认值	说明
空间	Craft 空间	是	无	标签所在的空间。
标签	Craft 标签	是	无	要打开的标签。请从列表中选择。

任务

创建任务

在文档或子页面的顶部创建任务，或在空间的任务 Inbox 中创建任务。内容和图片会添加在任务内部。

参数

参数	类型	必填	默认值	说明
空间	Craft 空间	是	无	任务所在的空间。
文档	Craft 文档或页面	是	无	任务所在的文档或子页面，或选择“未归档”。传入“查找页面”或“向文档添加子页面”返回的子页面，可在该子页面中创建任务。每日笔记选项在快捷指令运行时始终指向正确的那一天。
标题	文本	是	无	任务文本。
内容	文本	否	空	任务内部的内容。Markdown 会转换为带格式的 Craft 块。
图片	图片文件列表	否	空	添加在“内容”之后的图片。
日程	选项	否	无	无、今天、明天或个人。
自定义计划日期 (yyyy-MM-dd)	文本	“日程”为“个人”时	无	计划日期。
截止日期	选项	否	无	无、今天、明天或个人。
自定义截止日期 (yyyy-MM-dd)	文本	“截止日期”为“个人”时	无	截止日期。
提醒	选项	否	无	无、今天、明天或个人。
自定义提醒 (yyyy-MM-dd HH:mm)	文本	“提醒”为“个人”时	无	提醒的日期和时间。
提醒时间	文本	“提醒”为“今天”或“明天”时	无	24 小时制时间，例如 09:30。
打开应用	布尔值	否	关	完成后打开新任务。

日程和截止日期只包含日期。提醒会发送通知，因此还需要时间。

返回值

Craft 任务：新任务。可将其传给“设置任务状态”。

设置任务状态

将任务标记为待完成、已完成或已取消。

参数

参数	类型	必填	默认值	说明
空间	Craft 空间	是	无	任务所在的空间。
文档	Craft 文档	是	无	任务所在的文档；对于 Inbox 中的任务，选择“未归档”。选择其他文档会导致操作失败。
任务	Craft 任务	是	无	要更新的任务。选择一个任务，或插入前一个操作的结果。
状态	选项	否	已完成	待完成、已完成或已取消。
打开应用	布尔值	否	关	完成后打开更新后的任务。

返回值

Craft 任务：更新后的任务。

打开任务列表

在 Craft 中打开你的某个任务列表。

参数

参数	类型	必填	默认值	说明
空间	Craft 空间	否	上次使用的空间	要显示其任务的空间。
任务类型	选项	否	全部	未归档、今天、即将到来或全部。

返回值

无。

提醒

创建提醒

创建一个不附加到文档的 Craft 提醒。它不同于 Siri 操作中的“创建提醒”，后者创建的是任务。

参数

参数	类型	必填	默认值	说明
用户	Craft 用户	是	无	接收提醒的帐户。
到期日	选项	是	无	20分钟内、1小时后、3小时后、明天、下周、个人或保存以供以后使用。
自定义日期 (yyyy-MM-dd HH:mm)	文本	“到期日”为“个人”时	无	提醒的日期和时间。
文本	文本	是	无	提醒文本。
打开应用	布尔值	否	关	完成后打开 Craft。

“保存以供以后使用”会创建没有到期日的提醒。

返回值

无。

Siri 操作

这些操作遵循 Apple 为笔记、提醒和 App 内搜索定义的格式，因此 Siri 和 Apple Intelligence 可以使用它们。你也可以像添加其他操作一样，将它们添加到快捷指令中。它们需要 iOS、iPadOS 或 macOS 27 或更高版本。在这些操作中，笔记即 Craft 文档，提醒即 Craft 任务。文本以纯文本形式添加，Markdown 不会被转换。“模板”及其子文件夹中的文档不会出现在 Find Note 和“笔记”选择器中。Siri 操作的“文件夹”选择器中也不包含“模板”及其子文件夹。

Create Note

创建 Craft 文档。“内容”中的每个非空行都会成为一个独立的块。

参数

参数	类型	必填	默认值	说明
标题	文本	是	无	文档标题。
内容	文本	否	空	正文文本。
附件	文件列表	否	空	添加在文本之后的文件。
收藏	布尔值	否	关	收藏新文档。
文件夹	Craft 笔记文件夹	否	上次使用的空间中的“未分类”	目标文件夹。文件夹也决定了所在的空间。

返回值

Craft 笔记：新文档。可将其传给 Open Note、Update Note 或 Append Text to Note。

Find Note

在你的所有空间中查找 Craft 文档。回收站中的文档、隐藏的文档，以及“模板”或其子文件夹中的文档不包含在内。

参数

参数	类型	必填	默认值	说明
Search text	文本	否	无	匹配标题的一部分。不区分大小写。
Folder filter	Craft 笔记文件夹	否	无	只查找此文件夹中的文档。
Space filter	Craft 笔记帐户	否	无	只查找此空间中的文档。
Match mode	全部或任一	否	由“快捷指令”设置	多个筛选条件的组合方式。
Sort by	创建日期或修改日期	否	无	按创建日期或修改日期排序结果。
Sort order	升序或降序	否	无	排序方向。
Limit	整数	否	所有匹配项	结果的最大数量。

此操作的搜索、筛选和排序选项由“快捷指令”生成，因此标签可能因系统版本而异。只搜索标题，不搜索文档内容。

返回值

Craft 笔记列表：匹配的文档。

Open Note

打开 Craft 文档。

参数

参数	类型	必填	默认值	说明
笔记	Craft 笔记	是	无	要打开的文档，例如 Create Note 或 Find Note 的结果。

返回值

无。

Update Note

更改文档的标题、附件、收藏状态或文件夹。留空的项目保持不变。

参数

参数	类型	必填	默认值	说明
笔记	Craft 笔记	是	无	要更新的文档。
标题	文本	否	不变	新标题。留空则保留当前标题。
附件	文件列表	否	不变	添加到文档末尾的文件。现有附件会保留。
收藏	布尔值	否	不变	开启时收藏文档。关闭时取消收藏。
文件夹	Craft 笔记文件夹	否	不变	文档当前空间中的目标文件夹。选择“未分类”可将文档移出其文件夹。

“文件夹”选择器会列出所有空间中的文件夹，并标注空间和文件夹名称。请选择文档当前空间中的文件夹。选择其他空间中的文件夹会导致操作失败，并显示“所选项目属于不同的空间”。如果移动文件夹失败，操作会报告错误。已经应用的标题、收藏或附件更改仍会保存。要向文档添加文本，请使用 Append Text to Note。

返回值

Craft 笔记：更新后的文档。

Append Text to Note

将文本添加到 Craft 文档末尾。每个非空行都会成为一个独立的块。

参数

参数	类型	必填	默认值	说明
笔记	Craft 笔记	是	无	要添加内容的文档。
内容	文本	是	无	要添加的文本。空行会被跳过。

返回值

Craft 笔记：更新后的文档。

创建提醒（Siri 操作）

在空间的任务 Inbox 中创建 Craft 任务。它不同于“提醒”类别中的“创建提醒”。

参数

参数	类型	必填	默认值	说明
标题	文本	是	无	任务文本。
空间	Craft 提醒列表	否	你唯一的空间（如果只有一个）	目标空间。如果你有多个空间，Craft 会询问要使用哪一个。
内容	文本	否	空	添加在任务内部的文本。
安排日期	日期	否	无	计划日期。不会设置截止日期或通知。

请将部分留空。设置它会导致操作失败，并显示“不支持分区”。Apple 的格式还会显示已标记、图片、标签、网址、重复和位置触发器。Craft 会忽略这些字段。如需图片、截止日期或通知，请改用创建任务。

返回值

Craft 提醒：新任务。可将其传给“打开提醒”“更新提醒”或“删除提醒”。

打开提醒

打开 Craft 任务。Inbox 中的任务会在 Inbox 中打开；其他任务会在所在的文档中打开。

参数

参数	类型	必填	默认值	说明
提醒	Craft 提醒	是	无	要打开的任务。

返回值

无。

更新提醒

更新 Craft 任务。留空的项目保持不变。

参数

参数	类型	必填	默认值	说明
提醒	Craft 提醒	是	无	要更新的任务。
标题	文本	否	不变	新的任务文本。
内容	文本	否	不变	添加在任务内部的文本。现有内容会保留。
安排日期	日期	否	不变	新的计划日期。不会设置通知。
已完成	布尔值	否	不变	开启时完成任务。关闭时标记为未完成。
空间	Craft 提醒列表	否	空（任务保留在原空间）	如果设置，必须是任务当前所在的空间。选择其他空间会失败，并显示“不支持在空间之间移动任务”。

将标题、内容或安排日期留空会保留当前值，而不会清除它。Apple 的格式还会显示标签、网址、重复、已标记和位置触发器。Craft 会忽略这些字段。

返回值

Craft 提醒：更新后的任务。

删除提醒

删除一个或多个 Craft 任务。

参数

参数	类型	必填	默认值	说明
提醒	多个 Craft 提醒	是	无	要删除的任务。它们可以位于不同的空间。

返回值

无。

搜索文档

用你的搜索词打开 Craft 搜索。

参数

参数	类型	必填	默认值	说明
搜索	文本	是	无	搜索词。

搜索你在 Craft 中打开的空间，或上次使用的空间。结果会在 Craft 中打开；快捷指令不会取回文档列表。要选择空间，请使用打开并搜索。

返回值

无。

​文档

​参数

​返回值

​参数

​返回值

​参数

​返回值

​参数

​返回值

​参数

​返回值

​参数

​返回值

​参数

​返回值

​参数

​返回值

​参数

​返回值

​参数

​返回值

​文件夹

​参数

​返回值

​参数

​返回值

​参数

​返回值

​参数

​返回值

​参数

​返回值

​导航

​参数

​返回值

​参数

​返回值

​参数

​返回值

​标签

​参数

​返回值

​任务

​参数

​返回值

​参数

​返回值

​参数

​返回值

​提醒

​参数

​返回值

​Siri 操作

​参数

​返回值

​参数

​返回值

​参数

​返回值

​参数

​返回值

​参数

​返回值

​参数

​返回值

​参数

​返回值

​参数

​返回值

​参数

​返回值

​参数

​返回值

文档

参数

返回值

参数

返回值

参数

返回值

参数

返回值

参数

返回值

参数

返回值

参数

返回值

参数

返回值

参数

返回值

参数

返回值

文件夹

参数

返回值

参数

返回值

参数

返回值

参数

返回值

参数

返回值

导航

参数

返回值

参数

返回值

参数

返回值

标签

参数

返回值

任务

参数

返回值

参数

返回值

参数

返回值

提醒

参数

返回值

Siri 操作

参数

返回值

参数

返回值

参数

返回值

参数

返回值

参数

返回值

参数

返回值

参数

返回值

参数

返回值

参数

返回值

参数

返回值