DeepSeek Harness Desktop-App: Was der Installer tatsächlich auf Ihrem Rechner ablegt

Die DeepSeek Harness Desktop-App ist eine Electron-Hülle um dieselbe Weboberfläche, die Sie mit folgendem Befehl erhalten: npx @deepseek-ai/dsh web, und sie wird als drei plattformspezifische Installer für ein Harness ausgeliefert, das derzeit Version 0.2.1-rc.2 hat. Diese Beschreibung klingt abwertend, und das ist nicht beabsichtigt. Eine funktionierende Oberfläche in einen Desktop-Container zu packen, ist Arbeit für ein Wochenende; sie in einen Container zu packen, der sein eigenes Laufzeitverzeichnis besitzt, Ihre Aufgaben am Leben hält, wenn Sie das Fenster schließen, sich selbst über einen Kanal aktualisiert, auf dem es keine stabile Version gibt, und Ihre Sitzungen über all diese Vorgänge hinweg bewahrt – das ist der Teil, der Monate dauert, und der Teil, über den es sich zu lesen lohnt. Wenn Sie DeepSeek-V4.1-Flash über ein Harness ausführen möchten, das in einem Fenster statt in einem Terminal lebt, dann ist dies dieser Build, und die interessanten Fragen drehen sich alle darum, was rund um das Fenster passiert.

Zwei Dinge müssen vor den Details gesagt werden. Erstens: Dieser Artikel ersetzt unsere frühere Aussage, dass es keine Desktop-App gebe – diese Aussage war im August 2026, als sie verfasst wurde, korrekt, und sie ist jetzt falsch. Zweitens: Dies ist eine öffentliche Vorschau, die auf DeepSeeks eigener Website noch immer so bezeichnet wird, und das Paket hat die rauen Kanten, die diese Bezeichnung impliziert. Der Installer funktioniert. Die Distribution darum herum ist dünner, als man vermuten würde.

Was der Desktop-Build eigentlich ist

Die Desktop-Anwendung ist eine dünne Electron-Schicht, deren Aufgabe es ist, einen Host-Prozess zu starten und ein Fenster darauf zu richten. Das Fenster bringt keine eigene Chat-Oberfläche mit: Es lädt den mitgelieferten, in der App gebündelten Web-Einstiegspunkt unter dsh-app://app/, und die Update-Dialoge, die Sie sehen, stammen von einem zweiten gebündelten Origin unter dsh-app://shell/. Ein untergeordneter Node-Prozess wird im RunAsNode-Modus von Electron gestartet, um den gemeinsamen Profil-Runner zu starten, und die Shell leitet HTTP an den authentifizierten Web-Host weiter und entfernt dabei die transfer-encoding, connection und keep-alive-Header. Antworten von Plugin-Bundles werden mit no-storegekennzeichnet – ein kleines Detail mit sichtbarer Folge: Ändern Sie ein Plugin, so zeigt das nächste Neuladen die Änderung.

Da die URL dsh-app:// statt localhost ist, gibt es keinen festen Port, den man sich merken muss, und keinen Portkonflikt, der umgangen werden müsste. Der Desktop-Host lauscht standardmäßig an einem vom Betriebssystem zugewiesenen Port. Wenn Sie einen bestimmten benötigen, können Sie ihn über einen webserver.config.port-Override festlegen, aber der Standardwert ist bewusst keine Konstante, und der Host bindet an 127.0.0.1. Das ist wichtig, wenn Sie älteren Anweisungen gefolgt sind: Die Zahl 19387, die in Installationsanleitungen vom August kursierte, ist nicht der Desktop-Port, und wenn Sie sie als Desktop-Port behandeln, werden Sie nach einem Dienst suchen, der nicht existiert.

