DeepSeek Harness

DeepSeek Harness (commande dsh) est le framework d’agent de programmation open source de DeepSeek. Il comprend des espaces de travail, un terminal, l’édition de fichiers, les Skills, la planification et une Web UI. Son interface compatible OpenAI Chat Completions permet de le connecter à AIHubMix.

Ce guide est basé sur DeepSeek Harness 0.2.0-rc.2, la version la plus récente au 18 octobre 2026. Cette version diffère fortement de 0.1.0-rc.6 : l’emplacement de la configuration et l’interface ont été mis à jour. Harness est encore en aperçu développeur, les champs ou l’interface peuvent donc évoluer dans les prochaines versions.

Résumé

L’intégration utilise quatre valeurs :

Paramètre	Valeur
Provider ID	`aihubmix`
Base URL	`https://aihubmix.com/v1`
API protocol	`openai-completions`
API key environment variable	`AIHUBMIX_API_KEY`

AIHubMix configuré dans la page Models de DeepSeek Harness

Quels sont les prérequis ?

Une clé API AIHubMix active
Node.js 22 (22.19.0 ou une version ultérieure) ou Node.js 24 ou une version ultérieure
Un accès réseau au registre npm et à https://aihubmix.com

node --version
npm --version

Comment installer DeepSeek Harness ?

Installez la version npm publiée, sans cloner le dépôt source :

npm install -g @deepseek-ai/dsh
dsh --version

Si le terminal affiche dsh: command not found, exécutez npm config get prefix et vérifiez que le dossier bin correspondant figure dans PATH.

Comment démarrer la Web UI ?

Exécutez la commande depuis le dossier à utiliser comme espace de travail. La méthode officiellement recommandée est npx :

npx @deepseek-ai/dsh web --port 3080

Si Harness est déjà installé globalement, vous pouvez aussi exécuter :

dsh web --port 3080

Ouvrez http://127.0.0.1:3080, puis sélectionnez ou ajoutez un espace de travail lors de la première utilisation.

Comment configurer le fournisseur AIHubMix ?

Ouvrez Settings → Models → Add model provider, passez la carte sur Custom model API, puis saisissez les valeurs suivantes :

Formulaire de fournisseur personnalisé dans DeepSeek Harness

Champ	Valeur recommandée	Remarques
Provider ID	`aihubmix`	Identifiant en minuscules, ou `aihubmix-gateway` s’il est déjà utilisé
Display name	`AIHubMix`	Nom affiché dans le sélecteur de modèles
Base URL	`https://aihubmix.com/v1`	Doit inclure `/v1`
API protocol	`openai-completions`	Protocole compatible OpenAI Chat Completions
API key	Votre clé API AIHubMix	Harness l’enregistre comme identifiant et ne réaffiche pas sa valeur

Le point de terminaison final est https://aihubmix.com/v1/chat/completions.

Ne saisissez pas le chemin complet /chat/completions dans Base URL.

Ajouter auto ou un autre modèle

Après avoir saisi la Base URL et la clé API, ouvrez Model catalog et sélectionnez Fetch available models. Harness appelle GET https://aihubmix.com/v1/models et affiche les identifiants de modèles disponibles.

Modèles AIHubMix disponibles dans DeepSeek Harness

Pour le premier test, vous pouvez ajouter uniquement auto avec le nom Auto. Pour utiliser un modèle précis, cochez-le dans la liste récupérée, puis sélectionnez Add selected. Le sélecteur graphique n’affiche que les modèles enregistrés dans le catalogue du Provider actuel.

Comparaison entre auto et un modèle précis

Choix	Cas d’utilisation
`auto`	Premier test de connexion ou sélection automatique par AIHubMix
ID de modèle précis	Capacité, version ou résultat reproductible avec un modèle fixe

Les deux choix utilisent le même Provider, la même Base URL et la même clé API. Changer de modèle ne demande pas de recréer le fournisseur.

Stocker la clé API dans une variable d’environnement

Sur les machines de développement et en CI, Harness peut lire la clé depuis une variable d’environnement via un fichier de profil. La Web UI utilise le profil web, et les tests headless utilisent le profil headless. Les chemins des fichiers sont :

$DSH_HOME/profiles/web/cordis.patch.yml
$DSH_HOME/profiles/headless/cordis.patch.yml

Les deux fichiers contiennent le contenu suivant :

- id: llm-pi-ai
  config:
    providers:
      aihubmix:
        apiKeyEnv: AIHUBMIX_API_KEY
        api: openai-completions
        baseURL: https://aihubmix.com/v1
        models:
          - id: auto
- id: agent-default-model
  config:
    provider: aihubmix
    model: auto

Les deux entrées sont obligatoires. Si vous n’écrivez que llm-pi-ai sans agent-default-model, le mode headless utilise toujours le fournisseur par défaut deepseek-official et affiche MISSING_CREDENTIAL.

Les versions précédentes enregistraient la configuration dans $HOME/.dsh/settings.yaml, fichier qui n’est plus utilisé à partir de la version 0.2.0. Au premier démarrage de DSH 0.2.0, ce fichier est migré vers un profil et renommé settings.yaml.imported. La migration peut afficher MISSING_CREDENTIAL lors de cette première exécution : il suffit de relancer la commande une fois.

export AIHUBMIX_API_KEY='sk-***'
dsh web --port 3080

Lorsque la clé provient de l’environnement de lancement, la page de paramètres affiche un message en lecture seule sans révéler la valeur.

