SSD Nodes Learn Hosting plans →
Guides Matt ConnorPar Matt Connor

Plugins dsh : fonctionnement et vérifications

Un plugin dsh exécute du code tiers avec les droits de votre agent. Découvrez ce qu’il peut atteindre et les contrôles à faire avant son installation.

Qu’est-ce qu’un plugin dsh, et que peut-il faire ?

Les plugins dsh sont des paquets Node que DeepSeek Harness charge dans son propre processus. Une fois chargé, un plugin exécute le code d’un tiers avec les permissions de votre agent, sur une machine que votre agent peut déjà atteindre. L’étape d’installation est toutefois mieux protégée. pnpm bloque les scripts de build des dépendances jusqu’à votre approbation, et la référence de la CLI indique qu’il faut « redémarrer ce profil après l’ajout, la suppression ou la mise à jour d’un bundle » : un plugin ajouté avec dsh plugin est donc chargé au redémarrage suivant. Un plugin installé depuis la page web Plugins peut être appliqué immédiatement. Une fois chargé, un plugin n’est séparé du reste du harness par aucune barrière. Avant d’en installer un, vous devez donc déterminer ce que son code peut toucher et comment limiter cette portée.

dsh (DeepSeek Harness) est le harness d’agents open source de DeepSeek AI, basé sur un framework de plugins appelé Cordis. Ce terme est essentiel, car un harness d’agents est le programme qui entoure le modèle et gère la boucle d’exécution, les outils et les permissions. Un plugin s’y rattache exactement à ce niveau. Le README du projet indique que tout est un plugin. L’adaptateur du modèle est un plugin. L’interface web dans laquelle vous saisissez vos commandes est un plugin. Tout ce que vous installez depuis l’extérieur du projet rejoint la même arborescence, avec le même niveau de confiance que les composants fournis avec le projet. Si vous n’avez pas encore déployé d’instance, commencez par DeepSeek Harness sur un VPS, puis revenez ici avant d’y ajouter quoi que ce soit.

En août 2026, le AGENTS.md du dépôt listait les points d’extension auxquels un plugin pouvait accéder. Ils couvraient les éléments suivants :

  • LLM (large language model) : le fournisseur payé avec votre clé API
  • Shell : la capacité bash, avec les fournisseurs local et pwsh
  • Filesystem : l’accès aux fichiers contrôlé par des règles
  • Web : les fournisseurs de recherche et de récupération de contenu
  • Subprocess : un fournisseur d’arborescence de processus
  • Workflow : les threads de travail
  • Subagent : la délégation à d’autres agents
  • Settings and credentials : votre configuration enregistrée et vos variables d’environnement

Cette liste a depuis disparu de AGENTS.md. Au 17 novembre 2026, le docs/architecture.md du projet nomme plutôt les points d’extension et ajoute les backends de sandbox, les terminaux persistants, les tâches en arrière-plan, les commandes humaines et les sessions déclenchées par webhook aux interfaces du modèle, des outils, du shell, du système de fichiers et des sous-agents.

Un plugin enregistre également des outils dans ctx.tools, et la documentation précise que le schéma d’un outil enregistré est intégré à l’assemblage du prompt. C’est la seconde partie que beaucoup négligent. Un plugin peut modifier les décisions de votre agent sans que son propre code fasse quoi que ce soit d’inhabituel, car la description qu’il fournit devient du texte lu par le modèle. Le problème est du même type que l’injection de prompt contre les agents de développement, à une différence près : ce texte arrive au moment de l’installation et reste présent jusqu’à la suppression du plugin.

Comment dsh trouve-t-il et charge-t-il les plugins ?

Il n’existe pas de répertoire global de plugins. Un dsh en cours d’exécution est un arbre de plugins assemblé au démarrage à partir de couches ordonnées. Le profil contient vos choix. $DSH_HOME pointe par défaut vers ~/.dsh, et chaque profil se trouve dans $DSH_HOME/profiles/<name>. Les profils web et headless sont créés à la première utilisation à partir des templates fournis.

Un répertoire de profil contient deux fichiers qui déterminent tout :

  • package.json, avec les dépendances des plugins externes et un manifeste dsh.profile contenant la liste ordonnée bundles
  • cordis.patch.yml, votre propre couche de correctifs appliquée par-dessus ces bundles