Die Versionsfixierung ist strenger, als es zunächst den Anschein hat. Electron und @deepseek-ai/dsh tragen immer exakt dieselbe Version – keine Spanne, keine kompatible Hauptversion –, sodass ein Upgrade des Harness ein Desktop-Release ist und es keine unterstützte Kombination aus einem neuen dsh und einem alten Fenster gibt. Der Electron-Prozess nimmt eine prozesslebenslange Single-Instance-Sperre an und besitzt exklusiv $DSH_HOME/profiles/desktop. Diese Exklusivität ist real: Die CLI kann dieses Profil nicht booten, und ein per npm installiertes dsh kann es nicht verändern. Was die beiden Installationen teilen, ist der Zustand, der für Sie zählt – Sitzungen, Einstellungen, Anmeldedaten, Workspaces und Speicher, alles unter $DSH_HOME. Was sie nicht teilen, sind ausführbare Pakete, Plugin-Aktivierung, Lockfiles oder node_modules, weshalb die Installation eines Plugins in das Desktop-Profil nicht derselbe Vorgang ist wie die Installation in das CLI-Profil.

Drei Installer, ein Update-Kanal, keine stabile Version

Es existieren drei Installer, und alle drei antworten. Die 64-Bit-Executable für Windows ist 289.385.456 Byte groß und wird mit HTTP 200 ausgeliefert. Das Apple-Silicon-Datenträgerabbild ist 264.990.950 Byte groß, ebenfalls 200. Das Datenträgerabbild für Intel-Macs ist 289.480.824 Byte groß, ebenfalls 200. Alle drei wurden zuletzt am 17. Oktober 2026 geändert. Nur zwei davon sind von der Download-Seite aus verlinkt. Der Intel-Build ist live und erreichbar, und auf deepseek.com/en/harness/ gibt es nirgendwo einen Link, der darauf verweist — wenn Sie auf einem Intel Mac sind und der Seite gefolgt sind, würden Sie mit gutem Grund zu dem Schluss kommen, dass es für Sie keinen Build gab.

Der Intel-Build hinkt ebenfalls eine Version hinterher. Sein Update-Feed listet 0.2.1-rc.1 auf; die Feeds für Windows und Apple Silicon listen beide 0.2.1-rc.2 auf. Ein Release Candidate ist keine große Lücke bei den Funktionen, aber er ist ein echtes Signal dafür, welche Ziele zuerst gebaut und welche zuletzt verifiziert werden, und genau so etwas möchte man wissen, bevor man seine Arbeitssitzungen an eine Plattform bindet.

Bei den Update-Kanälen wird die Vertriebsgeschichte dünn. Die Feeds liegen pro Ziel unter /dsh-desk/feeds/<target>/ auf demselben Host. Windows x64 löst nightly.yml auf; beide macOS-Ziele lösen nightly-mac.yml auf. Fragt man eines der drei nach latest.yml oder latest-mac.yml, bekommt man ein 404 — es gibt keinen Stable-Kanal, keinen Beta-Kanal und keine Möglichkeit, sich vom einzig existierenden abzumelden. DeepSeeks eigene Veröffentlichungshinweise bestätigen diese Regelung, statt ihr zu widersprechen: Jede Veröffentlichung publiziert einen Nightly-Feed, und nur stabile Releases publizieren einen latest-Feed, der auf dieselben Artefakte verweist. „Nightly“ ist in diesem Zusammenhang ein Kanalname und keine Build-Kadenz — die Windows- und die Apple-Silicon-Feeds liefern beide denselben Build 0.2.1-rc.2 vom 17. Oktober, wobei das Windows-Paket mit 09:22 UTC und das Apple-Silicon-Paket mit 09:57 UTC zeitgestempelt ist. Man erhält also die Maschinerie des automatischen Updaters, gejittertes Polling, Backoff bis zu einer Obergrenze von einer Stunde — und keine Möglichkeit, etwas anderes anzufordern als das, was der Preview-Kanal gerade enthält.

