checklist-overlay
Un enregistrement d'écran à gauche, une liste de contrôle à droite. Chaque élément se coche à l'instant où l'étape correspondante se produit à l'écran. Après le dernier coche, le film se fige sur une liste entièrement cochée.
Entrées
| Entrée | Remarques |
|---|---|
| Enregistrement | Un fichier vidéo local, idéalement 16:9. Le silence est acceptable. |
| Étapes | 3 à 7 éléments : { "label": "...", "at": <secondes dans l'enregistrement> }. Les étiquettes sont de courtes phrases impératives (environ 2 à 4 mots). |
| Titre | Une ligne. Exprimez le résultat ("Intégrez une compétence à votre agent en 5 étapes"). |
| Sous-titre | Une ligne optionnelle. |
| Palette | Surcharges hexadécimales optionnelles : bg, surface, panel, ink, muted, accent, border, accentInk. La valeur par défaut est sombre avec un accent orange. Gardez accentInk assez sombre pour être lisible sur accent. |
Si la personne ne fournit pas de timestamps, parcourez l'enregistrement (extrayez des images toutes les 1 à 2 secondes avec ffmpeg, regardez-les) et choisissez la première image où chaque étape est visiblement accomplie ou en cours. Ne devinez pas.
Flux de travail
- Chargez
/hyperframes,/hyperframes-core,/hyperframes-clipour le contrat du projet. - Écrivez
spec.json:{ "title": "...", "subtitle": "...", "palette": { "accent": "#ff6b2b" }, "steps": [ { "label": "Ouvrir l'application", "at": 1.5 }, { "label": "Rechercher", "at": 7.9 } ] } - Générez la composition dans le répertoire du projet :
node <skill>/scripts/create.mjs spec.json <recording.mp4> <project-dir> [--hold 2.2]Cela copie l'enregistrement, extrait la dernière image (afin que l'image se fige après la fin de l'enregistrement) et écritindex.htmldimensionné à l'enregistrement. Longueur totale = longueur de l'enregistrement + pause (par défaut 2,2 s). npx --yes hyperframes checkdoit réussir avec 0 erreurs et 0 avertissements.- Validez (ci-dessous), puis effectuez le rendu :
npx --yes hyperframes render --workers 2 --quality delivery --output final.mp4.
Règles de synchronisation
- Le coche apparaît exactement sur l'étape, jamais avant. Le remplissage et le dessin du coche commencent à
t = at; le dessin se termine environ 0,3 s plus tard. Rien dans l'élément ne doit sembler coché avantat. - Les timestamps sont basés sur le temps de l'enregistrement et l'enregistrement commence au temps 0 de la composition, donc
atest utilisé tel quel. Si vous coupez l'enregistrement, décalez chaqueatde la même quantité. - Un contour "à venir" peut apparaître sur l'élément suivant peu après le coche précédent. Il s'agit uniquement d'un contour, jamais d'un remplissage ou d'un coche.
- Gardez les coche à au moins 1,5 s d'intervalle pour que chacun soit lisible. Si deux étapes sont trop proches, fusionnez-les.
- Le dernier coche doit se situer au moins 1,5 s avant la fin de l'enregistrement, ou augmentez
--holdpour que la liste terminée soit visible pendant 2 s ou plus. - Le compteur (
n / N), la barre de progression et l'anneau d'image clé pulsent tous en fonction des mêmes valeursat, restant ainsi synchronisés.
Mise en page (enregistrements 16:9)
Toile 1920x1080, marges de 56 px. Le titre et le sous-titre en haut ; le cadre de l'enregistrement est l'élément principal d'environ 1250 px de large (environ 65 % de la largeur), le panneau de la liste de contrôle est une colonne de 520 px à sa droite, de la même hauteur que le cadre, les éléments se partagent la hauteur de manière égale. Cela permet de garder le texte de l'interface utilisateur dans l'enregistrement lisible. Ne réduisez pas le cadre en dessous d'environ 1100 px de large ; pour un enregistrement plus haut, le générateur met à l'échelle le cadre en fonction du rapport hauteur/largeur. Enregistrements non 16:9 : vérifiez que le cadre tient toujours sous l'en-tête, ou rognez d'abord l'enregistrement.
Les étiquettes s'adaptent sur deux lignes à 32 px ; gardez-les sous environ 26 caractères.
Validation
Effectuez cette opération sur le final.mp4 rendu, pas seulement sur des captures d'écran :
- Pour chaque étape, extrayez une image 0,08 s avant
atet une 0,45 s après :ffmpeg -ss <t> -i final.mp4 -frames:v 1 f.png. - Regardez-les. Avant : élément non coché, compteur à i-1. Après : élément rempli avec un coche, compteur à i, barre de progression avancée.
- Extrayez une image dans la pause finale (environ 0,2 s avant la fin) : tous les éléments cochés, compteur
N / N, barre pleine. - Vérifiez que le texte de l'enregistrement est lisible dans le cadre et qu'aucune étiquette n'est coupée. Corrigez
spec.jsonou la palette et régénérez si nécessaire. ffprobele fichier : 1920x1080, h264, durée = enregistrement + pause.
Livraison
Signalez le chemin de final.mp4, sa durée et les timestamps des étapes utilisées. Conservez le répertoire du projet (index.html, assets/, spec.json) afin que le film puisse être régénéré avec différentes étiquettes ou palette. Ouvrez d'abord npx hyperframes preview si la personne souhaite éditer dans Studio.