Automatyzacja Skrótów na Macu: praktyczny przewodnik (2026)

TL;DR: Shortcuts jest dostępne na każdym Macu od macOS Monterey (2021), a macOS Tahoe (26) wreszcie dodał element, na który osoby automatyzujące pracę na Macu czekały przez 4 lata: automatyzacje osobiste z wyzwalaczami takimi jak zmiany w folderach, podłączanie dysków zewnętrznych, sieci Wi-Fi, monitory i uruchamianie aplikacji.³⁴ Aplikacja uruchamia skróty z paska menu, Spotlight, szybkich czynności Finder, skrótów klawiaturowych oraz za pomocą pełnoprawnego narzędzia wiersza poleceń (shortcuts run, list, view, sign).¹² Każda aplikacja może dodawać czynności za pośrednictwem frameworka App Intents, czyli tego samego interfejsu, z którego korzystają Siri, Spotlight i Apple Intelligence.¹³ Skrypty i agenci AI sterują skrótami na 3 sposoby: przez CLI, URL scheme shortcuts:// oraz obsługiwany skryptowo proces działający w tle Shortcuts Events.¹⁹¹¹ Najpierw warto poznać model uprawnień: monity o zgodę, które są niewidoczne w aplikacji, mogą bez żadnego komunikatu zatrzymać wykonanie nienadzorowanego skrótu.

Podczas WWDC 2021 Apple przekazało deweloperom: „Shortcuts to przyszłość automatyzacji na Macu”.⁵ Ta przyszłość nadeszła w 2 etapach. Pierwszy pojawił się od razu: natywna aplikacja SwiftUI w macOS Monterey z synchronizacją przez iCloud, narzędziem do migracji z Automator oraz pełną obsługą skryptów powłoki i AppleScript w edytorze.⁵ Na drugi trzeba było czekać jeszcze przez 4 wydania macOS. Do czasu macOS Tahoe skrót na Macu uruchamiał się wyłącznie na żądanie; nie było wyzwalaczy, więc „automatyzacja” oznaczała konieczność pamiętania o kliknięciu. Tahoe uzupełnił ten brak o automatyzacje osobiste stworzone z myślą o Macu (wyzwalacze zmian w folderach i podłączania dysków zewnętrznych), a także znany z iOS zestaw wyzwalaczy (pora dnia, Bluetooth). Dodano również czynność Use Model, która umieszcza Apple Intelligence w przepływie danych skrótu.³⁴

W rezultacie powstał system, który warto dobrze poznać. W 2026 roku Shortcuts na Macu pełni jednocześnie 4 funkcje:

1. Edytor niewymagający programowania z setkami wbudowanych czynności — od operacji na plikach, przez zarządzanie oknami, po AI działającą na urządzeniu
2. Mechanizm automatyzacji z wyzwalaczami zdarzeń systemowych, wprowadzonymi w macOS Tahoe
3. Pełnoprawne narzędzie wiersza poleceń: shortcuts run działa jak każde inne narzędzie uniksowe, obsługując stdin, stdout, kody wyjścia oraz potoki¹
4. Rejestr czynności dla każdej aplikacji: wszystko, co aplikacja udostępnia za pośrednictwem App Intents, automatycznie pojawia się w Shortcuts — zarówno na Macu, jak i na pozostałych platformach¹³⁴

Różnica między okazjonalnym a zaawansowanym korzystaniem sprowadza się do 5 systemów: katalogu czynności (co jest dostępne), wyzwalaczy automatyzacji (kiedy coś się uruchamia), CLI i mechanizmów integracji ze skryptami (jak kod wywołuje skróty), podpisywania i udostępniania (jak skróty są przekazywane) oraz modelu uprawnień (dlaczego nienadzorowane wykonania się zatrzymują). Każdemu z nich poświęcono osobną część poniżej.

Każde stwierdzenie w tym przewodniku opiera się na dokumentacji Apple, sesjach WWDC lub bezpośredniej analizie macOS 26.5 (Shortcuts 7.0) na komputerze, na którym powstał tekst. Jeśli dana informacja pochodzi bezpośrednio z systemu operacyjnego (strony podręcznika shortcuts(1), słownika skryptowego Shortcuts Events lub czynności we frameworku WorkflowKit), zaznaczono to w przypisie.

Najważniejsze informacje

• Automatyzacje są najważniejszą nowością. macOS Tahoe wprowadził na Maca automatyzacje osobiste: zmiany w folderach, dyski zewnętrzne, wyświetlacze, Wi‑Fi, Bluetooth, Stage Manager, uruchamianie i zamykanie aplikacji, porę dnia i wiele więcej — każdą można uruchamiać od razu lub po potwierdzeniu.³⁴
• CLI jest prawdziwym narzędziem, a nie zabawką. shortcuts run "Name" -i input -o output obsługuje stdin (-i -), stdout (-o -), dane wyjściowe o określonym typie przez Uniform Type Identifiers oraz zwraca kod 0 po powodzeniu i 1 w razie błędu. Można go łączyć potokami jak dowolne narzędzie Unix.¹²
• Trzy punkty wejścia dla skryptów, jedna zasada. Z CLI należy korzystać w powłokach i CI, ze schematu URL shortcuts:// wyłącznie z innych aplikacji, a z Shortcuts Events (AppleScript/ScriptingBridge), gdy wyniki muszą wrócić do kontekstu skryptowego bez otwierania aplikacji.¹⁹¹¹
• Podpisywanie warunkuje dystrybucję. Plik .shortcut musi być podpisany, aby można było go udostępniać: shortcuts sign -m anyone poświadcza go przez iCloud, aby każdy mógł go zaimportować; domyślny tryb people-who-know-me podpisuje plik lokalnie i ogranicza import do osób, które mają Pana/Panią w Kontaktach.²⁷
• App Intents to powierzchnia dla deweloperów. Aplikacja udostępniająca App Intents automatycznie otrzymuje akcje Shortcuts na Macu, a te same intencje obsługują Spotlight i automatyzacje, w tym aplikacje iOS zainstalowane na Macach z Apple silicon.⁴¹³
• Tryb awarii to zgoda. Shortcuts pyta o „Allow Once” / „Always Allow” / „Don’t Allow” dla każdego skrótu i każdego typu danych. Akcje uruchamiające skrypty są chronione globalnym przełącznikiem „Allow Running Scripts”. Bezgłowe uruchomienie, które napotka pytanie bez odpowiedzi, po prostu czeka.¹⁶⁸

Jak korzystać z tego przewodnika

Spis treści

Część 1: Podstawy

1. Czym jest Shortcuts na Macu
2. Sposoby uruchamiania skrótu
3. Shortcuts a Automator i AppleScript

Część 2: Akcje

1. Jak łączą się akcje
2. Katalog akcji
3. Akcje skryptowe
4. Akcje zarządzania oknami
5. Akcja Use Model

Część 3: Automatyzacje

1. Wyzwalacze automatyzacji w macOS
2. Wzorce automatyzacji, które działają

Część 4: Wiersz polecenia i schematy URL

1. CLI shortcuts
2. Sterowanie aplikacją za pomocą Shortcuts Events
3. Schematy URL

Część 5: Udostępnianie i dystrybucja

1. Formaty udostępniania i podpisywanie

Część 6: Powierzchnia dla deweloperów

1. App Intents: jak aplikacje dodają akcje
2. Spotlight i automatyzacje uruchamiają intencje
3. Sterowanie Shortcuts ze skryptów i agentów

Część 7: Operacje i materiały referencyjne

1. Uprawnienia i zgoda (TCC)
2. Rozwiązywanie problemów
3. Szybka karta referencyjna
4. FAQ
5. Dziennik zmian
6. Źródła

Czym jest Shortcuts na Macu

