Incrustation (Storyboard)
C'est une tâche unique, pas une étape d'un processus. On l'exécute quand l'utilisateur le demande, et on peut y revenir après avoir modifié le montage.
Il n'y a que deux prérequis : le journal et les sous-titres doivent déjà exister (les calques sont attachés aux blocs de sous-titres, la durée est calculée à partir du journal).
Nécessite edit-list.json, transcript.json, subtitles.json
Produit visuals.json + modules/<numéro-nom>/index.html
Une fois terminé, on s'arrête, on ne dirige pas l'utilisateur vers l'étape suivante.
Lisez et exécutez d'abord le contrat de flux de travail métier. Les règles strictes pour l'écriture des modules se trouvent dans le contrat de module, et les règles de jugement dans le jugement visuel.
0. Préparation
Exécutez d'abord la « vérification de préparation » de Vérifier les mises à jour — vérifier si les skills
sont à jour, si le Runtime est compatible ; la racine du plugin est également localisée ici (dans les commandes de ce document, <racinePlugin> est remplacé par
ce chemin littéral). Continuez seulement si le résultat est « prêt » ; si le résultat est « nécessite une nouvelle session » ou « stop », suivez ses instructions
(y compris l'interdiction de « créer une interface alternative maison »). Le skill métier n'intègre pas de logique d'environnement.
Si le résultat de la préparation est runtime.kind=desktop-managed, réutilisez directement la CLI stable déjà installée par l'application de bureau et le
même service launchd/windows-task ; ne résolvez pas le chemin Electron, n'installez pas de dépendances supplémentaires, et ne démarrez pas un second Runtime.
Commandes
node "<racinePlugin>/scripts/ensure-running.cjs" --json
node "<racinePlugin>/scripts/videocut-cli.cjs" visual get <projet> --json
node "<racinePlugin>/scripts/videocut-cli.cjs" visual frame <projet> --cues sub-0004,sub-0005 --count 12 --out <dossier> --json
node "<racinePlugin>/scripts/videocut-cli.cjs" visual add <projet> --module modules/01-xx/index.html --cues sub-0004,sub-0005 [--zoom x,y,w,h] [--id vis-0001] --json
node "<racinePlugin>/scripts/videocut-cli.cjs" visual remove <projet> --id vis-0001 --json
ensure-running doit d'abord prouver que le port canonique 5190 appartient au service géré de la plateforme actuelle ; en cas d'échec, transmettez l'erreur et
arrêtez-vous, ne revenez pas en avant-plan ou sur un port choisi.
Les calques sont liés aux blocs de sous-titres (--cues), le produit convertit lui-même en identifiants de mots — un calque ne peut jamais être attaché à des mots non prononcés,
si le montage change, le calque se déplace tout seul. Ne stockez pas de secondes.
Quatre étapes, sans exception
① Analyse textuelle de la tâche Lisez subtitles.json, segmentez sémantiquement, répondez pour chaque segment :
Tutoriel/Démonstration/Preuve, ou Concept/Logique/Transition ?
② Extraction d'images pour analyse visual frame extrait 8-12 images, regardez-les vraiment.
En pratique, sur 12 segments, 2 voient leur prédiction textuelle infirmée par l'image — cette étape n'est pas une formalité
③ Mesure de la fenêtre de mouvement Calculez la différence de pixels entre images adjacentes, trouvez les moments de défilement/transition/action.
Les calques ne couvrent que les fenêtres stables, les annotations disparaissent avant que l'image ne commence à bouger
④ Création et placement des calques Écrivez le module → visual add → vérifiez calque par calque dans l'aperçu
Règles de jugement pour ②
L'image correspond exactement à ce qu'il dit → Annotation : entourez, entourez précisément le mot qu'il dit. Ne masquez pas les preuves réelles
L'image est faiblement liée/vide → Animation plein écran : fond blanc, utilisez la bibliothèque de styles
L'image est suffisamment claire par elle-même → Ne faites rien. C'est la réponse la plus courante (en pratique, 4 segments sur 13 ne bougent pas)
Le résultat de ③ est numérique, pas une impression
Coordonnées de l'annotation Calculez via statistiques de pixels (scan de niveaux de gris pour trouver les lignes de texte), pas d'estimation visuelle — l'erreur d'estimation a déjà dépassé 50px
Moments d'interaction Trouvez les changements brusques via différence de pixels image par image (en pratique, un saut de 4 à 335), l'annotation doit disparaître 0,2s avant
Fenêtre stable Le début contient souvent un défilement (il cherche le contenu), le calque commence à se lier à partir de l'image où ça s'arrête
Zoom : réfléchissez avant d'utiliser
Par défaut, pas de zoom. Un enregistrement de 960x720 devient flou en zoomant, l'utilisateur le verra immédiatement
Si zoom indispensable ≤1,6x, zone carrée de 62,5% centrée — la composition complète prime sur la lisibilité des petits caractères
Caractères trop petits Utilisez une annotation pour guider le regard ; si vraiment besoin de lire, la réponse est de réenregistrer en haute résolution, pas de zoomer
Cycle de révision
Les répertoires de modules sont nommés par numéro (01-rapport-quotidien, 05-anim-tache-division),
la piste chronologique affiche le nom du répertoire. L'utilisateur signale le numéro, vous modifiez ce calque, sans toucher aux autres.
Deux règles de modification des calques, chacune correspondant à un incident réel :
Modifier un calque nécessite de vérifier le module Une fois un calque rétréci/allongé, les moments relatifs figés dans le module ne suivent pas —
le moment de sortie de l'annotation peut tomber après la fin du calque, et ne jamais apparaître
Validation par pixels Vérifiez l'image, pas les propriétés DOM. Un iframe avec une « visibilité inversée correcte »
était physiquement hors de l'image — propriétés correctes, écran vide
Ce qu'il ne faut pas faire
- Ne sautez jamais l'extraction d'images et la mesure de mouvement avant de créer les calques (deux types d'erreurs déjà commises : masquer des preuves réelles, annotation suspendue sur un défilement)
- Ne remplissez pas chaque segment — tout recouvrir n'est pas le but, ne rien faire est une réponse courante
- Ne stockez pas de secondes, n'estimez pas les coordonnées visuellement, n'ajoutez pas d'assombrissement sur fond blanc
- N'utilisez pas d'images de substitution s'il n'y a pas de contenu réel
- Choisissez le style depuis le registre, n'inventez pas
- Les icônes de marque utilisent des glyphes officiels, pas de substituts dessinés à la main (un X a été dessiné avec deux lignes croisées, et l'utilisateur l'a remarqué). Si l'index local ne les contient pas, prenez le glyphe officiel monochrome depuis simple-icons (le noir et blanc s'accorde bien), enregistrez le fichier svg d'origine dans le répertoire du module pour référence ; la même marque ne doit apparaître que sous une seule forme dans une même vidéo.