GitHub unterstreicht denselben Punkt aus einem anderen Blickwinkel. Das deepseek-ai/deepseek-harness-Repository – 256.559 Sterne und 30.921 Forks, als es am 21. Oktober 2026 gelesen wurde – hatte am selben Datum 31 Releases, jedes davon als Prerelease gekennzeichnet und jedes davon ohne angehängte Binärdateien. Nichts auf der Releases-Seite lässt sich herunterladen. Wer einen Build will, bekommt ihn von download.deepseek.com oder von npm, wo @deepseek-ai/dsh derzeit latest auf 0.2.1-rc.2 auflöst. Das Repository ist eine Quelle der Wahrheit für das Changelog und eine Sackgasse für das Artefakt – ungewöhnlich genug, um es klar zu sagen, denn beim Anblick von 31 Releases erwartet man instinktiv einen Installer bei einem davon.

Was der Installer schreibt und was er nicht anrührt

Der Windows-Installer ist ein natives NSIS-Paket, kein Wrapper um eine MSI, und er verhält sich auch so. Sie erhalten helle, dunkle und automatische Paletten – bei der Installation auswählbar mit /THEME=light, /THEME=dark oder /THEME=auto –, ein editierbares Zielverzeichnis und einen Installationsbereich, der auf den aktuellen Benutzer beschränkt ist. Laufwerkswurzeln werden als Ziele abgelehnt, und ein nicht leeres Ziel wird nur akzeptiert, wenn es bereits eine registrierte Installation ist, wobei der Installer sich weigert, einen fremden Ordner zu überschreiben. Bei einem Update wartet der Silent-Pfad bis zu zehn Sekunden darauf, dass die laufende Anwendung beendet wird, und bricht dann mit Exit-Code 2 ab, wenn sie noch läuft. Das ist ein ehrlicher Fehlschlag statt einer beschädigten Installation, und er wird in jeder skriptgesteuerten Bereitstellung auftauchen, die die App nicht vorher beendet.

Das Deinstallationsprogramm zieht die Grenze, an der die meisten Deinstallationsprogramme scheitern. Es entfernt das Electron-userData-Verzeichnis, das Produktverzeichnis unter %APPDATA% und den Updater-Cache unter %LOCALAPPDATA%. Das Harness-Home – ~/.dsh bzw. der Pfad, auf den DSH_HOME zeigt – bleibt unangetastet; dort liegen Sitzungen, Einstellungen, Zugangsdaten und Plugins. Wird --updated oder /KEEP_APP_DATA übergeben, bleiben auch die Electron-Daten erhalten. Deinstallieren und Neuinstallieren ist also ein unterstützter Weg, ein defektes Fenster zu reparieren, ohne dass Arbeit verloren geht – und das ist eine bewusste Designentscheidung und kein Versehen.

Die mitgelieferten Runtimes sind erwähnenswert, weil sie groß sind und außerhalb des App-Verzeichnisses liegen. Die Installation von Python mit numpy, pandas, python-docx, python-pptx, openpyxl, Pillow, lxml und XlsxWriter sowie Node und pnpm erfolgt unter $DSH_HOME/dsh-runtimes/dsh-primary-runtime – normalerweise ~/.dsh/... auf beiden Plattformen –, wenn ein Workspace zum ersten Mal angibt, dass er sie benötigt. Deshalb entspricht der Speicherplatzbedarf nach einer Woche Nutzung nicht dem Speicherplatzbedarf nach der Installation, und deshalb bleiben bei einer Deinstallation, die $DSH_HOME beibehält, auch mehrere hundert Megabyte an Runtimes erhalten.

Einstellungen werden beim Start einmalig aus desktop/settings.json im Electron-userData-Verzeichnis gelesen, was unter Windows %APPDATA%\@deepseek-ai\dsh-desktop\desktop\settings.json und unter macOS ~/Library/Application Support/@deepseek-ai/dsh-desktop/desktop/settings.json bedeutet. DSH_HOME verlegt diese Datei nicht — ein Punkt, der Erwähnung verdient, denn sie ist der einzige Konfigurationsteil, der nicht der Variable folgt, der alles andere folgt. Die Update-Einstellungen in dieser Datei sind in Millisekunden angegeben: intervalMs ist standardmäßig 600.000, und maxBackoffMs ist standardmäßig 3.600.000 und muss mindestens intervalMs betragen. Jitter ist standardmäßig 0,2, wird auf einen Bereich von null bis eins begrenzt und hat eine Untergrenze von einer Sekunde, während er die Backoff-Obergrenze nie überschreitet. Für HTTP-Verkehr zu Updates gilt eine Inaktivitätsfrist von 60.000 Millisekunden pro Verbindung, wobei ein aktiver Download keine Gesamtdauerfrist hat — eine langsame Verbindung wird nicht mitten im Download abgebrochen.

