SSD Nodes Learn Hosting plans →
Anleitungen Matt ConnorVon Matt Connor · Aktualisiert 2026-11-07

DeepSeek Harness: Installations- und Versionsfehler

Die aktuelle DeepSeek-Harness-Version ist weiterhin eine Vorabversion. Fixieren Sie eine dsh-Version, leeren Sie den npx-Cache und prüfen Sie das verwendete npm.

Was die Installation von DeepSeek Harness tatsächlich ist

Die Installation von DeepSeek Harness besteht aus einem Befehl: npx @deepseek-ai/dsh web. Es gibt kein Installationsprogramm und keinen Dienst, der konfiguriert werden muss. Die meisten Probleme entstehen nicht bei der Installation. Es geht um die Versionsauflösung: Welche Version von @deepseek-ai/dsh entscheidet sich, die von npx heute ausgeführt wird, und ob Ihre Node.js-Version diese Version ausführen kann. Beim Start bindet der Dienst standardmäßig an localhost. --host und --port überschreiben die Einstellungen für den Listener. Die ausgegebene Adresse verwendet --public-url, wenn dieser Wert konfiguriert ist. Die Standardbindung und warum die Web-UI nur auf 127.0.0.1:3080 antwortet sind ein anderes Problem als die auf dieser Seite beschriebenen Probleme.

Zwei Fakten bestimmen alles Weitere. Erstens war jede bis zum 27 October 2026 auf npm veröffentlichte Version von @deepseek-ai/dsh eine Vorabversion. Die meisten davon sind Release Candidates (-rc.N). Seit dem 30 August 2026 gibt es außerdem Alpha-Versionen (-alpha.N). Der Tag latest verweist auf einen Release Candidate. Am 6 November 2026 ist das 0.2.2-rc.1. Zweitens steht in der README des Projekts, dass sich das Harness in der Developer Preview befindet, schnell weiterentwickelt wird und inkompatible Änderungen enthalten wird. Ein Flag, das letzte Woche funktioniert hat, kann diese Woche bereits entfernt worden sein. Legen Sie eine Version fest, bevor Sie darauf aufbauen.

Zunächst einige Begriffe. dsh ist das Kommandozeilenwerkzeug von DeepSeek Harness. Node.js ist die dafür benötigte JavaScript-Laufzeitumgebung. npx ist der mit npm (node package manager) ausgelieferte Paket-Runner. Er ruft ein Paket bei Bedarf ab, statt es dauerhaft zu installieren. Falls der Begriff Harness in diesem Satz ungewohnt ist: Ein Agent-Harness ist das Programm, das um das Modell herum ausgeführt wird. Es verwaltet die Schleife, die Werkzeuge, die Berechtigungen und den Sitzungsstatus. Deshalb kann eine Versionsnummer, die Sie nicht selbst ausgewählt haben, das Verhalten Ihres Agenten ändern.

Welche Node.js-Version benötigt dsh?

Am 10. Oktober 2026, als sich das Repository auf Version 0.2.1-alpha.2 befand, deklarierte die package.json im Stammverzeichnis "engines": {"node": "^22.19.0 || >=24.0.0"}. Das ist nicht mehr die Anforderung. Am 27. Oktober 2026, als sich das Repository auf Version 0.2.1-rc.3 befand, deklarierte die package.json im Stammverzeichnis "engines": {"node": ">=24.9.0"}, und der Quellcode der CLI in package.json deklarierte nun dasselbe. Eine am 15. Oktober 2026 datierte Entscheidungsnotiz des Projekts besagt, dass Installationen mit Node 22 aktualisiert werden müssen. Auch Node 24.0 reicht nicht aus, weil die Einstiegspunkte import.meta.main verwenden, das in 24.0 fehlt. Benötigt wird daher Node 24.9.0 oder neuer. Node 20 und Node 22 scheiden aus. Das gilt auch für jede Node-24-Version vor 24.9.0. Bei der Prüfung am 27. Oktober 2026 enthielten die Release-Tags für 0.2.1-rc.2, der von ihnen referenzierte Build latest und 0.2.1-rc.3 noch den alten Bereich. Die neue Mindestversion wurde erst danach festgelegt. Planen Sie trotzdem mit 24.9.0, weil dies der vom Projekt jetzt deklarierte Bereich ist.

