> ## Documentation Index
> Fetch the complete documentation index at: https://craft-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Craft 快捷指令操作参考

> Apple 快捷指令中 Craft 操作的参数、默认值、行为和返回值。

本文介绍 iPhone、iPad 和 Mac 上 Apple“快捷指令”App 中的 Craft 操作。操作按你在“快捷指令”中看到的类别分组。展开某个操作，可查看它的参数和返回值。

使用文档和文件夹操作时，请先选择**空间**，再打开文档或文件夹选择器。选择空间之前，选择器是空的。部分操作可以根据前一个操作传入的文档推断空间；目标为每日笔记时，仍需明确选择空间。文档或文件夹必须属于该空间。要使用前面步骤的结果，请通过变量选择器插入。

当操作要求提供**文档**、**文件夹**或**任务**时，请从列表中选择，或传入前一个 Craft 操作的结果。输入标题或粘贴链接无效。Siri 操作则使用 Apple 的命名：**笔记**即 Craft 文档，**提醒**即 Craft 任务。

## 文档

<AccordionGroup>
  <Accordion title="创建文档" id="create-document">
    在空间中创建新文档，可选择放在某个文件夹内。每次运行都会创建一个新文档，即使已有同名文档。

    #### 参数

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

    #### 返回值

    **Craft 文档**：新文档。可将其传给“添加到文档”“重命名文档”或“打开文档”。

    相关示例：[导入文本文件并生成标题](/zh-Hans/integrate/apple-shortcuts/examples#导入文本文件并生成标题)。
  </Accordion>

  <Accordion title="添加到文档" id="add-to-document">
    将内容添加到文档或页面的开头或末尾。现有内容和标题保持不变。每次运行都会再次添加内容，即使内容已经存在。

    #### 参数

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

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

    如果“内容”和“图片”都为空，则不会添加任何内容。

    #### 返回值

    **Craft 文档**：接收内容的文档。如果添加到的是页面，返回的是它所属的文档，而不是该页面或新添加的块。

    相关示例：[语音收件箱](/zh-Hans/integrate/apple-shortcuts/examples#语音收件箱)。
  </Accordion>

  <Accordion title="重命名文档" id="rename-document">
    更改文档的标题。文档的内容和所在文件夹保持不变。重命名的是整个文档，而不是其中的页面或小标题。

    #### 参数

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

    “重命名文档”的选择器中不显示每日笔记。

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

    #### 返回值

    **Craft 文档**：重命名后的文档。

    相关示例：[导入文本文件并生成标题](/zh-Hans/integrate/apple-shortcuts/examples#导入文本文件并生成标题)。
  </Accordion>

  <Accordion title="打开文档" id="open-document">
    在 Craft 中打开文档或页面。

    #### 参数

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

    #### 返回值

    无。
  </Accordion>

  <Accordion title="打开每日笔记" id="open-daily-note">
    打开今天、明天、昨天或指定日期的每日笔记。

    #### 参数

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

    #### 返回值

    无。
  </Accordion>

  <Accordion title="移动文档" id="move-document">
    将文档移到同一空间中的另一个文件夹。文档的标题和内容保持不变。

    #### 参数

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

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

    #### 返回值

    **Craft 文档**：移动后的文档。
  </Accordion>

  <Accordion title="删除文档" id="delete-document">
    将文档移到回收站；如果开启“永久删除”，则永久删除文档。

    #### 参数

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

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

    #### 返回值

    无。
  </Accordion>

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

    #### 参数

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

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

    #### 返回值

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

  <Accordion title="向文档添加子页面" id="add-subpage-to-document">
    在文档或页面中创建新页面。

    #### 参数

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

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

    #### 返回值

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

  <Accordion title="获取第一级块" id="get-first-level-blocks">
    返回文档或页面中顶层块的文本。不包含嵌套块。

    #### 参数

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

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

    #### 返回值

    **文本**：每个块的文本，每行一个。
  </Accordion>
</AccordionGroup>

## 文件夹

<AccordionGroup>
  <Accordion title="创建文件夹" id="create-folder">
    在空间中创建文件夹，可选择放在另一个文件夹内。

    #### 参数

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

    #### 返回值

    **Craft 文件夹**：新文件夹。
  </Accordion>

  <Accordion title="打开文件夹" id="open-folder">
    在 Craft 中打开文件夹。

    #### 参数

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

    #### 返回值

    无。
  </Accordion>

  <Accordion title="重命名文件夹" id="rename-folder">
    更改文件夹的名称。

    #### 参数

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

    #### 返回值

    **Craft 文件夹**：重命名后的文件夹。
  </Accordion>

  <Accordion title="移动文件夹" id="move-folder">
    将文件夹移入同一空间中的另一个文件夹，或移到顶层。

    #### 参数

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

    #### 返回值

    **Craft 文件夹**：移动后的文件夹。
  </Accordion>

  <Accordion title="删除文件夹" id="delete-folder">
    删除文件夹及其子文件夹。其中的文档不会被删除，而是移到上一级文件夹；如果该文件夹位于顶层，则移到“未分类”。

    #### 参数

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

    内置文件夹无法删除。

    #### 返回值

    无。
  </Accordion>
</AccordionGroup>

## 导航

<AccordionGroup>
  <Accordion title="打开 Craft" id="open-craft">
    打开 Craft，可指定空间和视图。

    #### 参数

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

    如果两者都为空，Craft 会在你上次离开的位置打开。

    #### 返回值

    无。
  </Accordion>

  <Accordion title="打开并搜索" id="open-and-search">
    在空间中打开搜索，可预先填入搜索词。

    #### 参数

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

    #### 返回值

    无。
  </Accordion>

  <Accordion title="打开 Quick Entry" id="open-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。快捷指令不会取回你创建的项目。

    #### 返回值

    无。
  </Accordion>
</AccordionGroup>

## 标签

<AccordionGroup>
  <Accordion title="打开标签" id="open-tag">
    显示空间中带有某个标签的文档。

    #### 参数

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

    #### 返回值

    无。
  </Accordion>
</AccordionGroup>

## 任务

<AccordionGroup>
  <Accordion title="创建任务" id="create-task">
    在文档或子页面的顶部创建任务，或在空间的任务 Inbox 中创建任务。内容和图片会添加在任务内部。

    #### 参数

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

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

    #### 返回值

    **Craft 任务**：新任务。可将其传给“设置任务状态”。
  </Accordion>

  <Accordion title="设置任务状态" id="set-task-status">
    将任务标记为待完成、已完成或已取消。

    #### 参数

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

    #### 返回值

    **Craft 任务**：更新后的任务。
  </Accordion>

  <Accordion title="打开任务列表" id="open-tasks-list">
    在 Craft 中打开你的某个任务列表。

    #### 参数

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

    #### 返回值

    无。
  </Accordion>
</AccordionGroup>

## 提醒

<AccordionGroup>
  <Accordion title="创建提醒" id="create-reminder">
    创建一个不附加到文档的 Craft 提醒。它不同于 Siri 操作中的“创建提醒”，后者创建的是任务。

    #### 参数

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

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

    #### 返回值

    无。
  </Accordion>
</AccordionGroup>

## Siri 操作

这些操作遵循 Apple 为笔记、提醒和 App 内搜索定义的格式，因此 Siri 和 Apple Intelligence 可以使用它们。你也可以像添加其他操作一样，将它们添加到快捷指令中。它们需要 iOS、iPadOS 或 macOS 27 或更高版本。

在这些操作中，**笔记**即 Craft 文档，**提醒**即 Craft 任务。文本以纯文本形式添加，Markdown 不会被转换。“模板”及其子文件夹中的文档不会出现在 Find Note 和“笔记”选择器中。Siri 操作的“文件夹”选择器中也不包含“模板”及其子文件夹。

<AccordionGroup>
  <Accordion title="Create Note" id="create-note">
    创建 Craft 文档。“内容”中的每个非空行都会成为一个独立的块。

    #### 参数

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

    #### 返回值

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

  <Accordion title="Find Note" id="find-note">
    在你的所有空间中查找 Craft 文档。回收站中的文档、隐藏的文档，以及“模板”或其子文件夹中的文档不包含在内。

    #### 参数

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

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

    #### 返回值

    **Craft 笔记列表**：匹配的文档。
  </Accordion>

  <Accordion title="Open Note" id="open-note">
    打开 Craft 文档。

    #### 参数

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

    #### 返回值

    无。
  </Accordion>

  <Accordion title="Update Note" id="update-note">
    更改文档的标题、附件、收藏状态或文件夹。留空的项目保持不变。

    #### 参数

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

    “文件夹”选择器会列出所有空间中的文件夹，并标注空间和文件夹名称。请选择文档当前空间中的文件夹。选择其他空间中的文件夹会导致操作失败，并显示“所选项目属于不同的空间”。

    如果移动文件夹失败，操作会报告错误。已经应用的标题、收藏或附件更改仍会保存。

    要向文档添加文本，请使用 Append Text to Note。

    #### 返回值

    **Craft 笔记**：更新后的文档。
  </Accordion>

  <Accordion title="Append Text to Note" id="append-text-to-note">
    将文本添加到 Craft 文档末尾。每个非空行都会成为一个独立的块。

    #### 参数

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

    #### 返回值

    **Craft 笔记**：更新后的文档。
  </Accordion>

  <Accordion title="创建提醒（Siri 操作）" id="create-reminder-siri-actions">
    在空间的任务 Inbox 中创建 Craft 任务。它不同于“提醒”类别中的“创建提醒”。

    #### 参数

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

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

    #### 返回值

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

  <Accordion title="打开提醒" id="open-reminder">
    打开 Craft 任务。Inbox 中的任务会在 Inbox 中打开；其他任务会在所在的文档中打开。

    #### 参数

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

    #### 返回值

    无。
  </Accordion>

  <Accordion title="更新提醒" id="update-reminder">
    更新 Craft 任务。留空的项目保持不变。

    #### 参数

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

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

    #### 返回值

    **Craft 提醒**：更新后的任务。
  </Accordion>

  <Accordion title="删除提醒" id="delete-reminders">
    删除一个或多个 Craft 任务。

    #### 参数

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

    #### 返回值

    无。
  </Accordion>

  <Accordion title="搜索文档" id="search-documents">
    用你的搜索词打开 Craft 搜索。

    #### 参数

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

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

    #### 返回值

    无。
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.