プラグインインストール: セットアップまたは更新コマンドの前に、このスキルが HyperFrames プラグイン内にある場合は、プラグイン実行ルール に従ってください。スタンドアロンインストールの場合は、以下の更新手順を保持します。
media-use
HyperFrames のメディアOS: 解決 · 生成 · 操作 · 記憶 — あらゆるメディアタイプ、1つのスキル、コンテキストノイズゼロ。
環境に HEYGEN_API_BASE が設定されている場合のみ(ホストアプリが設定し、独自のキーで HeyGen の料金を支払っている場合):HeyGen メディアはすでに支払い済みです。ユーザーに heygen CLI のインストールやサインインを求めず、その OAuth 許容量を提供しないでください。カタログ検索、TTS、アバター呼び出しはすべてホスト経由で行われます。同じホストが独自の HeyGen ツールも提供している場合は、それらを優先して使用してください。ホスト経由の呼び出しが拒否された場合は、ホストのメッセージをそのままユーザーに伝え(修正方法、例えばアプリの設定でキーを追加または交換するなどが示されています)、停止してください。ユーザーが依頼しない限り、他のプロバイダに切り替えないでください。
それ以外の初回実行時(HEYGEN_API_BASE なし)、HeyGen メディア(カタログ検索、TTS、アバタービデオ)を使用する場合:heygen CLI をインストールしてサインインし(無料利用パス)、その後 npx hyperframes media-use resolve --doctor で確認してください。セットアップとプロバイダ: references/setup-providers.md。
ホストアプリ内での音楽と効果音:実行しているアプリが独自の音楽または効果音ツールを提供している場合は、それらを使用してください。HEYGEN_API_BASE がない場合、resolve --type bgm と --type sfx は heygen CLI を介して HeyGen カタログを検索します。なければ失敗し、その旨を伝えます(sfx はバンドルライブラリから応答します)。
HEYGEN_API_BASE がない場合、ナレーションまたはアバタービデオを生成する前に、ユーザーに伝えてください:heygen CLI に OAuth でサインインする(heygen auth login --oauth)と、TTS ナレーションとアバタービデオの無料許容量が得られます。API キーは API クレジットを消費します。
Resolve — 唯一の動詞
npx hyperframes media-use resolve --type <type> --intent "<description>" --project <dir>
1行で返します:resolved <id> → <path> (<type>, <metadata>)。すべての検索ノイズはディスクに残ります。
| タイプ | 1行の意図 |
|---|---|
bgm | 背景音楽(HeyGen カタログ、heygen CLI 経由、10,000+ トラック) |
sfx | 効果音(バンドルされた19ファイルライブラリ + heygen CLI 経由のカタログ) |
image | 写真、背景(HeyGen アセット検索、75,000+ ベクター) |
icon | アイコン、シンボル(透明) |
logo | 公式ブランドマーク(theSVG → GitHub アバター → favicon;再描画はしない) |
voice | TTS ナレーション(HeyGen 無料利用パス;オプションでローカル Kokoro) |
grade | 測定された補正候補;広範なポリッシュ/スタイライゼーションは Media Treatments に従う |
lut | ユーザー提供または明示的に選択された、再利用可能な検証済み .cube ファイル |
新しいものを解決する前に、--candidates で再利用可能な候補をリストし、自分で適合性を判断してください。再利用ルール、すべてのフラグ、取り込み(--from)、および採用については references/resolve.md を参照してください。
広範なビジュアルフィードバックをメディアインテントとして扱う
ユーザーが写真メディアの修正、ポリッシュ、スタイライズ、不明瞭化、強調、または公開を明示的に依頼した場合、たとえカラーグレーディングやエフェクトを明示しなくても、references/media-treatments.md を読んでください。実際の <img>/<video> を検査し、1つの主要なインテントを選択し、決定論的な永続化と検証を使用してください。オプションのテスト済みシードとして一致するレシピを使用するか、hyperframes media-treatment --capabilities --json を検査し、--capability <id> で1つの関連するファミリー/エフェクトを要求し、標準コントロールからカスタムトリートメントを組み立ててください。通常のオーサリングでは --all をロードしないでください。トリートメントは、補正、プリセット、仕上げ、互換性のあるシェーダーエフェクト、サポートされているキーフレーム、オプションのレジストリオーバーレイを構成できます。ソースによって正当化される範囲の調整と互換性のある部分のみを追加し、結果をより洗練されたように見せるためだけのエフェクトは追加しないでください。最終的な結合ペイロードを hyperframes media-treatment で永続化します。
1つの段階的にエスカレーションするワークフローを使用します。ビデオの場合、フレームを個別に読むのではなく、ラベル付けされた初期/中期/後期のコンタクトシートを1つ検査します。通常の補正またはポリッシュの場合は、1つの候補を適用し、1つのアフターシートを検査します。結果が曖昧、時間的、スタイライズ、LUTベース、HDR/LOGセンシティブ、プライベート、またはブランドにとって重要な場合にのみ、個別のフレームまたは動的なドラフトエビデンスにエスカレーションします。
通常の補正またはポリッシュの場合は、最終的なトリートメントのプリセット/調整 JSON を永続化します。露出、シャドウ、コントラスト、または暖かさをエンコードするためだけに .cube LUT を生成しないでください。LUT は、ユーザーが提供するか、選択したトリートメントが明示的に所有している場合にのみ使用してください。resolve --type grade --for ... --analyze は測定エビデンスであり、選択したトリートメントを生成された LUT で置き換える許可ではありません。サポートされているビネット、グレイン、ブラー、ピクセレート、カラー、またはトリートメントエフェクトを CSS/SVG オーバーレイで再作成しないでください。それはスタジオコントロールと標準のプレビュー/レンダリングシェーダーパスをバイパスします。
プロアクティブに — メディアチャンスパスを実行する
人間は通常、どのメディアが作品を引き上げるかを言えません。あなたは言えます。コンポジションを構築またはレビューするときは、1回の根拠のあるスキャンを行い、1回だけ質問してください。サイレントに追加したり、アセットごとにしつこく尋ねたりしないでください。
具体的なシグナルが存在する場合にのみ、機会を表面化してください:
| 検出されたシグナル | 提案 |
|---|---|
| 画面上のテキスト / ナレーションのないスクリプト | TTS ナレーション(オーディオエンジン) |
絵文字またはアイコンとしてスタイルされた <div> | 実際の icon を解決 |
| プレースホルダー、小さい、またはアップスケールされたように見える画像 | より良い image(および/またはアップスケール — references/operations.md を参照) |
| 音のないハードなシーンカット / トランジション | トランジション sfx |
| 音楽ベッドのない ~10秒以上のピース | bgm |
| 露出不足/過剰またはカラーキャストに見える映像 | 補正グレード(hyperframes media-treatment --selector '#hero' --analyze --json で検査) |
| 視覚的に平坦またはトピックから外れているように感じる写真メディア | 1つの特定のソースに適したプリセットまたはカスタムトリートメント。意図したターゲットを明記 |
| 静的で意味のあるメディアの登場/公開 | 1つのサポートされているシークセーフなトリートメントアニメーション;リクエストがプリセットも正当化しない限り、色は保持する |
これが助けであり、迷惑でないようにするルール:根拠があり、一般的でない(シグナルなし → 提案なし);意見があり具体的(デフォルトが選択された具体的な修正を提案 — 人間は すべて / 一部 / なし を承認);プロジェクトごとに1回(1つの統合された質問;「そのままにしておいて」を尊重);表面化し、決して静かに変更しない(特にカラーグレード:提案してプレビュー — グレイワールドの「補正」は意図的な夕日やネオンルックを台無しにする)。
どこを見るか — タスクに必要なファイルだけを読む
| タスク | 読むファイル |
|---|---|
| 解決 / 再利用 / 採用 / 取り込み、フラグ、カスケード、インベントリ | references/resolve.md |
カラーグレーディング、LUT、スマートグレード(--for)、グレード比較 | references/grading.md |
| ナレーション / TTS、音楽、SFX、キャプション、文字起こし(オーディオエンジン) | references/audio.md |
| 既存メディアの切り取り / リフレーム / 変換、正確な誤差拡散、HEVC | references/operations.md |
| ソース認識のクリエイティブトリートメント、リアルタイムエフェクト、オーバーレイ、公開 | references/media-treatments.md |
インストール + 認証、プロバイダテーブル、RAMラダー、--local-only、--provider | references/setup-providers.md |
| 記憶された設定 + 凍結されたレシピ(ユーザーメモリ) | references/memory.md |
| 所有権マトリックス、使用統計、テレメトリー、プライバシー(メンテナー向け) | references/meta.md |