ls ~/.dsh
ls ~/.dsh/profiles/web

Au démarrage, les couches sont appliquées dans cet ordre. Les couches ultérieures sont prioritaires :

  1. une racine vide
  2. les bundles du profil, dans l’ordre indiqué par le manifeste
  3. le cordis.patch.yml du profil
  4. $DSH_HOME/cordis.patch.yml
  5. les éventuelles surcouches --patch <path> fournies sur la ligne de commande

Deux options affichent le résultat de cette composition sans rien démarrer :

dsh --profile web --dump-default-config
dsh --profile web --dump-config

--dump-default-config affiche uniquement les couches de bundles. --dump-config ajoute les couches de correctifs du profil et du home, ainsi que les éventuelles surcouches --patch. C’est donc ce qui se rapproche le plus d’un inventaire fiable de ce que votre prochain démarrage chargera. Consultez-le avant de faire confiance à une machine dont vous avez hérité.

Un avertissement concernant ces fichiers de correctifs. La configuration ne contient pas seulement des données inertes, car le format autorise des valeurs marquées !!js dans le bloc config d’un plugin. Un extrait cordis.patch.yml copié depuis un forum est du code. Traitez-le comme un script shell provenant de la même source.

Que fait réellement dsh plugin add ?

dsh plugin --profile <name> <args> transmet ses arguments à pnpm dans le répertoire du profil concerné. pnpm doit donc être présent dans le PATH. Les verbes sont ceux de pnpm :

dsh plugin --profile web add '<package-or-git-spec>'
dsh plugin --profile web remove '<package-name>'
dsh plugin --profile web why '<package-name>'
dsh plugin --profile web update

Le modèle de sécurité de l’installation d’un plugin dsh est donc celui de l’installation de n’importe quelle dépendance de type npm, avec une étape supplémentaire : le résultat est ensuite chargé dans votre agent. Le package fournit son propre arbre de dépendances, et chaque package de cet arbre s’exécute dans le même processus. Tout ce qui concerne la façon dont les attaques de la chaîne logistique npm atteignent un serveur s’applique ici sans modification.

À partir de pnpm 10, les scripts de build des dépendances ne sont pas exécutés par défaut. Leur autorisation se fait package par package avec pnpm approve-builds ou le paramètre allowBuilds. pnpm 11 a remplacé l’ancien paramètre onlyBuiltDependencies par allowBuilds. Ainsi, un guide ou une ancienne configuration qui utilise encore onlyBuiltDependencies n’autorise aucun package avec une version actuelle de pnpm. Vérifiez la version de pnpm installée :

pnpm --version

C’est avec les plugins hébergés dans Git que vous rencontrez ce problème en premier. La référence de la CLI indique qu’un plugin Git qui fournit du code source le compile pendant l’installation via son script prepare. La première add échoue donc avec l’indication allowBuilds de pnpm. Copiez la clé affichée dans pnpm-workspace.yaml du profil, puis relancez la commande. L’autorisation de cette clé permet au build du dépôt de s’exécuter avec les permissions de votre utilisateur. Les tarballs déjà compilés et les clones locaux ne nécessitent aucune autorisation.

Ce comportement par défaut est utile, mais c’est aussi la fonctionnalité de sécurité la plus souvent surestimée de l’écosystème. Les scripts de build bloqués empêchent l’exécution de code pendant l’installation. Ils ne protègent pas contre le plugin lui-même, car le rôle d’un plugin est précisément que le harness l’importe et l’appelle après le redémarrage du profil, ou dès que l’installation est appliquée lorsque vous utilisez la page web Plugins. Un plugin n’a pas besoin d’un hook postinstall. Vous l’avez explicitement ajouté.

À lire avant d’installer un plugin dsh

Téléchargez l’archive tar publiée et lisez-la. Rien ne s’exécute lorsque vous décompressez une archive.

npm pack '<package-name>@<version>'
tar -tzf '<package-name>-<version>.tgz'
tar -xzf '<package-name>-<version>.tgz'
less package/package.json

Quatre champs de cette package.json vous donnent déjà l’essentiel. Consultez scripts pour les entrées preinstall, install et postinstall. Consultez dependencies pour les noms que vous ne reconnaissez pas, ou pour ceux qui ne diffèrent que d’un caractère d’un nom connu. Consultez bin pour tout ce que le paquet veut ajouter à votre PATH. Consultez main ou exports pour le fichier d’entrée, puis ouvrez ce fichier et suivez son exécution.

