DeepSeek Harness (dsh) installieren

Voraussetzungen

Sie brauchen Node.js. Das Repository deklariert einen engines-Bereich von ^22.19 || >=24; eine ältere Runtime verweigert entweder die Installation oder scheitert später auf eine Weise, die wie ein Fehler im Harness aussieht. Prüfen Sie vorab, was Sie haben:

node -v

Für den npx-Weg ist das die vollständige Liste der Anforderungen. Wollen Sie aus dem Quellcode bauen, brauchen Sie zusätzlich git und pnpm — den Paketmanager, auf den das Repository ausgelegt ist. Nichts auf dieser Seite verlangt eine systemweite Installation von dsh, und solange sich die Preview so schnell bewegt, ist eine projektweit fixierte Version leichter zu überblicken als ein globales Binary, dessen Installation man vergisst.

Schnellstart mit npx

Ein Befehl liefert Ihnen einen laufenden Harness samt Weboberfläche:

npx @deepseek-ai/dsh web

npm holt das Paket, und der Harness stellt seine Web-UI unter http://127.0.0.1:3080 bereit. Diese Adresse ist Loopback: Sie antwortet auf Ihrem Rechner und sonst nirgends — die richtige Voreinstellung für ein Werkzeug, das Ihre Dateien lesen und Befehle ausführen kann.

Die CLI kennt außerdem einen --profile-Schalter — dsh --profile <profile> — der auswählt, welches Plugin-Bündel beim Start geladen wird. Zu den mitgelieferten Profilen gehört headless. Führen Sie dsh --help gegen Ihre eigene Version aus, statt einer Liste zu vertrauen, die einen Tag nach dem Release geschrieben wurde: Verfügbare Profile und Bündel sind genau die Art von Detail, die eine Preview zwischen Releases neu mischt.

Aus dem Quellcode betreiben

Aus dem Repository zu bauen ist die zusätzlichen Minuten wert, wenn Sie ein Plugin schreiben wollen — Sie lesen dann die echten Paket-APIs, statt sie aus einer README zu erschließen:

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

Führen Sie den Build vor dem ersten pnpm dsh web aus; die dokumentierte Reihenfolge sieht das so vor. Sie landen bei derselben Web-UI auf Port 3080, jetzt aber gegen den Arbeitsbaum — Sie können also ein Paket patchen, neu bauen und das Ergebnis sehen. Das ist zugleich der schnellste Weg herauszufinden, was sich in einem Release wirklich geändert hat, denn eine so schnelle Preview überholt ihre eigene Dokumentation.

Wo cordis.yml hineinpasst

Der ordnende Gedanke von dsh ist: Alles ist ein Plugin. Modelle, Tools, Skills, Sessions, Sandboxes, Dateisysteme, die Agent-Schleife, die Orchestrierung und die Benutzeroberfläche sind allesamt Plugins, die in eine gemeinsame Runtime geladen werden. Diese Runtime ist Cordis, das Meta-Framework, auf dem der Harness aufbaut; @deepseek-ai/cordis ist eine Peer-Dependency jedes Harness-Pakets.

Welche Plugins mit welchen Optionen geladen werden, entscheidet eine cordis.yml-Loader-Konfiguration:

# cordis.yml
plugins:
  dsh-example-plugin:

Jeder Schlüssel unter plugins: benennt ein Plugin; der Block darunter ist dessen Konfiguration — oder gar nichts, wenn die Voreinstellungen genügen. Offizielle Pakete erscheinen als @deepseek-ai/dsh-<name>, und der Loader-Schlüssel ist in der Regel der Paketname ohne npm-Scope. Plugin-Autoren wählen manchmal einen anderen Schlüssel, deshalb schlägt die README des Plugins, das Sie hinzufügen, jede Faustregel — auch diese hier.

Ein Community-Plugin hinzufügen

Ein Plugin hinzuzufügen sind zwei Schritte: Paket installieren, dann in der Loader-Konfiguration eintragen.

npm install dsh-example-plugin

# cordis.yml
plugins:
  dsh-example-plugin:

Starten Sie den Harness neu, und das Plugin wird zusammen mit allem anderen geladen. Um etwas Installierenswertes zu finden, durchsuchen Sie die 7900 erfassten Repositories oder grenzen Sie nach Kategorie ein. Davon sind 3942 verifiziert — wir haben also eine Abhängigkeit zur Cordis-Runtime oder eine cordis.yml im Repository gefunden, sie werden tatsächlich geladen. Der Rest trägt ein dsh-plugin-Topic auf GitHub ohne jede Verdrahtung dahinter. Das ist relevant, weil dieses Topic zugleich der Weg ist, über den Auffindbarkeit funktioniert: Wenn Sie ein Plugin veröffentlichen, findet das Ökosystem Sie über genau dieses Topic.

