從命令列執行捷徑
你可使用 Mac 上的「終端機」App 來從命令列執行捷徑。 從命令列執行捷徑與從「捷徑」App 執行捷徑一樣,你可以傳遞文件、影像、文字等。 然後捷徑可將輸出傳遞至其他程序,或寫入檔案。
即使你幾乎可以從指令列執行任何捷徑,最有效率的捷徑是那些不會顯示提示或要求輸入的捷徑。 當捷徑要求輸入時,命令列程序會暫停來等待用户輸入。 不使用「選擇」動作,而是將你的捷徑設定為接收特定內容作為輸入,如果未接收到輸入,請要求內容。 請參閱:從 Mac 上的其他 App 執行時限制捷徑的輸入。 允許將影像傳遞到捷徑並詢問其是否不存在,能讓單個捷徑在任何地方執行,只在必要時提示用户。
從命令列執行捷徑
捷徑透過 shortcuts
指令執行。 如要執行名為「結合影像」的捷徑,你需要使用以下其中一種命令列來考慮空間:
shortcuts run "Combine Images"
或 shortcuts run Combine\ Images
你可以使用 -i
或 --input-path
旗標來將影像傳遞到捷徑。 你可以使用空格分隔的絕對或相對路徑,或使用萬用字元傳遞影像路徑。 如要執行「結合影像」捷徑並傳遞桌面上的所有 JPEG 檔案,你可以使用以下命令列:
shortcuts run "Combine Images" -i ~/Desktop/*.jpg
附註:當你使用垂直線(|
)傳遞檔案路徑時,系統會將路徑當作文字處理。 使用 -i
旗標來確認已將你的輸入視為檔案路徑。
如你的捷徑以產生文字、影像或一些其他檔案的動作作結,或如你使用「停止並輸出」動作,你可以加入 -o
或 --output-path
旗標來以智慧方式將輸出寫入檔案。 例如,你可以透過提供包含正確副檔名的路徑來輸出文字為 PDF 或 TXT 檔案。 如要執行「結合影像」捷徑來將桌面上的所有影像結合成 PNG 檔案,你可以使用以下命令列:
shortcuts run "Combine Images" -i ~/Desktop/*.jpg -o ~/Desktop/combined.png
如捷徑有一個以輸出作結的動作或有「停止」和「輸出」動作,你可以使用 |
字元將捷徑輸出傳輸到其他指令。 你可以透過「統一類型標識」使用 --output-type
旗標來決定輸出的類型(例如強行輸出為 JPEG 而非文字)。 如要執行「結合影像」捷徑來將桌面上的所有影像結合並傳遞至其他指令作為 RTFD,你可以使用以下命令列:
shortcuts run "Combine Images" -i ~/Desktop/*.jpg --output-type com.apple.rtfd | …
如需「統一類型標識」列表,請參閱:系統聲明的統一類型標識。
shortcuts
指令會在成功執行後以 0
退出,或在錯誤時以 1
退出。
在命令列上列出捷徑
你可能想在執行其他自動化操作前檢查捷徑是否存在,或在 GUI 無法使用時查看捷徑列表。 你可以使用 shortcuts
來列出所有可用的捷徑。 你也可以在自訂資料夾中列出捷徑。 使用 -f
旗標並提供自訂資料夾名稱。 例如,如要在名稱為「音樂」的自訂資料夾中列出所有捷徑,請使用下列命名列:
shortcuts list -f 音樂
附註:你只可以配搭自訂資料夾使用 -f
旗標,你不能使用產生的資料夾,如「快速動作」、「選單列」等。
如要列出所有資料夾(而非捷徑),你可以使用以下命令列:
shortcuts list --folders
從命令列檢視捷徑
你可以使用 shortcuts view
在編輯器中開啟捷徑。 如需對錯誤的捷徑進行疑難排解,此功能十分有用。 如要檢視名為「不正確捷徑」的捷徑,請使用下列命令列:
shortcuts view "不正確捷徑"
從命令列簽署捷徑
你可以使用 shortcuts sign
簽署你之前已輸出的捷徑。 當你簽署捷徑時,Apple 會收到副本以進行驗證(以防止在你分享捷徑時出現未經授權的篡改)。 捷徑簽署有兩個模式:
任何人: 任何人都可以輸入你的捷徑。
認識我的人: 只有在其通訊錄中有你的人才能輸入你的捷徑。 你的聯絡人資料會包含在捷徑檔案中。
如要簽署名為「Share me」的捷徑,請使用下列命令列:
shortcuts sign --mode people-who-know-me --input "Share me.shortcut" --output "Share me signed.shortcut"
如需分享捷徑的資料,請參閱:在 Mac 上分享捷徑。
即使你可以使用 x-callback-urls 來從命令列執行和檢視捷徑,你應該使用 shortcuts
指令來提供智慧型輸入和輸出。 請參閱Mac 上「捷徑」中的 URL 架構簡介。