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 sechs 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 – die 35 Plugins in sieben Kategorien einzeln vorgestellt, dazu Verwaltung und Nachinstallieren.
• 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.

Diese Ausgabe (Essentials) unterscheidet sich noch in einem Punkt von der allgemeinen Version im Software-Repository: Sie ist keine leere Anwendung, in der nur die Hülle steckt und auf Ihre Plugins wartet, sondern bringt 35 bereits ausgewählte, aufeinander abgestimmte Plugins gleich im Installationspaket mit. Beim ersten Start nach der Installation stehen diese Fähigkeiten schon auf der Plugin-Seite bereit – Sie müssen sie nicht einzeln auf npm suchen.

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 Upgrade 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 Paket zu hinterlassen, das sich danach nicht öffnen lässt. Vor dem Aktualisieren trotzdem die laufende Arbeit speichern. Auch beim Deinstallieren wird zuvor geprüft und das laufende Programm geschlossen, damit nicht mitten im Vorgang Dateien belegt sind.

Hinweis: Die Download-Seite bietet derzeit drei Varianten: Windows x64, das macOS-Universal-Paket und Linux x64. Ein arm64-Build für Linux entsteht im Testkanal und ist noch nicht in den stabilen Download-Links; wer auf ARM-Geräten auf Probleme mit nativen Modulen stößt, nimmt die x64-Version der jeweiligen Plattform oder einen Build aus dem Testkanal.

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 sechs Schritten; „Einrichtung überspringen“ ist jederzeit möglich, die Angaben lassen sich später auf der Einstellungsseite nachholen:

Die letzte Seite zeigt zuerst eine Übersicht der großen Kategorien: Gedächtnis und Kontext, Oberfläche und Arbeitsbereich, Agenten und Skills, Dokumente und Medien, Code und Technik, Robotik und Simulation, Verbindung und Automatisierung; zu jeder Kategorie steht, „was sie für Sie tun kann“, und die Anzahl der Plugins. Erst nach „Fertig und starten“ installiert der Assistent eines nach dem anderen und zeigt dabei jeweils Name, Version, Kategorie, die vollständige Beschreibung und einen Satz „Danke an … für dieses Plugin“. Während der Installation ist nichts zu tun – einfach warten, bis der Fortschritt durchgelaufen ist: 35 Pakete werden einzeln installiert, der erste Start dauert dadurch etwas länger als sonst.

Nach dem Assistenten ö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

Mit den mitgelieferten Plugins erscheinen in Seitenleiste und Eingabefeld weitere Zugänge: Skill-Zentrum, Aufgabenboard, Kostenboard, Eingabeverlauf, Expertenteams und mehr. Sie stammen alle aus den Plugins von Abschnitt neun; wird das jeweilige Plugin deaktiviert, verschwinden sie wieder.

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:

Die in der vorigen Ausgabe erwähnten „Modi: Verstärkt / Kompatibel / Erweitert“ sind entfallen: Ab 2.2.9 ist der Fenstermodus fest, in den Einstellungen bleibt nur „Fensteraussehen (Material)“.

7. Die Einstellungsseite

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

Im sicheren Modus ist diese Seite schreibgeschützt; auch Browserzugriff, LAN-Zugriff, Fernsteuerung und Benachrichtigungen sind deaktiviert – das ist so vorgesehen und kein Fehler.

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 neu angelegtes Profil enthält nur die offiziellen Grundkomponenten; die 35 mitgelieferten Plugins landen nur in dem Profil, mit dem der Assistent abgeschlossen wurde. Wer das Profil wechselt und sie weiter nutzen will, prüft auf der Plugin-Seite die tatsächliche Liste und ergänzt, was fehlt.
• Ein Profil zu löschen verschiebt es in das Sicherungsverzeichnis der Wiederherstellung (es wird nicht sofort gelöscht), gemeinsame Sitzungen und Einstellungen bleiben erhalten; für dieses Profil ist es aber nicht mehr nutzbar – vorher sicher sein.

9. Plugins: ab Werk mitgeliefert

Dieser Abschnitt ist der Schwerpunkt dieser Ausgabe. Das Installationspaket von 2.2.9 bringt 35 Plugins mit, verteilt auf sieben große Kategorien; beim ersten Abschluss des Assistenten werden sie automatisch in das aktuelle Profil installiert. Zuerst wird geklärt, „was mitkommt und wie es hineinkommt“, dann folgt die Vorstellung nach Kategorien, zuletzt die Verwaltung und das Nachinstallieren.

9.1 Was ab Werk mitgeliefert wird

Das Installationspaket liefert die Archive aller 35 Plugins mit (Verzeichnis plugins/); am Ende des ersten Assistentenlaufs werden sie einzeln in das Profil installiert. Sie sind kein „optionaler Download“, sondern einfach da: Auf der Plugin-Seite stehen unter „Installierte Plugins“ alle 35, standardmäßig aktiviert.

9.2 Wie die Mitlieferung abläuft