Lisez ensuite le code qui sera réellement chargé. Un plugin qui annonce un outil de notification n’a aucune raison de lire ~/.ssh, d’appeler un hôte dont vous n’avez jamais entendu parler ou de lancer un shell. Si le paquet fournit uniquement du JavaScript regroupé ou minifié et qu’aucun code source correspondant n’existe dans un dépôt public, vous avez votre réponse. Privilégiez les plugins dont le code source est lisible, et privilégiez les plugins de petite taille.

Vous pouvez également interroger le registre sans rien installer :

pnpm view '<package-name>' dependencies
pnpm view '<package-name>' versions

Un paquet publié la semaine dernière, avec une seule version, sans champ de dépôt et dont le nom usurpe celui d’un élément populaire, reprend la plus vieille astuce de tous les registres. Vérifier les téléchargements avec des sommes de contrôle est le réflexe complémentaire : sachez exactement ce que vous avez téléchargé avant de l’exécuter.

Épinglez la version et conservez le lockfile

Une plage de versions flottante signifie que le code exécuté dans le processus de votre agent peut changer lors de n’importe quelle installation ou mise à jour, sans que vous ayez rien décidé. Épinglez la version.

dsh plugin --profile web add --save-exact '<package-name>@<version>'

La position des options varie selon les versions de pnpm. Vérifiez donc le résultat au lieu de faire confiance à la commande. Ouvrez ensuite le package.json du profil et confirmez que la dépendance correspond à une version seule, sans ^ ni ~ devant. C’est ce fichier qui détermine ce qui est installé.

Conservez ensuite le lockfile, qui épingle tout l’arbre transitif et pas seulement le nom de la dépendance de premier niveau :

find ~/.dsh -maxdepth 3 -name 'pnpm-lock.yaml'

Copiez-le dans un emplacement sauvegardé, avec le package.json du profil. Ces deux fichiers reconstruisent le même arbre sur une nouvelle machine. Exécutez dsh plugin --profile web update lorsque vous avez décidé de changer de version, jamais pour faire du nettoyage courant, puis lisez le diff du lockfile.

Pour un plugin installé depuis git plutôt que depuis un registry, épinglez le commit et non la branche. Une spécification de la forme github:owner/repo#<full commit sha> vous donne un arbre fixe. Un nom de branche vous donne le contenu de cette branche lors de la prochaine résolution par pnpm, ce qui revient à laisser cette décision à quelqu’un d’autre. Le harness lui-même nécessite la même discipline, car la release npm latest est une release candidate et une installation sans version épinglée peut en sélectionner une autre un jour donné. C’est de là que viennent la plupart des erreurs d’installation et de version de dsh.

Le marché des plugins, et la valeur réelle de la « curation »

dsh dispose d’un marketplace, installé sous forme de plugin. Cela donne une indication sur son architecture :

dsh plugin --profile web add dshmarket

Après un redémarrage, il apparaît sous forme d’onglet dans la page Plugins, à côté de Installed, avec dsh 0.2.1 et les versions ultérieures. Les hôtes plus anciens utilisent Settings, puis Plugin Market. Son README décrit clairement les limites. Les installations sont limitées aux sources répertoriées dans un registre géré, et toute autre source est rejetée. Les scripts de build sont bloqués par défaut. Pour en activer un, il faut l’approuver pour chaque package. Les plugins de terminal sont signalés avant leur intégration dans un profil web. La phrase la plus importante précise que la présence dans le registre ne constitue pas une recommandation, car les plugins sont du code tiers. Le même README indique que la plupart des plugins installés de cette manière deviennent actifs après un simple rechargement de la page, sans redémarrage. Une installation en un clic peut donc s’exécuter dans votre agent quelques secondes plus tard.

Une liste gérée relève le niveau minimal de sécurité. Elle ne lit pas le code à votre place et ne peut pas vous dire ce que fera la prochaine version d’un plugin après un changement de propriétaire du compte du mainteneur. Traitez une installation en un clic comme vous traiteriez curl | bash provenant du même auteur. Une autre ligne de ce README mérite d’être répétée : une sauvegarde exportée peut contenir des identifiants provenant de la configuration de votre profil. Ne la joignez donc jamais à une issue publique ni à un site de paste. Si vous cherchez une liste de départ plutôt qu’une méthode, les plugins dsh qui valent le détour est l’article complémentaire de celui-ci.

