Was macht media-use?
Das Medien-Betriebssystem für HyperFrames: auflösen · erzeugen · bearbeiten · merken – jeder Medientyp, ein Skill, null Kontextrauschen.
Erster Durchlauf: Installiere und melde dich in der heygen CLI an (der kostenlose Nutzungspfad), verifiziere dann mit node <SKILL_DIR>/scripts/resolve.mjs --doctor. Einrichtung und Anbieter: references/setup-providers.md.
Auflösen – das eine Verb
node <SKILL_DIR>/scripts/resolve.mjs --type <type> --intent "<description>" --project <dir>
Gibt eine Zeile zurück: resolved <id> → <path> (<type>, <metadata>). Aller 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+ Vektoren) |
icon | Icons, Symbole (transparent) |
logo | Offizielle Markenzeichen (svgl → simple-icons → GitHub-Avatar → Favicon; nie neu gezeichnet) |
voice | TTS-Sprachaufnahme (HeyGen kostenloser Pfad; optional lokales Kokoro) |
grade | Gemessene Korrekturvorschlag; breite Politur/Stilisierung folgt Medienbehandlungen |
lut | Benutzerbereitgestellte oder explizit gewählte wiederverwendbare validierte .cube-Datei |
Bevor du frische Ressourcen auflöst, liste wiederverwendbare Kandidaten mit --candidates auf und beurteile selbst die Eignung – Wiederverwendungsregeln, alle Flags, Import (--from) und Übernahme findest du in references/resolve.md.
Behandle 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, lies references/media-treatments.md – auch wenn er keine Farbkorrektur oder einen Effekt nennt. Untersuche das tatsächliche <img>/<video>, wähle eine primäre Absicht, verwende dann deterministische Persistenz und Verifikation.
Verwende ein passendes Rezept als optionalen getesteten Startpunkt oder inspiziere
hyperframes media-treatment --capabilities --json und fordere dann eine relevante Familie/einen relevanten Effekt mit --capability <id> an und stelle eine benutzerdefinierte Behandlung aus kanonischen Steuerelementen zusammen. Lade niemals --all für normales Authoring. Eine Behandlung kann Korrektur, ein Preset, Finishing, kompatible Shader-Effekte, unterstützte Keyframes und optionale Registry-Overlays kombinieren. Füge nur quellbegründete begrenzte Anpassungen und kompatible Teile hinzu, niemals Effekte nur, um das Ergebnis ausgefeilter erscheinen zu lassen. Persistiere die endgültige kombinierte Nutzlast mit
hyperframes media-treatment.
Verwende einen schrittweise eskalierenden Arbeitsablauf. Für Video inspiziere ein beschriftetes frühes/mittleres/spätes Kontaktblatt, anstatt Frames einzeln zu lesen. Wende einen Kandidaten an und inspiziere ein Nachher-Blatt für gewöhnliche Korrektur oder Politur. Eskaliere zu einzelnen Frames oder bewegten Entwurfsnachweisen nur, wenn das Ergebnis mehrdeutig, zeitlich, stilisiert, LUT-basiert, HDR/LOG-empfindlich, privat oder markenkritisch ist.
Für gewöhnliche Korrektur oder Politur persistiere das endgültige Preset/Anpassungs-JSON der Behandlung.
Erzeuge keine .cube-LUT nur, um Belichtung, Schatten, Kontrast oder
Wärme zu codieren. Verwende 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 erzeugte LUT zu ersetzen.
Erstelle keine unterstützten Vignetten-, Körnungs-, Weichzeichnungs-, Pixelierungs-, Farb- oder Behandlungseffekte mit CSS/SVG-Overlays neu; das umgeht die Studio-Steuerung und den kanonischen Vorschau-/Render-Shader-Pfad.
Sei proaktiv – führe einen Medienchancen-Durchlauf durch
Der Mensch kann meist nicht sagen, welche Medien das Stück verbessern würden. Du schon. Wenn du eine Komposition erstellst oder überprüfst, führe einen fundierten Scan durch und frage dann einmal – füge nichts stillschweigend hinzu und nörgele nicht pro Asset.
Präsentiere eine Chance nur, wenn ein konkretes Signal vorhanden ist:
| Detektiertes Signal | Angebot |
|---|---|
| Bildschirmtext / 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 wirkt | 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 |
| Aufnahmen, die unter-/überbelichtet oder farbstichig wirken | eine korrigierende Gradierung (untersuche es mit hyperframes media-treatment --selector '#hero' --analyze --json) |
| Fotografische Medien, die visuell flach oder themenfremd wirken | ein spezifisches, quellenangepasstes Preset oder eine benutzerdefinierte Behandlung mit benanntem Ziel |
| Ein bedeutungsvoller Medieneintritt/Enthüllung, der statisch wirkt | eine unterstützte, seeksichere Behandlungsanimation; Farbe beibehalten, es sei denn, die Anfrage rechtfertigt auch ein Preset |
Regeln, die das zu einer Hilfe und nicht zu einer Nörgelei machen: begründet, nicht generisch (kein Signal → kein Vorschlag); meinungsstark + konkret (schlage die spezifische Korrektur mit Standardeinstellungen vor – der Mensch genehmigt alles / einiges / nichts); einmal pro Projekt (eine konsolidierte Anfrage; respektiere „Lass es“); vorschlagen, niemals stillschweigend ändern (besonders Farbkorrekturen: vorschlagen und in der Vorschau zeigen – eine Grauwelt-„Korrektur“ ruiniert einen beabsichtigten Sonnenuntergangs- oder Neon-Look).
Wo nachschlagen – lies nur die Datei, die deine Aufgabe braucht
| Aufgabe | Lies |
|---|---|
| auflösen / wiederverwenden / übernehmen / importieren, Flags, Kaskade, Inventar | references/resolve.md |
Farbkorrektur, LUTs, Smart Grade (--for), Grade-Vergleich | references/grading.md |
| Sprachaufnahme / TTS, Musik, SFX, Untertitel, Transkription (Audio-Engine) | references/audio.md |
| vorhandene Medien schneiden / neurahmen / transformieren, 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, Privatsphäre (Maintainer-Perspektive) | references/meta.md |