Pulupulu Motion은(는) 무엇을 하나요?
여기서 필름은 Chrome이 프레임별로 렌더링하는 HTML 타임라인입니다. 비디오 편집기는 사용하지 않습니다. 페이지를 작성하면 CLI가 고정 프레임 속도로 스크린샷을 찍고 ffmpeg이 사운드를 믹싱합니다.
이 파일은 라우터 역할을 합니다. 답변합니다: 이 작업을 수행해도 되는가, 무엇을 먼저 실행해야 하는가, 무엇이 통과되어야 하는가, 세부 정보는 어떤 페이지에 있는가. 작업 중인 부분에 대해서만 참조 페이지를 로드하세요.
1. 약속하기 전에
python scripts/doctor.py # 읽기 전용: python, node, ffmpeg, CLI, 키, 디스크
python scripts/doctor.py --project film/ # 추가: 페이지 계약이 존재하는지 확인
종료 코드 1은 이 머신에서 필름을 만들 수 없음을 의미합니다. 장면을 작성한 후에 이 사실을 알게 되지 마십시오. 명령어당 npx를 절대 호출하지 마십시오. 모든 check, still 및 render에서 발생하는 네트워크 왕복은 이 워크플로에서 가장 흔한 자체 유발 성능 저하입니다.
이 도구는 다음과 같은 경우 잘못된 선택입니다. 스토리에 필요한 푸티지가 없거나, 실제 사람의 얼굴이나 초상, 복잡한 인체 또는 동물 해부학, 연속적으로 수행되는 신체 동작, 또는 립싱크가 필요한 경우. 이 도구는 평면 벡터 지오메트리, 타이포그래피, 차트, 지도, 아이콘 및 색상 코딩된 객체를 잘 렌더링하며, 다른 것들은 제대로 렌더링하지 못합니다. 비슷한 결과물을 내는 대신 그렇게 말하세요. 아카이브 자료를 대체하는 그림은 스타일 선택이 아니라 출처 문제입니다.
2. 워크플로 순서
1비트 = 1문장 = 1숏. 타이밍은 측정된 음성에서 비롯되며, 절대 임의로 만들지 않습니다.
- 브리핑. 주제, 대상, 플랫폼, 언어, 내레이션 유무. 누락된 주제에 대해 질문하세요. 비디오가 요청되었을 때 내레이션 여부를 묻지 마십시오.
- HTML 전에 스토리보드 —
references/narration-and-captions.md. 캡션은 말 그대로의 음성 단어이며, 요약이 아닙니다. - 내레이션 및 측정.
python scripts/deepseek_voice.py beats beats.json film/assets/voice.wav --voice stella --timeline timeline.json을 실행한 다음gate를 실행하여 ASR로 모든 구문을 확인하세요. 경로, 음성 및 제한 사항:references/narration/deepseek-tts.md. - 스토리보드가 아닌
timeline.json에서 페이지를 빌드하세요. 계약:references/cli.md. 스토리에 아이콘 라이브러리에 없는 객체가 필요한 경우 먼저 프린트 패널로 생성하세요.references/generated-assets.md— 그런 다음 조립하세요. 사진을 대체할 그림을 직접 그리지 마십시오. - 확인한 다음 살펴보기.
pulupulu check .를 실행한 다음pulupulu still . --at 2,12,24 --out .om/stills를 실행하고 스틸 이미지를 여세요.check를 통과한 페이지도 빈 화면을 렌더링할 수 있습니다. - 렌더링 —
pulupulu render . --format mp4 --fps 30. 중단, 검은 프레임 및 잘못된 길이:references/render-traps.md. - 명시적 스트림 매핑으로 믹스 및 먹싱 —
scripts/deliver_check.py --video out/film-vN.mp4 --audio assets/mix.wav --out out/final.mp4는 먹싱 과 검증을 한 번에 수행합니다. 수동 레시피 및 덕킹 체인:references/workflow.md. - 렌더러의 최신 출력이 아닌, 전달할 파일을 검증하세요:
python scripts/deliver_check.py out/film.mp4 --timeline timeline.json. - 정직한 주의사항과 함께 전달하세요: 소싱된 것이 아니라 그려진 것과 QA 노트 내용.
3. 게이트
다음만 차단합니다. 도구가 출력하는 다른 모든 것은 읽기 노트입니다. 인수로 응답하거나 수정하되, 통과되지 않았는데 통과된 것으로 절대 보고하지 마십시오.
| 게이트 | 명령어 | 증명하는 것 | 실패 시 |
|---|---|---|---|
| 사전 점검 | python scripts/doctor.py | 머신이 렌더링 가능함 | 중단, 누락된 항목 보고 |
| 구성 | pulupulu check . | 페이지 계약, 누락된 파일 없음 | 렌더링 전에 수정 |
| 언어 | python scripts/lang-audit.py film/index.html --lang en | 다른 언어의 텍스트 없음, <script> 내의 문자열 리터럴 포함 | 리터럴 번역 후 재실행 |
| 음성 | python scripts/deepseek_voice.py gate beats.json --voice stella | 모든 구문이 자신의 단어로 다시 전사됨 | 구문 재작성; 조각을 절대 전달하지 마십시오 |
| 파일 | python scripts/deliver_check.py out/film.mp4 --timeline timeline.json (또는 --video/--audio/--out으로 먼저 먹싱) | 프레임 크기, 프레임 속도, 오디오 존재 및 충분한 길이, 트루 피크, 전달 크기 | 다시 먹싱 또는 인코딩 |
| 팝 | pulupulu qa out/film.mp4 | 단일 프레임 팝 없음 | 한 프레임 요소 찾기 |
pulupulu qa는 또한 초당 모션, ≥ 1초 동안 스틸 및 평탄한 시작을 보고합니다. 이는 페이싱에 대한 판단이며 96×54 그레이스케일 비교에서 측정되므로 낮은 대비의 느린 움직임이 스틸로 읽힐 수 있습니다. 이를 판결로 따르기보다는 확인해야 할 이유로 사용하세요.
어떤 게이트도 증명하지 않는 것: 필름이 좋다는 것, ASR이 올바른 숫자를 들었다는 것(토큰으로서의 숫자와 고유 명사 확인), 또는 캡션이 플랫폼 UI에 가려지지 않는 위치에 있다는 것.
4. 렌더링 비용을 발생시키는 함정
전체 세부 사항 및 수정 방법은 references/render-traps.md에 있습니다. 렌더링을 완전히 멈추게 하는 함정:
<div>안에 원시<g>/<rect>/<path>를 쓰면 아무 것도 렌더링되지 않고 경고도 없습니다. 모든 장면 조각을 자체<svg viewBox>로 감싸세요.- 인라인 SVG
<text>내부의 웹 폰트는 매 프레임마다 해당 레이어를 다시 래스터화합니다. 텍스트는 HTML에 넣거나 모양으로 그리세요. - 매 프레임 필터로
feTurbulence를 사용하면(인라인 SVG 또는 CSS 배경) 렌더러가 중단됩니다. 노이즈를 PNG 타일로 한 번 베이킹하세요. - 인라인 SVG에 대한 전체 프레임 GSAP scale은 플레이트를 다시 래스터화합니다. translate는 합성이 잘 되고, 비트맵 레이어는 크기 조정이 가능합니다. 푸시가 불가능한 경우 작은 내부 그룹에 애니메이션을 적용하세요.
repeat: -1은 타임라인을 무한으로 만듭니다. 87초 필름이 조용히 117초가 됩니다. 유한한 랩을 계산하세요.- 렌더링 실패 후, 남겨진 헤드리스 Chrome만 종료하세요.
taskkill //IM chrome.exe는 사용자 자신의 브라우저를 닫습니다.
5. 세부 정보 위치
| 작업 중인 내용 | 페이지 |
|---|---|
| 명령어, 페이지 계약, 설치 | references/cli.md |
| 9단계, 프로젝트 계약, 먹싱 | references/workflow.md |
| 스토리보드, 캡션, 단일 언어 게이트 | references/narration-and-captions.md |
| 팔레트, 요소 예산, 개성, 리듬 | references/design-taste.md |
| 모션 언어, 기법, 3D 레이어 | references/motion-library.md |
| 강화, 제품 데모, 토킹 헤드, 문법 | references/workflows-specialized.md |
| 음악 세계, 작곡가, SFX, 내레이션 합성 | references/audio-and-music.md, references/narration/deepseek-tts.md |
| 빈 화면, 중단 또는 잘못된 길이 렌더링 | references/render-traps.md |
| 확인할 사항 및 순서 | references/verification.md |
| 스타일 레시피, 카메라 언어 | references/art-motion/INDEX.md |
| 아이콘 및 벡터 소싱, 라이선스 | references/asset-sourcing.md |
| 이미지 모델로 생성된 아트, 프린트 자르기, 마운팅 | references/generated-assets.md |
| 평면 벡터 공예, 스크롤링 월드 | references/2d-vector-motion.md |
| 이 렌더러가 처리할 수 있는 주제 | references/topic-fit.md |
| 서브초 레벨의 타이밍 및 이징 | references/ui-motion/ |
| 이 스킬 게시 (원커밋, v1.0) | references/publishing-skills.md, references/publishing.md |
스타일 레시피 경로(scripts/art-motion/engine/)는 의도적으로 이 저장소에 포함되지 않은 20MB 규모의 벤더드 런타임입니다. 스킬은 모든 에이전트가 절대 사용하지 않을 엔진을 가져오도록 해서는 안 되며, 37MB 트리는 검토될 수 없습니다. 고정되고 체크섬이 확인된 상태로 위 페이지에서 인용한 정확한 경로에 설치됩니다:
python scripts/install_art_motion.py --check # 설치되었는가?
python scripts/install_art_motion.py # 코어: lib + 데모 + 장면, 20MB
python scripts/install_art_motion.py --with-reference-films # + 학습 자료, 추가 14MB
그 외 모든 것(Python 게이트, 클립 사양, 문서)은 저장소에 있으며 설치가 필요 없습니다. 가져온 트리를 절대 커밋하지 마십시오. .gitignore가 이미 처리합니다.
6. 스크립트
| 스크립트 | 기능 |
|---|---|
scripts/doctor.py | 사전 점검, 읽기 전용 |
scripts/deepseek_voice.py | probe · speak · cost · lay · beats · asr · gate — 내레이션 및 측정된 타임라인 |
scripts/deliver_check.py | 전달된 파일 검증: 크기, 속도, 오디오, 피크, 타임라인 대비 지속 시간 |
scripts/lang-audit.py | 마크업 및 스크립트 리터럴에 대한 단일 언어 게이트 |
scripts/art-motion/icon_audit.py | 아이콘 패밀리, 색상 수, 콘택트 시트 |
scripts/art-motion/qa.py | 렌더링된 파일의 페이싱 및 팝 휴리스틱 |
scripts/stamp_credit.py | 텍스트 파일에 by Alucard0x1 줄 추가 |
7. 사람과 협업하기
형용사가 아닌 프레임을 보여주세요. 각 행동마다 하나의 히어로 프레임이 잘못된 작업으로 일주일을 낭비하게 만듭니다. 그들이 수정할 때, 수정 사항을 채팅 응답이 아닌 이 스킬에 반영하세요.
핸드오프: 내레이션 타이밍 및 운율 → 스킬 tts-intonation · 다른 라이브러리 병합 또는 번역 → 스킬 agent-skill-sourcing · 게시 전 권리 및 초상권 → 스킬 media-content-safety · 참조 비디오 소싱 → 스킬 streaming-mirror-extraction · 3D 또는 푸티지 기반 샷 → 스킬 headless-three-video-render 및 cinetic · 타이포그래피 중심 필름 → 스킬 kinetic-typography.