Volet de configuration

Le volet Config de zerocode est le moyen de configurer un ZeroClaw en cours d’exécution. Chaque paramètre dispose d’un contrôle typé, d’une validation et d’une explication intégrée de son rôle, et la plupart des paramètres s’appliquent en direct sans redémarrage du démon. Ouvrez-le depuis n’importe quelle session zerocode et modifiez-y les paramètres plutôt que d’éditer manuellement le fichier de configuration.

Les paramètres sont toujours persistés dans votre configuration, et la documentation décrit les champs concernés afin que vous puissiez voir exactement ce qu’écrit un contrôle donné. Lisez ces descriptions comme le résultat persisté, et non comme une instruction d’ouvrir le fichier dans un éditeur. La modification manuelle est une solution de repli pour les hôtes sans interface graphique et le provisionnement par scripts, lorsque la documentation le mentionne explicitement.

Modificateurs de raccourcis clavier

Les raccourcis clavier utilisent des noms canoniques de modificateurs : control désigne littéralement Control, primary désigne Command sur macOS et Control ailleurs, et super désigne littéralement Super/Command. Par exemple, control+c, primary+r et alt+shift+up sont des valeurs portables persistées. Les anciennes valeurs ctrl+... sont migrées une fois lors du chargement de la configuration et réécrites avec l’orthographe canonique correspondante.

Pourquoi le volet au-dessus du fichier

• Validation. Les contrôles rejettent les valeurs mal formées avant qu’elles n’atteignent le démon, de sorte qu’une faute de frappe ne peut pas laisser la configuration dans un état qui échoue au chargement.
• Découvrabilité. Chaque paramètre comporte une description en ligne, vous n’avez donc pas besoin de consulter la référence de configuration pour savoir à quoi sert un champ.
• Application en direct. La plupart des paramètres prennent effet à la frame suivante, sans redémarrage.
• Listes basées sur le registre. Les choix de fournisseur, de canal, de modèle et de thème proviennent du registre du backend, donc les options affichées sont exactement celles prises en charge par cette version.

Paramètres locaux de l’interface utilisateur (zerocode-config.toml)

Certains paramètres décrivent comment zerocode lui-même affiche ses volets, plutôt que le comportement du démon. Ils figurent dans le fichier propre à zerocode, <config-dir>/zerocode-config.toml, et se modifient depuis le volet Config de zerocode.

Le suivi TodoWrite en fait partie. Il s’agit uniquement d’un élément d’affichage : le démon se contente d’émettre les mises à jour du plan et, via ACP, le client contrôle entièrement le formatage ; il relève donc de zerocode :

[todotracker]
enabled = true           # interrupteur principal ; lorsque false, le suivi n'est jamais affiché
enabled_at_start = false # visible au lancement, avant l'arrivée du premier plan
location = "right"       # "bottom", "left" ou "right"
width = 32               # largeur de colonne cible du panneau latéral (gauche/droite)
max_height = 5           # hauteur maximale de la barre inférieure en lignes

Les valeurs sont relues à chaque transition de session, de sorte qu’une modification apportée dans le volet Config s’applique à la prochaine session que vous démarrez, redémarrez ou vers laquelle vous basculez, sans qu’un redémarrage de zerocode soit nécessaire.

Surcharges de l’environnement

Chaque champ peut être remplacé pour une seule exécution au moyen d’une variable ZEROCODE_. La syntaxe est le préfixe suivi du chemin de configuration en minuscules, où . est noté __ :

ZEROCODE_todotracker__enabled=false zerocode
ZEROCODE_todotracker__location=bas zerocode

Ces remplacements sont transitoires au niveau du processus : ils n’affectent que l’instance en cours d’exécution et ne sont jamais réécrits dans zerocode-config.toml. Enregistrer un champ non apparenté dans le volet Config n’enregistrera pas dans le fichier une valeur injectée par une variable d’environnement.

Mise à niveau depuis un [todotracker] géré par un démon

Avant le déplacement de ce paramètre, [todotracker] était une section du config.toml du daemon. Si vous l’y avez défini, recopiez les valeurs :

1. Ouvrez le fichier config.toml de votre démon et notez les valeurs de [todotracker].
2. Placez le même bloc dans <config-dir>/zerocode-config.toml (indiqué ci-dessus), ou définissez-les depuis Configuration → Suivi des tâches.
3. Supprimez la section [todotracker] du fichier config.toml du démon.

Les variables d’environnement ZEROCLAW_todotracker__* existantes n’ont pas besoin d’être supprimées avant la mise à niveau : les cinq champs reconnus (enabled, enabled_at_start, location, width, max_height) sont acceptés et ignorés par le démon, de sorte qu’un déploiement qui fonctionnait auparavant démarre toujours. Ils n’ont plus aucun effet ; remplacez-les donc par la syntaxe ZEROCODE_ indiquée ci-dessus.