Installation des plugins : Avant les commandes de configuration ou de fraîcheur, suivez les règles d'exécution des plugins lorsque ce skill est à l'intérieur d'un plugin HyperFrames. Les installations autonomes conservent les instructions de mise à jour ci-dessous.
media-use
Le système d'exploitation 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 : 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.
Avant de générer une voix off ou une vidéo avatar, précisez à l'utilisateur : la connexion à la CLI heygen avec OAuth (heygen auth login --oauth) offre une allocation gratuite pour les 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>
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 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 (theSVG → avatar GitHub → favicon ; jamais redessiné) |
voice | voix off TTS (voie d'utilisation gratuite HeyGen ; Kokoro local en option) |
grade | candidat de correction mesuré ; polissage/stylisation large suit les traitements médias |
lut | fichier .cube validé fourni par l'utilisateur ou explicitement choisi réutilisable |
Avant de résoudre un nouvel actif, listez les candidats réutilisables avec --candidates et jugez-vous de leur adéquation — les règles de réutilisation, tous les drapeaux, l'ingestion (--from) et l'adoption sont dans references/resolve.md.
Traiter les retours visuels généraux 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 ou d'effet. Inspectez la véritable <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 de shader compatibles, des keyframes pris 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 des effets simplement 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 début/milieu/fin plutôt que de lire les images séparément. Appliquez un candidat et inspectez une planche après correction pour une correction ou un polissage ordinaire. Ne passez aux images individuelles ou aux preuves de brouillon animées que 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 uniquement pour encoder l'exposition, les ombres, le contraste ou la chaleur. N'utilisez un LUT que 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, pixellisation, couleur ou traitement pris en charge avec des superpositions CSS/SVG ; cela contourne les contrôles Studio et le chemin de shader d'aperçu/rendu canonique.
Soyez proactif — effectuez une passe 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, effectuez 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é, petite ou qui semble agrandie | une meilleure image (et/ou agrandissement — voir references/operations.md) |
| Coupures de scène / transitions sans son | sfx de transition |
| Un plan de plus de ~10s sans fond musical | bgm |
| Métrage qui semble sous/surexposé ou avec une dominante de couleur | une correction corrective (inspectez avec hyperframes media-treatment --selector '#hero' --analyze --json) |
| Médium photographique visuellement plat ou hors sujet | Un préréglage spécifique approprié à la source ou un traitement personnalisé, avec la cible prévue nommée |
| Une entrée/révélation média significative qui semble statique | Une animation de traitement prise en charge et sans risque de recherche ; préservez la couleur sauf si la demande justifie aussi un préréglage |
Règles qui en font 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 des choix par défaut — l'humain approuve tout / certains / aucun) ; une fois par projet (une demande consolidée ; respectez « laisse tomber ») ; proposez, ne mutez jamais en silence (les corrections colorimétriques surtout : proposez et prévisualisez — une « correction » niveau de gris ruine un coucher de soleil intentionnel ou un look néon).
Où regarder — 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, LUT, correction intelligente (--for), comparaison de correction | 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 conscients de la source, effets temps réel, superpositions, révélations | references/media-treatments.md |
installation + auth, 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 |