Führ häufige Aufgaben von CopyDoc ü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
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.
- Wähle die Ebenen aus, mit denen du arbeiten willst, falls das Kürzel eine Auswahl verwendet.
- Öffne die Quick Actions von Figma mit Command + / unter macOS oder Ctrl + / unter Windows.
- Such nach dem Plugin und wähle das unten genannte Kürzel.
- 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 CopyDoc, um das normale Plugin-Panel zu öffnen.
| Kürzel | Eingaben |
|---|---|
| Export Selected Text (Custom Settings…) | Format (optional) |
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.
Über das Kontextmenü ausführen
Wähle die gewünschten Ebenen aus, klick mit der rechten Maustaste und wähle Plugins → CopyDoc (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 CopyDoc öffnet das normale Panel.
| Menüeintrag | Nächster Schritt |
|---|---|
| Export Selected Text → Use Saved Settings | Läuft sofort |
| Export Selected Text → CSV Spreadsheet | Läuft sofort |
| Export Selected Text → Excel Spreadsheet (.xlsx) | Läuft sofort |
| Export Selected Text → JSON | Läuft sofort |
| Export Selected Text → Markdown | Läuft sofort |
| Export Selected Text → XLIFF 1.2 | Läuft sofort |
| Export Selected Text → XLIFF 2.0 | Läuft sofort |
| Export Selected Text → Export Selected Text (Custom Settings…) | Format eingeben (optional) |
Detaillierte Bearbeitung
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 CopyDoc
| Aktion | Was sie tut | Target |
|---|---|---|
export | Exportiert Text aus ausgewählten Frames | Eine oder mehrere geeignete Ebenen |
export
Exportiert Text aus ausgewählten Frames. Wähle eine oder mehrere geeignete Ebenen aus.
| Option | Typ | Pflicht / Standard | Bedeutung und zulässige Werte |
|---|---|---|---|
format | string | Fallback: "csv" | Format für den Textexport. csv, xlsx, json, markdown, xliff1, xliff2 |
Verschachtelte Pflichtfelder gelten, wenn ihr übergeordnetes Objekt oder Array-Element angegeben ist. Nicht angegebene optionale Werte verwenden das bestehende Verhalten des Vorgangs, sofern kein Standardwert genannt ist.
Wähle Export Selected Text (Custom Settings…). Gib diese einfachen Felder ein; JSON ist nicht nötig:
- Format: CSV Spreadsheet
Eingabe für den Agent-Host
{"command":"shortcut-export","parameters":{"format":"csv"}}Kürzel mit einem Agenten nutzen
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
| 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 enthält dieselben Aktions-IDs und Optionsdefinitionen.
Aktuelle Grenzen
Kürzel exportieren ausgewählten Text. Textersetzung, Import von Übersetzungen, Tabellen-Synchronisierung und das Füllen von Komponenten laufen über das normale Panel.