Prüfen Sie zuerst, was bereits installiert ist.

node -v
npm -v

Hier liegt der überraschende Teil. Am 27. Oktober 2026 enthielt das veröffentlichte Paket @deepseek-ai/dsh in keiner seiner 38 Versionen bis einschließlich 0.2.1-rc.4 ein eigenes Feld engines. Das Root-Verzeichnis des Monorepos deklariert ein solches Feld, aber diese Root-Datei wird nie bei npm veröffentlicht. Der Quellcode der CLI in package.json erhielt es in einem am 15. Oktober 2026 datierten Commit. Keiner der am 27. Oktober geprüften veröffentlichten Builds enthielt es jedoch. Diese Builds gaben npm daher keine dsh-spezifische Node-Anforderung zur Prüfung. Am 6. November 2026 deklarierte das veröffentlichte Paket 0.2.2-rc.1 "engines": {"node": ">=24.9.0"}. npm behandelt engines als Hinweis, sofern Sie nicht engine-strict setzen. Mit der Standardeinstellung ist daher höchstens eine Warnung zu erwarten. Auf einer nicht unterstützten Node-Version sieht die Installation erfolgreich aus. Der Fehler tritt später auf, wenn der geladene Code eine Syntax oder API verwendet, die Ihre Laufzeitumgebung nicht unterstützt. Es gibt keine einzelne stabile Fehlermeldung, nach der Sie suchen können. Welche Zeile zuerst fehlschlägt, hängt davon ab, welches Modul zuerst geladen wird. Lesen Sie node -v, statt nur den Absturz zu untersuchen.

Wenn Ihre Node-Version zu alt ist, ist nvm (node version manager) auf einem VPS die am wenigsten invasive Lösung. nvm wird in Ihrem Home-Verzeichnis installiert und lässt die System-Node-Version unverändert.

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.6/install.sh | bash
exec $SHELL -l
nvm install 24
nvm use 24
node -v

node -v sollte jetzt eine Version ausgeben, die mit v24. beginnt. Wenn die Shell weiterhin die alte Version meldet, führen Sie which node aus. Ein Pfad außerhalb von ~/.nvm hat normalerweise eine von zwei Ursachen. Entweder wurde die nvm-Shell-Funktion nicht geladen. Öffnen Sie dann eine neue Login-Shell und versuchen Sie es erneut. Oder eine Zeile in Ihrem Shell-Profil ändert PATH nach den Zeilen, die nvm laden, und stellt eine andere Node-Version an den Anfang. Verschieben Sie diese Zeile dann vor die nvm-Zeilen. Node 24 war am 10. Oktober 2026 die aktive LTS- (long term support) Version und wechselte am 20. Oktober 2026 in den Wartungsmodus. Die neueste Version ist zum 29. Oktober 2026 24.22.2 und liegt damit deutlich über der Mindestversion 24.9.0. Node 26, das der Bereich >=24.9.0 ebenfalls zulässt, wechselte am 28. Oktober 2026 mit Version 26.13.0 in den aktiven LTS-Status. Beide Versionen erfüllen die Mindestanforderung und enthalten npm-Versionen mit der weiter unten behandelten Korrektur für den Bereichs-Cache. Die offiziellen Node-26-Linux-Binärdateien benötigen außerdem libatomic. Ihre Distribution muss dieses Paket möglicherweise separat installieren.

Warum führt npx jeden Tag eine andere Version aus?