Einige Details, die sich zu kennen lohnen:

• Installiert wird eines nach dem anderen; jedes zeigt im Assistenten Name, Version, Kategorie, Beschreibung und Autor. Das Fenster erst schließen, wenn alles durch ist.
• Erfolgskriterium ist, dass der Paketname in den Abhängigkeiten der package.json des Profils steht, nicht ob ein Befehl einen Fehler gemeldet hat; anschließend wird der Name auch in profile.bundles ergänzt, sonst entsteht „installiert, aber nicht aktiviert“.
• Ein einzelnes fehlgeschlagenes Plugin hält den Start nicht auf: Treten Fehler auf, erscheint am Ende ein Sammeldialog mit Name und Grund, und dieselbe Meldung geht ins Desktop-Protokoll (bundled plugin not installed: <Name>: <Grund>); der Assistent endet regulär. Hinterher lässt sich auf der Plugin-Seite prüfen, was wirklich in der Liste steht.
• Installiert wird nur in das Profil, mit dem der Assistent abgeschlossen wurde. Später angelegte Profile sind sauber; bei Bedarf den Assistenten erneut ausführen oder auf der Plugin-Seite ergänzen.

9.3 Die Kategorien im Einzelnen

Im Folgenden alle 35 Plugins nach den sieben großen Kategorien. Das v hinter dem Namen ist die mitgelieferte Version; der Satz „Geeignet für“ ist eine Auswahlempfehlung, keine Funktionsgrenze.

9.4 Deaktivieren, deinstallieren und wieder installieren

• 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 „Nach dem Deinstallieren verschwindet, was es bietet“.
• Mitgelieferte Plugins zu deinstallieren bringt kaum Platz: Die ursprünglichen .tgz liegen weiterhin im Programmverzeichnis unter plugins/; gelöscht wird nur die Installationskopie im Profil. Wer wirklich abspecken will, nimmt ein Installationspaket ohne diese Pakete, statt einzeln zu deinstallieren.
• Wieder installieren: Einstellungen → Desktop-Werkzeuge → „Einrichtungsassistent“, bis Seite 6 durchlaufen und „Fertig und starten“ antippen; fehlende Pakete im Profil werden nachinstalliert. Alternativ von Hand über die Wege in 9.5.
• Geschützte Komponenten bleiben unangetastet: Was der Plugin-Manager selbst braucht (Host, Webdienst, Dateizugriff und so weiter), trägt den Hinweis „Für die Plugin-Verwaltung nötig; kann nicht deaktiviert oder deinstalliert werden“; integrierte Grundkomponenten wie dsh-base und dsh-web-app erscheinen gar nicht in der verwaltbaren Liste – ihr Zustand steht nur unter „Einstellungen → Integrierte Plugins“.

9.5 Selbst Plugins installieren: drei Wege

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 Quelle, 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.

Für den Plugin-Markt stehen zwei zur Wahl: dsh-community-market (der eingebaute offene Markt, eigene Datenquellen möglich, Beta) und dsh-market (der beliebte Community-Markt, Daten von awesome-dsh-plugin, Paketname dshmarket). Es lässt sich immer nur einer aktivieren; der Markt ist selbst ein Plugin und lässt sich deshalb auch direkt auf der Plugin-Seite schalten.

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

9.6 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, Kosten 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.7 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. Für mitgelieferte Plugins gilt dasselbe – sie unterscheiden sich nicht von später installierten.

10. Sicherheitsmodus und Wiederherstellungsmodus

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

10.1 Der Sicherheitsmodus

Der Sicherheitsmodus 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 „Sicherheitsmodus“ wählen.

Was im Sicherheitsmodus möglich ist:

• Feststellen, „ob es überhaupt an einem Plugin liegt“ – läuft im Sicherheitsmodus 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, Fernsteuerung, Desktop-Benachrichtigungen und andere Punkte, die eine dauerhafte Konfiguration brauchen, stehen nicht zur Verfügung.
• Oben in der Oberfläche bleibt durchgehend der Hinweis „Sicherheitsmodus“ 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 „Wiederherstellungsassistent…“.
• 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: Nur bis zum letzten startfähigen Zustand zurück geht es über „Zurückrollen“ im Wiederherstellungsassistenten. Wer das Installationspaket des stabilen Kanals will, holt die passende Version von der Download-Seite und installiert darüber – Profile und Plugins bleiben erhalten.

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.
• CHANGELOG.md: die Änderungen jeder Version; unter dem Eintrag 2.2.9 steht die zu diesem Handbuch passende „Liste der mitgelieferten Plugins (35)“.

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 35 mitgelieferten Plugins stammen von den folgenden Autorinnen, Autoren und Teams (nach Namen sortiert; dieselbe Person kann mehrere beigesteuert haben):

Version, Autor und vollständige Beschreibung jedes Plugins stehen mit dem Paket in plugins/manifest.json und lassen sich auch in den Details auf der Plugin-Seite nachsehen.

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