DeepSeek-Harness: Installation
In diesem Kapitel werdendrei Installationsmethoden vorgestellt: npm-Ein-Klick-Installation, Installation aus dem Quellcode, Python SDK.
Vorbereitung vor der Installation
Die Laufzeit von DeepSeek Harness basiert auf Node.js.Die offiziell empfohlene Ein-Klick-Installationsmethode erfordert keine zusätzlichen Abhängigkeiten.
Die Installation aus dem Quellcode erfordert außerdem pnpm und Git.
Die Python-SDK-Methode erfordert Python 3.10 oder höher.
Betriebssystem:Linux, macOS oder WindowsAlle möglich
Das Python SDK unterstützt Linux x64 / arm64 und macOS 14+ (arm64).
| Umgebungsanforderungen | npm-Ein-Klick-Installation | Installation aus dem Quellcode | Python SDK |
|---|---|---|---|
| Node.js | Erforderlich | Erforderlich | Nicht benötigt (Laufzeit im SDK enthalten) |
| Git | Optional | Erforderlich | Erforderlich |
| pnpm | Nicht erforderlich | Erforderlich | Nicht erforderlich |
| Python 3.10+ | Nicht erforderlich | Nicht erforderlich | Erforderlich |
| DeepSeek API-Schlüssel | Alle drei Methoden erfordern (zur Konfiguration des Modells; unterstützt auch OpenAI-kompatible Endpunkte) | ||
Prüfen Sie zuerst die lokale Umgebung; Node.js ist erforderlich, z. B. v20+:
node -v
git ist für die Installation aus dem Quellcode erforderlich:
git --version
Installationsmethode:
| Methode | Für wen es gedacht ist | Ausgabe |
|---|---|---|
| npm-Ein-Klick-Installation Empfohlen | Die meisten Nutzer: wollen die Web UI so schnell wie möglich erleben | Web UI starten, Standardhttp://127.0.0.1:3080 |
| Quellinstallation Entwicklung | Wollen Sie Plugins entwickeln, Quellcode lesen oder mitwirken | Lokales Repository + vollständige Build-Artefakte, verfügbarpnpm dshTypeScript-Einstiegspunkt direkt ausführen |
| Python SDK Programmatisch | Wollen Sie den Agent in Ihrem eigenen Python-Programm aufrufen | deepseek_harnessPaket + integrierte Laufzeit, kein systemweites Node.js erforderlich |
Methode 1: npm-Ein-Klick-Installation (empfohlen)
Wir können den npm-Befehl verwenden, um global zu installieren:
npm install -g @deepseek-ai/dsh
Die Installation auf diese Weise macht die spätere Verwendung bequemerdshBefehl. Nach Abschluss der Installation geben Sie den folgenden Befehl ein, um zu starten:
dsh web

Du kannst auch den npx-Befehl verwenden, um es zu installieren und schnell auszuprobieren — führe ihn im Terminal aus:
npx @deepseek-ai/dsh web
Der Befehl startet die Web-UI und initialisiert sie beim ersten Ausführen automatisch.webKonfigurationsvorlage, dann gibt sie die Zugriffsadresse aus——Der Standardwert isthttp://127.0.0.1:3080。