Shortcuts to aplikacja Apple do automatyzacji: łączy się akcje (pojedyncze kroki o konkretnym celu) w skrót (zapisany przepływ pracy), a następnie uruchamia go kliknięciem, głosem, skrótem klawiszowym, wyzwalaczem lub z wiersza polecenia. Warto pamiętać o definicji Apple, ponieważ wyjaśnia ona cały projekt: „Akcja jest podstawowym elementem skrótu. Każdy skrót składa się z serii akcji, a każda akcja to pojedynczy krok wykonujący określoną funkcję”.¹²

Aplikacja pojawiła się na Macu wraz z macOS Monterey w 2021 roku, przeniesiona z iOS, lecz napisana niemal w całości w SwiftUI, dzięki czemu ta sama baza kodu obsługuje obie platformy.⁵ Trzy decyzje projektowe z pierwszego wydania nadal definiują korzystanie z niej na Macu w 2026 roku:

• Synchronizacja iCloud jest domyślna. Po otwarciu Shortcuts na nowym Macu pojawia się istniejąca biblioteka zsynchronizowana z iPhone’a i iPada. Skrót utworzony na jednym urządzeniu działa na pozostałych, z pominięciem akcji specyficznych dla danej platformy.⁵¹²
• Aplikacje udostępniają akcje. „Podobnie jak w iOS, każda aplikacja na Macu może udostępniać akcje dla Shortcuts”.⁵ W 2026 roku za ten mechanizm odpowiada framework App Intents, omówiony w części 6.
• Skrypty są pełnoprawnym elementem. Monterey zapewnił „pełną obsługę AppleScripts i Shell Scripting” wraz z „nowymi akcjami wbudowanymi bezpośrednio w Shortcuts, które pozwalają pisać i uruchamiać skrypty bezpośrednio w edytorze Shortcuts”, dlatego Shortcuts otacza starszy stos automatyzacji, zamiast go zastępować.⁵

W Monterey nie było wyzwalaczy. Od 2021 do 2024 roku skrót na Macu uruchamiał się tylko wtedy, gdy coś go wywołało. macOS Tahoe (26) zmienił to w 2025 roku, wprowadzając na Maca automatyzacje osobiste z typami wyzwalaczy stworzonymi specjalnie dla przepływów pracy na komputerze stacjonarnym (zmieniona zawartość folderu, podłączony dysk zewnętrzny), a także z dotychczasowym zestawem z iOS.³⁴ Tahoe dodał również akcję Use Model, która przekazuje dane przez modele Apple Intelligence w trakcie działania skrótu.³⁴

Najważniejsze wersje:

W całym przewodniku określenie „zweryfikowano na macOS 26.5” oznacza bezpośrednie sprawdzenie w Shortcuts 7.0 na Macu użytym do jego napisania.

Sposoby uruchamiania skrótu

Shortcuts na Macu oferuje wyjątkowo wiele punktów wejścia. Wszystkie poniższe metody wywołują ten sam skrót; różnią się źródłem danych wejściowych i miejscem trafiania danych wyjściowych.¹²¹⁰

Dwa szczegóły oszczędzają później czas. Po pierwsze, wpisy Quick Action i Services otrzymują bieżące zaznaczenie jako dane wejściowe skrótu, dlatego skróty przetwarzające pliki powinny deklarować akceptowane typy wejściowe (konfigurację „Receive” w edytorze), zamiast zakładać, że otrzymają tekst. Po drugie, ostatnie trzy wiersze tworzą programowalną powierzchnię; mają własne sekcje, ponieważ ich kontrakty wejścia/wyjścia są różne.

Shortcuts a Automator i AppleScript

Wszystkie trzy systemy automatyzacji Apple są nadal dostarczane z macOS w 2026 roku (Automator wciąż znajduje się w /System/Applications, co zweryfikowano w macOS 26.5), a każdy z nich nadal ma swoje zastosowanie. Trafne ujęcie pozostaje niezmienne: Shortcuts stanowi warstwę integracji, AppleScript jest językiem sterowania aplikacjami, a skrypty powłoki tworzą warstwę obliczeniową. Automator pozostaje w trybie utrzymania: działa, nie jest rozwijany i został oficjalnie zastąpiony przez Shortcuts.⁵¹⁴

Ścieżka migracji rzeczywiście istnieje, ale w szczególnych przypadkach wiąże się ze stratami. Apple wbudowało konwerter w Shortcuts: wystarczy przeciągnąć plik .workflow do aplikacji (lub kliknąć z naciśniętym klawiszem Control → Open With → Shortcuts), a „Shortcuts może przekonwertować większość przepływów pracy Automator na skróty wykonujące te same funkcje, zdarzenia i automatyzacje”.¹⁴¹⁵ „Większość” to określenie użyte przez Apple, a w praktyce należy je rozumieć następująco: standardowe akcje dotyczące plików, obrazów i tekstu konwertują się prawidłowo; problemy pojawiają się przy mało popularnych akcjach Automator innych firm oraz nagraniach Watch Me Do. W ramach tej zgodności Shortcuts zachowuje nawet wewnętrzną nazwę akcji Watch Me Do (widoczną w tabeli akcji frameworka, co zweryfikowano w macOS 26.5).¹⁶

Kiedy warto wyjść poza Shortcuts. Zaawansowane sterowanie poszczególnymi aplikacjami — iterowanie po wiadomościach Mail, programistyczne manipulowanie oknami Finder czy obsługa aplikacji wyposażonych w rozbudowane słowniki skryptowe — nadal pozostaje domeną AppleScript. Złożone przetwarzanie tekstu, orkiestracja API oraz wszystko, co i tak zostałoby napisane w Python lub zsh, warto umieścić w skrypcie. W praktyce najlepiej łączyć narzędzia, zamiast opowiadać się za jednym z nich: skrót, który pobiera dane wejściowe z wyzwalacza, przekazuje je skryptowi powłoki do wykonania wymagających operacji, a następnie korzysta z natywnych akcji do obsługi powiadomień i zapisywania plików, wykorzystuje zalety każdego systemu. Mechanizmy te opisano w sekcji Akcje skryptowe.

Jak łączą się akcje

Każdy skrót jest potokiem. Poszczególne akcje pobierają dane wejściowe (często wynik poprzedniej akcji), wykonują jedno zadanie i zwracają wynik. Elastyczność potoku zapewniają trzy mechanizmy:

• Zmienne magiczne. Wynik każdej akcji jest automatycznie dostępny dla późniejszych akcji jako zmienna — bez konieczności jej deklarowania. Należy kliknąć pole parametru, wybrać Select Magic Variable, a następnie wskazać wynik dowolnej wcześniejszej akcji. Do jawnego nadawania nazw służą Set Variable i Get Variable, natomiast Add to Variable umożliwia gromadzenie elementów na listach (wszystkie trzy są akcjami wbudowanymi, co zweryfikowano w macOS 26.5).¹⁶
• Typy zawartości konwertowane na żądanie. Akcje deklarują akceptowane typy danych (pliki, obrazy, tekst, adresy URL, daty). Gdy typ wyniku różni się od typu danych wejściowych, Shortcuts dokonuje konwersji, jeśli jest to możliwe: przekazanie strony internetowej do akcji tekstowej zwraca tekst strony. Konfiguracja „Receive” u góry edytora skrótu określa, jakie dane cały skrót przyjmuje z Quick Actions, Services lub parametru --input-path narzędzia CLI.
• Sterowanie przepływem za pomocą akcji. If, Repeat, Repeat with Each, Choose from Menu, Wait to Return, Stop This Shortcut oraz Stop and Output są zwykłymi akcjami.¹⁶ Stop and Output ma na Mac szczególne znaczenie: określa, co skrót zwraca do wiersza poleceń, potoku lub skryptu wywołującego.¹