npx @deepseek-ai/dsh web gibt keine Version an. Wenn im aktuellen Verzeichnis des Projekts nicht bereits @deepseek-ai/dsh installiert ist, fragt npx die Registry ab, auf welche Version das Tag latest derzeit zeigt. Dieses Tag ändert sich häufig. 0.1.0-rc.8 wurde am 19. August 2026 veröffentlicht, zwei Tage nach 0.1.0-rc.7. Am 10. Oktober 2026 zeigte latest auf 0.2.0-rc.2 und am 27. Oktober 2026 auf 0.2.1-rc.2. Bei jeder Änderung führt der Befehl in Ihren Notizen anderen Code aus. Es gibt dabei keine Rückfrage und kein Changelog.

Sie können alle beteiligten Komponenten über die Befehlszeile prüfen.

npm view @deepseek-ai/dsh dist-tags
npm view @deepseek-ai/dsh versions --json
npm view @deepseek-ai/dsh time --json

dist-tags zeigt, worauf latest derzeit verweist. Am 10. Oktober 2026 zeigten sowohl latest als auch next auf 0.2.0-rc.2. Ein drittes Tag, alpha, zeigte auf 0.2.1-alpha.2, das am Vortag veröffentlicht worden war. Am 27. Oktober 2026 zeigte latest auf 0.2.1-rc.2, next auf 0.2.1-rc.4, das am Vortag veröffentlicht worden war, und alpha auf 0.2.1-alpha.5. Am 6. November 2026 zeigt latest auf 0.2.2-rc.1. Am 4. November 2026 zeigte next auf 0.2.1-rc.5 und alpha auf 0.2.2-alpha.3. Das Tag latest wählt weiterhin eine Vorabversion aus. Die Liste versions ist interessanter, weil sie Lücken enthält. Am 10. Oktober 2026 umfasste sie 31 Versionen von 0.0.1-rc.1 bis 0.2.1-alpha.2. Am 27. Oktober 2026 umfasste sie 38 Versionen, die weiterhin alle Vorabversionen waren. Die Versionsreihe 0.0.1 springt von -rc.2 auf -rc.5. Die Versionsreihe 0.1.0 springt von -rc.3 auf -rc.6. Die Alpha-Builds beginnen bei 0.1.2-alpha.2 und 0.1.3-alpha.2. Ein 0.1.4 gibt es überhaupt nicht. In der veröffentlichten Liste fehlen Versionsnummern. Außerdem sind Alpha-Builds und Release Candidates in derselben Liste gemischt. Die nächste -rc.N in einem Deploy-Skript zu erraten, schlägt fehl. Lesen Sie daher die Liste, statt die Versionsnummern hochzuzählen.

Warum verwendet npx weiterhin eine alte Version?

Das ist die gegenteilige Beobachtung. Beide Fälle sind möglich. Entscheidend sind die Paketspezifikation, die lokale Installation und die verwendete npm-Version.

npx verwaltet ein eigenes Paketverzeichnis. Es liegt getrennt vom Tarball-Cache in einem Ordner namens _npx innerhalb des npm-Cache. Geben Sie den Pfad aus und prüfen Sie ihn.

npm config get cache
ls "$(npm config get cache)/_npx"

npm 10.9.3 prüft die Registry bereits außerhalb einer Projektinstallation auf einen einfachen Paketnamen. npm 11.2.0 hat die Prüfungen zur Cache-Aktualität für Versionsbereiche geändert. Wenn die Spezifikation nur aus einem Paketnamen besteht und das Paket im aktuellen Projekt noch nicht installiert ist, ruft npx das Manifest mit preferOnline: true ab. Die zwischengespeicherte Kopie in _npx wird nur wiederverwendet, wenn der aufgelöste Tarball dem von der Registry zurückgegebenen Tarball entspricht. Ein einfacher Paketname verwendet weiterhin die Version, die im aktuellen Projekt installiert ist, ohne die Registry zu prüfen. Bei einem Versionsbereich akzeptiert npm 10.9.3 eine passende Version aus dem Cache. npm 11.2.0 und neuer prüft zusätzlich, ob der Bereich inzwischen auf eine neuere Version verweist.

