Craft 快捷指令操作参考

Apple 快捷指令中 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 空间	是	无	要搜索的空间。
查询	文本	否	空	搜索词。留空则打开搜索，不填入搜索词。

​

返回值

无。

打开 Quick Entry

以你选择的模式打开 Quick Entry，可预先填入文本。条目由你自己完成。

​

参数

参数	类型	必填	默认值	说明
空间	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 中打开；快捷指令不会取回文档列表。要选择空间，请使用打开并搜索。

​

返回值

无。