DeepSeek Harness Installation
Ce chapitre présentetrois méthodes d'installation : installation en un clic avec npm, installation depuis le code source, SDK Python.
Préparation avant l'installation
L'environnement d'exécution de DeepSeek Harness est basé sur Node.js.La méthode d'installation en un clic recommandée officiellement ne nécessite aucune dépendance supplémentaire.
L'installation depuis le code source nécessite également pnpm et Git.
La méthode du SDK Python nécessite Python 3.10 ou supérieur.
Système d'exploitation :Linux, macOS ou WindowsTous sont compatibles
Le SDK Python prend en charge Linux x64 / arm64 et macOS 14+ (arm64).
| Prérequis de l'environnement | Installation en un clic via npm | Installation depuis les sources | SDK Python |
|---|---|---|---|
| Node.js | Requis | Requis | Non requis (environnement d'exécution inclus avec le SDK) |
| Git | Optional | Requis | Requis |
| pnpm | Non requis | Requis | Non requis |
| Python 3.10+ | Non requis | Non requis | Requis |
| Clé API DeepSeek | Les trois méthodes nécessitent (pour configurer le modèle ; prend également en charge les points de terminaison compatibles OpenAI) | ||
Vérifiez d'abord l'environnement local ; Node.js est requis, par exemple v20+ :
node -v
git est requis pour l'installation depuis les sources :
git --version
Méthode d'installation :
| Méthode | Pour qui est-ce destiné | Sortie |
|---|---|---|
| Installation en un clic via npm Recommandé | La plupart des utilisateurs : veulent le moyen le plus rapide de découvrir l'interface Web | Démarrer l'interface Web, par défauthttp://127.0.0.1:3080 |
| Installation depuis les sources Développement | Vous voulez développer des plugins, lire le code source ou contribuer | Dépôt local + artefacts de build complets, disponiblespnpm dshExécuter directement le point d'entrée TypeScript |
| SDK Python Programmatique | Vous voulez appeler l'Agent dans votre propre programme Python | deepseek_harnessPaquet + environnement d'exécution intégré, aucun Node.js système requis |
Méthode 1 : installation en un clic avec npm (recommandée)
Nous pouvons utiliser la commande npm pour installer globalement :
npm install -g @deepseek-ai/dsh
Installer de cette façon rend l'utilisation ultérieure plus pratique, la commandedsh. Une fois l'installation terminée, saisissez la commande suivante pour démarrer :
dsh web

Vous pouvez également utiliser la commande npx pour l'installer et l'essayer rapidement — exécutez-la dans le terminal :
npx @deepseek-ai/dsh web
La commande démarrera l'interface Web, et elle s'initialisera automatiquement au premier lancementwebModèle de configuration, puis affiche l'adresse d'accès——La valeur par défaut esthttp://127.0.0.1:3080。

Vérifiez si cela a réussi :
1. Ouvrez dans votre navigateur l'adresse affichée dans le terminal (par défauthttp://127.0.0.1:3080);
2. L'installation est réussie lorsque vous voyez l'interface Web de DeepSeek Harness ;
3. Remarque : la nouvelle interface Web ne sélectionnera aucun espace de travail tant qu'un espace de travail n'a pas été ajouté——c'est normal, il sera configuré à l'étape suivante.
Astuces :dsh utiliseraCall directorycomme emplacement par défaut du système de fichiers. Il est recommandé de d'abordcdAllez dans le répertoire de votre projet et exécutez :npx @deepseek-ai/dsh web, cela rend la sélection d'un espace de travail plus pratique par la suite.
Méthode 2 : Installation depuis les sources
Adapté au développement de plugins, à la lecture du code source ou aux contributions. Après avoir cloné le dépôt, exécutez dans l'ordre :
git clone https://github.com/deepseek-ai/deepseek-harness.git cd deepseek-harness pnpm install # 安装依赖(需要 pnpm,可用 npm install -g pnpm 安装) pnpm run build # 构建包与前端产物(生产运行需要) pnpm dsh web # 以源码方式启动 Web UI
Autres points d'entrée lors de l'exécution depuis la source :
pnpm dsh --profile headless "run the tests"— exécuter une tâche une fois et afficher la réponse finale ;
pnpm dsh --profile web --dump-config— Afficher l'arborescence de configuration complète du démarrage effectif (utile lors du développement de plugins).
Méthode 3 : installation du SDK Python
Prérequis : Python 3.10+, Git, un point de terminaison d'API compatible DeepSeek et des identifiants, un espace de travail isolé que l'agent peut modifier. Créez un environnement virtuel et installez :
git clone https://github.com/deepseek-ai/deepseek-harness.git cd deepseek-harness python -m venv .venv . .venv/bin/activate python -m pip install deepseek-harness-sdk
Après avoir défini les identifiants, il peut être appelé dans le programme (le SDK est livré avec un runtime intégré,Aucun Node.js fourni par le système n'est requis):
export DEEPSEEK_API_KEY=sk-your-key-here # 如果模型不是默认 DeepSeek 端点,而是 OpenAI 兼容代理,还需要: # export DEEPSEEK_BASE_URL=http://127.0.0.1:8000/v1 # export DSH_MODEL=deepseek-v4-flash
Utilisez-le dans votre propre programme Python :
from deepseek_harness import DeepSeekHarness— intégré au dépôtexamples/jsonrpc-agent/minimal.pyest un wrapper léger pour les appels SDK et peut être référencé directement ; après son exécution, il imprimera la réponse finale de l'assistant, et le répertoire de session recevra des journaux JSONL contenant les requêtes du modèle et les appels d'outils.
Configuration initiale et première tâche
Quelle que soit la méthode utilisée pour démarrer l'interface Web, la première utilisation ne nécessite que trois étapes :
| Étapes | Opération | Description |
|---|---|---|
| 1Configuration du modèle | Paramètres → Modèle | Saisissez la clé API DeepSeek et enregistrez-la. Routage de modèleDisponible immédiatement, aucun redémarrage du serveur requis; prend également en charge d’autres fournisseurs et des points de terminaison personnalisés compatibles OpenAI |
| 2Sélectionner l’espace de travail | Cliquez sur « Select Workspace » | Ajoutez le répertoire du projet dans lequel dsh a été lancé et sélectionnez-le.La zone de saisie de session n’est pas disponible tant qu’un espace de travail n’est pas sélectionné |
| 3Exécuter la tâche | Saisissez des instructions dans la session | Par exempleSummarize this repository and identify its main packages.— l’agent lira/écrira les fichiers de l’espace de travail, exécutera des commandes, déléguera des sous-agents et maintiendra des plans ; les opérations au-delà de la politique d’autorisation demanderont d’abord votre approbation |
firstTaskSuggestionsfromLightweightDirectivestart:« Résumez ce dépôt et identifiez ses principaux paquets. »
Laissez d’abord l’agent se familiariser avec l’espace de travail, puis confiez-lui progressivement de vraies tâches.— Recommandation du guide de démarrage rapide officiel
Référence rapide des commandes courantes
| Commande | Fonction |
|---|---|
npx @deepseek-ai/dsh web |
Démarrer l’interface Web (équivalent à--profile web) |
dsh --profile headless "任务描述" |
Exécuter une tâche une fois, afficher la réponse finale, puis quitter (adapté aux scripts/CI) |
dsh plugin --profile <name> <pnpm 参数> |
Gérer les plugins pour un profil (transmet à pnpm pour exécution dans le répertoire du profil) |
dsh --profile web --dump-config |
Afficher l’arborescence de configuration complète du démarrage réel (sans démarrer le serveur) |
dsh --profile web --dump-default-config |
Afficher l’arborescence de configuration par défaut (sans correctifs utilisateur) |
pip install deepseek-harness-sdk |
Installer le SDK Python (avec runtime intégré) |
À propos du profil :webetheadlessDeux profils seront automatiquement initialisés à partir de modèles intégrés lors de la première utilisation ; les profils restants doivent êtredsh plugincréés. Les arguments de démarrage de dsh viennent en premier, les arguments de l’application viennent après, par exempledsh --profile web --port 8080Moyenne--portIl s’agit d’une application web.
Problèmes courants et dépannage
Problème 1 : Le navigateur ne peut pas ouvrir http://127.0.0.1:3080
Confirmez que le processus dsh est toujours en cours d’exécution dans le terminal et qu’il n’y a pas d’erreurs ; si le port est occupé, vous pouvez utiliserdsh --profile web --port 8080Changez le port ; vérifiez si le pare-feu autorise le port local.
Problème 2 : npx ne trouve pas @deepseek-ai/dsh ou la version est trop ancienne
Assurez-vous d’abord que Node.js est installé et que la version est relativement récente (node -v) ; le projet est en phase d’aperçu développeur et évolue rapidement. Si nécessaire, videz le cache npx et réessayez, ou passez à l’installation depuis le code source.
Problème 3 : pnpm install / build échoue lors de l’installation depuis le code source
Vérifiez que pnpm est installé (npm install -g pnpm) ; lorsque le réseau est restreint, vous pouvez configurer une source miroir pour npm/pnpm ; la compilation exige que la version de Node.js satisfasse la déclaration engines dans le package.json du dépôt.
Problème 4 : la zone de saisie de session est indisponible / l’agent ne peut pas lire ou écrire de fichiers
La cause la plus fréquente estAucun espace de travail n’a été sélectionné— revenez à « Sélectionner l’espace de travail » pour ajouter et sélectionner le répertoire du projet ; vérifiez qu’une clé API valide a été enregistrée dans « Paramètres → Modèles », et le routage du modèle prend effet sans redémarrage.
Problème 5 : l’environnement d’exécution du SDK Python ne trouve pas Node.js
Le SDK est fourni avec un environnement d’exécution intégré et ne nécessite normalement pas Node.js système ; s’il signale un environnement d’exécution manquant, veuillez confirmer que vous avez installé le paquet complet de la même version que le SDK (python -m pip install deepseek-harness-sdk), et utilisez Linux x64 / arm64 ou macOS 14+ (arm64) conformément aux prérequis officiels.