DeepSeek Harness Konfiguration

DeepSeek Harness  (Befehlsname dsh) ist DeepSeeks offizielles Open-Source-Agent-Harness, aufgebaut auf einer Architektur, in der alles ein Plugin ist — Modelle, Tools, Skills, Sessions, Sandboxes und die Oberfläche sind allesamt austauschbare Plugins. Standardmäßig ruft es die offizielle DeepSeek-API auf; richten Sie das Modell-Plugin auf OfoxAI aus, und dasselbe Harness erreicht 100+ Modelle.

Konfigurationsschritte

1. dsh installieren

Installieren Sie zuerst Node.js. dsh wird auf npm als @deepseek-ai/dsh veröffentlicht und stellt nach der Installation den Befehl dsh bereit.

npm install -g pnpm          # überspringen, falls bereits installiert
pnpm add -g @deepseek-ai/dsh
dsh --version

npm install -g pnpm          # überspringen, falls bereits installiert
pnpm add -g @deepseek-ai/dsh
dsh --version

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

pnpm gibt während der Installation möglicherweise die Warnung Ignored build scripts: node-pty, koffi … aus. Ignorieren Sie sie — beide Pakete liefern vorkompilierte Binaries für jede Plattform und benötigen keine lokale Kompilierung.

Zum Ausprobieren ohne globale Installation:

npx @deepseek-ai/dsh web

2. OfoxAI-Provider konfigurieren

dsh legt seine Konfiguration unter $DSH_HOME ab — ~/.dsh unter macOS und Linux, %USERPROFILE%\.dsh unter Windows. Wählen Sie einen der beiden Wege.

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. API Key setzen

apiKeyEnv benennt lediglich ein Credential, statt den Schlüssel selbst zu enthalten. dsh löst es in einer festen Reihenfolge auf: zuerst die Umgebung, in der dsh gestartet wurde, dann $DSH_HOME/.credentials.yaml, dann die .env Ihres Projekts, dann die .env in Ihrem Home-Verzeichnis. Wenn Sie die Web UI verwendet haben, ist der Schlüssel bereits gespeichert und Sie können diesen Schritt überspringen.

export OFOX_API_KEY=<Ihr OFOXAI_API_KEY>

export OFOX_API_KEY=<Ihr OFOXAI_API_KEY>

# nur für die aktuelle Sitzung
$env:OFOX_API_KEY = "<Ihr OFOXAI_API_KEY>"
 
# dauerhaft (in neuen Terminals verfügbar)
setx OFOX_API_KEY "<Ihr OFOXAI_API_KEY>"

4. Überprüfen

dsh --profile headless "Antworte mit genau: OK. Rufe keine Tools auf."

Kommt ein OK zurück, erreicht die Modellschicht OfoxAI. Für die tägliche Arbeit starten Sie die Weboberfläche mit dsh web oder führen mit dsh --profile headless "run the tests" eine einzelne Aufgabe aus und beenden das Programm wieder.

Plattformunterschiede

Der Inhalt der Konfigurationsdatei ist auf allen drei Plattformen identisch — nur Pfade und die Syntax für Umgebungsvariablen unterscheiden sich.

Fehlerbehebung

TIMEOUT: Request timed out. — dsh ist eine Node-Anwendung und liest http_proxy / all_proxy nicht aus; ein funktionierender System-Proxy bedeutet also nicht, dass dsh eine Verbindung aufbauen kann. Ist die Domain aus baseURL in Ihrem Netzwerk nicht erreichbar, sollten Nutzer in Festlandchina auf den Spiegel https://api.ofox.io/v1 wechseln.

MISSING_CREDENTIAL — das von apiKeyEnv benannte Credential konnte nicht aufgelöst werden. Prüfen Sie, ob die Umgebungsvariable in dem Terminal, aus dem dsh gestartet wurde, tatsächlich gesetzt ist oder ob der Schlüssel in $DSH_HOME/.credentials.yaml hinterlegt ist. Die andere Ursache ist ein falsch gewähltes Modell: Die eingebaute Route deepseek-official listet ihre Modelle auch ohne konfigurierten Schlüssel in der Auswahl auf — unter Namen, die denen Ihrer eigenen Route sehr ähnlich sind.

Die Antwort ist leer, ohne dass ein Fehler gemeldet wird — die häufigste Falle: Kombiniert man api: openai-responses mit einem Anthropic-Modell, endet die Anfrage regulär (finish reason: stop), liefert aber keinen Inhalt. Verschieben Sie dieses Modell auf eine openai-completions-Route oder auf eine anthropic-messages-Route, die auf https://api.ofox.ai/anthropic zeigt.

INVALID_REQUEST / HTTP 400 endpoint_not_supported — im Payload steht Model '…' does not support the /v1/responses endpoint on this platform. Please use /v1/chat/completions instead. Google- und Qwen-Modelle verhalten sich unter openai-responses so. Auch hier: api auf openai-completions umstellen.

Das Laden eines Plugins scheitert an einer doppelten Route — derselbe Routenname wurde zweimal registriert. Prüfen Sie, ob sowohl $DSH_HOME/cordis.patch.yml als auch settings.yaml ofox definieren.

Fortgeschritten: Konfiguration über die Patch-Ebene

settings.yaml enthält die Benutzereinstellungen zur Laufzeit und wird mit der nächsten Anfrage wirksam. Um die Plugin-Zusammensetzung selbst zu ändern — ein Plugin austauschen oder deaktivieren —, verwenden Sie die Patch-Ebene unter $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

Führen Sie dsh web --dump-config aus, um den zusammengesetzten Plugin-Baum auszugeben und zu bestätigen, dass Ihre Konfiguration greift.

Empfohlene Modelle

Empfohlene Modelle finden Sie im Modell-Marktplatz .