Erledige häufige Crypto-Aufgaben über die Quick Actions von Figma, ohne das Plugin-Fenster zu öffnen. Wähle unten einen benannten Kurzbefehl. Für ausführliche Einstellungen und die Bearbeitung nutzt du das normale Plugin-Fenster.
Eine Quick Action ausführen
Jeder Kurzbefehl setzt eine verifizierte, gültige Lizenz oder verbleibende Testläufe voraus. Schlägt die Verifizierung fehl oder sind deine Testläufe abgelaufen, öffne das normale Plugin-Fenster, um deine Lizenz zu aktivieren. Das Fenster lässt sich weiterhin öffnen.
- Wähle die Ebenen aus, mit denen du arbeiten willst, falls der Kurzbefehl eine Auswahl nutzt.
- Öffne die Quick Actions von Figma mit Command + / auf dem Mac oder Ctrl + / unter Windows.
- Such nach dem Plugin und wähle unten den benannten Kurzbefehl.
- Fülle die angezeigten Felder aus. Optionale Felder kannst du überspringen; mit der Tabulatortaste bearbeitest du sie. Führe den Kurzbefehl aus und prüfe das Ergebnis oder schließ den Speichern-Dialog ab.
Kurzbefehle zum Erstellen fragen Namen oder Abmessungen direkt ab. Kurzbefehle für ausgewählte Ebenen nutzen automatisch die aktuelle Auswahl. Diese alltäglichen Kurzbefehle fragen weder Target noch JSON ab. Wähle Open Crypto, um das normale Plugin-Fenster zu öffnen.
| Kurzbefehl | Eingaben |
|---|---|
| Upload Selected Designs | Keine; wird sofort ausgeführt |
| Export Selected Designs as PDF (Custom Settings…) | Password protection (optional), PDF quality (optional) |
Felder mit festen Auswahlmöglichkeiten verwenden lesbare Beschriftungen. Du kannst nach der angezeigten Beschriftung oder dem zugrunde liegenden Wert suchen; Eingaben von Agenten verwenden weiterhin die Werte aus der Befehlsreferenz.
Über das Kontextmenü ausführen
Wähle die gewünschten Ebenen aus, klick mit der rechten Maustaste und wähle Plugins → Crypto (Entwicklungs-Plugins erscheinen unter Development). Wähle eine Aktion und ihr Format oder ihre Voreinstellung. Eine Voreinstellung wird sofort ausgeführt, wenn sie keine Pflichteingabe braucht; schließ den Speichern-Dialog ab, falls einer erscheint.
Jede Voreinstellung setzt ihre benannte Option. Weggelassene kompatible Optionen übernehmen die gespeicherten Einstellungen des Plugins; eine ausdrücklich gewählte Aktion oder Option hat Vorrang vor widersprüchlichem gespeichertem Verhalten. Nur ausdrücklich eingegebene Felder oder die gewählte Menüoption überschreiben sie für diesen Durchlauf. Wurde eine Einstellung nie gespeichert, gilt die normale Einstellung oder der dokumentierte Fallback. Export-Überschreibungen werden nicht in deine Einstellungen zurückgespeichert. Ist ein gespeichertes Format nicht als Kurzbefehl verfügbar, wähle ausdrücklich ein unterstütztes Format oder nutze das normale Fenster. 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 Crypto öffnet das normale Fenster.
| Menüoption | Nächster Schritt |
|---|---|
| Upload Selected Designs | Wird sofort ausgeführt |
| Export Selected Designs as PDF → Use Saved Settings | Wird sofort ausgeführt |
| Export Selected Designs as PDF → Export Selected Designs as PDF (Custom Settings…) | Password protection (optional) und PDF quality (optional) eingeben |
Ausführliche Bearbeitung
Nutze das normale Plugin-Fenster für ausführliche Einstellungen, längere Inhalte, die Bearbeitung in großen Mengen und das Durchsuchen von Komponenten oder Vorlagen. Das Kurzbefehlsmenü enthält nur die oben aufgeführten alltäglichen Befehle.
Halte jedes eingefügte Feld unter 150 Zeichen: Figma Desktop kann eingefügte Eingaben an dieser Grenze abschneiden. Längere Eingaben gehören ins normale Fenster.
Zeigt ein älteres Plugin stattdessen Action, Target und Options an, aktualisiere es, um diese benannten Kurzbefehle zu nutzen. Ein Target-Wert ist eine Ebenen-ID oder eine Auswahl, nie der Name eines neuen Elements.
Aktionen von Crypto
| Aktion | Was sie tut | Target |
|---|---|---|
publish | Lädt ausgewählte Frames als neue geschützte Designversion hoch | Eine oder mehrere geeignete Ebenen |
pdf | Exportiert ausgewählte Frames als PDF mit den gespeicherten Schutzeinstellungen | Eine oder mehrere geeignete Ebenen |
publish
Lädt ausgewählte Frames als neue geschützte Designversion hoch. Wähle eine oder mehrere geeignete Ebenen aus.
Dieser Kurzbefehl hat keine Eingabefelder.
Das ist ein ausdrücklicher externer Schreibvorgang in die bestehenden Hypermatic-Dienste des Plugins. Er nutzt die gespeicherte Kontoeinrichtung und kann über den bestehenden Workflow ein Konto erstellen. Wiederhole den Vorgang nach einem Upload-Fehler nicht automatisch; prüf am Remote-Ziel, ob dort schon Teilergebnisse liegen.
Wähle Upload Selected Designs. Der Kurzbefehl wird sofort mit der aktuellen Auswahl ausgeführt.
Eingabe für den Agent-Host
{"command":"shortcut-publish","parameters":{}}pdf
Exportiert ausgewählte Frames als PDF mit den gespeicherten Schutzeinstellungen. Wähle eine oder mehrere geeignete Ebenen aus.
| Option | Typ | Pflicht / Standard | Bedeutung und zulässige Werte |
|---|---|---|---|
protection | string | Fallback: "saved" | Ein zuvor gespeichertes Passwort verwenden oder ausdrücklich ohne Schutz exportieren. saved, none |
dpi | string | Fallback: "ebook" | Bestehende Voreinstellung für die PDF-Qualität. screen, ebook, printer, prepress, default |
Verschachtelte Pflichtfelder gelten, wenn ihr übergeordnetes Objekt oder Array-Element angegeben wird. Weggelassene optionale Werte folgen dem Verhalten des bestehenden Vorgangs, sofern kein Standard angegeben ist.
Wähle Export Selected Designs as PDF (Custom Settings…). Gib diese einfachen Felder ein; JSON ist nicht nötig:
- Password protection: Use Saved Password
- PDF quality: eBook (150 dpi)
Eingabe für den Agent-Host
{"command":"shortcut-pdf","parameters":{"protection":"saved","dpi":"ebook"}}Kurzbefehle mit einem Agenten nutzen
Lies das unten verlinkte maschinenlesbare Verzeichnis und wähle eine Aktion, die in der Quick-Actions-Liste des installierten Plugins angeboten wird. Das Verzeichnis nutzt Optionsdefinitionen von Hypermatic statt des Standards JSON Schema: min und max begrenzen je nach Feldtyp die Länge einer Zeichenkette, 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 in Figma aufrufen und das normale Ergebnis des Plugins beobachten kann. Parameter fügen keinen REST- oder MCP-Starter hinzu. Die ausklappbaren Beispiele sind Eingabedaten für einen kompatiblen Host, keine ausführbaren API-Aufrufe; Eingaben für Kurzbefehle verwenden in parameters einfache Zeichenketten, auch für Zahlen und Formatauswahlen. Behaupte nie, dass ein Kurzbefehl allein aufgrund seiner vorbereiteten Eingabe ausgeführt wurde.
Prüfe das sichtbare Ergebnis: die geänderten Figma-Ebenen, den gespeicherten Export oder die veröffentlichte Seite. Lies die normale Erfolgs- oder Fehlermeldung und jede Warnung zu einem unvollständigen Export. Schließ native Speichern-Dialoge bei Bedarf ab; ein gestarteter Download beweist nicht, dass die Datei gespeichert wurde. Nutzer müssen weder Entwicklertools öffnen noch eine Konsole lesen.
Fehlerbehebung
| Symptom | Nächster Schritt |
|---|---|
| Die Aktion ist nicht verfügbar | Aktualisiere das Plugin und prüfe seine Quick-Actions-Liste; nutze das normale Fenster, wenn die Aktion nicht verfügbar ist. |
| Optionen sind ungültig oder wurden womöglich abgeschnitten | Verwende einzelne, einfache Feldwerte unter 150 Zeichen und nur Felder, die dieser Kurzbefehl akzeptiert. |
| Target fehlt oder ist nicht geeignet | Öffne die richtige Seite, prüfe die Anforderungen der Aktion an die Ebenen und wähle die gewünschten Ebenen erneut aus. |
| Ein Lizenz- oder Testlauffehler erscheint | Schließ die normale Aktivierung des Plugins ab, bevor du den Befehl erneut ausführst. |
| Ein Download wurde angefordert, aber keine gespeicherte Datei ist zu sehen | Prüfe den nativen Speichern-Dialog und den Download-Speicherort. Sieh dir die tatsächliche Datei an. |
| Ein Befehl schlägt fehl, überschreitet das Zeitlimit oder wird abgebrochen | Prüfe das Dokument und das Remote-Ziel, bevor du es erneut versuchst; frühere Änderungen oder Uploads sind möglicherweise schon vorhanden. |
Befehle haben ein Zeitlimit von fünf Minuten. Fehler bedeuten kein vollständiges Rückgängigmachen. Ein automatisch wiederholtes Erstellen, Ersetzen oder Hochladen kann Arbeit duplizieren oder überschreiben.
Das maschinenlesbare Befehlsverzeichnis enthält dieselben Aktions-IDs und Optionsdefinitionen.
Aktuelle Grenzen
Publish erstellt mit der bestehenden Kontoeinrichtung und Upload-Funktion eine neue geschützte Designversion; dabei kann ein Remote-Konto entstehen. Das Veröffentlichen von Prototypen, Aktualisierungen bestehender Versionen und das Wechseln des Passworts bleiben interaktiv. Der PDF-Export nutzt den gespeicherten Passwortschutz-Status und die gespeicherte Qualität. Wählst du für protection den Wert none, ist der Schutz nur für diesen Export deaktiviert. Eine gespeicherte, aktivierte Schutzeinstellung setzt ihr gespeichertes Passwort voraus. Wählst du ausdrücklich Use Saved Password, ist ebenfalls ein gespeichertes Passwort nötig, und der Schutz ist für diesen Durchlauf aktiviert.