Installation du plugin : Avant les commandes de configuration ou de rafraîchissement, suivez les règles d'exécution du plugin lorsque cette compétence se trouve dans un plugin HyperFrames. Les installations autonomes conservent les instructions de mise à jour ci-dessous.
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, une seule compétence, zéro bruit de contexte.
Première exécution : installez et connectez-vous à l'interface CLI heygen (le chemin d'utilisation gratuite), puis vérifiez avec npx hyperframes media-use resolve --doctor. Configuration et fournisseurs : references/setup-providers.md.
Resolve — le verbe unique
npx hyperframes media-use resolve --type <type> --intent "<description>" --project <dir>
Renvoie une ligne : resolved <id> → <path> (<type>, <metadata>). Toute recherche reste enregistrée sur le disque.
| Type | Intention en une ligne |
|---|---|
bgm | musique de fond (catalogue HeyGen, 10 000+ pistes) |
sfx | effets sonores (bibliothèque 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 (chemin gratuit HeyGen ; Kokoro local optionnel) |
grade | candidat de correction mesuré ; le polissage/stylisation large suit les traitements médias |
lut | fichier .cube validé fourni par l'utilisateur ou explicitement choisi et réutilisable |
Avant de résoudre un nouveau fichier, 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 vagues 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 mentionne pas d'étalonnage ou d'effet. Inspectez la vraie balise <img>/<video>, choisissez une intention primaire, puis utilisez la persistance déterministe et la vérification. 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 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 supportées et des superpositions optionnelles du Registre. 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 aux images 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/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 à remplacer le traitement choisi par un LUT généré. Ne recréez pas les effets de vignette, grain, flou, pixelation, couleur ou traitement supportés avec des superpositions CSS/SVG ; cela contourne les contrôles Studio et le chemin canonique de prévisualisation/rendu shader.
Soyez proactif — effectuez un passage d'opportunité média
L'humain ne peut généralement pas dire quel média améliorerait la pièce. Vous le pouvez. Lorsque vous construisez ou révisez une composition, faites un scan fondé, 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é | Offre |
|---|---|
| Texte à l'écran / un script sans voix off | Voix off TTS (moteur audio) |
Émoji ou une <div> stylisée en icône | Résoudre des icon réels |
| Image qui est un espace réservé, minuscule ou semble agrandie | Une meilleure image (et/ou agrandissement — voir references/operations.md) |
| Coupures de scène / transitions sans son | sfx de transition |
| Un morceau de plus de ~10s sans fond musical | bgm |
| Séquences semblant sous/surexposées ou avec dominante de couleur | Un étalonnage correctif (inspectez avec hyperframes media-treatment --selector '#hero' --analyze --json) |
| Un 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 nommée |
| Une entrée/révélation médiatique significative qui semble statique | Une animation de traitement compatible avec la recherche ; conservez la couleur sauf si la demande justifie aussi un préréglage |
Règles qui font que ceci reste une aide, pas un harcèlement : fondé, pas générique (pas de signal → pas de suggestion) ; tranché + concret (proposez la correction spécifique avec des valeurs par défaut choisies — l'humain approuve tout / une partie / rien) ; une fois par projet (une demande consolidée ; respectez "laissez-le") ; proposez, ne mutez jamais en silence (surtout pour les étalonnages : proposez et prévisualisez — une "correction" grise ruinerait 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, 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 |
| 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, 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é (pour les mainteneurs) | references/meta.md |