HyperFrames CLI は何をしますか?
すべての操作は npx hyperframes で実行します。Node.js >= 22 と FFmpeg が必要です。
ワークフロー
- スキャフォールディング —
npx hyperframes init my-video - 作成 — HTML コンポジションを記述(
hyperframesスキルを参照) - Lint —
npx hyperframes lint - ビジュアルインスペクト —
npx hyperframes inspect - プレビュー —
npx hyperframes preview - レンダリング —
npx hyperframes render
プレビューの前に lint と inspect を実行してください。lint は data-composition-id の欠落、トラックの重複、未登録のタイムラインを検出します。inspect はレンダリングされたコンポジションをヘッドレス Chrome で開き、タイムラインをシークして、バブル/コンテナやキャンバスからはみ出したテキストを報告します。
スキャフォールディング
npx hyperframes init my-video # インタラクティブウィザード
npx hyperframes init my-video --example warm-grain # 例を選択
npx hyperframes init my-video --video clip.mp4 # ビデオファイル付き
npx hyperframes init my-video --audio track.mp3 # オーディオファイル付き
npx hyperframes init my-video --example blank --tailwind # Tailwind v4 ブラウザランタイム付き
npx hyperframes init my-video --non-interactive # プロンプトをスキップ (CI/エージェント)
テンプレート: blank, warm-grain, play-mode, swiss-grid, vignelli, decision-tree, kinetic-type, product-promo, nyt-graph。
init は適切なファイル構造を作成し、メディアをコピーし、Whisper で音声を文字起こしし、AI コーディングスキルをインストールします。手動でファイルを作成する代わりに使用してください。
--tailwind を使用する場合は、クラスやテーマトークンを編集する前に tailwind スキルを呼び出してください。スキャフォールドは Studio の Tailwind v3 セットアップではなく、ブラウザランタイム経由の Tailwind v4.2 を使用します。
Linting
npx hyperframes lint # カレントディレクトリ
npx hyperframes lint ./my-project # 特定のプロジェクト
npx hyperframes lint --verbose # 情報レベルの検出結果
npx hyperframes lint --json # 機械可読
index.html と compositions/ 内のすべてのファイルを lint します。エラー(修正必須)、警告(修正推奨)、情報(--verbose 時)を報告します。
ビジュアルインスペクト
npx hyperframes inspect # タイムライン上のレンダリングレイアウトを検査
npx hyperframes inspect ./my-project # 特定のプロジェクト
npx hyperframes inspect --json # エージェント可読な検出結果
npx hyperframes inspect --samples 15 # より密なタイムラインスイープ
npx hyperframes inspect --at 1.5,4,7.25 # 明示的なヒーローフレームタイムスタンプ
lint と validate の後に使用してください。特に吹き出し、カード、キャプション、またはタイトなタイポグラフィを含むコンポジションに有効です。以下を報告します:
- 最も近いビジュアルコンテナまたは吹き出しの外側にはみ出したテキスト
- 自身の固定幅/固定高さのボックスによってクリップされたテキスト
- コンポジションキャンバスの外側にはみ出したテキスト
- クリッピングコンテナから逃れた子要素
エラーはレンダリング前に修正する必要があります。警告はエージェントレビューのために表示されます。警告でも失敗させたい場合は --strict を追加してください。繰り返しの静的問題はデフォルトで折りたたまれ、JSON 出力は LLM のコンテキストウィンドウのためにコンパクトに保たれます。オーバーフローが出入りアニメーションのために意図的な場合は、要素または祖先に data-layout-allow-overflow をマークしてください。装飾要素が監査されるべきでない場合は、data-layout-ignore をマークしてください。
npx hyperframes layout は同じビジュアル検査パスの互換性エイリアスとして引き続き使用可能です。
プレビュー
npx hyperframes preview # カレントディレクトリを配信
npx hyperframes preview --port 4567 # カスタムポート(デフォルト 3002)
ファイル変更時にホットリロードされます。ブラウザでスタジオが自動的に開きます。
プロジェクトをユーザーに返却する際は、ソース index.html パスではなく、Studio プロジェクト URL を使用してください:
http://localhost:<port>/#project/<project-name>
プレビュー出力の実際のポートとプロジェクトディレクトリ名を使用してください。例えば、codex-openai-video 内で npx hyperframes preview --port 3017 を実行した場合、http://localhost:3017/#project/codex-openai-video と報告してください。
index.html はソースコードコンテキストとしてのみ扱ってください。実装ファイルとしてリンクすることは問題ありませんが、プロジェクトやプレビュー画面としてラベル付けしないでください。
レンダリング
npx hyperframes render # 標準 MP4
npx hyperframes render --output final.mp4 # 名前付き出力
npx hyperframes render --quality draft # 高速イテレーション
npx hyperframes render --fps 60 --quality high # 最終納品
npx hyperframes render --format webm # 透明 WebM
npx hyperframes render --docker # バイト単位で同一
| フラグ | オプション | デフォルト | 備考 |
|---|---|---|---|
--output | パス | renders/name_timestamp.mp4 | 出力パス |
--fps | 24, 30, 60 | 30 | 60fps はレンダリング時間が倍増 |
--quality | draft, standard, high | standard | イテレーション時は draft |
--format | mp4, webm | mp4 | WebM は透明度をサポート |
--workers | 1-8 または auto | auto | 各ワーカーが Chrome を起動 |
--docker | フラグ | off | 再現可能な出力 |
--gpu | フラグ | off | GPU 加速エンコーディング |
--strict | フラグ | off | lint エラーで失敗 |
--strict-all | フラグ | off | エラーと警告の両方で失敗 |
--variables | JSON オブジェクト | — | data-composition-variables で宣言された変数値を上書き |
--variables-file | パス | — | 変数値を含む JSON ファイル(--variables の代替) |
--strict-variables | フラグ | off | --variables で未宣言のキーまたは型不一致でレンダリングを失敗させる |
品質ガイダンス: イテレーション中は draft、レビューには standard、最終納品には high を使用してください。
パラメータ化レンダリング: コンポジションは <html> ルートに data-composition-variables を使用して変数を宣言します。これはスキーマを定義する宣言の JSON 配列(エントリごとに {id, type, label, default})です。内部のスクリプトは window.__hyperframes.getVariables() を介して解決された値を読み取ります。CLI の **`--variables '{