Communitygithub.com

jun7799/jianying-subtitle-fixer

Corrector de subtítulos para Jianying con IA. Corrige automáticamente errores de reconocimiento de voz en términos técnicos y nombres propios.

¿Qué es jianying-subtitle-fixer?

Esta habilidad automatiza la corrección de subtítulos generados por el reconocimiento de voz en Jianying (剪映), una herramienta de edición de video popular en China. El problema principal es que Jianying malinterpreta términos técnicos como 'Agent', 'Claude Code' o 'MCP', lo que obliga al usuario a editar manualmente cada subtítulo durante unos 30 minutos por video. El flujo de trabajo es: 1️⃣ El usuario crea un borrador en Jianying, añade video y ejecuta el reconocimiento de voz automático. 2️⃣ La habilidad descifra el archivo de borrador encriptado, aplica una corrección de dos capas: primero, utiliza un diccionario de términos personalizable (reglas precisas), y segundo, recurre al modelo GLM-4-Flash de Zhipu AI para corregir homófonos y errores contextuales. 3️⃣ Vuelve a encriptar el archivo y lo escribe en el borrador. 4️⃣ El usuario abre Jianying y encuentra los subtítulos corregidos, listos para editar sin alterar la línea de tiempo ni los estilos. Soporta plataformas de escritorio con Jianying instalado y requiere una clave API de Zhipu. Ofrece parámetros como `--dry-run` para previsualizar los cambios, `--no-llm` para solo corrección por reglas, y mantiene automáticamente un historial de backups. La efectividad mejora con el uso gracias a la acumulación de términos en el diccionario.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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)

  1. Colocar jy-draftc.exe en la carpeta tools/ (descargar desde GitHub wenshui330/jy-draftc).
  2. Tener instalada la versión de escritorio de Jianying (se detecta automáticamente, o configurar JY_INSTALL_DIR apuntando al directorio que contiene videoeditor.dll).
  3. Clave API de Zhipu (variable de entorno ZHIPU_API_KEY; si usas Claude Code con Zhipu, puede leer automáticamente settings.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ámetroDescripción
--dry-runSolo genera tabla de cambios + SRT, no escribe nada (funciona incluso si Jianying está abierto)
--no-llmSolo aplica reemplazos del diccionario de términos, sin llamar a la API
--batch NCantidad 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.json con 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.

Skills relacionados