---
url: "/de/pixelay/automation/parameters.md"
description: "Führ Quick Actions von Pixelay mit einfachen benannten Eingaben und Kürzeln für die aktuelle Auswahl aus."
---

# Quick Actions von Pixelay

> Führ Quick Actions von Pixelay mit einfachen benannten Eingaben und Kürzeln für die aktuelle Auswahl aus.

Führ häufige Aufgaben von Pixelay über die Quick Actions von Figma aus, ohne das Plugin-Panel zu öffnen. Wähle unten ein benanntes Kürzel. Für detaillierte Einstellungen und das Erstellen von Inhalten nutzt du das normale Plugin-Panel.

## Eine Quick Action ausführen {#run-a-quick-action}

Jedes Kürzel setzt eine bestätigte gültige Lizenz oder verbleibende Testläufe voraus. Schlägt die Prüfung fehl oder sind deine Testläufe abgelaufen, öffne das normale Plugin-Panel, um deine Lizenz zu aktivieren. Das Panel lässt sich weiterhin öffnen.

1. Wähle die Ebenen aus, mit denen du arbeiten willst, falls das Kürzel eine Auswahl verwendet.
2. Öffne die Quick Actions von Figma mit **Command + /** unter macOS oder **Ctrl + /** unter Windows.
3. Such nach dem Plugin und wähle das unten genannte Kürzel.
4. Füll die angezeigten Felder aus. Optionale Felder kannst du überspringen; mit der Tab-Taste bearbeitest du sie. Führ das Kürzel aus und prüf das Ergebnis oder schließ den Speichern-Dialog ab.

Kürzel zum Erstellen fragen Namen oder Abmessungen direkt ab. Kürzel für ausgewählte Ebenen verwenden automatisch die aktuelle Auswahl. Diese alltäglichen Kürzel fragen weder Target noch JSON ab. Wähle **Open Pixelay**, um das normale Plugin-Panel zu öffnen.

| Kürzel | Eingaben |
| --- | --- |
| **Upload Selected Comparisons** | Keine; läuft sofort |

Felder mit fester Auswahl zeigen gut lesbare Bezeichnungen. Du kannst nach der angezeigten Bezeichnung oder nach dem zugrunde liegenden Wert suchen; Eingaben von Agenten verwenden weiterhin die Werte aus der Befehlsreferenz.

Richte die URLs der ausgewählten Frames und die seitenweite Basis-URL im normalen Panel ein, bevor du **Upload Selected Comparisons** verwendest.

## Über das Kontextmenü ausführen {#run-from-the-context-menu}

Wähle die gewünschten Ebenen aus, klick mit der rechten Maustaste und wähle **Plugins → Pixelay** (Plugins in Entwicklung stehen unter **Development**). Wähle eine Aktion und ihr Format oder Preset. Ein Preset läuft sofort, wenn es keine Pflichteingabe braucht; schließ den Speichern-Dialog ab, falls er erscheint.

Jedes Preset setzt seine benannte Option. Nicht angegebene kompatible Optionen übernehmen die gespeicherten Einstellungen des Plugins; eine explizit gewählte Aktion oder Option hat Vorrang vor widersprüchlichem gespeichertem Verhalten. Nur ausdrücklich eingegebene Felder oder der gewählte Menüeintrag überschreiben sie für diesen Durchlauf. Wurde eine Einstellung noch nie gespeichert, gilt die normale Einstellung oder der dokumentierte Fallback. Überschreibungen beim Export werden nicht in deine Einstellungen zurückgespeichert. Ist ein gespeichertes Format nicht als Kürzel verfügbar, wähle ausdrücklich ein unterstütztes Format oder nutze das normale Panel. Um Optionen zu kombinieren, wähle innerhalb der Aktion **Custom Settings…** und gib die Parameter ein. Aktionen, die Text, URLs, Namen oder Abmessungen brauchen, fragen diese Pflichtfelder weiterhin ab. **Open Pixelay** öffnet das normale Panel.

| Menüeintrag | Nächster Schritt |
| --- | --- |
| **Upload Selected Comparisons** | Läuft sofort |

## Detaillierte Bearbeitung {#detailed-editing}

Für detaillierte Einstellungen, längere Inhalte, das Erstellen vieler Inhalte auf einmal und das Durchsuchen von Komponenten oder Vorlagen nutzt du das normale Plugin-Panel. Das Kürzelmenü enthält nur die oben aufgeführten alltäglichen Befehle.

Halte jedes eingefügte Feld unter 150 Zeichen: Die Figma-Desktop-App kann eingefügte Eingaben an dieser Grenze abschneiden. Längere Eingaben gehören ins normale Panel.

Zeigt ein älteres Plugin stattdessen Action, Target und Options an, aktualisiere es, um diese benannten Kürzel zu nutzen. Ein Target-Wert ist eine Ebenen-ID oder eine Auswahl, nie der Name eines neuen Elements.

## Aktionen von Pixelay {#pixelay-actions}

| Aktion | Was sie tut | Target |
| --- | --- | --- |
| [`publish`](#publish) | Lädt ausgewählte Frames mit den gespeicherten Vergleichs-URLs hoch | Eine oder mehrere geeignete Ebenen |

### publish {#publish}

Lädt ausgewählte Frames mit den gespeicherten Vergleichs-URLs hoch. Wähle eine oder mehrere geeignete Ebenen aus.

Dieses Kürzel hat keine Eingabefelder.

Dies ist ein ausdrücklicher externer Schreibvorgang bei den bestehenden Hypermatic-Diensten des Plugins. Er verwendet die gespeicherte Kontoeinrichtung und kann über den bestehenden Ablauf ein Konto erstellen. Wiederhole den Vorgang nach einem Upload-Fehler nicht automatisch; prüf das entfernte Ziel auf unvollständige Ergebnisse.

Wähle **Upload Selected Comparisons**. Das Kürzel läuft sofort mit der aktuellen Auswahl.

Eingabe für den Agent-Host

```json
{"command":"shortcut-publish","parameters":{}}
```

## Kürzel mit einem Agenten nutzen {#using-shortcuts-with-an-agent}

Lies die unten verlinkte maschinenlesbare Registry und wähle eine Aktion, die in der Quick-Actions-Liste des installierten Plugins angeboten wird. Die Registry nutzt die Optionsdefinitionen von Hypermatic statt Standard-JSON-Schema: `min` und `max` begrenzen je nach Feldtyp die Länge eines Strings, die Länge eines Arrays oder einen Zahlenwert; verschachtelte Definitionen verwenden `fields` und `item`. Unbekannte Felder werden abgelehnt.

Der Agent braucht einen Host, der Quick Actions von Figma aufrufen und das normale Ergebnis des Plugins beobachten kann. Parameter bieten keinen REST- oder MCP-Starter. Die aufklappbaren Beispiele sind Eingabedaten für einen kompatiblen Host, keine ausführbaren API-Aufrufe; Kürzeleingaben verwenden in `parameters` einfache Strings, auch für Zahlen und Formatauswahlen. Behaupte nie, ein Kürzel sei allein aufgrund seiner vorbereiteten Eingabe ausgeführt worden.

Prüf das sichtbare Ergebnis: die geänderten Figma-Ebenen, den gespeicherten Export oder die veröffentlichte Seite. Lies die normale Erfolgs- oder Fehlermeldung und eventuelle Warnungen zu einem unvollständigen Export. Schließ native Speichern-Dialoge nach Bedarf ab; dass ein Download startet, beweist nicht, dass die Datei gespeichert wurde. Nutzer müssen weder die Entwicklertools öffnen noch eine Konsole lesen.

## Fehlerbehebung {#troubleshooting}

| Symptom | Nächster Schritt |
| --- | --- |
| Aktion ist nicht verfügbar | Aktualisiere das Plugin und prüf seine Quick-Actions-Liste; ist die Aktion nicht verfügbar, nutze das normale Panel. |
| Optionen sind ungültig oder wurden möglicherweise abgeschnitten | Verwende einzelne einfache Feldwerte unter 150 Zeichen und nur Felder, die dieses Kürzel akzeptiert. |
| Target fehlt oder ist nicht geeignet | Öffne die richtige Seite, prüf die Ebenenanforderungen der Aktion und wähle die gewünschten Ebenen erneut aus. |
| Ein Lizenz- oder Testlauf-Fehler erscheint | Schließ die normale Aktivierung des Plugins ab, bevor du erneut ausführst. |
| Ein Download wurde angefordert, aber keine gespeicherte Datei ist zu sehen | Prüf den nativen Speichern-Dialog und den Download-Ordner. Sieh dir die tatsächliche Datei an. |
| Ein Befehl schlägt fehl, überschreitet das Zeitlimit oder wird abgebrochen | Prüf das Dokument und das entfernte Ziel, bevor du es erneut versuchst; frühere Änderungen oder Uploads sind eventuell schon vorhanden. |

Befehle haben ein Zeitlimit von fünf Minuten. Fehler bedeuten kein vollständiges Zurücksetzen. Wenn du das Erstellen, Ersetzen oder Hochladen automatisch wiederholst, kann Arbeit doppelt entstehen oder überschrieben werden.

Die [maschinenlesbare Befehls-Registry](/automation/parameters/pixelay.json) enthält dieselben Aktions-IDs und Optionsdefinitionen.

## Aktuelle Grenzen {#current-limits}

Publish nutzt die bestehende Kontoeinrichtung und Upload-Funktion; es kann ein Konto erstellen und ersetzt den gespeicherten Vergleich durch die ausgewählten Frames. Configure speichert nur lokale URL-Zuordnungen. Die Basis-URL der Website muss vor dem Veröffentlichen eingerichtet sein.

## Weiterführende Dokumentation {#related-documentation}

- [Pixelay installieren und ausführen](/de/pixelay/overview/install)
- [Plugin-Parameter in Figma](https://developers.figma.com/docs/plugins/plugin-parameters/)
- [Optionen für verborgene UI in Figma](https://developers.figma.com/docs/plugins/api/properties/figma-showui/)