Skip to main content
DeepSeek Harness ist ein lokal ausgeführter Programm-Agent. Er liest den Arbeitsbereich, ruft Werkzeuge auf und führt Befehle aus, und ruft dann über die OpenAI-kompatible Chat Completions-Schnittstelle das Modell auf.
Dieser Artikel gilt für deepseek-harness-sdk==0.1.0rc6 und deepseek-harness-runtime-bin==0.1.0rc6. Nach dem Upgrade des Clients führen Sie bitte die untenstehenden Tests für schreibgeschützte Dateien erneut durch.

Unterstützungsbereich

Das Modellverzeichnis kann sich ändern. Überprüfen Sie vor dem Ausführen mit dem speziellen Schlüssel des Coding Plans das aktuelle Verzeichnis:
Bestätigen Sie, dass die Antwort deepseek-v4-pro enthält. Verwenden Sie deepseek-v4-flash nicht als gleichwertigen Ersatz für den Werkzeugmodus in diesem Artikel; in dieser festen Versionsvalidierung hat seine mehrstufige Schlussfolgerungsgeschichte und Werkzeugwiedergabe nicht bestanden.

1. Bereiten Sie den speziellen Schlüssel vor

Öffnen Sie die Coding Plan Anwendung, gehen Sie zur gekauften Coding-Anwendung und erstellen oder kopieren Sie den speziellen API-Schlüssel dieser Anwendung. Der Coding Plan verwendet kein allgemeines Guthaben, Schlüssel anderer Anwendungen können die Paketberechtigungen nicht repräsentieren. Fügen Sie den Schlüssel nur in die aktuelle Shell ein:
Schreiben Sie den echten Schlüssel nicht in Skripte, Konfigurationsrepositorys, Terminal-Screenshots oder Sitzungsprotokolle.

2. Erstellen Sie einen isolierten Arbeitsbereich

Das gebündelte Runtime von Harness enthält lokale Bash-Werkzeuge. Verweisen Sie beim ersten Test nicht auf echte Projekte oder das Hauptverzeichnis; erstellen Sie ein einmaliges Verzeichnis ohne Geheimnisse:
Wenn das Unternehmensnetzwerk ein privates PyPI-Image verwendet, stellen Sie sicher, dass die gleiche Version von deepseek-harness-runtime-bin ebenfalls im Image vorhanden ist. Verwenden Sie nicht danger-full-access, um den Dateizugriff zu erweitern; das Beispiel in diesem Artikel übergibt nur das einmalige Verzeichnis an cwd.

3. Führen Sie das offizielle Python SDK aus

Speichern Sie den folgenden Inhalt als /tmp/deepseek-harness-demo/run.py:
Führen Sie aus:
Erwartetes Ergebnis:
Dieser Schritt validiert gleichzeitig die Bearer-Authentifizierung, /v1/chat/completions, SSE, Schlussfolgerungsinhalte, Werkzeugaufrufe und die Rückgabe von Werkzeugergebnissen. Nach Abschluss können Sie /tmp/deepseek-harness-demo löschen; wenn das Sitzungsverzeichnis Projektkontext enthält, sollte es ebenfalls gemäß dem gleichen Sensibilitätsgrad wie das Code-Repository aufbewahrt werden.

Häufige Fragen

  • 401: Überprüfen Sie, ob ACEDATACLOUD_API_KEY in die gleiche Shell exportiert wurde, in der Python ausgeführt wird.
  • 403 oder Kontingentmeldung: Bestätigen Sie, dass der Schlüssel zur aktuellen Coding-Anwendung gehört, das Paket noch gültig ist und über ein verbleibendes Guthaben verfügt.
  • Modell nicht verfügbar: Überprüfen Sie erneut /v1/models, raten Sie nicht anhand alter Screenshots auf den Modellnamen.
  • reasoning_content / Werkzeugwiedergabefehler: Bestätigen Sie, dass SDK/runtime die in diesem Artikel festgelegte Version sind und deepseek-v4-pro verwenden.
  • Ungewöhnliche Anzahl von Werkzeugausführungen: Stoppen Sie die Ausführung von Aufgaben, die Nebenwirkungen verursachen könnten, und verwenden Sie zunächst die schreibgeschützte Fixture, um die aktuelle Serviceversion zu validieren.
  • Installation fehlgeschlagen: Bestätigen Sie, dass Python 3.10+, die Betriebssystemarchitektur von dem aktuellen Wheel unterstützt wird, und überprüfen Sie die Übereinstimmung der SDK/runtime-Versionen.

Fähigkeitsgrenzen

Dieser Artikel validiert nur den lokalen Python SDK zu Chat Completions in Bezug auf Text und Werkzeugschleifen. Bilder, Files API, /v1/responses, /v1/messages, Remote-Arbeitsbereiche und gehostete Sandboxes fallen nicht in den versprochenen Rahmen dieses Tutorials; die Berechtigungen des Arbeitsbereichs und die Risiken lokaler Befehle liegen in der Verantwortung der Maschine und Konfiguration, die Harness ausführt.

Offizielle Referenzen

Zurück zum Coding Plan Konfigurationszentrum.