Das Schließen des Fensters beendet die Anwendung nicht.

Auf beiden Plattformen wird das Fenster beim Schließen ausgeblendet. Unter macOS ist das Command-W; unter Windows ist es die Schließen-Schaltfläche, Alt-F4oder „Schließen“ in der Taskleiste. Windows verlangt vor dem ersten Ausblenden eine Bestätigung und schreibt ein background-close-confirmed-Flag in das Electron-userData-Verzeichnis, sodass es nur einmal fragt und nicht jedes Mal. Windows behält außerdem während der gesamten Laufzeit ein Tray-Symbol bei. macOS bringt überhaupt kein Menüleisten-Symbol mit, wodurch der ausgeblendete Zustand dort wirklich unsichtbar ist – die App läuft, Aufgaben laufen, und nichts auf dem Bildschirm verrät das, bis man sie je nach Plattform mit dsh://open oder über das Tray wieder öffnet.

Was das Ausblenden überlebt, ist der nützliche Teil. Laufende Aufgaben laufen weiter, und beim nächsten Anzeigen des Fensters zeigt es dasselbe Dokument mit derselben Sitzung, denselben Entwürfen und derselben Scrollposition. Dies unterscheidet sich von einem Browser-Tab, den man schließt und erneut öffnet, und ist der Grund, warum der Desktop-Build überhaupt lohnt, wenn Ihre Arbeit lang andauernde Agentenaufgaben umfasst: Sie können das Fenster schließen und die Aufgabe zu Ende laufen lassen.

Das Beenden ist eine separate Aktion mit eigener Logik. Vor dem Beenden prüft die Shell den Host auf laufende Agenten – einschließlich Unteragenten und Agenten, die auf eine Genehmigung warten –, in der Warteschlange befindliche Nachrichten, Jobs, die laufen oder gerade gestoppt werden, sowie aktivierte geplante Erinnerungen. Wenn nichts davon vorhanden ist, wird stillschweigend beendet. Falls doch, erscheint ein nativer Bestätigungsdialog mit dem Titel DeepSeek Harness beenden? und einer von drei Erklärungen, je nachdem, was gefunden wurde: Aufgaben werden unterbrochen, geplante Aufgaben werden nicht ausgeführt oder beides. Ein Host, der nie den Status „bereit“ erreicht hat, kann keine Aufgaben gestartet haben, daher erfolgt das Beenden in diesem Zustand ohne Rückfrage. Der Unterschied zwischen „Schließen“ und „Beenden“ ist der Kern des Designs, und er gilt auf beiden Plattformen, obwohl nur eine von ihnen ein dauerhaftes Symbol anzeigt.

Der dsh-Befehl und die Reihenfolge, auf die es ankommt

Der Installer kann dsh zu Ihrem PATH hinzufügen, wodurch Sie die CLI gegen dasselbe Harness-Home ausführen können, das die Desktop-App verwendet. Der Menüpunkt ist dsh-Befehl verwalten…, und er befindet sich direkt unter Nach Updates suchen… im Menü, mit drei Aktionen: Installieren, Reparieren und Entfernen. Unter macOS schreibt er einen Launcher nach /usr/local/bin/dsh und fordert bei Bedarf eine Administratorautorisierung an; unter Windows registriert er den Befehl im PATH des aktuellen Benutzers.

