Plugin-Installation: Bevor Sie Setup- oder Aktualisierungsbefehle ausführen, beachten Sie die Plugin-Ausführungsregeln, wenn dieser Skill Teil eines HyperFrames-Plugins ist. Bei eigenständigen Installationen gelten die unten stehenden Update-Hinweise.
Mediennutzung
Das Media-Betriebssystem für HyperFrames: Auflösen · Generieren · Bearbeiten · Merken – jeder Medientyp, ein Skill, null Kontextrauschen.
Erster Start: Installieren und melden Sie sich bei der heygen CLI an (kostenloser Pfad), dann überprüfen Sie mit npx hyperframes media-use resolve --doctor. Einrichtung und Anbieter: references/setup-providers.md.
Auflösen – das eine Verb
npx hyperframes media-use resolve --type <Typ> --intent "<Beschreibung>" --project <Verzeichnis>
Gibt eine Zeile zurück: resolved <ID> → <Pfad> (<Typ>, <Metadaten>). Der gesamte Suchlärm bleibt auf der Festplatte.
| Typ | Einzeilige Absicht |
|---|---|
bgm | Hintergrundmusik (HeyGen-Katalog, 10k+ Titel) |
sfx | Soundeffekte (gebündelte 19-Datei-Bibliothek + Katalog) |
image | Fotos, Hintergründe (HeyGen-Assetsuche, 75k+ Vektorgrafiken) |
icon | Symbole, Icons (transparent) |
logo | Offizielle Markenzeichen (theSVG → GitHub-Avatar → Favicon; nie neu gezeichnet) |
voice | TTS-Sprachausgabe (HeyGen-Kostenlos-Pfad; optional lokales Kokoro) |
grade | Gemessener Korrekturvorschlag; breite Verfeinerung/Stylisierung folgt Media Treatments |
lut | Benutzerdefinierte oder explizit gewählte, wiederverwendbare validierte .cube-Datei |
Vor dem Auflösen frischer Assets listen Sie wiederverwendbare Kandidaten mit --candidates auf und beurteilen Sie selbst die Eignung – Wiederverwendungsregeln, alle Flags, Import (--from) und Übernahme finden Sie in references/resolve.md.
Behandeln Sie breites visuelles Feedback als Medienabsicht
Wenn ein Benutzer explizit darum bittet, fotografische Medien zu korrigieren, zu polieren, zu stylisieren, zu verdecken, hervorzuheben oder freizulegen, lesen Sie references/media-treatments.md, auch wenn er keine Farbkorrektur oder einen Effekt nennt. Prüfen Sie das tatsächliche <img>/<video>, wählen Sie eine primäre Absicht, verwenden Sie dann deterministische Persistenz und Verifizierung. Verwenden Sie ein passendes Rezept als optionalen getesteten Startwert oder prüfen Sie hyperframes media-treatment --capabilities --json, fordern Sie dann eine relevante Familie/einen Effekt mit --capability <ID> an und stellen Sie eine benutzerdefinierte Behandlung aus kanonischen Steuerelementen zusammen. Laden Sie für normales Erstellen niemals --all. Eine Behandlung kann Korrektur, ein Preset, Finishing, kompatible Shader-Effekte, unterstützte Keyframes und optionale Registry-Überlagerungen kombinieren. Fügen Sie nur quellenbegründete, begrenzte Anpassungen und kompatible Teile hinzu, niemals Effekte, nur um das Ergebnis anspruchsvoller aussehen zu lassen. Persistieren Sie die endgültige kombinierte Nutzlast mit hyperframes media-treatment.
Verwenden Sie einen schrittweise eskalierenden Workflow. Prüfen Sie bei Videos eine beschriftete Kontaktliste von frühen/mittleren/späten Frames, anstatt Frames separat zu lesen. Wenden Sie einen Kandidaten an und prüfen Sie für gewöhnliche Korrekturen oder Politur eine Nachher-Kontaktliste. Eskalieren Sie zu einzelnen Frames oder bewegten Entwurfsbeweisen nur, wenn das Ergebnis mehrdeutig, zeitlich, stilisiert, LUT-basiert, HDR/LOG-empfindlich, privat oder markenkritisch ist.
Für gewöhnliche Korrekturen oder Politur persistieren Sie das Preset/Anpassungs-JSON der endgültigen Behandlung. Generieren Sie keine .cube-LUT, nur um Belichtung, Schatten, Kontrast oder Wärme zu kodieren. Verwenden Sie eine LUT nur, wenn der Benutzer eine bereitstellt oder die ausgewählte Behandlung explizit eine besitzt. resolve --type grade --for ... --analyze ist Messnachweis, keine Berechtigung, die gewählte Behandlung durch eine generierte LUT zu ersetzen. Erstellen Sie unterstützte Vignetten-, Körnungs-, Unschärfe-, Pixel-, Farb- oder Behandlungseffekte nicht mit CSS/SVG-Overlays nach; dies umgeht Studio-Steuerelemente und den kanonischen Vorschau-/Rendering-Shader-Pfad.
Seien Sie proaktiv – führen Sie einen Medienchancen-Durchlauf durch
Der Mensch kann normalerweise nicht sagen, welche Medien das Stück aufwerten würden. Sie können. Wenn Sie eine Komposition erstellen oder überprüfen, führen Sie einen fundierten Scan durch und fragen Sie dann einmal – fügen Sie nichts stillschweigend hinzu und nörgeln Sie nicht an jedem Asset.
Schlagen Sie eine Chance nur dann vor, wenn ein konkretes Signal vorliegt:
| Detektiertes Signal | Angebot |
|---|---|
| Text auf dem Bildschirm / ein Skript ohne Sprachausgabe | TTS-Sprachausgabe (Audio-Engine) |
Emoji oder ein <div>, das als Icon gestylt ist | echte icons auflösen |
| Bild, das ein Platzhalter, winzig oder hochskaliert aussieht | ein besseres image (und/oder Upscaling – siehe references/operations.md) |
| Harte Szenenschnitte / Übergänge ohne Ton | Übergangs-sfx |
| Ein Stück länger als ~10s ohne Musikbett | bgm |
| Filmmaterial, das unter-/überbelichtet oder farbstichig wirkt | eine korrektive Gradierung (prüfen mit hyperframes media-treatment --selector '#hero' --analyze --json) |
| Fotografisches Medium, das visuell flach oder themenfremd wirkt | ein spezifisches, quellenangepasstes Preset oder eine benutzerdefinierte Behandlung mit benanntem Ziel |
| Eine bedeutungsvolle Medien-Einblendung/-Enthüllung, die statisch wirkt | eine unterstützte suchsichere Behandlungsanimation; Farbe erhalten, es sei denn, die Anfrage rechtfertigt auch ein Preset |
Regeln, die dies zu einer Hilfe machen, nicht zu Nörgelware: fundiert, nicht generisch (kein Signal → kein Vorschlag); meinungsstark + konkret (die spezifische Lösung mit Standardwerten vorschlagen – der Mensch genehmigt alles / etwas / nichts); einmal pro Projekt (eine konsolidierte Anfrage; „lass es“ respektieren); an der Oberfläche, niemals stillschweigend mutieren (besonders Farbkorrekturen: vorschlagen und Vorschau anzeigen – eine Grauwelt-„Korrektur“ ruiniert einen absichtlichen Sonnenuntergang oder Neon-Look).
Wo suchen – lesen Sie nur die Datei, die Ihre Aufgabe benötigt
| Aufgabe | Lesen |
|---|---|
| Auflösen / Wiederverwenden / Übernehmen / Importieren, Flags, Kaskade, Inventar | references/resolve.md |
Farbkorrektur, LUTs, intelligente Gradierung (--for), Gradierung-Vergleich | references/grading.md |
| Sprachausgabe / TTS, Musik, SFX, Untertitel, Transkription (Audio-Engine) | references/audio.md |
| Schneiden / Umrahmen / Transformieren vorhandener Medien, exakte Fehlerdiffusion, HEVC | references/operations.md |
| Quellenbewusste kreative Behandlungen, Echtzeiteffekte, Overlays, Enthüllungen | references/media-treatments.md |
Installation + Authentifizierung, Anbietertabelle, RAM-Stufen, --local-only, --provider | references/setup-providers.md |
| Gespeicherte Präferenzen + eingefrorene Rezepte (Benutzerspeicher) | references/memory.md |
| Eigentumsmatrix, Nutzungsstatistiken, Telemetrie, Datenschutz (für Betreuer) | references/meta.md |