Doublage vidéo
D'un seul fichier vidéo à un carnet de suppression de mots vérifié manuellement (Cuts + EDL) sans toucher aux fichiers média. Un processus en sept étapes :
0 Prêt Vérification de la disponibilité en utilisant les mises à jour (cette Skill n'a pas de logique d'environnement)
1 Configuration Vidéo réelle → Transcription mot à mot dans le cloud → Création du projet produit → Démarrage du service → Lecture de l'état
2 Correction Correction des mots avec un dictionnaire (un général + un utilisateur) → Génération du tableau de corrections
3 Suppression Lecture des préférences et des règles → Cinq passages, chaque passage ne cherche qu'un seul type, seulement les lignes marquées
4 Synthèse Tableau récapitulatif des suppressions + Tableau des phrases répétées → Auto-vérification par lecture du tableau
5 Révision Soumission complète → Présentation des deux tableaux à l'utilisateur → Ouverture du Studio pour vérification manuelle
6 Bilan et passation Comparaison de la proposition avec la version finale → Archivage dans trois tiroirs → Rapport sur quatre points
Pas de découpage média : Modifier le carnet une fois prend quelques dizaines de millisecondes, découper une fois crée un fichier irréversible. À la fin de cette Skill, aucun nouveau fichier vidéo n'est présent sur le disque. La Skill effectue les jugements sémantiques et l'orchestration ; le Runtime Produit est le seul rédacteur des projets, des Cuts et de l'état du Studio.
L'utilisateur ne parle qu'à trois endroits : Choisir entre continuer ou recommencer pour le projet source (uniquement s'il a déjà été coupé), vérification dans le Studio, confirmation de fin. Pour le reste, communication à sens unique, sans s'arrêter pour attendre une réponse. Le critère de réussite de chaque étape est son livrable : pas de tableau, pas de tâche accomplie.
Commencez par lire et exécuter le contrat des étapes du business Skill. Correspondance entre les étapes de cet article et les phases du contrat : 1=preflight+Product state readback, 5=proposal+Product CAS, vérification=project-level review binding. Les trois phases suivantes du contrat (confirmation, exécution, validation) relèvent de la Skill d'exportation.
L'origine des incidents de chaque règle se trouve dans le Registre des incidents – les règles sont ici, les histoires sont là-bas.
0. Prêt
Exécutez d'abord la vérification de disponibilité de Vérifier les mises à jour – les skills sont-elles à jour, le Runtime est-il compatible ; la racine des plugins est également localisée ici (les <racine_plugins> dans les commandes de cet article sont remplacés par ce chemin littéral). Continuez seulement si le résultat est « Prêt » ; si le résultat est « Nouvelle session nécessaire » ou « Stop », suivez ses consignes (y compris l'interdiction de créer une interface de substitution maison).
Si le résultat de la vérification est runtime.kind=desktop-managed, il partage la même entrée stable et les mêmes services launchd/windows-task que l'installation CLI, continuez directement ; ne cherchez pas le répertoire d'installation d'Electron, n'installez pas Bun/FFmpeg, ne démarrez pas un second Runtime.
1. Configuration : Entrée réelle → Transcription → Création du projet produit
Quoi faire : Transmettre la vidéo locale réelle de l'utilisateur et le script mot à mot dans le cloud au produit, créer atomiquement le projet, démarrer le service, lire l'état.
# Transcription mot à mot dans le cloud (après avoir généré les candidats de transcription dans le répertoire de tâche) :
node "<racine_plugins>/scripts/videocut-cli.cjs" project create "<répertoire_projet>" --video "<fichier_vidéo_dans_répertoire_tâche>" --transcript "<script_mot_à_mot_dans_répertoire_tâche>" --json
node "<racine_plugins>/scripts/ensure-running.cjs" --json # Le produit s'assure déclarativement du service permanent (5190)
node "<racine_plugins>/scripts/videocut-cli.cjs" workflow get "<répertoire_projet>" --json # Product state readback
node "<racine_plugins>/scripts/videocut-cli.cjs" cuts get "<répertoire_projet>" --json
Règles :
- N'accepter que des vidéos réelles de doublage ou des projets réels existants fournis par l'utilisateur ; en l'absence de média réel, arrêter, interdire l'utilisation d'exemples ou de vidéos factices
- La transcription utilise uniquement la Cloud ASR autorisée par l'environnement actuel ; ne pas recourir à l'ASR locale ; si aucune Cloud ASR disponible, signaler
missing_cloud_transcription_adapter, ne pas ouvrir le Studio, ne pas falsifier la transcription --video/--transcriptdoivent être des fichiers réels dans le répertoire de tâche ; ne pas transmettre le format d'image – le produit le déduit automatiquement des dimensions réelles de la vidéo (Runtime 0.4.4+). Ajouter--aspect-ratio W:Huniquement si l'utilisateur demande explicitement un format spécial- Pour un projet déjà standard, d'abord
inspectpour confirmer et réutiliser, ne pas recréer unprojectId; si la même vidéo a déjà été coupée, demander à l'utilisateur : continuer la session précédente ou recommencer (c'est l'un des trois points de communication).project prepareest un compilateur idempotent, utilisé seulement pour reprendre une interruption ou pour un rafraîchissement explicite ; en cas d'interruption, relancer directement project createest la seule entrée : pas de bibliothèque de médias, de session de téléchargement ou de Skill supplémentaire ; la Skill ne doit pas écrireproject.jsonen premier- Le service doit être confirmé par le script avec
healthy=true,runtimeMode=launchd(macOS) ouruntimeMode=windows-task(Windows), version compatible, URL canonique 5190 avant de continuer ; en cas d'échec, transmettre l'erreur structurée et arrêter, interdire de recourir au foreground, de changer de port, de tuer des processus inconnus - Les deux readbacks doivent pointer vers le même
projectId, sauvegarder la phase du workflow et les trois révisions Project / Cuts / EditList ; si manquant ou incohérent, arrêter
2. Correction : Corriger les mots, générer le tableau de corrections
Quoi faire : Avant toute décision de suppression, corriger les mots mal transcrits à l'aide du dictionnaire – si les mots sont faux, les jugements ultérieurs le seront aussi ; les mots mal entendus ne sont pas des mots superflus, la suppression ne peut pas les corriger.
node "<racine_plugins>/scripts/videocut-cli.cjs" transcript dictionary "<répertoire_projet>" --dictionary "<racine_plugins>/references/ai-term-dictionary.md" --json
Vérifiez avec votre outil de fichiers si $HOME/.chengfeng-videocut/dictionary.md existe ; si oui, exécutez-le à nouveau (transition : le CLI ne prend actuellement qu'un seul fichier, deux passages ; il peut seulement ajouter, pas annuler le précédent – fusion complète avec priorité utilisateur quand le CLI multi-dictionnaire sera publié) :
node "<racine_plugins>/scripts/videocut-cli.cjs" transcript dictionary "<répertoire_projet>" --dictionary "$HOME/.chengfeng-videocut/dictionary.md" --json
Livrable : Tableau de corrections – Fusionner les listes applied des deux appels en un petit tableau (mot d'origine → corrigé → contexte), rapporter à l'utilisateur. Après correction, ce tableau doit être consulté – le dictionnaire peut aussi faire des erreurs de correction sans contexte ; si une erreur est constatée, corriger le dictionnaire, ne pas appliquer de correctif ailleurs.
Seulement si le dictionnaire ne peut pas résoudre le problème et que l'auteur dispose d'un script, ajoutez un alignement contextuel :
node "<racine_plugins>/scripts/videocut-cli.cjs" transcript align "<répertoire_projet>" --script "<fichier_script_doublage>" --json # seulement rapport, pas de correction
node "<racine_plugins>/scripts/videocut-cli.cjs" transcript correct "<répertoire_projet>" --file "<fichier_correction>" --json
Règles :
- Ne modifier que le texte, pas le temps, le nombre de mots, wordId – le produit compare mot à mot les timestamps, toute modification est directement rejetée
- Ne changer que l'écriture, pas le sens – ce qui a été réellement mal dit et répété relève des résidus de phrase et des reformulations, cela dépend de la suppression
- Si le dictionnaire n'a pas la réponse, et que le script ne peut pas confirmer, ne pas deviner : rapporter le problème pour que l'utilisateur complète le dictionnaire. Mettre un nom inventé est pire que de laisser un nom mal entendu
- Le chinois oral est conservé tel quel : s'il dit « 叉 » ou « 大模型 », c'est ce qu'il a dit
- Le dictionnaire est une barrière que chaque transcription doit franchir (transcrire deux fois le même audio donne des résultats différents, cf. registre des incidents)
Segmentation par ponctuation : Chaque mot de la transcription a une ponctuation, une virgule un paragraphe, une phrase une ligne ; les sous-titres utilisent la même ponctuation, les deux sont cohérents. Les anciens projets avant le 2026-07-28 n'ont pas de ponctuation, exécutez node "<racine_plugins>/scripts/videocut-cli.cjs" transcript regroup "<répertoire_projet>" --json pour recouper les paragraphes (vérification mot par mot des id/temps/texte inchangés, sûr pour les projets déjà coupés) ; pour avoir la ponctuation, il faut retranscrire – la ponctuation n'existe tout simplement pas dans les anciennes transcriptions.
3. Suppression : Cinq passages, chaque passage ne cherche qu'un seul type
Quoi faire : Lire le matériel, puis lire l'ordre de lecture complet cinq fois, chaque fois avec un seul critère. Lire avec un seul critère à la fois donne une qualité de jugement bien supérieure à une fois avec six critères ; chaque passage produit des résultats petits et vérifiables.
D'abord, lire le matériel :
node "<racine_plugins>/scripts/videocut-cli.cjs" transcript playback "<répertoire_projet>" --json
Ensuite, lire avec votre outil de fichiers $HOME/.chengfeng-videocut/cut-preferences.md (préférences utilisateur, ce qu'il a dit compte ; si le fichier n'existe pas, c'est un nouvel utilisateur, passez).
Les critères sont dans Règles de suppression sémantique (principes + cas). Priorité des règles : Préférences utilisateur > Cas utilisateur > Cas généraux.
Passage 1 Répétition Répétition inter-phrases, intra-phrases (le plus objectif : deux fois la même chose)
Passage 2 Résidus et reformulation S'arrêter à moitié, recommencer autrement
Passage 3 Erreur de parole Nombre / nom propre / mot mal dit, puis correction
Passage 4 Bégaiement en anglais Répétition de début de mot / lettre / syllabe
Passage 5 Tics de langage et interjections Le plus subjectif, selon la densité et la tolérance des préférences utilisateur
Chaque passage a une action fixe : consulter les cas selon le type → chaque occurrence relevée sur une ligne (wordIds + type + risque) → ne pas décider pour d'autres types. Les passages suivants ignorent les mots déjà marqués, les conflits sont résolus lors de la synthèse.
Règles :
- Le jugement utilise uniquement l'ordre de lecture de
transcript playback, ne jamais assembler manuellement à partir detranscript.json– « dit deux fois » se base sur la proximité à la lecture, assembler manuellement risque de lire des sauts de numérotation comme un contenu manquant et de faire des erreurs (cf. registre des incidents) - La suppression n'a que deux états : « supprimé / non supprimé » ; les raisons IA ne créent pas de troisième état « suggéré pour suppression »
- Les erreurs de parole, répétitions, résidus : par défaut supprimer avant, garder après ; les longues phrases, phrases entières, reformulations en bifurcation doivent être vérifiées à haut risque
- Les pauses normales ne sont pas calculées par la Skill : la fusion des silences adjacents et
natural-pause-v2sont exécutés de manière déterministe par le produit
4. Synthèse : Deux tableaux, agir seulement après leur création
Quoi faire : Fusionner les lignes des cinq passages en deux tableaux – c'est le livrable de cette étape et ce que l'utilisateur verra.
Tableau récapitulatif des suppressions (décisions de suppression item par item) :
| # | Temps | Type | Suppression | Lecture restante | Risque | Base |
|---|-------|--------|----------------------|----------------------|-----|----------|
| 1 | 00:12 | Répétition | 这个功能呢 | 这个功能它其实 | Faible | Cas R2 |
| 2 | 02:31 | Reformulation | 比如我就让他跟踪 | 比如我让grok跟踪 | Haut | Cas R5 |
Tableau des phrases répétées (phrases dites plusieurs fois, le tableau mot par mot ne montre pas « combien de fois enregistré, quelle version gardée », c'est ce que l'utilisateur veut le plus vérifier) :
| Début de phrase | Dite combien de fois | Version gardée | Versions supprimées | Risque |
|---------------------|----------------------|-----------------|---------------------|-------------------|
| Parce qu'aujourd'hui il y a… | 3 | 3e fois 00:08 | 1ère, 2e fois | Faible – trois fois globalement identiques |
| La plupart des agents peuvent chercher… | 2 | 2e fois 04:40 | 1ère fois | Haut – les deux versions diffèrent, écouter attentivement |
Puis auto-lecture : Lire le texte après suppression dans l'ordre de lecture complet, annuler les lignes qui ne se lisent pas bien. C'est la définition de la relecture : l'IA se relit elle-même, pas pour demander à l'utilisateur ; si pas sûr = ne pas lister (deux états).
5. Révision : Ouvrir le Studio seulement lors de la vérification manuelle
Quoi faire : Soumettre complètement les candidats, présenter les deux tableaux à l'utilisateur, puis ouvrir la page de vérification du produit pour que l'utilisateur vérifie manuellement.
node "<racine_plugins>/scripts/videocut-cli.cjs" cuts get "<répertoire_projet>" --json # Obtenir la révision des Cuts
node "<racine_plugins>/scripts/videocut-cli.cjs" cuts set "<répertoire_projet>" --file "<fichier_proposition>" --expected-revision "<révision_actuelle_Cuts>" --json
Le candidat ne référence que des wordIds stables :
{
"schemaVersion": 1,
"cutWordIds": ["word-12", "word-13"],
"reasons": [
{ "wordIds": ["word-12", "word-13"], "kind": "repeat", "risk": "low" }
]
}
Règles de soumission :
- Le candidat est la conclusion complète du jugement actuel, pas un incrément –
cuts seta une sémantique de remplacement, soumettre un incrément ferait perdre silencieusement les suppressions sémantiques du tour précédent (cf. registre des incidents) ; lors de la soumission, ne pas lire ou fusionner manuellementinitialization.baselineCutWordIds(le produit intègre automatiquement les pauses de base) reasonsest enregistré, écrit fidèlement ; le produit supprime les parties qui mentionnent des mots non supprimés- Ne pas écrire directement
cut-selection.json,project.jsonou les logs d'événements cuts get.data.revisionest la révision des Cuts,workflow get.data.revisionest celle du projet, ne pas les mélanger- Après soumission réussie, vérifier obligatoirement
noLongerCut(nombre de mots non supprimés cette fois) : si différent de zéro et non intentionnellement retiré = incrément, revenir en arrière et soumettre à nouveau la version complète ; même si"unknown"est lu, il faut le voir - Immédiatement après, refaire
workflow get+cuts get, confirmercut_review_readyet les trois révisions ; si incohérence, arrêter, ne jamais écrire de JSON directement ou écraser automatiquement - Après soumission, laisser le
<fichier_proposition>dans le répertoire de tâche – l'étape 6 du bilan en aura besoin (les raisons sont coupées par le produit après édition utilisateur, il n'est pas fiable de reconstruire à partir du carnet)
Ensuite, présenter d'abord les tableaux, puis ouvrir la page : Envoyer les deux tableaux à l'utilisateur, puis lui permettre d'entrer dans le Studio pour vérification.
node "<racine_plugins>/scripts/ensure-running.cjs" --json # Avant d'ouvrir, assurer à nouveau l'idempotence
node "<racine_plugins>/scripts/videocut-cli.cjs" open "<répertoire_projet>" --json # Obtenir l'URL du projet produit
node "<racine_plugins>/scripts/ensure-studio.cjs" --url "<URL_projet_produit>" --view koubo --json # Contrôle d'accès des capacités : confirmer que 5190 a enregistré la vue koubo
Règles :
- Seulement si le contrôle d'accès retourne
ok=true, ouvrirstudio.urlavec le navigateur intégré de Codex, puis arrêter l'avancement automatique, attendre que l'utilisateur sélectionne, rétablisse et enregistre - Avant d'ouvrir, comparer strictement
productUrl#project/<projectId>avecprojectIddu readback, et lierstage=cut_review_readyavec les trois révisions –ok=truedu contrôle d'accès ne prouve que la capacité du produit, ne peut remplacer la liaison au niveau du projet ; toute incohérence nécessite un nouveau readback studio_capability_missing: arrêter et expliquer l'incompatibilité de version, peut suggérer$chengfeng-report-bug; ne pas considérer que l'URL avec?view=koubosignifie que la nouvelle interface existe, ne pas recourir à l'ancien panneau de tâches- Ne pas faire de « ouvrir le poste de travail » la première étape de la tâche ; ne pas accéder à l'ancienne
review.html, 8898/8899 ; ne pas contrôler le DOM du Studio, ne pas modifier directement les éléments média ; ne pas créer de pistes audio indépendantes ou de pistes de sous-titres factices
6. Bilan et passation : Les éditions de l'utilisateur ne doivent pas être jetées
Lorsque la vérification utilisateur est terminée, d'abord relire :
node "<racine_plugins>/scripts/videocut-cli.cjs" workflow get "<répertoire_projet>" --json
node "<racine_plugins>/scripts/videocut-cli.cjs" cuts get "<répertoire_projet>" --json
Bilan (transition, remplacé quand la commande cuts diff du produit sera publiée) : Comparer le <fichier_proposition> conservé à l'étape 5 avec la version finale lue cutWordIds :
- Ce que l'utilisateur a rétabli (présent dans la proposition, pas dans la version finale) = L'IA a mal supprimé. En fonction de la raison écrite dans la proposition, se demander : dans quelle catégorie l'erreur a-t-elle été faite ?
- Ce que l'utilisateur a supprimé en plus (présent dans la version finale, pas dans la proposition, ni dans
initialization.baselineCutWordIdsde la pause de base) = L'IA a oublié. Se demander : à quel type cela appartient-il, pourquoi n'a-t-il pas été identifié ? (La base est uniquement utilisée ici pour exclure les mots de pause, ne jamais l'intégrer dans la soumission)
Archivage de trois tiroirs :
- Différence de goût → Ajouter à
~/.chengfeng-videocut/cut-preferences.md(markdown géré par l'Agent, seulement ajouter et réécrire sa propre section ; créer le fichier s'il n'existe pas) - Erreur de nom propre → Ajouter à
~/.chengfeng-videocut/dictionary.md(tableau à deux colonnes, dédoublonner avant d'ajouter) - Lacune de règle → Noter une ligne dans la section « Cas à mettre à niveau » du fichier de préférences ; si troisième occurrence du même type, signaler à l'utilisateur, suggérer de mettre à niveau dans les cas généraux (ne pas modifier le répertoire skills avant la validation humaine)
- Zéro différence aussi le noter : Le fichier de préférences enregistre une ligne « Adoption complète »
Rapport de quatre points : Combien de mots supprimés, combien de secondes en moins ; la phase actuelle (devrait être cut_review_ready) ; les trois révisions Projet / Cuts / EDL ; résumé du bilan (proposition N items, adoptés X restaurés Y supprimés en plus Z, principal désaccord en une phrase). Puis dire à l'utilisateur de lancer l'exportation.
Ne pas afficher de carte de confirmation, ne pas exécuter la coupe – la carte de confirmation de la coupe physique appartient à la Skill d'exportation, cette carte doit figer la révision au moment où l'utilisateur appuie sur confirmer.
return_cut_review : D'abord refaire node "<racine_plugins>/scripts/ensure-running.cjs" --json, puis retourner au même Studio pour continuer la vérification ; ne pas déclencher le bilan, le bilan n'est fait qu'une fois lors du passage final.
Niveaux de rapport : La révision structurée du Produit est API/readback PASS ; la vérification réelle du navigateur est visual frame PASS ; sans écoute réelle, c'est human listening UNVERIFIED, ne pas utiliser la lecture, le DOM, les captures d'écran ou la détection de média pour remplacer.
Reprise et échec
revision_conflict: Relire l'état, expliquer l'édition précédente de l'utilisateur, ne pas écraser automatiquementruntime_unhealthy: Ne pas boucler de réinstallationservice_identity_mismatch/service_port_conflict: Arrêter, ne pas recourir au foreground, ne pas changer de port, ne pas tuer de processus inconnus- La page est fermée mais le service toujours actif : Lire le workflow, puis continuer à partir de l'état actuel, ne pas créer de nouveau projet
- En cas d'échec, ne pas dire « le carnet est écrit » comme « déjà coupé » – jusqu'à cette étape, aucun fichier média n'a été produit
Note : Cette Skill accepte la vidéo locale réelle et le script mot à mot dans le cloud directement dans le produit, c'est l'exigence du contrat preflight ; les deux existent véritablement, c'est la condition préalable à tout jugement.