Podstawowym mechanizmem kompozycji jest Run Shortcut: jeden skrót wywołuje inny według nazwy i przekazuje mu dane wejściowe.¹⁶ Apple wyraźnie zaleca, aby zagnieżdżanie realizować za pomocą tej akcji, a nie URL scheme: „Aby uruchomić jeden skrót z innego skrótu, należy użyć akcji Run Shortcut zamiast URL scheme”.⁹ Skróty warto traktować jak funkcje: niewielkie skróty o jednym przeznaczeniu (normalizacja nazwy pliku, wysyłanie danych do webhooka, zmiana rozmiaru do miniatury), łączone przez skrót koordynujący, skalują się znacznie lepiej niż jeden monolit złożony z 60 akcji. Każdy element można też niezależnie testować za pomocą CLI.

Katalog akcji

Wbudowana biblioteka jest obszerna: tabela angielskich ciągów znaków we frameworku WorkflowKit systemu macOS 26.5 (prywatnym frameworku, na którym opiera się Shortcuts) zawiera 361 odrębnych nazw akcji.¹⁶ Liczba ta zawyża jednak liczbę pozycji widocznych w edytorze: tabela obejmuje akcje przeznaczone wyłącznie dla iOS oraz starsze integracje odziedziczone po czasach aplikacji Workflow. Poniżej przedstawiono katalog akcji istotnych na Mac, uporządkowany według ich praktycznych zastosowań w automatyzacji. Każda z poniższych nazw akcji występuje w tej tabeli w identycznej postaci, co zweryfikowano w macOS 26.5.¹⁶

Pliki i Finder

System i aplikacje

Internet i dane

Get Contents of URL wraz z akcjami Dictionary tworzy funkcjonalnego klienta REST: wysłanie żądania, przetworzenie JSON i wyodrębnienie wartości odbywa się bez kodu. Gdy struktura danych staje się złożona, lepiej przekazać je do skryptu powłoki korzystającego z curl i jq, niż zmagać się z zagnieżdżonymi słownikami w edytorze.

Tekst, obrazy i multimedia

Calendar, Reminders, Contacts i Notes

Find Calendar Events, Add New Calendar, Edit Calendar Event, Find Reminders, New Reminder, Edit Reminder, Find Contacts, Edit Contact, Create New Note, Get Notes, Delete Notes oraz odpowiadające im akcje Get Details of… obsługują aplikacje zwiększające produktywność.¹⁶ Typowy schemat polega na połączeniu Find/Filter z Get Details: najpierw należy przeszukać kolekcję, a następnie wyodrębnić pola z dopasowanych elementów.

Shortcuts, metadane i przepływ sterowania

Uwaga dotycząca metaautomatyzacji w części 6: Get My Shortcuts i Get Details of Shortcut pozwalają skrótowi wyliczyć zawartość biblioteki. W połączeniu z shortcuts list po stronie CLI umożliwia to tworzenie narzędzi obsługujących kolekcję skrótów.¹⁶²

Akcje skryptowe

Pięć akcji łączy Shortcuts z tradycyjnym stosem automatyzacji, a wszystkie są ukryte za jednym globalnym przełącznikiem. W Shortcuts → Settings → Advanced należy włączyć „Allow Running Scripts”, zanim którakolwiek z nich zostanie uruchomiona; opis tego ustawienia w samej aplikacji dokładnie wskazuje, które akcje kontroluje: „When enabled, the actions ‘Run AppleScript’, ‘Run Shell Script’, ‘Run JavaScript for Mac Automation’, ‘Run JavaScript on Web Page’ and ‘Run Script Over SSH’ can be run” (zweryfikowano w macOS 26.5).⁸¹⁷ Dokumentacja Apple zawiera dodatkowo ostrzeżenie, że uruchamianie skrótów ze skryptami może spowodować utratę danych — ustawienie istnieje, ponieważ te pięć akcji działa z pełnymi uprawnieniami użytkownika, poza zabezpieczeniami ograniczającymi zwykłe akcje.⁸

Run Shell Script

Koń roboczy. Wybiera się powłokę, wkleja skrypt i określa sposób przekazywania danych wejściowych. Dwa tryby wejścia wynikają bezpośrednio z dokumentacji tej akcji: „to stdin: The input will be converted to a file and directed to the stdin pipe of the script. as arguments: The input will be converted to a list of strings and passed as arguments to the script.”¹⁷

Praktyczne konsekwencje tych dwóch trybów:

• Tryb stdin nadaje się do tekstu i pojedynczych plików: przetwarzania w stylu pbpaste, JSON przez jq, wszystkiego, co odczytuje strumień.
• Tryb arguments nadaje się do wielu plików: każdy element wejściowy trafia do "$@", więc for f in "$@"; do ... done poprawnie obsługuje zaznaczenie w Finder, łącznie ze spacjami w nazwach.
• Wynikiem jest wszystko, co skrypt zapisze do stdout, i przepływa ono do następnej akcji jak każde inne wyjście.

Run AppleScript i Run JavaScript for Mac Automation

Obie akcje osadzają skrypty Open Scripting Architecture z punktem wejścia on run {input, parameters} (AppleScript) lub funkcją run(input, parameters) (JXA). Warto użyć ich, gdy zadanie polega na sterowaniu inną aplikacją: układzie okien Finder, regułach Mail czy wszystkim, co ma słownik skryptowy. Wartość zwracana staje się wyjściem akcji.

Run Script Over SSH

Uruchamia skrypt powłoki na zdalnym hoście, przy czym host, port, użytkownik i uwierzytelnianie konfiguruje się w akcji. Najważniejszy przypadek użycia jest symetryczny względem CLI: Mac w biurze może udostępniać powtarzalne operacje każdej maszynie, która może połączyć się z nim przez SSH, a skrót może wysyłać zadania do maszyn z Linux bez opuszczania edytora Shortcuts.

Run JavaScript on Web Page

Uruchamia JavaScript względem bieżącej strony Safari i zwraca wynik. Apple umieszcza tę akcję za przełącznikiem skryptów oraz monitem o uprawnienie przy każdym uruchomieniu, ponieważ dowolny JavaScript w kontekście strony stanowi powierzchnię umożliwiającą eksfiltrację danych.⁸

Akcje zarządzania oknami

Shortcuts oferuje na Mac natywne sterowanie oknami: Find Windows, Move Window i Resize Window.¹⁶ Wyglądają jak drobne pozycje w katalogu, lecz okazują się elementami składowymi układów okien sterowanych klawiaturą, bez narzędzi innych firm.

• Find Windows wyszukuje otwarte okna (które można sortować i filtrować w edytorze) oraz zwraca obiekty okien.
• Move Window przyjmuje okno i pozycję. Podsumowanie jego parametrów brzmi „Move ⟨Window⟩ to ⟨Position⟩”, z opcjonalnym wariantem niestandardowym „Move ⟨Window⟩ to ⟨Position⟩ ⟨X Coordinate⟩, ⟨Y Coordinate⟩” (zweryfikowano w macOS 26.5).¹⁶
• Resize Window przyjmuje okno i cel: „Resize ⟨Window⟩ to ⟨Configuration⟩”, z wariantem niestandardowym akceptującym jawne wartości ⟨Width⟩ × ⟨Height⟩.¹⁶

Wbudowane pozycje okien znajdują się w tabeli ciągów frameworka: Full Screen, Left, Right, Top, Bottom, trzecie części (Left Third, Middle Third, Right Third), warianty narożne (Top/Bottom Leading i Trailing) oraz niestandardowy format Window Location and Size (zweryfikowano w macOS 26.5).¹⁶ Połączenie Find Windows (najbardziej wysunięte okno) → Resize Window (Left) ze skrótem klawiaturowym daje polecenie okna uruchamiane jednym klawiszem. Split Screen Apps obsługuje przypadek dwóch aplikacji w jednej akcji.¹⁶

