Inhalt dieses Handbuchs

Die dreizehn Abschnitte folgen der Reihenfolge „installieren → benutzen → Probleme“. Wer nur ein bestimmtes Problem lösen will, springt direkt zu Abschnitt zwölf.

• 1 · Was ist das – drei Schichten; im Alltag berühren Sie nur die oberste.
• 2 · Installation – welches Paket für welche Plattform, und wie es installiert wird.
• 3 · Der erste Start – der Assistent in sieben Schritten und „Schließen ist nicht Beenden“.
• 4 · Die Hauptoberfläche – was die vier Bereiche jeweils steuern.
• 5 · Die erste Unterhaltung – wie Sie Ihre Anforderung klar formulieren.
• 6 · Das Tray-Menü – hier liegen alle systemweiten Zugänge.
• 7 · Die Einstellungsseite – was sich in den einzelnen Bereichen ändern lässt.
• 8 · Profile – wie mehrere Konfigurationen gewechselt werden und was bei Fehlern zurückfällt.
• 9 · Plugins – was ab Werk enthalten ist, drei Installationswege und wie man sie wieder entfernt.
• 10 · Sicherheits- und Wiederherstellungsmodus – was hilft, wenn ein Plugin den Start verhindert.
• 11 · Updates – fünf Phasen und vier wiederverwendbare Aktionen.
• 12 · Bei Problemen – Tabelle häufiger Symptome und Diagnose-Export.
• 13 · Daten und Hilfe – Dateiorte und weitere Dokumentationszugänge.

1. Was ist das

In einem Satz: Es bringt die Agenten-Fähigkeiten von DeepSeek Harness in eine Desktop-Anwendung; ein Doppelklick auf das Symbol genügt, um eine Unterhaltung zu beginnen, in der es Dateien liest und schreibt, Befehle ausführt und Werkzeuge aufruft.

Das Produkt besteht aus drei Schichten. Sie arbeiten nur mit der dritten; die beiden unteren laufen automatisch im Hintergrund.

2. Installation

Auf der Produkt-Download-Seite das Paket für Ihre Plattform wählen, ein Doppelklick genügt. Das Paket enthält bereits Electron, Node.js, pnpm und die festgelegte DSH-Laufzeit – es muss nichts zusätzlich installiert werden. Konkret sind dies Electron 44.0.0, Node.js 24.21.0, pnpm 11.8.0, Python 3.12.14 und die DSH-Laufzeit 0.2.2-rc.1.

Für ein Update muss die alte Version nicht von Hand beendet werden. Der Installer fordert die laufende alte Version zuerst zum Beenden auf, beendet sie notfalls gewaltsam und überschreibt danach die Dateien; lässt sie sich wirklich nicht beenden, bricht die Installation mit einer klaren Fehlermeldung ab, statt ein unbrauchbares Paket zu hinterlassen. Vor dem Aktualisieren trotzdem die laufende Arbeit speichern.

Hinweis: Windows ARM64 ist derzeit ein experimenteller Build. Das Hauptprogramm ist ARM64-nativ, Teile der Nutzlast im Paket (eingebaute Python-, Node- und Office-Laufzeit, einige native Module) sind jedoch weiterhin x64 und wurden auf ARM-Geräten nicht vollständig geprüft; normalen Anwendern ist die x64-Version empfohlen.

3. Der erste Start

Beim ersten Start wird automatisch eine Standardkonfiguration vorbereitet (ein Profil namens desktop) und der lokale Dienst für die Oberfläche gestartet. Zuerst erscheint ein Assistent mit sieben Schritten; „Einrichtung überspringen“ ist jederzeit möglich, die Angaben lassen sich später auf der Einstellungsseite nachholen.

Danach öffnet sich die Hauptoberfläche. Das Fenster zu schließen bedeutet nicht, die Anwendung zu beenden: Standardmäßig wandert es nur ins Tray, Hintergrunddienst und laufende Aufgaben arbeiten weiter. Zum echten Beenden im Tray-Menü „Beenden“ wählen.

