DeepSeek Harness

DeepSeek Harness (Befehl dsh) ist das Open-Source-Framework von DeepSeek für Coding Agents. Es bietet Arbeitsbereiche, Terminal, Dateibearbeitung, Skills, Planung und eine Web UI. Über die OpenAI-Chat-Completions-kompatible Schnittstelle kann es AIHubMix verwenden.

Diese Anleitung wurde am 14. August 2026 mit DeepSeek Harness 0.1.0-rc.6 getestet. Harness befindet sich in der Entwickler-Vorschau, daher können spätere Versionen Felder oder UI-Details ändern.

Zusammenfassung

Für die Integration sind vier Werte erforderlich:

Einstellung	Wert
Provider ID	`aihubmix`
Base URL	`https://aihubmix.com/v1`
API protocol	`openai-completions`
API key environment variable	`AIHUBMIX_API_KEY`

AIHubMix ist auf der Models-Seite von DeepSeek Harness konfiguriert

Welche Voraussetzungen gibt es?

Ein aktiver AIHubMix API Key
Node.js 22.19.0 oder neuer, einschließlich Node.js 24+
Netzwerkzugriff auf die npm Registry und https://aihubmix.com

node --version
npm --version

Wie wird DeepSeek Harness installiert?

Installieren Sie das veröffentlichte npm-Paket, ohne das Quellrepository zu klonen:

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

Bei dsh: command not found führen Sie npm config get prefix aus und prüfen, ob das zugehörige bin-Verzeichnis in PATH enthalten ist.

Wie wird die Web UI gestartet?

Führen Sie den Befehl im Projektverzeichnis aus, das als Arbeitsbereich dienen soll:

dsh web --port 3080

Öffnen Sie http://127.0.0.1:3080 und wählen oder erstellen Sie bei der ersten Verwendung einen Arbeitsbereich.

Wie wird der AIHubMix-Anbieter konfiguriert?

Öffnen Sie Settings > Models > Add a custom provider.

Formular für einen benutzerdefinierten Anbieter in DeepSeek Harness

Feld	Empfohlener Wert	Hinweise
Provider ID	`aihubmix`	Bezeichner in Kleinbuchstaben, bei Bedarf `aihubmix-gateway`
Display name	`AIHubMix`	Name im Modellselektor
Base URL	`https://aihubmix.com/v1`	Muss `/v1` enthalten
API protocol	`openai-completions`	OpenAI-Chat-Completions-kompatibles Protokoll
API key	Ihr AIHubMix API Key	Harness speichert ihn als Zugangsdaten und zeigt den Klartext nicht erneut an

Der endgültige Endpunkt lautet https://aihubmix.com/v1/chat/completions.

Tragen Sie nicht den vollständigen Pfad /chat/completions in Base URL ein.

auto oder ein anderes Modell hinzufügen

Wählen Sie nach Eingabe von Base URL und API Key Fetch available models. Harness ruft GET https://aihubmix.com/v1/models auf und zeigt die verfügbaren Modell-IDs an.

Verfügbare AIHubMix-Modelle in DeepSeek Harness

Für den ersten Verbindungstest können Sie nur auto mit dem Anzeigenamen Auto hinzufügen. Für ein bestimmtes Modell wählen Sie es aus der Liste oder geben über Add model die genaue Modell-ID ein. Der grafische Modellselektor zeigt nur Modelle, die im aktuellen Provider-Katalog registriert sind.

Speichern Sie mit Create provider.

auto vs. festes Modell

Auswahl	Einsatz
`auto`	Erster Verbindungstest oder automatische Modellauswahl durch AIHubMix
Feste Modell-ID	Feste Modellfunktion, Version oder reproduzierbares Ergebnis erforderlich

Beide Varianten verwenden denselben Provider, dieselbe Base URL und denselben API Key. Beim Modellwechsel muss der Anbieter nicht neu erstellt werden.

API Key in einer Umgebungsvariable speichern

Bearbeiten Sie $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

Wenn der Schlüssel aus der Startumgebung stammt, zeigt die Einstellungsseite einen schreibgeschützten Hinweis, ohne den Wert offenzulegen.

Details des AIHubMix-Anbieters in DeepSeek Harness

Starten Sie Harness nach einer Änderung der Umgebungsvariable neu.

Modell auswählen und Unterhaltung testen

Schließen Sie Settings und wählen Sie unten rechts im Eingabefeld Auto oder ein anderes hinzugefügtes Modell.

Auto im Modellselektor von DeepSeek Harness

Reply with exactly: AIHubMix connection successful