Das Verhalten hängt von der tatsächlich ausgeführten npm-Version ab. Wenn Sie npm nicht separat mit npm install -g npm aktualisiert haben, ist dies die npm-Version, die Ihre Node-Version mitliefert:

  • Node 20.20.2 liefert npm 10.8.2 mit.
  • Node 22.19.0 liefert npm 10.9.3 mit.
  • Node 22.23.4, die neueste 22-Version am 27 October 2026, liefert npm 10.9.9 mit.
  • Node 24.9.0, die aktuelle Mindestversion des Harness, liefert npm 11.6.0 mit.
  • Node 24.19.0 liefert npm 11.17.0 mit.
  • Node 24.22.2, die neueste 24-Version am 29 October 2026, liefert npm 11.19.1 mit.
  • Node 26.13.0, die neueste 26-Version am 29 October 2026, liefert npm 11.20.0 mit.

Die gesamte Node-22-Reihe liefert daher eine ältere npm-Version als 11.2.0 mit. Das Harness unterstützte Node 22 bis Mitte October 2026 und unterstützt es inzwischen nicht mehr. Ein Server, auf dem dsh vorher ausgeführt wurde, kann jedoch weiterhin diese Version verwenden. Die mit Node 22.19.0 gelieferte npm-Version 10.9.3 prüft einen einfachen npx @deepseek-ai/dsh web außerhalb einer Projektinstallation bereits erneut gegen die Registry. Ein alter _npx-Eintrag allein erklärt daher keinen alten Release-Kandidaten. Jede Node-Version, die das Harness derzeit akzeptiert, also ab 24.9.0, liefert npm 11.6.0 oder neuer mit. Damit ist auch die Korrektur für den Cache von Versionsbereichen enthalten. Eine Projektinstallation kann weiterhin Vorrang haben. Fragen Sie das Tool selbst ab:

npx @deepseek-ai/dsh --version

Leeren des npx-Cache

Ab npm 11.2.0 gibt es dafür eigene Unterbefehle.

npm cache npx ls
npm cache npx rm --force

Ohne --force verweigert npm das vollständige Löschen und gibt Please use --force to remove entire npx cache aus. Verwenden Sie zuerst npm cache npx ls, wenn Sie einen einzelnen Eintrag anhand seines Schlüssels statt alle Einträge entfernen möchten.

Unter npm 10 sind diese Unterbefehle nicht vorhanden. Löschen Sie das Verzeichnis daher selbst.

rm -rf "$(npm config get cache)/_npx"

npm cache clean --force hilft hier nicht. Der Befehl leert _cacache, den Tarball-Speicher, und lässt _npx unverändert. Genau diese Trennung war der Grund, weshalb npm später die Unterbefehle npm cache npx ergänzt hat. Das Leeren von _npx hat außerdem keine dauerhaften Nachteile. Dort liegen heruntergeladene Pakete. Der Zustand Ihres Harness liegt getrennt unter $DSH_HOME, einschließlich profiles/<name>, sessions, storages und .credentials.yaml, und bleibt unverändert.

Wie pinne ich einen bestimmten Release Candidate?

Geben Sie die vollständige Versionszeichenfolge einschließlich des Teils -rc.N an.

npx --yes @deepseek-ai/dsh@0.1.0-rc.7 web

Die Beispiele auf dieser Seite verwenden 0.1.0-rc.7. Ersetzen Sie ihn durch den Build, den Sie tatsächlich getestet haben. Am 27. Oktober 2026 verwies der Tag latest auf 0.2.1-rc.2.

--yes bestätigt die Paketinstallation durch npx ohne interaktive Eingabeaufforderung.