Zwei Regeln zur Reihenfolge sind leicht zu übersehen und ärgerlich, wenn sie erst im Nachhinein auffallen. Die erste: Führen Sie Remove aus, bevor Sie die Desktop-Anwendung deinstallieren, weil das Deinstallationsprogramm die dsh-Registrierung nicht entfernt. Wenn Sie zuerst deinstallieren, bleibt ein PATH-Eintrag zurück, der auf eine Binärdatei verweist, die nicht mehr existiert. Die zweite: Wenn Sie die Anwendung an einen anderen Ort verschieben, verwenden Sie unter macOS „Repair“ oder unter Windows „Install“ vom neuen Ort aus, statt anzunehmen, dass die Registrierung der App folgt.

Die Plugin-Verwaltung für das Desktop-Profil hat ihre eigene Besonderheit. Da Electron ausschließlich $DSH_HOME/profiles/desktop besitzt, solange es läuft, ist das Installieren in dieses Profil nichts, was man bei geöffneter App erledigt. Die unterstützte Vorgehensweise ist, die Desktop-App einmal zu starten, sie zu beenden und dann dsh plugin --profile desktop add <package> über die Befehlszeile auszuführen. Das Paket landet im Desktop-Profil und ist beim nächsten Öffnen des Fensters aktiv.

Was Ihnen die Verpackung bereits verrät, ist unvollendet.

Der Abschnitt zu bekannten Einschränkungen in der README ist ungewöhnlich offen, und zwei ihrer Einträge werden Sie zuerst betreffen.

• Die Kontoanmeldung ist nicht verbunden. Die Schaltfläche „Anmelden“ ist deaktiviert. Stattdessen öffnet der erste Start ein 600 mal 700 Pixel großes Begrüßungsfenster mit einem API-Schlüssel-Formular; „Speichern und fortfahren“ schreibt den Schlüssel in den Speicher für Entwicklungs-Anmeldeinformationen, und „Später einrichten“ öffnet den tatsächlichen Arbeitsbereich, ohne einen zu speichern. Wenn Sie dort, wo sie angezeigt wird, auf „Anmelden“ drücken, öffnet sich die konfigurierte Plattformseite in Ihrem Systembrowser, wobei der Host den PKCE-Austausch und einen temporären Loopback-Callback übernimmt – die technische Infrastruktur ist vorhanden, die Kontobindung nicht. Rechnen Sie praktisch damit, einen Schlüssel mitzubringen.

• Release-Signierung und Notarisierung sind als Vorgänge aufgeführt, die die Produktions-Release-Umgebung voraussetzen. Hier ist das README vorsichtig, und zugleich ist es der Punkt, an dem eine Messung nützlicher ist als ein Satz. Die veröffentlichte Windows-Executable trägt eine gültige Authenticode-Signatur mit einer Extended-Validation-Kette: GlobalSign Root CA–R3, hinunter über die GlobalSign Code Signing Root R45 und die GlobalSign GCC R45 EV CodeSigning CA 2020, bis zu einem Endzertifikat, das für Hangzhou DeepSeek Artificial Intelligence Co., Ltd. ausgestellt wurde, mit angegebener Jurisdiktion CN / Zhejiang / Hangzhou und der Geschäftskategorie „private Organisation“. Der RFC-3161-Zeitstempel auf dieser Signatur lautet 2026-10-17T09:22:04Z; er stimmt bis auf eine Minute mit dem Veröffentlichungsdatum im Windows-Update-Feed überein, und der SHA-512-Digest der heruntergeladenen Datei stimmt Byte für Byte mit dem in diesem Feed veröffentlichten Hash überein. Unter Windows ist die Binärdatei also heute signiert, mit Zeitstempel versehen und hash-abgeglichen, unabhängig davon, was das README darüber sagt, dass der Prozess nicht vollständig produktionsisiert sei. Die macOS-Seite ist eine andere Frage, und dort haben wir die Notarisierung nicht verifiziert; übertragen Sie das Windows-Ergebnis nicht darauf.

Absturzberichte und ein Detail, das man kennen sollte

