Craft 捷徑動作參考

Apple 捷徑中 Craft 動作的參數、預設值、行為與傳回值。

這是 iPhone、iPad 和 Mac 上 Apple「捷徑」App 中 Craft 動作的參考資料。動作依照你在「捷徑」中看到的類別分組。展開動作即可查看其參數與傳回內容。

使用「文件」和「資料夾」類別的動作時，請先選擇空間，再開啟文件或資料夾選擇器。選取空間之前，選擇器會是空的。部分動作可以從前一個動作傳入的文件推斷空間，但以每日筆記為目的地時，仍須明確選擇空間。文件或資料夾必須屬於該空間。若要使用前一個步驟的結果，請透過變數選擇器插入。

當動作要求文件、資料夾或任務時，請從清單中挑選，或傳入前一個 Craft 動作的結果。輸入標題或貼上連結都無效。Siri 動作則使用 Apple 的名稱：筆記是 Craft 文件，提醒是 Craft 任務。

​

文件

建立文件

在空間中建立新文件，也可以放進某個資料夾。每次執行都會建立一份新文件，即使已有同標題的文件也一樣。

​

參數

參數	類型	必填	預設值	說明
空間	Craft 空間	是	無	建立文件的空間。
資料夾	Craft 資料夾	否	未分類	所選空間中的目的地資料夾。可以傳入「建立資料夾」產生的資料夾。
大標題	文字	否	空白	文件標題。
內容	文字	否	空白	內文。Markdown 會轉換為已套用格式的 Craft 區塊。
圖片	圖片檔案列表	否	空白	加在內容之後的圖片。不會設定文件封面。
開啟 App	布林值	否	關閉	建立後開啟新文件。

​

傳回值

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

用於匯入文字檔並產生標題。

加入文件

將內容加到文件或頁面的開頭或結尾。現有內容和標題保持不變。每次執行都會再加入一次內容，即使內容已經存在。

​

參數

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

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

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

​

傳回值

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

用於語音收件匣。

重新命名文件

變更文件標題。內容和所在資料夾保持不變。重新命名的是整份文件，而不是其中的頁面或標題。

​

參數

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

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

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

​

傳回值

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

用於匯入文字檔並產生標題。

開啟文件

在 Craft 中開啟文件或頁面。

​

參數

參數	類型	必填	預設值	說明
空間	Craft 空間	否	所選文件的空間	文件所在的空間。
文件	Craft 文件或頁面	是	無	要開啟的文件或頁面。

​

傳回值

無。

開啟每日筆記

開啟今天、明天、昨天或指定日期的每日筆記。

​

參數

參數	類型	必填	預設值	說明
空間	Craft 空間	是	無	每日筆記所在的空間。
日期	選項	否	今天	今天、明天、昨天或客製化日期。
日期 (yyyy-MM-dd)	文字	「日期」為「客製化日期」時	無	要開啟的日期，例如 2026-10-13。

​

傳回值

無。

移動文件

將文件移到同一空間中的另一個資料夾。標題和內容保持不變。

​

參數

參數	類型	必填	預設值	說明
空間	Craft 空間	是	無	文件所在的空間。
文件	Craft 文件	是	無	要移動的文件。
資料夾	Craft 資料夾	否	未分類	目的地資料夾。留空會將文件移到未分類。
開啟 App	布林值	否	關閉	完成後開啟已移動的文件。

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

​

傳回值

Craft 文件：已移動的文件。

刪除文件

將文件移到垃圾桶；如果開啟「永久刪除」，則會永久刪除。

​

參數

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

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

​

傳回值

無。

尋找頁面

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

​

參數

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

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

​

傳回值

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

在文件中加入子頁面

在文件或頁面中建立新頁面。

​

參數

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

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

​

傳回值

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

取得第一級區塊

傳回文件或頁面中頂層區塊的文字。不包含巢狀區塊。

​

參數

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

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

​

傳回值

文字：每個區塊的文字，一行一個。

​

資料夾

建立資料夾

在空間中建立資料夾，也可以建立在另一個資料夾內。

​

參數

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

​

傳回值

Craft 資料夾：新資料夾。

開啟資料夾

在 Craft 中開啟資料夾。

​

參數

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

​

傳回值

無。

重新命名資料夾

變更資料夾名稱。

​

參數

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

​

傳回值

Craft 資料夾：已重新命名的資料夾。

移動資料夾

將資料夾移到同一空間中的另一個資料夾內，或移到頂層。

​

參數

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

​

傳回值

Craft 資料夾：已移動的資料夾。

刪除資料夾

刪除資料夾及其子資料夾。裡面的文件不會被刪除：它們會移到上層資料夾；如果該資料夾位於頂層，則移到未分類。

​

參數

參數	類型	必填	預設值	說明
空間	Craft 空間	是	無	資料夾所在的空間。
資料夾	Craft 資料夾	是	無	要刪除的資料夾。
開啟 App	布林值	否	關閉	完成後開啟 Craft。

內建資料夾無法刪除。

​

傳回值

