Panel de configuración

El panel Config de zerocode es la forma de configurar un ZeroClaw en ejecución. Cada ajuste tiene un control tipado, validación y una explicación en línea de lo que hace, y la mayoría de los ajustes se aplican en vivo sin reiniciar el daemon. Ábrelo desde cualquier sesión de zerocode y edita los ajustes allí en lugar de editar manualmente el archivo de configuración.

La configuración aún se conserva en tu archivo de configuración, y la documentación describe los campos relevantes para que puedas ver exactamente qué escribe cada control. Interpreta esas descripciones como el resultado persistido, no como una instrucción para abrir el archivo en un editor. La edición manual es una alternativa de respaldo para hosts sin interfaz gráfica y aprovisionamiento mediante scripts, en los casos donde la documentación lo indica explícitamente.

Modificadores de las combinaciones de teclas

Las combinaciones de teclas usan nombres canónicos de modificadores: control es Control literal, primary es Comando en macOS y Control en el resto, y super es Super/Comando literal. Por ejemplo, control+c, primary+r y alt+shift+up son valores persistidos portátiles. Los valores antiguos ctrl+... se migran una sola vez al cargar la configuración y se reescriben con la forma canónica correspondiente.

Por qué el panel sobre el archivo

• Validación. Los controles rechazan valores mal formados antes de que lleguen al daemon, por lo que un error tipográfico no puede dejar la configuración en un estado que falle al cargarse.
• Descubribilidad. Cada configuración incluye una descripción en línea, por lo que no tienes que consultar la referencia de configuración para saber qué hace un campo.
• Aplicación en vivo. La mayoría de los ajustes surten efecto en el siguiente fotograma, sin necesidad de reiniciar.
• Listas respaldadas por el registro. Las opciones de proveedor, canal, modelo y tema provienen del registro del backend, por lo que las opciones que ves son exactamente las que esta compilación admite.

Configuración local de la interfaz de usuario (zerocode-config.toml)

Algunas opciones describen cómo el propio zerocode renderiza sus paneles, en lugar de cómo se comporta el demonio. Se encuentran en el archivo propio de zerocode, <config-dir>/zerocode-config.toml, y se editan desde el panel Config de zerocode.

El rastreador TodoWrite es uno de ellos. Es una cuestión exclusiva de visualización: el demonio simplemente emite actualizaciones del plan y, a través de ACP, el cliente controla por completo el formato, por lo que es responsabilidad de zerocode:

[todotracker]
enabled = true           # interruptor maestro; cuando es false, el rastreador nunca se renderiza
enabled_at_start = false # visible al iniciar, antes de que llegue el primer plan
location = "right"       # "bottom", "left" o "right"
width = 32               # ancho de columna objetivo del panel lateral (izquierda/derecha)
max_height = 5           # altura máxima de la franja inferior en filas

Los valores se vuelven a leer en cada cambio de sesión, por lo que un cambio realizado en el panel Config se aplica a la siguiente sesión que inicies, reinicies o a la que cambies, sin necesidad de reiniciar zerocode.

Anulaciones del entorno

Cualquier campo se puede sobrescribir para una sola ejecución con una variable ZEROCODE_. La sintaxis consiste en el prefijo seguido de la ruta de configuración en minúsculas, con . escrito como __:

ZEROCODE_todotracker__enabled=false zerocode
ZEROCODE_todotracker__location=parte inferior zerocode

Estas anulaciones son transitorias para el proceso: solo afectan a la instancia en ejecución y nunca se vuelven a escribir en zerocode-config.toml. Guardar un campo no relacionado en el panel Config no incorporará al archivo un valor inyectado mediante una variable de entorno.

Actualización desde un [todotracker] propiedad de un demonio

Antes de que se trasladara esta configuración, [todotracker] era una sección del config.toml del demonio. Si la estableciste allí, copia los valores:

1. Abra el archivo config.toml de su demonio y anote los valores de [todotracker].
2. Coloca el mismo bloque en <config-dir>/zerocode-config.toml (mostrado arriba) o configúralos desde Config → Todo tracker.
3. Elimina la sección [todotracker] del config.toml del demonio.

Las variables de entorno existentes ZEROCLAW_todotracker__* no es necesario eliminarlas antes de actualizar: los cinco campos reconocidos (enabled, enabled_at_start, location, width, max_height) son aceptados e ignorados por el demonio, por lo que una implementación que funcionaba anteriormente sigue iniciándose. Ya no tienen ningún efecto, así que cámbialas a la nomenclatura ZEROCODE_ indicada arriba.