---
url: "/pl/hypercrop/automation/parameters.md"
description: "Uruchamiaj Quick Actions w HyperCrop z prostymi nazwanymi polami i skrótami działającymi na bieżącym zaznaczeniu."
---

# Quick Actions w HyperCrop

> Uruchamiaj Quick Actions w HyperCrop z prostymi nazwanymi polami i skrótami działającymi na bieżącym zaznaczeniu.

Uruchamiaj typowe zadania HyperCrop 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 {#run-a-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.

1. Zaznacz warstwy, na których chcesz pracować, jeśli skrót korzysta z zaznaczenia.
2. Otwórz Quick Actions w Figmie skrótem **Command + /** w macOS lub **Ctrl + /** w Windows.
3. Wyszukaj wtyczkę i wybierz jeden z nazwanych skrótów poniżej.
4. 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 HyperCrop**, aby otworzyć zwykły panel wtyczki.

| Skrót | Pola |
| --- | --- |
| **Crop Selected Images (Custom Settings…)** | Name, Width (px), Height (px), Format (opcjonalnie), Image fit (opcjonalnie), Horizontal alignment (opcjonalnie), Vertical alignment (opcjonalnie), Content-aware cropping (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ń.

Wybierz **Crop to Fill…**, **Fit Inside…** lub **Content-aware Crop…** i wpisz nazwę oraz wymiary wyniku. Crop to Fill i Fit Inside wyłączają odziedziczone pozycjonowanie z uwzględnieniem treści lub twarzy; Content-aware Crop wybiera Crop to Fill nawet wtedy, gdy zapisane jest Fit Inside. Custom Settings udostępnia **Crop to Fill / Fit Inside**, wyrównanie w poziomie i w pionie oraz kadrowanie z uwzględnieniem treści. Jawnie ustawione wyrównanie wyłącza odziedziczone inteligentne kadrowanie i kadrowanie według twarzy; jawny wybór kadrowania z uwzględnieniem treści ma pierwszeństwo przed wyrównaniem.

## Uruchamianie z menu kontekstowego {#run-from-the-context-menu}

Zaznacz odpowiednie warstwy, kliknij prawym przyciskiem myszy i wybierz **Plugins → HyperCrop** (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 HyperCrop** otwiera zwykły panel.

Jawnie ustawione wyrównanie w poziomie lub w pionie wyłącza w danym uruchomieniu zapisane inteligentne kadrowanie i wykrywanie twarzy. Aby zamiast tego użyć kadrowania z uwzględnieniem treści, jawnie wybierz inteligentne kadrowanie.

| Pozycja menu | Następny krok |
| --- | --- |
| **Crop Selected Images → Crop to Fill…** | Wpisz Name, Width (px), Height (px) |
| **Crop Selected Images → Fit Inside…** | Wpisz Name, Width (px), Height (px) |
| **Crop Selected Images → Content-aware Crop…** | Wpisz Name, Width (px), Height (px) |
| **Crop Selected Images → Crop Selected Images (Custom Settings…)** | Wpisz Name, Width (px), Height (px), Format (opcjonalnie), Image fit (opcjonalnie), Horizontal alignment (opcjonalnie), Vertical alignment (opcjonalnie), Content-aware cropping (opcjonalnie) |

## Szczegółowa edycja {#detailed-editing}

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 HyperCrop {#hypercrop-actions}

| Akcja | Co robi | Target |
| --- | --- | --- |
| [`crop`](#crop) | Przycina zaznaczone warstwy do nazwanych rozmiarów i pobiera plik ZIP | Co najmniej jedna kwalifikująca się warstwa |

### crop {#crop}

Przycina zaznaczone warstwy do nazwanych rozmiarów i pobiera plik ZIP. Zaznacz co najmniej jedną kwalifikującą się warstwę.

| Opcja | Typ | Obowiązkowa / domyślna | Znaczenie i dozwolone wartości |
| --- | --- | --- | --- |
| `name` | string | Obowiązkowa | Nazwa nowego elementu. Minimum 1 znak; maksimum 120 znaków |
| `width` | number | Obowiązkowa | Szerokość w pikselach. Minimum 1; maksimum 8192 |
| `height` | number | Obowiązkowa | Wysokość w pikselach. Minimum 1; maksimum 8192 |
| `format` | string | Wartość zastępcza: `"jpg"` | Format obrazu. `jpg`, `png` |
| `fill` | string | Wartość zastępcza: `"cover"` | Przytnij lub zmieść obraz źródłowy. `cover`, `contain` |
| `horizontal` | string | Wartość zastępcza: `"center"` | Wyrównanie w poziomie. `left`, `center`, `right` |
| `vertical` | string | Wartość zastępcza: `"center"` | Wyrównanie w pionie. `top`, `center`, `bottom` |
| `smart` | boolean | Wartość zastępcza: `false` | Użyj kadrowania z uwzględnieniem treści bez wykrywania twarzy |

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 **Crop Selected Images (Custom Settings…)**. Wypełnij te zwykłe pola; JSON nie jest potrzebny:

- **Name**: `Square`
- **Width (px)**: `1080`
- **Height (px)**: `1080`
- **Format**: **JPG Image**
- **Image fit**: **Crop to Fill**
- **Horizontal alignment**: **Centre**
- **Vertical alignment**: **Centre**
- **Content-aware cropping**: **Use Alignment**

Dane wejściowe dla hosta agenta

```json
{"command":"shortcut-crop","parameters":{"name":"Square","width":"1080","height":"1080","format":"jpg","fill":"cover","horizontal":"center","vertical":"center","smart":"false"}}
```

## Korzystanie ze skrótów przez agenta {#using-shortcuts-with-an-agent}

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 {#troubleshooting}

| 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](/automation/parameters/hypercrop.json) zawiera te same identyfikatory akcji i definicje opcji.

## Obecne ograniczenia {#current-limits}

Skróty kadrowania eksportują zaznaczone obrazy w jednym nazwanym rozmiarze. Format, wyrównanie i inne szczegółowe wybory ustawisz w Custom Settings; rozmiary kadrowania wielokrotnego użytku zapisuj w zwykłym panelu.

## Powiązana dokumentacja {#related-documentation}

- [Instalacja i uruchamianie HyperCrop](/pl/hypercrop/overview/install)
- [Parametry wtyczek Figmy](https://developers.figma.com/docs/plugins/plugin-parameters/)
- [Opcje ukrytego interfejsu w Figmie](https://developers.figma.com/docs/plugins/api/properties/figma-showui/)