¿Qué hace framechord?
Usa el binario framechord desde cualquier agente que pueda ejecutar un proceso. Si falta, consulta la instalación para instaladores públicos, instalación local del usuario y actualizaciones explícitas, o explica cargo install --path /path/to/framechord para una compilación desde el código fuente. No cambies de herramientas multimedia ni realices llamadas API de proveedores dentro de la habilidad.
Los proyectos mediaagent/ existentes se soportan en su lugar. Consulta cambio de nombre y proyectos heredados antes de actualizar una instalación anterior; usa las rutas devueltas en data_directory en lugar de asumir el nombre de la carpeta.
Consulta comandos para cada comando y opción de esta versión del binario; flujo de trabajo para salidas, límites, recuperación y revisión; creación para plantillas de personajes e infografías. Los esquemas legibles por máquina están en references/schemas/. Las plantillas exportadas están en templates/.
Consulta continuidad de personajes al reutilizar los mismos personajes en diferentes escenas. Usa referencias de identidad seleccionadas, controles de fidelidad soportados y comparación con las imágenes originales reales; el éxito de la API no establece el parecido.
Consulta verificaciones de conexión al comprobar la configuración o fallos de proveedor/credenciales: doctor verifica la presencia sin conexión; doctor --live autentica explícitamente con solicitudes de solo lectura. Soporta filtrado por proveedor, tiempos de espera y JSON. Lee el estado/acciones por proveedor; la autenticación exitosa no establece la disponibilidad de generación/modelo/facturación.
Consulta voces al descubrir voces, diseñar vistas previas, aceptar grabaciones autorizadas o crear/clonar/vincular explícitamente una voz de un proveedor seleccionado. La generación de vistas previas, la creación en el lado del proveedor, la vinculación canónica y la aceptación de grabaciones son operaciones separadas.
Consulta configuración y modelos actuales para el asistente terminal en bucle, valores predeterminados de Google primero y una alternativa explícita de OpenAI, conservando la configuración .env del proyecto, credenciales enmascaradas e instalación de la habilidad del proyecto, preparación para configuración no interactiva, filtros de modelo y actualización explícita del catálogo. Para un solo activo, usa indicadores explícitos de proveedor/modelo/entrada/salida actual sin inicialización. Para trabajo repetido, los agentes usan init PATH --preset recommended --json --non-interactive, inspeccionan config status --json y proporcionan la configuración exacta con config setup --file cuando sea necesario. Los usuarios humanos de terminal ejecutan init para reanudar la configuración. No se realizan llamadas a proveedores durante la inicialización. Los bloqueos de modelo de personajes existentes se conservan; las identidades con modelos retirados necesitan una nueva versión del personaje y referencias aceptadas por el humano antes de generar de nuevo.
Conserva exactamente el diálogo, las letras, los números y las etiquetas solicitados. Usa una operación de planificación explícita separada al adaptar un artículo a un podcast. Proporciona el texto del artículo en un archivo local. Los personajes son opcionales; cuando se seleccionan, reutiliza sus referencias aceptadas y la voz/proveedor/modelo asignados. Los activos de identidad derivados deben usar el proveedor/modelo registrado del activo original; las anulaciones conflictivas fallan. Conserva los metadatos originales en lugar de copiar el valor predeterminado del proyecto en el YAML del trabajo derivado. Describe la identidad estable por separado de la pose, escena, presentación o vestimenta temporal. Las referencias candidatas necesitan la selección del usuario antes de la aceptación.
Crea archivos usando plantillas, luego validate. Inspecciona generate --job ... --dry-run --json antes de la ejecución cuando las entradas son nuevas. Llama a la generación solo cuando forma parte de la solicitud del usuario. Usa --json --non-interactive para automatización. Informa honestamente las rutas de los artefactos devueltas por el binario y los trabajos incompletos.
Usa runs status, runs wait, runs reconcile y runs resume para ejecuciones registradas. Recupera los resultados del proveedor compatible antes de considerar un reintento de pago. Nunca reintentes silenciosamente una solicitud paga desconocida; --retry-unknown requiere autorización explícita del usuario. Las revisiones registran la calidad por separado del éxito de la generación. La revisión no revisa automáticamente, y las revisiones no reemplazan las referencias canónicas del personaje.
Consulta flujos de trabajo de corrección para casts v2, entradas de planificador seleccionadas, verificación acotada, almacenamiento de referencias, adjuntado de resultados recuperados, uso y migraciones. Los trabajos/configuraciones/ejecuciones aceptan v1 y v2; los casts nuevos y el montaje de podcasts requieren v2. Otras versiones de manifiesto permanecen sin cambios.
Usa plan --character MANIFEST --asset FILE para seleccionar dependencias explícitamente; el binario las copia en _inputs/. Para una escena con múltiples personajes guardados, usa entradas cast y archivos de dirección específicos del trabajo. Requiere referencias aceptadas y linajes de modelo original compatibles; nunca reescribas perfiles para hacer desaparecer un conflicto.
Para pruebas de aceptación, previsualiza verify --suite SUITE --json y obtén aprobación para el lote pago acotado antes de --execute --preview-hash HASH. Las credenciales faltantes se omiten, no se pasan. La creación/clonación de voz usa sus propios comandos de persona explícitos y aprobaciones. review report compara los artefactos generados con las referencias guardadas; solo las selecciones reales del usuario autorizan la aceptación canónica.
models --live lee los catálogos del proveedor; la visibilidad no es un derecho de generación. usage informa honestamente las unidades devueltas y los costos desconocidos. storage plan --output cleanup.yaml prepara una vista previa de limpieza conservadora fuera de framechord/; storage clean --plan cleanup.yaml solo elimina blobs no referenciados después de una revalidación. migrate --kind job|config|run --file FILE previsualiza; --apply conserva una copia de seguridad v1. Para trabajos inciertos, runs recover requiere la huella digital registrada y evidencia de conciliación, luego runs resume publica la respuesta proporcionada sin regeneración.