プラグインインストール: セットアップやフレッシュネスコマンドの前に、このスキルが HyperFrames プラグイン内にある場合は、プラグイン実行ルールに従ってください。スタンドアロンインストールの場合は、以下の更新手順を保持してください。
HyperFrames レジストリ
レジストリは、hyperframes add <name> でインストール可能な再利用可能なブロックとコンポーネントを提供します。
- ブロック — スタンドアロンのサブコンポジション(独自の寸法、持続時間、タイムラインを持つ)。ホストコンポジション内で
data-composition-srcを使用してインクルードします。 - コンポーネント — エフェクトスニペット(独自の寸法を持たない)。ホストコンポジションのHTMLに直接ペーストします。
クイックリファレンス
hyperframes add data-chart # ブロックをインストール
hyperframes add grain-overlay # コンポーネントをインストール
hyperframes add captions # captions タグが付いたすべてのブロックをインストール
hyperframes add shimmer-sweep --dir . # 特定のプロジェクトをターゲット
hyperframes add data-chart --json # マシンリーダブルな出力
hyperframes add data-chart --no-clipboard # クリップボードをスキップ(CI/ヘッドレス)
インストール後、CLIは書き込まれたファイルと、ホストコンポジションにペーストするスニペットを出力します。スニペットは出発点です。ブロックを配線する際には、data-composition-id(ブロックの内部コンポジションIDと一致する必要があります)、data-start、data-track-index 属性を追加する必要があります。
位置引数の値は、最初に正確なアイテム名として解決されます。アイテムが一致せず、値がタグである場合、コマンドはそのタグを持つすべてのブロックをインストールします。レジストリの依存関係は、要求されたアイテムの前にインストールされます。hyperframes add はブロックとコンポーネントにのみ機能します。例については、代わりに hyperframes init <dir> --example <name> を使用してください。
インストール場所
ブロックはデフォルトで compositions/<name>.html にインストールされます。コンポーネントはデフォルトで compositions/components/<name>.html にインストールされます。
これらのパスは hyperframes.json で設定可能です:
{
"registry": "https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry",
"paths": {
"blocks": "compositions",
"components": "compositions/components",
"assets": "assets"
}
}
詳細は install-locations.md を参照してください。
ブロックの配線
ブロックはスタンドアロンのコンポジションです。ホストの index.html で data-composition-src を使用してインクルードします:
<div
data-composition-id="data-chart"
data-composition-src="compositions/data-chart.html"
data-start="2"
data-duration="15"
data-track-index="1"
data-width="1920"
data-height="1080"
></div>
主要な属性:
data-composition-src— ブロックHTMLファイルへのパスdata-composition-id— ブロックの内部IDと一致する必要がありますdata-start— ブロックがホストタイムラインに現れる時間(秒)data-duration— ブロックが再生される時間data-width/data-height— ブロックのキャンバス寸法data-track-index— Studioタイムラインの行。表示用。レイヤリングにはCSSz-indexを使用します
詳細は wiring-blocks.md を参照してください。
コンポーネントの配線
コンポーネントはスニペットです。そのHTMLをコンポジションのマークアップに、CSSをスタイルブロックに、JSをスクリプトに(存在する場合)ペーストします:
- インストールされたファイルを読み取ります(例:
compositions/components/grain-overlay.html) - HTML要素をコンポジションの
<div data-composition-id="...">にコピーします <style>ブロックをコンポジションのスタイルにコピーします<script>の内容をコンポジションのスクリプトにコピーします(タイムラインコードの前)- コンポーネントがGSAPタイムライン統合を公開している場合(スニペットのコメントブロックを参照)、それらの呼び出しをタイムラインに追加します
詳細は wiring-components.md を参照してください。
ディスカバリー
CLIを主要なディスカバリーサーフェスとして使用します。ブラウジングよりも意図による検索を優先してください: レジストリには目でスキャンできる以上のアイテムが含まれているため、名前やタグでリストアップして一致させるのは遅い方法であり、作者の表現があなたの表現と異なる場合に失敗します。
# ビートが行うべきことに対してカタログ全体をランク付け
npx hyperframes catalog --query "見出しを一行ずつ表示する"
npx hyperframes add caption-clip-wipe
検索はローカルで実行され、何も送信しません。デフォルトではアイテムの名前、タイトル、説明と共有される語彙でランク付けされるため、あなたの言葉を再利用したアイテムのみが見つかります。--on-device は、一度モデルをダウンロードした後、意味でランク付けします。--json を使用すると、エンベロープがどのティアが応答したかを示すので、ランキングが行われたと想定するのではなく、それを確認してください。
ビデオの言語に関係なく、常に英語でクエリを実行してください。 カタログは英語で書かれており、両方のティアがそのようにインデックスを作成します(オンデバイスモデルも英語のみです)。別のスクリプトでのクエリは検索可能な用語を生成せず、何も返しません。これは日本語や中国語のプロジェクトで間違えやすい点です。ブリーフ、キャプション、ナレーションがすべてその言語であり、クエリも自然にそれに従うからです。動き を英語で説明し、画面上のコピーはビデオが必要とする言語で記述してください。クエリが クエリに検索可能な単語がありません を返した場合、これはルールの問題であり、コンポーネントの欠落ではありません。ギャップレポートの対象にはなりません。
インストール可能性はランキングの後、その前に適用されるわけではありません。ベクターが運ぶがこのレジストリが提供できない名前は結果から除外され、dropped にカウントされます。したがって、dropped がゼロでない場合、2つの世代が異なることを意味します。オフラインティア、同意ゲート、および古いインデックスの更新方法については、/hyperframes-cli を参照してください。
検索の代わりにブラウズやフィルタリングを行うには:
npx hyperframes catalog
npx hyperframes catalog --type block
npx hyperframes catalog --type component
npx hyperframes catalog --type block --tag social
npx hyperframes catalog --json
npx hyperframes catalog --human-friendly
通常のテーブルと --json モードでは一致するもののみがリストされ、選択した名前を hyperframes add <name> でインストールします。--human-friendly はインタラクティブなピッカーを開き、選択したアイテムを即座にインストールします。CIやエージェントのワークフローでは、--json の後に明示的な add を優先してください。
カタログにないものを報告する
検索結果に適切なものがない場合、手動で動きを作成する前にその旨を伝えてください:
npx hyperframes feedback --search-miss "<実行したクエリ>" --wanted "<必要な動き>" --tier <応答したティア>
catalog --query はこの行を事前に入力して出力し、--json はそれを report_gap として保持します。そのため、何も適合しないと判断した時点で既に手元にあります。
どちらのティアでも、結果に適切なものがない場合は必ず報告してください。 オンデバイスティアが応答したかどうかを待たないでください。同意が必要な33 MBのダウンロードが必要なため、エージェントの実行は明示的にオプトインしない限り words になります。on-device でゲートすると、ほぼすべてのレポートが沈黙します。--tier 値が一緒に送られるため、語彙ミスと意味ミスを区別できます。必要としたエフェクトを説明し、想像したアイテム名を説明しないでください。返ってくるのは構築する価値のある動きのリストであり、存在しないアイテムを名前で報告しても何も学べません。これがクエリをどこかに送信する唯一のパスであり、そのため検索が自動的に行うのではなく、別個の意図的なコマンドになっています。評価は含まれず、評価指標に届くことはありません。
これがカタログ全体の需要シグナルです。これをスキップすると、遭遇したギャップはインストール数の推測に依存することになり、誰もインストールできなかった動きを見ることはできません。
CLIが設定されたレジストリに到達できない場合、フォールバックとして生のマニフェストを検査します:
curl -s https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry/registry.json
CLIが到達できないレジストリは、ディスカバリーのためにカタログを空にしません。以前にフェッチされたマニフェストは、再検証に失敗しても24時間の更新ウィンドウを超えて提供され続けるため、catalog と catalog --query はディスク上の最後のコピーに対してリストとランキングを実行します。
add は、昨日インストールしたアイテムであってもネットワークを必要とします。 キャッシュされるのはマニフェストのみで、アイテムの実際のファイルはインストールのたびにフェッチされます。したがって、オフラインでは検索したり、アイテムが何であるかを確認したりできますが、インストールはファイルフェッチで失敗します。ユーザーにオフラインインストールを約束しないでください。
各アイテムの registry-item.json には、名前、タイプ、タイトル、説明、タグ、寸法(ブロックのみ)、持続時間(ブロックのみ)、ファイルリストが含まれています。
タイプとタグによるフィルタリングの詳細については、discovery.md を参照してください。
新しいブロックまたはコンポーネントのコントリビュート
新しいレジストリアイテム(キャプションスタイル、VFXブロック、トランジション、ロワースリー、または再利用可能なコンポーネント)を作成し、上流へのPRとして送信する場合(既存のものをインストールするのではなく)、contributing.md の完全なアイデア→スキャフォールド→ビルド→検証→プレビュー→出荷のワークフローに従ってください。コピーペースト可能なスターターテンプレート(キャプション/VFX/コンポーネント/registry-item.json)は templates.md にあります。