DeepSeek Harness sur Windows : Pas d'application de bureau, pas de problème — La méthode officielle pour l'exécuter

There is no official DeepSeek Harness desktop app for Windows, and you do not need one. DeepSeek Harness (dsh) — the open-source agent runtime DeepSeek released under an MIT license on 2026-08-13 — is a Node.js tool that runs a local web server you open in your browser, with a headless CLI for the terminal as the alternative. On Windows the whole setup is two commands: install Node.js 22.19 or newer (Node 24 LTS is the safer pick), then run npx @deepseek-ai/dsh web and open http://127.0.0.1:3080. Every "DeepSeek Harness Desktop" repository on GitHub is an unofficial community wrapper around that same two-command setup — useful to some people, but not required. It is also the harness DeepSeek uses to produce the agentic coding results it reports for DeepSeek V4 Pro and DeepSeek V4 Flash, which is why the two models keep showing up in any conversation about it.

Si vous avez cherché « deepseek harness windows », vous êtes probablement en train de regarder une page de ces dépôts wrapper en vous demandant lequel installer. Cet article répond à la véritable question derrière cette recherche : ce qu'est réellement DeepSeek Harness, la méthode officielle pour l'exécuter sur Windows aujourd'hui, les alternatives en ligne de commande, et les mises en garde honnêtes concernant l'exécution d'un outil en phase d'aperçu. C'est un tutoriel, pas un article de lancement — le lancement et la piste de la fuite sont traités dans des articles séparés.

