Ejecuta las tareas habituales de Crypto 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 Crypto para abrir el panel normal del plugin.
| Atajo | Campos |
|---|---|
| Upload Selected Designs | Ninguno; se ejecuta al instante |
| Export Selected Designs as PDF (Custom Settings…) | Protección con contraseña (opcional), calidad del PDF (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 → Crypto (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 Crypto abre el panel normal.
| Opción del menú | Siguiente paso |
|---|---|
| Upload Selected Designs | Se ejecuta al instante |
| Export Selected Designs as PDF → Use Saved Settings | Se ejecuta al instante |
| Export Selected Designs as PDF → Export Selected Designs as PDF (Custom Settings…) | Introduce Protección con contraseña (opcional) y Calidad del PDF (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 Crypto
| Acción | Qué hace | Target |
|---|---|---|
publish | Sube los frames seleccionados como una nueva versión de diseño protegida | Una o más capas válidas |
pdf | Exporta los frames seleccionados como PDF con los ajustes de protección guardados | Una o más capas válidas |
publish
Sube los frames seleccionados como una nueva versión de diseño protegida. Selecciona una o más capas válidas.
Este atajo no tiene campos.
Es una escritura externa explícita en los servicios de Hypermatic que el plugin ya usa. Reutiliza la configuración de cuenta guardada y puede crear una cuenta con el flujo de trabajo existente. No lo reintentes automáticamente después de un error de subida; comprueba si en el destino remoto hay resultados parciales.
Elige Upload Selected Designs. Se ejecuta al instante con la selección actual.
Entrada del host del agente
{"command":"shortcut-publish","parameters":{}}pdf
Exporta los frames seleccionados como PDF con los ajustes de protección guardados. Selecciona una o más capas válidas.
| Opción | Tipo | Obligatorio / valor por defecto | Significado y valores aceptados |
|---|---|---|---|
protection | string | Alternativa: "saved" | Usa una contraseña guardada antes o exporta explícitamente sin protección. saved, none |
dpi | string | Alternativa: "ebook" | Preajuste de calidad del PDF existente. screen, ebook, printer, prepress, default |
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 Designs as PDF (Custom Settings…). Introduce estos campos sencillos; no hace falta JSON:
- Password protection: Use Saved Password
- PDF quality: eBook (150 dpi)
Entrada del host del agente
{"command":"shortcut-pdf","parameters":{"protection":"saved","dpi":"ebook"}}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
Publish crea una nueva versión de diseño protegida con la configuración de cuenta y la función de subida existentes; puede crear una cuenta remota. La publicación de prototipos, las actualizaciones de versiones existentes y el cambio de contraseña siguen siendo interactivos. La exportación PDF usa el estado de protección con contraseña y la calidad guardados. Elegir la protección none desactiva la protección solo en esa exportación. Un ajuste de protección guardado y activado requiere su contraseña guardada. Elegir explícitamente Use Saved Password también requiere una contraseña guardada y activa la protección en esa ejecución.