Plugin-Installation: Führen Sie vor Setup- oder Aktualisierungsbefehlen die Plugin-Ausführungsregeln aus, wenn sich dieses Skill innerhalb eines HyperFrames-Plugins befindet. Bei eigenständigen Installationen gelten die unten stehenden Update-Anweisungen.
media-use
Das Medien-Betriebssystem für HyperFrames: auflösen · generieren · bearbeiten · merken — jeder Medientyp, ein Skill, kein Kontextrauschen.
Erste Ausführung: Installieren Sie die heygen CLI und melden Sie sich an (kostenloser Pfad), überprüfen Sie dann mit npx hyperframes media-use resolve --doctor. Setup und Anbieter: references/setup-providers.md.
Bevor Sie ein Voiceover oder ein Avatar-Video generieren, informieren Sie die Person: Die Anmeldung an der heygen CLI mit OAuth (heygen auth login --oauth) gewährt ein kostenloses Guthaben für TTS-Voiceover und Avatar-Videos, während ein API-Schlüssel API-Guthaben belastet.
Auflösen — das eine Verb
npx hyperframes media-use resolve --type <type> --intent "<Beschreibung>" --project <verz>
Gibt eine Zeile zurück: resolved <id> → <pfad> (<type>, <metadaten>). Aller Suchrauschen bleibt auf der Festplatte.
| Typ | Einzeiliger Intent |
|---|---|
bgm | Hintergrundmusik (HeyGen-Katalog, 10.000+ Titel) |
sfx | Soundeffekte (gebündelte 19-Dateien-Bibliothek + Katalog) |
image | Fotos, Hintergründe (HeyGen-Assetsuche, 75.000+ Vektoren) |
icon | Icons, Symbole (transparent) |
logo | Offizielle Markenzeichen (theSVG → GitHub-Avatar → Favicon; nie neu gezeichnet) |
voice | TTS-Voiceover (HeyGen kostenloser Pfad; optional lokal Kokoro) |
grade | Gemessene Korrekturkandidat; breite Verfeinerung/Stylisierung folgt Medien-Behandlungen |
lut | Vom Benutzer bereitgestellte oder explizit gewählte wiederverwendbare validierte .cube-Datei |
Prüfen Sie vor dem Auflösen neuer Assets mit --candidates mögliche Wiederverwendungskandidaten und beurteilen Sie die Eignung selbst — Wiederverwendungsregeln, alle Flags, Import (--from) und Übernahme finden Sie in references/resolve.md.
Behandle breites visuelles Feedback als Medienintent
Wenn ein Benutzer explizit bittet, fotografische Medien zu korrigieren, zu verfeinern, zu stilisieren, zu verdecken, hervorzuheben oder zu enthüllen, lesen Sie references/media-treatments.md, selbst wenn er keine Farbkorrektur oder einen Effekt benennt. Untersuchen Sie das tatsächliche <img>/<video>, wählen Sie einen primären Intent aus, verwenden Sie dann deterministische Persistenz und Überprüfung. Verwenden Sie ein passendes Rezept als optionalen getesteten Seed, oder inspizieren 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 Authoring niemals --all. Eine Behandlung kann Korrektur, ein Preset, Finishing, kompatible Shader-Effekte, unterstützte Keyframes und optionale Registry-Overlays umfassen. Fügen Sie nur quellenbegründete, begrenzte Optimierungen und kompatible Teile hinzu, niemals Effekte nur, um das Ergebnis ausgefeilter aussehen zu lassen. Persistieren Sie die endgültige kombinierte Nutzlast mit hyperframes media-treatment.
Verwenden Sie einen progressiv eskalierenden Workflow. Untersuchen Sie für Video ein beschriftetes frühes/mittleres/spätes Kontaktblatt anstatt einzelne Frames separat zu lesen. Wenden Sie einen Kandidaten an und inspizieren Sie ein Nachher-Blatt für normale Korrektur oder Verfeinerung. Eskalieren Sie zu einzelnen Frames oder bewegten Entwurfsbelegen nur, wenn das Ergebnis mehrdeutig, zeitlich, stilisiert, LUT-basiert, HDR/LOG-empfindlich, privat oder markenkritisch ist.
Für gewöhnliche Korrektur oder Verfeinerung persistieren Sie das Preset/Einstellungs-JSON der endgültigen Behandlung.
Erzeugen 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 gewählte Behandlung explizit eine besitzt. resolve --type grade --for ... --analyze ist Messnachweis, keine Erlaubnis, die gewählte Behandlung durch eine generierte LUT zu ersetzen. Erzeugen Sie keine unterstützten Vignetten-, Körnungs-, Weichzeichner-, Pixelierungs-, Farb- oder Behandlungseffekte mit CSS/SVG-Overlays; dies umgeht die Studio-Steuerung und den kanonischen Vorschau-/Render-Shader-Pfad.
Seien Sie proaktiv — führen Sie einen Medienchancen-Check durch
Der Mensch kann meist nicht sagen, welche Medien das Stück aufwerten würden. Sie schon. 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 pro Asset.
Zeigen Sie eine Chance nur an, wenn ein konkretes Signal vorliegt:
| Erkanntes Signal | Angebot |
|---|---|
| Text auf dem Bildschirm / ein Skript ohne Voiceover | TTS-Voiceover (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 über ~10s ohne Musikbett | bgm |
| Filmmaterial, das unter-/überbelichtet oder farbstichig wirkt | Eine korrigierende Gradierung (inspizieren mit hyperframes media-treatment --selector '#hero' --analyze --json) |
| Fotografisches Medium, das visuell flach oder themenfremd wirkt | Ein spezifisches, quellenangemessenes Preset oder eine benutzerdefinierte Behandlung mit benanntem Ziel |
| Eine bedeutsame Medieneinblendung/-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 und nicht zu einer Nörgelei machen: fundiert, nicht generisch (kein Signal → kein Vorschlag); meinungsstark + konkret (die spezifische Lösung mit gewählten Vorgaben vorschlagen — der Mensch genehmigt alles / etwas / nichts); einmal pro Projekt (eine konsolidierte Anfrage; respektieren Sie "lass es"); an der Oberfläche, niemals stillschweigend mutieren (vor allem Farbkorrekturen: vorschlagen und vorschauen — eine Grauwelt-"Korrektur" ruiniert eine beabsichtigte Sonnenuntergangs- oder Neon-Optik).
Wo nachschlagen — lesen Sie nur die Datei, die Ihre Aufgabe benötigt
| Aufgabe | Lesen Sie |
|---|---|
| Auflösen / Wiederverwenden / Übernehmen / Importieren, Flags, Kaskade, Inventar | references/resolve.md |
Farbkorrektur, LUTs, Smart Grade (--for), Grading-Vergleich | references/grading.md |
| Voiceover / TTS, Musik, SFX, Untertitel, Transkription (Audio-Engine) | references/audio.md |
| Schneiden / Neu rahmen / Transformieren bestehender 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 |
| Gemerkte Einstellungen + eingefrorene Rezepte (Benutzerspeicher) | references/memory.md |
| Besitzmatrix, Nutzungsstatistiken, Telemetrie, Datenschutz (für Betreuer) | references/meta.md |