Ejecuta las tareas habituales de CopyDoc desde las Quick Actions de Figma sin abrir el panel del plugin. Elige uno de los atajos con nombre que aparecen abajo. Usa el panel normal del plugin para los ajustes detallados y la creación de contenido.
Ejecutar una Quick Action
Todos los atajos requieren una licencia válida verificada o usos de prueba restantes. Si la verificación falla o se te han acabado los usos de prueba, abre el panel normal del plugin para activar tu licencia. El panel siempre se puede abrir.
- Selecciona las capas con las que quieres trabajar, si el atajo usa una selección.
- Abre las Quick Actions de Figma con Command + / en Mac o Ctrl + / en Windows.
- Busca el plugin y elige el atajo con nombre que aparece abajo.
- Rellena los campos que se muestran. Puedes saltarte los campos opcionales; usa el tabulador para editarlos. Ejecuta el atajo y comprueba el resultado o completa su cuadro de diálogo para guardar.
Los atajos de creación te piden nombres o dimensiones directamente. Los atajos de capas seleccionadas usan automáticamente la selección actual. Estos atajos del día a día no piden Target ni JSON. Elige Open CopyDoc para abrir el panel normal del plugin.
| Atajo | Campos |
|---|---|
| Export Selected Text (Custom Settings…) | Formato (opcional) |
Los campos de opciones fijas usan etiquetas legibles. Busca por la etiqueta que se muestra o por el valor subyacente; los campos para agentes siguen usando los valores que aparecen en la referencia de comandos.
Ejecutar desde el menú contextual
Selecciona las capas que quieras, haz clic derecho y elige Plugins → CopyDoc (los plugins en desarrollo aparecen en Development). Elige una acción y su formato o preajuste. Un preajuste se ejecuta al instante cuando no necesita ningún campo obligatorio; completa el cuadro de diálogo para guardar cuando aparezca.
Cada preajuste define la opción que indica su nombre. Las opciones compatibles que no indiques heredan los ajustes guardados del plugin; una acción u opción explícita tiene prioridad sobre el comportamiento guardado que entre en conflicto. Solo los campos que introduzcas explícitamente o la opción del menú que elijas los sustituyen en esa ejecución. Si un ajuste nunca se ha guardado, se aplica el ajuste normal o la alternativa documentada. Los cambios de exportación no se guardan en tus preferencias. Si un formato guardado no está disponible como atajo, elige explícitamente un formato compatible o usa el panel normal. Para combinar opciones, elige Custom Settings… dentro de la acción e introduce los parámetros. Las acciones que necesitan texto, URL, nombres o dimensiones siguen pidiendo esos campos obligatorios. Open CopyDoc abre el panel normal.
| Opción del menú | Siguiente paso |
|---|---|
| Export Selected Text → Use Saved Settings | Se ejecuta al instante |
| Export Selected Text → CSV Spreadsheet | Se ejecuta al instante |
| Export Selected Text → Excel Spreadsheet (.xlsx) | Se ejecuta al instante |
| Export Selected Text → JSON | Se ejecuta al instante |
| Export Selected Text → Markdown | Se ejecuta al instante |
| Export Selected Text → XLIFF 1.2 | Se ejecuta al instante |
| Export Selected Text → XLIFF 2.0 | Se ejecuta al instante |
| Export Selected Text → Export Selected Text (Custom Settings…) | Introduce Formato (opcional) |
Edición detallada
Usa el panel normal del plugin para los ajustes detallados, el contenido más largo, la creación en bloque y para explorar componentes o plantillas. El menú de atajos solo contiene los comandos del día a día que aparecen arriba.
Mantén cada campo pegado por debajo de 150 caracteres: la app de escritorio de Figma puede cortar el texto pegado a partir de ese límite. Los textos más largos van en el panel normal.
Si un plugin antiguo muestra Action, Target y Options en su lugar, actualízalo para usar estos atajos con nombre. Un valor de Target es un ID de capa o una selección, nunca el nombre de un elemento nuevo.
Acciones de CopyDoc
| Acción | Qué hace | Target |
|---|---|---|
export | Exporta el texto de los frames seleccionados | Una o más capas válidas |
export
Exporta el texto de los frames seleccionados. Selecciona una o más capas válidas.
| Opción | Tipo | Obligatorio / valor por defecto | Significado y valores aceptados |
|---|---|---|---|
format | string | Alternativa: "csv" | Formato de exportación del texto. csv, xlsx, json, markdown, xliff1, xliff2 |
Los campos obligatorios anidados se aplican cuando se incluye su objeto padre o el elemento de la matriz. Los valores opcionales que no indiques usan el comportamiento de la operación existente, salvo que se indique un valor por defecto.
Elige Export Selected Text (Custom Settings…). Introduce estos campos sencillos; no hace falta JSON:
- Format: CSV Spreadsheet
Entrada del host del agente
{"command":"shortcut-export","parameters":{"format":"csv"}}Usar los atajos con un agente
Lee el registro legible por máquina enlazado abajo y elige una acción que ofrezca la lista de Quick Actions del plugin instalado. El registro usa definiciones de opciones de Hypermatic en lugar del JSON Schema estándar: min y max limitan la longitud de la cadena, la longitud de la matriz o el valor numérico según el tipo de campo; las definiciones anidadas usan fields e item. Los campos desconocidos se rechazan.
El agente necesita un host que pueda invocar las Quick Actions de Figma y observar el resultado normal del plugin. Los parámetros no añaden ningún lanzador REST ni MCP. Los ejemplos desplegables son datos de entrada para un host compatible, no llamadas a una API ejecutables; los campos de los atajos usan cadenas sencillas en parameters, incluidos los números y las opciones de formato. Nunca afirmes que un atajo se ha ejecutado solo porque tienes preparada su entrada.
Verifica el resultado visible: las capas de Figma modificadas, la exportación guardada o la página publicada. Lee la notificación normal de éxito o error y cualquier aviso de exportación parcial. Completa los cuadros de diálogo nativos para guardar cuando haga falta; que empiece una descarga no demuestra que el archivo se haya guardado. Los usuarios no necesitan abrir las herramientas de desarrollo ni leer una consola.
Solución de problemas
| Síntoma | Siguiente paso |
|---|---|
| La acción no está disponible | Actualiza el plugin y revisa su lista de Quick Actions; usa el panel normal si la acción no está disponible. |
| Las opciones no son válidas o pueden haberse cortado | Usa valores de campo sencillos e individuales de menos de 150 caracteres, solo con los campos que acepta ese atajo. |
| Falta el Target o no es válido | Abre la página correcta, revisa los requisitos de capas de la acción y vuelve a seleccionar las capas que quieras. |
| Aparece un error de licencia o de prueba | Completa el proceso de activación normal del plugin antes de volver a ejecutarlo. |
| Se pidió una descarga, pero no ves ningún archivo guardado | Revisa el cuadro de diálogo nativo para guardar y la ubicación de descarga. Comprueba el archivo real. |
| Un comando falla, se agota el tiempo o se cancela | Revisa el documento y el destino remoto antes de reintentarlo; puede que ya existan cambios o subidas anteriores. |
Los comandos tienen un plazo de cinco minutos. Los errores no implican que se deshaga todo. Reintentar automáticamente una creación, una sustitución o una subida puede duplicar o sobrescribir el trabajo.
El registro de comandos legible por máquina contiene los mismos ID de acción y definiciones de opciones.
Límites actuales
Los atajos exportan el texto seleccionado. La sustitución de texto, la importación de traducciones, la sincronización de hojas de cálculo y el rellenado de componentes se hacen desde el panel normal.