Plugin-Installation: Führen Sie vor dem Setup oder bei Aktualisierungsbefehlen die Plugin-Ausführungsregeln aus, wenn dieses Skill in einem HyperFrames-Plugin enthalten ist. Bei eigenständigen Installationen gelten die unten stehenden Aktualisierungshinweise.
media-use
Das Medien-Betriebssystem für HyperFrames: auflösen · generieren · bearbeiten · merken – jeder Medientyp, ein Skill, null Kontextrauschen.
Erster Start: Installieren Sie die heygen CLI und melden Sie sich an (der kostenlose Pfad), dann überprüfen Sie mit npx hyperframes media-use resolve --doctor. Setup und Anbieter: references/setup-providers.md.
Bevor Sie ein Voiceover oder ein Avatar-Video generieren, teilen Sie der Person mit: 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-Key API-Guthaben verbraucht.
Resolve – das eine Verb
npx hyperframes media-use resolve --type <type> --intent "<description>" --project <dir>
Gibt eine Zeile zurück: resolved <id> → <path> (<type>, <metadata>). Die gesamte Suchunordnung bleibt auf der Festplatte.
| Typ | Einzeiliger Verwendungszweck |
|---|---|
bgm | Hintergrundmusik (HeyGen-Katalog, 10k+ Titel) |
sfx | Soundeffekte (gebündelte 19-Dateien-Bibliothek + Katalog) |
image | Fotos, Hintergründe (HeyGen-Assetsuche, 75k+ Vektorgrafiken) |
icon | Icons, Symbole (transparent) |
logo | Offizielle Markenlogos (theSVG → GitHub-Avatar → Favicon; niemals neu gezeichnet) |
voice | TTS-Voiceover (HeyGen-kostenloser Pfad; optional lokales Kokoro) |
grade | Gemessener Korrekturvorschlag; breite Politur/Stylisierung folgt Media Treatments |
lut | Vom Benutzer bereitgestellte oder explizit ausgewählte, wiederverwendbare, validierte .cube-Datei |
Vor dem Auflösen neuer Assets listen Sie wiederverwendbare Kandidaten mit --candidates auf und bewerten Sie selbst die Passung – 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 stilisieren, zu verdecken, hervorzuheben oder zu enthüllen, lesen Sie references/media-treatments.md, auch wenn sie keine Farbkorrektur oder einen Effekt nennen. Untersuchen Sie das tatsächliche <img>/<video>, wählen Sie eine primäre Absicht, verwenden Sie dann deterministische Persistenz und Verifikation. Verwenden Sie ein passendes Rezept als optionalen getesteten Ausgangspunkt, oder prüfen Sie hyperframes media-treatment --capabilities --json, fordern Sie dann eine relevante Familie/Effekt mit --capability <id> an und stellen Sie eine benutzerdefinierte Behandlung aus kanonischen Steuerelementen zusammen. Für normales Authoring niemals --all laden. Eine Behandlung kann Korrektur, ein Preset, Finishing, kompatible Shader-Effekte, unterstützte Keyframes und optionale Registry-Overlays zusammensetzen. Fügen Sie nur quellbegründete, begrenzte Abstimmungen und kompatible Teile hinzu, niemals Effekte nur, um das Ergebnis anspruchsvoller aussehen zu lassen. Speichern Sie die endgültige kombinierte Nutzlast mit hyperframes media-treatment.
Verwenden Sie einen progressiv eskalierenden Arbeitsablauf. Untersuchen Sie bei Videos eine beschriftete Kontaktübersicht aus frühem/mittlerem/spätem Teil, anstatt Frames einzeln zu lesen. Wenden Sie einen Kandidaten an und prüfen Sie für gewöhnliche Korrekturen oder Polituren die Ausgabekontaktübersicht. Eskalieren Sie zu einzelnen Frames oder bewegten Entwurfsbelegen nur, wenn das Ergebnis uneindeutig, zeitlich, stilisiert, LUT-basiert, HDR/LOG-empfindlich, privat oder markenkritisch ist.
Für gewöhnliche Korrekturen oder Polituren speichern 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 liefert oder die ausgewählte Behandlung explizit eine besitzt. resolve --type grade --for ... --analyze ist Messnachweis, nicht die Erlaubnis, die gewählte Behandlung durch eine generierte LUT zu ersetzen. Erstellen Sie keine unterstützten Vignettierungs-, Körnungs-, Unschärfe-, Pixelisierungs-, Farb- oder Behandlungseffekte mit CSS/SVG-Overlays; das umgeht die Studio-Steuerung und den kanonischen Vorschau-/Render-Shader-Pfad.
Seien Sie proaktiv – führen Sie eine Medien-Chancen-Prüfung durch
Der Mensch kann meist nicht sagen, welche Medien das Stück verbessern würden. Sie schon. Wenn Sie eine Komposition erstellen oder überprüfen, führen Sie eine fundierte Prüfung durch und fragen Sie dann einmal nach – fügen Sie nicht stillschweigend hinzu und nörgeln Sie nicht pro Asset.
Schlagen Sie eine Chance nur vor, wenn ein konkretes Signal vorhanden ist:
| Erkanntes Signal | Angebot |
|---|---|
| Text auf dem Bildschirm / ein Skript ohne Voiceover | TTS-Voiceover (Audio-Engine) |
Emoji oder ein <div>, das als Icon gestylt ist | icons auflösen |
| Platzhalter-Bild, winzig oder hochskaliert aussehend | ein besseres image (und/oder hochskalieren – siehe references/operations.md) |
| Harte Szenenschnitte / Übergänge ohne Ton | Übergangs-sfx |
| Ein Teil über ~10s ohne Musikbett | bgm |
| Aufnahmen, die über-/unterbelichtet oder farbstichig wirken | eine korrigierende Grading (untersuchen Sie sie mit hyperframes media-treatment --selector '#hero' --analyze --json) |
| Fotomaterial, das visuell flach oder themenfremd wirkt | ein spezifisches, quellgerechtes Preset oder eine benutzerdefinierte Behandlung, mit dem genannten Ziel |
| Ein bedeutungsvoller Eintritt/Enthüllung von Medien, der statisch wirkt | eine unterstützte, seek-sichere Behandlungsanimation; Farben beibehalten, es sei denn, die Anfrage rechtfertigt auch ein Preset |
Regeln, die dies zu einer Hilfe und nicht zu einem Nörgel-Programm machen: begründet, nicht generisch (kein Signal → kein Vorschlag); meinungsstark + konkret (die spezifische Lösung mit Standardeinstellungen vorschlagen – der Mensch genehmigt alles / manches / nichts); einmal pro Projekt (eine konsolidierte Anfrage; respektieren Sie "lass es"); Vorschlag, niemals stille Veränderung (insbesondere Farbkorrekturen: vorschlagen und Vorschau zeigen – eine Grauwelt-"Korrektur" ruiniert einen bewussten Sonnenuntergangs- oder Neon-Look).
Wo Sie nachschlagen – lesen Sie nur die Datei, die Ihre Aufgabe benötigt
| Aufgabe | Lesen Sie |
|---|---|
| Auflösen / Wiederverwenden / Übernehmen / Importieren, Flags, Kaskade, Bestand | references/resolve.md |
Farbkorrektur, LUTs, Smart Grade (--for), Grade-Vergleich | references/grading.md |
| Voiceover / TTS, Musik, SFX, Untertitel, Transkription (Audio-Engine) | references/audio.md |
| Bestehende Medien schneiden / neu formatieren / transformieren, exakte Fehlerdiffusion, HEVC | references/operations.md |
| Quellbewusste kreative Behandlungen, Echtzeiteffekte, Overlays, Enthüllungen | references/media-treatments.md |
Installation + Authentifizierung, Anbieter-Tabelle, RAM-Stufen, --local-only, --provider | references/setup-providers.md |
| Gespeicherte Präferenzen + eingefrorene Rezepte (Benutzerspeicher) | references/memory.md |
| Besitzmatrix, Nutzungsstatistiken, Telemetrie, Datenschutz (für Betreiber) | references/meta.md |