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 basiert auf DeepSeek Harness 0.2.0-rc.2, der neuesten Version zum 18. Oktober 2026. Gegenüber 0.1.0-rc.6 gibt es deutliche Änderungen: Speicherort der Konfiguration und Benutzeroberfläche wurden aktualisiert. Harness befindet sich weiterhin 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 (22.19.0 oder neuer) oder Node.js 24 oder neuer
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. Der offiziell empfohlene Start erfolgt über npx:

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

Ist Harness global installiert, können Sie auch Folgendes ausführen:

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 model provider, wechseln Sie die Karte auf Custom model API und geben Sie anschließend Folgendes ein:

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

Geben Sie Base URL und API Key ein und öffnen Sie danach den Model catalog. Wählen Sie dort 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 markieren Sie es in der abgerufenen Liste und wählen Add selected. Der grafische Modellselektor zeigt nur Modelle, die im aktuellen Provider-Katalog registriert sind.

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

Auf Entwicklungsrechnern und in CI-Umgebungen kann Harness den Schlüssel über eine Profildatei aus einer Umgebungsvariable lesen. Die Web UI verwendet das Profil web, der Headless-Test das Profil headless. Die Dateipfade lauten:

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

Beide Dateien enthalten folgenden Inhalt:

- 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

Beide Einträge sind erforderlich. Wenn nur llm-pi-ai und nicht agent-default-model eingetragen ist, verwendet der Headless-Modus weiterhin den Standardanbieter deepseek-official und meldet MISSING_CREDENTIAL.

Frühere Versionen speicherten die Konfiguration in $HOME/.dsh/settings.yaml. Ab Version 0.2.0 wird diese Datei nicht mehr verwendet. Beim ersten Start von DSH 0.2.0 wird sie in ein Profil migriert, und die Originaldatei wird in settings.yaml.imported umbenannt. Bei diesem Migrationslauf kann MISSING_CREDENTIAL erscheinen. Führen Sie den Befehl dann einfach noch einmal aus.

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

Ohne Web UI können Sie den folgenden Befehl ausführen. Er verwendet das Profil headless, daher muss $DSH_HOME/profiles/headless/cordis.patch.yml beide oben genannten Einträge enthalten.

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 keine verwendbare Konfiguration gelesen. Prüfen Sie, ob beide Einträge im Profil stehen und die Umgebungsvariable AIHUBMIX_API_KEY gesetzt ist. Starten Sie Harness danach aus demselben Terminal:

test -n "$AIHUBMIX_API_KEY" && echo configured

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, wählen Sie im Model catalog Fetch available models, markieren Sie die gewünschten Modelle und wählen Sie Add selected.

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. DSH liest die Umgebungsvariablen HTTP_PROXY und HTTPS_PROXY automatisch. Um bestimmte Adressen vom Proxy auszunehmen, setzen Sie NO_PROXY. Wenn nur der Browser den Systemproxy nutzt, setzen Sie HTTP_PROXY und HTTPS_PROXY 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-10-18

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