DeepSeek Harness pour le design.
Un modèle peut écrire du JSX, mais un agent de design utile exige davantage que la seule sortie du modèle. Il lui faut des règles de marque, des références, des outils, des autorisations et une boucle capable de rendre puis de contrôler le résultat. DeepSeek Harness expose ces éléments environnants au lieu de les masquer.
Pour les interfaces, rendez explicites le brief et la boucle de validation. La route DeepSeek par défaut n’accepte que le texte ; le point de départ le plus fiable est donc un workflow fondé sur le code et les spécifications. Ne joignez des captures d’écran qu’après avoir sélectionné une route de modèle qui déclare prendre en charge les images.
Cette flexibilité est utile pour le design, car la qualité de l’UI générée dépend de l’environnement qui entoure le modèle : des règles de projet persistantes, des skills réutilisables, le bon fournisseur pour les entrées texte ou image, des outils de gestion de fichiers et de shell, ainsi qu’une boucle de vérification. Ce guide présente la configuration minimale opérationnelle, les limites importantes pour les tâches d’UI et la frontière réelle avec Open Design : dsh ne dispose pas encore d’un adaptateur Open Design officiel, tandis que l’adaptateur DeepSeek TUI existant correspond à une autre CLI.
Configurer DeepSeek Harness à partir de zéro
La préversion publique nécessite Node.js `^22.19.0` ou `>=24.0.0`. La commande npm initialise le profil web à la première utilisation : vous pouvez donc accéder à une UI locale opérationnelle sans cloner le dépôt.
# 1. Start the official DeepSeek Harness Web UI
# Requires Node.js ^22.19.0 or >=24.0.0
npx @deepseek-ai/dsh web
# 2. Open the local UI (default)
# http://127.0.0.1:3080
# 3. In Settings → Models, add a DeepSeek API key
# or configure another supported provider.
# 4. Choose the project directory as your workspace.
# Optional: run one headless job after the profile is initialized
npx @deepseek-ai/dsh --profile headless "Audit this UI against AGENTS.md"
- Les identifiants restent référencés: La Web UI stocke les secrets des fournisseurs dans `$DSH_HOME/.credentials.yaml` ; les paramètres ne conservent qu’une référence vers les identifiants, et l’UI reçoit un descripteur masqué plutôt que la clé elle-même.
- Traitez la préversion comme une infrastructure dont la version est verrouillée: Les mainteneurs avertissent explicitement que des changements incompatibles auront lieu. Verrouillez la version utilisée par l’équipe et examinez les changements de chaque nouvelle version avant toute mise à jour.
Pourquoi un cadre centré sur les plugins convient au design
Un modèle peut écrire du JSX, mais un agent de design utile exige davantage que la seule sortie du modèle. Il lui faut des règles de marque, des références, des outils, des autorisations et une boucle capable de rendre puis de contrôler le résultat. DeepSeek Harness expose ces éléments environnants au lieu de les masquer.
- Contexte de design persistant: Le chargeur d’instructions par défaut lit `AGENTS.md` et `CLAUDE.md` dans la hiérarchie du projet. Placez-y les tokens, les règles de composants, les points de rupture responsive et les critères de revue afin qu’ils soient accessibles à chaque exécution.
- Skills réutilisables: Les skills locaux peuvent être placés dans `.dsh/skills` ou `.agents/skills`. Un skill frontend peut regrouper le brief, la checklist, les exemples et les scripts précis qui évitent de repartir de zéro à chaque tâche d’UI.
- Choix du fournisseur selon la tâche: La Web UI permet de configurer DeepSeek, des fournisseurs du catalogue tels qu’Anthropic ou OpenAI, ainsi que des endpoints personnalisés compatibles avec OpenAI. Pour fournir une capture d’écran en entrée, utilisez une route déclarée comme compatible avec les images ; pour le texte, le code, le DOM et les tâches guidées par des spécifications, utilisez la route DeepSeek native.
La limite essentielle est la même pour tous les agents : la composabilité ne remplace pas le goût. Sans contraintes réfléchies sur la typographie, l’espacement, les composants et les interactions, l’environnement automatisera fidèlement un résultat générique. Le rôle d’Open Design est de fournir et d’organiser ces éléments de design.
Un workflow pratique avec DeepSeek Harness pour l’UI et le frontend
Pour les interfaces, rendez explicites le brief et la boucle de validation. La route DeepSeek par défaut n’accepte que le texte ; le point de départ le plus fiable est donc un workflow fondé sur le code et les spécifications. Ne joignez des captures d’écran qu’après avoir sélectionné une route de modèle qui déclare prendre en charge les images.
- Démarrez dsh depuis le dépôt, choisissez ce répertoire comme espace de travail et sélectionnez la route de modèle adaptée à la tâche.
- Définissez les règles de marque dans `AGENTS.md`, `CLAUDE.md` ou un fichier `DESIGN.md` référencé : tokens, primitives, espacements, typographie, points de rupture, états et motifs interdits.
- Chargez un skill frontend ciblé depuis `.dsh/skills` ou `.agents/skills` ; conservez les exemples et scripts de validation avec les instructions.
- Demandez à l’agent de réutiliser les composants existants, d’exécuter l’application et de valider les états responsive avec les tests ou les outils de navigateur propres au projet.
- Examinez le résultat visible, consignez les écarts précis et procédez par petits commits. Annulez les itérations insuffisantes au lieu d’empiler les corrections sur une base défaillante.
Un bon prompt précise à la fois les contraintes visuelles et les éléments de preuve attendus lors de la vérification :
Implement the account dashboard in React + TypeScript.
Reuse the components and tokens named in AGENTS.md and DESIGN.md.
Use a 240px sidebar, a 12-column content grid, and the documented
mobile navigation pattern. Include loading, empty, error, and focus states.
Run the app and existing UI checks, inspect desktop and mobile breakpoints,
and report the exact files and states you verified.Si une capture d’écran est indispensable, configurez d’abord un fournisseur compatible avec les images. DeepSeek Harness refuse l’image avant l’envoi lorsque la route sélectionnée ne déclare pas cette prise en charge — une protection utile qui évite d’ignorer silencieusement la référence.
Plugins, skills et contexte du projet
C’est sous l’interface de chat que DeepSeek Harness se distingue le plus. Son arborescence de plugins permet aux équipes d’intégrer le workflow de design à l’environnement d’exécution, au lieu de coller un prompt dans chaque session.
- AGENTS.md et CLAUDE.md: Le plugin d’instructions charge le fichier global de l’utilisateur et la hiérarchie du projet, puis détecte les fichiers d’instructions imbriqués pertinents après les opérations de fichiers natives. Utilisez-le pour les règles de design durables, pas pour les demandes ponctuelles.
- Skills du système de fichiers: Le registre de skills découvre les racines du projet et de l’utilisateur, classe les doublons et expose au modèle un outil `skill`. C’est l’emplacement naturel pour les pratiques frontend, l’accessibilité, le contrôle qualité responsive et les procédures du système de design.
- Profils et bundles: Un profil superpose des bundles de plugins ordonnés et les modifications de l’utilisateur. Les équipes peuvent maintenir une composition orientée design qui réunit le fournisseur, les outils, les règles d’autorisation et les sources de skills dont elles ont réellement besoin.
- MCP et fonctionnalités externes: L’arborescence des sources inclut des fonctionnalités de client MCP, mais leur configuration reste destinée aux développeurs. Pendant la préversion, traitez les intégrations comme des plugins versionnés, et non comme un workflow stable activable par une simple case à cocher.
Avant de construire un workflow interne pérenne, inspectez l’arborescence effective avec `dsh --profile web --dump-config`. Le résultat indique ce qui est réellement monté et modifiable ; il est plus fiable que de supposer que chaque package du dépôt est actif dans le profil fourni.
Pièges de la préversion développeur et du design
Les erreurs les plus courantes consistent à traiter une préversion comme un produit stable, une route texte comme un modèle de vision ou un cadre flexible comme une source de goût visuel.
- Verrouillez la version avant de personnaliser: Les changements incompatibles font explicitement partie de la politique de préversion. Verrouillez la version npm et limitez l’ampleur des modifications de profil pour pouvoir les examiner facilement après une mise à niveau.
- Vérifiez les modalités du modèle sélectionné: La route native de complétion de chat de DeepSeek n’accepte que le texte. Pour convertir une capture d’écran en code, sélectionnez et déclarez une route de fournisseur compatible avec les images au lieu de présumer que la pièce jointe sera comprise.
- Fournissez le goût esthétique sous forme de données: Donnez à l’agent les tokens, les composants de référence, les états de référence et les motifs interdits. Un environnement modulaire sans règles de design produit malgré tout une UI générique.
- Vérifiez ce que le profil monte réellement: Les packages du dépôt représentent des fonctionnalités disponibles, mais ne prouvent pas que le profil par défaut les active. Inspectez la configuration composée avant de documenter une intégration ou d’en dépendre.
Chaque mesure corrective relève du contexte et de la vérification. C’est précisément ce qu’une couche de design doit rendre reproductible, au lieu de laisser chaque projet le redécouvrir.
Ce qu’est réellement DeepSeek Harness
DeepSeek Harness (`dsh`) est un cadre d’exécution d’agents sous licence MIT développé par DeepSeek AI. La préversion développeur publique comprend une Web UI locale et un exécuteur headless. Ce n’est ni un modèle ni une simple interface de terminal : c’est l’environnement d’exécution qui assemble un modèle, des outils, du contexte, des autorisations, des sessions et une interface utilisateur pour former un agent.
Son principe fondateur est que « tout est un plugin ». Cordis assemble une arborescence dans laquelle l’adaptateur de modèle, le registre d’outils, la boucle d’agent, le système de fichiers, le shell, la sandbox, les skills, les sous-agents, la persistance et l’UI peuvent être montés, remplacés ou modifiés au moyen de profils et de bundles. Les profils `web` et `headless` fournis sont des points de départ, pas des produits figés.
- Web UI locale: `npx @deepseek-ai/dsh web` démarre par défaut un espace de travail dans le navigateur à l’adresse `127.0.0.1:3080`. Ajoutez un modèle, choisissez un espace de travail et lancez des tâches depuis l’interface de conversation.
- Mode headless: Le profil `headless` lance une nouvelle session persistante, affiche la réponse finale, puis se termine — pratique pour les audits scriptés, les builds et les contrôles de design reproductibles.
- Environnement composable: Les profils superposent des bundles de plugins et vos propres modifications. Une équipe peut ainsi changer de fournisseur, d’outils, de règles et de comportement d’UI sans créer un fork de la boucle d’agent.
- Développeur : DeepSeek AI (projet officiel)
- Statut : préversion développeur ; des changements incompatibles sont à prévoir
- Licence : MIT
- Commande principale : `npx @deepseek-ai/dsh web`
DeepSeek Harness face à DeepSeek TUI et aux autres agents de design
Ces noms sont faciles à confondre. DeepSeek Harness et DeepSeek TUI, actuellement référencé dans Open Design, sont des projets distincts, avec des exécutables et des niveaux d’intégration différents.
| Outil | Description | Meilleur usage pour le design |
|---|---|---|
| DeepSeek Harness (`dsh`) | Cadre officiel de DeepSeek AI centré sur les plugins, avec une Web UI locale et des profils headless ; préversion développeur | Les équipes qui veulent composer l’environnement d’exécution, les skills, les fournisseurs, les règles et l’UI autour d’un workflow de design |
| DeepSeek TUI (`deepseek` / `codewhale`) | Un agent de programmation en terminal distinct, et l’adaptateur DeepSeek actuellement pris en charge par Open Design | Utiliser DeepSeek depuis Open Design dès aujourd’hui |
| OpenCode | Agent de terminal open source éprouvé et indépendant des fournisseurs | Changer de modèle dans un workflow TUI stable avec AGENTS.md et MCP |
| Claude Code | Agent de programmation éprouvé pour le terminal, les IDE, les applications de bureau et le Web | Raisonnement frontend, références riches en images et intégrations de design bien établies |
| Open Design | Espace de travail et bibliothèque de design pensés pour les agents, construits autour d’agents de programmation pris en charge | Systèmes de design soigneusement sélectionnés, skills, artefacts visuels et workflow local indépendant d’un fournisseur de modèles particulier |
Choisissez dsh si c’est le cadre d’exécution lui-même que vous souhaitez étendre. Choisissez DeepSeek TUI dans Open Design si vous recherchez l’adaptateur DeepSeek actuellement pris en charge et une couche de design prête à l’emploi. Ils pourront converger grâce à un futur adaptateur, mais ils ne sont pas interchangeables aujourd’hui.
Utiliser DeepSeek Harness avec un espace de travail de design pensé pour les agents
Open Design et DeepSeek Harness occupent des couches adjacentes. dsh compose un environnement d’exécution d’agents ; Open Design sélectionne les systèmes de design, les skills et le workflow local d’artefacts qui rendent un agent utile pour le travail visuel. Open Design ne fournit pas encore d’adaptateur `dsh` dédié : le workflow exact consiste donc aujourd’hui à les utiliser côte à côte.
- Installez Open Design et utilisez ses systèmes de design et ses skills pour définir les règles visuelles du projet.
- Conservez le fichier `DESIGN.md`, les références et les instructions de projet obtenus dans le même dépôt que celui ouvert par DeepSeek Harness comme espace de travail.
- Exécutez dsh pour les expérimentations centrées sur les plugins et les tâches de programmation ; réutilisez les mêmes tokens, règles, ressources et critères de validation au lieu de maintenir un second brief de design.
- Lorsque vous devez utiliser DeepSeek directement dans Open Design aujourd’hui, sélectionnez l’adaptateur DeepSeek TUI existant. Considérez un futur adaptateur dsh comme une intégration distincte, pas comme une fonctionnalité actuelle.
Vous obtenez ainsi une base de code unique sous votre contrôle et un ensemble de règles de design portable entre deux outils privilégiant le local. Open Design reste indépendant de DeepSeek AI ; DeepSeek et DeepSeek Harness sont des marques de leurs propriétaires respectifs.
FAQ sur DeepSeek Harness
-
01 Qu’est-ce que DeepSeek Harness ?
DeepSeek Harness (`dsh`) est le cadre d’exécution d’agents open source officiel de DeepSeek AI. Il réunit modèles, outils, contexte, sessions, règles, orchestration et UI au moyen d’une arborescence de plugins Cordis. La version publique est actuellement une préversion développeur sous licence MIT.
-
02 Comment installer et exécuter DeepSeek Harness ?
Installez une version de Node.js prise en charge, puis exécutez `npx @deepseek-ai/dsh web`. La Web UI locale démarre par défaut à l’adresse `http://127.0.0.1:3080`. Ajoutez un modèle dans Settings → Models, choisissez un espace de travail et démarrez une session.
-
03 DeepSeek Harness est-il un projet officiel de DeepSeek ?
Oui. Le dépôt est publié sous l’organisation GitHub `deepseek-ai` et présente dsh comme un cadre d’exécution d’agents développé par DeepSeek AI. Il est sous licence MIT et explicitement désigné comme préversion développeur.
-
04 DeepSeek Harness peut-il créer une UI à partir de captures d’écran ?
Uniquement lorsque la route de fournisseur sélectionnée déclare accepter des images en entrée. Dans dsh, la propre route de complétion de chat de DeepSeek n’accepte que le texte, et le cadre rejette les images jointes avant leur envoi sur une telle route. Pour les captures d’écran, utilisez un fournisseur compatible avec les images ou décrivez la cible à l’aide du code, du DOM, des tokens et de spécifications écrites.
-
05 DeepSeek Harness prend-il en charge AGENTS.md et les skills ?
Oui. Son plugin d’instructions charge les fichiers de projet compatibles avec AGENTS.md et CLAUDE.md. Son fournisseur de skills par système de fichiers découvre les skills du projet dans `.dsh/skills` et `.agents/skills`, ainsi que les racines utilisateur et intégrées configurées.
-
06 Quelle est la différence entre DeepSeek Harness et DeepSeek TUI ?
Il s’agit d’outils distincts. DeepSeek Harness utilise l’exécutable `dsh` et constitue la Web UI et l’environnement headless officiels de DeepSeek AI, centrés sur les plugins. DeepSeek TUI utilise le lanceur `deepseek` ou `codewhale` et correspond à l’adaptateur DeepSeek distinct actuellement pris en charge par Open Design.
-
07 Open Design prend-il en charge DeepSeek Harness ?
Pas encore sous la forme d’un adaptateur officiel dédié. Open Design prend actuellement en charge l’adaptateur DeepSeek TUI distinct. Vous pouvez néanmoins utiliser les systèmes de design, les skills, les fichiers DESIGN.md et les artefacts d’Open Design aux côtés de dsh dans le même dépôt local.
-
08 Où DeepSeek Harness stocke-t-il ma clé d’API ?
Le guide officiel des modèles indique que les clés des fournisseurs sont stockées dans `$DSH_HOME/.credentials.yaml`. Les paramètres ne conservent qu’une référence vers les identifiants, et la Web UI reçoit un descripteur masqué plutôt que le secret lui-même.
Construisez la couche de design autour de votre workflow DeepSeek.
Utilisez dès aujourd’hui les systèmes de design locaux, les skills et le workflow d’artefacts d’Open Design, tout en conservant les mêmes règles de projet pour le prochain environnement d’exécution d’agents que vous choisirez.