플러그인 패널을 열지 않고도 Figma Quick Actions에서 자주 쓰는 HyperCrop 작업을 실행할 수 있어요. 아래에서 이름이 붙은 바로가기를 고르세요. 자세한 설정과 작성 작업에는 일반 플러그인 패널을 사용하세요.

Quick Action 실행

모든 바로가기는 확인된 유효한 라이선스나 남은 체험 횟수가 있어야 실행돼요. 확인에 실패했거나 체험 횟수를 모두 사용했다면 일반 플러그인 패널을 열어 라이선스를 활성화하세요. 패널은 언제든 열 수 있어요.

1. 바로가기가 선택 항목을 사용한다면 작업할 레이어를 선택하세요.
2. Mac에서는 Command + /, Windows에서는 Ctrl + / 단축키로 Figma Quick Actions를 여세요.
3. 플러그인을 검색하고 아래에 있는 이름의 바로가기를 고르세요.
4. 표시된 필드를 입력하세요. 선택 사항 필드는 건너뛰어도 되고, Tab 키로 편집할 수 있어요. 바로가기를 실행한 뒤 결과를 확인하거나 저장 대화 상자를 완료하세요.

생성 바로가기는 이름이나 크기를 직접 물어봐요. 선택한 레이어용 바로가기는 현재 선택 항목을 자동으로 사용해요. 이런 일상적인 바로가기는 Target이나 JSON을 묻지 않아요. 일반 플러그인 패널을 열려면 Open HyperCrop을 고르세요.

바로가기	입력
Crop Selected Images (Custom Settings…)	Name, Width (px), Height (px), Format(선택 사항), Image fit(선택 사항), Horizontal alignment(선택 사항), Vertical alignment(선택 사항), Content-aware cropping(선택 사항)

선택지가 정해진 필드는 읽기 쉬운 레이블을 사용해요. 표시된 레이블이나 실제 값으로 검색할 수 있으며, 에이전트 입력에는 계속 명령 레퍼런스에 표시된 값을 사용해요.

Crop to Fill…, Fit Inside…, Content-aware Crop… 중 하나를 고르고 출력 이름과 크기를 입력하세요. Crop to Fill과 Fit Inside는 이어받은 콘텐츠 인식/얼굴 기준 위치 지정을 끄고, Content-aware Crop은 Fit Inside가 저장되어 있어도 Crop to Fill을 선택해요. Custom Settings에서는 Crop to Fill / Fit Inside, 가로·세로 정렬, 콘텐츠 인식 자르기를 설정할 수 있어요. 정렬을 직접 지정하면 이어받은 스마트/얼굴 자르기가 꺼지고, 콘텐츠 인식 자르기를 직접 선택하면 정렬보다 우선해요.

컨텍스트 메뉴에서 실행

원하는 레이어를 선택하고 마우스 오른쪽 버튼을 클릭한 뒤 Plugins → HyperCrop 메뉴를 고르세요(개발 중인 플러그인은 Development 아래에 표시돼요). 작업을 고르고 형식이나 프리셋을 선택하세요. 필수 입력이 없는 프리셋은 바로 실행돼요. 저장 대화 상자가 나타나면 완료하세요.

각 프리셋은 이름에 해당하는 옵션을 설정해요. 생략한 호환 옵션은 플러그인에 저장된 설정을 이어받고, 명시적으로 지정한 작업이나 옵션은 충돌하는 저장 동작보다 우선해요. 해당 실행에서는 직접 입력한 필드나 선택한 메뉴 항목만 저장된 설정을 덮어써요. 한 번도 저장한 적이 없는 설정에는 일반 설정이나 문서에 안내된 대체값이 적용돼요. 내보내기 재정의 값은 환경설정에 다시 저장되지 않아요. 저장된 형식을 바로가기로 사용할 수 없다면 지원되는 형식을 직접 고르거나 일반 패널을 사용하세요. 여러 옵션을 함께 쓰려면 작업 안에서 Custom Settings… 항목을 고르고 매개변수를 입력하세요. 텍스트, URL, 이름, 크기가 필요한 작업은 여전히 해당 필수 필드를 입력하라고 요청해요. Open HyperCrop은 일반 패널을 열어요.

가로 또는 세로 정렬을 직접 지정하면 해당 실행에서는 저장된 스마트 자르기와 얼굴 인식이 꺼져요. 대신 콘텐츠 인식 자르기를 사용하려면 스마트 자르기를 직접 요청하세요.

메뉴 항목	다음 단계
Crop Selected Images → Crop to Fill…	Name, Width (px), Height (px) 입력
Crop Selected Images → Fit Inside…	Name, Width (px), Height (px) 입력
Crop Selected Images → Content-aware Crop…	Name, Width (px), Height (px) 입력
Crop Selected Images → Crop Selected Images (Custom Settings…)	Name, Width (px), Height (px), Format(선택 사항), Image fit(선택 사항), Horizontal alignment(선택 사항), Vertical alignment(선택 사항), Content-aware cropping(선택 사항) 입력

세부 편집

자세한 설정, 긴 콘텐츠, 일괄 작성, 컴포넌트나 템플릿 둘러보기에는 일반 플러그인 패널을 사용하세요. 바로가기 메뉴에는 위에 나열한 일상적인 명령만 있어요.

붙여 넣는 필드는 각각 150자 미만으로 유지하세요. Figma 데스크톱 앱은 붙여 넣은 입력을 이 길이에서 잘라 낼 수 있어요. 더 긴 입력은 일반 패널에서 처리하세요.