Die erwartete Antwort bestätigt die Verbindung zwischen Harness, dem OpenAI-Chat-Completions-kompatiblen Endpunkt und AIHubMix.

Erfolgreiche AIHubMix-Antwort in DeepSeek Harness

Headless-Test ausführen

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

Bei Erfolg wird DSH_AIHUBMIX_OK ausgegeben.

Häufige Fragen

Warum zeigt Harness MISSING_CREDENTIAL?

Harness hat AIHUBMIX_API_KEY nicht aus der Startumgebung erhalten. Setzen Sie die Variable und starten Sie Harness aus demselben Terminal.

Warum liefert die Modellsuche 401?

Prüfen Sie, ob der API Key gültig ist und keine zusätzlichen Leerzeichen oder Zeilenumbrüche enthält. Die Anfrage verwendet Bearer-Authentifizierung.

Warum ist Auto das einzige Modell im Selektor?

Der Selektor zeigt nur registrierte Modelle des aktuellen Provider-Katalogs. Öffnen Sie Settings > Models > AIHubMix > Edit und verwenden Sie Fetch available models oder fügen Sie die genaue Modell-ID manuell hinzu.

Warum meldet Harness UNKNOWN_MODEL?

Der aktuelle Provider-Katalog enthält diese Modell-ID nicht. Modell-IDs unterscheiden Groß- und Kleinschreibung. Verwenden Sie den exakten Wert aus der Modellsuche.

Warum läuft die Verbindung in ein Timeout?

Prüfen Sie DNS, das Organisationsnetzwerk und den lokalen Proxy. Wenn nur der Browser den Systemproxy nutzt, setzen Sie HTTP_PROXY, HTTPS_PROXY und NODE_USE_ENV_PROXY=1 im Terminal, das dsh startet.

Sicherheitshinweise

Speichern Sie API Keys nicht in Git, Screenshots oder gemeinsam genutzten Skripten
Verwenden Sie den Zugangsspeicher von Harness oder AIHUBMIX_API_KEY
Geben Sie bei der Fehlersuche keinen vollständigen API Key aus
Nutzen Sie die Secret-Verwaltung der CI-Plattform für Umgebungsvariablen

Zuletzt aktualisiert: 2026-08-14

Coding-Assistenten

IDE-Integrationen

Agent / Workflow

SDKs und Frameworks

Zusammenfassung

Welche Voraussetzungen gibt es?

Wie wird DeepSeek Harness installiert?

Wie wird die Web UI gestartet?

Wie wird der AIHubMix-Anbieter konfiguriert?

auto oder ein anderes Modell hinzufügen

auto vs. festes Modell

API Key in einer Umgebungsvariable speichern

Modell auswählen und Unterhaltung testen

Headless-Test ausführen

Häufige Fragen

Warum zeigt Harness MISSING_CREDENTIAL?

Warum liefert die Modellsuche 401?

Warum ist Auto das einzige Modell im Selektor?

Warum meldet Harness UNKNOWN_MODEL?

Warum läuft die Verbindung in ein Timeout?

Sicherheitshinweise

​Zusammenfassung

​Welche Voraussetzungen gibt es?

​Wie wird DeepSeek Harness installiert?

​Wie wird die Web UI gestartet?

​Wie wird der AIHubMix-Anbieter konfiguriert?

​auto oder ein anderes Modell hinzufügen

​auto vs. festes Modell

​API Key in einer Umgebungsvariable speichern

​Modell auswählen und Unterhaltung testen

​Headless-Test ausführen

​Häufige Fragen

​Warum zeigt Harness MISSING_CREDENTIAL?

​Warum liefert die Modellsuche 401?

​Warum ist Auto das einzige Modell im Selektor?

​Warum meldet Harness UNKNOWN_MODEL?

​Warum läuft die Verbindung in ein Timeout?

​Sicherheitshinweise

Zusammenfassung

Welche Voraussetzungen gibt es?

Wie wird DeepSeek Harness installiert?

Wie wird die Web UI gestartet?

Wie wird der AIHubMix-Anbieter konfiguriert?

auto oder ein anderes Modell hinzufügen

auto vs. festes Modell

API Key in einer Umgebungsvariable speichern

Modell auswählen und Unterhaltung testen

Headless-Test ausführen

Häufige Fragen

Warum zeigt Harness MISSING_CREDENTIAL?

Warum liefert die Modellsuche 401?

Warum ist Auto das einzige Modell im Selektor?

Warum meldet Harness UNKNOWN_MODEL?

Warum läuft die Verbindung in ein Timeout?

Sicherheitshinweise