caption-writer
Trois choses distinctes : légendes incrustées (video/captions/, props.captions, speech.srt) ; texte de publication (captions/<platform>.md, skill eda-marketing:content-repurposer) ; texte éditorial (accents avec spoken: false, editorialCta) — jamais dans le SRT.
Le texte des légendes est dans la langue de la marque (brand.json → language). Les règles de regroupement, de typographie et de syllabes proviennent du pack de langue (packages/core/src/lang/<en|ru>.ts).
Avant l'enregistrement (brouillon)
npm run mos -- captions build <pkg> — estimation du timing à partir du script (brand.json → speech.syllablesPerSec), badge « ESTIMATED TIMING », rendu final bloqué.
Après l'enregistrement
npm run mos -- footage <pkg>(si les sources sont dansinput/).npm run mos -- captions transcribe <pkg> <fichier audio>— faster-whisper local, pas de téléchargement. Pas de modèle → demander l'autorisation avant d'installer (docs/VIDEO_PIPELINE.md).- La transcription ASR est un brouillon. Vérifier les noms, les nombres, les négations, les terminaisons de mots, les mots peu audibles, les limites de phrases. Les corrections vont dans
transcript/corrected.<fichier>.json+ une ligne danstranscript/CORRECTIONS.md;transcript/raw-asr.*est immuable. En cas de doute →[inaudible]+ demander à l'utilisateur ; ne jamais deviner. Ne jamais prétendre avoir écouté si ce n'est pas le cas. - Si la parole réelle diffère du script, montrer la différence et décider avec l'utilisateur (garder la parole / rééditer / réenregistrer). Les légendes suivent la parole réelle ; n'ajoutez jamais de mots qui ne sont pas dans l'audio.
npm run mos -- captions map <pkg>→npm run mos -- captions build <pkg> --source transcribed.- Optionnel :
npm run mos -- captions calibrate <pkg> raw-asr.<fichier>.json --write— le rythme réel du locuteur est écrit dansbrand.json.
Modes et regroupement
Mode par défaut : brand.json → defaults.captionMode ; par vidéo : props.captions.mode. replace — des groupes courts se remplacent ; accumulate — les mots construisent un petit bloc progressif ; highlight — sur demande. Emphase : *mot* dans la parole du script (pour la parole transcrite, marquer emphasis dans corrected).
Regrouper par sens. Ne jamais séparer une négation de son verbe (« ne / sais pas »), une préposition de son mot (« dans / l'app »), un nombre de son unité (« 30 / secondes »), ni un nom propre. Éviter un mot isolé en fin de ligne. Conserver intacts les brand.json → captions.protectedPhrases. Les règles russes sont dans le pack de langue ru.
Vérification
Studio : début/fin de chaque page, transition légende-accent sans doublon, lisibilité sur téléphone, pas de texte sur les yeux. mos qa vérifie le débordement des lignes avec les métriques réelles des polices.