Ce que DeepSeek Harness est (et n'est pas)

DeepSeek Harness n'est pas un modèle, et il n'évalue aucun modèle. Il s'agit du runtime d'agent : la couche qui connecte un modèle aux outils, aux fichiers, à un shell et à Internet — lisant votre code, planifiant des modifications, exécutant des commandes et itérant jusqu'à ce que la tâche soit terminée. L'architecture est énoncée dans son slogan : "Tout est un plugin."Les modèles, les outils, les compétences, les sessions, les sandboxes, la boucle d'agent elle-même, et même l'interface web sont des plugins composés au démarrage, construits sur le méta-framework Cordis — le même noyau derrière l'écosystème de chatbot Koishi. Un déploiement par défaut embarque plus de 150 plugins.

Ceci est aussi résolument une version préliminaire. dsh est à la version 0.1.0-rc.6, le README la qualifie d’aperçu pour développeurs, et il avertit en majuscules : « IL Y AURA DES CHANGEMENTS QUI ROMPRONT LA COMPATIBILITÉ. » Rien de tout cela n’a ralenti son adoption : le projet a atteint environ 50 000 étoiles GitHub dans les premières 12 heures suivant sa publication publique le 13 août 2026, et se situait à environ 126 000 au 16 août 2026 — la sortie open-source la plus rapide jamais réalisée par DeepSeek.

La réponse courte : le chemin officiel de Windows comporte deux commandes.

Le README officiel de DeepSeek donne en une ligne la procédure d'exécution sous Windows : installez Node.js, puis exécutez npx @deepseek-ai/dsh web. Concrètement, les étapes sont :

• Installez Node.js 22.19+ ou Node 24.La version actuelle de dsh nécessite Node 22.19 ou plus récent ; Node 24 LTS est le choix le plus sûr sous Windows, et la raison est prosaïque — les versions plus récentes de Node incluent la décompression zstd native, que dsh utilise pour lire ses journaux de session compressés. Vérifiez votre installation avec node --version dans PowerShell ou cmd.

• Run the harness. Either run it on the spot with npx @deepseek-ai/dsh web, or install it once with npm install -g @deepseek-ai/dsh and then run dsh web from any folder afterwards. The first run prints the URL and starts the Web UI at http://127.0.0.1:3080.

• Ouvrez cette adresse dans votre navigateur. L'interface Web est une application web locale — c'est pourquoi il n'y a pas d'application de bureau ; le navigateur est l'application de bureau.

• Ajoutez une clé de modèle une fois. Dans l’interface Web, ouvrez Paramètres → Modèles, collez une clé API DeepSeek et enregistrez. L’effet est immédiat, sans redémarrage du serveur. dsh utilise le dossier dans lequel vous l’avez lancé comme emplacement de système de fichiers par défaut, et l’étape Choisir un espace de travail de l’interface vous permet de le pointer vers n’importe quel répertoire de projet.

Voilà tout le chemin officiel. Si une machine a déjà Node 22+ installé, le temps entre « rien » et « agent en cours d'exécution » est de moins d'une minute.

Pourquoi chaque dépôt "DeepSeek Harness Desktop" est un wrapper

Les résultats de la page 1 pour cette requête sont tous des wrappers de bureau communautaires — des coquilles Electron, Tauri et WebView2 qui regroupent un runtime Node et lancent l’interface Web officielle dans une fenêtre encadrée. Ce ne sont pas des produits DeepSeek, et ils n’ajoutent pas de capacité de harnais ; ils ajoutent un lanceur. Ce qu’ils ont en commun :

• Ils se lancent par double-clic et évitent totalement la ligne de commande, ce qui est leur véritable argument de vente.

• Ils ne sont pas signés, donc Windows SmartScreen affichera un avertissement à l'installation — « Plus d'informations → Exécuter quand même » fait partie du processus.

• Ils suivent le projet officiel à des rythmes différents : certains épinglent 0.1.0-rc.5, d'autres 0.1.0-rc.6, d'autres suivent master, si bien que la version du wrapper et celle du harness divergent au fil du temps.

• Ils stockent les mêmes données locales que dsh utilise toujours sous ~/.dsh, donc basculer entre un wrapper et la CLI officielle ne réinitialise pas vos sessions.

Quand une surcouche vaut-elle le coup ? Quand « double-cliquer sur une icône, voir une icône dans la zone de notification, ne jamais toucher un terminal » est le facteur décisif, et que vous acceptez qu’un tiers soit désormais la couche de mise à jour et de sécurité devant un outil en phase de préversion. Quand ne l’est-elle pas ? Le chemin officiel est deux commandes et un onglet de navigateur — si vous avez déjà Node, une surcouche vous procure un lanceur dont vous n’avez peut-être pas besoin, et ajoute en échange sa propre surface de maintenance.

La voie du terminal : plugins CLI headless et TUI

Si vous ne travaillez pas dans le navigateur, dsh dispose également d'une version terminal, divisée en deux modes.

Headless est le profil non interactif : dsh --profile headless "summarize this repository" exécute une tâche sans interface, affiche le résultat, puis se termine — le mode adapté aux CI. Sous Windows, c'est également le mode que les scripts et les tâches planifiées devraient utiliser, car il ne nécessite ni affichage ni session ouverte.

TUI est une interface interactive en terminal de type Claude Code, distribuée sous forme de bundles de plugins communautaires plutôt que dans le paquet de base. Les paquets comme dsh-tui s'installent dans un profil avec dsh plugin --profile tui add <package> et se lancent avec dsh --profile tui ; au moins l'un d'eux fournit un lanceur Windows .cmd. Le point à savoir avant d'essayer : une TUI nécessite un véritable terminal pour l'entrée et la sortie — si votre configuration utilise des pipes ou des redirections, dsh refusera et vous dira d'utiliser le mode headless à la place.

Les quatre préréglages : lequel pour quelle tâche

dsh est livré avec quatre préréglages d’agent intégrés, et ils ne constituent pas une échelle de difficulté — ce sont quatre surfaces d’outils différentes. Vous définissez la valeur par défaut dans ~/.dsh/settings.yaml sous agent-presets.default.

• Standard est le mode par défaut : l’agent complet du quotidien — édition de fichiers, shell, recherche de fichiers et sur le web, compétences, sous-agents, planification. C’est par là que la plupart des utilisateurs Windows devraient commencer.

• PTC (également appelé mode Code) conserve tout ce que Standard possède mais change la manière dont les outils sont exposés : au lieu d’une longue séquence d’appels d’outils isolés, le modèle écrit un programme TypeScript qui compose des opérations en plusieurs étapes — boucles, filtres, branches conditionnelles. Pour les workflows complexes, répétés ou en plusieurs étapes.

• Minimal réduit délibérément l'agent à deux outils — un shell persistant et un éditeur de fichiers — et est destiné à l'évaluation et au benchmarking, pas au travail quotidien. C'est le préréglage sur lequel sont exécutés les scores agentiques de DeepSeek lui-même.

• Creation (Cordis) permet de créer des préréglages personnalisés : il inclut l'inspection à l'exécution, l'expérimentation de plugins en mémoire et des conseils pour la conception de préréglages. Pour bricoler avec le harnais lui-même.

MCP et rejeu de trajectoire : pourquoi cela vaut la peine de les exécuter

Deux fonctionnalités justifient l'utilisation de dsh plutôt qu'un simple client de chat. Premièrement, un client Model Context Protocol (MCP) est intégré — une commande /mcp et un onglet MCP dans les paramètres connectent des serveurs MCP externes au harnais, de sorte que les mêmes outils que vos autres agents utilisent se branchent sur dsh. Deuxièmement, chaque exécution est écrite dans un journal de session en ajout seul, et la vue Trajectory vous permet d'inspecter une exécution par source, de la reprendre, de la forker, de la rechercher et de la rejouer. C'est la différence entre déboguer un agent en ne regardant que sa réponse finale et parcourir pas à pas pourquoi il a effectué chaque appel.

Lorsque le chemin officiel est la mauvaise réponse.

• Il vous faut un clic, pas de terminal. Il n'y a pas d'installateur officiel. Si le double-clic est non négociable, vous utilisez des wrappers de la communauté — qui ne sont pas signés, alors mettez en balance la commodité et la surface de maintenance de tiers.

• Votre machine Windows est ancienne ou verrouillée. dsh nécessite Node 22.19+ (ou Node 24). Sur une machine gérée, cela signifie l'installation d'un runtime et éventuellement une approbation que vous n'avez pas.

• C'est un aperçu, et ça casse. 0.1.0-rc.6 est livré avec un avertissement indiquant que des changements non rétrocompatibles sont à venir ; entre les versions rc, les plugins et les profils peuvent cesser de fonctionner. Épinglez votre version pour tout ce qui est scripté.

• La facture du modèle est à votre charge. dsh est gratuit ; chaque tâche consomme des tokens selon la clé que vous avez configurée. Une boucle d'agent relit les fichiers et réessaie, et un modèle verbeux sur une tâche difficile peut dépenser un budget surprenant en un après-midi. C'est là que le choix du modèle, et non celui du harnais, domine le coût.

• Un abonnement forfaitaire peut battre le routage par jeton. Si vous restez dans le forfait d'un laboratoire sous ses plafonds, l'abonnement forfaitaire est souvent moins cher que tout chemin par jeton. Le routage gagne lorsque vous mélangez des modèles ou que vous voulez un basculement — pas par défaut.

Router le modèle derrière le harnais

Le chemin natif est l'API propre de DeepSeek : collez une clé dans Paramètres → Modèles et c'est parti. Mais dsh accepte aussi une URL de base compatible OpenAI — définissez DEEPSEEK_BASE_URL dans l'environnement ou configurez le fournisseur LLM dans settings.yaml — ce qui signifie que le modèle derrière le harnais est interchangeable sans toucher au harnais. Vous pouvez faire tourner DeepSeek V4 Pro pour la refactorisation difficile et DeepSeek V4 Flash pour les modifications mécaniques peu coûteuses, sur la même installation locale de dsh.

C'est la couche qu'occupe OrcaRouter. Une URL de base compatible OpenAI, plus de 200 modèles, zéro marge — le prix catalogue du fournisseur est répercuté tel quel — et un basculement automatique lorsqu'un fournisseur limite le débit ou se dégrade. Pointez dsh dessus et le harnais reste sur votre machine, tandis que le catalogue de modèles devient une décision de routage plutôt qu'un achat. Deux mises en garde honnêtes : nous n'hébergeons pas dsh — il s'exécute localement sur votre machine Windows — et nous ne sommes que la couche d'accès aux modèles si vous voulez des modèles au-delà de l'API de DeepSeek. Et pour un seul modèle lourd dans les limites de son forfait, l'abonnement forfaitaire est souvent le choix le plus économique, quel que soit le routeur.

La version courte

DeepSeek Harness sur Windows est une configuration en deux commandes, pas une installation via une boutique d’applications : Node 22.19+ (ou Node 24), puis npx @deepseek-ai/dsh web, puis votre navigateur à l’adresse http://127.0.0.1:3080. Les dépôts GitHub « desktop » sont des wrappers non officiels autour de ce même serveur local. Pour les terminaux, le mode headless exécute des tâches ponctuelles pour l’IC, et les plugins TUI offrent une interface de style Claude Code. Quatre préréglages — Standard, PTC, Minimal, Creation — choisissent la surface d’outils, et MCP plus le rejeu de trajectoire le rendent véritablement utile. C’est gratuit, open source, et au stade d’aperçu : verrouillez la version, surveillez la facture du modèle, et acheminez le modèle séparément du harnais.