4. Die Hauptoberfläche im Überblick

5. Die erste Unterhaltung beginnen

1. Eine neue Sitzung anlegen und das Arbeitsverzeichnis wählen.
2. In einem Satz sagen, „was zu tun ist, wo es zu tun ist und wie das Ergebnis aussehen soll“. Beispiel: „Lies die README in diesem Verzeichnis und liste alle veralteten Download-Links in einer Tabelle auf.“
3. Sobald es arbeitet, auf Werkzeugaufrufe und geänderte Dateien achten; soll es die Richtung wechseln, einfach unterbrechen und die neue Vorgabe nennen.
4. Passt das Ergebnis nicht, genau sagen, was nicht stimmt – es ändert es mit dem vorhandenen Kontext, ohne dass eine neue Sitzung nötig ist.

Drei Punkte für eine klare Anforderung:

• Umfang: welches Verzeichnis, welche Dateien – nicht frei laufen lassen.
• Abnahmekriterium: woran eine fertige Arbeit erkennbar ist (es läuft, Tests bestehen, in der Tabelle steht kein leerer Wert).
• Vorgaben: was nicht angefasst werden darf, welches Format erhalten bleiben muss, ob Netzzugriff erlaubt ist.

6. Das Tray-Menü

Ist das Fenster geschlossen, ist das Tray-Symbol der zentrale Zugang zur Anwendung. Ein Rechtsklick darauf zeigt:

7. Die Einstellungsseite

Der Zugang liegt unten in der Seitenleiste (Einstellungen → Desktop-Einstellungen). Die Bereiche im Einzelnen:

8. Profile: mehrere Konfigurationen

Ein Profil ist eine eigene Konfigurationsumgebung: Sitzungen, Plugins und Einstellungen gehören jeweils nur dazu und stören einander nicht. Typisch ist „Arbeit“ und „Privat“ je ein Profil, oder „Alltag“ und „neue Plugins ausprobieren“ je eines.

Drei praktische Regeln:

• Ist ein Profil kaputt, lässt sich mit einem anderen weiterarbeiten – man muss das kaputte nicht zuerst retten.
• Ein neues Profil ist leer (nur die offiziellen Grundkomponenten); Plugins müssen erneut installiert werden – genau das macht es sauber.
• Ein Profil zu löschen entfernt auch die lokalen Konfigurations- und Plugin-Dateien, und das lässt sich nicht rückgängig machen.

9. Plugins: Auslieferungszustand und Installation

9.1 Was ab Werk enthalten ist

Das Installationspaket enthält keine Drittanbieter-Plugins. Das beim ersten Start angelegte Standardprofil lädt nur zwei offizielle Grundkomponenten:

• @deepseek-ai/dsh-base – der Host-Kern: Sitzungen, Werkzeuge, Dateizugriff, Modellanbindung.
• @deepseek-ai/dsh-web-app – die Web-Oberfläche, die Sie sehen.

Nach der Installation erhalten Sie also eine saubere Desktop-Anwendung, die chatten, Dateien lesen und schreiben und Befehle ausführen kann; Plugin-Markt, Expertenteams, Spracheingabe, Aufgabenboard, Code-Graph und vieles mehr müssen Sie selbst installieren. Das ist Absicht: Sie entscheiden, was hineinkommt, und bei Problemen lässt sich der „zuletzt installierte“ Kandidat leicht finden.

9.2 Drei Installationswege

Die Plugin-Seite (links „Plugins“, Untertitel „Plugins installieren, aktivieren und konfigurieren“) deckt zwei Dinge ab:

• Neue Plugins installieren: „Plugin hinzufügen“ antippen, „Installieren Sie ein Drittanbieter-Plugin“ wählen und den npm-Paketnamen (etwa dsh-xxx oder @Autor/Pluginname), eine GitHub-Repository-Adresse oder ein lokales Verzeichnis eintragen. Bei der Installation lässt sich die Quelle wählen: Standardregistrierung, offizielle npm-Registrierung, Spiegel vom chinesischen Festland oder eine eigene interne npm-Adresse.
• Installierte verwalten: Unter „Installierte Plugins“ aktivieren, deaktivieren, deinstallieren und nach Updates sehen; außerdem Version, Quelle und Laufzustand jedes Plugins.

