Tutoriel sur DeepSeek Harness

DeepSeek HarnessDéveloppé par DeepSeek AI et officiellement open source en août 2026Agent Harness (framework d'agent), sous licence MIT, écrit en TypeScript.

DeepSeek Harness adopteTout est un pluginArchitecture ouverte : toutes les capacités de l'Agent telles que les modèles, les outils, les compétences, les sessions, le sandbox, le stockage, les boucles, l'ordonnancement et l'UI sont composées de plugins, et peuvent être librement remplacées et recombinées avec souplesse—Personnalisez votre propre Agent au niveau de la configuration sans modifier le code source。

Philosophie officielle de DeepSeek AI :Agent = Modèle + HarnessSlogan officiel :Tout est un plugin. (Tout est un plugin)


Qui devrait lire ce tutoriel ?

Ce tutoriel est destiné aux types de lecteurs suivants :

  • Développeurs / IngénieursPour ceux qui veulent un assistant de codage IA local dont les limites de capacités sont entièrement contrôlables et dont chaque composant peut être remplacé ou recombiné—plutôt qu'une boîte noire verrouillée par le fournisseur dans des fonctionnalités fixes.

  • Praticiens de l'IA/MLPour ceux qui s'intéressent à l'architecture des Agents—le système de plugins Cordis sous-jacent la pilote, la conception événementielle est étayée par des articles académiques, et le pattern PTC permet aux modèles de composer des appels d'outils multi-étapes avec des programmes TypeScript.

  • Passionnés d'outils d'efficacité: Pour ceux qui souhaitent intégrer l'Agent dans leur propre workflow à l'aide d'une interface graphique Web UI, d'une ligne de commande headless, ou d'un SDK Python.

  • Chercheurs: Besoin d'agents observables—chaque exécution écrit dans des journaux de session en ajout seul, avec les prompts système, la chaîne de raisonnement, les appels d'outils et l'ordonnancement des sous-agents consultables dans la vue Trajectory.

  • Utilisateurs attachés à l'open source et à la contrôlabilitéLicence open source MIT, composition libre au niveau de la configuration, aucune télémétrie, aucun verrouillage cloud, entièrement auto-contrôlé.


Compétences prérequises avant la lecture

Ce tutorielNon requisUne expérience en recherche en IA ou des connaissances approfondies en apprentissage automatique. Vous devez avoir :

Compétences Niveau d'exigence Description
Bases de la ligne de commande Requis Capacité à exécuter des commandes dans un terminal et à définir des variables d’environnement
Bases de Node.js Requis Installer et démarrer dsh via npx / pnpm.
Concepts de base des API Une familiarité suffit Savoir ce qu'est une clé API et comment demander une clé API DeepSeek
Concepts de plugin / fichier de configuration Une familiarité suffit Utilisé dans les chapitres avancés (développement de plugins, composition de la couche de configuration)
Bases de Git Optional Utilisé lors de l'installation depuis les sources ou pour contribuer

Configuration requise pour le système d'exploitation: Linux, macOS ou Windows (peut être exécuté après l'installation de Node.js).


Fonctionnalités principales

Fonctionnalités de DeepSeek Harness :

  • 🧩 Tout est un plugin— Le noyau Cordis ne gère que le chargement, le déchargement et la gestion des dépendances des plugins ; toutes les capacités telles que les modèles, les outils, les compétences, les sessions, le bac à sable, le stockage, les boucles, l’ordonnancement et l’interface utilisateur sont fournies par des plugins, qui collaborent via des services et des événements, avec une composition libre au niveau de la configuration

  • 📜 Exécution traçable— Tout ce que le modèle voit (invites système, chaîne de pensée, appels d’outils et résultats, ordonnancement des sous-agents, injection de contexte) est écrit dans des journaux de session en ajout uniquement ; la vue Trajectory affiche par source, avec reprise, fork, récupération et rejeu partageant le même flux d’événements

  • 🛠️ Quatre modes de fonctionnement— Mode standard (Agent de codage complet), mode PTC (le modèle combine plusieurs tours d’appels d’outils à l’aide d’un programme TypeScript), mode Minimal (deux outils, pour l’évaluation comparative de modèles), mode Créatif (vérifications à l’exécution + expérimentation de plugins + création de préréglages personnalisés)

  • 🌐 Utilisation multi-forme— Interface Web (par défaut http://127.0.0.1:3080), headless (exécution unique, affichage de la réponse finale et sortie), CLI, SDK Python, SDK TypeScript

  • 🔌 Outils et extensions riches— Édition de fichiers, Shell, recherche de fichiers et sur le Web, Skills, planification, objectifs, sous-agents, workflows ; points d’extension pilotés par les événements (événements à trois niveaux session/Agent/capacité), toute capacité peut être remplacée par des correctifs

  • 🔒 Ouvert et contrôlable— Open source MIT ; configuration en couches Profile + composition package,dsh --profile web --dump-configAfficher l’arbre de configuration complet du démarrage réel ; noyau non privilégié, tous les enregistrements sont réversibles

  • 🤖 Indépendant du modèle— Renseignez la clé API DeepSeek et c'est prêt à l'emploi ; prend en charge d'autres fournisseurs et des points de terminaison personnalisés compatibles OpenAI ; routage de modèles sans redémarrage

  • 🔬 Prêt pour la recherche— Flux d’événements et arbre de configuration entièrement observables, conception ouverte pour la recherche sur l’architecture d’Agent (le Cordis sous-jacent s’appuie sur des articles académiques)


Ressources associées

Ressources officielles

Ressources Liens
Site officiel deepseek.com/harness
Dépôt GitHub github.com/deepseek-ai/deepseek-harness
Documentation officielle · Démarrage rapide deepseek-harness.github.io/deepseek-harness/guide/quickstart
paquet npm @deepseek-ai/dsh(npx @deepseek-ai/dsh webdémarrage en un clic)
Communauté de plugins Sujets GitHub : dsh-plugin
Support communautaire Discussions GitHub
autres extensions