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 a été testé le 14 août 2026 avec DeepSeek Harness 0.1.0-rc.6. Harness est encore en aperçu développeur, les champs ou l’interface peuvent évoluer.

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.19.0 ou une version ultérieure, y compris Node.js 24+
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 :

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 a custom provider.

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, 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, sélectionnez-le dans la liste ou choisissez Add model et saisissez son identifiant exact. Le sélecteur graphique affiche uniquement les modèles enregistrés dans le catalogue du Provider actuel.

Sélectionnez Create provider pour enregistrer.

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

Modifiez $HOME/.dsh/settings.yaml :

llm-pi-ai:
  providers:
    aihubmix:
      displayName: AIHubMix
      apiKeyEnv: AIHUBMIX_API_KEY
      api: openai-completions
      baseURL: https://aihubmix.com/v1
      models:
        - id: auto
          name: Auto
          contextWindow: 1000000
          maxTokens: 32768

agent-default-model:
  provider: aihubmix
  model: auto

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

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 reçu AIHUBMIX_API_KEY dans son environnement de lancement. Définissez la variable et démarrez Harness depuis le même terminal.

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 utilisez Fetch available models ou ajoutez l’identifiant exact manuellement.

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. Si seul le navigateur utilise le proxy système, définissez HTTP_PROXY, HTTPS_PROXY et NODE_USE_ENV_PROXY=1 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-08-14

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é