Verificación
Utilice el nivel de verificación más bajo que demuestre el resultado solicitado:
| Nivel | Evidencia requerida |
|---|---|
| L0 | Comprobaciones estáticas como el script de verificación enfocado, npx tsc --noEmit, pruebas y compilación. |
| L1 | Una ejecución real del agente contra el editor en localhost:5199, seguida de evidencia estructural y renderizada. |
| L2 | La aplicación de escritorio empaquetada completando el escenario del usuario, incluyendo revisión visual humana donde la automatización sea insuficiente. |
Los cambios en el comportamiento en tiempo de ejecución requieren L0 + L1. Los cambios solo de lanzamiento y de escritorio también requieren L2 cuando la aplicación empaquetada es el comportamiento bajo prueba.
Prefiera dos señales:
read_projectpara la estructura: activos, pistas, elementos, colocación de fotogramas, duración de la línea de tiempo.- Una ruta de captura visual para evidencia renderizada en fotogramas exactos.
Utilice view_timeline_frames para obtener evidencia de la línea de tiempo compuesta. Esto verifica la línea de tiempo editada de OpenChatCut: recortes, capas, subtítulos, efectos, marcadores, marcadores de posición, recortes, transiciones y diseño.
Para la inspección de fotogramas de activos de origen sin procesar, elija la ruta más económica según dónde residan los bytes:
- El agente en esta compilación no tiene acceso al sistema de archivos local; todos los bytes de origen residen en el almacén de medios del proyecto (
/media/uploads/). Utiliceview_asset_framescon el ID del activo del proyecto; el servidor toma automáticamente una ruta rápida de hoja de contacto de ffmpeg, por lo que ya es la ruta de fotogramas de origen más económica. view_timeline_framesrenderiza la línea de tiempo compuesta (la comprobación de la verdad del editor);view_asset_framesmuestrea fotogramas de origen sin procesar. Elija según lo que esté verificando.- No existe una herramienta
get_contact_sheetseparada en esta compilación: la hoja de contacto es lo queview_asset_frames/view_timeline_framesya devuelven.
Utilice artefactos de fotogramas de origen locales/remotos solo para la comprensión de la fuente, selección de momento y decisiones de recorte aproximado, no como resultado editado o prueba de la línea de tiempo.
Para medios solo locales o en proceso de carga, la prueba de la línea de tiempo compuesta puede estar bloqueada hasta que el activo tenga bytes disponibles para el renderizador. La inspección de fotogramas de origen a través de view_asset_frames aún funciona mientras los bytes del activo estén en el disco (/media/uploads/).
Si ambas rutas de prueba visual están bloqueadas, pida al usuario que inspeccione el editor de OpenChatCut directamente e informe el bloqueador explícitamente.
Verificaciones útiles:
- Después de la importación:
read_project({ "view": "assets", "assetId": "<prefijo>" }) - Después de mover/recortar:
read_project({ "view": "timeline" }) - Después de superposición visual o MG en cualquier medio de la línea de tiempo:
view_timeline_frames({ "frames": [30, 45, 75] }), luego revise los fotogramas devueltos. - Para selección de fuente solicitada por el usuario o elección de momento visual: muestree imágenes fijas con
view_asset_framese inspecciónelas. Utilice esto solo para elegir archivos fuente, momentos y recortes aproximados. Construya la edición visible como elementos de la línea de tiempo de OpenChatCut. No trate la inspección de fuente sin procesar como verificación de la línea de tiempo ni como permiso para producir el video editado en otro lugar. - Para la inspección de fotogramas de origen: llame a
view_asset_frames({"assetId":"...","sourceTimesMs":[...]})después de queread_project({"view":"assets"})confirme el ID/tipo de activo. Prefiera esto sobre pedir al usuario que vuelva a adjuntar el archivo. - Para verificación visual solo local: cargue/registre medios legibles en la nube antes de confiar en la prueba visual del conector.
- Para validación sin fuente: confirme que el manifiesto de la herramienta expuso los parámetros que utilizó, luego registre la prueba visible en el registro de seguimiento.
Al hablar de segundos, verifique los fps desde read_project o use herramientas adaptadoras que resuelvan fps internamente.
Al informar la ubicación de un elemento de la línea de tiempo, utilice solo la estructura más reciente de read_project para el alias de pista, ID de elemento, inicio, duración e ID de activo. No informe pistas planificadas/predeterminadas ni la intención de llamada a la herramienta como ubicación verificada.
No trate una respuesta JSON de línea de comandos por sí sola como suficiente cuando el usuario pregunta si el editor refleja el resultado. Utilice la URL del editor o prueba visual cuando sea práctico.
Verificación de transcripción de agente real
Después de cada ejecución del agente L1, inspeccione el registro de chat completo antes de informar éxito:
- Lea la respuesta final del asistente y cada fila de herramienta creada por la ejecución.
- Expanda las filas fallidas o de advertencia y registre el error exacto.
- Verifique si hay turnos abortados, reintentos repetidos, propuestas obsoletas, trabajos incompletos y resultados de herramientas que la respuesta final describe incorrectamente como exitosos.
- Compare el resultado más reciente de
read_projectcon la línea de tiempo visible. - Para ediciones visuales, inspeccione los fotogramas de la línea de tiempo devueltos en lugar de confiar en el resumen del asistente.
Una ejecución con una línea de tiempo de aspecto correcto pero un error de herramienta no informado no es una aprobación limpia. Corrija la causa o informe el error restante explícitamente.
Si la verificación falla, clasifique la brecha antes de cambiar herramientas:
- la descripción o el esquema de la herramienta eran insuficientes
- las instrucciones del skill omitieron un paso
read_projectno expuso suficiente estado- la autorización del editor no se completó
- la canalización de medios/transcripción falló
- la renderización en la nube/observación del editor estaba bloqueada