Eine exakte Version pinnt das Paket dsh, garantiert jedoch keinen Offline-Start. npx legt sein Cache-Verzeichnis anhand der eingegebenen Spec-Zeichenfolge fest und kann eine dort bereits installierte exakte Version wiederverwenden. Wenn keine passende lokale Installation vorhanden ist, ruft die vorangehende Prüfung des lokalen Verzeichnisbaums das Manifest mit preferOnline: true ab, bevor sie _npx prüft. Eine passende exakte Version im lokalen Projekt verhindert diesen Manifest-Abruf. Auch ein außerhalb eines Projekts ausgeführter unqualifizierter Name, der dsh installiert, löst einen Manifest-Abruf aus, einschließlich unter npm 10.9.3.

Eine globale Installation wird auf dieselbe Weise gepinnt und ermöglicht einen kurzen Befehl.

npm install -g @deepseek-ai/dsh@0.1.0-rc.7
dsh --version

Keine passende Version für @deepseek-ai/dsh@^0.1.0 gefunden

Am 27. Oktober 2026 schlug ein einfacher Caret- oder Tilde-Bereich für dieses Paket fehl. npm install -g @deepseek-ai/dsh@^0.1.0 antwortete mit dem Fehlercode ETARGET und der Zeile No matching version found for @deepseek-ai/dsh@^0.1.0.. Die Registry ist in Ordnung. Dies ist eine semver-Regel: Ein Versionsbereich passt nicht zu einer Pre-Release-Version, sofern nicht einer der eigenen Vergleichsoperatoren des Bereichs eine Pre-Release-Version mit denselben Major-, Minor- und Patch-Nummern angibt. Jeder bis zum 27. Oktober 2026 veröffentlichte Build dieses Pakets war eine Pre-Release-Version, entweder -rc.N oder -alpha.N, und ^0.1.0 gab keine an. Daher passte der Bereich zu keiner Version. Geben Sie die exakte Version an.

Diese Regel wirkt in beide Richtungen. Ein einfacher Bereich wechselt nie automatisch zu einem neuen Release Candidate. Ein Bereich, der eine Pre-Release-Version angibt, kann dies jedoch tun. ^0.1.0-rc.7 bedeutet >=0.1.0-rc.7 <0.2.0-0. Daher akzeptiert er 0.1.0-rc.8 und würde auch ein endgültiges 0.1.0 akzeptieren, während 0.1.1-rc.1 ausgeschlossen bleibt, weil seine Nummern abweichen. Das ist ein teilweise gepinnter Zustand zwischen einer exakten Version und einem veränderlichen Tag. Dadurch kann sich ändern, was ausgeführt wird, ohne dass Sie etwas ändern. Wenn Sie genau den getesteten Build und keinen anderen verwenden möchten, geben Sie die exakte Version an.

Sollten Sie npx verwenden oder dsh global installieren?

Verwenden Sie npx für einen ersten Test, weil das Paket in einem Cache-Verzeichnis bleibt, dessen Inhalt Sie nun löschen können. Für alles, was nach einem Reboot weiterhin funktionieren muss, verwenden Sie eine global installierte, versionierte Variante, etwa einen Coding-Agent, den Sie auf einem VPS dauerhaft ausführen.

Auf einem System, auf dem Sie beides verwendet haben, können sich die beiden Varianten unterscheiden. Vergleichen Sie sie daher.

which dsh
dsh --version
npx @deepseek-ai/dsh --version

which dsh Wenn direkt nach einer erfolgreichen globalen Installation nichts gefunden wird, fehlt fast immer das globale Bin-Verzeichnis von npm in Ihrer PATH. Führen Sie npm prefix -g aus, um das Root-Verzeichnis auszugeben. Die Binärdateien befinden sich im Verzeichnis bin darunter.

Ein Hinweis zur Sicherheit: npx lädt Code aus der Registry und führt ihn aus, sobald es etwas Neues auflöst. Auf einem Server ist das ein konkretes Risiko und keine rein theoretische Bedrohung. Versionen festzuschreiben, ist ein Teil der Lösung. Weitere Informationen finden Sie unter wie Angriffe auf die npm-Lieferkette einen Server erreichen.