Ein Teil der Plugins ist mit DSH zusammen ausgeliefert: Sie erscheinen als „Dieses Plugin wird mit DSH geliefert“ mit dem Hinweis, dass kein weiterer Download nötig ist und Aktivieren genügt; ist es älter als die aktuelle DSH-Version, erscheint „Update verfügbar“. Dazu gehören unter anderem Expertenteams, Spracheingabe, Plugin-Markt, automatische Prüfung, Terminal, Sitzungssuche, Sitzungstitel, Badge-Skills, Ralph, Übersetzung der Gedankenkette, Inspector, LiveShare, Forge, Werkzeuge für Arbeitsbäume und personalisierte Empfehlungen. Auch die schwereren, standardmäßig nicht installierten (Claude-Code-Subagent, Codex-Subagent, Computer-Use-Desktopsteuerung) werden auf der Plugin-Seite nach Bedarf aktiviert.

Die mit DSH eingebauten Grundkomponenten (wie dsh-base und dsh-web-app) erscheinen nicht in der verwaltbaren Liste der Plugin-Seite; ihr Laufzustand steht unter Einstellungen → „Integrierte Plugins“.

Für den Plugin-Markt stehen derzeit zwei zur Wahl: dsh-community-market (der eingebaute offene Markt, eigene Datenquellen möglich) und dsh-market (der beliebte Community-Markt, Daten von awesome-dsh-plugin). Es lässt sich immer nur einer aktivieren.

Drei Befehle im Terminal (ohne --profile wirken sie auf das gerade aktive Profil):

9.3 Nach der Installation neu starten und prüfen

Ein neu installiertes Plugin wird erst nach einem Neustart der Anwendung geladen – die Oberfläche meldet beim Abschluss „Installiert; Starten Sie DSH neu, um es zu laden.“ Ob es angekommen ist, prüfen Sie so:

1. Plugin-Seite öffnen und nachsehen, ob es unter „Installierte Plugins“ steht und aktiviert ist.
2. In der Seitenleiste nachsehen, ob sein Zugang erschienen ist (Markt, Board, Expertenteams und Ähnliches).
3. Bleibt es unklar, „Einstellungen → Protokollierung“ öffnen, die Protokollebene erhöhen und einmal neu starten; ein Ladefehler steht dann meist ausdrücklich im Protokoll.

9.4 Deaktivieren und deinstallieren

• Erst deaktivieren, dann deinstallieren: Deaktivieren sorgt nur dafür, dass es beim nächsten Start nicht geladen wird; Installationsdateien und Konfiguration bleiben erhalten, und es lässt sich jederzeit wieder einschalten. Deinstallieren entfernt das Paket über dsh plugin remove; die Oberfläche fragt vorher „Was es bietet, verschwindet, sobald es deinstalliert wird.“ Im Wiederherstellungsassistenten heißt Deaktivieren schlicht „Deaktivieren“ – gemeint ist dasselbe.
• Komponenten, die der Plugin-Manager selbst braucht (Host, Webdienst, Dateizugriff und so weiter), tragen den Hinweis „Das Plugin-Management braucht es; Es kann nicht ausgeschaltet oder deinstalliert werden.“ – damit die Anwendung nicht unbrauchbar wird. Eingebaute Grundkomponenten wie dsh-base und dsh-web-app erscheinen gar nicht in der verwaltbaren Liste; ihr Zustand steht nur unter „Einstellungen → Integrierte Plugins“.
• Bei Profilen, die von einer älteren Version übernommen wurden, bleibt der Plugin-Markt standardmäßig aus, bis Sie ihn in den Einstellungen einmal bewusst wählen. Das ist kein Fehler.

9.5 Was tun, wenn ein Plugin die Anwendung lahmlegt

