screen-demo は何をしますか?
URLをデモ動画に変換します。あなたはディレクターです:ページを確認し、ツアーをJSONで記述し、スクリプトがそれを再生し、ページ自身のフレーム(デスクトップはキャプチャしません)を取り込み、動画を編集します。スクロール、カーソルの動き、タイピングは30fpsで1フレームごとにキャプチャされるため、重いページでも滑らかです。クリックや読み込み後にページ自身が行う動作は、ライブスクリーンキャストから取得されます。
セットアップ(一度だけ)
- 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個のこと(ヒーロー、機能、価格、サインアップフロー)、フォーマット(YouTubeやREADME用の
landscape16:9、ShortsやReels用のvertical9:16、square)、GIFが必要かどうか。ユーザー自身のサイトまたはアプリ、あるいは公開されていて表示が許可されたページのみ。 - ページを確認する:
python scripts/demo.py inspect URL WORK [--format vertical]。すべてのWORK/page-N.jpg(ビューポートサイズにスライスされたページ、クリック可能な要素が赤い番号で囲まれている)とWORK/elements.txtを読みます。Cookieバナーやポップアップはここに現れます:ツアーの最初のステップでそれを閉じます(「拒否」または「閉じる」ボタン)。 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)のパス、長さ、表示するアイデアごとに1行。
ルール
- パスワードでログインしない、パスワードやカード番号を入力しない(スクリプトはパスワードおよび支払いフィールドを拒否します)、購入・送信・投稿・削除をしない、他人の個人データでフォームを送信しない。ログインが必要な領域のデモには、ユーザー自身がテストアカウントのページを提供する必要があります。
- ユーザーが別途指示しない限り、Cookieバナーは拒否します(最小限のデータ)。
- キャプションは短く(3〜8語)、キャプションごとに1つのアイデア。動画自体の動きが残りを伝えます。
- サイトを尊重する:ユーザーが表示を許可していないページのツアーは作成しない。
例
ユーザー:「https://example.com のランディングページの20秒デモをREADME用に作って、サインアップを表示して」
あなたはinspectを実行し、3枚のスライスを読み、Cookieバナー(#2「すべて拒否」)、ヒーロー、「試してみる」フィールド(#9)、価格カード(#21)を確認。ツアーを作成:タイトルカード、#2をクリック、キャプション「自動で書かれるノート」、#9に入力、#10をクリック、結果をハイライト、キャプション「永久無料」、#21にスクロール、ズーム。--gif付きで録画、keys.jpgを確認、価格が適切にフレームに入っているズームを確認し、demo.mp4(21秒)、demo.gif(3 MB)、4つのアイデアと共に回答します。