Absturzberichte werden als crash-<UTC time>-<source>.log in ~/Library/Logs/DeepSeek Harness unter macOS oder in ein logs-Verzeichnis unter dem Electron-userData-Pfad unter Windows geschrieben, und die zehn neuesten werden aufbewahrt. Diese Aufbewahrungsanzahl ist klein genug, um von Bedeutung zu sein: Wenn wiederholt etwas schiefgeht und Sie ein paar Tage lang nicht nachsehen, ist das Protokoll, das den ersten Fehler erklärt hätte, verschwunden. Kopieren Sie das Verzeichnis, wenn Sie ein intermittierendes Problem debuggen.

Der Wiederherstellungspfad für eine beschädigte Konfiguration ist ebenso spezifisch. Die Shell benennt cordis.patch.yml in cordis.patch.yml.bak-<timestamp> um, ohne die Datei zu parsen, sodass die Datei erhalten bleibt statt repariert zu werden, und die App mit Standardwerten startet. Wenn Sie diese Datei manuell bearbeitet haben, sind Ihre Änderungen in der .bak-Datei gelandet, und sie ist weiterhin lesbar.

Was das für den früheren Rat „keine Desktop-App“ bedeutet

Im August 2026 haben wir den Hinweis veröffentlicht, dass das Harness keine Desktop-Anwendung habe und Windows-Nutzer den Terminal-Build verwenden sollten – das war damals korrekt und ist heute überholt. Der Terminal-Build funktioniert weiterhin und ist nach wie vor die richtige Wahl für einen Server, einen Container oder alles, was skriptgesteuert ist. Was sich geändert hat: Der Desktop-Build ist keine bloße Spielzeug-Hülle – er verfügt über ein eigenes Profil, hält Aufgaben auch beim Schließen eines Fensters am Leben, aktualisiert sich selbst und teilt Zustand mit der CLI, und zwar in die Richtung, die Ihnen hilft. Wenn Sie den Desktop-Build aufgeschoben haben, weil im früheren Artikel stand, es gebe ihn nicht, dann ist dieser Grund entfallen.

Die Installationsschritte selbst werden in unserer Installationsanleitung behandelt und hier bewusst nicht wiederholt. Was diese Anleitung Ihnen nicht sagen kann, ist, welcher der drei Installer auf der Download-Seite keinen Link hat, welche Zielplattform eine Version hinterherhinkt, dass es keinen stabilen Update-Kanal gibt, den man auswählen kann, und dass die Windows-Binärdatei signiert ist, obwohl im README steht, dass die Signierung zu einer zukünftigen Version gehört. Das sind die Fakten, die entscheiden, ob der Desktop-Build das Richtige zum Installieren ist, und sie sind der Grund, warum diese Seite separat existiert.

Wenn Sie lieber nichts installieren möchten

Ein Harness zu installieren, nur um an ein einziges Modell zu gelangen, bietet viel Angriffsfläche für wenig Nutzen, und die Desktop-App ist eine Vorschau mit einem einzigen Update-Kanal und einem Intel-Build, auf den niemand verlinkt. Wenn du eigentlich DeepSeek-V4.1-Flash willst – das Modell, das das Harness standardmäßig verwendet, dasselbe, für das die Versionshinweise zu 0.2.1-rc.2 Unterstützung hinzufügen –, dann erledigt ein API-Endpunkt das ohne Installer, ohne Profilverzeichnis und ohne Tray-Symbol, bei dem du daran denken musst, dass es läuft.

Der anzustellende Vergleich ist nicht der zwischen Desktop-App und API im Abstrakten. Es geht darum, ob die Arbeit einen Agenten verlangt, der einen Arbeitsbereich auch bei geschlossenem Fenster offen halten, Skripte auf Ihrem Rechner ausführen und eine Sitzung stundenlang am Leben halten kann – in diesem Fall sind die oben genannten Packaging-Probleme es wert, in Kauf genommen zu werden, und der Desktop-Build ist der einzige Weg, dieses Verhalten zu erhalten – oder ob die Arbeit ein Strom von Anfragen an ein Modell ist, das bereits anderswo bereitgestellt wird. Für den zweiten Fall ist das Modellverzeichnis der kürzere Weg, und es gibt nichts in diesem Artikel, das daran etwas ändert.