Uruchamiaj typowe zadania Pixelay 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 Pixelay, aby otworzyć zwykły panel wtyczki.
| Skrót | Pola |
|---|---|
| Upload Selected Comparisons | Brak; uruchamia się od razu |
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ń.
Przed użyciem Upload Selected Comparisons skonfiguruj w zwykłym panelu adresy URL zaznaczonych ramek oraz bazowy adres URL obowiązujący na całej stronie.
Uruchamianie z menu kontekstowego
Zaznacz odpowiednie warstwy, kliknij prawym przyciskiem myszy i wybierz Plugins → Pixelay (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 Pixelay otwiera zwykły panel.
| Pozycja menu | Następny krok |
|---|---|
| Upload Selected Comparisons | Uruchamia się od razu |
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 Pixelay
| Akcja | Co robi | Target |
|---|---|---|
publish | Przesyła zaznaczone ramki z zapisanymi adresami URL porównań | Co najmniej jedna kwalifikująca się warstwa |
publish
Przesyła zaznaczone ramki z zapisanymi adresami URL porównań. 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 Comparisons. Skrót uruchamia się od razu na bieżącym zaznaczeniu.
Dane wejściowe dla hosta agenta
{"command":"shortcut-publish","parameters":{}}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 korzysta z istniejącej konfiguracji konta i funkcji przesyłania; może utworzyć konto i zastępuje zapisane porównanie zaznaczonymi ramkami. Konfiguracja zapisuje tylko lokalne powiązania adresów URL. Przed publikowaniem trzeba skonfigurować bazowy adres URL strony.