Fehlerbehebung

Die Installation scheitert mit einem engine- oder Syntaxfehler

Fast immer ein zu altes Node.js. Das Repository verlangt ^22.19 || >=24; darunter kann die Installation fehlschlagen oder tief in einer Abhängigkeit ein Parse-Fehler auftreten, der wie ein kaputtes Paket aussieht, es aber nicht ist. Prüfen Sie node -v und aktualisieren Sie — ein Versionsmanager wie nvm oder fnm ist der störungsärmste Weg, wenn andere Projekte auf dem Rechner ältere Runtimes brauchen.

Port 3080 ist bereits belegt

Etwas anderes hält den Port — häufig ein früherer dsh-Lauf, der nie beendet wurde. Unter macOS oder Linux finden Sie ihn so:

lsof -i :3080

Beenden Sie diesen Prozess und starten Sie neu. Wenn Sie lieber den Harness verschieben als den anderen Dienst, sehen Sie in dsh --help und in den Optionen des Web-Plugins in Ihrer cordis.yml nach, statt einen Schalternamen zu raten: Die Optionsfläche der Preview ändert sich noch, und ein Schalter, der letzte Woche in einem Blogbeitrag funktioniert hat, existiert in Ihrem Build vielleicht nicht.

Letzte Woche lief es, jetzt nicht mehr

Das ist kein Rätsel, sondern die erwartbare Ausfallart einer Developer Preview. Die README sagt unumwunden, dass kompatibilitätsbrechende Änderungen kommen, und ein Plugin, das gegen ein älteres Loader-Format gebaut wurde, kann nach einem Harness-Update stillschweigend nicht mehr laden. Zwei Gewohnheiten helfen: die getestete Version fixieren und nachsehen, wann ein Plugin zuletzt gepusht wurde, bevor Sie Ihre eigene Konfiguration verdächtigen — unsere Einträge zeigen dieses Datum auf jeder Plugin-Seite.

npx @deepseek-ai/dsh@<version> web

Wenn etwas wirklich kaputt und nicht bloß umbenannt ist: Das Projekt betreibt GitHub Discussions und einen Discord, und beide sind in einer Woche wie dieser aktueller, als es eine Anleitung von Dritten sein kann.

Häufige Fragen

Muss ich dsh global installieren?

Nein. Der npx-Schnellstart lädt und startet das Paket bei Bedarf, und der Weg über den Quellcode führt die CLI per pnpm im geklonten Repository aus. Weil die Preview kompatibilitätsbrechende Änderungen ausliefert, altert eine pro Projekt fixierte Version besser als ein globales Binary, dessen Installation Sie vergessen.

Ist DeepSeek Harness kostenlos nutzbar?

Der Harness selbst ist Open Source unter der MIT-Lizenz; Sie dürfen ihn gebührenfrei ausführen, verändern und weitergeben. Das Modell, auf das Sie ihn richten, ist eine andere Sache — was der jeweilige Anbieter berechnet, deckt die Harness-Lizenz nicht ab.

Warum lauscht die Web-UI auf 127.0.0.1 statt auf meiner Netzwerkadresse?

Diese Adresse ist Loopback: Die Oberfläche antwortet nur auf dem Rechner, der sie gestartet hat. Nichts in Ihrem lokalen Netz erreicht http://127.0.0.1:3080, sofern Sie nicht bewusst einen Proxy oder Tunnel davorsetzen — eine vernünftige Voreinstellung für ein Werkzeug, das auf Ihrem Rechner Befehle ausführen kann.

Kann ich dsh heute produktiv einsetzen?

Nicht gefahrlos. DeepSeek Harness ist eine am 13. August 2026 veröffentlichte Developer Preview, deren README in Großbuchstaben vor kompatibilitätsbrechenden Änderungen warnt. Behandeln Sie es als etwas zum Experimentieren und zum Plugin-Bauen, nicht als Infrastruktur, für die Sie eine Rufbereitschaft einrichten würden.

Was genau ist cordis.yml?

Es ist die Loader-Konfiguration, die festlegt, mit welchen Plugins Ihr Harness startet und wie jedes davon konfiguriert ist. Weil dsh Modelle, Tools, Skills, Sessions, Sandboxes und selbst die Oberfläche als Plugins behandelt, ist cordis.yml faktisch die Definition dessen, was Ihre Installation kann.

Wie es weitergeht

Wenn Ihnen das Plugin-Modell neu ist, beginnen Sie mit was ein Agent-Harness eigentlich ist — dort steht, warum dsh so viel hinter eine Loader-Konfiguration legt. Wenn Sie dsh gegen ein Werkzeug abwägen, das Sie schon nutzen, vergleichen wir es mit Claude Code, einschließlich der Punkte, an denen dsh erkennbar noch nicht so weit ist.