Three.js 품질 키트 — 리소스, 방법, 체크리스트
이 스킬은 한 가지 질문에 답합니다: 우리의 Three.js 비디오를 '쌓인 기본 도형'에서 '리깅된 캐릭터, 실제 도시, 깔끔한 연출을 갖춘 영화'로 만든 것은 무엇일까요? 세 가지입니다: 시간이 지나면서 추가된 리소스, 작업 방법, 그리고 체계적인 검토. 자매 스킬 threejs-code-video에는 기술적 세부 사항(파이프라인, 캐릭터, 카메라, 루프, 함정)이 포함되어 있습니다. 이 스킬은 전체 개요와 시작 키트입니다.
내용
| 파일 | 용도 |
|---|---|
| references/ressources.md | 전체 인벤토리: 저장소, 스킬, 사이트, 도구, 서비스 — 각 항목이 제공하는 것, 설치 방법, 라이선스 |
| references/methode.md | 작업 방식, 단계별 설명, 실제로 품질을 높인 6가지 레버 |
| references/checklist.md | 체크리스트: 설치, 코딩 전, 코딩 중, 전송 전 |
scripts/install-kit.js | 프로젝트에 키트의 공개 스킬 설치 (복제 + 복사, 종속성 없음) |
scripts/planche.js | 비디오 → 콘택트 시트 (1프레임/초) 전체 렌더 검토용 |
scripts/polyfork-fetch.js | Polyfork 모델 검색 및 다운로드 (매개변수화 가능한 .mjs 모듈) |
scripts/face-landmarks.py, scripts/face-measure.py | 사진 속 얼굴 측정 (MediaPipe) — 눈짐작 대신 |
1분 요약 리소스
| 필요 | 리소스 | 당사 상태 |
|---|---|---|
| 최신 Three.js (r186), R3F, 셰이더, 조명… | 13개의 threejs-* 스킬 — CloudAI-X/threejs-skills | 설치됨, 각 구성 시 참조 |
| 프레임별 비디오 렌더링 | 8개의 Remotion 스킬 — remotion-dev/skills | 설치됨 |
| 코드 비디오 방법 + 템플릿 | 스킬 threejs-code-video + 저장소 Alex-sia99/threejs-code-video | 직접 작성, 공개 |
| 객체, 장면, 로우폴리 캐릭터 | Polyfork (polyfork.dev, 인덱스 lucas-martinic/polyfork-catalog) | v3 영화에서 사용 — .mjs 모듈, 재배포 금지 |
| 애니메이션 바디 | Mixamo 스켈레톤 및 클립 | v3 영화의 리깅된 바디 |
| 사진 기반 유사성 | img2threejs/img2threejs + MediaPipe Face Landmarker | '측정, 추정 금지' 방식 채택 |
| 모델링 전 참조 이미지 | Kie.ai nano-banana-2-lite | 비율 및 장면에 사용 |
| 음성, 효과, 음악 | ElevenLabs, Suno, FFmpeg | 전체 파이프라인 완료 |
| 코드 기반 2D 드로잉 (다른 스타일) | alexgreensh/anidoodle, html-anime | 설치됨, Three.js 외부 |
자세한 내용, 링크 및 주의 사항: references/ressources.md.
10줄 요약 방법
- 무엇보다 먼저 참조: 스타일 비디오를 콘택트 시트로 분석, 참조 이미지, 측정된 사진.
- 코드 전에 스킬: 관련
threejs-*또는remotion-*스킬을 로드하고, API를 절대 기억에 의존해 작성하지 않음. - 좋은 코드를 연구한 후 다시 작성: 잘 만들어진 모듈을 읽고, 방법을 기록한 후 자신의 코드를 작성.
- 모든 것은 프레임 번호의 순수 함수: 고정 시드, 거리 기반 이동, 누적 상태 없음.
- 스크립트 → 음성 → 타임라인: 연출은 대사(
at("l14"))에 맞춰 조정되며, 절대 하드코딩된 초 단위가 아님. - 문제당 하나의 워크숍: 얼굴용
Lab구성, 바디용RigLab, 의심스러운 부분에 대한 실험 행렬. - 렌더링, 검토, 수정: 정지 이미지 → 장면별 콘택트 시트 → 1프레임/초로 검토된 최종 비디오.
- 새로운 시각의 엄격한 감사: 모든 재설계 전에.
- 일찍 인간 검증: 긴 렌더링 전에 캐릭터와 스타일 방향.
- 자본화: 만난 모든 함정은
pitfalls.md에, 각 방법은 스킬에.
자세한 내용: references/methode.md.
절대 규칙
- 검토되지 않은 렌더는 절대 보내지 마세요. 정지 이미지 하나로는 영화에 충분하지 않습니다. 콘택트 시트로 최종 비디오를 검토하세요.
- 스타일이 정확성보다 우선합니다. 스타일화된 세계의 사실적인 얼굴은 두 번 거부되었습니다. 유사성은 형태와 몇 가지 선명한 특징을 통해 전달됩니다.
- 라이선스를 준수하세요. Polyfork: 무료 비디오 사용,
.mjs모듈과 구운 클립은 공개 저장소나 패키지에 절대 포함하지 마세요. - 획 = 볼륨, 장소 = 인식 가능한 객체, 대사 = 그것을 보여주는 시각 자료.
학생에게 키트 전달하기
키트는 https://github.com/Alex-sia99/threejs-quality-kit 저장소에 게시되어 있습니다. 이 링크를 보내기만 하면 됩니다. README는 학생을 대상으로 합니다(전제 조건, 3단계 설치, 에이전트에게 제공할 문구). install.js는 공개 스킬과 시작 프로젝트를 직접 다운로드하므로 저장소는 가볍고 최신 상태를 유지합니다. Polyfork .mjs 모듈, anim-*.json 클립, API 키, 사진 또는 개인 음성을 여기에 절대 추가하지 마세요.