Compresión y Archivado de Vídeos
Utiliza el propio entorno local de IA del usuario para completar la compresión de vídeos. Primero verifica el entorno, luego analiza el material, pregunta los objetivos, recomienda parámetros y proporciona muestras; una vez recibida la confirmación del usuario sobre la muestra específica y el rango del lote, ejecuta el proceso por lotes y orienta sobre el archivado. No describir "verificación automática aprobada" como si el usuario ya hubiera aceptado la calidad.
Los scripts complementarios solo dependen de Python 3.9+ (biblioteca estándar), FFmpeg y ffprobe. La primera versión está orientada principalmente a macOS; la ejecución depende de bloqueos de archivos POSIX. Las herramientas de chat normales que no pueden leer/escribir archivos locales ni ejecutar comandos solo pueden proporcionar orientación, no afirmar que ya han procesado el vídeo. Los scripts no necesitan clave API de modelo y no suben material.
Entrada y Directorio de Tareas
- Encuentra la ruta absoluta de esta Skill. En adelante,
<script>se refiere a la ruta absoluta descripts/workflow.py;<tarea>es un directorio de tareas independiente creado en la máquina del usuario. No escribir resultados de vuelta al paquete de Skill instalado. - Crear el directorio de tareas fuera del directorio de material original del usuario; cada lote de tareas guarda de forma independiente el inventario, el plan, las muestras, las confirmaciones y el estado. Para material nuevo o modificado, crear otra tarea; los lotes ya iniciados mantienen el plan original.
- Las instrucciones claras del usuario y las autorizaciones ya otorgadas tienen prioridad sobre las sugerencias predeterminadas de esta Skill. No preguntar repetidamente sobre objetivos, rutas o selecciones ya definidos. Si la solicitud del usuario excede el alcance de soporte del script, explicar las limitaciones y preparar un plan separado, sin modificar el script o degradar el proceso sin aviso.
1. Verificación del Entorno e Instrucciones de Instalación
Primero confirmar que la terminal puede encontrar Python, luego ejecutar python3 "<script>" doctor. Verificar la versión de Python, FFmpeg, ffprobe, libx265/libx264 y las opciones necesarias. Si falta algo, leer environment.md y explicar qué falta, cómo instalarlo y el impacto. Si el usuario ya ha solicitado la instalación, ejecutarla según ese alcance; de lo contrario, proporcionar primero comandos específicos para que el usuario elija cómo ejecutarlos. No informar erróneamente herramientas faltantes como "sin vídeo". Después de la instalación, verificar que esté disponible antes de continuar.
2. Análisis de Material Solo Lectura
Confirmar el directorio de origen y el directorio de salida, ejecutar init, scan; los comandos se encuentran en operations.md. El escaneo solo lee metadatos multimedia, no inicia la codificación. Informar al usuario sobre la cantidad, el tamaño, la duración, la resolución/tasa de fotogramas, la profundidad de color, las marcas de color, las pistas de audio y el perfil principal, y listar por separado los archivos que no se pueden leer y los que requieren revisión.
La etiqueta BT.709 no puede probar el modo de grabación ni descartar Log; debe combinarse con la información de grabación proporcionada por el usuario. El ejecutor de la primera versión solo procesa automáticamente material H.264/HEVC, 4:2:0, de 8/10 bits con etiqueta BT.709 completa; HLG/PQ/HDR, subtítulos, múltiples flujos de vídeo principal y color desconocido se listan por separado como REVISAR, y no se convierten automáticamente a SDR. El material conocido como Log debe procesarse por separado primero, sin garantizar al usuario la corrección del color.
3. Preguntar el Propósito de Uso
Primero explicar los hallazgos del escaneo, luego solo hacer preguntas que aún no estén claras y que puedan cambiar el plan: uso principal (visualización doméstica/archivo a largo plazo/edición posterior/compartir), prioridad entre calidad y tamaño, tiempo de procesamiento aceptable, dispositivo de reproducción o límites de tamaño de archivo. Generalmente, combinar en una sola ronda de preguntas breves; no hacer que el usuario complete una tabla de parámetros irrelevantes.
Al archivar, explicar ambas opciones: conservar el original en su lugar; o, después de una compresión exitosa y verificación, moverlo a un subdirectorio designado dentro del directorio padre original. Por defecto keep; mover requiere una selección explícita del usuario; no proporcionar la función de eliminar el original. Primero determinar esta elección, luego generar la configuración de la muestra.
4. Recomendar Planes Comparables
Según quality.md, relacionar el objetivo del usuario con el material real. Explicar el códec, preset, 2–3 valores CRF candidatos, parámetros conservados, compensaciones esperadas e incertidumbres. No usar CRF22, una cámara específica o un directorio como regla fija para todos los usuarios.
Crear plan.json dentro de la tarea; el formato se encuentra en operations.md. Guardar el objetivo del usuario y la justificación de la recomendación; seleccionar solo los perfiles que se pretenden procesar en esta ocasión, y cada perfil seleccionado debe tener al menos una muestra. Elegir segmentos representativos de movimiento, textura, áreas oscuras, etc.; si los metadatos no pueden identificar escenas, explicarlo y pedir al usuario que especifique segmentos clave o ayude a visualizar. Si hay muchos tipos de material, reducir el alcance por lotes.
Por defecto, conservar resolución, tasa de fotogramas, relación de aspecto, orientación, profundidad de color, metadatos de color conocidos y copiar todas las pistas de audio. El script solo copia la pista de vídeo principal y las pistas de audio; las pistas de datos auxiliares o carátulas no se incluirán en la copia comprimida, y esto debe explicarse en el plan. Redimensionamiento, corrección de color, conversión HDR, recodificación de audio, codificación por hardware, tamaño de archivo objetivo estricto y formato intermedio de edición no están dentro del alcance automático de la primera versión.
5. Muestras y Visualización Manual
Ejecutar sample y mostrar sample-report.md, la referencia y las rutas locales de cada candidato. Todos los candidatos se codifican desde el mismo segmento de referencia. Explicar el tamaño y el tiempo, y orientar sobre cómo comparar visualmente detalles, movimiento, áreas oscuras, degradados, sincronización de audio y vídeo, y el dispositivo de reproducción real; el recorte por fotogramas clave puede provocar una ligera desviación en la duración.
No ejecutar approve, run o start hasta que el usuario haya aceptado explícitamente un candidato. Si el usuario no está satisfecho, ajustar el plan, generar nuevas muestras y recopilar conclusiones; no adivinar que "cumple con los requisitos". El PASS del script es una verificación estructural, no una prueba de calidad fotograma a fotograma.
6. Ejecución por Lotes tras Confirmación
Mostrar el alcance de plan --crf N y el mapeo de salida, el CRF seleccionado, la estrategia de archivado y la estimación de tiempo/tamaño basada en la muestra. Una vez que el usuario confirme y acepte la ejecución de este lote, usar approve para registrar la respuesta real del usuario; no es necesario volver a preguntar sobre elementos ya cubiertos en la respuesta. El registro de confirmación puede restaurar el contexto, pero no significa que el script pueda probar que la respuesta proviene de una persona real.
Después de llamar a start, usar status y los registros para verificar la ejecución real. El procesamiento por lotes es secuencial de un solo FFmpeg; la pausa segura solo es posible después de que el archivo actual haya completado la codificación, verificación y archivado. Usar pause; no detener mediante la eliminación del proceso para una pausa normal. resume elimina la solicitud de pausa; después de que el controlador salga, usar start de nuevo; no iniciar si ya hay un controlador en ejecución. No mantener una encuesta de alta frecuencia de IA para tareas largas. Solo cuando el usuario solicite ser notificado después, usar las capacidades de notificación/programación proporcionadas por su sistema de IA.
Los cambios en parámetros, rutas, alcance o muestras invalidan la confirmación anterior; las tareas ya iniciadas se reanudan según el plan original, y los cambios se gestionan en una nueva tarea. Los elementos fallidos y pendientes de revisión se informan por separado. La reanudación desde un punto de interrupción es por archivo; los vídeos incompletos se codifican desde el principio.
7. Verificación y Entrega del Archivado
Según archival.md, explicar la correspondencia entre la versión comprimida, el original y los registros de la tarea. Resumir los elementos completados/saltados/pendientes de revisión, la diferencia de tamaño de la copia comprimida, la ubicación actual del original y el método de recuperación. La tasa de compresión reportada no equivale al espacio realmente liberado: el original aún se conserva y el uso de disco del flujo actual generalmente aumenta.
No sobrescribir originales ni salidas existentes; los archivos temporales no verificados no se entregan como producto final. La verificación automática se basa en ffprobe, size/mtime, no en hash de contenido o decodificación de fotograma completo. Si el usuario necesita una verificación más estricta o una copia de seguridad, diseñar los pasos correspondientes en ese momento; mover directorios no es una copia de seguridad. Conservar el directorio de tareas para que el usuario u otra IA pueda restaurar e interpretar los resultados.