Weder das System neu installieren noch das Datenverzeichnis löschen. Nehmen Sie den Wiederherstellungsassistenten aus Abschnitt zehn: zuerst unter „Plugins verwalten“ das zuletzt installierte Plugin deaktivieren, dann starten; hilft auch das nicht, mit „Zurückrollen“ auf den letzten startfähigen Prüfpunkt zurückgehen.

10. Sicherheitsmodus und Wiederherstellungsmodus

Beide Funktionen lösen dieselbe Art von Problem: Nach einer Installation startet nichts mehr. Der Unterschied: Der sichere Modus ist „sauber hineingehen und arbeiten“, der Wiederherstellungsmodus „draußen bleiben und reparieren“.

10.1 Der sichere Modus

Der sichere Modus startet mit einem eigenen temporären Datenverzeichnis: Er liest Ihre vorhandenen Plugins, Einstellungen, Sitzungen und Arbeitsbereichsaufzeichnungen nicht und kann deshalb auch nicht von ihnen ausgebremst werden. An den Originaldaten wird kein einziges Byte verändert.

So kommen Sie hinein: Tray → „Sicheren Modus starten…“, oder auf der Startseite des Wiederherstellungsassistenten „Sicheren Modus“ wählen.

Was im sicheren Modus möglich ist:

• Feststellen, „ob es überhaupt an einem Plugin liegt“ – läuft im sicheren Modus alles normal, steckt das Problem mit hoher Wahrscheinlichkeit in einem Plugin oder in der Konfiguration.
• Über die Web-Oberfläche normal chatten, Dateien lesen und schreiben – Dringendes lässt sich zuerst erledigen.
• Protokolle ansehen und Diagnoseinformationen exportieren (das Diagnosepaket lässt sich auch im Wiederherstellungsassistenten exportieren).

Einschränkungen (so vorgesehen):

• Die Seite der Desktop-Einstellungen ist fest schreibgeschützt, Änderungen sind nicht möglich.
• Browserzugriff, LAN-Zugriff, Agents-Anywhere, Desktop-Benachrichtigungen und andere Punkte, die eine dauerhafte Konfiguration brauchen, stehen nicht zur Verfügung.
• Oben in der Oberfläche bleibt durchgehend der Hinweis „Sicherer Modus“ sichtbar, der daran erinnert, dass Sie in einer temporären Umgebung arbeiten.

Verlassen: Tray → „Sicheren Modus beenden und neu starten…“. Danach wird die temporäre Umgebung beim nächsten normalen Start automatisch entfernt und belegt keinen Platz auf der Festplatte.

10.2 Wiederherstellungsassistent (Wiederherstellungsmodus)

Wann Sie hier landen:

• Sie wählen im Tray „Im Wiederherstellungsmodus neu starten“ oder unter Einstellungen → Version und Updates → „Im Wiederherstellungsmodus neu starten“.
• Der Start scheitert wiederholt, und die Anwendung fällt von selbst in den Wiederherstellungsassistenten zurück.
• Lässt sich die Oberfläche gar nicht starten, erscheint ein eigener Dialog „DSH Desktop wiederherstellen“, in dem sich die Wiederherstellung erneut versuchen lässt, ohne den Hintergrunddienst neu zu starten.

Der Assistent nennt drei Dinge: warum Sie hier sind (bei manuellem Eintritt steht dort „Wiederherstellungsmodus manuell geöffnet“), welches Profil und welches Verzeichnis gerade verwendet werden und an welcher Stelle der Start stehen geblieben ist (Electron-Initialisierung → Vorbereitung der Shell-Umgebung → Vorbereitung der Desktop-Laufzeit → Profilauswahl → Zusammenstellung der Plugin-Konfiguration → Start des Plugin-Hosts → Start der Desktop-Oberfläche → Bestätigung des Startergebnisses). Die Stufe, an der es hängt, grenzt den Fehlerbereich ein.