Überprüfe, ob es erfolgreich war:
1. Öffne die im Terminal ausgegebene Adresse in deinem Browser (Standardhttp://127.0.0.1:3080);
2. Die Installation ist erfolgreich, wenn du die DeepSeek Harness Web-Oberfläche siehst;
3. Hinweis: Die neue Web-UI wählt keinen Arbeitsbereich aus, bis ein Arbeitsbereich hinzugefügt wird——das ist normal, er wird im nächsten Schritt konfiguriert.
Tipps:dsh wirddas Aufrufverzeichnisals Standard-Dateisystemort verwenden. Es wird empfohlen, zuerstcdWechsle in dein Projektverzeichnis und führe aus:npx @deepseek-ai/dsh web, das macht es am praktischsten, wenn du später einen Arbeitsbereich auswählst.
Methode 2: Aus dem Quellcode installieren
Geeignet für die Entwicklung von Plugins, das Lesen von Quellcode oder zum Mitwirken. Führe nach dem Klonen des Repositorys der Reihe nach aus:
git clone https://github.com/deepseek-ai/deepseek-harness.git cd deepseek-harness pnpm install # 安装依赖(需要 pnpm,可用 npm install -g pnpm 安装) pnpm run build # 构建包与前端产物(生产运行需要) pnpm dsh web # 以源码方式启动 Web UI
Weitere Einstiegspunkte beim Ausführen aus dem Quellcode:
pnpm dsh --profile headless "run the tests"— eine Aufgabe einmal ausführen und die endgültige Antwort ausgeben;
pnpm dsh --profile web --dump-config— den vollständigen Konfigurationsbaum des tatsächlichen Starts anzeigen (nützlich bei der Entwicklung von Plugins).
Methode 3: Python-SDK-Installation
Voraussetzungen: Python 3.10+, Git, ein DeepSeek-kompatibler API-Endpunkt und Zugangsdaten, ein isolierter Arbeitsbereich, den der Agent ändern kann. Erstellen Sie eine virtuelle Umgebung und installieren Sie:
git clone https://github.com/deepseek-ai/deepseek-harness.git cd deepseek-harness python -m venv .venv . .venv/bin/activate python -m pip install deepseek-harness-sdk
Nach dem Festlegen der Zugangsdaten kann es im Programm aufgerufen werden (das SDK enthält eine integrierte Laufzeit,Kein vom System bereitgestelltes Node.js erforderlich):
export DEEPSEEK_API_KEY=sk-your-key-here # 如果模型不是默认 DeepSeek 端点,而是 OpenAI 兼容代理,还需要: # export DEEPSEEK_BASE_URL=http://127.0.0.1:8000/v1 # export DSH_MODEL=deepseek-v4-flash
Verwenden Sie es in Ihrem eigenen Python-Programm:
from deepseek_harness import DeepSeekHarness— im Repository integriertexamples/jsonrpc-agent/minimal.pyist ein leichtgewichtiger Wrapper für SDK-Aufrufe und kann direkt referenziert werden; nach dem Ausführen gibt er die endgültige Antwort des Assistenten aus, und das Sitzungsverzeichnis erhält JSONL-Protokolle, die Modellanfragen und Tool-Aufrufe enthalten.
Erstmalige Konfiguration und die erste Aufgabe
Unabhängig davon, welche Methode Sie zum Starten der Web-UI verwenden, sind bei der erstmaligen Nutzung nur drei Schritte erforderlich:
| Schritte | Aktion | Beschreibung |
|---|---|---|
| 1Modell konfigurieren | Einstellungen → Modell | DeepSeek-API-Schlüssel eingeben und speichern. Modell-RoutingSofort verfügbar, kein Server-Neustart erforderlich; unterstützt auch andere Anbieter und benutzerdefinierte OpenAI-kompatible Endpunkte |
| 2Arbeitsbereich auswählen | Auf "Arbeitsbereich auswählen" klicken | Das Projektverzeichnis hinzufügen, in dem dsh gestartet wurde, und es auswählen.Das Sitzungseingabefeld ist nicht verfügbar, bis ein Arbeitsbereich ausgewählt wurde |
| 3Aufgabe ausführen | Anweisungen in der Sitzung eingeben | Zum BeispielSummarize this repository and identify its main packages.— der Agent liest/schreibt Arbeitsbereichsdateien, führt Befehle aus, delegiert Subagenten und pflegt Pläne; Vorgänge, die über die Berechtigungsrichtlinie hinausgehen, erfordern zunächst Ihre Genehmigung |
firstTaskSuggestionsfromLightweightDirectivestart:"Fassen Sie dieses Repository zusammen und identifizieren Sie seine Hauptpakete."
Lassen Sie den Agenten zunächst den Arbeitsbereich kennenlernen und weisen Sie ihm dann nach und nach echte Aufgaben zu.— Empfehlung des offiziellen Schnellstartleitfadens
Kurzreferenz für gängige Befehle
| Befehl | Funktion |
|---|---|
npx @deepseek-ai/dsh web |
Die Web-UI starten (entspricht--profile web) |
dsh --profile headless "任务描述" |
Eine Aufgabe einmal ausführen, die endgültige Antwort ausgeben und dann beenden (geeignet für Skripte/CI) |
dsh plugin --profile <name> <pnpm 参数> |
Plugins für ein Profil verwalten (leitet zur Ausführung im Profilverzeichnis an pnpm weiter) |
dsh --profile web --dump-config |
Den vollständigen Konfigurationsbaum des tatsächlichen Starts anzeigen (ohne den Server zu starten) |
dsh --profile web --dump-default-config |
Den Standard-Konfigurationsbaum anzeigen (ohne Benutzer-Patches) |
pip install deepseek-harness-sdk |
Das Python-SDK installieren (mit integrierter Laufzeitumgebung) |
Über Profile:webundheadlessBei der ersten Verwendung werden zwei Profile automatisch aus integrierten Vorlagen initialisiert; die übrigen Profile müssendsh pluginerstellt werden. Die Startargumente von dsh kommen zuerst, Anwendungsargumente danach, zum Beispieldsh --profile web --port 8080Mittel--portEs ist eine Webanwendung.
Häufige Probleme und Fehlerbehebung
Problem 1: Der Browser kann http://127.0.0.1:3080 nicht öffnen
Bestätigen Sie, dass der dsh-Prozess noch im Terminal läuft und keine Fehler vorliegen; wenn der Port belegt ist, können Siedsh --profile web --port 8080Ändern Sie den Port; prüfen Sie, ob die Firewall den lokalen Port zulässt.
Problem 2: npx kann @deepseek-ai/dsh nicht finden oder die Version ist zu alt
Stellen Sie zunächst sicher, dass Node.js installiert und die Version relativ neu ist (node -v); das Projekt befindet sich in der Entwicklervorschauphase und wird schnell weiterentwickelt. Leeren Sie bei Bedarf den npx-Cache und versuchen Sie es erneut, oder wechseln Sie zur Installation aus dem Quellcode.
Problem 3: pnpm install / build schlägt bei der Installation aus dem Quellcode fehl
Bestätigen Sie, dass pnpm installiert ist (npm install -g pnpm); wenn das Netzwerk eingeschränkt ist, können Sie eine Mirror-Quelle für npm/pnpm konfigurieren; der Build erfordert, dass die Node.js-Version der engines-Deklaration in der package.json des Repositorys entspricht.
Problem 4: Das Sitzungs-Eingabefeld ist nicht verfügbar / der Agent kann keine Dateien lesen oder schreiben
Die häufigste Ursache istEs wurde kein Arbeitsbereich ausgewählt— kehren Sie zu "Arbeitsbereich auswählen" zurück, um das Projektverzeichnis hinzuzufügen und auszuwählen; bestätigen Sie, dass ein gültiger API-Schlüssel in "Einstellungen → Modelle" gespeichert wurde, und dass das Modell-Routing ohne Neustart wirksam wird.
Problem 5: Python-SDK-Laufzeit kann Node.js nicht finden
Das SDK bringt eine integrierte Laufzeit mit und benötigt normalerweise kein System-Node.js; wenn eine fehlende Laufzeit gemeldet wird, bestätigen Sie bitte, dass Sie das vollständige Paket derselben Version wie das SDK installiert haben (python -m pip install deepseek-harness-sdk), und verwenden Sie Linux x64 / arm64 oder macOS 14+ (arm64) gemäß den offiziellen Voraussetzungen.