無。

​

導覽

開啟 Craft

開啟 Craft，也可以指定空間和檢視。

​

參數

參數	類型	必填	預設值	說明
空間	Craft 空間	否	上次使用的空間	要開啟的空間。
位置	選項	否	無	所有文件、標籤、收藏、任務或日曆。

如果兩者都留空，Craft 會在你上次離開的地方開啟。

​

傳回值

無。

開啟並搜尋

在空間中開啟搜尋，也可以預先填入搜尋字詞。

​

參數

參數	類型	必填	預設值	說明
空間	Craft 空間	是	無	要搜尋的空間。
查詢	文字	否	空白	搜尋字詞。留空會開啟搜尋但不帶字詞。

​

傳回值

無。

開啟 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。捷徑不會取回你建立的項目。

​

傳回值

無。

​

標籤

開啟標籤

顯示空間中帶有某個標籤的文件。

​

參數

參數	類型	必填	預設值	說明
空間	Craft 空間	是	無	標籤所在的空間。
標籤	Craft 標籤	是	無	要開啟的標籤。請從清單中挑選。

​

傳回值

無。

​

任務

創建任務

在文件或子頁面的頂端，或在空間的任務 Inbox 中建立任務。內容和圖片會加在任務內。

​

參數

參數	類型	必填	預設值	說明
空間	Craft 空間	是	無	任務所在的空間。
文件	Craft 文件或頁面	是	無	任務所在的文件或子頁面，或收件匣。傳入「尋找頁面」或「在文件中加入子頁面」產生的子頁面，即可在該處建立任務。每日筆記選項在捷徑執行時一律指向正確的日期。
大標題	文字	是	無	任務文字。
內容	文字	否	空白	任務內的內容。Markdown 會轉換為已套用格式的 Craft 區塊。
圖片	圖片檔案列表	否	空白	加在內容之後的圖片。
日程	選項	否	無	無、今天、明天或個人。
自訂排程日期 (yyyy-MM-dd)	文字	「日程」為「個人」時	無	排程日期。
截止日期	選項	否	無	無、今天、明天或個人。
自訂截止日期 (yyyy-MM-dd)	文字	「截止日期」為「個人」時	無	截止日期。
提醒	選項	否	無	無、今天、明天或個人。
自訂提醒 (yyyy-MM-dd HH:mm)	文字	「提醒」為「個人」時	無	提醒的日期和時間。
提醒時間	文字	「提醒」為「今天」或「明天」時	無	24 小時制的時間，例如 09:30。
開啟 App	布林值	否	關閉	完成後開啟新任務。

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

​

傳回值

Craft 任務：新任務。可以傳給「設定任務狀態」。

設定任務狀態

將任務標記為待完成、已完成或已取消。

​

參數

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

​

傳回值

Craft 任務：已更新的任務。

打開任務列表

在 Craft 中開啟你的其中一個任務清單。

​

參數

參數	類型	必填	預設值	說明
空間	Craft 空間	否	上次使用的空間	要顯示其任務的空間。
任務類型	選項	否	全部	收件匣、今天、即將到來或全部。

​

傳回值

無。

​

提醒事項

建立提醒

建立不附屬於任何文件的 Craft 提醒。這與 Siri 動作中的「建立提醒」不同，後者會建立任務。

​

參數

參數	類型	必填	預設值	說明
使用者	Craft 使用者	是	無	收到提醒的帳號。
到期日	選項	是	無	20分鐘後、1小時內、3小時內、明天、下週、個人或儲存以供稍後使用。
自訂日期 (yyyy-MM-dd HH:mm)	文字	「到期日」為「個人」時	無	提醒的日期和時間。
文字	文字	是	無	提醒文字。
開啟 App	布林值	否	關閉	完成後開啟 Craft。

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

​

傳回值

無。

​

Siri 動作

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

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

​

傳回值

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

開啟提醒

開啟 Craft 任務。Inbox 中的任務會在 Inbox 中開啟；其他任務則在其所在文件中開啟。

​

參數

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

​

傳回值

無。

更新提醒

更新 Craft 任務。留空的項目保持不變。

​

參數

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

將大標題、內容或排程日期留空會保留目前的值，不會將其清除。Apple 的格式也會顯示標籤、URL、重複、已標記和位置觸發條件。Craft 會忽略這些欄位。

​

傳回值

Craft 提醒：已更新的任務。

刪除提醒

刪除一或多個 Craft 任務。

​

參數

參數	類型	必填	預設值	說明
提醒事項	多個 Craft 提醒	是	無	要刪除的任務。它們可以位於不同的空間。

​

傳回值

無。

搜尋文件

以你的搜尋字詞開啟 Craft 搜尋。

​

參數

參數	類型	必填	預設值	說明
搜尋	文字	是	無	搜尋字詞。

會搜尋你在 Craft 中開啟的空間，或上次使用的空間。結果會在 Craft 中開啟；捷徑不會取回文件清單。若要選擇空間，請使用開啟並搜尋。

​

傳回值

無。