Le harness dispose désormais lui aussi de sa propre route. Un plugin Custom expérimental, qui indexe les bundles et s’active depuis la page Plugins, ajoute un onglet Discover alimenté par les fichiers d’index que vous ajoutez vous-même. dsh ne fournit aucune source d’index. Sa documentation précise que les index sont du contenu tiers et que dsh vérifie le format du fichier, mais pas les informations qu’un index fournit sur le titre, l’auteur ou la source d’un plugin.

Exécuter dsh avec son propre utilisateur, pas avec root

Le contrôle réduit la fréquence des intrusions. Le principe du moindre privilège limite ce qu’un intrus peut atteindre si une intrusion se produit. Sur un VPS, cette seconde partie est simple à mettre en place.

Attribuez au harness son propre compte Unix et son propre répertoire personnel, et ne l’exécutez jamais avec root :

sudo adduser --disabled-password --gecos "" dshrun
sudo -iu dshrun

Dans cette session, démarrez le harness afin qu’il utilise le répertoire personnel de ce compte :

npx @deepseek-ai/dsh web

L’interface web écoute sur http://127.0.0.1:3080 par défaut. Conservez cette valeur. Si vous avez déjà cliqué sur ce lien affiché depuis une autre machine sans obtenir de réponse, ce que dsh signifie lorsqu’il affiche cette adresse l’explique. La composition web fournie vérifie bien les en-têtes Host et Origin et exige un navigateur authentifié ou un Peer API authentifié pour chaque méthode RPC Host et chaque flux WebSocket, et dsh web refuse --host 0.0.0.0. Les clients API s’authentifient via /connect et reçoivent un cookie API signé. Considérez cette connexion comme un second verrou, et non comme une raison de publier le port 3080. Elle donne accès à un agent qui dispose d’un shell : une fuite de jeton de session ou une faille de connexion sur un port public fournit donc à un inconnu un shell distant sans privilèges root, avec une interface conviviale. Accédez-y depuis votre ordinateur portable via un tunnel SSH :

ssh -L 3080:127.0.0.1:3080 you@your-vps

Vérifiez ensuite qu’aucun service n’écoute sur une adresse publique :

ss -lnt | grep 3080

L’adresse locale doit être 127.0.0.1:3080. Si elle est 0.0.0.0:3080, un autre réglage que les valeurs par défaut de dsh web a été appliqué, par exemple une autre composition ou une modification de la configuration, et cette composition gère sa propre authentification. La documentation du projet précise que le serveur web sous-jacent ne fournit ni authentification ni politique Origin. Tant que vous ne savez pas ce qui protège ce port, considérez que votre pare-feu est la seule barrière entre un inconnu et votre agent, puis replacez-le sur l’interface loopback. Le raisonnement présenté dans exécuter Claude Code en toute sécurité sur un VPS s’applique à dsh sans modification. Attribuez à l’agent un seul répertoire de travail qu’il est autorisé à détruire, et conservez hors de cette machine tout ce que vous ne pouvez pas recréer. Mieux encore, considérez cette machine comme une VM jetable pour les agents de programmation, car reconstruire un VPS prend une heure, tandis que l’auditer prend une semaine.

Où se trouvent vos clés et pourquoi les permissions de fichiers ne suffisent pas

dsh conserve les clés d’API dans $DSH_HOME/.credentials.yaml et les valeurs d’environnement dans $DSH_HOME/.env, avec les paramètres du modèle dans cordis.patch.yml du profil actif. Lors de la première vérification de ce guide, en octobre 2026, le $DSH_HOME/settings.yaml d’une version précédente avait été importé une fois, puis renommé en settings.yaml.imported. La clé à placer dans chacun de ces fichiers et les données qui quittent réellement la machine dans chaque mode sont expliquées dans configuration des clés d’API, des modèles et des endpoints de dsh. Il est préférable de régler ce point avant d’ajouter un plugin, car chaque clé que vous configurez est une donnée supplémentaire qu’un plugin peut lire. Sécurisez au minimum les deux fichiers sensibles :