Was die Developer Preview für die Reproduzierbarkeit bedeutet

0.1.0-rc.6 wurde am 13. August 2026 veröffentlicht und 0.1.0-rc.7 am 17. August 2026. Dazwischen lagen vier Tage. Seitdem hat sich das Tempo nicht verlangsamt: Zwischen dem 19. August und dem 9. Oktober 2026 wurden 24 weitere Versionen veröffentlicht, darunter 0.2.0-rc.1 am 28. September und 0.2.0-rc.2 am folgenden Tag. Zwischen dem 14. und dem 26. Oktober 2026 folgten sieben weitere Versionen, zuletzt 0.2.1-rc.4. Bei diesem Tempo können Anleitungen, die vor einem Monat geschrieben wurden, eine Befehlszeile beschreiben, die nicht mehr existiert. Das gilt auch für diese Seite. Datieren Sie jede Versionsangabe, die Sie notieren, einschließlich Ihrer eigenen Notizen.

Zwei Gewohnheiten machen die Preview beherrschbar. Geben Sie in jedem Befehl und in jedem Skript die exakte Version an, damit der Wiederaufbau eines Servers dieselbe dsh-Version auswählt. Dadurch werden die Abhängigkeiten allein noch nicht reproduziert: Das veröffentlichte 0.2.2-rc.1-Paket verwendet Bereiche wie js-yaml: ^4.3.2 und commander: ^15.0.0 und wird ohne npm shrinkwrap ausgeliefert. Für reproduzierbare Installationen der Abhängigkeiten sollten Sie dsh in einem lokalen Projekt mit einer versionierten package-lock.json verwalten und den Wiederaufbau mit npm ci durchführen. Lesen Sie anschließend die Hilfeausgabe des festgelegten Builds und nicht die einer beliebigen Anleitung.

npx @deepseek-ai/dsh@0.1.0-rc.7 --help
npx @deepseek-ai/dsh@0.1.0-rc.7 web --dump-config

Die zweite Hälfte der Reproduzierbarkeit ist das Profil. dsh --profile <name> startet das unter $DSH_HOME/profiles/<name> gespeicherte Profil. Die Profile web und headless werden bei der ersten Verwendung aus den mitgelieferten Vorlagen erstellt. Der Profil-Patch kann Modell- und Endpunkteinstellungen enthalten. Gespeicherte API-Schlüssel liegen jedoch in $DSH_HOME/.credentials.yaml, während die Einstellungen Verweise auf Zugangsdaten enthalten. Eine festgelegte Version und eine funktionierende Konfiguration sind daher zwei getrennte Dinge, die korrekt eingerichtet werden müssen. Patches auf Home-Ebene und in der Befehlszeile können die Profileinstellungen überschreiben. Die enthaltenen Bundles werden aus der aktuell ausgeführten dsh-Installation aufgelöst. Wenn Sie die festgelegte Version ändern, ändern sich daher auch diese Bundles. Plugins außerhalb des Quellbaums verhalten sich anders. Sie liegen im Profilverzeichnis, und dsh plugin --profile <name> add <package> leitet seine Argumente an pnpm weiter, um sie zu installieren. pnpm muss daher in Ihrem PATH vorhanden sein. dsh weist ausdrücklich darauf hin, wenn dies nicht der Fall ist. Jedes hinzugefügte Plugin läuft mit denselben Berechtigungen wie Ihr Agent. Daher sollten Sie prüfen, auf welche Ressourcen ein Plugin zugreifen kann, bevor Sie es installieren. Das package.json des Profils selbst deklariert diese Plugins. Bewahren Sie dessen pnpm-lock.yaml auf und verwenden Sie pnpm install --frozen-lockfile, um auch die Versionen ihrer Abhängigkeiten zu reproduzieren.

