dsh-Plugins prüfen: Risiken und sichere Installation
dsh-Plugins laufen mit den Berechtigungen Ihres Agents. Erfahren Sie, was sie nach dem Laden erreichen können und wie Sie Pakete vor der Installation prüfen.
Was ist ein dsh-Plugin, und was kann es tun?
dsh-Plugins sind Node-Pakete, die DeepSeek Harness in den eigenen Prozess lädt. Nach dem Laden führt ein Plugin den Code eines anderen Anbieters mit den Berechtigungen Ihres Agents auf dem Rechner aus, den Ihr Agent bereits erreichen kann. Der Installationsschritt selbst ist stärker abgesichert. pnpm hält Build-Skripte von Abhängigkeiten zurück, bis Sie sie genehmigen. In der CLI-Referenz steht außerdem: „Starten Sie dieses Profil nach dem Hinzufügen, Entfernen oder Aktualisieren eines Bundles neu.“ Ein mit dsh plugin hinzugefügtes Plugin wird daher beim nächsten Neustart geladen. Ein Plugin, das über die Weboberfläche Plugins installiert wurde, kann sofort wirksam werden. Zwischen einem geladenen Plugin und dem restlichen Harness gibt es keine weitere Schutzschicht. Fragen Sie sich daher vor der Installation, auf welche Daten und Funktionen dieser Code zugreifen kann und wie Sie diesen Zugriff begrenzen.
dsh (DeepSeek Harness) ist das Open-Source-Agent-Harness von DeepSeek AI. Es basiert auf einem Plugin-Framework namens Cordis. Dieser mittlere Begriff ist entscheidend, denn ein Agent-Harness ist das Programm um das Modell herum. Es verwaltet die Schleife, die Tools und die Berechtigungen. Ein Plugin wird genau auf dieser Ebene eingebunden. In der README des Projekts steht, dass alles ein Plugin ist. Der Modelladapter ist ein Plugin. Die Weboberfläche, in die Sie Eingaben schreiben, ist ein Plugin. Alles, was Sie außerhalb des Projekts installieren, landet im selben Baum und auf derselben Vertrauensstufe wie die mitgelieferten Komponenten. Wenn Sie noch keinen Agenten eingerichtet haben, beginnen Sie mit dem DeepSeek Harness auf einem VPS und kehren Sie hierher zurück, bevor Sie etwas hinzufügen.
Im August 2026 führte das AGENTS.md des Repositorys die Erweiterungspunkte auf, die ein Plugin erreichen kann. Dazu gehörten:
- LLM (Large Language Model): der Anbieter, den Sie mit Ihrem API-Key bezahlen
- Shell: die bash-Funktion mit lokalen und pwsh-Anbietern
- Filesystem: richtliniengesteuerter Dateizugriff
- Web: Anbieter für Suche und Abruf
- Subprocess: ein Anbieter für Prozessbäume
- Workflow: Worker-Threads
- Subagent: Delegation an weitere Agents
- Settings und Credentials: Ihre gespeicherte Konfiguration und Umgebungsvariablen
Diese Liste ist inzwischen aus AGENTS.md verschwunden. Seit dem 17. November 2026 nennt das docs/architecture.md des Projekts stattdessen die Erweiterungspunkte. Zusätzlich zu den Schnittstellen für Modell, Tools, Shell, Dateisystem und Subagents werden dort Sandbox-Backends, persistente Terminals, Hintergrundaufgaben, Benutzerbefehle und durch Webhooks ausgelöste Sitzungen genannt.
Ein Plugin registriert außerdem Tools bei ctx.tools. Die Dokumentation stellt ausdrücklich klar, dass das Schema eines registrierten Tools in die Prompt-Erstellung einfließt. Diesen zweiten Aspekt übersehen viele. Ein Plugin kann beeinflussen, was Ihr Agent entscheidet, ohne dass sein eigener Code etwas Ungewöhnliches tut. Die von ihm bereitgestellte Beschreibung wird zu Text, den das Modell liest. Das entspricht dem Problem von Prompt-Injection-Angriffen gegen Coding-Agents, mit einem Unterschied: Dieser Text gelangt bei der Installation in das System und bleibt dort, bis Sie das Plugin entfernen.
Wie findet und lädt dsh Plugins?
Es gibt kein globales Plugin-Verzeichnis. Ein laufendes dsh ist ein beim Start aus geordneten Ebenen zusammengesetzter Plugin-Baum. Das Profil enthält Ihre Auswahl. $DSH_HOME ist standardmäßig auf ~/.dsh gesetzt, und jedes Profil befindet sich in $DSH_HOME/profiles/<name>. Die Profile web und headless werden bei der ersten Verwendung anhand der mitgelieferten Vorlagen automatisch angelegt.
Ein Profilverzeichnis enthält zwei Dateien, die alles festlegen:
package.jsonmit den Abhängigkeiten der Plugins außerhalb des Standardbaums sowie einemdsh.profile-Manifest, das die geordnete Listebundlesenthältcordis.patch.yml, Ihre eigene Patch-Ebene über diesen Bundles
ls ~/.dsh
ls ~/.dsh/profiles/webBeim Start werden die Ebenen in dieser Reihenfolge angewendet. Spätere Ebenen haben Vorrang:
- ein leeres Root
- die Bundles des Profils in der Reihenfolge, in der sie im Manifest aufgeführt sind
- das
cordis.patch.ymldes Profils $DSH_HOME/cordis.patch.yml- alle über die Kommandozeile übergebenen
--patch <path>-Overlays
Zwei Flags geben das Ergebnis dieser Zusammensetzung aus, ohne etwas zu starten:
dsh --profile web --dump-default-config
dsh --profile web --dump-config--dump-default-config gibt nur die Bundle-Ebenen aus. --dump-config ergänzt die Profil- und Home-Patch-Ebenen sowie alle --patch-Overlays. Damit erhalten Sie die genaueste Übersicht darüber, was beim nächsten Start geladen wird. Prüfen Sie diese Ausgabe, bevor Sie einer übernommenen Maschine vertrauen.
Beachten Sie eine wichtige Warnung zu diesen Patch-Dateien. Die Konfiguration besteht hier nicht nur aus passiven Daten, weil das Format !!js-markierte Werte im config-Block eines Plugins erlaubt. Ein aus einem Forum kopierter cordis.patch.yml-Abschnitt ist Code. Behandeln Sie ihn daher wie ein Shell-Skript aus derselben Quelle.
Was führt dsh plugin add tatsächlich aus?
dsh plugin --profile <name> <args> leitet seine Argumente innerhalb des Verzeichnisses dieses Profils an pnpm weiter. pnpm muss daher in PATH verfügbar sein. Die Verben stammen von pnpm:
dsh plugin --profile web add '<package-or-git-spec>'
dsh plugin --profile web remove '<package-name>'
dsh plugin --profile web why '<package-name>'
dsh plugin --profile web updateDas Sicherheitsmodell bei der Installation eines dsh-Plugins entspricht daher dem Sicherheitsmodell jeder npm-ähnlichen Abhängigkeit. Hinzu kommt ein weiterer Schritt: Das Ergebnis wird in Ihren Agent geladen. Das Paket bringt seinen eigenen Abhängigkeitsbaum mit. Jedes Paket in diesem Baum läuft letztlich im selben Prozess. Alles unter wie npm-Lieferkettenangriffe einen Server erreichen gilt hier unverändert.
pnpm 10 und höher führen die Build-Skripte einer Abhängigkeit standardmäßig nicht aus. Die Freigabe erfolgt paketweise über pnpm approve-builds oder die Einstellung allowBuilds. pnpm 11 hat die ältere Einstellung onlyBuiltDependencies durch allowBuilds ersetzt. Eine Anleitung oder alte Konfiguration, die weiterhin onlyBuiltDependencies verwendet, gibt daher in einem aktuellen pnpm nichts frei. Prüfen Sie, welche pnpm-Version installiert ist:
pnpm --versionBei Plugins aus Git-Repositories tritt dieses Verhalten zuerst auf. Die CLI-Referenz weist darauf hin, dass ein Git-Plugin, das Quellcode enthält, beim Installieren über sein Skript prepare erstellt wird. Der erste add-Aufruf schlägt daher mit dem Hinweis allowBuilds von pnpm fehl. Kopieren Sie den ausgegebenen Schlüssel in pnpm-workspace.yaml des Profils und führen Sie den Befehl erneut aus. Wenn Sie diesen Schlüssel freigeben, darf der Build des Repositorys mit den Berechtigungen Ihres Benutzers ausgeführt werden. Vorgefertigte Tarballs und lokale Checkouts benötigen keine Freigabe.
Diese Standardeinstellung ist sinnvoll. Sie wird im Ökosystem jedoch am häufigsten überschätzt. Blockierte Build-Skripte verhindern, dass während der Installation Code ausgeführt wird. Sie schützen nicht vor dem Plugin selbst. Der Zweck eines Plugins besteht darin, dass der Harness es importiert und aufruft, sobald das Profil neu gestartet wird oder sobald die Installation wirksam wird, wenn Sie die Web-Seite Plugins verwendet haben. Ein Plugin benötigt keinen postinstall-Hook. Sie haben es ausdrücklich hinzugefügt.
Lesen Sie dies, bevor Sie ein dsh-Plugin installieren
Laden Sie das veröffentlichte Tarball herunter und lesen Sie es. Beim Entpacken eines Archivs wird nichts ausgeführt.
npm pack '<package-name>@<version>'
tar -tzf '<package-name>-<version>.tgz'
tar -xzf '<package-name>-<version>.tgz'
less package/package.jsonDie vier Felder in diesem package.json liefern Ihnen fast alle benötigten Informationen. Lesen Sie scripts für preinstall-, install- und postinstall-Einträge. Lesen Sie dependencies bei Namen, die Sie nicht erkennen, oder bei Namen, die sich nur durch ein Zeichen von bekannten Namen unterscheiden. Lesen Sie bin für alles, was das Paket in Ihrem PATH erwartet. Lesen Sie main oder exports für die Einstiegsdatei. Öffnen Sie diese Datei anschließend und gehen Sie den darin beschriebenen Ablauf durch.
Lesen Sie danach den Code, der tatsächlich geladen wird. Ein Plugin, das ein Benachrichtigungswerkzeug bereitstellt, muss keinen ~/.ssh lesen, keinen Ihnen unbekannten Host kontaktieren und keine Shell starten. Wenn das Paket ausschließlich gebündeltes oder minimiertes JavaScript enthält und kein passender Quellcode in einem öffentlichen Repository vorhanden ist, ist das bereits eine klare Aussage. Bevorzugen Sie Plugins, deren Quellcode Sie lesen können, und bevorzugen Sie kleine Plugins.
Sie können die Registry auch ohne Installation prüfen:
pnpm view '<package-name>' dependencies
pnpm view '<package-name>' versionsEin Paket, das letzte Woche veröffentlicht wurde, nur eine Version hat, kein Repository-Feld enthält und dessen Name einen bekannten Namen nachahmt, folgt dem ältesten Trick jeder Registry. Downloads mit Prüfsummen verifizieren gehört zur gleichen Vorgehensweise: Sie müssen genau wissen, was Sie heruntergeladen haben, bevor Sie es ausführen lassen.
Version fixieren und Lockfile beibehalten
Ein dynamischer Versionsbereich bedeutet, dass sich der Code innerhalb des Prozesses Ihres Agents bei jeder Installation oder jedem Update ändern kann, ohne dass Sie dies steuern. Fixieren Sie die Version.
dsh plugin --profile web add --save-exact '<package-name>@<version>'Die Platzierung der Flags variiert zwischen den pnpm-Versionen. Überprüfen Sie daher das Ergebnis, anstatt sich auf den Befehl zu verlassen. Öffnen Sie anschließend die package.json des Profils und bestätigen Sie, dass die Abhängigkeit als reine Versionsnummer ohne ^ oder ~ davor aufgeführt ist. Diese Datei bestimmt, was installiert wird.
Behalten Sie anschließend das Lockfile bei, da es den gesamten transitiven Baum fixiert und nicht nur den Namen auf der obersten Ebene:
find ~/.dsh -maxdepth 3 -name 'pnpm-lock.yaml'Kopieren Sie es zusammen mit der package.json des Profils an einen Ort, an dem Sie Backups erstellen. Diese beiden Dateien stellen denselben Baum auf einem neuen System wieder her. Führen Sie dsh plugin --profile web update nur aus, wenn Sie sich für einen Versionswechsel entschieden haben, niemals als routinemäßige Bereinigung, und lesen Sie anschließend das Diff des Lockfiles.
Fixieren Sie bei einem Plugin, das aus git statt aus einer Registry installiert wurde, den Commit anstelle des Branches. Eine Spezifikation in der Form github:owner/repo#<full commit sha> liefert Ihnen einen festen Baum. Ein Branch-Name liefert Ihnen bei der nächsten Auflösung durch pnpm den aktuellen Stand dieses Branches – eine Entscheidung, die Sie an jemand anderen delegiert haben. Das Framework selbst erfordert dieselbe Disziplin, da das npm-Release latest ein Release Candidate ist und eine nicht fixierte Installation an jedem beliebigen Tag zu einer anderen Version aufgelöst werden kann. Dies ist die häufigste Ursache für dsh Installations- und Versionsfehler.
Der Plugin-Markt und der Wert einer „kuratieren“ Auswahl
dsh verfügt über einen Plugin-Markt, der selbst als Plugin installiert wird. Das sagt etwas über die Architektur aus:
dsh plugin --profile web add dshmarketNach einem Neustart erscheint er auf dsh 0.2.1 und neuer als Tab auf der Seite Plugins neben Installed. Auf älteren Hosts öffnen Sie Settings und anschließend Plugin Market. Die README beschreibt die Einschränkungen eindeutig. Installationen sind auf Quellen beschränkt, die in einer kuratierten Registry aufgeführt sind. Alles andere wird abgelehnt. Build-Skripte sind standardmäßig blockiert. Wenn Sie eines aktivieren, müssen Sie jedes Paket einzeln genehmigen. Terminal-Plugins werden markiert, bevor sie in ein Webprofil übernommen werden. Am wichtigsten ist der Hinweis, dass eine Aufnahme keine Empfehlung darstellt, weil es sich um Code von Drittanbietern handelt. Dieselbe README weist darauf hin, dass die meisten darüber installierten Plugins nach einer Aktualisierung der Seite ohne Neustart aktiv werden. Eine Installation per Mausklick kann daher bereits wenige Sekunden später innerhalb Ihres Agents ausgeführt werden.
Eine kuratierte Liste setzt die Einstiegshürde höher. Sie prüft den Code jedoch nicht für Sie. Außerdem kann sie nicht vorhersagen, was die nächste Plugin-Version nach einem Wechsel des Maintainer-Kontos tun wird. Behandeln Sie eine Installation per Mausklick genauso wie curl | bash desselben Autors. Ein weiterer Hinweis aus dieser README ist besonders wichtig: Ein exportiertes Backup kann Zugangsdaten aus Ihrer Profilkonfiguration enthalten. Hängen Sie es deshalb niemals an ein öffentliches Issue an und stellen Sie es nicht auf einer Paste-Seite bereit. Wenn Sie statt einer Methode eine Ausgangsliste suchen, ist dsh-Plugins, die sich zur Installation lohnen der ergänzende Beitrag zu diesem Thema.
Das Harness verfügt nun ebenfalls über eine eigene Route. Ein experimentelles Custom-Plugin namens Indexes, das auf der Seite Plugins aktiviert wird, fügt einen Discover-Tab hinzu. Dieser wird aus Indexdateien gespeist, die Sie selbst hinzufügen. dsh liefert keine Indexquelle aus. In der Dokumentation steht, dass Indizes Inhalte von Drittanbietern sind. dsh prüft das Dateiformat, aber nicht, welche Angaben ein Index zu Titel, Autor oder Quelle eines Plugins macht.
Ausführung von dsh als eigener Benutzer statt als root
Eine gründliche Prüfung reduziert die Wahrscheinlichkeit, dass Schadsoftware in das System gelangt. Das Prinzip der minimalen Rechtevergabe (Least Privilege) bestimmt, was diese Software im Falle einer Kompromittierung erreichen kann. Auf einem VPS ist die Umsetzung dieses zweiten Punktes mit geringem Aufwand verbunden.
Erstellen Sie für die Anwendung ein eigenes Unix-Konto mit einem eigenen Home-Verzeichnis und führen Sie sie niemals als root aus:
sudo adduser --disabled-password --gecos "" dshrun
sudo -iu dshrunStarten Sie die Anwendung innerhalb dieser Sitzung, sodass sie ihre Daten in das Home-Verzeichnis dieses Kontos schreibt:
npx @deepseek-ai/dsh webDas Web-UI läuft standardmäßig auf http://127.0.0.1:3080. Belassen Sie es dabei. Falls Sie jemals auf den ausgegebenen Link von einem anderen Rechner aus geklickt haben und keine Antwort erhielten, erklärt was dsh mit der Ausgabe dieser Adresse meint, warum dies so ist. Die mitgelieferte Web-Komponente prüft die Host- und Origin-Header und erfordert für jede Host-RPC-Methode sowie jeden WebSocket-Stream einen authentifizierten Browser oder API-Peer; zudem verweigert dsh web den Zugriff über --host 0.0.0.0. API-Clients authentifizieren sich über /connect und erhalten ein signiertes API-Cookie. Betrachten Sie diesen Login als zusätzliches Schloss, nicht als Grund, Port 3080 öffentlich zugänglich zu machen. Dahinter befindet sich ein Agent mit Shell-Zugriff; ein geleaktes Session-Token oder ein Login-Fehler an einem öffentlichen Port würde einem Angreifer eine Remote-Shell ohne root-Rechte mit einer benutzerfreundlichen Oberfläche überlassen. Greifen Sie stattdessen über einen SSH-Tunnel von Ihrem Laptop darauf zu:
ssh -L 3080:127.0.0.1:3080 you@your-vpsÜberprüfen Sie anschließend, ob kein Dienst an einer öffentlichen Adresse lauscht:
ss -lnt | grep 3080Die lokale Adresse sollte 127.0.0.1:3080 lauten. Falls dort 0.0.0.0:3080 steht, wurde dies durch etwas anderes als die Standardeinstellungen von dsh web verursacht, etwa durch eine abweichende Konfiguration oder eine geänderte Zusammenstellung, wobei diese dann für ihre eigene Authentifizierung verantwortlich ist. Die Dokumentation des Projekts weist darauf hin, dass der zugrunde liegende Webserver von sich aus keine Authentifizierung oder Origin-Richtlinie mitbringt. Gehen Sie daher so lange davon aus, dass nur Ihre Firewall den Zugriff auf diesen Port schützt, bis Sie wissen, welcher Mechanismus ihn absichert, und verschieben Sie ihn zurück auf das Loopback-Interface. Die Überlegungen unter Sicheres Ausführen von Claude Code auf einem VPS gelten unverändert für dsh. Geben Sie dem Agenten ein Arbeitsverzeichnis, in dem er Schäden anrichten darf, und halten Sie alles, was Sie nicht wiederherstellen können, von diesem Rechner fern. Noch besser: Betrachten Sie den Server als wegwerfbare VM für Coding-Agenten, da die Neuinstallation eines VPS eine Stunde dauert, während eine Sicherheitsprüfung eine ganze Woche in Anspruch nehmen kann.
Wo Ihre Schlüssel liegen und warum Dateiberechtigungen allein nicht ausreichen
dsh speichert API-Schlüssel in $DSH_HOME/.credentials.yaml und Umgebungswerte in $DSH_HOME/.env. Modelleinstellungen liegen im aktiven Profil in cordis.patch.yml. Als diese Anleitung im Oktober 2026 erstmals geprüft wurde, wurde $DSH_HOME/settings.yaml aus einer früheren Version einmalig importiert und in settings.yaml.imported umbenannt. Welcher Schlüssel in welche dieser Dateien gehört und welche Daten in den einzelnen Modi tatsächlich das System verlassen, wird unter API-Schlüssel, Modelle und Endpunkte in dsh konfigurieren beschrieben. Das sollten Sie klären, bevor Sie ein Plugin hinzufügen. Jeder eingetragene Schlüssel ist eine weitere Information, die ein Plugin lesen kann. Sichern Sie die beiden sensiblen Dateien ab:
chmod 600 ~/.dsh/.credentials.yaml ~/.dsh/.env
ls -l ~/.dshDer Modus 600 gewährt dem Besitzer Lese- und Schreibzugriff und allen anderen keinen Zugriff. Das ist in beiden Schreibweisen wichtig zu kennen (numerische und symbolische chmod-Modi). Seien Sie sich über den tatsächlichen Nutzen im Klaren. Dateimodi schützen diese Dateien vor anderen Konten auf dem System. Gegen ein Plugin schützen sie nicht, weil das Plugin als der Benutzer ausgeführt wird, dem die Dateien gehören, und innerhalb des Prozesses läuft, der sie liest. Deshalb bedeutet Geheimnisse außerhalb der Reichweite eines AI-Agenten halten, dass Sie sie überhaupt nicht auf diesem Rechner speichern. Ein dsh-System sollte nur den einen benötigten Modellschlüssel enthalten. Ihre Cloud-Anmeldedaten und Ihre Signaturschlüssel gehören an einen anderen Ort.
Warum ein Plugin, das das Web liest, das Bedrohungsmodell verändert
Die Web-Schnittstelle stellt Plugins Such- und Abrufanbieter bereit. Ein Plugin, das eine Seite in Ihre Sitzung lädt, lädt Text, den ein Angreifer kontrollieren kann. Ein Modell-Prompt trennt Anweisungen nicht von Daten. Daher kann eine abgerufene Seite eine Zeile enthalten, die an Ihren Agenten gerichtet ist. Ein Harness mit Shell-Berechtigung ist dann nur noch einen gehorsamen Schritt von der Ausführung entfernt.
Die Steuerung ist bereits im Harness vorhanden. dsh-base, das gemeinsam verwendete erste Bundle der Profile web, headless, sdk und acp, liefert die Sandbox und die Genehmigungsrichtlinie. Das Profil sdk-minimal lässt sie bewusst weg. Verwenden Sie diese Steuerung. Eine Sitzung, die nicht vertrauenswürdige Seiten abrufen kann, sollte für alle Aktionen, die Daten schreiben oder Befehle ausführen, eine Genehmigung verlangen. Dadurch kann eine abgerufene Anweisung nicht eigenständig zu einer Aktion werden. Agentenaktionen durch Genehmigungen absichern erläutert, wie Sie festlegen, wo diese Grenze verläuft. Die Beziehung wirkt außerdem in beide Richtungen: Ihr eigener Server ist eine Seite, die der Agent einer anderen Person abruft. Das ist der Anwendungsfall für KI-Crawler auf Ihrem Server blockieren.
Wie prüfe ich, was ein Plugin geändert hat?
Erstellen Sie vor der Installation einen Snapshot und danach einen weiteren. Lesen Sie anschließend den Unterschied.
dsh --profile web --dump-config > /tmp/dsh-before.txt
dsh plugin --profile web add '<package-name>@<version>'
dsh --profile web --dump-config > /tmp/dsh-after.txt
diff -u /tmp/dsh-before.txt /tmp/dsh-after.txtDer Diff zeigt, welche Plugin-Einträge die Installation zum zusammengesetzten Baum hinzugefügt hat. Nur ein Paket, das einen Bundle-Patch deklariert, wird in den Baum aufgenommen. Eine einfache Abhängigkeit fügt dort nichts hinzu, und dsh weist Sie einmalig darauf hin. Wenn ein Plugin, das Sie für eine kleine Funktion installiert haben, mehrere Einträge hinzufügt, die Sie nicht zuordnen können, sollten Sie anhalten und den Quellcode lesen, bevor Sie es starten. dsh plugin --profile web why <package-name> beantwortet die andere Frage: Welche Ihrer direkten Abhängigkeiten hat ein bestimmtes Paket eingezogen?
Installierte Pakete werden im eigenen node_modules des Profils unter $DSH_HOME/profiles/<name>/node_modules abgelegt. Sie können den Baum daher auch auf der Festplatte prüfen:
ls ~/.dsh/profiles/web/node_modulesVerwenden Sie ein zweites Profil, in dem Sie keine Experimente durchführen. Wenn eine Installation den Harness beschädigt, zeigt der Start von dsh --profile <clean-name> innerhalb von Sekunden, ob das Plugin die Ursache war.
Wie entferne ich ein dsh-Plugin?
dsh plugin --profile web remove '<package-name>'
dsh --profile web --dump-config > /tmp/dsh-after-removal.txt
diff -u /tmp/dsh-before.txt /tmp/dsh-after-removal.txtDurch das Entfernen der Abhängigkeit wird die Konfiguration nicht immer entfernt. Einträge in cordis.patch.yml des Profils bleiben bestehen, weil diese Datei Ihnen gehört und das Harness sie nicht für Sie neu schreibt. Öffnen Sie die Datei und löschen Sie jeden Block, in dem das entfernte Paket genannt wird.
less ~/.dsh/profiles/web/cordis.patch.ymlDanach müssen Sie sich mit dem Teil befassen, den kein Deinstallationsbefehl beheben kann. Wenn Sie ein Plugin entfernt haben, weil Sie ihm nicht mehr vertrauen, hat es bereits alles gelesen, worauf es zugreifen konnte. Ersetzen Sie den DeepSeek API-Schlüssel in der Provider-Konsole und erneuern Sie alle anderen Schlüssel oder Zugangsdaten, die in $DSH_HOME gespeichert waren. Ermitteln Sie anschließend, worauf das Unix-Konto, unter dem das Plugin ausgeführt wurde, im restlichen Netzwerk zugreifen konnte.
Die Kurzfassung
- Lesen Sie das veröffentlichte Tarball vor der Installation, beginnend bei
scriptsund der Einstiegsdatei - Fixieren Sie die genaue Version oder bei einer git-Spezifikation den genauen Commit und behalten Sie die Lockdatei
- Installieren Sie in einem Profil und halten Sie ein sauberes Profil bereit, das Sie starten können, wenn etwas ausfällt
- Vergleichen Sie
--dump-configvor und nach jeder Installation - Führen Sie den Harness als eigenen Unix-Benutzer auf dem Loopback-Interface aus und greifen Sie über SSH darauf zu
- Bewahren Sie einen API-Schlüssel auf dem System auf und rotieren Sie ihn an dem Tag, an dem Sie ein Plugin entfernen, dem Sie nicht mehr vertrauen
Nichts davon ist ein Grund, Plugins zu vermeiden. Das Plugin-Modell macht dsh nützlich, und ein Harness, den Sie nicht erweitern können, werden Sie ersetzen. Es ist ein Grund, zu wissen, was Sie installiert haben, von wem es stammt und in welcher Version, und alles an einem Ort auszuführen, den Sie neu erstellen können.
FAQ
Isoliert dsh Plugins voneinander?
Nein. Ein Plugin wird über Cordis in den Harness-Prozess geladen und kann die dokumentierten Zugriffsschnittstellen erreichen, darunter Shell, Dateisystem, Web, Subprozesse, Subagenten und Zugangsdaten. dsh-base, das gemeinsame erste Bundle der Profile web, headless, sdk und acp, liefert die Sandbox- und Freigaberichtlinie, die festlegt, was die Tools des Agenten tun dürfen. Diese Richtlinie bietet den Schutz. Es gibt keine Berechtigungsgrenze zwischen einzelnen Plugins. Das ehrliche Modell lautet daher: Mit der Installation eines Plugins erweitern Sie Ihr Vertrauen auf dessen Autor und auf jedes Paket in seinem Abhängigkeitsbaum.
Kann ich ein dsh Plugin installieren, ohne dessen Installationsskripte auszuführen?
pnpm 10 und spätere Versionen blockieren standardmäßig Build-Skripte von Abhängigkeiten. dsh plugin ... add leitet an pnpm weiter. Bei einem aktuellen pnpm führt die Installation daher keine Paketskripte aus, sofern Sie das betreffende Paket nicht freigeben. Prüfen Sie Ihre Version mit pnpm --version. Dadurch wird ein ungeprüftes Plugin nicht sicher. Der eigene Code des Plugins wird ausgeführt, sobald der Harness es lädt. Das geschieht beim nächsten Neustart des Profils nach einer Installation mit dsh plugin oder häufig sofort nach einer Installation über die Weboberfläche Plugins. Keine Einschränkung während der Installation wirkt sich darauf aus.
Wo befinden sich dsh Plugins und ihre Konfiguration tatsächlich?
$DSH_HOME verwendet standardmäßig ~/.dsh. Die Profile befinden sich in $DSH_HOME/profiles/<name>. Jedes Profil enthält ein package.json mit seinen Plugin-Abhängigkeiten sowie das dsh.profile-Manifest der geordneten Bundles und eine cordis.patch.yml-Patch-Schicht. Installierte Pakete werden im eigenen node_modules jedes Profils unter $DSH_HOME/profiles/<name>/node_modules abgelegt. Schlüssel befinden sich in $DSH_HOME/.credentials.yaml, Umgebungswerte in $DSH_HOME/.env. Ein $DSH_HOME/cordis.patch.yml auf Home-Ebene gilt für jedes Profil. Führen Sie dsh --profile web --dump-config aus, um das zusammengeführte Ergebnis anzuzeigen, ohne den Startvorgang auszuführen.
Ist die Installation aus dem dsh Plugin-Markt sicher?
Der Markt beschränkt Installationen auf Quellen in einer kuratierten Registry und blockiert Build-Skripte, sofern Sie sie nicht für das jeweilige Paket freigeben. Das ist eine deutliche Verbesserung gegenüber dem Einfügen eines Paketnamens aus einem Chatfenster. In der eigenen README wird jedoch weiterhin darauf hingewiesen, dass eine Aufnahme keine Empfehlung darstellt. Die Plugins bestehen aus Code von Drittanbietern. Lesen Sie den Quellcode und legen Sie die Version fest. Betreiben Sie den Harness unter einem Benutzerkonto und idealerweise auf einem Computer, dessen Verlust Sie verkraften können.