Akcja Use Model

Nowa w macOS Tahoe i najbardziej znacząca pojedyncza akcja, jaką Apple dodało od czasu udostępnienia Shortcuts na Mac: Use Model wysyła dane do modelu Apple Intelligence w trakcie działania skrótu i przekazuje odpowiedź do następnej akcji.³⁴

Zgodnie z sesją WWDC Apple poświęconą tej funkcji dostępne są trzy modele: duży model serwerowy działający w Private Cloud Compute, model działający na urządzeniu „for simple requests without network connection” oraz ChatGPT „for broad world knowledge”.⁴

Dostępne są trzy kształty danych wyjściowych, a kluczową umiejętnością jest świadomy wybór:⁴

1. Text (w tym tekst sformatowany) do podsumowań i przeredagowań.
2. Dictionary do strukturalnej ekstrakcji; przykład Apple polega na wyodrębnianiu dostawcy, kwoty i daty z faktur. Wyjście Dictionary sprawia, że Use Model można komponować: kolejne akcje odczytują pola zamiast analizować prozę.
3. App entities: obiekty zawartości z aplikacji udostępniających je przez App Intents. Apple opisuje tę relację następująco: „If App Intents are the actions or verbs from your app, App Entities are the nouns”,⁴ a Use Model może bezpośrednio rozumować na podstawie tych rzeczowników (filtrować te notatki, wybrać odpowiednie wydarzenie z kalendarza).

Przełącznik Follow Up umożliwia iterowanie odpowiedzi modelu w ramach tego samego uruchomienia.⁴

Jedno zastrzeżenie inżynieryjne: wyniki modelu są niedeterministyczne, więc te same dane wejściowe mogą dawać różne rezultaty przy kolejnych uruchomieniach. W przypadku automatyzacji przemawia to za wyjściem Dictionary (ograniczonym schematem), małymi, precyzyjnymi promptami oraz krokiem walidacji (akcją If sprawdzającą wymagane pola), zanim wynik dotknie plików lub wiadomości. Z Use Model należy korzystać jak z zawodnego wywołania sieciowego: jest użyteczne, lecz powinno być otoczone kontrolami.

Aby poznać perspektywę programisty na tę samą funkcję (czyli co aplikacja powinna udostępniać, aby Use Model mogło o tym rozumować), zobacz część 6 oraz klaster App Intents na tej stronie, zaczynając od App Intents Are Apple’s New API to Your App.

Wyzwalacze automatyzacji w macOS

Automatyzacje to skróty z dołączonym wyzwalaczem: „uruchom to, gdy wydarzy się tamto”, bez konieczności klikania. Pojawiły się na Mac w macOS Tahoe, a Apple stworzyło wyzwalacze specyficzne dla Mac zamiast przenosić całą listę z iOS: „we’re bringing personal automations to the Mac, with new automation types like folder and external drive automations built specifically for Mac, along with automation types you might already be familiar with from iOS, like Time of Day and Bluetooth.”⁴

Tworzy się je w obszarze Automation aplikacji Shortcuts. Każda automatyzacja łączy jeden wyzwalacz z zestawem akcji i jedną decyzją dotyczącą zasad działania: Run Immediately (bez interakcji — to sens automatyzacji) albo Run After Confirmation (najpierw pojawia się powiadomienie z pytaniem).³¹⁸ Nowe automatyzacje warto uruchamiać z potwierdzeniem, dopóki nie wzbudzą zaufania, a następnie przełączyć je na natychmiastowe uruchamianie.

Katalog wyzwalaczy w macOS Tahoe:³⁴¹⁸

Z tego projektu wynikają dwie zmiany. Po pierwsze, Mac wreszcie ma natywne rozwiązanie Apple dla „obserwuj ten folder i przetwarzaj wszystko, co w nim się pojawi”, które synchronizuje się i edytuje jak każdy inny skrót (Folder Actions w Automator wykonywało obserwację, ale nie resztę). Po drugie, ponieważ automatyzacje uruchamiają skróty, wszystko w tym przewodniku się kumuluje: wyzwalacz Folder może zasilać Run Shell Script; wyzwalacz App może wywołać Use Model; wyzwalacz External Drive może rozpocząć zadanie SSH.

Wzorce automatyzacji, które się sprawdzają

Wzorce sprawdzające się w codziennym użytkowaniu, złożone wyłącznie z udokumentowanych elementów:

Folder monitorowany. Wyzwalacz folderu dla ~/Inbox → Filter Files (rozszerzenie to pdf) → Extract Text from Image lub Get Text from PDF → Use Model z wynikiem w formie słownika (sprzedawca, data, suma) → Rename File i Move File do hierarchii archiwum. Klasyczny przypadek użycia Automator, wzbogacony o wyodrębnianie danych na urządzeniu i nazewnictwo ustrukturyzowane przez model.³⁴¹⁶

Stacja robocza. Wyzwalacz ekranu (podłączenie zewnętrznego monitora) → Open App dla zestawu aplikacji roboczych → Move Window i Resize Window zgodnie z układem → Set Focus na tryb Praca. Po odłączeniu należy wykonać działania odwrotne. Jeden wyzwalacz odtwarza cały układ stanowiska bez ręcznego przeciągania okien.³¹⁶

Dysk do importu. Wyzwalacz External Drive → Get Contents of Folder dla folderu DCIM na karcie → Filter Files według daty → Save File w folderze oznaczonym datą → Show Notification z liczbą plików. Warto tu użyć trybu potwierdzania: nieoczekiwane dyski nie powinny uruchamiać masowego kopiowania.³¹⁸

Droga wyjścia do właściwego kodu. Dowolny wyzwalacz → Run Shell Script z danymi wejściowymi przekazanymi jako argumenty → istniejący skrypt. Najcenniejszy jest system wyzwalaczy; nic nie wymaga, aby logika znajdowała się w actions Shortcuts. Automatyzacja złożona z dwóch actions (wyzwalacz + skrypt) zapewnia obsługę zdarzeń w stylu launchd wraz z interfejsem, synchronizacją i zarządzaniem zgodami bez dodatkowego wysiłku.⁸¹⁷

Konteksty związane ze spotkaniami. Wyzwalacz Focus (włączenie trybu Praca)¹⁸ → Set Volume, Quit App dla rozpraszających aplikacji, Open App dla notatek. Gdy w System Settings włączone jest udostępnianie trybu Focus między urządzeniami, Mac reaguje na tryb Focus włączony na iPhone.

Ograniczenia, które należy uwzględnić w projekcie: automatyzacja działa na Mac, na którym została utworzona, dlatego automatyzacja folderu skonfigurowana na MacBooku nie uruchomi się na Mac mini, mimo że sama biblioteka skrótów jest synchronizowana (wyzwalacz należy skonfigurować na każdym komputerze, który go potrzebuje). Na liście wyzwalaczy nie ma też pozycji „odebrano żądanie internetowe” (można to obejść za pomocą Run Script Over SSH po stronie nadawcy albo folderu monitorowanego przez klienta synchronizacji z chmurą).³¹⁸

CLI narzędzia shortcuts

Od wersji Monterey system macOS zawiera pełnoprawny interfejs wiersza poleceń dla Shortcuts: /usr/bin/shortcuts, udokumentowany w shortcuts(1) oraz w podręczniku użytkownika Apple.¹² Obejmuje on cztery podpolecenia. Wszystkie poniższe informacje zweryfikowano w systemie macOS 26.5.

