Corrector de Subtítulos para Jianying con IA
¿Qué problema resuelve?
El reconocimiento de voz de Jianying es rápido y gratuito, pero suele malinterpretar términos técnicos (Agent, Claude Code, MCP, WorkBuddy…), obligando a corregir manualmente cada subtítulo durante unos 30 minutos por video. Esta herramienta automatiza el proceso: descifra el borrador → corrección en dos capas → lo vuelve a encriptar y escribir, sin alterar la línea de tiempo ni los estilos. Al volver a abrir Jianying, los subtítulos están corregidos y listos para editar.
Requisitos previos (una sola vez; ver referencias/setup.md)
- Colocar
jy-draftc.exeen la carpetatools/(descargar desde GitHub wenshui330/jy-draftc). - Tener instalada la versión de escritorio de Jianying (se detecta automáticamente, o configurar
JY_INSTALL_DIRapuntando al directorio que contienevideoeditor.dll). - Clave API de Zhipu (variable de entorno
ZHIPU_API_KEY; si usas Claude Code con Zhipu, puede leer automáticamentesettings.json).
Flujo de trabajo estándar
1. En Jianying: Crear un borrador nuevo → Agregar video → Ir a "Texto → Subtítulos inteligentes" y reconocer.
2. Salir completamente de Jianying (incluyendo la bandeja del sistema) — el script detecta si está abierto y rechaza escribir.
3. Ejecutar el script (usar dry-run primero para ver el efecto):
python scripts/fix_subtitles.py "Nombre del borrador" --dry-run
4. Revisar la tabla de cambios en workspace/<Nombre del borrador>/changes.md con el usuario para confirmar.
5. Escribir los cambios finales (quitar --dry-run).
6. El usuario vuelve a abrir Jianying → Los subtítulos están corregidos → Editar manualmente (recortar/ajustar velocidad) → Exportar.
Plantilla de comandos
& "<ruta_del_skill>/scripts/fix_subtitles.py" "Nombre del borrador" --dry-run # Vista previa
& "<ruta_del_skill>/scripts/fix_subtitles.py" "Nombre del borrador" # Escribir cambios
& "<ruta_del_skill>/scripts/fix_subtitles.py" "Nombre del borrador" --no-llm # Solo reglas, instantáneo
Parámetros
| Parámetro | Descripción |
|---|---|
--dry-run | Solo genera tabla de cambios + SRT, no escribe nada (funciona incluso si Jianying está abierto) |
--no-llm | Solo aplica reemplazos del diccionario de términos, sin llamar a la API |
--batch N | Cantidad de elementos por lote para LLM; por defecto 30 |
Mantenimiento del diccionario (¡clave! mejora con el uso)
config/terms.json:
terms: Escritura autorizada (se fuerza la corrección de mayúsculas/minúsculas antes de escribir, ej. api→API).fix: Mapeos de "incorrecto → correcto" sin ambigüedad (ej.克劳德扣→Claude Code,engine→Agent).
Cada vez que se detecte un error nuevo, preguntar activamente al usuario si quiere agregarlo al diccionario. El usuario es un creador de contenido; en una misma serie de videos los términos se repiten mucho, por lo que el diccionario es el activo más valioso. Nota: Los mapeos de frases largas (ej. "手抽injection→手搓Agent") pueden ser anulados por mapeos cortos existentes ("手抽→手搓") que se ejecutan primero — es mejor agregar el mapeo directamente sobre la palabra objetivo (ej. "injection→Agent").
Mecanismo de corrección en dos capas
- Capa de reglas (principal): Reemplazos precisos del diccionario de términos; instantáneos, sin costo, 100% controlables.
- Capa LLM (respaldo): glm-4-flash corrige errores de homófonos en lotes (30 elementos/lote × 4 rutas concurrentes). Antes de escribir, se aplica validación del diccionario + detección de cambios bruscos de longitud (para evitar alucinaciones que reescriban demasiado).
Mecanismos de seguridad
- No escribe si Jianying está en ejecución; cada ejecución crea automáticamente una copia de seguridad en
workspace/<Nombre del borrador>/backups/. - Solo modifica campos de texto; no toca la línea de tiempo, estilos ni pistas. Revertir = sobrescribir
draft_content.jsoncon la copia de seguridad.
Limitaciones conocidas
- Depende del soporte de jy-draftc para la versión de Jianying (actualmente compatible con versiones 10.3~11.5; revisar el proyecto tras actualizaciones mayores de Jianying).
- Los títulos de texto añadidos manualmente en el borrador también se corrigen (se ve en la tabla de cambios; normalmente no hay problema).
- glm-4-flash ocasionalmente puede excederse (eliminar partículas/agregar palabras); el prompt incluye la restricción "antes omitir una corrección que hacer un cambio incorrecto". La tabla de cambios sirve para revisión manual final.