chmod 600 ~/.dsh/.credentials.yaml ~/.dsh/.env
ls -l ~/.dsh

Le mode 600 autorise le propriétaire à lire et à écrire le fichier, et n’accorde aucun droit aux autres utilisateurs. Cette distinction est utile dans les deux notations (modes chmod numériques et symboliques). Il faut toutefois comprendre ce que ces permissions garantissent réellement. Les modes de fichier protègent ces fichiers contre les autres comptes présents sur la machine. Ils ne protègent pas contre un plugin, car celui-ci s’exécute avec l’utilisateur qui possède les fichiers, dans le processus qui les lit. C’est pourquoi garder les secrets hors de portée d’un agent d’IA signifie ne pas les placer sur la machine. Une machine qui exécute dsh doit uniquement contenir la clé du modèle dont elle a besoin. Vos identifiants cloud et vos clés de signature doivent être stockés ailleurs.

Pourquoi un plugin qui lit le Web modifie le modèle de menace

Le point d’intégration Web fournit aux plugins des services de recherche et de récupération. Un plugin qui charge une page dans votre session charge du texte qu’un attaquant peut modifier. Un prompt de modèle ne distingue pas les instructions des données. Une page récupérée peut donc contenir une ligne destinée à votre agent, et un harness qui détient la capacité d’exécuter des commandes shell n’est plus qu’à une étape obéissante de son exécution.

Le contrôle existe déjà dans le harness. dsh-base, le premier bundle partagé des profils web, headless, sdk et acp, fournit le sandbox et la policy d’approbation (le profil sdk-minimal l’exclut volontairement). Utilisez-les. Une session qui peut récupérer des pages non fiables doit exiger une approbation pour toute opération qui écrit ou exécute quelque chose. Ainsi, une instruction récupérée ne peut pas devenir une action par elle-même. Placer les actions de l’agent derrière des approbations explique comment déterminer où placer cette limite. La relation fonctionne aussi dans l’autre sens : votre propre serveur est une page que l’agent de quelqu’un d’autre va récupérer. C’est le sujet de bloquer les robots d’IA sur votre serveur.

Comment vérifier ce qu’un plugin a modifié ?

Créez un snapshot avant l’installation, installez le plugin, créez un snapshot après, puis consultez la différence.

dsh --profile web --dump-config > /tmp/dsh-before.txt
dsh plugin --profile web add '<package-name>@<version>'
dsh --profile web --dump-config > /tmp/dsh-after.txt
diff -u /tmp/dsh-before.txt /tmp/dsh-after.txt

Le diff indique quelles entrées du plugin l’installation a ajoutées à l’arbre composé. Seul un package qui déclare un bundle patch rejoint l’arbre ; une dépendance simple n’y ajoute rien, et dsh vous en avertit une fois. Si un plugin installé pour une petite fonctionnalité ajoute plusieurs entrées que vous ne pouvez pas justifier, arrêtez-vous et consultez le code source avant de le démarrer. dsh plugin --profile web why <package-name> répond à l’autre question : quelles dépendances directes ont entraîné l’installation d’un package donné ?

Les packages installés sont placés dans le node_modules propre au profil, à $DSH_HOME/profiles/<name>/node_modules. Vous pouvez donc aussi examiner l’arbre sur le disque :

ls ~/.dsh/profiles/web/node_modules

Conservez un second profil dans lequel vous ne faites jamais d’expérimentation. Si une installation casse le harness, démarrer dsh --profile <clean-name> vous indique en quelques secondes si le plugin en est la cause.

Comment supprimer un plugin dsh ?

dsh plugin --profile web remove '<package-name>'
dsh --profile web --dump-config > /tmp/dsh-after-removal.txt
diff -u /tmp/dsh-before.txt /tmp/dsh-after-removal.txt

La suppression de la dépendance ne supprime pas toujours la configuration. Les entrées écrites dans le cordis.patch.yml du profil restent en place, car ce fichier vous appartient et le harness ne le réécrit pas à votre place. Ouvrez-le et supprimez tout bloc qui fait référence au package supprimé.

less ~/.dsh/profiles/web/cordis.patch.yml