shortcuts run <shortcut-name-or-identifier> [-i <input-path> ...] [-o <output-path>] [--output-type <UTI>]
shortcuts list [-f <folder-name>] [--folders] [--show-identifiers]
shortcuts view <shortcut-name>
shortcuts sign [-m <mode>] -i <input> -o <output>

shortcuts run

Uruchamia skrót według nazwy lub identyfikatora. „Uruchamianie skrótów z wiersza poleceń nie różni się od uruchamiania ich w aplikacji Shortcuts”¹, co ma dwojakie konsekwencje: pełny dostęp do actions oraz wszystkie monity o uprawnienia (zob. Uprawnienia).

W kanonicznym przykładzie Apple skrót łączący obrazy jest uruchamiany dla folderu zawierającego pliki JPEG:¹

shortcuts run "Combine Images" -i ~/Desktop/*.jpg -o ~/Desktop/combined.png

CLI przestrzega konwencji systemu Unix zarówno na wejściu, jak i na wyjściu. Kod zakończenia: „Polecenie shortcuts kończy działanie z kodem 0 po pomyślnym uruchomieniu lub z kodem 1 w przypadku błędu”.¹ Przekazywanie danych wyjściowych potokiem działa, gdy skrót kończy się wynikiem lub zawiera Stop and Output:¹

# Pipe shortcut output onward, typed as RTFD
shortcuts run "Make Meeting Notes" --output-type com.apple.rtfd | ...

# Feed stdin in, capture stdout out
echo "quarterly report" | shortcuts run "Slugify" -i - -o -

Jedna udokumentowana pułapka: tekst przekazany potokiem do shortcuts run trafia do niego jako tekst. „Gdy ścieżka pliku jest przekazywana potokiem, traktuje się ją jako tekst. Aby dane wejściowe zostały potraktowane jako ścieżki plików, należy użyć flagi -i”.¹

Warto też zapamiętać jedną zasadę projektową Apple: „najwydajniejsze skróty to takie, które nie wyświetlają alertów ani nie proszą o dane wejściowe. Gdy skrót prosi o dane wejściowe, proces wiersza poleceń zostaje wstrzymany i oczekuje na reakcję użytkownika”.¹ W każdym procesie bez interfejsu takie wstrzymanie oznacza zawieszenie. Skróty przeznaczone do obsługi przez CLI należy projektować tak, aby pobierały wszystkie parametry z danych wejściowych.

shortcuts list

Wyświetla nazwy skrótów, po jednej w każdym wierszu. Opcja --folders wyświetla zamiast nich foldery; -f <folder> ogranicza zakres do folderu („none” oznacza skróty znajdujące się poza folderami); --show-identifiers dołącza UUID każdego skrótu.² Identyfikatory są istotne w automatyzacji: nazwy mogą się powtarzać i ulegać zmianie, natomiast UUID pozostają niezmienne. shortcuts run przyjmuje oba warianty.²

shortcuts list --show-identifiers | grep "Deploy"

shortcuts view

Otwiera wskazany skrót w edytorze Shortcuts.² Przydaje się na końcu działania narzędzi: skrypt wykrywający wadliwy skrót może od razu otworzyć go w edytorze.

shortcuts sign

Podpisuje plik .shortcut przeznaczony do dystrybucji; tę funkcję omówiono wraz z formatami udostępniania w części 5.²

Skryptowa obsługa aplikacji za pomocą Shortcuts Events

Trzeci interfejs programistyczny służy do obsługi skryptowej. Shortcuts na Mac rejestruje dwa obiekty docelowe dostępne dla skryptów: samą aplikację Shortcuts oraz pozbawiony interfejsu pomocniczy proces działający w tle — Shortcuts Events (identyfikator pakietu com.apple.shortcuts.events, zweryfikowany w systemie macOS 26.5).¹¹ Słownik skryptowy wyjaśnia powód tego podziału: „Aby uruchomić skrót w tle bez otwierania aplikacji Shortcuts, należy skierować polecenie do ‘Shortcuts Events’ zamiast do ‘Shortcuts’”.¹¹

Słownik jest niewielki i stabilny. Skróty mają właściwości tylko do odczytu: name, subtitle, id, folder, color, icon, accepts input oraz action count; foldery mają właściwości name i id; jedynym czasownikiem jest run, z opcjonalnym parametrem with input i wynikiem.¹¹

AppleScript:

tell application "Shortcuts Events"
    run shortcut "Slugify" with input "Quarterly Report Draft"
end tell

JXA:

const se = Application("Shortcuts Events");
const result = se.shortcuts.byName("Slugify").run({withInput: "Quarterly Report Draft"});

Python za pośrednictwem ScriptingBridge lub py-applescript korzysta z tego samego interfejsu; w ScriptingBridge z PyObjC wywołanie SBApplication.applicationWithBundleIdentifier_("com.apple.shortcuts.events") zwraca obiekt aplikacji, którego kolekcja shortcuts() odzwierciedla opisany powyżej słownik.¹¹

Kiedy warto użyć tego rozwiązania zamiast CLI: gdy kod działa już w kontekście AppleScript/JXA, wynik skrótu ma zostać zwrócony jako obiekt natywny zamiast zserializowanego stdout albo uruchomienia są sterowane z aplikacji, która może wysyłać Apple Events, lecz nie powinna wywoływać powłoki. Pierwsze zdarzenie Apple Event wysłane przez proces hosta do Shortcuts Events powoduje wyświetlenie standardowego monitu systemu macOS o zgodę na automatyzację (System Settings → Privacy & Security → Automation). To kolejny monit, który należy zaakceptować przed rozpoczęciem pracy bez nadzoru.⁶

Słownik zapewnia również dostęp na poziomie organizacji biblioteki (foldery i metadane skrótów są dostępne do odczytu, a przypisanie folderu — do zapisu), dzięki czemu porządkowanie biblioteki, takie jak raporty inwentaryzacyjne i audyty folderów, można zautomatyzować bez korzystania z interfejsu użytkownika.¹¹

Schematy URL

Shortcuts rejestruje schemat URL shortcuts:// (a także starszy workflow://, pochodzący z okresu sprzed przejęcia aplikacji; zweryfikowano w systemie macOS 26.5).¹⁹ Adresy URL stanowią ścieżkę integracji dla innych aplikacji: launcherów, aplikacji do notatek z polami na linki i wszystkiego, co potrafi otworzyć URL. Zalecenie Apple jest jednoznaczne: „Skróty należy uruchamiać za pomocą URL wyłącznie podczas integracji z inną aplikacją spoza Shortcuts”.⁹

Uruchamianie skrótu:⁹

shortcuts://run-shortcut?name=[name]&input=[input]&text=[text]

• name (wymagany): nazwa skrótu zakodowana procentowo.
• input: text albo clipboard. W przypadku text wartość parametru text staje się danymi wejściowymi skrótu; w przypadku clipboard „używana jest zawartość schowka”, a parametr text zostaje zignorowany.⁹

shortcuts://run-shortcut?name=Lookup%20Goetta&input=text&text=goetta%20is%20great
shortcuts://run-shortcut?name=Add%20to%20Notes&input=clipboard

x-callback-url dodaje obsługę odpowiedzi w komunikacji dwukierunkowej:²⁰

shortcuts://x-callback-url/run-shortcut?name=Calculate%20Tip&input=text&text=24.99&x-success=...&x-error=...&x-cancel=...

• x-success jest otwierany po powodzeniu, a tekstowy wynik skrótu zostaje dołączony jako parametr result.
• x-error jest otwierany po niepowodzeniu z parametrem errorMessage.
• x-cancel jest otwierany, jeśli użytkownik anuluje operację, i nie przekazuje żadnych danych wyjściowych.²⁰

W powłoce działa open "shortcuts://run-shortcut?...", ale lepiej użyć tam shortcuts run: CLI zwraca bezpośrednio kody zakończenia i dane wyjściowe, zamiast przekazywać je za pośrednictwem wywołań zwrotnych URL. Na Mac schemat ten pozostaje przydatny głównie do integracji między aplikacjami oraz umieszczania linków w dokumentach.

Formaty udostępniania i podpisywanie

Skróty można przekazywać na 2 sposoby, a każdy z nich wiąże się z decyzją dotyczącą zaufania.⁷

Łącza iCloud. W aplikacji: udostępnianie → Copy iCloud Link (Kopiuj łącze iCloud). Każda osoba mająca łącze może dodać skrót do swojej biblioteki, dlatego jest to najprostszy sposób publicznego rozpowszechniania. Po wysłaniu łącza należy traktować je jako publiczne.⁷

Pliki skrótów. File → Export (Plik → Eksportuj) tworzy plik .shortcut (UTI com.apple.shortcut, zweryfikowano w macOS 26.5).¹⁹⁷ Podczas eksportowania trzeba wybrać poziom zaufania:

• Anyone (Każdy): „Każdy może uruchomić ten skrót”. Apple otrzymuje kopię skrótu w celu jego weryfikacji.⁷
• People Who Know Me (Osoby, które mnie znają): „Tylko osoby, które mają Pana/Panią w kontaktach, będą mogły uruchomić ten skrót”. Dane kontaktowe zostają osadzone w pliku na potrzeby tej weryfikacji.⁷

Polecenie CLI odzwierciedla te same 2 tryby i określa nazwę mechanizmu — zgodnie z shortcuts(1) w macOS 26.5 tryb people-who-know-me „podpisuje lokalnie, ale skrót będą mogły zaimportować tylko urządzenia użytkownika lub osoby, które mają jego dane w swoich kontaktach”, natomiast tryb anyone „przeprowadza notaryzację za pośrednictwem iCloud i pozwala każdemu zaimportować skrót”.²

shortcuts sign -m anyone -i "Deploy Notes.shortcut" -o "Deploy Notes-signed.shortcut"

To polecenie rozwiązuje kwestię dystrybucji w zespołach i systemach CI: wyeksportowane skróty podpisane za pomocą -m anyone można bez problemu importować u odbiorców, którzy nie mają nadawcy w kontaktach. Ponieważ tryb anyone przeprowadza notaryzację przez iCloud, przed włączeniem go do procesu kompilacji należy zapewnić sesję zalogowaną do iCloud oraz dostęp do sieci.²

Importowanie odbywa się metodą „przeciągnij i upuść”: można kliknąć dwukrotnie plik .shortcut, przeciągnąć go do aplikacji albo upuścić na jej ikonę w Docku; pliki .workflow są podczas importowania konwertowane z formatu Automator.¹⁵ Skróty udostępniane poza Gallery są objęte zastrzeżeniem, które Apple formułuje jednoznacznie: „Apple nie może zweryfikować autentyczności ani sposobu działania skrótów udostępnianych prywatnie”.⁶ Dla firmowych flot urządzeń istnieje osobna ścieżka: Apple Configurator obsługuje automatyzacje Shortcuts w zarządzanych przepływach pracy.²¹

W Settings → Advanced (Ustawienia → Zaawansowane) znajduje się również opcja Private Sharing (Udostępnianie prywatne), która określa możliwość importowania skrótów udostępnianych prywatnie i dostępnych tylko dla kontaktów. Towarzyszą jej opcje Allow Running Scripts (Zezwalaj na uruchamianie skryptów) oraz Allow Sharing Large Amounts of Data (Zezwalaj na udostępnianie dużych ilości danych).⁶⁸ Jeśli otrzymanego skrótu nie można zaimportować, przyczyną jest zwykle niepodpisany plik, ograniczenie dostępu do kontaktów, gdy nadawcy nie ma w kontaktach odbiorcy, albo wyłączona opcja Private Sharing.

App Intents: jak aplikacje dodają akcje

Wszystkie opisane dotąd elementy katalogu pochodzą od Apple. Drugą połowę biblioteki zapewniają zainstalowane aplikacje, a od 2022 roku służy do tego jeden framework: App Intents (iOS 16, macOS 13).¹³ Aplikacja definiuje typy zgodne z AppIntent (czasownik: parametry wraz z metodą perform()), opcjonalnie także z AppEntity (rzeczownik: element zawartości aplikacji o określonym typie, z identyfikatorem i reprezentacją ekranową), a resztą zajmuje się system. Te same definicje są dostępne w Shortcuts, Siri, Spotlight, widżetach i Apple Intelligence. Shortcuts stanowi jedną z projekcji schematu intencji aplikacji, a nie osobną integrację.¹³⁴

O sposobie prezentowania aplikacji na Macu decydują 2 poziomy wdrożenia:

• Akcje: każda intencja, która nie jest ukryta, pojawia się jako akcja w edytorze Shortcuts pod nazwą aplikacji i może być łączona ze wszystkimi elementami opisanymi w tym przewodniku.
• App Shortcuts: intencje opakowane w AppShortcutsProvider są dostarczane jako gotowe do uruchomienia skróty natychmiast po zainstalowaniu aplikacji. Użytkownik nie musi ich samodzielnie tworzyć, a skróty mają przypisane frazy wyzwalające Siri.¹³

Zakres frameworka poszerza się co roku. Sesja WWDC25 poświęcona Shortcuts i Spotlight bezpośrednio opisuje aktualne zasady dotyczące Maca: „Jeśli intencja jest dostępna w macOS, można jej również używać w Shortcuts jako części automatyzacji na Macu. Dotyczy to również aplikacji na iOS, które można instalować w macOS”.⁴ Aplikacja na iPhone’a uruchomiona na Macu z układem Apple silicon może dodawać akcje do automatyzacji na Macu bez ani jednego wiersza kodu przeznaczonego specjalnie dla tej platformy.

Wskazówki Apple dotyczące wdrażania z tej samej sesji można podsumować następująco: zawartość należy udostępniać jako encje z „kluczowymi właściwościami, na podstawie których model powinien umieć wnioskować” (korzysta z nich akcja Use Model), zapewnić akcje wyszukiwania umożliwiające wykonywanie zapytań, stosować ciągi atrybutowe tam, gdzie uzasadniony jest tekst sformatowany, oraz dbać o czytelność podsumowań parametrów.⁴

Wskazówki projektowe dla autorów intencji, wynikające z praktyki wdrażania App Intents w aplikacjach produkcyjnych:

• Intencje są API. Nazwy, parametry i identyfikatory encji należy traktować jak kontrakt — zmiana nazwy psuje skróty użytkowników tak samo, jak zmiana nazwy punktu końcowego psuje aplikacje klienckie.
• Działanie w tle jest lepsze niż na pierwszym planie. Intencję, którą można uruchomić bez otwierania aplikacji, da się włączyć do automatyzacji. Intencja wymagająca przeniesienia aplikacji na pierwszy plan przerywa natomiast wykonywane przez użytkownika czynności. Należy świadomie rozdzielać te 2 rodzaje intencji.⁴
• Zwracane wartości zasilają potoki. Intencja zwracająca encję lub wartość daje użytkownikom Shortcuts wynik, który mogą przekazać dalej. Intencja, która niczego nie zwraca, stanowi ślepy zaułek w grafie.

Ta witryna szczegółowo omawia perspektywę programisty w serii poświęconej App Intents: App Intents to nowe API Apple do aplikacji (argumenty przemawiające za wdrożeniem i opis implementacji produkcyjnej), App Intents 2.0 w iOS 26 (Visual Intelligence, fragmenty interfejsu i właściwości odroczone), App Intents w iOS 27 (długotrwałe intencje działające w tle, synchronizowalne encje i ponowne indeksowanie Spotlight) oraz App Intents a MCP (kiedy tę samą funkcję warto udostępnić również jako narzędzie agenta).

Spotlight i automatyzacje uruchamiają intencje

macOS Tahoe rozszerzył zakres miejsc, w których mogą być wykonywane intencje, a 2 nowe możliwości zmieniają korzyści płynące z wdrożenia App Intents na Macu.⁴

Spotlight uruchamia intencje bezpośrednio w interfejsie. „Od tego roku można uruchamiać akcje aplikacji bezpośrednio ze Spotlight na Macu. Aplikacje mogą wyświetlać akcje w Spotlight dzięki wdrożeniu App Intents, tak samo jak w przypadku Shortcuts”.⁴ Wymagania są na tyle precyzyjne, że można przeprowadzić audyt ich zgodności:

1. Podsumowanie parametrów („krótki opis w języku naturalnym przedstawiający działanie intencji aplikacji”) „musi zawierać wszystkie wymagane parametry, które nie mają wartości domyślnej”.⁴
2. Intencja nie może wyłączać wykrywania: ustawienie isDiscoverable na false lub assistantOnly na true usuwa ją ze Spotlight.⁴
3. Sugestie i wyszukiwanie opierają się na warstwie encji: na potrzeby selektora należy zaimplementować sugerowane encje lub zapytanie o wyliczalne encje, natomiast wyszukiwanie podczas pisania wymaga tekstowego zapytania o encje albo encji objętych indeksowaniem.⁴

Automatyzacje uruchamiają intencje bez nadzoru. Ponieważ automatyzacje w Tahoe wykonują skróty, a skróty wykonują intencje, zmiana zawartości folderu lub zamontowanie dysku może teraz wywołać intencję aplikacji bez obecności użytkownika.⁴ Dla autorów intencji oznacza to zaostrzenie wymagań opisanych w poprzedniej sekcji: intencja zakładająca obecność użytkownika na pierwszym planie — na przykład wyświetlająca interfejs lub wymagająca potwierdzenia — po cichu przestaje działać w automatyzacji Run Immediately. Każdą intencję należy sprawdzić pod kątem wykonywania bez nadzoru: co się stanie, jeśli nikt nie będzie patrzył na ekran?

Razem te 2 funkcje wyrażają dyskretne założenie architektoniczne Apple: to intencja, a nie okno aplikacji, stanowi jednostkę funkcjonalności na Macu. Spotlight jest interaktywnym mechanizmem wywołującym, automatyzacje — mechanizmem działającym bez nadzoru, a Shortcuts — warstwą kompozycji pomiędzy nimi.

Uruchamianie Shortcuts ze skryptów i agentów

Shortcuts zajmuje szczególne miejsce w architekturach agentów i skryptów: jest sposobem o najmniejszych uprawnieniach i największej przejrzystości dla użytkownika, który pozwala zewnętrznemu kodowi korzystać z możliwości Maca. Agent AI z dostępem do powłoki może wykonać większość czynności bezpośrednio, ale skierowanie operacji przez skrót zapewnia właściwości niedostępne w zwykłej powłoce: operacja jest definiowana i edytowalna przez użytkownika, uprawnienia są przyznawane osobno dla każdego skrótu i można je cofnąć jednym kliknięciem, a zakres potencjalnych skutków jest widoczny w edytorze.⁶ Warstwę skrótów warto traktować jako katalog możliwości zarządzany przez człowieka i wywoływany przez agenta.

Zanim będzie to możliwe, trzeba spełnić jeden bezwzględny wymóg: CLI wymaga zalogowanej sesji z interfejsem graficznym. Każde podpolecenie shortcuts — w tym list — komunikuje się z aplikacją pomocniczą w sesji Aqua użytkownika i kończy się błędem „Couldn’t communicate with a helper application”, gdy taka sesja nie istnieje (zweryfikowano w macOS 26.5). Sesje korzystające wyłącznie z SSH, bezgłowe środowiska CI oraz demony launchd napotykają tę przeszkodę; agentów i zaplanowane wywołania należy uruchamiać w ramach zalogowanej sesji użytkownika — jako agent launchd, a nie demon.

Kontrakt wywołania w terminologii agentów:¹²

Dane strukturalne przekraczają tę granicę jako tekst. Praktycznym rozwiązaniem jest przesyłanie JSON przez stdin/stdout: program wywołujący przekazuje dokument JSON (-i -), skrót analizuje go za pomocą Get Dictionary from Input, wykonuje pracę, a następnie kończy się akcją Stop and Output, która zwraca słownik w formie tekstu.¹¹⁶ Skrót staje się funkcją typowaną z udokumentowanym schematem; obok konfiguracji agenta, która go wywołuje, warto przechowywać plik README opisujący oczekiwany format danych wejściowych i wyjściowych każdego skrótu.

Za limity czasu odpowiada program wywołujący. Skrót wyświetlający alert wstrzymuje proces CLI na czas nieokreślony,¹ dlatego każde nienadzorowane wywołanie powinno mieć limit czasu, a jego przekroczenie należy traktować jako błąd:

# macOS ships no timeout(1); gtimeout comes from `brew install coreutils`
if ! output=$(gtimeout 120 shortcuts run "$UUID" -i - -o - <<<"$payload"); then
  echo "shortcut failed or timed out" >&2
fi
# no-Homebrew alternative using the system perl:
#   perl -e 'alarm shift; exec @ARGV' 120 shortcuts run "$UUID" -i - -o - <<<"$payload"

Przed uruchomieniem bez nadzoru należy wstępnie przyznać uprawnienia. Każdy skrót trzeba najpierw uruchomić interaktywnie i odpowiedzieć Always Allow na wyświetlane monity; następnie należy potwierdzić w Terminalu, że wykonanie nie powoduje wyświetlania monitów, zanim skrót wywoła agent lub zadanie launchd.⁶¹ Sekcja dotycząca uprawnień wyjaśnia, które zgody są w ten sposób przyznawane z wyprzedzeniem.

Punkt wejścia należy dobrać do typu programu wywołującego. Programy z dostępem do powłoki (agenty, CI, agenty launchd, pliki Makefile — wszystkie działające w zalogowanej sesji) korzystają z CLI. Konteksty Apple Event (aplikacje AppleScript, demony PyObjC) używają Shortcuts Events i otrzymują natywne wartości zwrotne.¹¹ Środowiska sandboxowe lub dysponujące wyłącznie adresami URL używają shortcuts://run-shortcut wraz z x-callback do zwracania wyników.⁹²⁰ Wszystkie 3 metody uruchamiają ten sam skrót; różni je jedynie sposób komunikacji.

Działa również kierunek odwrotny: skróty mogą służyć jako interfejsy agentów. Skrót uruchamiany skrótem klawiszowym lub z paska menu może zebrać kontekst (zaznaczenie, zawartość schowka, aplikację na pierwszym planie), przekazać go do akcji Run Shell Script wywołującej CLI agenta, a następnie wyświetlić wynik — powierzchnie wprowadzania danych systemu operacyjnego stają się w ten sposób interfejsem dla narzędzi działających w tle.¹⁰¹⁷

Uprawnienia i zgody (TCC)

Shortcuts korzysta z modelu zabezpieczeń macOS opartego na uprzednim wyrażaniu zgody, a źródłem każdego błędu automatyzacji, który nie wynika z logiki, jest ostatecznie ten model. Składa się on z 4 warstw; ustalenie, która z nich wyświetla monit, pozwala rutynowo rozwiązać problem.

1. Zgoda na dostęp do danych dla poszczególnych skrótów. Gdy skrót po raz pierwszy uzyskuje dostęp do chronionego zasobu, Shortcuts wyświetla komunikat: „If a Privacy dialog appears requesting access to data, choose Allow Once, Always Allow, or Don’t Allow”. Always Allow oznacza, że „the Shortcuts app won’t ask you for access the next time you run the shortcut”.⁶ Zgody są przyznawane osobno dla każdego skrótu i zasobu oraz można je przeglądać: panel szczegółów każdego skrótu zawiera kartę Privacy, na której można cofnąć poszczególne zgody, a opcja „To remove access to all data for this shortcut, click Reset Privacy” pozwala usunąć wszystkie zgody dotyczące danego skrótu.⁶

2. Blokada skryptów. 5 akcji skryptowych działa wyłącznie po włączeniu opcji Settings → Advanced → Allow Running Scripts (dokładna lista powyżej).⁸ To ustawienie globalne, a nie przypisane do konkretnego skrótu; włączenie go dla jednego skryptu obsługującego monitorowany folder umożliwia wykonywanie skryptów przez każdy zaimportowany skrót. Jest to jeden z powodów, dla których przed uruchomieniem zaimportowanego skrótu należy sprawdzić jego zawartość.⁶

3. Systemowe monity TCC. Akcje uzyskujące dostęp do chronionych obszarów systemu operacyjnego (Files and Folders, Automation/Apple Events do sterowania innymi aplikacjami za pomocą skryptów, Accessibility do sterowania wprowadzaniem danych) powodują wyświetlenie okien dialogowych na poziomie systemu, zarządzanych w System Settings → Privacy & Security. Uprawnienia te są przypisywane do odpowiedzialnego procesu, dlatego skrót może zachowywać się inaczej w aplikacji, po uruchomieniu z CLI i w ramach automatyzacji: są to różne konteksty uruchomienia, którym zgody przyznaje się osobno.⁶

4. Zasady uruchamiania automatyzacji. Ustawienie Run Immediately lub Run After Confirmation dla każdej automatyzacji określa, czy samo wyzwolenie wymaga działania człowieka.¹⁸

Wynikają z tego następujące zasady operacyjne:

• Monity nie pojawiają się tam, gdzie nikt ich nie zobaczy. Konteksty bezgłowe (sesje SSH, środowiska CI, agenty) podlegają pierwszej zasadzie z sekcji dotyczącej CLI: monit o zgodę pozostawiony bez odpowiedzi powoduje wstrzymanie na czas nieokreślony.¹ Zgody należy przyznać wcześniej w trybie interaktywnym.
• Reset Privacy pozwala rozpocząć diagnostykę od czystego stanu. Jeśli po wprowadzeniu zmian skrót działa nieprawidłowo, zresetowanie jego zgód i ponowne uruchomienie w trybie interaktywnym powoduje wyświetlenie wszystkich monitów w odpowiedniej kolejności.⁶
• Zaimportowane skróty należy sprawdzać. Apple weryfikuje skróty podpisane w trybie „Anyone”, ale „cannot verify the authenticity or behavior of shortcuts shared privately”.⁶⁷ Karta Privacy pokazuje, jakie uprawnienia przyznano skrótowi, a edytor — co skrót robi. Sprawdzenie obu zajmuje minutę.

Rozwiązywanie problemów

Skrócona karta referencyjna

# Run
shortcuts run "Name"                          # by name
shortcuts run 8F3A...-UUID                    # by identifier (stable)
shortcuts run "Name" -i file.jpg -o out.png   # file in, file out
echo data | shortcuts run "Name" -i - -o -    # stdin → stdout
shortcuts run "Name" --output-type public.plain-text | pbcopy

# Inspect
shortcuts list                                # names
shortcuts list --show-identifiers             # names + UUIDs
shortcuts list --folders                      # folders
shortcuts list -f "Folder"                    # scoped
shortcuts view "Name"                         # open in editor

# Distribute
shortcuts sign -m anyone -i in.shortcut -o out.shortcut
shortcuts sign -m people-who-know-me -i in.shortcut -o out.shortcut

# Exit codes: 0 success, 1 error

-- Background run with result (no app window)
tell application "Shortcuts Events" to run shortcut "Name" with input "payload"

shortcuts://run-shortcut?name=Name&input=text&text=payload
shortcuts://run-shortcut?name=Name&input=clipboard
shortcuts://x-callback-url/run-shortcut?name=Name&x-success=app://ok&x-error=app://fail

Listy kontrolne. Skrót gotowy do pracy bez nadzoru: nie zawiera alertów ani parametrów Ask Each Time; zgody przyznano wcześniej za pomocą Always Allow; jest wywoływany przez UUID; program wywołujący wymusza limit czasu; kończy się akcją Stop and Output.¹⁶ Plik gotowy do dystrybucji: został wyeksportowany i podpisany za pomocą -m anyone, a jego kontrakt danych wejściowych jest udokumentowany.²⁷

FAQ

Jak uruchomić skrót Maca z Terminal? shortcuts run "Shortcut Name", opcjonalnie z -i dla plików wejściowych (lub - dla stdin), -o dla danych wyjściowych (lub - dla stdout) oraz --output-type z Uniform Type Identifier. Polecenie zwraca 0 po powodzeniu i 1 w przypadku błędu, więc można je łączyć z &&, if i make jak każde narzędzie Unix.¹²

Czy macOS ma wreszcie automatyzacje Shortcuts takie jak iOS? Tak, od macOS Tahoe (26). Wyzwalacze obejmują porę dnia, alarm, e-mail, wiadomość, zmiany w folderze, dysk zewnętrzny, ekran, Wi‑Fi, Bluetooth, poziom baterii, ładowarkę, otwarcie/zamknięcie aplikacji, Focus i Stage Manager; każdy z nich można skonfigurować do uruchamiania natychmiast lub po potwierdzeniu.³⁴¹⁸

Co właściwie robi shortcuts sign -m anyone? Notaryzuje plik skrótu przez iCloud, dzięki czemu każdy może go zaimportować. Domyślny tryb, people-who-know-me, podpisuje lokalnie i ogranicza import do własnych urządzeń oraz osób, które mają dane kontaktowe użytkownika w Contacts.²

Jak aplikacje dodają własne actions do Shortcuts na Macu? Przez zastosowanie frameworka App Intents. Intents automatycznie pojawiają się jako actions w Shortcuts, a AppShortcutsProvider dostarcza wraz z aplikacją App Shortcuts niewymagające konfiguracji. Intents dostępne w macOS działają także z Spotlight i w automatyzacjach Tahoe, w tym intents z aplikacji iOS zainstalowanych na Macach z Apple silicon.¹³⁴

Jak skrypt lub agent AI powinien wywoływać skróty? Należy używać CLI: wykrywać skróty przez shortcuts list --show-identifiers, wywoływać je przez UUID, przekazywać JSON przez stdin, odczytywać wyniki ze stdout i otaczać każde wywołanie limitem czasu, ponieważ skrót wyświetlający monit będzie czekał bez końca (macOS nie zawiera timeout(1) — należy użyć gtimeout z coreutils lub limitu czasu procesu w używanym języku). Przed użyciem bez nadzoru należy interaktywnie zatwierdzić monity o uprawnienia każdego skrótu. W kontekstach AppleScript należy kierować żądania do Shortcuts Events, aby uruchamiać skróty bez otwierania aplikacji.¹²¹¹

Czy Shortcuts może zastąpić Automator? W przypadku większości przepływów pracy — tak; Apple nazywa Shortcuts przyszłością automatyzacji Maca i stworzyło konwerter, który bezpośrednio importuje większość plików .workflow. Automator nadal jest dostarczany z systemem i nadal uruchamia istniejące przepływy pracy, dlatego migracja jest wyborem, a nie terminem.⁵¹⁴¹⁵

Dziennik zmian

Źródła