이전 버전의 플러그인에 Action, Target, Options가 대신 표시된다면 플러그인을 업데이트해 이름이 붙은 바로가기를 사용하세요. Target 값은 레이어 ID나 선택 항목이며, 새 항목의 이름이 아니에요.

HyperCrop 작업

작업	기능	Target
crop	선택한 레이어를 지정한 크기로 자르고 ZIP 다운로드	조건에 맞는 레이어 하나 이상

crop

선택한 레이어를 지정한 크기로 자르고 ZIP 파일로 다운로드해요. 조건에 맞는 레이어를 하나 이상 선택하세요.

옵션	유형	필수 여부 / 기본값	의미와 허용 값
name	string	필수	새 항목의 이름. 최소 1자, 최대 120자
width	number	필수	픽셀 단위 너비. 최소 1, 최대 8192
height	number	필수	픽셀 단위 높이. 최소 1, 최대 8192
format	string	대체값: "jpg"	이미지 형식. jpg, png
fill	string	대체값: "cover"	원본을 잘라 채우거나 안에 맞춤. cover, contain
horizontal	string	대체값: "center"	가로 정렬. left, center, right
vertical	string	대체값: "center"	세로 정렬. top, center, bottom
smart	boolean	대체값: false	얼굴 인식 없이 콘텐츠 인식 자르기 사용

중첩된 필수 필드는 상위 객체나 배열 항목을 입력했을 때 적용돼요. 생략한 선택 사항 값은 기본값이 표시되어 있지 않다면 기존 작업의 동작을 따라요.

Crop Selected Images (Custom Settings…) 바로가기를 고르세요. 다음 일반 필드를 입력하면 되고, 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

에이전트 호스트 입력

{"command":"shortcut-crop","parameters":{"name":"Square","width":"1080","height":"1080","format":"jpg","fill":"cover","horizontal":"center","vertical":"center","smart":"false"}}

에이전트와 함께 바로가기 사용

아래에 링크된 기계 판독용 레지스트리를 읽고, 설치된 플러그인의 Quick Actions 목록에 있는 작업을 고르세요. 레지스트리는 표준 JSON Schema가 아니라 Hypermatic 옵션 정의를 사용해요. min과 max는 필드 유형에 따라 문자열 길이, 배열 길이 또는 숫자 값을 제한하고, 중첩된 정의에는 fields와 item을 사용해요. 알 수 없는 필드는 거부돼요.

에이전트에는 Figma Quick Actions를 호출하고 일반 플러그인 결과를 확인할 수 있는 호스트가 필요해요. 매개변수가 REST나 MCP 실행기를 추가하지는 않아요. 펼쳐 볼 수 있는 예시는 호환 호스트용 입력 데이터이며, 실행 가능한 API 호출이 아니에요. 바로가기 입력은 숫자와 형식 선택을 포함해 parameters에 일반 문자열로 넣어요. 준비된 입력만으로 바로가기가 실행되었다고 주장하면 안 돼요.

눈에 보이는 결과를 확인하세요. 변경된 Figma 레이어, 저장된 내보내기 파일, 게시된 페이지를 확인하면 돼요. 일반 성공·오류 알림과 일부만 내보내졌다는 경고가 있는지도 읽어 보세요. 필요하면 기본 저장 대화 상자를 완료하세요. 다운로드가 시작되었다고 해서 파일이 저장되었다는 뜻은 아니에요. 사용자가 개발자 도구를 열거나 콘솔을 읽을 필요는 없어요.

문제 해결

증상	다음 단계
작업을 사용할 수 없어요	플러그인을 업데이트하고 Quick Actions 목록을 확인하세요. 작업을 사용할 수 없다면 일반 패널을 사용하세요.
옵션이 유효하지 않거나 잘렸을 수 있어요	해당 바로가기가 허용하는 필드만 사용하고, 각 필드 값은 150자 미만의 일반 값으로 입력하세요.
Target이 없거나 조건에 맞지 않아요	올바른 페이지를 열고 작업의 레이어 요구 사항을 확인한 뒤 원하는 레이어를 다시 선택하세요.
라이선스나 체험 오류가 표시돼요	다시 실행하기 전에 플러그인의 일반 활성화 절차를 완료하세요.
다운로드를 요청했지만 저장된 파일이 보이지 않아요	기본 저장 대화 상자와 다운로드 위치를 확인하세요. 실제 파일을 열어 확인하세요.
명령이 실패했거나, 시간이 초과되었거나, 취소되었어요	다시 시도하기 전에 문서와 원격 대상을 확인하세요. 앞서 적용된 변경이나 업로드가 이미 있을 수 있어요.

명령의 제한 시간은 5분이에요. 오류가 발생해도 모든 변경이 되돌려지는 것은 아니에요. 생성, 교체, 업로드를 자동으로 다시 시도하면 작업이 중복되거나 덮어써질 수 있어요.

기계 판독용 명령 레지스트리에는 같은 작업 ID와 옵션 정의가 들어 있어요.

현재 제한 사항

자르기 바로가기는 선택한 이미지를 지정한 크기 하나로 내보내요. 형식, 정렬 등 세부 선택은 Custom Settings를 사용하고, 재사용할 자르기 크기는 일반 패널에서 저장하세요.

관련 문서

• HyperCrop 설치 및 실행
• Figma 플러그인 매개변수(영어)
• Figma 숨김 UI 옵션(영어)