Que fait media-use ?
Le système multimé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 à l'interface CLI heygen (le chemin 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>
Retourne une ligne : resolved <id> → <path> (<type>, <metadata>). Tout le bruit de recherche reste sur le disque.
| Type | Intention (une ligne) |
|---|---|
bgm | musique de fond (catalogue HeyGen, 10 000+ pistes) |
sfx | effets sonores (bibliothèque intégré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é) |
voice | voix off TTS (chemin d'utilisation gratuite HeyGen ; Kokoro local optionnel) |
grade | candidat de correction mesurée ; polissage/stylisation large suit Traitements Média |
lut | fichier .cube réutilisable validé fourni par l'utilisateur ou explicitement choisi |
Avant de résoudre un nouveau fichier, lister les candidats réutilisables avec --candidates et juger par vous-même de leur pertinence — les règles de réutilisation, tous les indicateurs, l'ingestion (--from) et l'adoption sont 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 valeur 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 graine testée optionnelle, ou inspectez
hyperframes media-treatment --capabilities --json, puis demandez une famille/effet pertinent avec --capability <id> et assemblez un traitement personnalisé à partir de contrôles canoniques. Ne chargez jamais --all pour une rédaction ordinaire. Un traitement peut composer une correction, un préréglage, une finition, des effets de shader compatibles, des images clés supportées et des superpositions optionnelles de Registre. N'ajoutez que des ajustements bornés justifiés par la source et des parties compatibles, jamais des effets juste pour rendre le résultat plus sophistiqué. Persistez la charge utile combinée finale avec
hyperframes media-treatment.
Utilisez un flux de travail progressif unique. Pour la vidéo, inspectez une planche-contact étiquetée tôt/milieu/tard plutôt que de lire les trames séparément. Appliquez un candidat et inspectez une après-planche pour une correction ou un polissage ordinaire. Passez aux trames individuelles ou aux preuves de brouillon animées 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/ajustement du traitement final.
Ne générez pas de LUT .cube simplement pour encoder l'exposition, les ombres, le contraste ou la chaleur. Utilisez une LUT uniquement lorsque l'utilisateur en fournit une ou que le traitement sélectionné en possède explicitement une. resolve --type grade --for ... --analyze est une preuve de mesure, pas une permission de remplacer le traitement choisi par une LUT générée.
Ne recréez pas les effets de vignette, grain, flou, pixellisation, couleur ou traitement supportés avec des superpositions CSS/SVG ; cela contourne les contrôles Studio et le chemin canonique de shader d'aperçu/rendu.
Être proactif — effectuer un passage d'opportunité média
L'humain ne peut généralement pas dire quel média améliorerait le morceau. Vous le pouvez. Lorsque vous construisez ou révisez une composition, faites un scan fondé puis demandez une fois — n'ajoutez pas silencieusement et ne harcèlez pas par actif.
Suggérez une opportunité uniquement 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é comme une icône | Résoudre des icons réelles |
| Image qui est un espace réservé, minuscule ou qui semble agrandie | Une meilleure image (et/ou agrandissement — voir references/operations.md) |
| Coupures/transitions brusques sans son | sfx de transition |
| Un morceau de plus de ~10s sans fond musical | bgm |
| Séquences qui semblent sous/surexposées ou avec une dominance colorée | Une correction d'étalonnage (inspectez-la avec hyperframes media-treatment --selector '#hero' --analyze --json) |
| Média photographique qui semble visuellement plat ou hors sujet | Un préréglage spécifique adapté à la source ou un traitement personnalisé, avec la cible visée nommée |
| Une entrée/révélation média significative qui semble statique | Une animation de traitement supportée et sans risque de décalage ; préservez la couleur sauf si la demande justifie aussi un préréglage |
Règles pour que cela reste une aide, pas du harcèlement : fondé, pas générique (pas de signal → pas de suggestion) ; avisé + concret (proposez la correction spécifique avec des valeurs par défaut choisies — l'humain approuve tout / certains / rien) ; une fois par projet (une demande consolidée ; respectez "laissez-le") ; suggérez, ne modifiez jamais silencieusement (les corrections colorimétriques surtout : proposez et prévisualisez — une "correction" grise ruine un coucher de soleil ou un look néon intentionnel).
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, LUTs, correction intelligente (--for), comparaison d'étalonnage | references/grading.md |
| voix off / TTS, musique, SFX, sous-titres, transcription (moteur audio) | references/audio.md |
| couper / recadrer / transformer un média existant, diffusion d'erreur exacte, HEVC | references/operations.md |
| traitements créatifs conscients de la source, effets temps réel, superpositions, révélations | references/media-treatments.md |
installer + authentification, tableau des fournisseurs, échelons RAM, --local-only, --provider | references/setup-providers.md |
| préférences mémorisées + recettes figé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 |