Détails du fournisseur AIHubMix dans DeepSeek Harness

Redémarrez Harness après toute modification de la variable.

Sélectionner un modèle et tester une conversation

Fermez Settings, ouvrez le sélecteur en bas à droite de la zone de saisie, puis choisissez Auto ou un modèle ajouté.

Reply with exactly: AIHubMix connection successful

La réponse attendue confirme la connexion entre Harness, le point de terminaison compatible OpenAI Chat Completions et AIHubMix.

Réponse AIHubMix réussie dans DeepSeek Harness

Exécuter un test headless

Pour tester sans la Web UI, exécutez la commande suivante. Elle utilise le profil headless, donc le fichier $DSH_HOME/profiles/headless/cordis.patch.yml doit contenir les deux entrées ci-dessus.

export AIHUBMIX_API_KEY='sk-***'
dsh --profile headless \
  'Reply with exactly DSH_AIHUBMIX_OK and do not use tools.'

Une exécution réussie affiche DSH_AIHUBMIX_OK.

Questions fréquentes

Pourquoi MISSING_CREDENTIAL s’affiche-t-il ?

Harness n’a pas pu lire une configuration utilisable. Vérifiez que les deux entrées sont présentes dans le profil et que la variable AIHUBMIX_API_KEY est définie, puis lancez Harness depuis le même terminal :

test -n "$AIHUBMIX_API_KEY" && echo configured

Pourquoi la découverte des modèles renvoie-t-elle 401 ?

Vérifiez que la clé API est valide et ne contient aucun espace ou saut de ligne supplémentaire. La requête utilise l’authentification Bearer.

Pourquoi Auto est-il le seul modèle du sélecteur ?

Le sélecteur affiche uniquement les modèles enregistrés dans le catalogue actuel. Ouvrez Settings → Models → AIHubMix → Edit, puis, dans Model catalog, sélectionnez Fetch available models, cochez les modèles voulus et choisissez Add selected.

Pourquoi Harness affiche-t-il UNKNOWN_MODEL ?

Le catalogue actuel ne contient pas cet identifiant. Les identifiants sont sensibles à la casse, utilisez la valeur exacte renvoyée par la découverte.

Pourquoi la connexion expire-t-elle ?

Vérifiez le DNS, le réseau de votre organisation et le proxy local. DSH lit automatiquement les variables HTTP_PROXY et HTTPS_PROXY. Pour exclure certaines adresses du proxy, définissez NO_PROXY. Si seul le navigateur utilise le proxy système, définissez HTTP_PROXY et HTTPS_PROXY dans le terminal qui lance dsh.

Consignes de sécurité

Ne placez pas de clé API dans Git, les captures d’écran ou les scripts partagés
Utilisez le stockage d’identifiants de Harness ou AIHUBMIX_API_KEY
N’affichez pas la clé API complète pendant le diagnostic
Injectez les variables avec la gestion des secrets de votre plateforme CI

Dernière mise à jour : 2026-10-18

Assistants de codage

Intégrations IDE

Agent / Workflow

SDKs et frameworks

Résumé

Quels sont les prérequis ?

Comment installer DeepSeek Harness ?

Comment démarrer la Web UI ?

Comment configurer le fournisseur AIHubMix ?

Ajouter auto ou un autre modèle

Comparaison entre auto et un modèle précis

Stocker la clé API dans une variable d’environnement

Sélectionner un modèle et tester une conversation

Exécuter un test headless

Questions fréquentes

Pourquoi MISSING_CREDENTIAL s’affiche-t-il ?

Pourquoi la découverte des modèles renvoie-t-elle 401 ?

Pourquoi Auto est-il le seul modèle du sélecteur ?

Pourquoi Harness affiche-t-il UNKNOWN_MODEL ?

Pourquoi la connexion expire-t-elle ?

Consignes de sécurité

​Résumé

​Quels sont les prérequis ?

​Comment installer DeepSeek Harness ?

​Comment démarrer la Web UI ?

​Comment configurer le fournisseur AIHubMix ?

​Ajouter auto ou un autre modèle

​Comparaison entre auto et un modèle précis

​Stocker la clé API dans une variable d’environnement

​Sélectionner un modèle et tester une conversation

​Exécuter un test headless

​Questions fréquentes

​Pourquoi MISSING_CREDENTIAL s’affiche-t-il ?

​Pourquoi la découverte des modèles renvoie-t-elle 401 ?

​Pourquoi Auto est-il le seul modèle du sélecteur ?

​Pourquoi Harness affiche-t-il UNKNOWN_MODEL ?

​Pourquoi la connexion expire-t-elle ?

​Consignes de sécurité

Résumé

Quels sont les prérequis ?

Comment installer DeepSeek Harness ?

Comment démarrer la Web UI ?

Comment configurer le fournisseur AIHubMix ?

Ajouter auto ou un autre modèle

Comparaison entre auto et un modèle précis

Stocker la clé API dans une variable d’environnement

Sélectionner un modèle et tester une conversation

Exécuter un test headless

Questions fréquentes

Pourquoi MISSING_CREDENTIAL s’affiche-t-il ?

Pourquoi la découverte des modèles renvoie-t-elle 401 ?

Pourquoi Auto est-il le seul modèle du sélecteur ?

Pourquoi Harness affiche-t-il UNKNOWN_MODEL ?

Pourquoi la connexion expire-t-elle ?

Consignes de sécurité