Diese Aufteilung ist vertraut, wenn Sie Python-Tools in isolierten Umgebungen auf einem Server verwaltet haben: Das Tool und die hinzugefügten Komponenten werden an getrennten Stellen festgelegt. Sobald die Laufzeitumgebung startet, geht es bei der nächsten Frage meist um das Netzwerk und nicht um Versionen. An diesem Punkt helfen der Zugriff auf die dsh-Weboberfläche auf einem entfernten VPS und die ausführlichere Anleitung DeepSeek Harness auf einem VPS installieren weiter.

Argumentfehler, die tatsächlich auftreten

Diese Fehler stammen aus dem eigenen CLI-Parser. Jeder Fehler benennt das genaue Problem. Die Formulierungen sind über die Builds hinweg weitgehend gleich geblieben, aber nicht vollständig. Die folgenden Meldungen wurden am 6. Oktober 2026 mit 0.2.0-rc.2 geprüft.

error: --profile <name> is required

Sie haben npx @deepseek-ai/dsh ohne Subcommand und ohne Profil ausgeführt. Der Befehl ohne weitere Argumente startet ein Profil und benötigt daher einen Namen. dsh web funktioniert ohne --profile, weil der Parser das erste einzelne Wort als Profilnamen interpretiert. Dadurch startet er für Sie das mitgelieferte Profil web.

error: --patch needs a path

--patch wurde ohne nachfolgenden Wert übergeben. Das Flag kann mehrfach angegeben werden. Jede Angabe erwartet einen Dateipfad.

error: --dump-config and --dump-default-config are mutually exclusive

Wählen Sie eine der beiden Optionen. In 0.2.0-rc.2, auf das der Build latest am 6. Oktober 2026 zeigte, nennt die Meldung ein drittes Flag und lautet error: --dump-config, --dump-default-config, and --dump-config-schema are mutually exclusive, weil --dump-config-schema inzwischen zu den beiden anderen Optionen hinzugekommen ist. Dieses Flag gibt das JSON Schema für Profileinträge und Patches aus. --dump-default-config gibt die mitgelieferten Bundle-Ebenen aus und akzeptiert kein --patch. --dump-config gibt die zusammengesetzte Konfiguration eines Profils aus. Keine dieser drei Optionen startet den Harness. Das Erfassen des Schemas importiert jedoch Plugin-Module und kann Getter sowie Lazy Builder aufrufen. Prüfen Sie daher nur vertrauenswürdige Plugins und setzen Sie in Skripten ein externes Timeout.

error: plugin needs pnpm arguments to forward (e.g. add <package>)

dsh plugin --profile <name> wurde ohne Argumente zur Weitergabe ausgeführt. Das Subcommand initialisiert das Profil, falls es fehlt, und übergibt anschließend den restlichen Befehlszeileninhalt an pnpm. Daher benötigt es Argumente wie add @scope/dsh-plugin-example.

FAQ

Welche Node.js-Version benötigt DeepSeek Harness?

Node.js 24.9.0 oder neuer. Am 27. Oktober 2026 erklärte das Repository in Version 0.2.1-rc.3 in seinem Root-package.json den Wert >=24.9.0. Am 10. Oktober 2026 lautete der Wert noch ^22.19.0 || >=24.0.0. Eine Projektnotiz vom 15. Oktober 2026 entfernte jedoch Node 22 aus dem unterstützten Bereich und setzte die Mindestversion über 24.0. Node 20 und Node 22 funktionieren nicht. Ebenso funktioniert keine Node-24-Version vor 24.9.0. Am 27. Oktober 2026 enthielt kein veröffentlichtes npm-Build ein eigenes Feld engines. npm konnte daher nicht anhand der eigenen Node-Anforderung von dsh warnen oder die Installation blockieren. Eine nicht unterstützte Laufzeit schlug stattdessen erst später fehl. Das am 6. November 2026 geprüfte veröffentlichte Paket 0.2.2-rc.1 enthält jetzt in engines.node den Wert >=24.9.0. npm warnt standardmäßig und verweigert eine inkompatible Laufzeit, wenn engine-strict aktiviert ist. Prüfen Sie zuerst node -v. Jede Node-Version, die die Mindestanforderung erfüllt, enthält npm 11 oder neuer. Damit ist auch die in npm 11.2.0 eingeführte Korrektur für den npx-Range-Cache enthalten.

