Uruchamiaj typowe zadania Weblify 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 Weblify.
| Skrót | Pola |
|---|---|
| Export Website… | Export name |
| Repair Weblify Metadata | Brak; uruchamia się od razu |
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 → Weblify (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 Weblify otwiera zwykły panel.
| Pozycja menu | Następny krok |
|---|---|
| Export Website… | Wpisz Export name |
| Repair Weblify Metadata | Uruchamia się od razu |
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 Weblify
| Akcja | Co robi | Target |
|---|---|---|
export | Eksportuje bieżącą stronę Weblify jako statyczne archiwum ZIP | Bez warstwy docelowej |
repair | Naprawia metadane w zaznaczonych poddrzewach bez przechodzenia na całą stronę | Co najmniej jedna kwalifikująca się warstwa |
export
Eksportuje bieżącą stronę Weblify jako statyczne archiwum ZIP. Ta akcja nie przyjmuje elementów docelowych.
| Opcja | Typ | Wymagana / domyślna | Znaczenie i akceptowane wartości |
|---|---|---|---|
name | string | Wymagana | Nazwa nowego elementu. Minimum 1 znak, maksimum 120 znaków |
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 Website…. Wpisz te zwykłe pola – JSON nie jest potrzebny:
- Export name:
My Website
Dane wejściowe dla hosta agenta
{"command":"shortcut-export","parameters":{"name":"My Website"}}repair
Naprawia metadane w zaznaczonych poddrzewach bez przechodzenia na całą stronę. Zaznacz co najmniej jedną kwalifikującą się warstwę.
Ten skrót nie ma pól do wypełnienia.
Wybierz Repair Weblify Metadata. Uruchamia się od razu na bieżącym zaznaczeniu.
Dane wejściowe dla hosta agenta
{"command":"shortcut-repair","parameters":{}}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
Twórz strony, aktualizuj obrazy, składaj komponenty i publikuj w zwykłym panelu. Repair Weblify Metadata naprawia tylko metadane w zaznaczonych poddrzewach; nie zmienia ich widocznego układu. Export Website działa na bieżącej stronie Weblify, a nie na zaznaczeniu. Do audytów, tokenów i sprawdzania obrazów zastępczych używaj panelu.