Communitygithub.com

Pulupulu Motion

모션 필름을 HTML과 GSAP 타임라인으로 만들고, 헤드리스 Chrome으로 프레임마다 찍어 ffmpeg로 내레이션과 음악을 섞는다.

Pulupulu Motion란 무엇인가요?

Node, ffmpeg, pulupulu CLI가 있는지 먼저 확인하고 평평한 벡터, 글자, 차트, 지도를 만든다. 실제 얼굴, 립싱크, 연속된 신체 동작은 받지 않고 그렇다고 말한다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Alucard0x1/pulupulu-motion/tree/HEAD

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

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숏. 타이밍은 측정된 음성에서 비롯되며, 절대 임의로 만들지 않습니다.

  1. 브리핑. 주제, 대상, 플랫폼, 언어, 내레이션 유무. 누락된 주제에 대해 질문하세요. 비디오가 요청되었을 때 내레이션 여부를 묻지 마십시오.
  2. HTML 전에 스토리보드 — references/narration-and-captions.md. 캡션은 말 그대로의 음성 단어이며, 요약이 아닙니다.
  3. 내레이션 및 측정. python scripts/deepseek_voice.py beats beats.json film/assets/voice.wav --voice stella --timeline timeline.json을 실행한 다음 gate를 실행하여 ASR로 모든 구문을 확인하세요. 경로, 음성 및 제한 사항: references/narration/deepseek-tts.md.
  4. 스토리보드가 아닌 timeline.json에서 페이지를 빌드하세요. 계약: references/cli.md. 스토리에 아이콘 라이브러리에 없는 객체가 필요한 경우 먼저 프린트 패널로 생성하세요. references/generated-assets.md — 그런 다음 조립하세요. 사진을 대체할 그림을 직접 그리지 마십시오.
  5. 확인한 다음 살펴보기. pulupulu check .를 실행한 다음 pulupulu still . --at 2,12,24 --out .om/stills를 실행하고 스틸 이미지를 여세요. check를 통과한 페이지도 빈 화면을 렌더링할 수 있습니다.
  6. 렌더링 — pulupulu render . --format mp4 --fps 30. 중단, 검은 프레임 및 잘못된 길이: references/render-traps.md.
  7. 명시적 스트림 매핑으로 믹스 및 먹싱 — scripts/deliver_check.py --video out/film-vN.mp4 --audio assets/mix.wav --out out/final.mp4는 먹싱 과 검증을 한 번에 수행합니다. 수동 레시피 및 덕킹 체인: references/workflow.md.
  8. 렌더러의 최신 출력이 아닌, 전달할 파일을 검증하세요: python scripts/deliver_check.py out/film.mp4 --timeline timeline.json.
  9. 정직한 주의사항과 함께 전달하세요: 소싱된 것이 아니라 그려진 것과 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.pyprobe · 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.

관련 스킬