Communitygithub.com

jun7799/jianying-subtitle-fixer

Pipeline de correction IA pour les sous-titres Jianying. Corrige automatiquement les erreurs de reconnaissance vocale (noms propres, termes techniques) dans les brouillons Jianying, avec double correction par glossaire et LLM.

Qu'est-ce que jianying-subtitle-fixer ?

Ce skill est un pipeline automatisé de correction des sous-titres pour l'éditeur vidéo Jianying (剪映). Il résout le problème des erreurs de reconnaissance vocale sur les noms propres et termes techniques (comme Agent, Claude Code, MCP) qui nécessitent des corrections manuelles fastidieuses. Le flux de travail est : reconnaissance vocale Jianying → décryptage du brouillon par jy-draftc → double correction via un glossaire de termes et le LLM glm-4-flash (Zhipu) → rechiffrement et réécriture. Le skill préserve exactement la timeline et les styles, et permet un retour immédiat dans Jianying pour le montage final. Il inclut des mécanismes de sécurité (refus d'écriture si Jianying est ouvert, sauvegardes automatiques) et une couche de détection des hallucinations. Idéal pour les créateurs de contenu techniques qui produisent des vidéos avec des termes spécialisés récurrents. Supporte les plateformes Windows avec Jianying Desktop, et nécessite une clé API Zhipu.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add jun7799/jianying-subtitle-fixer

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Correction IA des sous-titres Jianying

Quel problème cela résout-il ?

La reconnaissance vocale de Jianying est rapide et gratuite, mais elle se trompe systématiquement sur les noms propres (Agent, Claude Code, MCP, WorkBuddy…). Chaque épisode vidéo nécessite une demi-heure de corrections manuelles des sous-titres. Cet outil automatise le tout : décryptage du brouillon → double correction → rechiffrement et réécriture. Les modifications de la timeline et des styles sont nulles ; une fois le script exécuté, vous pouvez rouvrir Jianying et commencer le montage immédiatement.

Prérequis (une fois, voir references/setup.md)

  1. Placer jy-draftc.exe dans le dossier tools/ (téléchargé depuis GitHub wenshui330/jy-draftc)
  2. Avoir Jianying Desktop installé (détection automatique, ou définir JY_INSTALL_DIR pointant vers le répertoire contenant videoeditor.dll)
  3. Clé API Zhipu (variable d'environnement ZHIPU_API_KEY ; si vous utilisez Zhipu avec Claude Code, elle peut être lue automatiquement depuis settings.json)

Workflow standard

1.  Dans Jianying : créer un nouveau brouillon → ajouter une vidéo → lancer la reconnaissance vocale via « Texte → Sous-titres intelligents »
2.  Quitter complètement Jianying (y compris depuis la barre des tâches) — le script détecte si Jianying est ouvert et refuse d'écrire
3.  Exécuter le script (dry-run d'abord pour voir le résultat) :
    python scripts/fix_subtitles.py "nom_du_brouillon" --dry-run
4.  Montrer à l'utilisateur le tableau de comparaison dans workspace/<nom_du_brouillon>/changes.md pour confirmer les modifications
5.  Écrire les corrections définitives (enlever --dry-run)
6.  L'utilisateur rouvre Jianying → les sous-titres sont corrigés → suppression/ajout manuel de segments, changement de vitesse → exportation

Modèle de commande d'exécution

& "<chemin_du_skill>/scripts/fix_subtitles.py" "nom_du_brouillon" --dry-run   # Aperçu
& "<chemin_du_skill>/scripts/fix_subtitles.py" "nom_du_brouillon"             # Écriture définitive
& "<chemin_du_skill>/scripts/fix_subtitles.py" "nom_du_brouillon" --no-llm    # Règles seules, instantané

Paramètres

ParamètreEffet
--dry-runAffiche uniquement le tableau de comparaison + SRT sans écrire (peut être exécuté même si Jianying est ouvert)
--no-llmExécute uniquement les remplacements par glossaire sans appeler l'API
--batch NNombre d'entrées traitées par lot par le LLM, 30 par défaut

Maintenance du glossaire (essentiel ! Plus il est utilisé, plus il est précis)

config/terms.json :

  • terms : orthographe autoritaire (vérification de la casse avant réécriture, ex. api→API)
  • fix : correspondances « erreur → correction » certaines (ex. 克劳德扣→Claude Code, engine→Agent)

Après chaque exécution, si de nouvelles erreurs sont détectées, demandez activement à l'utilisateur s'il souhaite les ajouter au glossaire. L'utilisateur est un créateur de contenu ; les termes sont très répétés dans une même série vidéo, le glossaire est l'actif le plus efficace. Remarque : l'ajout de correspondances longues (ex. « 手抽injection→手搓Agent ») peut être neutralisé par des correspondances courtes déjà présentes (ex. « 手抽→手搓 »). Il est préférable d'ajouter directement la correspondance du terme cible (ex. « injection→Agent »).

Mécanisme de double correction

  • Couche de règles (principale) : remplacements précis via le glossaire, en quelques secondes, sans coût, 100% contrôlable
  • Couche LLM (filet de sécurité) : glm-4-flash corrige en lots les homophones et erreurs de frappe (30 entrées/lot × 4 flux concurrents). Avant la réécriture, une vérification du glossaire + détection des variations de longueur est effectuée (pour éviter les hallucinations de réécriture).

Mécanismes de sécurité

  • Refus d'écriture si Jianying est en cours d'exécution ; sauvegarde automatique dans workspace/<nom_du_brouillon>/backups/ à chaque exécution
  • Seul le champ texte est modifié ; la timeline, les styles et les pistes restent inchangés ; la restauration consiste à remplacer draft_content.json par la sauvegarde

Limites connues

  • Dépend du support de la version de Jianying par jy-draftc (actuellement versions 10.3 à 11.5 ; surveiller le projet après une mise à jour majeure de Jianying)
  • Les titres ajoutés manuellement dans le brouillon seront également corrigés (visible dans le tableau de comparaison, généralement sans conséquence)
  • glm-4-flash peut parfois dépasser légèrement ses droits (suppression de mots de liaison/ajout de caractères). L'instruction « plutôt ne pas corriger que mal corriger » est incluse dans le prompt. La vérification finale repose sur l'inspection humaine du tableau de comparaison.

Skills associés