dsh konfigurieren: API-Keys, Modelle und Endpunkte
Erfahren Sie, wo dsh seine Konfiguration unter Linux speichert, wie Sie DeepSeek oder Ollama einrichten und welche Daten je Modus Ihr System verlassen.
Wo dsh seine Konfiguration speichert
dsh (DeepSeek Harness) speichert seine Harness-Daten unter $DSH_HOME. Standardmäßig ist dies ~/.dsh. Die gemeinsame Agent-Konfiguration wird aus einem separaten Stammverzeichnis gelesen: $DSH_AGENTS_HOME. Standardmäßig ist dies ~/.agents. Alles, was Sie in der Web UI festlegen, wird dort als einfache Datei gespeichert. Kopieren Sie beim Übertragen Ihrer Konfiguration auf einen anderen Server das Harness-Home-Verzeichnis sowie alle globalen Anweisungen und Skills aus dem gemeinsamen Agent-Stammverzeichnis.
Vier Pfade enthalten die wichtigsten Harness-Einstellungen, Secrets und Sitzungsprotokolle.
~/.dsh/profiles/<profile>/cordis.patch.ymlenthält die Einstellungen, die die Web UI für dieses Profil schreibt, einschließlich Ihrer Provider- und Modellrouten.dsh webstartet das Profilweb. Daher lautet die Datei~/.dsh/profiles/web/cordis.patch.yml.~/.dsh/.credentials.yamlenthält die Secrets. In den Einstellungen wird nur eine Referenz auf ein Credential gespeichert. Der eigentliche Schlüsselwert befindet sich in einer Datei.~/.dsh/profiles/enthält benannte Profile.~/.dsh/sessions/enthält gespeicherte Sitzungsprotokolle.~/.dsh/cordis.patch.ymlist Ihre eigene Patch-Schicht. Sie wird für jedes Profil über die integrierte Konfiguration angewendet und hat Vorrang vor der Profildatei. Eine Änderung in der Web UI, die diese Schicht überschreiben würde, wird daher abgelehnt und nicht gespeichert.
Das gemeinsame Agent-Stammverzeichnis bleibt außerhalb von $DSH_HOME, weil andere Agent-Tools es ebenfalls verwenden. dsh liest benutzerweite Anweisungen aus ~/.agents/AGENTS.md und durchsucht ~/.agents/skills/ nach Skills. Setzen Sie DSH_AGENTS_HOME, um dieses Stammverzeichnis zu verschieben.
Frühere Builds speicherten diese Einstellungen in ~/.dsh/settings.yaml. Aktuelle Builds importieren diese Datei einmalig in das aktive Profil und benennen sie in settings.yaml.imported um. Eine ältere Anleitung, die Sie auffordert, settings.yaml zu bearbeiten, verweist daher inzwischen auf eine Datei, die dsh nicht mehr liest.
DeepSeek veröffentlicht das Harness als MIT-lizenzierte Entwicklervorschau. Die README weist darauf hin, dass Änderungen mit inkompatiblen Auswirkungen auf die Kompatibilität zu erwarten sind. Die Feldnamen und Pfade in dieser Anleitung entsprechen der aktuellen Dokumentation des Repositorys, die am 5. November 2026 geprüft wurde. Vergleichen Sie sie vor dem Kopieren einer Konfiguration aus einer Anleitung, einschließlich dieser Anleitung, mit der Dokumentation der von Ihnen installierten Version. In einer Vorschau werden Bezeichnungen zwischen Releases geändert.
Das ehrliche Minimum bis zur ersten Ausgabe
dsh benötigt Node.js 24.9 oder neuer. Am 5. November 2026 deklariert seine package.json >=24.9.0, daher wird die 22er-Linie nicht unterstützt. Auch Node 24.0 bis 24.8 ist nicht ausreichend. Prüfen Sie zuerst die Version, weil eine nicht passende Version den Start verhindert und die Fehlermeldung wie ein beschädigtes Paket aussieht.
node -v
npx @deepseek-ai/dsh webnpx lädt das Paket aus der npm-Registry herunter und startet die Weboberfläche auf http://127.0.0.1:3080. Die Loopback-Adresse wird gebunden. Der Port ist daher von keinem anderen Rechner aus erreichbar, selbst wenn Ihre Firewall den Zugriff erlaubt. Leiten Sie ihn auf einem VPS stattdessen über SSH weiter, anstatt Port 3080 im Internet zu öffnen. Falls die ausgegebene URL unklar ist, erklärt warum dsh auf dieser Adresse startet, welche Zugriffe die Loopback-Bindung verhindert und welche nicht.
ssh -N -L 3080:127.0.0.1:3080 you@your-serverÖffnen Sie http://127.0.0.1:3080 auf Ihrem Laptop und wechseln Sie dann zu Settings und Models. Die DeepSeek-Karte enthält ein Feld für einen API-Schlüssel. Fügen Sie den Schlüssel von platform.deepseek.com ein und speichern Sie ihn. Die Modellroute ist sofort nutzbar und erfordert keinen Neustart, weil der laufende Server die Zugangsdaten speichert und die Referenz zur Laufzeit auflöst. Auf die dsh-Weboberfläche auf einem entfernten Server zugreifen behandelt den Fall mit einem Tunnel und einem Reverse Proxy. DeepSeek Harness auf einem VPS installieren behandelt die in dieser Anleitung vorausgesetzte Servervorbereitung.
Sehen Sie sich nach dem Speichern an, was die Anwendung erstellt hat.
ls -la ~/.dsh
stat -c '%a %n' ~/.dsh/.credentials.yamlSie sollten .credentials.yaml und profiles/ sehen. Die Einstellungen der Weboberfläche befinden sich in profiles/web/cordis.patch.yml. In einem Home-Verzeichnis, das ein älterer Build erstellt hat, kann außerdem settings.yaml.imported liegen. Wenn stat einen anderen Modus als 600 ausgibt, führen Sie chmod 600 ~/.dsh/.credentials.yaml aus. Eine für die Gruppe lesbare Zugangsdaten-Datei gibt Ihren Schlüssel für alle Konten in dieser Gruppe frei. Eine für alle lesbare Datei gibt ihn für jedes andere Konto auf dem System frei.
Für einen ersten Durchlauf ohne Browser genügt ein Befehl.
npx @deepseek-ai/dsh --profile headless "summarise the files in this directory"Das Headless-Profil führt eine einzelne Sitzung aus und gibt die abschließende Antwort aus.
Umgebungsvariablen oder die Konfigurationsdatei
dsh kann einen Schlüssel aus gespeicherten Zugangsdaten oder aus Umgebungsvariablen als Fallback auflösen.
Ein Kataloganbieter (DeepSeek, Anthropic, OpenAI und die übrigen integrierten Anbieter) akzeptiert einen Schlüssel über die Seite Models oder verwendet den unterstützten Fallback aus der Umgebung, wenn keine gespeicherten Zugangsdaten den Schlüssel bereitstellen. Der Wert wird in ~/.dsh/.credentials.yaml gespeichert. Ihre Einstellungen enthalten nur eine Referenz darauf. Die Web UI zeigt den Schlüssel nach dem Speichern nicht erneut an.
Ein benutzerdefinierter Anbieter kann mit apiKeyEnv auf eine Zugangsdatenreferenz verweisen. Auch dafür werden Umgebungsvariablen als Fallback unterstützt. Dies ist die Struktur, die die Dokumentation für einen Eintrag in einem Profil-Patch wie ~/.dsh/profiles/web/cordis.patch.yml vorgibt.
- id: llm-pi-ai
config:
providers:
my-gateway:
apiKeyEnv: GATEWAY_API_KEY
api: openai-completions
baseURL: https://gateway.example/v1
models:
- id: legacy-chat
- id: vision-preview
input: [text, image]Fügen Sie zunächst über die Web UI einen Anbieter hinzu. Öffnen Sie anschließend cordis.patch.yml des Profils und kopieren Sie die dort gespeicherte Struktur. Während einer Entwicklervorschau ändert sich die Verschachtelung am wahrscheinlichsten. Die Datei, die die Anwendung gerade geschrieben hat, ist immer aktuell.
apiKeyEnv wird über den Zugangsdaten-Speicher aufgelöst: Zuerst wird die gespeicherte Datei verwendet, danach die Startumgebung, anschließend .env des aufrufenden Verzeichnisses und zuletzt $DSH_HOME/.env. Ein Schlüssel, der nur in einer interaktiven Sitzung exportiert wurde, ist für eine systemd-Unit nicht sichtbar. Ohne eine andere Quelle für Zugangsdaten liefert dieselbe Konfiguration, die bei der manuellen Eingabe von dsh web funktioniert, unter einem Dienst MISSING_CREDENTIAL zurück. Geben Sie der Unit eine eigene Datei.
[Service]
EnvironmentFile=/etc/dsh/dsh.envSetzen Sie für diese Datei den Modus 600 und weisen Sie sie dem Benutzer zu, unter dem der Dienst ausgeführt wird.
Modelle auswählen und die ID, die Sie nicht umbenennen können
Jeder konfigurierte Provider erscheint in der Modellauswahl. Wenn Sie ein Modell auswählen, wird es zugleich zum Standardmodell für neue Sitzungen. Sitzungen, in denen bereits eine Anfrage gesendet wurde, behalten das darin gespeicherte Modell. Ein Wechsel ändert daher keine alte Unterhaltung.
Die Provider-ID ist dauerhaft. Anfragen, gespeicherte Sitzungen, Modelldefaults und Verweise auf Zugangsdaten verwenden diese ID. Deshalb gibt es keine Schaltfläche zum Umbenennen. Wenn Sie die ID ändern, müssen Sie einen neuen Provider anlegen und den alten löschen. Wählen Sie einen Namen, mit dem Sie langfristig arbeiten können: local-ollama statt test2.
Benutzerdefinierte Modelle ohne geerbte Bildunterstützung verarbeiten nur Text, sofern Sie nichts anderes deklarieren. Fügen Sie input: [text, image] zu einem Modelleitrag hinzu, um die Bildunterstützung zu deklarieren. Alternativ können Sie defaultInput auf Route-Ebene als Fallback für Modelle setzen, die im Katalog nicht beschrieben sind. Auf der eigenen Route von DeepSeek gilt ein Modell ohne deklarierte Modalitäten als reines Textmodell. Wählen Sie daher einen bildfähigen Katalogeintrag (standardmäßig deepseek-flash), bevor Sie ein Bild anhängen. Ein Bild, das an ein Modell ohne deklarierte Bildunterstützung gesendet wird, wird abgelehnt, bevor irgendetwas übertragen wird.
dsh auf einen lokalen Endpunkt ausrichten, damit der Code auf dem Rechner bleibt
Ollama stellt unter http://127.0.0.1:11434/v1 eine mit OpenAI kompatible API bereit. dsh kann über einen benutzerdefinierten Provider mit jeder kompatiblen Base-URL kommunizieren. Zwischen beiden ist daher keine weitere Komponente erforderlich. Richten Sie zuerst den Model-Server ein: ein LLM mit Ollama auf einem VPS selbst hosten beschreibt die Installation und den Abruf des Modells.
Prüfen Sie, ob der Endpunkt antwortet, bevor Sie dsh konfigurieren.
ollama list
curl -s http://127.0.0.1:11434/v1/modelsollama list gibt den exakten Tag jedes abgerufenen Modells aus. Kopieren Sie diese Zeichenfolge. curl gibt dieselben Modelle als JSON zurück. Eine leere Liste bedeutet, dass Ollama läuft, aber kein Modell abgerufen wurde. Connection refused bedeutet, dass Ollama nicht läuft oder nicht auf 11434 lauscht.
Wählen Sie ein Modell, das auf diesem Rechner ausgeführt werden kann. Ein angemeldeter Ollama-Server stellt über dieselbe lokale Adresse auch Cloud-Modelle bereit. Ein Cloud-Tag wie gemma4:cloud wird daher auf den Servern von Ollama ausgeführt. Ihre Prompts verlassen den Rechner, obwohl dsh ausschließlich mit 127.0.0.1 kommuniziert.
Fügen Sie den Provider jetzt zum Profile-Patch hinzu. Geben Sie für diese Konfiguration einen nicht leeren API-Key-Wert an. Der lokale Ollama-Server ignoriert ihn.
- id: llm-pi-ai
config:
providers:
local-ollama:
apiKeyEnv: OLLAMA_API_KEY
api: openai-completions
baseURL: http://127.0.0.1:11434/v1
models:
- id: <the exact tag printed by ollama list>Exportieren Sie die Variable in der Umgebung, in der der dsh-Prozess sie sehen kann.
sudo install -d -m 700 /etc/dsh
printf 'OLLAMA_API_KEY=ollama\n' | sudo tee /etc/dsh/dsh.env
sudo chmod 600 /etc/dsh/dsh.envDrei Fehler decken fast alle Fehlversuche ab. MISSING_CREDENTIAL bedeutet, dass die von apiKeyEnv angegebene Referenz zu keinem Wert aufgelöst wurde. Prüfen Sie daher die gespeicherten Zugangsdaten und die Startumgebung, nicht nur Ihr Terminal. UNKNOWN_MODEL bedeutet, dass id nicht mit einem konfigurierten Modell übereinstimmt. Vergleichen Sie den Wert Zeichen für Zeichen mit ollama list, einschließlich des Tags nach dem Doppelpunkt. Ein 401-Fehler beim Abrufen der verfügbaren Modelle entsteht bei der Modellerkennung. Dabei wird GET /models auf Ihrer Base-URL aufgerufen. Endpunkte, die diesen Pfad nicht bereitstellen, benötigen eine manuell eingetragene Modellliste.
Eine weitere Fehlerquelle ist die Base-URL. Lassen Sie /v1 nicht weg. Andernfalls werden die Anfragen an Pfade gesendet, die Ollama nicht bereitstellt. Der Aufruf endet dann mit 404, und das Modell wird nicht ausgeführt. Das Suffix gehört zur mit OpenAI kompatiblen Schnittstelle. Es ist keine optionale Ergänzung.
Wenn Ollama auf einem anderen Rechner läuft, wird die Adresse dieses Rechners zur Base-URL. Ihre Prompts werden dann über unverschlüsseltes HTTP im Klartext über das Netzwerk übertragen. Betreiben Sie Ollama auf demselben Host oder schützen Sie den Endpunkt mit TLS (Transport Layer Security) und Authentifizierung: einen öffentlich erreichbaren Ollama-Endpunkt absichern.
Was den Rechner in den einzelnen Modi verlässt
Mit einem DeepSeek-Schlüssel und dem Standard-Endpunkt werden Modellanfragen an die API von DeepSeek gesendet. Diese Anfrage enthält Ihre Eingabe, die Inhalte der Dateien, die der Agent zur Beantwortung gelesen hat, die Ausgabe der ausgeführten Befehle und alle Tool-Ergebnisse, die er einbezieht. Ihr Quellcode befindet sich in dieser Nutzlast, sobald der Agent eine Datei geöffnet hat. So funktioniert ein gehostetes Modell. Deshalb sollten Sie berücksichtigen, in welchem Verzeichnis Sie den Agenten starten.
Aktuelle Releases hängen Anfragen über den nativen DeepSeek-Adapter standardmäßig außerdem ein noch nicht akzeptiertes Suffix des Ereignisprotokolls der Sitzung an. Das gilt auch bei konfigurierten Gateways. Das Suffix wird als separates Feld dsh_session_log übertragen. Das Modell sieht dieses Feld nie, aber das Ziel der Anfrage erhält es. Deaktivieren Sie die Option unter Settings, General ("Upload Session Log when using the official model API"), oder setzen Sie enabled: false für das Plugin session-log-deepseek. Die folgenden Telemetrie-Schalter steuern diesen Upload nicht.
Die mitgelieferten Profile senden über den nativen DeepSeek-Adapter außerdem die Namen und Versionen der aktiven Plugin-Pakete in einem separaten Feld dsh_plugin_packages. Setzen Sie enabled: false für plugin-package-inventory-deepseek, um diese Übertragung zu unterbinden.
Bei einem anderen Kataloganbieter oder einem Gateway Ihres Unternehmens wird dieselbe Nutzlast stattdessen an diesen Anbieter gesendet. Die Basis-URL zeigt genau, wohin.
Bei einem lokalen Endpunkt wird die Modellanfrage an 127.0.0.1:11434 gesendet. Die Loopback-Adresse allein hält sie jedoch nicht auf dem Rechner. In der Dokumentation von Ollama heißt es: "To use cloud models through this server, sign in to Ollama." Wenn Sie ein Cloud-Modell über denselben lokalen Server auswählen, sendet dieser Ihre Eingaben und Ihren Code an die Cloud von Ollama. Nur wenn das Modell selbst lokal ausgeführt wird, bleibt die Modellanfrage auf dem Rechner. Trotzdem werden weiterhin drei Arten von Daten über das Netzwerk übertragen. npx lädt das Paket aus der npm-Registry herunter. Jedes Tool, das der Agent ausführt, kann selbstständig das Internet erreichen. Dazu gehören auch verbundene MCP-Server (model context protocol); das Betreiben von MCP-Servern auf einem VPS wird ausführlich behandelt. Ein Plugin gehört in dieselbe Kategorie. Bei seiner Installation wird der Code eines anderen Autors mit den Berechtigungen Ihres Agenten ausgeführt. Daher lohnt es sich, vor der Installation zu prüfen, worauf ein Plugin zugreifen kann. Hinzu kommt die Telemetrie. Aktuelle Releases erlauben ihren Export an DeepSeek, sobald Sie Feedback übermitteln, und zwar bei einem lokalen Modell genauso wie bei einem gehosteten Modell.
Die Telemetrie ist standardmäßig auf Feedback beschränkt. DSH_TELEMETRY_MODE wählt den Modus. In der aktuell mitgelieferten Basiskonfiguration wird ein nicht gesetzter oder leerer Wert zu FEEDBACK_ONLY aufgelöst. In diesem Modus wird bei gewöhnlicher Aktivität keine Telemetrieerfassung autorisiert. Wenn Sie Textfeedback übermitteln, eine Bewertung erstellen oder bearbeiten, eine Notiz bearbeiten oder Feedback zurücknehmen, autorisiert dsh den Export des Sitzungsprotokoll-Präfixes, das noch nicht an den Exporter übergeben wurde. Der Export erfolgt über dieses Feedback-Ereignis und enthält den geerbten Kontext. Ziel ist https://dsh-otel-collector.deepseeksvc.com/v1/logs. Eine vollständige Übertragung ist nicht garantiert: Ein zu großes Ereignis wird ohne Kürzung abgelehnt, und große Präfixe können beim Beenden der CLI teilweise ungesendet bleiben. Autorisierte Batches können ohne eine weitere Interaktion oder einen weiteren Modellaufruf weiter gesendet werden. Die Telemetrie-README sagt, dass dies "for all users and providers" gilt. Die lokale Ausführung des Modells deaktiviert die Telemetrie daher nicht. DISABLED erstellt überhaupt keinen OpenTelemetry-(OTel-)Transport. FULL wird nicht mehr akzeptiert. Jeder andere Wert als diese beiden Werte wird mit unsupported mode abgelehnt. Ein Feedback-Export kann Nachrichtentext, Tool-Argumente und -Ergebnisse sowie Workspace-Pfade enthalten. Betrachten Sie Feedback daher als Autorisierung, das entsprechende Sitzungsprotokoll-Präfix an DeepSeek zu senden.
Für eine zuverlässige Deaktivierung, die nicht davon abhängt, den Moduswert korrekt zu setzen, legen Sie DSH_TELEMETRY_DISABLED=1 fest. Jeder nicht leere Wert ist ein verbindlicher Opt-out, einschließlich 0 und false. Die Einstellung wird vor dem Start der Ausführung gelesen. Projektcode kann sie daher während der Sitzung nicht wieder aktivieren. Die Standardadresse des Collectors ist dsh-otel-collector.deepseeksvc.com. DSH_TELEMETRY_OTLP_URL überschreibt sie.
Prüfen Sie die Einstellung, statt ihr zu vertrauen. Listen Sie bei laufender Aufgabe die ausgehenden Verbindungen auf, die der Prozess hält.
sudo ss -tnp | grep -i nodeBei einem lokal ausgeführten Modell verwendet der Modellverkehr den Loopback-Port 11434. Öffentliche Verbindungen können jedoch weiterhin von Tools aufgebaut werden, ohne dass Feedback übermittelt wurde. Die mitgelieferten Profile enthalten Websuche und Abruf-Funktionen. Das standardmäßige Berechtigungsprofil schränkt den Netzwerkzugriff nicht ein. Ermitteln Sie jedes öffentliche Ziel, bevor Sie eine Verbindung der Telemetrie zuschreiben. Der Zeitpunkt allein beweist nicht, dass es sich um den Feedback-Export handelt. Diese Momentaufnahme kann außerdem kurzlebige Verbindungen übersehen. Diese Prüfung umfasst nur den dsh-Prozess. Der Verkehr eines Cloud-Modells verlässt den Rechner über den Ollama-Server. Prüfen Sie daher zusätzlich, dass das Modell id kein Cloud-Tag ist. Jede andere Verbindung sollten Sie identifizieren, bevor Sie fortfahren. Was ein Coding-Agent nach außen sendet führt dieselbe Prüfung für andere Harnesses durch und erklärt, wie Sie das Ergebnis lesen.
Wohin Secrets nicht gehören
- Shell-History.
export DEEPSEEK_API_KEY=sk-...wird von~/.bash_historyim Klartext gespeichert und bleibt dort noch lange nach der Rotation des Keys erhalten. Stellen Sie dem Befehl ein Leerzeichen voran, wennHISTCONTROL=ignorespacegesetzt ist, oder umgehen Sie die Shell und schreiben Sie den Wert direkt in eine Datei mit dem Modus 600. - Committe Dotfiles. Ein Key in
~/.bashrcoder~/.zshrcist nur nochgit addvon einem öffentlichen Repository entfernt, wenn Sie Dotfiles in git verwalten. Führen Sie in diesem Repository vor dem Pushgit grep -I -n 'sk-'aus. - Patch-Dateien von Profilen. Verwenden Sie
apiKeyEnvfür benutzerdefinierte Provider, damitcordis.patch.ymleinen Variablennamen statt eines Secrets enthält. Konfigurationsdateien werden in Issue-Reports und Support-Chats eingefügt. Credential-Dateien nicht. - Ausgabe von
envund Terminal-Screenshots. Alles, was die gesamte Umgebung ausgibt, zeigt auch den Key an. - Backups.
~/.dshsollte gesichert werden, aber.credentials.yamldarin ist ein aktives Secret. Schließen Sie diese Datei aus oder verschlüsseln Sie das Archiv.
Diese Regeln gelten nicht nur für dsh. Secrets aus Compose-Umgebungsdateien heraushalten behandelt dasselbe Problem auf der Container-Seite desselben Servers.
Mit einer Developer Preview arbeiten
Fixieren Sie die getestete Version, weil eine Preview einen Konfigurationsschlüssel bereits in einem Patch-Release ändern kann und Ihr Provider dann nicht geladen werden kann. Wenn die Installation mit fixierter Version anschließend den Start verweigert oder npx Ihnen weiterhin einen nicht angeforderten Build bereitstellt, behandelt der Installations- und Versionsfehler, den eine Preview verursacht den npx-Cache und die mit Node ausgelieferte npm-Version. Halten Sie das Home-Verzeichnis cordis.patch.yml und die Patch-Dateien unter profiles/ unter Versionskontrolle. Schließen Sie die Anmeldedatendatei davon aus. So sehen Sie nach einem Upgrade, was sich geändert hat.
Zwei Flags helfen, wenn sich ein Profil nicht wie erwartet verhält. --dump-default-config gibt die zusammengesetzte Standardkonfiguration aus, ohne den Dienst zu starten. --dump-config gibt die zusammengesetzte Konfiguration für Ihr Profil auf dieselbe Weise aus. Durch den Vergleich sehen Sie, was Ihre Patch-Ebene tatsächlich geändert hat. Das ist schneller, als die Ebenen von Hand zu lesen.
dsh --profile web --dump-configFühren Sie diesen Befehl zuerst aus, wenn nach einem Upgrade etwas nicht mehr funktioniert. Ein Schlüssel, der zwischen Releases verschoben wurde, erscheint im Dump als fehlender Zweig. Die Korrektur besteht dann aus einer einzeiligen Änderung statt aus einer Neuinstallation.
FAQ
Wo speichert dsh meinen DeepSeek-API-Schlüssel?
In $DSH_HOME/.credentials.yaml. Dies ist ~/.dsh/.credentials.yaml, sofern Sie DSH_HOME nicht selbst festlegen. Die Seite „Models“ schreibt den Schlüssel dort hinein. In Ihren Einstellungen wird nur ein Verweis darauf gespeichert. Das Geheimnis befindet sich daher in einer einzigen Datei. Prüfen Sie die Berechtigungen mit stat -c '%a %n' ~/.dsh/.credentials.yaml. Setzen Sie sie auf 600, wenn sie weiter gefasst sind. Ein benutzerdefinierter Provider kann die Datei vollständig vermeiden, indem Sie mit apiKeyEnv eine Umgebungsvariable angeben.
Wie kann ich dsh statt der DeepSeek-API ein lokales Modell verwenden lassen?
Fügen Sie einen benutzerdefinierten Provider mit der Basis-URL Ihres lokalen OpenAI-kompatiblen Endpunkts hinzu. Für Ollama lautet sie http://127.0.0.1:11434/v1. Verwenden Sie api: openai-completions sowie ein Modell id, das exakt aus ollama list kopiert wurde. Geben Sie für diese Konfiguration einen nicht leeren API-Schlüssel an. Der lokale Ollama-Server ignoriert ihn. Prüfen Sie mit curl -s http://127.0.0.1:11434/v1/models, ob der Endpunkt antwortet, bevor Sie eine dsh-Konfiguration bearbeiten. Ein nicht erreichbarer Endpunkt und eine falsche Konfiguration erzeugen ähnliche Fehlermeldungen.
Sendet dsh meinen Code standardmäßig irgendwohin?
Bei einem gehosteten Modell: ja. Ihr Prompt und die Inhalte der Dateien, die der Agent gelesen hat, befinden sich in der API-Anfrage an diesen Anbieter. Anfragen über den nativen DeepSeek-Adapter, einschließlich konfigurierter Gateways, enthalten standardmäßig ebenfalls ein Suffix mit dem Sitzungsprotokoll, bis Sie diesen Upload unter „Settings“, „General“ deaktivieren. Bei einem lokal von Ollama ausgeführten Modell geht die Anfrage an die Loopback-Adresse und bleibt auf dem Rechner. Ein Cloud-Modell wie gemma4:cloud leitet sie jedoch über dieselbe Loopback-Adresse an die Ollama-Cloud weiter. Die integrierte Websuche und der Abruf, andere Tools sowie Plugins können unabhängig von Feedback öffentliche Dienste kontaktieren. Telemetrie ist ein separater Datenstrom: In aktuellen Releases wird DSH_TELEMETRY_MODE bei fehlender Einstellung zu FEEDBACK_ONLY aufgelöst. Feedback autorisiert dadurch für jeden Provider, einschließlich lokaler Modelle, den Export des Präfixes des Sitzungsprotokolls über dieses Ereignis, einschließlich des übernommenen Kontexts. Die Zustellung ist nicht garantiert. Autorisierte Uploads können nach der Feedback-Interaktion fortgesetzt werden. Setzen Sie den Wert auf DISABLED, um keinen Exporter zu verwenden. Alternativ können Sie DSH_TELEMETRY_DISABLED=1 für einen Opt-out setzen, der vor dem Start des Laufs gelesen wird.
Warum meldet dsh MISSING_CREDENTIAL, obwohl meine Variable gesetzt ist?
Weil der von apiKeyEnv angegebene Verweis in den Credential-Quellen von dsh aufgelöst werden muss. Gespeicherte Zugangsdaten haben Vorrang vor der Startumgebung. Danach folgen .env und $DSH_HOME/.env des aufrufenden Verzeichnisses. Eine in Ihrer Shell exportierte Variable wird nicht an einen systemd-Dienst, die Sitzung eines anderen Benutzers oder einen Prozess weitergegeben, der vor dem Export gestartet wurde. Hinterlegen Sie den Wert für die Unit in einem EnvironmentFile mit den Berechtigungen 600. Alternativ exportieren Sie ihn in derselben Shell, in der Sie dsh starten. Prüfen Sie mit sudo tr '\0' '\n' < /proc/$(pgrep -f dsh | head -1)/environ, welche Werte der laufende Prozess tatsächlich enthält.
Welche Node.js-Version benötigt dsh?
Laut der package.json des Repositorys benötigt dsh Node.js 24.9 oder neuer. Diese Angabe gilt zum 5 November 2026. Die Version-22-Reihe wird nicht mehr unterstützt. Auch Node 24.0 bis 24.8 reicht nicht aus. Führen Sie zuerst node -v aus. Ein Startfehler aufgrund einer nicht unterstützten Laufzeit sieht wie eine fehlerhafte Installation aus. Dadurch installieren Benutzer häufig das Paket neu, obwohl die Laufzeit aktualisiert werden muss.