Uruchamiaj typowe zadania Crypto z Quick Actions w Figmie bez otwierania panelu wtyczki. Wybierz jeden z nazwanych skrótów poniżej. Do szczegółowych ustawień i tworzenia treści używaj zwykłego panelu wtyczki.
Uruchamianie Quick Action
Każdy skrót wymaga zweryfikowanej, ważnej licencji lub pozostałych użyć próbnych. Jeśli weryfikacja się nie powiedzie albo Twoje użycia próbne się skończyły, otwórz zwykły panel wtyczki, aby aktywować licencję. Otwieranie panelu jest zawsze dostępne.
- Zaznacz warstwy, na których chcesz pracować, jeśli skrót korzysta z zaznaczenia.
- Otwórz Quick Actions w Figmie skrótem Command + / w macOS lub Ctrl + / w Windows.
- Wyszukaj wtyczkę i wybierz jeden z nazwanych skrótów poniżej.
- Wypełnij wyświetlone pola. Pola opcjonalne możesz pominąć; do ich edycji użyj klawisza Tab. Uruchom skrót i sprawdź wynik albo dokończ okno zapisu.
Skróty tworzące nowe elementy pytają bezpośrednio o nazwy lub wymiary. Skróty działające na zaznaczonych warstwach automatycznie używają bieżącego zaznaczenia. Te codzienne skróty nie pytają o Target ani JSON. Wybierz Open Crypto, aby otworzyć zwykły panel wtyczki.
| Skrót | Pola |
|---|---|
| Upload Selected Designs | Brak; uruchamia się od razu |
| Export Selected Designs as PDF (Custom Settings…) | Password protection (opcjonalnie), PDF quality (opcjonalnie) |
Pola z ustaloną listą wyborów mają czytelne etykiety. Możesz wyszukiwać po wyświetlanej etykiecie lub po wartości, która się za nią kryje; dane wejściowe agenta nadal używają wartości podanych w opisie poleceń.
Uruchamianie z menu kontekstowego
Zaznacz odpowiednie warstwy, kliknij prawym przyciskiem myszy i wybierz Plugins → Crypto (wtyczki deweloperskie znajdziesz w Development). Wybierz akcję oraz jej format lub ustawienie wstępne. Ustawienie wstępne uruchamia się od razu, jeśli nie wymaga żadnych pól obowiązkowych; gdy pojawi się okno zapisu, dokończ je.
Każde ustawienie wstępne ustawia opcję, od której wzięło nazwę. Pominięte zgodne opcje dziedziczą zapisane ustawienia wtyczki; jawnie wybrana akcja lub opcja ma pierwszeństwo przed sprzecznym zapisanym zachowaniem. Tylko jawnie wpisane pola lub wybrana pozycja menu zastępują je w danym uruchomieniu. Jeśli ustawienie nigdy nie zostało zapisane, obowiązuje zwykłe ustawienie lub opisana wartość zastępcza. Zmiany wprowadzone na potrzeby eksportu nie są zapisywane w Twoich preferencjach. Jeśli zapisany format nie jest dostępny jako skrót, wybierz jawnie obsługiwany format albo użyj zwykłego panelu. Aby połączyć kilka opcji, wybierz w danej akcji Custom Settings… i wpisz parametry. Akcje, które potrzebują tekstu, adresów URL, nazw lub wymiarów, nadal pytają o te obowiązkowe pola. Open Crypto otwiera zwykły panel.
| Pozycja menu | Następny krok |
|---|---|
| Upload Selected Designs | Uruchamia się od razu |
| Export Selected Designs as PDF → Use Saved Settings | Uruchamia się od razu |
| Export Selected Designs as PDF → Export Selected Designs as PDF (Custom Settings…) | Wpisz Password protection (opcjonalnie), PDF quality (opcjonalnie) |
Szczegółowa edycja
Do szczegółowych ustawień, dłuższych treści, masowego tworzenia oraz przeglądania komponentów i szablonów używaj zwykłego panelu wtyczki. Menu skrótów zawiera tylko codzienne polecenia wymienione powyżej.
Każde wklejane pole powinno mieć mniej niż 150 znaków: Figma w wersji desktopowej może obcinać wklejony tekst na tej granicy. Dłuższe treści wpisuj w zwykłym panelu.
Jeśli starsza wersja wtyczki pokazuje zamiast tego pola Action, Target i Options, zaktualizuj ją, aby korzystać z tych nazwanych skrótów. Wartość Target to identyfikator warstwy lub zaznaczenie, nigdy nazwa nowego elementu.
Akcje Crypto
| Akcja | Co robi | Target |
|---|---|---|
publish | Przesyła zaznaczone ramki jako nową, chronioną wersję projektu | Co najmniej jedna kwalifikująca się warstwa |
pdf | Eksportuje zaznaczone ramki do PDF z zapisanymi ustawieniami ochrony | Co najmniej jedna kwalifikująca się warstwa |
publish
Przesyła zaznaczone ramki jako nową, chronioną wersję projektu. Zaznacz co najmniej jedną kwalifikującą się warstwę.
Ten skrót nie ma pól do wypełnienia.
To jawny zapis zewnętrzny do istniejących usług Hypermatic, z których korzysta wtyczka. Używa zapisanej konfiguracji konta i może utworzyć konto w ramach dotychczasowego przepływu. Po błędzie przesyłania nie ponawiaj próby automatycznie; sprawdź, czy w miejscu docelowym nie ma częściowych wyników.
Wybierz Upload Selected Designs. Skrót uruchamia się od razu na bieżącym zaznaczeniu.
Dane wejściowe dla hosta agenta
{"command":"shortcut-publish","parameters":{}}pdf
Eksportuje zaznaczone ramki do PDF z zapisanymi ustawieniami ochrony. Zaznacz co najmniej jedną kwalifikującą się warstwę.
| Opcja | Typ | Obowiązkowa / domyślna | Znaczenie i dozwolone wartości |
|---|---|---|---|
protection | string | Wartość zastępcza: "saved" | Użyj wcześniej zapisanego hasła albo jawnie wyeksportuj bez ochrony. saved, none |
dpi | string | Wartość zastępcza: "ebook" | Istniejące ustawienie wstępne jakości PDF. screen, ebook, printer, prepress, default |
Zagnieżdżone pola obowiązkowe obowiązują, gdy podasz ich obiekt nadrzędny lub element tablicy. Pominięte wartości opcjonalne działają tak jak w istniejącej operacji, chyba że podano wartość domyślną.
Wybierz Export Selected Designs as PDF (Custom Settings…). Wypełnij te zwykłe pola; JSON nie jest potrzebny:
- Password protection: Use Saved Password
- PDF quality: eBook (150 dpi)
Dane wejściowe dla hosta agenta
{"command":"shortcut-pdf","parameters":{"protection":"saved","dpi":"ebook"}}Korzystanie ze skrótów przez agenta
Przeczytaj rejestr w formacie do odczytu maszynowego, do którego link znajdziesz poniżej, i wybierz akcję dostępną na liście Quick Actions zainstalowanej wtyczki. Rejestr używa definicji opcji Hypermatic, a nie standardowego JSON Schema: min i max ograniczają długość tekstu, długość tablicy lub wartość liczbową, zależnie od typu pola; definicje zagnieżdżone używają fields i item. Nieznane pola są odrzucane.
Agent potrzebuje hosta, który potrafi wywoływać Quick Actions w Figmie i obserwować zwykły wynik działania wtyczki. Parametry nie dodają uruchamiania przez REST ani MCP. Rozwijane przykłady to dane wejściowe dla zgodnego hosta, a nie wykonywalne wywołania API; pola skrótów używają w parameters zwykłych ciągów znaków, także dla liczb i wyboru formatu. Nigdy nie twierdź, że skrót się wykonał, tylko na podstawie przygotowanych danych wejściowych.
Sprawdź widoczny efekt: zmienione warstwy w Figmie, zapisany eksport lub opublikowaną stronę. Przeczytaj zwykły komunikat o powodzeniu lub błędzie oraz ewentualne ostrzeżenie o częściowym eksporcie. W razie potrzeby dokończ systemowe okna zapisu; samo rozpoczęcie pobierania nie dowodzi, że plik został zapisany. Użytkownicy nie muszą otwierać narzędzi deweloperskich ani czytać konsoli.
Rozwiązywanie problemów
| Objaw | Następny krok |
|---|---|
| Akcja jest niedostępna | Zaktualizuj wtyczkę i sprawdź jej listę Quick Actions; jeśli akcji nadal nie ma, użyj zwykłego panelu. |
| Opcje są nieprawidłowe lub mogły zostać obcięte | Podawaj osobne, zwykłe wartości pól krótsze niż 150 znaków i tylko pola akceptowane przez dany skrót. |
| Brakuje elementu docelowego lub się nie kwalifikuje | Otwórz właściwą stronę, sprawdź wymagania akcji dotyczące warstw i ponownie zaznacz odpowiednie warstwy. |
| Pojawia się błąd licencji lub użyć próbnych | Przed ponownym uruchomieniem przejdź zwykłą aktywację we wtyczce. |
| Zlecono pobranie, ale nie widać zapisanego pliku | Sprawdź systemowe okno zapisu i folder pobierania. Obejrzyj sam plik. |
| Polecenie kończy się błędem, przekracza limit czasu lub zostaje anulowane | Przed ponowną próbą sprawdź dokument i miejsce docelowe; wcześniejsze zmiany lub przesłane pliki mogą już istnieć. |
Polecenia mają limit pięciu minut. Błąd nie oznacza pełnego wycofania zmian. Automatyczne ponawianie tworzenia, zastępowania lub przesyłania może zduplikować lub nadpisać pracę.
Rejestr poleceń do odczytu maszynowego zawiera te same identyfikatory akcji i definicje opcji.
Obecne ograniczenia
Publikowanie tworzy nową, chronioną wersję projektu przy użyciu istniejącej konfiguracji konta i funkcji przesyłania; może utworzyć konto zdalne. Publikowanie prototypów, aktualizowanie istniejących wersji i zmiana hasła pozostają interaktywne. Eksport PDF używa zapisanego stanu ochrony hasłem i zapisanej jakości. Wybranie ochrony none wyłącza ochronę tylko dla tego eksportu. Zapisane, włączone ustawienie ochrony wymaga zapisanego hasła. Jawny wybór Use Saved Password także wymaga zapisanego hasła i włącza ochronę dla tego uruchomienia.