L’exploiter

Dépannage

Ce que chaque refus veut dire au juste, et le geste qu’il réclame, y compris les échecs qui sont un comportement correct et non un défaut.

DISPONIBLEÉcrit et couvert par des tests, pas encore observé en exécution réelleDeskworth · publié · mis à jour · 3 sources · Deskworth OS 0.0.48

Livré dans la construction courante. Vous pouvez le faire sur votre machine aujourd’hui.

L’essentiel de ce qui ressemble ici à une panne est un refus, et un refus nomme son geste. La table sépare les deux, parce que chercher à réparer un refus délibéré coûte un après-midi.

#Un fournisseur refuse de se connecter

Ce que vous voyezCe que cela veut direQuoi faire
non installéAucun binaire de ce nom n’est dans le chemin.Installez le CLI de l’éditeur, puis laissez Deskworth regarder à nouveau.
déconnectéLe binaire répond, la session non. Cela a l’air de fonctionner, et c’est le cas le plus fréquent.Connectez-vous, depuis Deskworth pour deux des trois éditeurs, depuis le CLI lui-même pour le troisième.
délai dépasséLa connexion a dépassé trois minutes.Réessayez. Rien n’est cassé ; une connexion par navigateur a simplement pris plus de temps que le délai.
échoué, avec une raisonLa tentative a échoué et Deskworth dit pourquoi dans ses propres mots.Lisez la raison : elle nomme le geste. Le message du CLI lui-même n’est délibérément pas montré, parce qu’il porte une adresse électronique et le chemin d’un jeton.
aucun bouton de connexionCe CLI n’a aucune commande de connexion à piloter.Posez la variable d’environnement qu’il lit, ou connectez-vous une fois depuis l’interface du CLI.

#Une carte ne produit rien

  • Lisez la trace d’abord. Chaque ligne est un évènement d’un processus réel ; si la trace est vide, le processus n’a jamais démarré, et c’est un problème de fournisseur, pas de mandat.
  • Dépliez la sortie brute sous la trace. Elle porte la ligne de commande exacte, et la carte est faite pour se reproduire à la main à partir d’elle.
  • Si un appel d’outil est revenu marqué en erreur, c’est l’outil qui refuse en donnant sa raison, pas le serveur qui casse. La raison est écrite pour que l’agent agisse dessus, et elle vaut d’être lue par vous aussi.

#Une demande est refusée avant que rien ne tourne

  • PRÉVUUne présentation ou un PDF a été demandéAucun des deux formats n’a de moteur. Le contrôle préalable refuse avant qu’un processus ne démarre, d’où un refus instantané qui ne coûte rien. Demandez un classeur à la place.
  • DISPONIBLEUn outil ne figure pas dans la liste d’une carteLe rôle ne tient pas la capacité que cet outil réclame. Il n’est pas caché comme une porte fermée, il n’existe pas pour ce rôle. La page de référence montre quels rôles tiennent quels outils.
  • DISPONIBLEUn connecteur a été refusé à la déclarationLe rôle auquel vous l’avez attribué lit vos propres données, et un connecteur va vers l’extérieur. Les deux ne se cumulent jamais. Attribuez-le à un rôle qui ne lit ni le bureau ni vos dépôts.
  • DISPONIBLEUn outil a répondu qu’une clé manqueCertains fournisseurs de données en réclament une. L’outil refuse proprement et le dit, au lieu de basculer en silence sur une autre source, ce qui vous donnerait un nombre dont vous ne sauriez pas nommer l’origine.

#Un processus a survécu à l’application

Quitter depuis l’application arrête tout processus qu’elle a démarré. Une interruption brutale venue de l’extérieur contourne ce chemin par définition, et un orphelin a été observé exactement de cette manière. C’est le comportement attendu d’un signal, pas une fuite, mais si vous tuez l’application depuis l’extérieur, cherchez vous-même un processus de CLI resté là.

#La réponse dit BLOCKED

C’est un résultat, pas un échec, souvent le plus honnête disponible. Cela veut dire que la question n’a pas pu être traitée à la date d’arrêté avec des sources admissibles, et que le mandat l’a dit au lieu d’approximer. L’artefact bloqué porte ce qui a été tenté et pourquoi cela s’est arrêté ; le contrat refuse de le déposer autrement.

#Sources

  1. Deskworth OS, product state at 0.0.23Deskworthinternal handover report · Deskworth OS 0.0.23 · commit produit 5968ef0 · lu à bcae42d · publié 2026-09-10 · lu 2026-09-10Document interne, non publié
  2. The provider registry, mirrored on this siteDeskworthinternal registry · provider registry mirror of providers::ALL · lu 2026-09-10Document interne, non publié
  3. The tool registry, mirrored on this siteDeskworthinternal registry · tool registry mirror of mcp::tools::TOOLS, crossed with the roles’ declared capabilities · lu 2026-09-10Document interne, non publié