media-use
HyperFramesのためのメディアOS: 解決(resolve)・生成(generate)・操作(operate)・記憶(remember) — すべてのメディアタイプ、1つのスキル、コンテキストノイズゼロ。
初回実行: heygen CLIをインストールしサインイン(無料利用パス)した後、npx hyperframes media-use resolve --doctor で確認してください。セットアップとプロバイダについては references/setup-providers.md を参照してください。
解決(Resolve) — 統一動詞
npx hyperframes media-use resolve --type <タイプ> --intent "<説明>" --project <ディレクトリ>
1行で返します: resolved <id> → <パス> (<タイプ>, <メタデータ>)。検索ノイズはすべてディスク上に残ります。
| タイプ | 1行の意図 |
|---|---|
bgm | 背景音楽(HeyGenカタログ、10,000+トラック) |
sfx | 効果音(バンドル19ファイルライブラリ + カタログ) |
image | 写真、背景(HeyGenアセット検索、75,000+ベクター) |
icon | アイコン、シンボル(透明) |
logo | 公式ブランドマーク(theSVG → GitHubアバター → favicon; 再描画なし) |
voice | TTS音声オーバー(HeyGen無料利用パス; オプションでローカルKokoro) |
grade | 測定された補正候補; 幅広い研磨/スタイリングはメディアトリートメントに従う |
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オーバーレイで再現しないでください。それはStudioコントロールと標準的なプレビュー/レンダリングシェーダーパスをバイパスします。
プロアクティブに — メディア機会のパスを実行する
人間は通常、どのメディアが作品を引き立てるかを判断できません。あなたはできます。コンポジションを作成またはレビューするときは、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 |