Installer DeepSeek Harness sur un VPS en privé
Installez DeepSeek Harness sur un VPS Linux, épinglez la version npm, comprenez les plugins et ouvrez l’interface web du port 3080 via un tunnel SSH.
Ce qu’est le DeepSeek Harness
Le DeepSeek Harness (dsh) est un runtime d’agent Node.js que vous pouvez exécuter sur un VPS (serveur privé virtuel). La méthode sûre consiste à le lier à 127.0.0.1 et à y accéder depuis votre navigateur via un tunnel SSH (secure shell). Il sert une interface web (UI, interface utilisateur) sur le port 3080 au lieu de fonctionner dans un terminal. Dans la version 0.1.0-rc.6 ciblée par ce guide, ce serveur web ne demande aucun mot de passe qui lui soit propre. Un port 3080 exposé sur Internet donne donc à toute personne qui le découvre accès à un agent capable de lire vos fichiers et d’exécuter des commandes avec votre compte Linux. Les versions plus récentes, de 0.2.0-rc.2 à 0.2.2-rc.2 du 11 novembre 2026, qui est la version la plus récente listée par GitHub le 12 novembre 2026, affichent au démarrage une URL contenant un nouveau token pour le processus, puis l’échangent contre un cookie de session. Elles continuent toutefois d’écouter sur loopback par défaut et refusent toujours de se lier à toutes les interfaces.
DeepSeek le publie sous licence MIT, sous la forme du package npm @deepseek-ai/dsh. Le projet se présente comme une version d’évaluation destinée aux développeurs et précise que des changements incompatibles sont prévus. La version ciblée ci-dessous est celle publiée en août 2026. Le 12 novembre 2026, le tag latest de npm désigne 0.2.2-rc.1. GitHub liste la prerelease plus récente 0.2.2-rc.2, marquée dsh-v0.2.2-rc.2 et publiée le 11 novembre 2026. Consultez le dépôt avant de copier quoi que ce soit sur un serveur important.
Une idée traverse toute la conception : tout est un plugin. L’adaptateur du modèle, le registre des outils, le journal des sessions, la sandbox, le scheduler et la boucle de l’agent elle-même sont des plugins chargés dans un contexte partagé unique. Chacun peut être remplacé. Il n’existe aucun cœur privilégié que les plugins se contenteraient de décorer. C’est ce qui rend le harness intéressant à essayer, mais c’est aussi là que se trouve le seul risque réel. La pertinence de ce compromis dépend de l’élément de comparaison. La comparaison avec Claude Code et Omnigent met la conception où tout est un plugin en regard de deux autres approches concernant le couplage au modèle, la licence et la quantité de ressources d’un VPS demandée par chacune.
Un harness n’est pas un modèle
Le harness exécute la boucle de l’agent. Le raisonnement est effectué ailleurs, dans un modèle. Rien ne fonctionne donc tant que vous ne lui avez pas fourni une clé d’API (application programming interface) ou l’adresse d’un endpoint de modèle que vous hébergez vous-même. Tout ce qui est décrit dans cet article concerne la configuration du harness, et non le comportement du modèle. Il est utile de bien comprendre la distinction entre les deux avant de passer l’après-midi à chercher de quel côté se trouve le problème.
Vous configurez cela dans l’interface, sous Settings, puis Models. DeepSeek dispose de sa propre carte. Dans les versions actuelles, le bouton « Add model provider » situé dessous ouvre deux modes. « Third-party model provider » couvre les fournisseurs pour lesquels le harness fournit un catalogue, comme OpenAI et Anthropic. Vous y collez une clé, puis le catalogue fournit l’endpoint et la liste des modèles. « Custom model API » est l’option la plus intéressante. Elle demande un identifiant de fournisseur en minuscules, un nom d’affichage, une URL de base, un protocole d’API, un identifiant d’authentification et au moins un modèle. Le sélecteur de protocole propose OpenAI Chat Completions, OpenAI Responses, Anthropic Messages et Gemini API. Vous pouvez donc configurer une gateway ou un serveur local qui utilise l’un de ces protocoles. Les endpoints dont le format des requêtes diffère nécessitent des paramètres de compatibilité. Les fournisseurs personnalisés peuvent également interroger l’endpoint OpenAI-compatible GET /models pour remplir automatiquement la liste des modèles.
C’est ainsi que vous indiquez au harness d’utiliser un modèle installé sur le même VPS. Ollama expose une API compatible OpenAI à l’adresse http://127.0.0.1:11434/v1/. Le champ de clé d’API accepte n’importe quelle chaîne, ollama par convention, car le client de type OpenAI exige une valeur et qu’Ollama l’ignore. La documentation d’Ollama décrit également ollama launch dsh. Cette commande installe @deepseek-ai/dsh s’il n’est pas présent et le démarre avec un modèle Ollama. Vérifiez donc la version installée avant de vous fier au pin ci-dessous. La question la plus difficile est de savoir si un modèle assez petit pour tenir sur votre VPS est suffisamment performant pour piloter un agent. La différence entre Ollama et vLLM en tant que serveurs de modèles locaux détermine la quantité de RAM nécessaire.
Les clés saisies dans l’interface sont en écriture seule. Le harness les stocke dans $DSH_HOME/.credentials.yaml. Les paramètres ne conservent qu’une référence à l’identifiant d’authentification. Dans les versions actuelles, cette référence est écrite dans le fichier de patch du profil actif, $DSH_HOME/profiles/<profile>/cordis.patch.yml (le profil est web pour dsh web). $DSH_HOME est la valeur par défaut de ~/.dsh. Traitez le fichier d’identifiants comme un fichier de mots de passe, car c’en est un. Toute personne qui peut le lire peut utiliser votre budget d’API. Si vous préférez modifier directement ces fichiers plutôt que de passer par Settings, la procédure consacrée aux fichiers de configuration, aux clés et aux endpoints de modèles de dsh explique le rôle de chaque clé et les données qui quittent votre machine dans chaque mode.
Prérequis avant l’installation
- un VPS sous Ubuntu 24.04 ou une autre version récente de Linux, avec un accès SSH
- Node.js 24.9 ou une version ultérieure, car la branche principale du projet et
0.2.2-alpha.2déclarent désormais>=24.9.0, et ses tests CI utilisent Node 24 avec une vérification de compatibilité sur Node 24.9 et Node 26, sans tâche pour Node 22 ; les versions marquées jusqu’à0.2.1-rc.4indiquaient encore Node 22.19 comme version acceptable, mais ce n’est plus la version minimale utilisée pour construire le projet - un compte utilisateur normal, et non
root, car l’agent exécute les commandes shell avec l’utilisateur qui a démarré le processus pnpmdans le PATH si vous prévoyez d’installer des plugins, car la commande du plugin l’exécute via un shell- le port 3080 fermé sur votre firewall et sur le firewall réseau distinct de votre fournisseur
Le paquet nodejs fourni par Ubuntu 24.04 est plus ancien que ce dont le harness a besoin. Sur cette version, installez donc Node depuis NodeSource ou nvm au lieu d’utiliser apt install nodejs. Le dépôt officiel d’Ubuntu 26.10 propose Node 24.19.0, qui dépasse le minimum requis de Node 24.9. Si le VPS est neuf, sécuriser SSH avant toute autre chose vaut les dix minutes nécessaires, car le tunnel dont vous allez dépendre est aussi fiable que le serveur SSH qui se trouve derrière.
Installer DeepSeek Harness sur un VPS en verrouillant une version
node --version
npx @deepseek-ai/dsh@0.1.0-rc.6 webnpx télécharge le paquet et exécute son binaire dsh. web est un alias de --profile web, qui démarre l’application web, puis le processus affiche l’adresse sur laquelle il est à l’écoute. La valeur par défaut est http://127.0.0.1:3080. Ces valeurs correspondent à une décision d’association réseau, et non à une simple valeur par défaut cosmétique. Pourquoi dsh affiche une adresse loopback explique à quelles requêtes le harness répond ou ne répond pas avant que vous essayiez d’y accéder depuis votre ordinateur portable.
Verrouillez la version. npx @deepseek-ai/dsh web résout le tag vers lequel pointe latest au moment où vous exécutez la commande, sauf si le projet depuis lequel vous l’exécutez contient déjà une copie installée ; dans ce cas, npx utilise discrètement cette copie. Dans les deux cas, ce n’est pas vous qui choisissez la version. Le projet a déjà publié plusieurs release candidates et annonce des changements incompatibles à venir. 0.1.0-rc.6 est la version d’août 2026 verrouillée ici. Le 12 novembre 2026, latest pointe vers 0.2.2-rc.1, une release qui affiche une URL de démarrage contenant un token ; GitHub répertorie la prerelease plus récente 0.2.2-rc.2. Passer à une autre version est donc exactement le type de mise à niveau à effectuer volontairement après avoir lu le dépôt. Une version verrouillée garantit que la machine configurée aujourd’hui se comportera de la même manière le mois prochain. La mise à niveau devient ainsi une décision que vous prenez, et non un incident que vous découvrez. Si une commande utilisant une version verrouillée démarre malgré tout le mauvais build ou refuse complètement l’installation, Les erreurs d’installation et de version dsh les plus courantes expliquent comment vider le cache npx et vérifier quel npm est fourni avec votre Node.
Pour l’utilisation quotidienne, installez-le une fois au lieu de refaire la résolution à chaque démarrage.
npm install -g @deepseek-ai/dsh@0.1.0-rc.6
dsh --profile web --helpCette deuxième ligne mérite d’être exécutée, car le launcher et l’application web utilisent des ensembles de flags distincts. dsh --help affiche les options propres au launcher. dsh --profile web --help affiche les flags acceptés par l’application web. C’est là que se trouvent --port, --host et --trusted-host, qui peut être répété.
Vérifiez maintenant sur quelle adresse il est à l’écoute.
ss -tlnp | grep 3080La colonne de l’adresse locale doit afficher 127.0.0.1:3080. Si elle affiche 0.0.0.0:3080, l’interface web est à l’écoute sur toutes les interfaces. Seuls vos firewalls la séparent donc d’Internet. Arrêtez le processus avant toute autre action.
Pourquoi vous ne devez jamais publier le port 3080
Le serveur web de 0.1.0-rc.6 ne comporte aucune couche d’authentification. Sa configuration expose une adresse d’écoute et un port d’écoute, et c’est toute sa surface. Le contrôle d’accès pour les déploiements autres que loopback repose sur un paramètre distinct de trusted host. Ce paramètre ne constitue pas un écran de connexion.
Les versions plus récentes en ajoutent une. À partir de 0.2.0-rc.2, le démarrage affiche une URL contenant un nouveau token pour ce processus. Le navigateur qui l’ouvre reçoit un cookie de session signé, puis est redirigé vers la même adresse sans le token. Une restriction Host/Origin placée devant les routes de /api n’accepte que loopback, l’adresse de bind du listener et les autorités indiquées avec --trusted-host. Il s’agit bien d’un identifiant, mais la documentation du projet précise que l’URL affichée est un identifiant à partager uniquement avec les utilisateurs prévus et qu’une connexion HTTP simple l’envoie sans chiffrement. Depuis 0.2.1-alpha.2, l’application web peut également se binder à une adresse locale précise et servir elle-même le HTTPS avec --tls-cert et --tls-key. Cela corrige le problème du texte en clair, pas celui de l’exposition. Le port exposé est plus difficile à exploiter. Cela ne justifie pas de le publier.
Il faut ensuite prendre en compte ce qui se trouve derrière ce port. L’agent modifie les fichiers du workspace et exécute des commandes shell. Vos identifiants de fournisseur sont stockés sur le disque, à côté de lui. Avec la release figée, un port 3080 ouvert équivaut donc à un shell distant avec une interface de chat, exécuté avec les droits de l’utilisateur qui l’a démarré, et auquel votre clé API est associée. Personne n’a besoin d’un exploit pour cela. Il suffit de connaître le numéro du port. Avec une release utilisant le token de démarrage, il faut également le token. Toute personne pouvant lire votre terminal, les journaux du service ou votre trafic non chiffré le possède déjà.
La CLI (interface de ligne de commande) confirme cette approche. Depuis 0.1.0-rc.6, elle ne prend délibérément pas en charge --host 0.0.0.0 et quitte avec une erreur d’utilisation au lieu de démarrer. La nouvelle 0.2.2-alpha.2 le refuse également au démarrage. Ce refus est une fonctionnalité. Ne cherchez donc pas un patch qui le supprime.
Deux autres déploiements sont raisonnables lorsqu’un tunnel ne vous convient pas. Placez la machine sur un réseau overlay privé afin qu’elle ne possède qu’une adresse vers laquelle seuls vos propres appareils peuvent router. C’est ce que fournit un serveur de contrôle Headscale auto-hébergé. Vous pouvez aussi placer un reverse proxy devant elle afin qu’il authentifie la requête avant qu’elle n’atteigne le port 3080, par exemple un serveur d’authentification unique Authentik utilisant forward auth. Un reverse proxy sans authentification devant le service ne constitue pas un contrôle de sécurité. C’est simplement une URL plus longue.
Accéder à l’interface web via un tunnel SSH
Exécutez cette commande sur votre ordinateur portable, pas sur le serveur.
ssh -N -L 3080:127.0.0.1:3080 you@your-server-L ouvre le port 3080 sur votre ordinateur portable et transfère toute connexion qui y arrive via la session SSH chiffrée. La partie 127.0.0.1:3080 est résolue sur le serveur. La connexion arrive donc au harness depuis loopback, exactement comme si vous étiez devant la machine. -N indique de ne pas démarrer de shell distant, car vous voulez uniquement le transfert.
Ouvrez ensuite http://127.0.0.1:3080 dans votre navigateur local. Avec une version qui utilise un launch token, ouvrez plutôt l’URL complète de démarrage affichée par le serveur, avec le token inclus. Lorsque le harness est démarré via SSH, il affiche toujours la ligne de démarrage, mais n’essaie pas d’ouvrir un navigateur à votre place. Si le port 3080 est déjà utilisé sur votre ordinateur portable, modifiez le numéro de gauche : ssh -N -L 3180:127.0.0.1:3080 you@your-server, puis accédez à http://127.0.0.1:3180. Modifiez le port d’une URL avec token de la même manière. Le numéro de gauche est local et celui de droite appartient au serveur. Seul le numéro de gauche doit donc changer.
Enregistrez-la dans ~/.ssh/config et ne la saisissez plus manuellement.
Host dsh
HostName 203.0.113.10
User deploy
IdentityFile ~/.ssh/id_ed25519
LocalForward 3080 127.0.0.1:3080Le tunnel est ensuite démarré par ssh -N dsh. Si le navigateur indique que la connexion a été refusée, cela signifie généralement que le tunnel est actif, mais que rien n’écoute à l’autre extrémité. SSH transfère le port, que le harness soit démarré ou non. Vérifiez le serveur avec la commande ss ci-dessus.
Conserver le harness après la déconnexion
Une commande npx s’arrête avec votre shell. Un service utilisateur systemd reste actif et relance le harness après un crash ou un redémarrage. L’unité présentée ici est volontairement minimale. Si vous voulez exécuter le harness avec son propre compte verrouillé, définir la version directement dans l’unité et disposer de journaux réellement consultables, la configuration systemd sans interface pour dsh couvre ce sujet en détail.
loginctl enable-linger $USER
mkdir -p ~/.config/systemd/user
command -v dshenable-linger est important, car les services utilisateur s’arrêtent normalement à la fin de votre dernière session. Sans ce paramètre, le harness s’arrête dès que vous fermez le tunnel. Utilisez le chemin absolu affiché par command -v dsh et indiquez-le dans l’unité, car systemd ne recherche pas les commandes dans le PATH construit par votre shell de connexion.
[Unit]
Description=DeepSeek Harness web UI
After=network-online.target
[Service]
Type=simple
WorkingDirectory=%h/projects/site
ExecStart=/usr/local/bin/dsh web
Restart=on-failure
RestartSec=5
[Install]
WantedBy=default.targetWorkingDirectory n’est pas un détail esthétique. Le processus dsh utilise son répertoire de lancement comme emplacement par défaut dans le système de fichiers. Un service lancé au mauvais endroit indique donc le mauvais répertoire à l’agent. Ce répertoire n’est toutefois qu’une valeur par défaut : une nouvelle interface Web n’a aucun workspace sélectionné tant que vous n’en avez pas ajouté un sous Choose workspace, et le guide du projet vous demande d’ajouter le répertoire depuis lequel vous avez lancé dsh. Le guide ne contient aucun marqueur de version, et la même formulation figure déjà dans 0.1.0-rc.7. Elle devrait donc aussi s’appliquer à la release épinglée. Définissez le répertoire de l’unité sur celui du projet, puis sélectionnez ce workspace dans l’interface.
systemctl --user daemon-reload
systemctl --user enable --now dsh
systemctl --user status dshUne unité qui refuse de démarrer utilise presque toujours un mauvais chemin ExecStart ou une version de Node rejetée par le binaire. journalctl --user -u dsh -n 50 indique laquelle. Avec une release qui prend en charge le launch token, le journal est également l’endroit où apparaît l’URL de démarrage contenant le token, et chaque redémarrage en génère une nouvelle. La même méthode permet de maintenir un agent de codage actif sur un VPS, et les modes d’échec sont identiques.
Ce qu’un plugin peut faire
Un plugin est un module qui ajoute des services, des événements typés et des effets réversibles à un contexte partagé. Les points d’extension méritent une attention particulière :
- enregistrer un fournisseur de modèles sur
ctx.llm - ajouter des outils destinés au modèle sur
ctx.tools - fournir le backend shell derrière
ctx.shell - fournir l’accès au système de fichiers ou la policy derrière
ctx.fs - enregistrer des commandes utilisateur sur
ctx.commands - exécuter des tâches en arrière-plan via
ctx.jobs - encapsuler les processus lancés avec un backend
ctx.sandbox - intercepter les requêtes et les appels d’outils via les événements
agent/*ettools/* - étendre l’état durable de la session
- piloter l’interface utilisateur via
ctx.agents
Lisez cette liste comme le ferait un attaquant. Un plugin peut fournir la couche du système de fichiers et la couche shell. Il peut aussi s’intercaler dans chaque appel d’outil effectué par le modèle. Aucune boîte de dialogue de permission ne s’interpose entre un plugin et ces points d’extension, car un plugin est du code Node ordinaire chargé dans le même processus que le reste. Installer un plugin revient à exécuter le code d’un tiers avec les permissions de votre agent, c’est-à-dire avec les permissions de votre utilisateur Unix.
C’est la même décision de confiance que lorsque vous rattachez un serveur MCP à un agent sur un VPS, MCP désignant le protocole de contexte du modèle. C’est aussi pourquoi exécuter un agent de programmation en toute sécurité sur un VPS commence par le compte sous lequel il s’exécute, et non par le modèle, et pourquoi les attaques de la supply chain npm sont particulièrement graves sur les serveurs : l’étape d’installation constitue la compromission, et aucune confirmation ne vous est demandée.
D’où viennent les plugins
Les plugins résident dans des profils. Un profil est une composition nommée stockée sous $DSH_HOME, qui vaut par défaut ~/.dsh. Chaque répertoire de profil contient les plugins externes qu’il installe. La CLI les gère en transmettant directement vos arguments à pnpm, avec le répertoire du profil comme répertoire de travail.
dsh plugin --profile web add github:deepseek-harness/turtle-ui
dsh plugin --profile web remove turtle-uiComme les arguments sont transmis à pnpm sans modification, add, remove, update et why se comportent comme dans n’importe quel projet pnpm. Un plugin peut être un paquet npm ou une référence GitHub. pnpm doit d’abord être disponible dans le PATH. Avec Node 24, corepack enable pnpm l’y place. Node 25 ne distribue plus Corepack. Avec Node 25 et les versions ultérieures, installez-le plutôt avec npm install -g pnpm.
La découverte passe par un topic GitHub. Les auteurs de plugins ajoutent le topic dsh-plugin à leur dépôt. Parcourir ce topic permet donc de trouver les plugins disponibles. Un topic est une étiquette qu’un auteur applique à son propre dépôt. Personne ne le vérifie ni ne le signe. La page du topic classe les dépôts selon leur nombre d’étoiles, ce qui mesure la popularité, pas la sécurité.
Les versions actuelles incluent également un bundle expérimental Custom plugin indexes. Activez-le dans Plugins. Un onglet Discover vous permet alors d’ajouter un index, c’est-à-dire un fichier JSON récupéré depuis une URL que vous fournissez. Le harness ne fournit aucun index, vérifie le format du fichier, mais pas les titres, les auteurs ni les sources revendiqués par un market. Toute personne située sur le chemin réseau peut modifier un index transmis via http: en clair. Un market est un catalogue créé par un tiers, pas une évaluation.
Quatre habitudes permettent de limiter les risques. Lisez le code source avant l’installation, car la plupart des plugins sont assez petits pour être examinés en dix minutes. Épinglez la version ou le commit exact au lieu de suivre une branche. Exécutez le harness avec un utilisateur qui ne possède rien d’autre, sur un VPS que vous accepteriez de réinstaller. Donnez à l’agent sa propre clé API et sa propre limite de dépenses, séparées de la clé utilisée par vos services de production. Lorsque vous examinez un plugin et voulez savoir quels fichiers présentent un risque, le guide pour évaluer un plugin dsh passe en revue le manifeste, le point d’entrée et les points d’extension enregistrés par un plugin.
Si vous préférez comparer les architectures avant de vous engager, le harness multi-agent Omnigent répond au même problème avec une structure différente. Les compromis deviennent évidents dès que les plugins sont utilisés. Si vous gardez finalement deux ou trois plugins sur la même machine au lieu d’en choisir un seul, placer tous les harness derrière une seule API auto-hébergée vous évite de créer un tunnel par port. En contrepartie, vous ajoutez un service qui doit être lié à loopback et recevoir un vrai mot de passe dès le premier jour.
Ce qui casse en premier
Node est trop ancien. La branche principale du projet et 0.2.2-alpha.2 nécessitent Node 24.9 ou une version ultérieure, et sa CI teste Node 24 ainsi qu’une vérification de compatibilité sur Node 24.9 et Node 26, sans rien tester sur Node 22. Les anciennes releases taguées jusqu’à 0.2.1-rc.4 indiquaient que Node 22.19 était accepté, mais le projet ne se compile plus avec cette version. Un runtime ancien échoue au démarrage, car le code utilise une syntaxe et des API qu’il ne fournit pas. Exécutez node --version avant toute autre chose.
Le port 3080 est déjà utilisé. Il peut être occupé par un second outil de test, un processus résiduel ou une application indépendante qui utilise elle aussi le port 3080. Trouvez le processus avec ss -tlnp | grep 3080, puis arrêtez-le ou démarrez l’outil de test ailleurs avec dsh web --port 3180. --port appartient à l’application web, et doit donc être exécuté après web.
Le navigateur ne peut pas se connecter via le tunnel. Vérifiez que vous avez accédé à 127.0.0.1 et non à l’adresse publique du serveur, car le port transféré n’existe que sur votre ordinateur portable. Vérifiez ensuite que l’outil de test est en écoute sur le serveur, car SSH configure le transfert même si aucun service ne répond à l’autre extrémité.
dsh plugin échoue immédiatement. Cette commande encapsule pnpm. Un binaire pnpm absent l’arrête donc avant le début du traitement des plugins. Avec Node 25 et les versions ultérieures, c’est l’état par défaut, car Corepack n’est plus fourni avec Node.
L’agent ne voit pas votre projet. Une nouvelle interface Web n’a aucun workspace sélectionné tant que vous n’en avez pas ajouté un, et le composeur de session reste indisponible jusque-là. Le processus utilise le répertoire depuis lequel il a été démarré comme emplacement par défaut dans le système de fichiers. Ainsi, une unité dont le WorkingDirectory est votre répertoire personnel indique à l’agent d’utiliser ce répertoire. Sélectionnez le workspace dans l’interface ou corrigez l’unité, puis rechargez-la.
FAQ
Est-il prudent d’exposer l’interface web de DeepSeek Harness sur le port 3080 ?
Non. Dans le 0.1.0-rc.6 épinglé, le serveur web n’a pas de système de connexion propre. L’agent qui se trouve derrière modifie des fichiers et exécute des commandes shell avec les droits de l’utilisateur qui a démarré le processus. Votre clé d’API du fournisseur est également stockée sur le même disque. À partir de 0.2.0-rc.2, notamment avec 0.2.2-rc.1, la version latest de npm publiée le 12 novembre 2026 et la nouvelle préversion 0.2.2-rc.2, l’URL de démarrage affichée contient un token de lancement. Le navigateur l’échange contre un cookie de session. Mais cette URL est un identifiant d’authentification que HTTP envoie en clair. Les recommandations restent donc les mêmes. Laissez le listener sur 127.0.0.1 et accédez-y via un tunnel SSH. Un réseau overlay privé ou un reverse proxy qui authentifie chaque requête avant de la transmettre au port convient également. Depuis la version 0.1.0-rc.6, la CLI refuse --host 0.0.0.0 et se termine avec une erreur d’utilisation. 0.2.2-alpha.2 le rejette toujours aussi. Cela indique la position des auteurs sur cette configuration.
Ai-je besoin d’une clé d’API DeepSeek, ou puis-je utiliser un modèle local ?
Les deux sont possibles, car le harness est un runtime et non un modèle. Dans Settings, puis Models, vous pouvez coller une clé dans la fiche DeepSeek ou dans celle d’un fournisseur du catalogue. Vous pouvez aussi choisir « Add model provider », puis « Custom model API », et lui fournir une base URL compatible avec OpenAI Chat Completions, OpenAI Responses, Anthropic Messages ou Gemini API. Un serveur Ollama local répond sur http://127.0.0.1:11434/v1/ et accepte n’importe quelle chaîne dans le champ de clé d’API. Les clés sont stockées dans $DSH_HOME/.credentials.yaml, qui utilise ~/.dsh/.credentials.yaml par défaut.
Que permet réellement l’installation d’un plugin DeepSeek Harness ?
Elle lui donne les permissions du compte qui exécute le harness. Un plugin est du code Node chargé dans le même processus. Les points d’extension incluent le backend shell, la couche filesystem, le registre des outils et les événements qui entourent chaque appel d’outil. Rien n’isole un plugin de ces interfaces, sauf si le plugin fournit lui-même sa sandbox. Lisez le code source avant l’installation. Exécutez le harness avec un utilisateur qui ne possède aucune donnée importante pour vous.
Quelle version dois-je installer, et continuera-t-elle de fonctionner ?
Installez une version exacte, par exemple npx @deepseek-ai/dsh@0.1.0-rc.6 web. Il s’agit de la version d’août 2026 épinglée ici. Le 12 novembre 2026, le tag latest de npm pointe vers 0.2.2-rc.1. GitHub répertorie la nouvelle préversion 0.2.2-rc.2, publiée le 11 novembre. La CLI actuelle nécessite Node 24.9 ou une version ultérieure. Le projet se présente comme une developer preview et indique que des changements incompatibles sont attendus. Une commande sans version épinglée peut donc se comporter différemment d’un jour à l’autre. Consultez le dépôt avant toute mise à niveau. Attendez-vous à ce que les clés de configuration et les interfaces des plugins évoluent tant que la version commence par 0.