Il faut ensuite traiter ce qu’aucune commande de désinstallation ne peut corriger. Si vous avez supprimé un plugin parce que vous ne lui faisiez plus confiance, il a déjà lu tout ce à quoi il pouvait accéder. Faites une rotation de la clé API DeepSeek dans la console du fournisseur, ainsi que de tous les autres secrets présents dans $DSH_HOME. Déterminez ensuite à quelles ressources du reste de votre réseau le compte Unix utilisé par le plugin pouvait accéder.

La version courte

  • Lisez l’archive tarball publiée avant l’installation, en commençant par scripts et le fichier d’entrée
  • Épinglez la version exacte, ou le commit exact pour une spécification git, et conservez le fichier lock
  • Installez dans un seul profil et gardez un profil propre que vous pouvez démarrer en cas de problème
  • Comparez --dump-config avant et après chaque installation
  • Exécutez le harness avec son propre utilisateur Unix, sur loopback, et accédez-y via SSH
  • Conservez une seule clé API sur la machine et faites-la tourner le jour où vous supprimez un plugin auquel vous ne faites plus confiance

Rien de tout cela ne justifie d’éviter les plugins. Le modèle des plugins explique l’utilité de dsh, et un harness que vous ne pouvez pas étendre est un harness que vous devrez remplacer. Cela signifie qu’il faut savoir ce que vous avez installé, de qui cela vient et à quelle version, puis exécuter l’ensemble dans un environnement que vous pouvez reconstruire.

FAQ

Les plugins dsh sont-ils isolés les uns des autres ?

Non. Un plugin est chargé dans le processus du harness par l’intermédiaire de Cordis et peut accéder aux interfaces de capacité documentées, notamment au shell, au système de fichiers, au web, aux sous-processus, aux subagents et aux credentials. dsh-base, le premier bundle partagé des profils web, headless, sdk et acp, fournit le sandbox et la politique d’approbation qui contrôlent ce que les outils de l’agent peuvent faire. C’est cette politique qui assure votre protection. Il n’existe pas de limite de permissions entre les plugins. Le modèle à retenir est donc que l’installation d’un plugin étend votre confiance à son auteur et à chaque package de son arbre de dépendances.

Puis-je installer un plugin dsh sans exécuter ses scripts d’installation ?

pnpm 10 et les versions ultérieures bloquent par défaut les scripts de build des dépendances, et dsh plugin ... add transmet les commandes à pnpm. Avec une version actuelle de pnpm, l’installation n’exécute donc pas les scripts des packages, sauf si vous approuvez le package concerné. Vérifiez votre version avec pnpm --version. Cela ne rend pas sûr un plugin dont vous n’avez pas lu le code. Le code du plugin s’exécute dès que le harness le charge, au prochain redémarrage du profil après une installation avec dsh plugin, ou souvent immédiatement après une installation depuis la page Plugins du web. Aucune restriction appliquée au moment de l’installation ne change cela.

Où se trouvent réellement les plugins dsh et leur configuration ?

$DSH_HOME utilise ~/.dsh par défaut. Les profils se trouvent dans $DSH_HOME/profiles/<name>. Chacun contient un package.json avec ses dépendances de plugins, le manifeste dsh.profile des bundles ordonnés et une couche de modifications cordis.patch.yml. Les packages installés sont placés dans le node_modules propre à chaque profil, à l’emplacement $DSH_HOME/profiles/<name>/node_modules. Les clés se trouvent dans $DSH_HOME/.credentials.yaml, les valeurs d’environnement dans $DSH_HOME/.env, et un $DSH_HOME/cordis.patch.yml situé au niveau du répertoire personnel s’applique à tous les profils. Exécutez dsh --profile web --dump-config pour afficher le résultat final de la composition sans démarrer le système.

Est-il sûr d’installer un plugin depuis le marché dsh ?

Le marché limite les installations aux sources présentes dans un registre sélectionné et bloque les scripts de build, sauf si vous les approuvez pour chaque package. C’est une réelle amélioration par rapport au fait de copier-coller un nom de package depuis une fenêtre de chat. Son propre README précise toutefois que la présence dans le registre ne constitue pas une recommandation, car les plugins sont du code tiers écrit par d’autres personnes. Lisez le code source et verrouillez la version. Exécutez le harness avec un compte utilisateur et, idéalement, sur une machine que vous pouvez vous permettre de perdre.

Cet article vous a-t-il été utile ?