media-use
Das Medien-Betriebssystem für HyperFrames: auflösen · generieren · bearbeiten · merken — jeder Medientyp, ein Skill, null Kontextrauschen.
Erster Durchlauf: Installiere und melde dich in der heygen-CLI an (kostenloser Nutzungspfad), überprüfe 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 <Typ> --intent "<Beschreibung>" --project <Verzeichnis>
Gibt eine Zeile zurück: resolved <ID> → <Pfad> (<Typ>, <Metadaten>). Der gesamte Suchlärm bleibt auf der Platte.
| Typ | Einzeilige Absicht |
|---|---|
bgm | Hintergrundmusik (HeyGen-Katalog, 10k+ Tracks) |
sfx | Soundeffekte (gebündelte 19-Dateien-Bibliothek + Katalog) |
image | Fotos, Hintergründe (HeyGen-Assetsuche, 75k+ Vektoren) |
icon | Icons, Symbole (transparent) |
logo | Offizielle Markenlogos (svgl → simple-icons → GitHub-Avatar → Favicon; niemals neu gezeichnet) |
voice | TTS-Sprachaufnahme (HeyGen-kostenloser Pfad; optional lokales Kokoro) |
grade | Gemessener Korrekturvorschlag; breite Optimierung/Stylisierung folgt Medienbehandlungen |
lut | Benutzerbereitgestellte oder explizit gewählte, wiederverwendbare, validierte .cube-Datei |
Vor einer Neuauflösung liste wiederverwendbare Kandidaten mit --candidates auf und beurteile die Passung selbst — Wiederverwendungsregeln, alle Flags, Import (--from) und Übernahme findest du in references/resolve.md.
Behandle breites visuelles Feedback als Medienabsicht
Wenn ein Benutzer explizit bittet, fotografische Medien zu korrigieren, zu polieren, zu stylisieren, zu verdecken, hervorzuheben oder zu enthüllen, lies references/media-treatments.md, auch wenn er keine Farbkorrektur oder einen Effekt nennt. Untersuche das echte <img>/<video>, wähle eine primäre Absicht, verwende dann deterministische Persistenz und Verifikation. Verwende ein passendes Rezept als optionalen getesteten Ausgangspunkt oder inspiziere hyperframes media-treatment --capabilities --json, fordere dann eine relevante Familie/einen Effekt mit --capability <ID> an und stelle eine benutzerdefinierte Behandlung aus kanonischen Steuerelementen zusammen. Lade niemals --all für gewöhnliches Authoring. Eine Behandlung kann Korrektur, ein Preset, Finish, kompatible Shader-Effekte, unterstützte Keyframes und optionale Registry-Overlays umfassen. Füge nur quellgerechtfertigte begrenzte Anpassungen und kompatible Teile hinzu, niemals Effekte nur, um das Ergebnis ausgefeilter aussehen zu lassen. Persistiere die endgültige kombinierte Nutzlast mit hyperframes media-treatment.
Verwende einen schrittweise eskalierenden Arbeitsablauf. Untersuche für Video einen beschrifteten frühen/mittleren/späten Kontaktbogen, anstatt Frames einzeln zu lesen. Wende einen Kandidaten an und untersuche einen Nachbogen für gewöhnliche Korrektur oder Optimierung. Eskaliere zu einzelnen Frames oder bewegten Entwurfsbelegen nur, wenn das Ergebnis mehrdeutig, zeitlich, stylisiert, LUT-basiert, HDR/LOG-empfindlich, privat oder markenkritisch ist.
Für gewöhnliche Korrektur oder Optimierung persistiere das Preset/Anpassungs-JSON der endgültigen Behandlung. Generiere keine .cube-LUT, nur um Belichtung, Schatten, Kontrast oder Wärme zu kodieren. Verwende eine LUT nur, wenn der Benutzer eine bereitstellt oder die gewählte Behandlung explizit eine besitzt. resolve --type grade --for ... --analyze ist ein Messbeleg, keine Erlaubnis, die gewählte Behandlung durch eine generierte LUT zu ersetzen. Erstelle keine unterstützten Vignetten-, Körnungs-, Weichzeichnungs-, Pixelierungs-, Farb- oder Behandlungseffekte mit CSS/SVG-Overlays; das umgeht die Studio-Steuerelemente und den kanonischen Vorschau-/Render-Shader-Pfad.
Sei proaktiv — führe einen Medien-Chancen-Durchlauf durch
Der Mensch kann normalerweise nicht sagen, welche Medien das Stück aufwerten würden. Du schon. Wenn du eine Komposition erstellst oder überprüfst, führe einen fundierten Scan durch und frage dann einmal nach — füge nichts stillschweigend hinzu und belästige nicht pro Asset.
Zeige eine Chance nur an, wenn ein konkretes Signal vorhanden ist:
| Erkanntes Signal | Angebot |
|---|---|
| Text auf dem Bildschirm / ein Skript ohne Sprachaufnahme | TTS-Sprachaufnahme (Audio-Engine) |
Emoji oder ein <div>, das wie ein Icon gestylt ist | Löse echte icons auf |
| 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 Abschnitt über ~10s ohne Musikbett | bgm |
| Material, das unter-/überbelichtet oder farbstichig wirkt | eine korrigierende Grading (untersuche mit hyperframes media-treatment --selector '#hero' --analyze --json) |
| Fotografische Medien, die visuell flach oder themenfremd wirken | ein spezifisches, quellgerechtes Preset oder eine benutzerdefinierte Behandlung mit genanntem Ziel |
| Ein bedeutungsvoller Medieneintritt/-auftakt, der statisch wirkt | eine unterstützte suchsichere Behandlungsanimation; Farbe erhalten, sofern die Anfrage nicht auch ein Preset rechtfertigt |
Regeln, die dies zu einer Hilfe machen, nicht zu einer Belästigung: fundiert, nicht generisch (kein Signal → kein Vorschlag); meinungsstark + konkret (schlage die spezifische Lösung mit gewählten Standardwerten vor — der Mensch stimmt allen / einigen / keinen zu); einmal pro Projekt (eine konsolidierte Anfrage; respektiere „Lass es“); anzeigen, niemals stillschweigend mutieren (besonders Farbkorrekturen: Vorschlagen und in der Vorschau anzeigen — eine Grauwelt-„Korrektur“ ruiniert einen gezielten Sonnenuntergangs- oder Neon-Look).
Wo nachschlagen — lies nur die Datei, die deine Aufgabe benötigt
| Aufgabe | Lese |
|---|---|
| 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 |
| Schneiden / Neu einrahmen / Transformieren vorhandener Medien, exakte Fehlerdiffusion, HEVC | references/operations.md |
| Quellbewusste 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 |