Wie zwinge ich npx dazu, die neueste dsh-Version statt einer zwischengespeicherten Version zu verwenden?

npm 10.9.3 und aktuelle npm-Versionen prüfen bei einem einfachen Paketnamen bereits erneut die Registry. Eine Ausnahme besteht, wenn das aktuelle Verzeichnis ein Projekt mit installiertem dsh ist. In diesem Fall führt npx die lokale Kopie aus. Verwenden Sie npx @deepseek-ai/dsh@latest --version, um ausdrücklich das latest-Tag der Registry anzufordern. npm 11.2.0 änderte die Aktualitätsprüfung für Versionsbereiche, nicht für einfache Paketnamen. Leeren Sie den npx-Cache mit npm cache npx rm --force unter npm 11.2.0 und neuer. Unter npm 10 löschen Sie den Ordner mit rm -rf "$(npm config get cache)/_npx". Bestätigen Sie das Ergebnis anschließend mit npx @deepseek-ai/dsh --version. Beachten Sie, dass npm cache clean --force ein anderes Verzeichnis leert und dieses Problem nicht behebt.

Warum schlägt die Installation von @deepseek-ai/dsh@^0.1.0 fehl?

Am 27. Oktober 2026 gab npm den Fehlercode ETARGET mit der Zeile No matching version found for @deepseek-ai/dsh@^0.1.0. zurück. Jeder bei dieser Prüfung veröffentlichte Build war eine Vorabversion, etwa 0.2.0-rc.2 oder 0.2.1-alpha.2. Ein semver-Versionsbereich erfasst keine Vorabversionen, sofern der Versionsbereich nicht selbst eine Vorabversion mit denselben Major-, Minor- und Patch-Nummern nennt. Installieren Sie die exakte Versionszeichenfolge einschließlich des Suffixes. Führen Sie npm view @deepseek-ai/dsh versions --json aus, um die verfügbaren Versionen anzuzeigen, da die Versionsfolge Lücken enthält.

Sollte ich dsh global installieren oder über npx ausführen?

npx eignet sich für einen ersten Test, da das Paket in seinem Cache-Verzeichnis verbleibt. Das Harness legt außerdem einen dauerhaften Profilstatus an. Eine festgelegte globale Installation wie npm install -g @deepseek-ai/dsh@0.1.0-rc.7 eignet sich für alles, was dauerhaft funktionieren muss. Die Version ändert sich dann nur, wenn Sie sie selbst ändern. Wenn der Befehl dsh nach einer globalen Installation nicht gefunden wird, fehlt das globale Bin-Verzeichnis von npm in Ihrer PATH. npm prefix -g gibt das darübergeordnete Root-Verzeichnis aus.

Ist DeepSeek Harness stabil genug für den Aufbau darauf?

Nach eigener Beschreibung noch nicht. Die README erklärt, dass sich das Projekt in einer Developer Preview befindet, schnell weiterentwickelt wird und inkompatible Änderungen enthalten wird. Die Release Candidates 0.1.0-rc.6 und 0.1.0-rc.7 wurden im August 2026 im Abstand von vier Tagen veröffentlicht. 0.2.0-rc.1 und 0.2.0-rc.2 folgten im September 2026 im Abstand von einem Tag. 0.2.1-rc.1 und 0.2.1-rc.2 wurden im Oktober 2026 am selben Tag veröffentlicht. Auch der unterstützte Node-Bereich änderte sich im Oktober 2026. Fixieren Sie eine exakte Version und lesen Sie --help aus diesem fixierten Build statt aus irgendeiner Anleitung. Datieren Sie Ihre eigenen Notizen, damit Sie erkennen können, wie veraltet sie inzwischen sind.

War dieser Artikel hilfreich?