drama-forge

/drama-forge — Pipeline automatisé pour vidéos courtes en série

Vous êtes l'opérateur d'une pipeline de production de vidéos courtes en série. L'utilisateur donne le nom de la série, et vous exécutez l'orchestrateur, qui automatise l'ensemble du processus "script → vidéo → voix → montage → contrôle qualité → mise à jour de l'état", produisant des vidéos courtes verticales prêtes à publier, et passant automatiquement à l'épisode suivant (cohérence des personnages + continuité narrative assurées par le fichier d'état).

Déclenchement

L'utilisateur appelle /drama-forge ou en fait mention en langage naturel :

/drama-forge générer le prochain épisode de "Le Retour de Su Wan"
/drama-forge relancer les épisodes 1-2 (problème de répétition d'images la dernière fois)
/drama-forge générer 3 épisodes, revival antique et satisfaction
/drama-forge lancer d'abord un autotest

Commande unique (toujours essayer celle-ci en premier)

cd <répertoire du skill>
python -X utf8 scripts/run_pipeline.py --series "Nom de la série" [paramètres]

L'ordre de toutes les étapes est dans le code de l'orchestrateur, ne les exécutez pas manuellement.

Paramètre	Utilisation
--series NAME	Nom de la série (obligatoire)
--to-episode N	Générer jusqu'à l'épisode N
--force-episode N	Forcer la régénération de l'épisode N (rollback atomique de l'état + nettoyage des artefacts)
--with-bgm	Générer automatiquement une musique de fond IA (music-2.6)
--genre / --directive	Genre / directives scénaristiques supplémentaires
--dry-run	Autotest sans frais, n'appelle pas d'API payante
--workdir PATH	Répertoire de travail (emplacement de series/)
--model ID	Surcharger le modèle LLM (par défaut : abab6.5s-chat)

Sous Windows, python doit être appelé avec -X utf8 (la console GBK fait planter l'impression du chinois).

Workflow standard

1. Autotest (à exécuter après toute modification de code, sans frais) : python -X utf8 scripts/run_pipeline.py --dry-run
2. Vérification du solde : --dry-run ne vérifie pas le solde. Avant la génération, effectuez un appel chat minimal pour confirmer (arrêt sur InsufficientBalanceError, l'utilisateur doit recharger – notez que MiniMax vidéo ne reconnaît que le "solde de la plateforme ouverte", l'argent des forfaits Token n'est pas valable pour la vidéo)
3. Génération : python -X utf8 scripts/run_pipeline.py --series X [--to-episode N] [--with-bgm]
4. Validation : une fois le contrôle qualité (intégré) passé, vérifiez le fichier final series/<Nom de la série>/episodes/epXXX.mp4
   • series/<Nom de la série>/.usage.json (détail des coûts)

Contrôle qualité intégré (arrêt automatique en cas d'échec)

Après chaque épisode, verify est exécuté automatiquement :

• Tous les MD5 des fragments sont différents (prévention directe des accidents de répétition)
• Le fichier final contient un flux vidéo + un flux audio, durée ≥ 10s
• Le script contient une hook_line (accroche superposée sur la première image) + répartition temporelle inégale des scènes (pas de métronome)

Échec du contrôle = pas de mise à jour de l'état, pas de passage à l'épisode suivant, pas de dépenses pour l'épisode suivant. Correction puis --force-episode N pour relancer.

Mécanisme de continuation (ne pas modifier manuellement le fichier d'état)

• Personnages/univers/intrigues/résumés sont stockés dans series/<Nom de la série>/state.json
• Chaque épisode : LLM lit l'état → génère le script → une fois terminé, mise à jour de l'état (ajout/suppression d'intrigues, état des personnages)
• Pour relancer un épisode, utilisez impérativement --force-episode N (rollback automatique de l'état + nettoyage), interdiction de supprimer manuellement des fichiers
• Nouveau personnage : placez son portrait fixe (face/plan taille/fond uni) dans assets/characters/, enregistrez-le dans state.json

Détails complets

• references/api-reference.md — Paramètres API testés (ne pas "optimiser")
• references/pitfall-log.md — Incidents → causes profondes → préventions (consultez d'abord en cas de problème)
• references/quality-gates.md — Description des points de contrôle qualité et d'autotest
• references/content-quality.md — Structure dramatique en cinq actes/grammaire des accroches/principes de rétention
• assets/state.schema.json — Schéma JSON de state.json
• assets/series-template.json — Modèle d'initialisation pour une nouvelle série