DeepSeek Harness

Verwenden Sie diese Anleitung, um das quelloffene DeepSeek Harness mit Modellen auszuführen, die von der Felo API Platform bereitgestellt werden. Der empfohlene Weg nutzt den integrierten Adapter deepseek-official des Harness. Sie können Felo außerdem als separaten benutzerdefinierten OpenAI-kompatiblen Anbieter in der Web-UI hinzufügen.

DeepSeek Harness ist derzeit eine Developer Preview und kann kompatibilitätsbrechende Änderungen einführen. Prüfen Sie die Upstream-Release-Notes, wenn eine Option oder ein Bildschirm von dieser Anleitung abweicht.

Bevor Sie beginnen

Sie benötigen Node.js und einen Schlüssel für die Felo API Platform. Halten Sie den Schlüssel aus der Versionsverwaltung heraus.

export FELO_API_KEY="YOUR_API_KEY"

Die Beispiele verwenden deepseek-v4-flash. Prüfen Sie Modelle und Preise, bevor Sie eine andere Modell-ID wählen.

Empfohlene Einrichtung: integrierter DeepSeek-Adapter

DeepSeek Harness liest die Anmeldedaten des integrierten Adapters aus DEEPSEEK_API_KEY und seinen Endpoint aus DEEPSEEK_BASE_URL.

export DEEPSEEK_API_KEY="$FELO_API_KEY"
export DEEPSEEK_BASE_URL="https://openapi.felo.ai/api/v1"
npx @deepseek-ai/dsh web

Öffnen Sie http://127.0.0.1:3080 und gehen Sie dann wie folgt vor:

1. Fügen Sie Ihren Projekt-Workspace hinzu oder wählen Sie ihn aus.
2. Öffnen Sie Settings → Models.
3. Wählen Sie den Anbieter deepseek-official und das Modell deepseek-v4-flash.
4. Starten Sie eine neue Sitzung und senden Sie eine kleine Repository-Aufgabe.

Hängen Sie /chat/completions nicht an die Base-URL an. Der integrierte Adapter sendet Anfragen selbst an {DEEPSEEK_BASE_URL}/chat/completions.

Umgebungswerte dauerhaft speichern

DeepSeek Harness kann eine .env-Datei aus dem Verzeichnis lesen, in dem Sie es starten. Fügen Sie die folgenden Werte einer nicht versionierten .env-Datei hinzu, wenn Sie sie nicht für jede Sitzung exportieren möchten:

DEEPSEEK_API_KEY=YOUR_API_KEY
DEEPSEEK_BASE_URL=https://openapi.felo.ai/api/v1

Übertragen Sie diese Datei nicht in die Versionsverwaltung. Sie können auch die Anmeldedaten- und Einstellungsdateien des Harness unter $DSH_HOME verwenden, wenn Sie eine Konfiguration auf Benutzerebene benötigen.

Alternative Einrichtung: benutzerdefinierter OpenAI-kompatibler Anbieter

Verwenden Sie diesen Weg, wenn Felo als separater Anbieter erscheinen soll, statt die integrierte DeepSeek-Verbindung zu überschreiben.

1. Starten Sie die Web-UI mit npx @deepseek-ai/dsh web.
2. Öffnen Sie Settings → Models.
3. Wählen Sie Add custom provider.
4. Geben Sie die folgenden Werte ein und speichern Sie den Anbieter.

Wenn die Modellerkennung fehlschlägt, fügen Sie die Modell-ID manuell hinzu. Die Aktion Get available models eines Anbieters setzt eine OpenAI-kompatible GET /models-Route voraus und ist für die manuelle Konfiguration nicht erforderlich.

Einrichtung prüfen

Starten Sie eine neue Sitzung und fragen Sie:

Summarize this repository and identify its main packages.

Die Einrichtung ist bereit, wenn die Sitzung mit ausgewähltem deepseek-v4-flash abgeschlossen wird und kein Authentifizierungs- oder Unbekanntes-Modell-Fehler erscheint.

Für einen nicht interaktiven Smoke-Test mit dem empfohlenen Adapter führen Sie im Ziel-Workspace aus:

npx @deepseek-ai/dsh --profile headless "List the top-level files in this workspace."

Hinweis zur Websuche

Diese Einrichtung leitet Modellanfragen über Felo. Der integrierte web_search-Anbieter von DeepSeek Harness hat separate Endpoint-Anforderungen, obwohl seine Standard-Anmeldedatenvariable ebenfalls DEEPSEEK_API_KEY lautet. Richten Sie DEEPSEEK_SEARCH_BASE_URL nicht auf Felo, sofern Sie keinen ausdrücklich kompatiblen Such-Endpoint verwenden. Verwenden Sie die Chat API von Felo oder andere Felo Skills separat, wenn Ihr Workflow die Felo-Suche benötigt.

Fehlerbehebung

Nächste Schritte

• DeepSeek Harness-Repository
• LLM API-Referenz
• Chat API-Referenz
• Felo Skills für KI-Agenten