Ejecuta las tareas habituales de HyperCrop 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 HyperCrop para abrir el panel normal del plugin.
| Atajo | Campos |
|---|---|
| Crop Selected Images (Custom Settings…) | Nombre, ancho (px), alto (px), formato (opcional), ajuste de imagen (opcional), alineación horizontal (opcional), alineación vertical (opcional), recorte inteligente (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.
Elige Crop to Fill…, Fit Inside… o Content-aware Crop… e introduce el nombre y las dimensiones de salida. Crop to Fill y Fit Inside desactivan el posicionamiento inteligente o por caras heredado; Content-aware Crop selecciona Crop to Fill aunque se haya guardado Fit Inside. Custom Settings muestra Crop to Fill / Fit Inside, la alineación horizontal y vertical y el recorte inteligente. Una alineación explícita desactiva el recorte inteligente o por caras heredado; elegir explícitamente el recorte inteligente tiene prioridad sobre la alineación.
Ejecutar desde el menú contextual
Selecciona las capas que quieras, haz clic derecho y elige Plugins → HyperCrop (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 HyperCrop abre el panel normal.
Una alineación horizontal o vertical explícita desactiva el recorte inteligente y la detección de caras guardados en esa ejecución. Si prefieres usar el recorte inteligente, pídelo explícitamente.
| Opción del menú | Siguiente paso |
|---|---|
| Crop Selected Images → Crop to Fill… | Introduce Nombre, Ancho (px) y Alto (px) |
| Crop Selected Images → Fit Inside… | Introduce Nombre, Ancho (px) y Alto (px) |
| Crop Selected Images → Content-aware Crop… | Introduce Nombre, Ancho (px) y Alto (px) |
| Crop Selected Images → Crop Selected Images (Custom Settings…) | Introduce Nombre, Ancho (px), Alto (px), Formato (opcional), Ajuste de imagen (opcional), Alineación horizontal (opcional), Alineación vertical (opcional) y Recorte inteligente (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 HyperCrop
| Acción | Qué hace | Target |
|---|---|---|
crop | Recorta las capas seleccionadas a tamaños con nombre y descarga un ZIP | Una o más capas válidas |
crop
Recorta las capas seleccionadas a tamaños con nombre y descarga un ZIP. Selecciona una o más capas válidas.
| Opción | Tipo | Obligatorio / valor por defecto | Significado y valores aceptados |
|---|---|---|---|
name | string | Obligatorio | Nombre del nuevo elemento. Mínimo 1 carácter; máximo 120 caracteres |
width | number | Obligatorio | Ancho en píxeles. Mínimo 1; máximo 8192 |
height | number | Obligatorio | Alto en píxeles. Mínimo 1; máximo 8192 |
format | string | Alternativa: "jpg" | Formato de imagen. jpg, png |
fill | string | Alternativa: "cover" | Recorta o encaja la imagen de origen. cover, contain |
horizontal | string | Alternativa: "center" | Alineación horizontal. left, center, right |
vertical | string | Alternativa: "center" | Alineación vertical. top, center, bottom |
smart | boolean | Alternativa: false | Usa el recorte inteligente sin detección de caras |
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 Crop Selected Images (Custom Settings…). Introduce estos campos sencillos; no hace falta JSON:
- Name:
Square - Width (px):
1080 - Height (px):
1080 - Format: JPG Image
- Image fit: Crop to Fill
- Horizontal alignment: Centre
- Vertical alignment: Centre
- Content-aware cropping: Use Alignment
Entrada del host del agente
{"command":"shortcut-crop","parameters":{"name":"Square","width":"1080","height":"1080","format":"jpg","fill":"cover","horizontal":"center","vertical":"center","smart":"false"}}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 de recorte exportan las imágenes seleccionadas a un único tamaño con nombre. El formato, la alineación y otras opciones detalladas se eligen en Custom Settings; guarda los tamaños de recorte reutilizables en el panel normal.