Mediennutzung
Das Medien-Betriebssystem für HyperFrames: auflösen · generieren · bearbeiten · merken — jeder Medientyp, ein Skill, null Kontextrauschen.
Erster Durchlauf: Installieren und am heygen CLI anmelden (der kostenlose Nutzungspfad), dann mit npx hyperframes media-use resolve --doctor überprüfen. Einrichtung und Anbieter: references/setup-providers.md.
Auflösen — das eine Verb
npx hyperframes media-use resolve --type <type> --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, 10.000+ Titel) |
sfx | Soundeffekte (integrierte 19-Dateien-Bibliothek + Katalog) |
image | Fotos, Hintergründe (HeyGen-Assetsuche, 75.000+ Vektoren) |
icon | Icons, Symbole (transparent) |
logo | Offizielle Markenzeichen (theSVG → GitHub-Avatar → Favicon; niemals neu gezeichnet) |
voice | TTS-Sprachaufnahme (HeyGen Free-Usage-Pfad; optional lokales Kokoro) |
grade | Gemessener Korrekturvorschlag; breite Politur/Stilisierung folgt den Medienbehandlungen |
lut | Vom Benutzer bereitgestellte oder explizit gewählte, wiederverwendbare, validierte .cube-Datei |
Bevor Sie neue Auflösungen durchführen, listen Sie wiederverwendbare Kandidaten mit --candidates auf und beurteilen Sie selbst, ob sie passen – 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, selbst wenn er keine Farbkorrektur oder Effekte benennt. Überprü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 überprüfen Sie hyperframes media-treatment --capabilities --json, fordern Sie dann eine relevante Familie/Effekt mit --capability <id> an und erstellen Sie eine benutzerdefinierte Behandlung aus kanonischen Steuerelementen. Laden Sie für die normale Autorenarbeit niemals --all. Eine Behandlung kann Korrektur, ein Preset, Finishing, kompatible Shader-Effekte, unterstützte Keyframes und optionale Registry-Overlays kombinieren. Fügen Sie nur quellenbegründete, begrenzte Abstimmung 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. Überprüfen Sie für Video ein beschriftetes Kontaktblatt mit frühen/mittleren/späten Frames, anstatt Frames separat zu lesen. Wenden Sie einen Kandidaten an und überprüfen Sie ein Nachkontaktblatt für normale Korrektur oder Politur. Eskalieren Sie zu einzelnen Frames oder bewegten Entwurfsbelegen nur, wenn das Ergebnis mehrdeutig, zeitlich, stilisiert, LUT-basiert, HDR/LOG-empfindlich, privat oder markenrelevant ist.
Für normale Korrektur 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 codieren. 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 Erlaubnis, die gewählte Behandlung durch eine generierte LUT zu ersetzen. Erstellen Sie unterstützte Vignettierungs-, Körnungs-, Unschärfe-, Pixelierungs-, Farb- oder Behandlungseffekte nicht mit CSS/SVG-Overlays nach; das umgeht die Studio-Steuerung und den kanonischen Vorschau/Render-Shader-Pfad.
Seien Sie proaktiv – führen Sie eine Medienchancen-Prüfung durch
Der Mensch kann meistens 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 Überprüfung durch und fragen Sie dann einmal — fügen Sie nichts stillschweigend hinzu und nerven Sie nicht pro Asset.
Schlagen Sie eine Chance nur vor, wenn ein konkretes Signal vorhanden ist:
| Signal erkannt | Angebot |
|---|---|
| Text auf dem Bildschirm / ein Skript ohne Sprachaufnahme | TTS-Sprachaufnahme (Audio-Engine) |
Emoji oder ein als Icon gestyltes <div> | Echte icons auflösen |
| Bild, das ein Platzhalter, winzig oder hochskaliert aussieht | Ein besseres image (und/oder hochskalieren – siehe references/operations.md) |
| Harte Szenenschnitte / Übergänge ohne Ton | Übergangs-sfx |
| Ein Stück über ~10s ohne Musikbett | bgm |
| Material, das unter/überbelichtet oder farbstichig wirkt | Eine korrigierende Gradierung (überprüfen Sie es 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 beabsichtigtem Ziel |
| Ein bedeutungsvoller Medien-Ein-/Ausstieg, der statisch wirkt | Eine unterstützte, sychronisationssichere Behandlung-Animation; Farbe beibehalten, es sei denn, die Anfrage rechtfertigt auch ein Preset |
Regeln, die dies zu einer Hilfe, nicht zu einem Nörgel-Tool machen: fundiert, nicht generisch (kein Signal → kein Vorschlag); meinungsstark + konkret (schlagen Sie die spezifische Korrektur mit Standardwerten vor – der Mensch genehmigt alles / einige / nichts); einmal pro Projekt (eine konsolidierte Anfrage; respektieren Sie "lass es"); oberflächlich, niemals stillschweigend mutieren (insbesondere Farbkorrekturen: vorschlagen und in der Vorschau zeigen – eine Grauwelt-"Korrektur" ruiniert eine absichtliche Sonnenuntergangs- oder Neon-Optik).
Wo suchen – 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, intelligente Gradierung (--for), Gradierungsvergleich | references/grading.md |
| Sprachaufnahme / TTS, Musik, SFX, Untertitel, Transkription (Audio-Engine) | references/audio.md |
| Schneiden / Umwandeln / 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 |
| Besitzmatrix, Nutzungsstatistiken, Telemetrie, Datenschutz (für Betreuer) | references/meta.md |