verbatra studio

Inicia Verbatra Studio, un panel web local sobre tu proyecto: un resumen de la cobertura, la última ejecución y el historial de ejecuciones con su coste nuevo, el estado de las traducciones con la lista de claves, la cola de revisión, el glosario y tu configuración resuelta, en vivo sobre los archivos en disco, también sobre .verbatra-local/run-history.jsonl. Editar archivos de locale y un glosario basado en archivo funciona sin más; solo el gasto en el proveedor es opcional, detrás de --allow-spend.

SinopsisCopiar enlace a esta sección

verbatra studio [flags]

EjemplosCopiar enlace a esta sección

# inicia Verbatra Studio en el puerto por defecto
verbatra studio

# activa las acciones que llaman al proveedor, en un puerto concreto
verbatra studio --allow-spend --port 6000

# deja que un agente de navegador use las acciones de revisión
verbatra studio --expose-agent-tools

FlagsCopiar enlace a esta sección

También acepta los flags globales --cwd y --config.

ComportamientoCopiar enlace a esta sección

La URL impresaCopiar enlace a esta sección

Antes de arrancar, studio carga los archivos de entorno y resuelve tu configuración una vez; un error de configuración sale con 2 antes de que arranque ningún servidor. Studio solo escucha en 127.0.0.1 y, en cuanto está escuchando, imprime una línea en stdout:

Verbatra Studio running at http://127.0.0.1:5849/?token=<token>

Abre exactamente esa URL. El token solo se acepta como ?token= en la primera carga de la página: el servidor lo comprueba, fija una cookie de sesión HttpOnly y redirige a /. Cada petición posterior necesita esa cookie. El token no es de un solo uso, así que trata la URL como un secreto mientras Studio esté en marcha. No se imprime nada antes de ocupar el puerto, así que un arranque fallido nunca filtra un token.

Un fallo al ocupar el puerto se informa en stderr como verbatra: error [<code>] <message>: PORT_IN_USE cuando otro proceso tiene el puerto (pasa --port <n> o detén ese proceso), o BIND_FAILED cuando el socket quedó en una dirección distinta de 127.0.0.1.

Cada página se actualiza en vivo cuando cambia un archivo de locale, el archivo de bloqueo, el archivo de procedencia o el archivo de límites (Revisa en Studio describe el aviso), y Run history and cost se relee cuando cambia el archivo del historial, la pestaña recupera el foco o vuelve una ejecución.

Navegación y enlacesnuevoCopiar enlace a esta sección

Overview, Translations, Review, Glossary y Settings son enlaces en la cabecera, con un cajón de menú por debajo de 1280px de ancho. La búsqueda de la cabecera abre Translations filtrado por lo que escribes, y el botón de tema alterna entre sistema, claro y oscuro. Translations y Review guardan su estado en la dirección, así que puedes enlazarlas: #/translations?locale=de&status=missing&key=nav.title&q=text (status puede repetirse) y #/review?locale=de.

Qué imprime en stderrCopiar enlace a esta sección

La línea de la URL es la única salida en stdout. Después, stderr dice qué capacidades están activas y cómo activar las que no:

verbatra: spend tools off (pass --allow-spend to retranslate from Studio)
verbatra: agent tools off (pass --expose-agent-tools to register them)

Con --allow-spend y el proveedor none, la primera línea dice verbatra: spend tools off (provider none). En un terminal interactivo añade verbatra: press Ctrl-C to stop, e imprime verbatra: Studio stopped tras apagarse. --verbose reenvía una línea por petición (como GET / 200, o POST /rpc status.check 200, que nombra el método RPC, nunca sus parámetros); la línea de arranque propia de Studio siempre se descarta. --quiet deja solo la línea de la URL. Una línea verbatra: studio error: ..., que aparece cuando una acción por lotes del panel se detiene por un error inesperado del servidor, sale siempre, incluso con --quiet. Consulta Salida en el terminal.

Gasto y herramientas de agenteCopiar enlace a esta sección

Sin --allow-spend, Studio lee VERBATRA_STUDIO_ALLOW_SPEND; --expose-agent-tools recurre del mismo modo a VERBATRA_STUDIO_AGENT_TOOLS. En ambos casos, 1, true, yes u on (sin distinguir mayúsculas e ignorando espacios alrededor) cuenta como activado, y el flag siempre gana a la variable. Sin ninguno de los dos, Studio nunca contacta con un proveedor. Studio carga antes los archivos de entorno, así que ambas variables pueden estar en .env.local o .env.

El gasto desde un agente necesita los dos flags; ninguno implica el otro. Una configuración con provider: { id: "none" } desactiva la traducción automática por política, así que Studio retiene el gasto incluso con --allow-spend, y la página Settings lo indica. Consulta Opera Studio con un agente de navegador para el catálogo de herramientas y el modelo de seguridad.

InstalaciónCopiar enlace a esta sección

@verbatra/studio es un paquete propio que se carga con un import dinámico, para que el resto de la CLI funcione sin él. Instálalo junto a la CLI con npm install --save-dev @verbatra/cli @verbatra/studio. Si falta, verbatra studio sale con 2 y este mensaje:

Verbatra Studio requires @verbatra/studio. Install it alongside the CLI with: npm install --save-dev @verbatra/studio, or run both without installing with: npx -y -p @verbatra/cli -p @verbatra/studio verbatra studio

Con pnpm, esa instalación funciona pero sale con 1 y ERR_PNPM_IGNORED_BUILDS, y deja un pnpm-workspace.yaml sin responder; la solución, que se aplica una sola vez, está en Solución de problemas. npm y yarn no tienen ese problema.

Códigos de salidaCopiar enlace a esta sección

Consulta Códigos de salida para el contrato que sigue cada comando.

RelacionadoCopiar enlace a esta sección

• Revisa en Studio recorre las páginas Overview y Translations, la cola de revisión y la retraducción con --allow-spend.
• Ver los archivos modificados en Studio lista los archivos de locale que difieren del último commit y las claves que cambiaron en cada uno.
• Opera Studio con un agente de navegador cubre --expose-agent-tools y las herramientas WebMCP.
• verbatra check y verbatra diff son los mismos cálculos que Studio muestra en vivo.