screen-demo은(는) 무엇을 하나요?
URL을 데모 영상으로 바꿉니다. 당신은 감독입니다: 페이지를 살펴보고, 투어를 JSON으로 작성하면, 스크립트가 이를 재생하고 페이지의 자체 프레임(데스크톱이 아님)을 캡처하여 영상을 편집합니다. 스크롤, 커서의 글라이드, 타이핑은 30fps로 프레임별로 캡처되어 무거운 페이지에서도 부드럽습니다. 클릭 또는 로드 후 페이지 자체적으로 발생하는 동작은 실시간 화면 캡처에서 가져옵니다.
설정 (한 번만)
- Python 3.10+에 Pillow와 최신 Playwright 설치:
python -m pip install -U playwright pillow, 그 다음python -m playwright install chromium. - PATH에 ffmpeg 설치 (
winget install ffmpeg,brew install ffmpeg).
python tests/selftest.py (로컬 페이지, 네트워크 없음, 약 1분 소요)로 확인합니다.
워크플로
- 영상 용도 파악: URL, 보여줄 2~4가지 항목 (히어로, 기능, 가격, 가입 흐름), 형식 (
landscape16:9는 YouTube와 README용,vertical9:16은 Shorts와 Reels용,square), GIF 필요 여부. 사용자 자신의 사이트나 앱, 또는 공개적으로 보여줄 수 있는 페이지만 가능합니다. - 페이지 검사:
python scripts/demo.py inspect URL WORK [--format vertical]. 모든WORK/page-N.jpg(뷰포트 크기로 자른 페이지, 각 클릭 가능 요소에 빨간색 번호가 표시됨)와WORK/elements.txt를 읽습니다. 여기서 쿠키 배너나 팝업이 나타나면 투어의 첫 번째 단계에서 이를 닫습니다 ("거절" 또는 "닫기" 버튼). WORK/tour.json작성 (형식은 references/tour-format.md 참조): 타이틀 카드, 그 다음 짧은 단계들. 좋은 투어: 제품 설명 캡션, 첫 번째 볼만한 곳으로 스크롤, 확대, 제품 작동을 보여주는 클릭이나 타이핑, 결과 하이라이트, 각 아이디어당 캡션. 15~40초. 타겟은 inspect의 번호 (#12), 또는css=...또는text=...입니다.- 녹화:
python scripts/demo.py record WORK/tour.json OUT [--gif]. 투어를 재생하고, 실패한 각 단계를 출력하며,OUT/demo.mp4(그리고OUT/demo.gif)를 렌더링합니다. - 완료 전에
OUT/keys.jpg확인: 각 단계의 프레임. 잘못된 곳에 확대, 프레임 요점을 가리는 캡션, 실패한 단계 (요소가 이동했거나 숨겨짐), 여전히 방해가 되는 배너. 캡션, 확대 또는 타이틀 카드만 변경하려면OUT/tour.json을 편집하고python scripts/demo.py render OUT [--gif]실행 (새 녹화 없음); 그 외에는 다시 녹화합니다. - 전달:
demo.mp4(및 GIF)의 경로, 길이, 그리고 보여주는 각 아이디어를 한 줄씩 설명.
규칙
- 비밀번호로 로그인하지 말고, 비밀번호나 카드 번호를 입력하지 말며 (스크립트는 비밀번호 및 결제 필드를 거부함), 구매, 전송, 게시 또는 삭제하지 말고, 누군가의 개인 데이터로 양식을 제출하지 마십시오. 로그인된 영역의 데모는 사용자가 직접 테스트 계정 페이지를 제공해야 합니다.
- 쿠키 배너는 거절합니다 (사용자가 달리 명시하지 않는 한 최소 데이터만).
- 캡션은 짧게 유지 (3~8단어); 캡션당 하나의 아이디어; 영상 자체의 움직임이 나머지를 전달합니다.
- 사이트를 존중: 사용자가 보여줄 수 없는 페이지의 투어는 금지.
예시
사용자: "README용으로 내 랜딩 페이지 https://example.com 의 20초 데모를 만들어 줘, 가입 화면을 보여 줘"
당신은 inspect를 실행하고, 3개의 슬라이스를 읽고, 쿠키 배너 (#2 "모두 거절"), 히어로, "시도하기" 필드 (#9) 및 가격 카드 (#21)를 확인합니다. 투어를 작성합니다: 타이틀 카드, #2 클릭, 캡션 "스스로 쓰는 노트", #9에 타이핑, #10 클릭, 결과 하이라이트, 캡션 "영원히 무료", #21로 스크롤, 확대; --gif로 녹화, keys.jpg를 열고 확대가 가격을 잘 프레임에 담았는지 확인한 후, demo.mp4 (21초), demo.gif (3MB) 및 네 가지 아이디어로 답변합니다.