プラグインインストール: セットアップやフレッシュネスコマンドの前に、このスキルが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— スタジオタイムラインの行。表示のみ。レイヤリングにはCSSのz-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 "reveal a headline one line at a time"
npx hyperframes add caption-clip-wipe
検索はローカルで行われ、何も送信しません。デフォルトでは、アイテムの名前、タイトル、説明と共有される語彙に基づいてランク付けされるため、あなたの言葉を再利用するアイテムのみが見つかります。--on-device は、一度だけモデルをダウンロードした後、意味に基づいてランク付けします。--json を使用すると、エンベロープはどのティアが回答したかを示すので、ランク付けが行われたと想定するのではなく、それを確認してください。
ビデオの言語に関係なく、常に英語でクエリを実行してください。 カタログは英語で書かれており、両方のティアがそのようにインデックスを作成しています(オンデバイスモデルも英語のみです)。別のスクリプトでのクエリは検索可能な用語を生成せず、何も返しません。これは、ブリーフ、キャプション、ナレーションがすべてその言語であり、クエリが自然にそれに従う日本語や中国語のプロジェクトでは誤解しやすいです。動き を英語で説明し、画面上のコピーをビデオが必要とする言語で記述してください。クエリが No searchable words in query を返す場合、これは不足しているコンポーネントではなく、このルールが原因です。そのため、ギャップレポートの価値はありません。
インストール可能性はランク付けの後に適用され、その前ではありません。ベクターが運ぶがこのレジストリが提供できない名前は結果から除外され、dropped にカウントされます。したがって、非ゼロの dropped は両者が異なる世代であることを意味します。オフラインティア、同意ゲート、および古いインデックスを更新する方法については /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 にある完全なワークフロー(アイデア → スキャフォールド → ビルド → 検証 → プレビュー → 出荷)に従ってください。コピーペースト可能なスターターテンプレート(caption / VFX / component / registry-item.json)は templates.md にあります。