플러그인 설치: 설치 또는 업데이트 명령 전에 이 스킬이 HyperFrames 플러그인 내부에 있는 경우 플러그인 실행 규칙을 따르세요. 독립 실행형 설치는 아래 업데이트 지침을 유지합니다.
media-use
HyperFrames를 위한 미디어 OS: resolve · generate · operate · remember — 모든 미디어 유형, 하나의 스킬, 컨텍스트 노이즈 제로
환경 변수에 HEYGEN_API_BASE가 설정된 경우(호스트 앱이 설정하고 자체 키로 HeyGen 비용을 지불하는 경우): HeyGen 미디어는 이미 유료입니다. 사용자에게 heygen CLI를 설치하거나 로그인하도록 요청하지 말고, OAuth 허용량을 제안하지 마세요. 카탈로그 검색, TTS 및 아바타 호출은 여기서 호스트를 통해 이루어집니다. 동일한 호스트가 자체 HeyGen 도구도 제공하는 경우, 해당 도구를 먼저 사용하세요. 호스트를 통한 호출이 거부되면 사용자에게 호스트의 메시지를 그대로 전달하고(수정 방법을 명시함, 예: 앱 설정에서 키 추가 또는 교체) 중단하세요. 사용자가 요청하지 않는 한 다른 제공자로 전환하지 마세요.
그 외의 첫 실행 시(HEYGEN_API_BASE 없음), HeyGen 미디어(카탈로그 검색, TTS, 아바타 비디오)를 사용하는 경우: heygen CLI를 설치하고 로그인한 다음(무료 사용 경로), npx hyperframes media-use resolve --doctor로 확인하세요. 설정 및 제공자: references/setup-providers.md.
호스트 앱 내부의 음악 및 음향 효과: 실행 중인 앱이 자체 음악 또는 음향 효과 도구를 제공하는 경우 해당 도구를 사용하세요. HEYGEN_API_BASE 없이 resolve --type bgm 및 --type sfx는 heygen CLI를 통해 HeyGen 카탈로그를 검색합니다. 없으면 실패하고 그렇게 알립니다(sfx는 번들 라이브러리에서 여전히 응답합니다).
HEYGEN_API_BASE 없이, 음성 해설 또는 아바타 비디오를 생성하기 전에 사용자에게 알리세요: OAuth로 heygen CLI에 로그인하면(heygen auth login --oauth) TTS 음성 해설 및 아바타 비디오에 대한 무료 허용량이 제공되며, API 키는 API 크레딧을 청구합니다.
Resolve — 하나의 동사
npx hyperframes media-use resolve --type <type> --intent "<description>" --project <dir>
한 줄 반환: resolved <id> → <path> (<type>, <metadata>). 모든 검색 노이즈는 디스크에 남습니다.
| 유형 | 한 줄 의도 |
|---|---|
bgm | 배경 음악 (heygen CLI를 통한 HeyGen 카탈로그, 10,000+ 트랙) |
sfx | 음향 효과 (번들 19개 파일 라이브러리 + heygen CLI를 통한 카탈로그) |
image | 사진, 배경 (HeyGen 자산 검색, 75,000+ 벡터) |
icon | 아이콘, 기호 (투명) |
logo | 공식 브랜드 마크 (theSVG → GitHub 아바타 → 파비콘; 절대 다시 그리지 않음) |
voice | TTS 음성 해설 (HeyGen 무료 사용 경로; 선택적 로컬 Kokoro) |
grade | 측정된 보정 후보; 광범위한 광택/스타일화는 Media Treatments 따름 |
lut | 사용자 제공 또는 명시적으로 선택된 재사용 가능한 검증된 .cube 파일 |
새로 resolve하기 전에 --candidates로 재사용 가능한 후보를 나열하고 직접 적합성을 판단하세요 — 재사용 규칙, 모든 플래그, 수집(--from), 및 채택은 references/resolve.md에 있습니다.
광범위한 시각적 피드백을 미디어 의도로 처리
사용자가 사진 미디어를 수정, 광택, 스타일화, 가리기, 강조 또는 공개하도록 명시적으로 요청하면, 컬러 그레이딩이나 효과를 언급하지 않더라도 references/media-treatments.md를 읽으세요. 실제 <img>/<video>를 검사하고, 하나의 기본 의도를 선택한 다음, 결정론적 지속성 및 검증을 사용하세요. 일치하는 레시피를 선택적 테스트 시드로 사용하거나 hyperframes media-treatment --capabilities --json을 검사한 후, 관련 패밀리/효과 하나를 --capability <id>로 요청하고 정식 컨트롤에서 사용자 정의 처리를 조립하세요. 일반 저작을 위해 --all을 로드하지 마세요. 처리는 보정, 프리셋, 마무리, 호환되는 셰이더 효과, 지원되는 키프레임 및 선택적 Registry 오버레이를 구성할 수 있습니다. 소스에서 정당화된 제한된 튜닝과 호환되는 부분만 추가하고, 결과를 더 정교하게 보이게 하기 위한 효과만 추가하지 마세요. 최종 결합된 페이로드를 hyperframes media-treatment로 지속하세요.
점진적으로 확대되는 하나의 워크플로우를 사용하세요. 비디오의 경우, 프레임을 개별적으로 읽기보다는 레이블이 지정된 초기/중간/후반 접촉 시트 하나를 검사하세요. 일반 보정 또는 광택을 위해 후보 하나를 적용하고 후속 시트를 검사하세요. 결과가 모호하거나, 시간적이거나, 스타일화되거나, LUT 기반이거나, HDR/LOG에 민감하거나, 개인 정보이거나, 브랜드에 중요한 경우에만 개별 프레임 또는 움직이는 드래프트 증거로 확대하세요.
일반 보정 또는 광택의 경우 최종 처리의 프리셋/조정 JSON을 지속하세요.
노출, 그림자, 대비 또는 따뜻함만 인코딩하기 위해 .cube LUT를 생성하지 마세요. 사용자가 LUT를 제공하거나 선택한 처리가 명시적으로 LUT를 소유하는 경우에만 LUT를 사용하세요. resolve --type grade --for ... --analyze는 측정 증거이며, 선택한 처리를 생성된 LUT로 대체할 수 있는 권한이 아닙니다. 지원되는 비네트, 그레인, 블러, 픽셀화, 색상 또는 처리 효과를 CSS/SVG 오버레이로 재생성하지 마세요. 이는 Studio 컨트롤과 정식 미리보기/렌더링 셰이더 경로를 우회합니다.
능동적으로 행동하세요 — 미디어 기회 검사를 실행하세요
사용자는 일반적으로 어떤 미디어가 작품을 향상시킬지 알 수 없습니다. 당신은 알 수 있습니다. 구성을 빌드하거나 검토할 때 하나의 근거 있는 검사를 수행한 다음 한 번만 물어보세요 — 조용히 추가하지 말고, 자산당 귀찮게 하지 마세요.
구체적인 신호가 있을 때만 기회를 표면화하세요:
| 감지된 신호 | 제안 |
|---|---|
| 화면상의 텍스트 / 음성 해설 없는 스크립트 | TTS 음성 해설 (오디오 엔진) |
이모지 또는 아이콘으로 스타일링된 <div> | 실제 icon resolve |
| 플레이스홀더, 작거나 업스케일된 이미지 | 더 나은 image (및/또는 업스케일 — references/operations.md 참조) |
| 소리 없는 하드 장면 컷 / 전환 | 전환 sfx |
| 음악 없이 ~10초 이상의 조각 | bgm |
| 노출 부족/과다 또는 색조가 있는 영상 | 교정 그레이드 (hyperframes media-treatment --selector '#hero' --analyze --json으로 검사) |
| 시각적으로 평평하거나 주제와 맞지 않는 사진 미디어 | 적절한 소스의 특정 프리셋 또는 사용자 정의 처리, 의도된 대상 명시 |
| 정적으로 느껴지는 의미 있는 미디어 등장/공개 | 하나의 지원되는 시크-세이프 처리 애니메이션; 요청이 프리셋도 정당화하지 않는 한 색상 유지 |
이것을 도움으로 유지하고 성가심으로 만들지 않는 규칙: 근거 있음, 일반적이지 않음(신호 없음 → 제안 없음); 의견이 명확하고 구체적임(기본값으로 특정 수정 제안 — 사용자가 전부 / 일부 / 없음 승인); 프로젝트당 한 번(하나의 통합된 요청; "그대로 둬" 존중); 표면화, 절대 조용히 변이하지 않음(특히 컬러 그레이드: 제안하고 미리보기 — 그레이월드 "보정"은 의도적인 일몰 또는 네온 모양을 망칩니다).
어디를 볼까 — 작업에 필요한 파일만 읽으세요
| 작업 | 읽을 파일 |
|---|---|
| resolve / reuse / adopt / ingest, 플래그, 계단식, 인벤토리 | references/resolve.md |
컬러 그레이딩, LUT, 스마트 그레이드 (--for), 그레이드 비교 | references/grading.md |
| 음성 해설 / TTS, 음악, SFX, 자막, 트랜스크립션 (오디오 엔진) | references/audio.md |
| 기존 미디어 자르기 / 프레임 변경 / 변환, 정확한 오류 확산, HEVC | references/operations.md |
| 소스 인지형 창의적 처리, 실시간 효과, 오버레이, 공개 | references/media-treatments.md |
설치 + 인증, 제공자 테이블, RAM 사다리, --local-only, --provider | references/setup-providers.md |
| 기억된 환경 설정 + 고정 레시피 (사용자 메모리) | references/memory.md |
| 소유권 매트릭스, 사용 통계, 텔레메트리, 프라이버시 (유지 관리자용) | references/meta.md |