Uruchamiaj typowe zadania Convertify 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 bezpłatnych prób. Jeśli weryfikacja się nie powiedzie albo bezpłatne próby się skończyły, otwórz zwykły panel wtyczki, aby aktywować licencję. Otwieranie panelu pozostaje dostępne.
- Zaznacz warstwy, z którymi chcesz pracować, jeśli skrót korzysta z zaznaczenia.
- Otwórz Quick Actions w Figmie skrótem Command + / na Macu 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 zapisywanie w oknie dialogowym.
Skróty tworzące 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. Aby otworzyć zwykły panel wtyczki, wybierz Open Convertify.
| Skrót | Pola |
|---|---|
| Export Selected Layers (Custom Settings…) | Format (opcjonalnie) |
Pola ze stałą listą wyborów pokazują czytelne etykiety. Wyszukuj po wyświetlanej etykiecie lub po wartości, która się za nią kryje. Dane wejściowe dla agentów nadal korzystają z wartości podanych w opisie poleceń.
Uruchamianie z menu kontekstowego
Zaznacz odpowiednie warstwy, kliknij prawym przyciskiem myszy i wybierz Plugins → Convertify (wtyczki deweloperskie są w sekcji Development). Wybierz akcję oraz jej format lub preset. Preset uruchamia się od razu, jeśli nie wymaga żadnych pól obowiązkowych. Gdy pojawi się okno zapisywania, dokończ zapis.
Każdy preset ustawia swoją nazwaną opcję. Pominięte zgodne opcje dziedziczą zapisane ustawienia wtyczki, a wprost wybrana akcja lub opcja ma pierwszeństwo przed sprzecznym zapisanym zachowaniem. Tylko wprost wpisane pola lub wybrana pozycja menu nadpisują ustawienia w danym uruchomieniu. Jeśli ustawienie nigdy nie zostało zapisane, obowiązuje zwykłe ustawienie lub opisana wartość zastępcza. Nadpisania eksportu nie są zapisywane w Twoich preferencjach. Jeśli zapisany format nie jest dostępny jako skrót, wybierz wprost obsługiwany format albo użyj zwykłego panelu. Aby połączyć kilka opcji, wybierz w danej akcji Custom Settings… i wpisz parametry. Akcje wymagające tekstu, adresów URL, nazw lub wymiarów nadal pytają o te obowiązkowe pola. Open Convertify otwiera zwykły panel.
| Pozycja menu | Następny krok |
|---|---|
| Export Selected Layers → Use Saved Settings | Uruchamia się od razu |
| Export Selected Layers → Adobe Photoshop (.psd) | Uruchamia się od razu |
| Export Selected Layers → Canva (.psd) | Uruchamia się od razu |
| Export Selected Layers → Sketch (.sketch) | Uruchamia się od razu |
| Export Selected Layers → EPS Vector (.eps) | Uruchamia się od razu |
| Export Selected Layers → Adobe XD (.xd) | Uruchamia się od razu |
| Export Selected Layers → Adobe After Effects | Uruchamia się od razu |
| Export Selected Layers → Adobe InDesign (.idml) | Uruchamia się od razu |
| Export Selected Layers → Export Selected Layers (Custom Settings…) | Wpisz Format (opcjonalnie) |
Szczegółowa edycja
Do szczegółowych ustawień, dłuższych treści, masowego tworzenia oraz przeglądania komponentów lub szablonów używaj zwykłego panelu wtyczki. Menu skrótów zawiera tylko wymienione wyżej codzienne polecenia.
Każde wklejane pole powinno mieć mniej niż 150 znaków: Figma w wersji desktopowej może obcinać wklejany tekst na tej granicy. Dłuższe dane 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 Convertify
| Akcja | Co robi | Target |
|---|---|---|
export | Konwertuje zaznaczone warstwy za pomocą istniejącego eksportera | Co najmniej jedna kwalifikująca się warstwa |
export
Konwertuje zaznaczone warstwy za pomocą istniejącego eksportera. Zaznacz co najmniej jedną kwalifikującą się warstwę.
| Opcja | Typ | Wymagana / domyślna | Znaczenie i akceptowane wartości |
|---|---|---|---|
format | string | Wartość zastępcza: "psd" | Format konwersji lokalnej. psd, canva, sketch, eps, xd, ae, idml |
Zagnieżdżone pola wymagane obowiązują, gdy podano ich obiekt nadrzędny lub element tablicy. Pominięte wartości opcjonalne korzystają z dotychczasowego działania operacji, chyba że podano wartość domyślną.
Wybierz Export Selected Layers (Custom Settings…). Wpisz te zwykłe pola – JSON nie jest potrzebny:
- Format: Adobe Photoshop (.psd)
Dane wejściowe dla hosta agenta
{"command":"shortcut-export","parameters":{"format":"psd"}}Korzystanie ze skrótów z agentem
Przeczytaj rejestr w formacie do odczytu maszynowego (link 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, a 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ą mechanizmu 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 w parameters to zwykłe ciągi znaków, także liczby i wybrane formaty. Nigdy nie twierdź, że skrót się wykonał, tylko na podstawie przygotowanych danych wejściowych.
Sprawdź widoczny wynik: zmienione warstwy w Figmie, zapisany eksport lub opublikowaną stronę. Przeczytaj zwykłe powiadomienie o sukcesie lub błędzie i ewentualne ostrzeżenie o częściowym eksporcie. W razie potrzeby dokończ zapis w systemowym oknie dialogowym – 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 akcja jest niedostępna, użyj zwykłego panelu. |
| Opcje są nieprawidłowe lub mogły zostać obcięte | Wpisuj pojedyncze, zwykłe wartości pól krótsze niż 150 znaków i tylko pola akceptowane przez dany skrót. |
| Brakuje elementu Target lub się on 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 bezpłatnych prób | Przed ponownym uruchomieniem przejdź zwykły proces aktywacji wtyczki. |
| Pobieranie zostało zlecone, ale nie widać zapisanego pliku | Sprawdź systemowe okno zapisywania i lokalizację pobierania. Sprawdź sam plik. |
| Polecenie kończy się błędem, przekracza limit czasu lub zostaje anulowane | Przed ponowieniem sprawdź dokument i zdalne 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ń w formacie do odczytu maszynowego zawiera te same identyfikatory akcji i definicje opcji.
Obecne ograniczenia
Wszystkie importy plików pozostają interaktywne, ponieważ tekst parametrów nie może dostarczyć zawartości lokalnych plików. After Effects korzysta z dotychczasowego formatu przekazania przez XD, a IDML tworzy dotychczasowy pakiet ZIP. Dotychczasowe działanie konwersji i tymczasowego przywracania dokumentu pozostaje bez zmian.