> ## 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 區塊。 |
    | **圖片** | 圖片檔案列表 | 否 | 空白 | 加在內容之後的圖片。不會設定文件封面。 |
    | **開啟 App** | 布林值 | 否 | 關閉 | 建立後開啟新文件。 |

    #### 傳回值

    **Craft 文件**：新文件。可以傳給「加入文件」、「重新命名文件」或「開啟文件」。

    用於[匯入文字檔並產生標題](/zh-Hant/integrate/apple-shortcuts/examples#匯入文字檔並產生標題)。
  </Accordion>

  <Accordion title="加入文件" id="add-to-document">
    將內容加到文件或頁面的開頭或結尾。現有內容和標題保持不變。每次執行都會再加入一次內容，即使內容已經存在。

    #### 參數

    | 參數 | 類型 | 必填 | 預設值 | 說明 |
    | - | - | - | - | - |
    | **空間** | Craft 空間 | 否 | 所選文件的空間 | 目的地空間。目的地為每日筆記時請選擇。 |
    | **文件** | Craft 文件或頁面 | 是 | 無 | 目的地文件或頁面。可以傳入前一個動作的結果。 |
    | **內容** | 文字 | 否 | 空白 | 要加入的文字。Markdown 會轉換為已套用格式的 Craft 區塊。 |
    | **圖片** | 圖片檔案列表 | 否 | 空白 | 加在內容之後的圖片。 |
    | **位置** | 附加或前置 | 否 | 附加 | 將內容加到目的地的結尾或開頭。 |
    | **開啟 App** | 布林值 | 否 | 關閉 | 完成後開啟目的地。 |

    **每日筆記（今天）**、**每日筆記（昨天）** 和 **每日筆記（明天）** 在捷徑執行時一律指向正確的日期。如果該每日筆記尚未存在，Craft 會建立它。若要加到文件內的某個頁面，請將「尋找頁面」的結果傳入作為文件。

    如果內容和圖片都是空白，就不會加入任何東西。

    #### 傳回值

    **Craft 文件**：收到內容的文件。如果你加到的是頁面，得到的是它的上層文件，而不是該頁面或新區塊。

    用於[語音收件匣](/zh-Hant/integrate/apple-shortcuts/examples#語音收件匣)。
  </Accordion>

  <Accordion title="重新命名文件" id="rename-document">
    變更文件標題。內容和所在資料夾保持不變。重新命名的是整份文件，而不是其中的頁面或標題。

    #### 參數

    | 參數 | 類型 | 必填 | 預設值 | 說明 |
    | - | - | - | - | - |
    | **空間** | Craft 空間 | 是 | 無 | 文件所在的空間。 |
    | **文件** | Craft 文件 | 是 | 無 | 要重新命名的文件。挑選文件，或插入前一個動作的結果。 |
    | **大標題** | 文字 | 是 | 無 | 新標題。會完全照原樣使用，包括任何引號或格式。 |
    | **開啟 App** | 布林值 | 否 | 關閉 | 完成後開啟文件。 |

    每日筆記不會出現在「重新命名文件」的選擇器中。

    傳入子頁面而非整份文件時，動作會失敗。

    #### 傳回值

    **Craft 文件**：已重新命名的文件。

    用於[匯入文字檔並產生標題](/zh-Hant/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 資料夾 | 否 | 未分類 | 目的地資料夾。留空會將文件移到未分類。 |
    | **開啟 App** | 布林值 | 否 | 關閉 | 完成後開啟已移動的文件。 |

    傳入子頁面而非整份文件時，動作會失敗。

    #### 傳回值

    **Craft 文件**：已移動的文件。
  </Accordion>

  <Accordion title="刪除文件" id="delete-document">
    將文件移到垃圾桶；如果開啟「永久刪除」，則會永久刪除。

    #### 參數

    | 參數 | 類型 | 必填 | 預設值 | 說明 |
    | - | - | - | - | - |
    | **空間** | Craft 空間 | 是 | 無 | 文件所在的空間。 |
    | **文件** | Craft 文件 | 是 | 無 | 要刪除的文件。 |
    | **永久刪除** | 布林值 | 否 | 關閉 | 關閉時會將文件移到垃圾桶。開啟時會永久刪除。 |
    | **開啟 App** | 布林值 | 否 | 關閉 | 完成後開啟 Craft。 |

    傳入子頁面而非整份文件時，動作會失敗。

    #### 傳回值

    無。
  </Accordion>

  <Accordion title="尋找頁面" id="find-page">
    在文件或頁面中尋找你輸入的標題，包括巢狀內容。比對時會比較完整標題、不分大小寫，並先檢查頁面，再檢查其他區塊。每一輪搜尋都會傳回由上往下的第一個符合項目。

    #### 參數

    | 參數 | 類型 | 必填 | 預設值 | 說明 |
    | - | - | - | - | - |
    | **空間** | Craft 空間 | 是 | 無 | 文件所在的空間。 |
    | **文件** | Craft 文件或頁面 | 是 | 無 | 要搜尋的文件或頁面。可以傳入前一個動作的結果。 |
    | **大標題** | 文字 | 是 | 無 | 要比對的完整標題，不分大小寫。部分標題不會符合。 |
    | **開啟 App** | 布林值 | 否 | 關閉 | 完成後開啟符合的頁面或區塊。 |

    如果沒有符合的頁面，「尋找頁面」會在其他區塊中搜尋符合的文字。它只搜尋所選的文件或頁面及其巢狀內容，不會搜尋整個空間。如果沒有任何符合項目，動作會失敗並顯示「無法找到子頁面」。

    #### 傳回值

    **Craft 文件或頁面**：符合的區塊。可以傳給「加入文件」或「開啟文件」。
  </Accordion>

  <Accordion title="在文件中加入子頁面" id="add-subpage-to-document">
    在文件或頁面中建立新頁面。

    #### 參數

    | 參數 | 類型 | 必填 | 預設值 | 說明 |
    | - | - | - | - | - |
    | **空間** | Craft 空間 | 否 | 所選文件的空間 | 目的地為每日筆記時請選擇。 |
    | **文件** | Craft 文件或頁面 | 是 | 無 | 要加入新頁面的文件或頁面。可以傳入前一個動作的結果。 |
    | **大標題** | 文字 | 是 | 無 | 新頁面的標題。 |
    | **內容** | 文字 | 否 | 空白 | 新頁面的內容。Markdown 會轉換為已套用格式的 Craft 區塊。 |
    | **圖片** | 圖片檔案列表 | 否 | 空白 | 加在內容之後的圖片。 |
    | **位置** | 附加或前置 | 否 | 附加 | 將頁面加到目的地的結尾或開頭。 |
    | **開啟 App** | 布林值 | 否 | 關閉 | 完成後開啟新的子頁面。 |

    以每日筆記為目的地時，捷徑執行時一律指向正確的日期；如果該每日筆記尚未存在，Craft 會建立它。

    #### 傳回值

    **Craft 文件**：指向新子頁面的文件值，而不是它的上層文件。可以傳給接受文件或頁面的動作。
  </Accordion>

  <Accordion title="取得第一級區塊" id="get-first-level-blocks">
    傳回文件或頁面中頂層區塊的文字。不包含巢狀區塊。

    #### 參數

    | 參數 | 類型 | 必填 | 預設值 | 說明 |
    | - | - | - | - | - |
    | **空間** | Craft 空間 | 是 | 無 | 文件所在的空間。 |
    | **文件** | Craft 文件或頁面 | 是 | 無 | 要讀取的文件或頁面。可以傳入前一個動作的結果。 |
    | **數位** | 整數 | 否 | 所有頂層區塊 | 從頂端起算要讀取的區塊數量。設為 0 會傳回空白文字。 |

    只會傳回文字區塊。程式碼、表格、連結、圖片和檔案會被略過，但仍計入「數位」的數量。不包含文件標題。

    #### 傳回值

    **文字**：每個區塊的文字，一行一個。
  </Accordion>
</AccordionGroup>

## 資料夾

<AccordionGroup>
  <Accordion title="建立資料夾" id="create-folder">
    在空間中建立資料夾，也可以建立在另一個資料夾內。

    #### 參數

    | 參數 | 類型 | 必填 | 預設值 | 說明 |
    | - | - | - | - | - |
    | **空間** | Craft 空間 | 是 | 無 | 建立資料夾的空間。 |
    | **名稱** | 文字 | 是 | 無 | 資料夾名稱。不可留空。 |
    | **上層資料夾** | Craft 資料夾 | 否 | 無（頂層） | 要在其中建立新資料夾的資料夾。 |
    | **開啟 App** | 布林值 | 否 | 關閉 | 完成後開啟新資料夾。 |

    #### 傳回值

    **Craft 資料夾**：新資料夾。
  </Accordion>

  <Accordion title="開啟資料夾" id="open-folder">
    在 Craft 中開啟資料夾。

    #### 參數

    | 參數 | 類型 | 必填 | 預設值 | 說明 |
    | - | - | - | - | - |
    | **空間** | Craft 空間 | 是 | 無 | 資料夾所在的空間。 |
    | **資料夾** | Craft 資料夾 | 是 | 無 | 要開啟的資料夾。 |

    #### 傳回值

    無。
  </Accordion>

  <Accordion title="重新命名資料夾" id="rename-folder">
    變更資料夾名稱。

    #### 參數

    | 參數 | 類型 | 必填 | 預設值 | 說明 |
    | - | - | - | - | - |
    | **空間** | Craft 空間 | 是 | 無 | 資料夾所在的空間。 |
    | **資料夾** | Craft 資料夾 | 是 | 無 | 要重新命名的資料夾。 |
    | **名稱** | 文字 | 是 | 無 | 新名稱。不可留空。 |
    | **開啟 App** | 布林值 | 否 | 關閉 | 完成後開啟已重新命名的資料夾。 |

    #### 傳回值

    **Craft 資料夾**：已重新命名的資料夾。
  </Accordion>

  <Accordion title="移動資料夾" id="move-folder">
    將資料夾移到同一空間中的另一個資料夾內，或移到頂層。

    #### 參數

    | 參數 | 類型 | 必填 | 預設值 | 說明 |
    | - | - | - | - | - |
    | **空間** | Craft 空間 | 是 | 無 | 資料夾所在的空間。 |
    | **資料夾** | Craft 資料夾 | 是 | 無 | 要移動的資料夾。 |
    | **上層資料夾** | Craft 資料夾 | 否 | 無（頂層） | 要移入的資料夾。留空會移到頂層。 |
    | **開啟 App** | 布林值 | 否 | 關閉 | 完成後開啟已移動的資料夾。 |

    #### 傳回值

    **Craft 資料夾**：已移動的資料夾。
  </Accordion>

  <Accordion title="刪除資料夾" id="delete-folder">
    刪除資料夾及其子資料夾。裡面的文件不會被刪除：它們會移到上層資料夾；如果該資料夾位於頂層，則移到未分類。

    #### 參數

    | 參數 | 類型 | 必填 | 預設值 | 說明 |
    | - | - | - | - | - |
    | **空間** | Craft 空間 | 是 | 無 | 資料夾所在的空間。 |
    | **資料夾** | Craft 資料夾 | 是 | 無 | 要刪除的資料夾。 |
    | **開啟 App** | 布林值 | 否 | 關閉 | 完成後開啟 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 會使用 Inbox；iPhone 和 iPad 會使用上次 Quick Entry 的任務位置，若沒有儲存的位置則使用 Inbox。 |
    | **排程日期 (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。 |
    | **開啟 App** | 布林值 | 否 | 關閉 | 完成後開啟新任務。 |

    日程和截止日期只有日期。提醒會傳送通知，因此也需要時間。

    #### 傳回值

    **Craft 任務**：新任務。可以傳給「設定任務狀態」。
  </Accordion>

  <Accordion title="設定任務狀態" id="set-task-status">
    將任務標記為待完成、已完成或已取消。

    #### 參數

    | 參數 | 類型 | 必填 | 預設值 | 說明 |
    | - | - | - | - | - |
    | **空間** | Craft 空間 | 是 | 無 | 任務所在的空間。 |
    | **文件** | Craft 文件 | 是 | 無 | 任務本身所在的文件；Inbox 中的任務則選擇收件匣。選擇其他文件會導致動作失敗。 |
    | **任務** | Craft 任務 | 是 | 無 | 要更新的任務。挑選任務，或插入前一個動作的結果。 |
    | **狀態** | 選項 | 否 | 已完成 | 待完成、已完成或已取消。 |
    | **開啟 App** | 布林值 | 否 | 關閉 | 完成後開啟已更新的任務。 |

    #### 傳回值

    **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)** | 文字 | 「到期日」為「個人」時 | 無 | 提醒的日期和時間。 |
    | **文字** | 文字 | 是 | 無 | 提醒文字。 |
    | **開啟 App** | 布林值 | 否 | 關閉 | 完成後開啟 Craft。 |

    「儲存以供稍後使用」會建立沒有到期日的提醒。

    #### 傳回值

    無。
  </Accordion>
</AccordionGroup>

## Siri 動作

這些動作遵循 Apple 自身的備忘錄、提醒事項和 App 內搜尋格式，因此 Siri 和 Apple Intelligence 可以使用它們。你也可以像其他動作一樣把它們加入捷徑。它們需要 iOS、iPadOS 或 macOS 27 以上版本。

在這些動作中，**筆記**是 Craft 文件，**提醒**是 Craft 任務。文字會以純文字加入：Markdown 不會被轉換。範本（Templates）資料夾及其子資料夾中的文件，不會出現在 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 的格式也會顯示已標記、圖片、標籤、URL、重複和位置觸發條件。Craft 會忽略這些欄位。如需圖片、截止日期或通知，請改用[創建任務](#create-task)。

    #### 傳回值

    **Craft 提醒**：新任務。可以傳給「開啟提醒」、「更新提醒」或「刪除提醒」。
  </Accordion>

  <Accordion title="開啟提醒" id="open-reminder">
    開啟 Craft 任務。Inbox 中的任務會在 Inbox 中開啟；其他任務則在其所在文件中開啟。

    #### 參數

    | 參數 | 類型 | 必填 | 預設值 | 說明 |
    | - | - | - | - | - |
    | **提醒** | Craft 提醒 | 是 | 無 | 要開啟的任務。 |

    #### 傳回值

    無。
  </Accordion>

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

    #### 參數

    | 參數 | 類型 | 必填 | 預設值 | 說明 |
    | - | - | - | - | - |
    | **提醒** | Craft 提醒 | 是 | 無 | 要更新的任務。 |
    | **大標題** | 文字 | 否 | 不變 | 新的任務文字。 |
    | **內容** | 文字 | 否 | 不變 | 加在任務內的文字。現有內容會保留。 |
    | **排程日期** | 日期 | 否 | 不變 | 新的排程日期。不會設定通知。 |
    | **已完成** | 布林值 | 否 | 不變 | 開啟時完成任務。關閉時標記為未完成。 |
    | **空間** | Craft 提醒列表 | 否 | 空白（任務留在原本的空間） | 若有設定，必須是任務目前所在的空間。選擇其他空間時會失敗並顯示「不支援在空間之間移動任務」。 |

    將大標題、內容或排程日期留空會保留目前的值，不會將其清除。Apple 的格式也會顯示標籤、URL、重複、已標記和位置觸發條件。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.