media-use
Le système d'exploitation media pour HyperFrames : résoudre · générer · opérer · mémoriser — tous types de médias, une seule compétence, zéro bruit de contexte.
Première exécution : installez et connectez-vous à la CLI heygen (voie d'utilisation gratuite), puis vérifiez avec npx hyperframes media-use resolve --doctor. Configuration et fournisseurs : references/setup-providers.md.
Résoudre — le verbe unique
npx hyperframes media-use resolve --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 en 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 (theSVG → avatar GitHub → favicon ; jamais redessiné) |
voice | voix off TTS (voie d'utilisation gratuite HeyGen ; Kokoro local optionnel) |
grade | candidat de correction mesurée ; polissage / stylisation large suivent les traitements media |
lut | fichier .cube validé fourni par l'utilisateur ou explicitement choisi et réutilisable |
Avant de résoudre du neuf, listez les candidats réutilisables avec --candidates et jugez vous-même de leur pertinence — les règles de réutilisation, tous les drapeaux, l'ingestion (--from) et l'adoption sont dans references/resolve.md.
Traiter les retours visuels larges comme une intention media
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 d'étalonnage ou d'effet. Inspectez le vrai <img>/<video>, choisissez une intention principale, puis utilisez une persistance et une 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 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. Ajoutez uniquement 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 flux de travail 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 à des images individuelles ou à des preuves d'ébauche 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 de préréglage/réglage du traitement final.
Ne générez pas de LUT .cube simplement pour encoder l'exposition, les ombres, le contraste ou la chaleur. Utilisez un LUT uniquement lorsque l'utilisateur en fournit un ou que le traitement sélectionné en possède explicitement un. resolve --type grade --for ... --analyze est une preuve de mesure, pas une autorisation pour remplacer le traitement choisi par un LUT généré. Ne recréez pas les effets de vignettage, grain, flou, pixelisation, couleur ou traitement pris en charge avec des superpositions CSS/SVG ; cela contourne les contrôles Studio et le chemin de rendu/previsualisation canonique du shader.
Soyez proactif — effectuez un passage d'opportunité media
L'humain ne peut généralement pas dire quel média améliorerait le projet. Vous, si. Lorsque vous créez ou révisez une composition, effectuez un scan fondé, puis demandez une fois — n'ajoutez pas en silence et ne harcèlez 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é comme une icône | Résoudre de vraies icons |
| Image qui est un espace réservé, minuscule ou qui semble agrandie | Une meilleure image (et/ou agrandissement — voir references/operations.md) |
| Coupes de scène brutales / transitions sans son | sfx de transition |
| Un morceau de plus de ~10 s sans fond musical | bgm |
| Séquence qui semble sous/surexposée ou avec dominante colorée | Un étalonnage correctif (inspectez-le 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 adapté à la source, avec la cible visée nommée |
| Une entrée/révélation média significative qui semble statique | Une animation de traitement compatible avec la recherche ; préservez la couleur sauf si la demande justifie aussi un préréglage |
Règles qui font que cela reste une aide, pas un harcèlement : fondé, pas générique (pas de signal → pas de suggestion) ; avisé + concret (proposez la correction spécifique avec les valeurs par défaut choisies — l'humain approuve tout / en partie / rien) ; une fois par projet (une demande consolidée ; respectez "laissez tel quel") ; proposez, ne mutez jamais en silence (les étalonnages 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 | Lisez |
|---|---|
| résoudre / réutiliser / adopter / ingérer, drapeaux, cascade, inventaire | references/resolve.md |
étalonnage, LUTs, étalonnage intelligent (--for), comparaison d'étalonnage | references/grading.md |
| voix off / TTS, musique, SFX, sous-titres, transcription (moteur audio) | references/audio.md |
| découper / recadrer / transformer des médias existants, 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 |
installation + authentification, table 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é aux mainteneurs) | references/meta.md |