Wie das Zurückrollen funktioniert: Nach jedem erfolgreichen Start legt die Anwendung einen „Startprüfpunkt“ an – die Konfiguration, mit der es in diesem Moment lief. Zurückrollen heißt, Profil, settings.yaml und den Aktivierungszustand der Plugins gemeinsam auf diesen Zeitpunkt zurückzusetzen. Prüfpunkte zeigen einen von drei Zuständen: „wiederherstellbar / nicht lesbar / noch kein Prüfpunkt“; „nicht lesbar“ bedeutet, dass dieser Prüfpunkt selbst beschädigt ist – dann einen älteren wählen.

Werkseinstellungen zurücksetzen: Das aktuelle Datenverzeichnis wandert komplett in den Papierkorb (unter Windows in den Recycling-Bin), nach dem Neustart wird ein neues Standardprofil angelegt. Projektdateien außerhalb des Datenverzeichnisses werden nicht gelöscht – es räumt nur die eigenen Konfigurationen und Sitzungen auf. Prüfen Sie vorher, ob Sie die alten Sitzungen wirklich nicht mehr brauchen.

10.3 Der Ausweg

Nach der Reparatur ist keine Handarbeit nötig: den Assistenten einfach normal verlassen und die Anwendung starten. Wurde im Wiederherstellungsmodus „Neu starten“ gewählt, läuft der normale Startvorgang erneut ab; scheitert er wieder, landet die Anwendung erneut im Assistenten – ohne endlose Schleife.

11. Updates

Fünf Phasen: prüfen → herunterladen → installieren → neu starten → Version bestätigen. Vier wiederverwendbare Aktionen:

• Manuell prüfen: Tray → „Nach Updates suchen…“, oder Einstellungen → Version und Updates → „Nach Updates prüfen…“.
• Neu starten: Einstellungen → Version und Updates → „Neu starten“; bei einem Update-Hinweis in der Titelleiste genügt auch ein Klick darauf.
• Installationsreste beseitigen: Ein fehlgeschlagenes Update liegt meist daran, dass eine alte Instanz die Dateien noch hält. Die Anwendung über das Tray beenden und den Installer erneut ausführen – Verzeichnisse müssen nicht von Hand gelöscht werden.
• Zurückgehen: Vom Testkanal zur stabilen Version über „Stabile Version installieren…“ im Tray; nur bis zum letzten startfähigen Zustand zurück über „Zurückrollen“ im Wiederherstellungsassistenten.

12. Was bei Problemen zu tun ist

Diagnoseinformationen exportieren

Tray → „Diagnoseinformationen exportieren…“, oder derselbe Punkt unten auf der Einstellungsseite. Das Paket enthält lokale Pfade, Protokolle, Systeminformationen und bei Abstürzen Speicherauszüge. Vor dem Weitergeben selbst durchsehen: Pfade und Sitzungsausschnitte können persönliche Inhalte enthalten.

13. Wo die Daten liegen und wo es Hilfe gibt

Weitere Dokumentation

• README.md / README.zh.md: Installation, Build, Entwicklungsumgebung.
• docs/: Architektur, Release-Ablauf, Anleitung zur Plugin-Entwicklung.
• Im selben Verzeichnis Nonead-DSH-Desktop-User-Manual.en.md und die HTML-Fassungen in acht Sprachen: inhaltlich gleich, gut zum Vergleich.

Danksagung

Dieses Produkt steht auf den Schultern von DeepSeek Harness und der Open-Source-Community: Electron, Node.js, pnpm, Python sowie dem Cordis-Plugin-System und dem offiziellen Bundle-Ökosystem. Dank an die Maintainer des Upstreams und alle Beitragenden.

Die Angaben zu den Autorinnen und Autoren von Drittanbieter-Plugins werden mit dem jeweiligen Plugin ausgeliefert und sind auf der Plugin-Seite oder in den Details des Plugin-Markts zu finden; dieses Handbuch listet keine konkreten Versionen und Namen mehr auf, denn das gehört zu Ihrer Installationsentscheidung und nicht zum Auslieferungszustand des Produkts.

Das Handbuch wird mit der Version aktualisiert. Wer Abweichungen zur aktuellen Version findet, meldet sie gern als Issue über GitHub / GitCode.