Configuration de DeepSeek Harness

DeepSeek Harness  (nom de commande dsh) est le harness d’agent open source officiel de DeepSeek, bâti sur une architecture où tout est plugin — modèles, outils, skills, sessions, sandboxes et interface sont autant de plugins interchangeables. Il appelle l’API officielle DeepSeek par défaut ; pointez son plugin de modèles vers OfoxAI et le même harness accède à plus de 100 modèles.

Étapes de configuration

1. Installer dsh

Installez d’abord Node.js. dsh est publié sur npm sous le nom @deepseek-ai/dsh et fournit la commande dsh une fois installé.

npm install -g pnpm          # ignorer si déjà installé
pnpm add -g @deepseek-ai/dsh
dsh --version

npm install -g pnpm          # ignorer si déjà installé
pnpm add -g @deepseek-ai/dsh
dsh --version

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

pnpm peut afficher l’avertissement Ignored build scripts: node-pty, koffi … pendant l’installation. Ignorez-le — ces deux paquets fournissent des binaires précompilés pour toutes les plateformes et ne nécessitent aucune compilation locale.

Pour l’essayer sans installation globale :

npx @deepseek-ai/dsh web

2. Configurer le provider OfoxAI

dsh conserve sa configuration dans $DSH_HOME — ~/.dsh sur macOS et Linux, %USERPROFILE%\.dsh sur Windows. Choisissez l’une des deux méthodes ci-dessous.

dsh web

llm-pi-ai:
  providers:
    ofox:
      apiKeyEnv: OFOX_API_KEY
      api: openai-completions
      baseURL: https://api.ofox.ai/v1
      models:
        - id: deepseek/deepseek-v4-pro-0813
          name: DeepSeek V4 Pro
        - id: google/gemini-2.5-flash
          name: Gemini 2.5 Flash
    ofox-anthropic:
      apiKeyEnv: OFOX_API_KEY
      api: anthropic-messages
      baseURL: https://api.ofox.ai/anthropic
      models:
        - id: anthropic/claude-sonnet-5
          name: Claude Sonnet 5
          contextWindow: 1000000
agent-default-model:
  provider: ofox
  model: deepseek/deepseek-v4-pro-0813

3. Définir la clé API

apiKeyEnv désigne un identifiant au lieu de contenir la clé elle-même. dsh le résout dans un ordre fixe : l’environnement dans lequel dsh a été lancé, puis $DSH_HOME/.credentials.yaml, puis le .env de votre projet, puis le .env de votre répertoire personnel. Si vous avez utilisé la Web UI, la clé est déjà enregistrée et vous pouvez sauter cette étape.

export OFOX_API_KEY=<votre OFOXAI_API_KEY>

export OFOX_API_KEY=<votre OFOXAI_API_KEY>

# session actuelle uniquement
$env:OFOX_API_KEY = "<votre OFOXAI_API_KEY>"
 
# permanent (disponible dans les nouveaux terminaux)
setx OFOX_API_KEY "<votre OFOXAI_API_KEY>"

4. Vérifier

dsh --profile headless "Réponds exactement : OK. N'appelle aucun outil."

Un OK en retour signifie que la couche modèle atteint bien OfoxAI. Au quotidien, lancez l’interface web avec dsh web, ou exécutez une tâche unique puis quittez avec dsh --profile headless "run the tests".

Différences entre plateformes

Le contenu du fichier de configuration est identique sur les trois plateformes — seuls les chemins et la syntaxe des variables d’environnement diffèrent.

Dépannage

TIMEOUT: Request timed out. — dsh est une application Node et ne lit pas http_proxy / all_proxy : un proxy système fonctionnel ne garantit donc pas que dsh puisse se connecter. Si le domaine indiqué dans baseURL est inaccessible depuis votre réseau, les utilisateurs de Chine continentale doivent basculer sur le miroir https://api.ofox.io/v1.

MISSING_CREDENTIAL — l’identifiant désigné par apiKeyEnv n’a rien renvoyé. Vérifiez que la variable d’environnement est bien active dans le terminal qui a lancé dsh, ou que la clé est enregistrée dans $DSH_HOME/.credentials.yaml. L’autre cause est un mauvais choix de modèle : la route intégrée deepseek-official affiche ses modèles dans le sélecteur même sans clé configurée, sous des noms très proches de ceux de votre route personnalisée.

La réponse est vide et aucune erreur n’est signalée — le piège le plus facile à déclencher : associer api: openai-responses à un modèle Anthropic termine la requête normalement (finish reason: stop) mais ne renvoie aucun contenu. Déplacez ce modèle vers une route openai-completions, ou vers une route anthropic-messages pointant sur https://api.ofox.ai/anthropic.

INVALID_REQUEST / HTTP 400 endpoint_not_supported — la charge utile indique Model '…' does not support the /v1/responses endpoint on this platform. Please use /v1/chat/completions instead. Les modèles Google et Qwen se comportent ainsi sous openai-responses. Là encore, passez api à openai-completions.

Le chargement d’un plugin échoue avec une erreur de route dupliquée — le même nom de route a été enregistré deux fois. Vérifiez si $DSH_HOME/cordis.patch.yml et settings.yaml définissent tous deux ofox.

Avancé : configuration via la couche patch

settings.yaml contient les paramètres utilisateur d’exécution et prend effet à la requête suivante. Pour modifier la composition des plugins elle-même — remplacer ou désactiver un plugin —, utilisez la couche patch dans $DSH_HOME/cordis.patch.yml :

- id: llm-pi-ai
  config:
    providers:
      ofox:
        apiKeyEnv: OFOX_API_KEY
        api: openai-completions
        baseURL: https://api.ofox.ai/v1
- id: agent-default-model
  config:
    provider: ofox
    model: deepseek/deepseek-v4-pro-0813

Exécutez dsh web --dump-config pour afficher l’arbre de plugins composé et confirmer que votre configuration a bien été appliquée.

Modèles recommandés

Pour les modèles recommandés, consultez le Marché des modèles .