Uruchamiaj typowe zadania CopyDoc 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 CopyDoc, aby otworzyć zwykły panel wtyczki.
| Skrót | Pola |
|---|---|
| Export Selected Text (Custom Settings…) | Format (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ń.
Uruchamianie z menu kontekstowego
Zaznacz odpowiednie warstwy, kliknij prawym przyciskiem myszy i wybierz Plugins → CopyDoc (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 CopyDoc otwiera zwykły panel.
| Pozycja menu | Następny krok |
|---|---|
| Export Selected Text → Use Saved Settings | Uruchamia się od razu |
| Export Selected Text → CSV Spreadsheet | Uruchamia się od razu |
| Export Selected Text → Excel Spreadsheet (.xlsx) | Uruchamia się od razu |
| Export Selected Text → JSON | Uruchamia się od razu |
| Export Selected Text → Markdown | Uruchamia się od razu |
| Export Selected Text → XLIFF 1.2 | Uruchamia się od razu |
| Export Selected Text → XLIFF 2.0 | Uruchamia się od razu |
| Export Selected Text → Export Selected Text (Custom Settings…) | Wpisz Format (opcjonalnie) |
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 CopyDoc
| Akcja | Co robi | Target |
|---|---|---|
export | Eksportuje tekst z zaznaczonych ramek | Co najmniej jedna kwalifikująca się warstwa |
export
Eksportuje tekst z zaznaczonych ramek. Zaznacz co najmniej jedną kwalifikującą się warstwę.
| Opcja | Typ | Obowiązkowa / domyślna | Znaczenie i dozwolone wartości |
|---|---|---|---|
format | string | Wartość zastępcza: "csv" | Format eksportu tekstu. csv, xlsx, json, markdown, xliff1, xliff2 |
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 Export Selected Text (Custom Settings…). Wypełnij te zwykłe pola; JSON nie jest potrzebny:
- Format: CSV Spreadsheet
Dane wejściowe dla hosta agenta
{"command":"shortcut-export","parameters":{"format":"csv"}}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
Skróty eksportują zaznaczony tekst. Zamiana tekstu, import tłumaczeń, synchronizacja arkuszy i wypełnianie komponentów odbywają się w zwykłym panelu.