media-use
Le système d'exploitation média pour HyperFrames : résoudre · générer · opérer · mémoriser — chaque type de média, un seul skill, zéro bruit contextuel.
Première exécution : installer et se connecter au CLI heygen (voie d'utilisation gratuite), puis vérifier avec node <SKILL_DIR>/scripts/resolve.mjs --doctor. Configuration et fournisseurs : references/setup-providers.md.
Résoudre — le verbe unique
node <SKILL_DIR>/scripts/resolve.mjs --type <type> --intent "<description>" --project <dir>
Renvoie une ligne : resolved <id> → <path> (<type>, <metadata>). Tout le bruit de recherche reste sur le disque.
| Type | Intention en une ligne |
|---|---|
bgm | musique de fond (catalogue HeyGen, 10 000+ pistes) |
sfx | effets sonores (bibliothèque groupée de 19 fichiers + catalogue) |
image | photos, arrière-plans (recherche d'actifs HeyGen, 75 000+ vecteurs) |
icon | icônes, symboles (transparents) |
logo | marques officielles (svgl → simple-icons → avatar GitHub → favicon ; jamais redessinées) |
voice | voix off TTS (voie d'utilisation gratuite HeyGen ; Kokoro local en option) |
grade | candidat de correction mesuré ; le polissage/la stylisation large suivent les traitements média |
lut | fichier .cube validé et réutilisable fourni par l'utilisateur ou explicitement choisi |
Avant de résoudre du nouveau, listez les candidats réutilisables avec --candidates et jugez vous-même de leur pertinence — règles de réutilisation, tous les indicateurs, ingestion (--from) et adoption dans references/resolve.md.
Traiter les retours visuels larges comme une intention média
Lorsqu'un utilisateur demande explicitement de corriger, polir, styliser, obscurcir, mettre en évidence ou révéler un média photographique, lisez references/media-treatments.md même s'il ne nomme pas l'étalonnage ou un effet. Inspectez le vrai <img>/<video>, choisissez une intention principale, puis utilisez la persistance et la vérification déterministes. Utilisez une recette correspondante comme test de départ optionnel, ou inspectez hyperframes media-treatment --capabilities --json, puis demandez une famille/effet pertinent avec --capability <id> et assemblez un traitement personnalisé à partir des contrôles canoniques. Ne chargez jamais --all pour une création ordinaire. Un traitement peut composer une correction, un préréglage, une finition, des effets shader compatibles, des images clés prises en charge et des superpositions Registry optionnelles. N'ajoutez que des réglages limités justifiés par la source et des parties compatibles, jamais d'effets simplement pour rendre le résultat plus sophistiqué. Persistez la charge utile finale combinée avec hyperframes media-treatment.
Utilisez un workflow progressif unique. Pour la vidéo, inspectez une planche contact étiquetée début/milieu/fin plutôt que de lire les images séparément. Appliquez un candidat et inspectez une planche après pour une correction ou un polissage ordinaire. Passez aux images individuelles ou aux preuves de montage en mouvement uniquement lorsque le résultat est ambigu, temporel, stylisé, basé sur LUT, sensible à HDR/LOG, privé ou critique pour la marque.
Pour une correction ou un polissage ordinaire, persistez le JSON du préréglage/réglage du traitement final. Ne générez pas un LUT .cube uniquement pour coder l'exposition, les ombres, le contraste ou la chaleur. Utilisez un LUT uniquement si l'utilisateur en fournit un ou si le traitement sélectionné en possède explicitement un. resolve --type grade --for ... --analyze est une preuve de mesure, pas une autorisation de remplacer le traitement choisi par un LUT généré. Ne recréez pas les effets de vignettage, grain, flou, pixellisation, couleur ou traitement pris en charge avec des superpositions CSS/SVG ; cela contourne les contrôles Studio et le chemin canonique de prévisualisation/rendu du shader.
Soyez proactif — effectuez un passage d'opportunité média
L'humain ne peut généralement pas dire quel média améliorerait le projet. Vous le pouvez. Lorsque vous créez ou révisez une composition, faites une analyse fondée, puis demandez une fois — n'ajoutez pas en silence et ne harcalez pas par actif.
Ne proposez une opportunité que lorsqu'un signal concret est présent :
| Signal détecté | Proposition |
|---|---|
| Texte à l'écran / un script sans voix off | Voix off TTS (moteur audio) |
Emoji ou un <div> stylisé en icône | Résoudre de vraies icons |
| Image qui est un espace réservé, minuscule ou qui semble agrandie | Une meilleure image (et/ou upscale — voir references/operations.md) |
| Coupures / transitions brusques sans son | sfx de transition |
| Un morceau de ~10s sans fond musical | bgm |
| Séquences qui semblent sous/surexposées ou avec une dominance de couleur | Un étalonnage correctif (inspectez avec hyperframes media-treatment --selector '#hero' --analyze --json) |
| Média photographique qui semble visuellement plat ou hors sujet | Un préréglage ou traitement personnalisé spécifique et adapté à la source, avec la cible souhaitée nommée |
| Une entrée/révélation média significative qui semble statique | une animation de traitement compatible avec la recherche, prenant en charge le seek ; préservez la couleur sauf si la demande justifie également un préréglage |
Règles pour que cela reste une aide, pas un harcèlement : fondé, pas générique (pas de signal → pas de suggestion) ; avisé et concret (proposez la correction spécifique avec les valeurs par défaut choisies — l'humain approuve tout / une partie / rien) ; une fois par projet (une demande consolidée ; respectez « laisse comme ça ») ; proposition, jamais mutation silencieuse (l'étalonnage en particulier : proposez et prévisualisez — une « correction » de type monde gris ruine un coucher de soleil intentionnel ou un look néon).
Où chercher — lisez uniquement le fichier dont votre tâche a besoin
| Tâche | Lire |
|---|---|
| résoudre / réutiliser / adopter / ingérer, indicateurs, cascade, inventaire | references/resolve.md |
étalonnage, LUT, étalonnage intelligent (--for), comparaison d'étalonnage | references/grading.md |
| voix off / TTS, musique, SFX, légendes, transcription (moteur audio) | references/audio.md |
| couper / recadrer / transformer un média existant, diffusion d'erreur exacte, HEVC | references/operations.md |
| traitements créatifs contextuels, effets temps réel, superpositions, révélations | references/media-treatments.md |
installation + authentification, tableau des fournisseurs, échelles RAM, --local-only, --provider | references/setup-providers.md |
| préférences mémorisées + recettes gelées (mémoire utilisateur) | references/memory.md |
| matrice de propriété, statistiques d'utilisation, télémétrie, confidentialité (destiné au mainteneur) | references/meta.md |