v0.23.1 : un plafond de 2 MiB a discrètement figé votre catalogue de plugins dans le passé

Un collègue balance un nom de plugin dans le canal de l’équipe : « installe celui-là, il est excellent ». Vous tapez la commande d’installation, et Hermes répond qu’il ne trouve pas ce plugin. Vous mettez ça sur le compte d’une faute de frappe, essayez une autre orthographe, même réponse. Vous ouvrez la page du catalogue : il est là, avec une version, un dépôt et une description.
Votre réseau et votre orthographe ne sont pas en cause. Depuis le 9 novembre, le fichier du catalogue officiel pèse plus que ce que le client accepte — et quand le client juge un fichier trop gros, il ne se plaint pas. Il retombe discrètement sur la copie embarquée dans votre version. Ce que vous pouvez chercher est un instantané du jour où cette version a été coupée. La v0.23.1 relève le plafond pour que le catalogue en direct soit de nouveau utilisé.
Trois choses valent la peine d’être comprises : comment le plafond mord, pourquoi le mot « silencieux » est la partie coûteuse ici, et comment vérifier votre propre installation. Plus le reste de la fenêtre.
La version courte : mettez à jour
hermes update
Ensuite, le client accepte jusqu’à 16 MiB au lieu de 2 MiB. Le catalogue en direct se charge : hermes plugins install voit donc les plugins récemment ajoutés, résout les pins actuels plutôt que ceux livrés avec votre version, et respecte les entrées removed plus récentes.
Une réserve qui compte : le correctif est dans le client. Les installations qui restent en v0.23.0 ou antérieure continuent de retomber tant qu’elles ne sont pas mises à jour. Donc quand un collègue jure qu’un plugin n’existe pas, demandez hermes version avant de déboguer quoi que ce soit d’autre.
Comment un plafond mord
Le catalogue de plugins est un document JSON public, récupéré quand vous parcourez la liste ou installez un plugin, puis mis en cache localement pendant six heures. Deux sources, dans un ordre de priorité strict :
- Le catalogue en direct (
plugin-catalog.json), publié par le site de documentation — entrées les plus récentes, pins de version les plus récents, retraits les plus récents ; - Le catalogue embarqué livré avec votre installation — jamais mis à jour, utilisé seulement quand le catalogue en direct ne peut pas être récupéré.
Le chemin de récupération comporte un contrôle de taille. Au-delà du plafond, la réponse est traitée comme cassée : on lève une erreur, on journalise en niveau debug, on renvoie « pas de catalogue en direct ». Chaque appelant en amont voit « rien », retombe sur la copie embarquée, et ne vous dit rien.
Le 9 novembre, le document publié mesurait 2 109 306 octets pour 1 268 entrées — environ 1,7 Ko chacune — et franchissait la ligne des 2 MiB. À partir de là :
- les plugins récemment ajoutés n’existaient pas sur votre machine ;
- les plugins ré-épinglés sur un commit plus récent s’installaient sur le pin livré avec votre version ;
- les entrées « retiré / non maintenu » plus récentes étaient invisibles.
La troisième est celle sur laquelle il faut s’arrêter. Un plugin officiellement retiré n’a plus l’air retiré sur votre installation — il a toujours l’air installable.
Mesure du document en direct à l’instant : 1 380 entrées, 2 310 445 octets. Il dépasse déjà l’ancien plafond de 10 %. Sans la hausse, le cas ne ferait que se généraliser.
Pourquoi « silencieux » était la partie coûteuse
À froid, le bug est une constante réglée trop bas. Le plus dur, c’est le mode de défaillance : chaque erreur était avalée.
Ce design est juste en soi. Un catalogue manquant ne devrait jamais bloquer une installation — si le réseau est coupé ou si le site de doc passe une mauvaise journée, vous devez quand même pouvoir installer depuis la copie que vous avez déjà. Retomber en arrière à la moindre erreur est la bonne politique.
Le problème, c’est que « le document est trop gros » et « je n’ai pas de réseau » ont atterri dans le même seau. Le premier signifie que votre catalogue est périmé et que cela devrait vous importer ; le second signifie attendez une minute et réessayez. Les deux se ressemblaient exactement pour l’utilisateur, et les actions requises étaient opposées. Le bug a survécu sur cette ambiguïté jusqu’à ce que quelqu’un remarque des plugins manquants et remonte jusqu’à la constante.
C’est la forme de la plupart des bugs d’infrastructure, en vérité : rien ne plante, rien ne réveille personne, aucune ligne de log ne passe au rouge — le monde vieillit simplement en silence. Vous faites tout bien et vous obtenez la mauvaise réponse.
Ce qui a changé
Le correctif tient en une constante, mais le commentaire qui l’accompagne vaut la lecture, parce qu’il énonce la frontière :
- le plafond passe de
2 * 1024 * 1024à16 * 1024 * 1024; - aux tailles actuelles par entrée, 16 MiB logent environ 9 000 entrées ;
- le plafond n’a pas disparu. Il borne toujours une réponse hostile ou corrompue — il cesse simplement de punir la croissance normale.
Le même fichier porte les règles de repli alentour, et les connaître vous dit sur quel catalogue vous êtes :
| Règle | Valeur | Ce que cela signifie |
|---|---|---|
| Cache normal | 6 heures | les appels répétés dans la fenêtre évitent le téléchargement |
| Cache périmé utilisable pendant | 24 heures | les caches plus anciens perdent les entrées et ne gardent que la liste des retraits |
| Mémoire d’échec | 60 secondes | après un échec, pas de nouvel essai pendant 60 s |
| Délai de requête | 5 secondes | délai réseau par tentative |
Vérifier sa propre installation
Le test honnête est comportemental : essayez d’installer un plugin listé récemment et regardez s’il se résout. La page de référence hermes plugins donne l’ensemble des sous-commandes.
Deux habitudes valent d’être gardées :
- quand un plugin « n’existe pas », lancez d’abord
hermes version— puis pensez au catalogue ; - quand un plugin se comporte comme une version que vous n’avez pas installée, vérifiez le pin résolu avant d’accuser le plugin.
Si vous avez lu notre article précédent sur le fonctionnement du catalogue de plugins, c’est une conséquence directe de ce design : le catalogue est une donnée, pas du code, et la croissance des données finit par peser sur les hypothèses du client. Le même raisonnement apparaît dans la surface publique de l’API plugin — des interfaces stables sont ce qui permet aux données de croître, et les clients doivent laisser de la place à cette croissance.
Ce qu’il y a d’autre dans la fenêtre
La v0.23.1 est un tag correctif : 618 PR fusionnées depuis la v0.23.0, regroupées en une version stable pour la release GitHub (CLI et installateurs), l’application Microsoft Store, Docker et Hermes Cloud. Mesurée au commit 3b421578588, la fenêtre contient 2 578 commits hors merge sur 2 781 fichiers modifiés (+151 690 / −62 595) et 409 issues fermées.
Les notes de version le disent clairement : une série de fonctionnalités de cette fenêtre reste volontairement non documentée, les notes complètes et rédigées arrivant avec la v0.24.0. Y sont nommés :
- Esc backtrack dans la TUI et la CLI classique, remplaçant le sélecteur de liste de rewind ;
- des chats de groupe qui tournent sur un gateway sans Desktop et peuvent accueillir des bots d’autres ordinateurs ;
- des connexions gateway enregistrées partagées entre Desktop et la Webapp ;
- le navigateur intégré, qui se connecte avec votre vrai profil de navigateur et remplit les identifiants enregistrés depuis sa barre d’adresse ;
hermes gateway attachpour les clients locaux ;hermes clipboard image --json;- une nouvelle surface d’API plugin : valeurs d’environnement liées à la session, méthodes et événements JSON-RPC de plugin, tâches auxiliaires
llm.oneshot, unconversation_idstable à la compression, un hookon_session_opendans le gateway, un hookpost_curator_run; - des lectures de transcript et de handoff plus rapides, plus un gros lot de nouvelles entrées de catalogue.
Nous avons traité la plupart de ces sujets séparément : le workflow Esc backtrack dans rembobiner une conversation sans la perdre, l’entretien du catalogue dans comment les entrées de catalogue sont balayées par lots, et la vue d’ensemble sur la page de la v0.23.0.
Mise à jour
# CLI
hermes update
# ou relancez l'installateur en une ligne
# Docker / Hermes Cloud : nousresearch/hermes-agent:stable
L’application Microsoft Store se met à jour via le Store. Une application Desktop installée depuis l’installateur .exe / .dmg ne change pas dans cette version ; elle récupérera le correctif avec la prochaine version groupée.
Une chose à faire après la mise à jour : installer le plugin qui « n’existait pas » et vérifier qu’il se résout. S’il reste introuvable, regardez hermes plugins list et la version de votre client — à ce stade, le problème vient de l’entrée du plugin ou du dépôt, pas du cache du catalogue.
Notes complètes : la page de la v0.23.1.