Installation du plugin : Avant les commandes de configuration ou de fraîcheur, 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.
Avant de générer une voix off ou une vidéo avatar, dites à la personne : la connexion à l'interface CLI heygen avec OAuth (heygen auth login --oauth) donne une allocation gratuite pour la voix off TTS et les vidéos avatar, tandis qu'une clé API facture des crédits API.
Résoudre — le verbe unique
npx hyperframes media-use resolve --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, 10k+ pistes) |
sfx | effets sonores (bibliothèque groupée de 19 fichiers + catalogue) |
image | photos, arrière-plans (recherche d'actifs HeyGen, 75k+ vecteurs) |
icon | icônes, symboles (transparents) |
logo | marques officielles (theSVG → avatar GitHub → favicon ; jamais redessiné) |
voice | voix off TTS (chemin d'utilisation gratuite HeyGen ; Kokoro local optionnel) |
grade | candidat de correction mesuré ; polissage/stylisation large suit les traitements média |
lut | fichier .cube validé 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 adéquation — 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 d'étalonnage couleur ou d'effet. Inspectez la vraie balise <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 correction, préréglage, finition, effets shader compatibles, images clés prises en charge et 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 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 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 de préréglage/ajustement du traitement final. Ne générez pas de LUT .cube uniquement 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 autorisation pour 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 pris en charge avec des superpositions CSS/SVG ; cela contourne les contrôles Studio et le chemin canonique de rendu/preview shader.
Soyez proactif — effectuez une passe 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 créez ou examinez une composition, faites une analyse fondée, puis demandez une fois — n'ajoutez pas en silence, et ne harcèlez pas par actif.
Ne signalez 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) |
Emoji ou une balise <div> stylisée comme icône | résoudre de véritables icons |
| Image qui est un espace réservé, petite ou semble agrandie | une meilleure image (et/ou agrandissement — voir references/operations.md) |
| Coupures de scène nettes / transitions sans son | sfx de transition |
| Une pièce de plus de ~10s sans fond musical | bgm |
| Séquences qui semblent sous/surexposées ou avec dominante couleur | une correction (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 à 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 prise en charge et sans décalage ; conservez la couleur sauf si la demande justifie aussi un préréglage |
Règles qui font de cela une aide, pas un outil de 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 / aucun) ; une fois par projet (une demande consolidée ; respectez « laisse tomber ») ; signalez, ne mute jamais en silence (étalonnages couleur surtout : proposez et prévisualisez — une « correction » grise 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 | Lisez |
|---|---|
| résoudre / réutiliser / adopter / ingérer, indicateurs, cascade, inventaire | references/resolve.md |
étalonnage couleur, LUT, niveau intelligent (--for), comparaison de niveaux | references/grading.md |
| voix off / TTS, musique, SFX, sous-titres, transcription (moteur audio) | references/audio.md |
| couper / recadrer / transformer des médias existants, diffusion exacte d'erreurs, 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 figées (mémoire utilisateur) | references/memory.md |
| matrice de propriété, statistiques d'utilisation, télémétrie, confidentialité (face au mainteneur) | references/meta.md |