SSD Nodes Learn Hosting plans →
Przewodniki Matt ConnorAutor: Matt Connor · Zaktualizowano 2026-11-06

Konfiguracja dsh: API keys, modele i endpointy

Dowiedz się, gdzie dsh przechowuje pliki konfiguracyjne w systemie Linux. Sprawdź, jak poprawnie skonfigurować klucz API DeepSeek oraz lokalny endpoint Ollama w ~/.dsh.

Lokalizacja konfiguracji dsh

Narzędzie dsh (DeepSeek Harness) przechowuje dane środowiska w $DSH_HOME, co domyślnie wskazuje na ~/.dsh, natomiast współdzieloną konfigurację agenta odczytuje z osobnego katalogu głównego $DSH_AGENTS_HOME, domyślnie ustawionego na ~/.agents. Wszystkie ustawienia wprowadzone w interfejsie WWW są zapisywane w tym miejscu jako zwykłe pliki. Podczas przenoszenia konfiguracji na inny serwer należy skopiować katalog domowy środowiska oraz wszelkie globalne instrukcje i umiejętności z katalogu głównego współdzielonego agenta.

Cztery ścieżki zawierają główne ustawienia środowiska, sekrety oraz dzienniki sesji.

  • ~/.dsh/profiles/<profile>/cordis.patch.yml przechowuje ustawienia zapisywane przez interfejs WWW dla danego profilu, w tym trasy dostawców i modeli. dsh web uruchamia profil web, dlatego plik znajduje się w ~/.dsh/profiles/web/cordis.patch.yml.
  • ~/.dsh/.credentials.yaml przechowuje sekrety. Ustawienia zawierają jedynie odniesienie do poświadczenia, więc sama wartość klucza znajduje się w jednym pliku.
  • ~/.dsh/profiles/ przechowuje nazwane profile, a ~/.dsh/sessions/ zapisane dzienniki sesji.
  • ~/.dsh/cordis.patch.yml stanowi własną warstwę poprawek użytkownika. Jest ona nakładana na wbudowaną konfigurację dla każdego profilu i ma wyższy priorytet niż plik profilu, dlatego edycja w interfejsie WWW, która zostałaby nadpisana przez tę warstwę, jest odrzucana zamiast zapisywana.

Katalog główny współdzielonego agenta znajduje się poza $DSH_HOME, ponieważ korzystają z niego również inne narzędzia agentowe. dsh odczytuje globalne instrukcje użytkownika z ~/.agents/AGENTS.md i skanuje ~/.agents/skills/ w poszukiwaniu umiejętności; należy ustawić DSH_AGENTS_HOME, aby zmienić ten katalog główny.

Wcześniejsze wersje przechowywały te ustawienia w ~/.dsh/settings.yaml. Obecne wersje importują ten plik jednorazowo do aktywnego profilu i zmieniają jego nazwę na settings.yaml.imported, dlatego starsze poradniki zalecające edycję settings.yaml wskazują na plik, którego dsh już nie odczytuje.

DeepSeek udostępnia środowisko jako wersję poglądową dla programistów na licencji MIT, a plik README informuje o planowanych zmianach niekompatybilnych wstecz. Nazwy pól i ścieżki w tym przewodniku są zgodne z aktualną dokumentacją repozytorium, zweryfikowaną 5 listopada 2026. Przed skopiowaniem konfiguracji z jakiegokolwiek poradnika, w tym niniejszego, należy porównać je z dokumentacją posiadanej wersji, ponieważ w wersjach poglądowych nazwy mogą ulegać zmianom pomiędzy wydaniami.

Uczciwe minimum dla pierwszego uruchomienia

dsh wymaga Node.js w wersji 24.9 lub nowszej. Według stanu na 5 listopada 2026 plik package.json deklaruje >=24.9.0, więc linia 22 nie jest wspierana. Wersje Node od 24.0 do 24.8 również są niewystarczające. Najpierw sprawdź wersję, ponieważ niezgodność wersji powoduje błąd przy starcie, a komunikat o błędzie sugeruje uszkodzenie pakietu.

node -v
npx @deepseek-ai/dsh web

npx pobiera pakiet z rejestru npm i uruchamia Web UI na http://127.0.0.1:3080. Wiąże się on z adresem loopback, co oznacza, że port nie jest dostępny z innej maszyny, nawet jeśli firewall na to pozwala. Na serwerze VPS przekieruj go przez SSH zamiast otwierać port 3080 na świat. Jeśli wyświetlony adres URL jest niejasny, dlaczego dsh uruchamia się na tym adresie wyjaśnia, przed czym chroni wiązanie z adresem loopback, a przed czym nie.

ssh -N -L 3080:127.0.0.1:3080 you@your-server

Otwórz http://127.0.0.1:3080 na swoim laptopie, a następnie przejdź do Settings i Models. Karta DeepSeek zawiera jedno pole na API key. Wklej klucz z platform.deepseek.com i zapisz go. Ścieżka modelu staje się użyteczna natychmiast, bez restartu, ponieważ działający serwer przechowuje poświadczenia i rozwiązuje odwołanie w czasie rzeczywistym. Dostęp do Web UI dsh na zdalnym serwerze opisuje tunelowanie oraz przypadek reverse proxy, a instalacja DeepSeek Harness na VPS obejmuje przygotowanie serwera, które zakłada ten przewodnik.

Po zapisaniu sprawdź, co utworzyła aplikacja.

ls -la ~/.dsh
stat -c '%a %n' ~/.dsh/.credentials.yaml

Powinieneś zobaczyć .credentials.yaml oraz profiles/, z ustawieniami Web UI w profiles/web/cordis.patch.yml. Katalog domowy utworzony przez starszą kompilację może również zawierać settings.yaml.imported. Jeśli stat wyświetla tryb inny niż 600, uruchom chmod 600 ~/.dsh/.credentials.yaml. Plik poświadczeń z uprawnieniami do odczytu dla grupy ujawnia klucz kontom należącym do tej grupy; plik z uprawnieniami dla wszystkich (world-readable) ujawnia go każdemu innemu użytkownikowi w systemie.

Dla pierwszego uruchomienia bez przeglądarki wystarczy jedno polecenie.

npx @deepseek-ai/dsh --profile headless "summarise the files in this directory"

Profil headless uruchamia pojedynczą sesję i wypisuje ostateczną odpowiedź.

Zmienne środowiskowe lub plik konfiguracyjny

dsh może pobrać klucz z zapisanych poświadczeń lub alternatywnych zmiennych środowiskowych.

Dostawca katalogowy (DeepSeek, Anthropic, OpenAI oraz pozostałe z wbudowanej listy) akceptuje klucz poprzez stronę Models lub korzysta z obsługiwanej zmiennej środowiskowej, jeśli nie podano zapisanego poświadczenia. Wartość trafia do ~/.dsh/.credentials.yaml, a ustawienia przechowują jedynie odwołanie do niej. Interfejs WWW nigdy nie wyświetla klucza ponownie po jego zapisaniu.

Dostawca niestandardowy może wskazać odwołanie do poświadczenia za pomocą apiKeyEnv, co również wspiera alternatywne zmienne środowiskowe. Taką postać dokumentacja przewiduje dla wpisu w patchu profilu, na przykład ~/.dsh/profiles/web/cordis.patch.yml.

- 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]

Najpierw dodaj jednego dostawcę przez interfejs WWW, następnie otwórz cordis.patch.yml profilu i skopiuj zapisaną strukturę. W fazie developer preview zagnieżdżenie jest elementem, który najprawdopodobniej ulegnie zmianie, a plik utworzony przez aplikację jest zawsze aktualny.

apiKeyEnv jest rozwiązywane przez magazyn poświadczeń: zapisany plik ma pierwszeństwo, następnie środowisko uruchomieniowe, .env w katalogu wywołującym, a na końcu $DSH_HOME/.env. Klucz wyeksportowany tylko w sesji interaktywnej jest niewidoczny dla jednostki systemd, więc bez innego źródła poświadczeń ta sama konfiguracja, która działa po wpisaniu dsh web ręcznie, zwróci MISSING_CREDENTIAL w ramach usługi. Należy dostarczyć jednostce własny plik.

[Service]
EnvironmentFile=/etc/dsh/dsh.env

Plik ten należy przechowywać z uprawnieniami 600, przypisanymi do użytkownika, na którego koncie działa usługa.

Wybór modeli oraz identyfikator, którego nie można zmienić

Każdy skonfigurowany dostawca pojawia się w selektorze modeli. Wybór modelu ustawia go również jako domyślny dla nowych sesji. Sesje, w których wysłano już żądanie, mają przypisany model na stałe, więc przełączenie nie powoduje nadpisania historii starej konwersacji.

Identyfikator dostawcy (Provider ID) jest stały. Żądania, zapisane sesje, domyślne ustawienia modeli oraz odwołania do poświadczeń wskazują na ten identyfikator, dlatego nie istnieje przycisk zmiany nazwy. Zmiana identyfikatora wymaga utworzenia nowego dostawcy i usunięcia starego. Należy wybrać nazwę, która będzie odpowiednia w dłuższej perspektywie: local-ollama zamiast test2.

Modele niestandardowe bez dziedziczonej obsługi obrazów działają wyłącznie w trybie tekstowym, chyba że zadeklarowano inaczej. Należy dodać input: [text, image] do wpisu modelu, aby zadeklarować obsługę obrazów, lub ustawić defaultInput na poziomie trasy jako ustawienie zapasowe dla modeli, których katalog nie opisuje. W przypadku własnej trasy DeepSeek, model bez zadeklarowanych modalności jest traktowany jako tekstowy, dlatego przed dołączeniem obrazu należy wybrać wpis z katalogu obsługujący obrazy (domyślnie deepseek-flash). Obraz wysłany do modelu, który nie deklaruje obsługi obrazów, zostanie odrzucony przed wysłaniem jakichkolwiek danych.

Skierowanie dsh na lokalny punkt końcowy w celu utrzymania kodu na serwerze

Ollama udostępnia API zgodne z OpenAI pod adresem http://127.0.0.1:11434/v1. dsh komunikuje się z dowolnym bazowym adresem URL zgodnym z OpenAI za pośrednictwem niestandardowego dostawcy, dzięki czemu oba komponenty łączą się bezpośrednio. Najpierw skonfiguruj serwer modelu: samodzielne hostowanie LLM za pomocą Ollama na VPS zawiera opis instalacji oraz pobierania modelu.

Przed przystąpieniem do konfiguracji dsh upewnij się, że punkt końcowy odpowiada.

ollama list
curl -s http://127.0.0.1:11434/v1/models

ollama list wyświetla dokładny tag każdego pobranego modelu. Skopiuj ten ciąg znaków. curl zwraca listę tych samych modeli w formacie JSON. Pusta lista oznacza, że Ollama działa, ale nie pobrano żadnych modeli. Connection refused oznacza, że Ollama nie działa lub nie nasłuchuje na porcie 11434.

Wybierz model, który działa na tej maszynie. Zalogowany serwer Ollama udostępnia również modele chmurowe pod tym samym lokalnym adresem, a tag chmurowy, taki jak gemma4:cloud, uruchamia model na serwerach Ollama, więc Twoje zapytania opuszczają serwer, mimo że dsh komunikuje się wyłącznie z 127.0.0.1.

Teraz dodaj dostawcę do poprawki profilu. Podaj niepustą wartość klucza API dla tej konfiguracji; lokalny serwer Ollama ignoruje ten parametr.

- 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>

Wyeksportuj zmienną w miejscu, w którym proces dsh będzie mógł ją odczytać.

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.env

Trzy rodzaje błędów obejmują niemal każdą próbę konfiguracji. MISSING_CREDENTIAL oznacza, że odwołanie wskazane przez apiKeyEnv nie zostało rozwiązane, więc sprawdź zapisane poświadczenia oraz środowisko uruchomieniowe, a nie tylko terminal. UNKNOWN_MODEL oznacza, że id nie pasuje do skonfigurowanego modelu, więc porównaj go znak po znaku z ollama list, uwzględniając tag po dwukropku. Błąd 401 podczas pobierania dostępnych modeli wynika z mechanizmu wykrywania modeli, który wywołuje GET /models pod bazowym adresem URL; punkty końcowe, które nie obsługują tej ścieżki, wymagają ręcznego wpisania modeli.

Kolejną pułapką jest bazowy adres URL. Jeśli pominiesz /v1, żądania trafią do ścieżek nieobsługiwanych przez Ollama, co spowoduje błąd 404 i uniemożliwi uruchomienie modelu. Sufiks jest częścią interfejsu zgodnego z OpenAI, a nie elementem dekoracyjnym.

Jeśli Ollama działa na innej maszynie, adres tej maszyny staje się bazowym adresem URL, a Twoje zapytania będą przesyłane przez sieć otwartym tekstem za pomocą zwykłego HTTP. Utrzymuj usługę na tym samym hoście lub zabezpiecz ją za pomocą TLS (transport layer security) i uwierzytelniania: zabezpieczanie wystawionego punktu końcowego Ollama.

Co opuszcza maszynę w poszczególnych trybach

Przy użyciu klucza DeepSeek i domyślnego punktu końcowego, żądania do modelu trafiają do API DeepSeek. Żądanie to zawiera prompt, zawartość plików odczytanych przez agenta w celu udzielenia odpowiedzi, dane wyjściowe uruchomionych poleceń oraz wszelkie wyniki narzędzi, które agent zdecydował się dołączyć. Kod źródłowy znajduje się wewnątrz tego ładunku za każdym razem, gdy agent otworzy plik. Tak działa model hostowany i dlatego należy zwracać uwagę na to, w jakim katalogu uruchamia się agenta.

Obecne wydania domyślnie dołączają również niezaakceptowany sufiks dziennika zdarzeń sesji do żądań przesyłanych przez natywny adapter DeepSeek, w tym skonfigurowane bramy, jako oddzielne pole dsh_session_log. Model nigdy go nie widzi, ale otrzymuje go miejsce docelowe żądania. Można to wyłączyć w Settings, General („Upload Session Log when using the official model API”) lub ustawiając enabled: false w wtyczce session-log-deepseek. Przełączniki telemetrii poniżej nie kontrolują tego przesyłania.

Dostarczone profile wysyłają również nazwy i wersje aktywnych pakietów wtyczek przez natywny adapter DeepSeek w oddzielnym polu dsh_plugin_packages. Ustaw enabled: false na plugin-package-inventory-deepseek, aby zatrzymać to udostępnianie.

W przypadku innego dostawcy katalogu lub bramy firmowej, ten sam ładunek trafia do danego dostawcy. Bazowy URL wskazuje dokładnie gdzie.

Przy lokalnym punkcie końcowym żądanie do modelu trafia do 127.0.0.1:11434, ale sam adres loopback nie gwarantuje pozostania danych wewnątrz maszyny. Dokumentacja Ollama podaje: „Aby używać modeli chmurowych przez ten serwer, zaloguj się do Ollama”, więc model chmurowy wybrany przez ten sam lokalny serwer wysyła prompty i kod do chmury Ollama. Tylko wtedy, gdy sam model działa lokalnie, żądanie do modelu pozostaje na maszynie. Nawet wtedy trzy elementy nadal przechodzą przez sieć. npx pobiera pakiet z rejestru npm. Każde narzędzie uruchomione przez agenta może samodzielnie uzyskać dostęp do Internetu, w tym serwery MCP (model context protocol), z którymi nawiązano połączenie, co szczegółowo opisano w uruchamianie serwerów MCP na VPS. Wtyczka należy do tej samej kategorii, ponieważ jej instalacja uruchamia kod innego autora z uprawnieniami agenta, więc warto sprawdzić, do czego wtyczka może uzyskać dostęp przed jej instalacją. Dotyczy to również telemetrii, którą obecne wydania autoryzują do eksportu do DeepSeek za każdym razem, gdy przesyłana jest opinia, zarówno w przypadku modelu lokalnego, jak i hostowanego.

Telemetria jest domyślnie ograniczona do opinii. DSH_TELEMETRY_MODE wybiera tryb, a w bieżącej dostarczonej konfiguracji bazowej nieustawiona lub pusta wartość oznacza FEEDBACK_ONLY. W tym trybie zwykła aktywność nie autoryzuje przechwytywania telemetrii. Po przesłaniu pisemnej opinii, utworzeniu lub edycji oceny, edycji notatki lub wycofaniu opinii, dsh autoryzuje eksport prefiksu dziennika sesji, który nie został jeszcze przekazany do eksportera, poprzez to zdarzenie opinii i włącznie z dziedziczonym kontekstem, do https://dsh-otel-collector.deepseeksvc.com/v1/logs. Pełne dostarczenie nie jest gwarantowane: zbyt duże zdarzenie jest odrzucane bez obcinania, a długie prefiksy mogą pozostać częściowo niewysłane przy wyjściu z CLI. Autoryzowane partie mogą kontynuować wysyłanie bez kolejnej interakcji lub wywołania modelu. Plik README telemetrii podaje, że dotyczy to „wszystkich użytkowników i dostawców”, więc uruchomienie modelu lokalnie nie wyłącza tego mechanizmu. DISABLED nie konstruuje żadnego transportu OpenTelemetry (OTel). FULL nie jest już akceptowane: każda wartość inna niż te dwie jest odrzucana z unsupported mode. Eksport opinii może zawierać tekst wiadomości, argumenty i wyniki narzędzi oraz ścieżki obszaru roboczego, więc należy traktować opinię jako autoryzację wysłania tego prefiksu sesji do DeepSeek.

Aby wymusić całkowite zatrzymanie, które nie zależy od poprawnego ustawienia ciągu trybu, należy ustawić DSH_TELEMETRY_DISABLED=1. Każda niepusta wartość jest autorytatywnym wyłączeniem (opt-out), w tym 0 i false, i jest odczytywana przed rozpoczęciem uruchomienia, więc kod projektu nie może go włączyć w trakcie sesji. Domyślny adres kolektora to dsh-otel-collector.deepseeksvc.com; DSH_TELEMETRY_OTLP_URL nadpisuje go.

Należy weryfikować zamiast ufać ustawieniom. Podczas uruchomionego zadania należy wyświetlić listę połączeń wychodzących utrzymywanych przez proces.

sudo ss -tnp | grep -i node

W przypadku lokalnie uruchomionego modelu ruch do modelu wykorzystuje port loopback 11434, ale połączenia publiczne nadal mogą pochodzić z narzędzi bez przesłanej opinii. Dostarczone profile obejmują wyszukiwanie w sieci i pobieranie, a domyślny zestaw uprawnień nie ogranicza dostępu do sieci. Należy zidentyfikować każde publiczne miejsce docelowe przed przypisaniem go do telemetrii; sam czas trwania nie potwierdza, że połączenie jest eksportem opinii. Ten zrzut może również pominąć krótkotrwałe połączenia. Ta kontrola obejmuje tylko proces dsh: ruch modelu chmurowego wychodzi z serwera Ollama, więc należy również potwierdzić, czy model id nie jest tagiem chmurowym. Warto zidentyfikować wszystko inne przed kontynuowaniem pracy. Co agent kodujący wysyła do domu przeprowadza tę samą kontrolę w odniesieniu do innych narzędzi i wyjaśnia, jak interpretować wynik.

Gdzie nie należy przechowywać sekretów

  • Historia powłoki. export DEEPSEEK_API_KEY=sk-... jest zapisywane w ~/.bash_history w postaci jawnej i pozostaje tam długo po rotacji klucza. Poprzedź polecenie spacją, gdy HISTCONTROL=ignorespace jest ustawione, lub pomiń powłokę i zapisz wartość bezpośrednio do pliku z uprawnieniami 600.
  • Zatwierdzone pliki konfiguracyjne (dotfiles). Klucz w ~/.bashrc lub ~/.zshrc znajduje się o jedno git add od publicznego repozytorium, jeśli przechowujesz pliki konfiguracyjne w git. Uruchom git grep -I -n 'sk-' w tym repozytorium przed wykonaniem push.
  • Pliki łatek profilu. Użyj apiKeyEnv dla niestandardowych dostawców, aby cordis.patch.yml zawierało nazwę zmiennej zamiast sekretu. Pliki konfiguracyjne są wklejane do zgłoszeń o błędach i czatów wsparcia technicznego. Pliki z danymi uwierzytelniającymi nie powinny być.
  • Dane wyjściowe env i zrzuty ekranu terminala. Wszystko, co wyświetla całe środowisko, wyświetla również klucz.
  • Kopie zapasowe. ~/.dsh warto archiwizować, ale .credentials.yaml wewnątrz niego to aktywny sekret. Wyklucz ten plik lub zaszyfruj archiwum.

Te zasady nie dotyczą wyłącznie dsh, a utrzymywanie sekretów poza plikami env w Compose omawia ten sam problem po stronie kontenerów na tym samym serwerze.

Praca z wersją developer preview

Należy przypiąć przetestowaną wersję, ponieważ w wydaniach typu patch wersja preview może zmienić klucz konfiguracyjny, co spowoduje błąd ładowania u dostawcy. Jeśli przypięta instalacja odmawia uruchomienia lub npx ciągle dostarcza kompilację, której nie wybrano, błędy instalacji i wersji generowane przez preview opisują sposób obsługi pamięci podręcznej npx oraz npm dostarczanego z Node. Należy przechowywać katalog domowy cordis.patch.yml oraz pliki patch w profiles/ w systemie kontroli wersji, wykluczając plik z poświadczeniami, aby umożliwić weryfikację zmian po aktualizacji.

Dwie flagi pomagają w przypadku nieprawidłowego działania profilu. --dump-default-config wyświetla złożoną konfigurację domyślną bez uruchamiania usługi, a --dump-config wyświetla w ten sam sposób złożoną konfigurację dla danego profilu. Porównanie obu wyników pokazuje, co faktycznie zmieniła warstwa patch, co jest szybsze niż ręczna analiza warstw.

dsh --profile web --dump-config

W przypadku awarii po aktualizacji należy uruchomić to polecenie w pierwszej kolejności. Klucz, który został przeniesiony między wydaniami, pojawi się jako brakująca gałąź w zrzucie, a naprawa będzie wymagała jedynie edycji jednej linii zamiast ponownej instalacji.

FAQ

Gdzie dsh przechowuje mój klucz API DeepSeek?

W $DSH_HOME/.credentials.yaml, co oznacza ~/.dsh/.credentials.yaml, chyba że samodzielnie ustawiono DSH_HOME. Strona Models zapisuje tam klucz, a ustawienia przechowują jedynie odwołanie do niego, dzięki czemu sekret znajduje się w jednym pliku. Sprawdź uprawnienia za pomocą stat -c '%a %n' ~/.dsh/.credentials.yaml i ustaw je na 600, jeśli są bardziej liberalne. Własny dostawca pozwala całkowicie uniknąć użycia pliku poprzez zdefiniowanie zmiennej środowiskowej za pomocą apiKeyEnv.

Jak skonfigurować dsh, aby używał modelu lokalnego zamiast API DeepSeek?

Dodaj własnego dostawcę, którego bazowy URL jest lokalnym punktem końcowym zgodnym z OpenAI. Dla Ollama jest to http://127.0.0.1:11434/v1, z api: openai-completions oraz modelem id skopiowanym dokładnie z ollama list. Podaj niepustą wartość klucza API dla tej konfiguracji; lokalny serwer Ollama ignoruje ten parametr. Przed edycją konfiguracji dsh potwierdź działanie punktu końcowego za pomocą curl -s http://127.0.0.1:11434/v1/models, ponieważ niedziałający punkt końcowy i błędna konfiguracja generują podobne komunikaty o błędach.

Czy dsh domyślnie wysyła mój kod na zewnątrz?

W przypadku modelu hostowanego – tak. Prompt oraz zawartość plików odczytanych przez agenta są częścią żądania API do dostawcy. Żądania przesyłane przez natywny adapter DeepSeek, w tym skonfigurowane bramy, domyślnie zawierają również sufiks dziennika sesji, dopóki nie wyłączy się przesyłania w Settings, General. W przypadku modelu uruchomionego lokalnie przez Ollama, żądanie trafia na interfejs loopback i pozostaje na maszynie, jednak model chmurowy, taki jak gemma4:cloud, przekazuje je do chmury Ollama przez ten sam adres loopback. Wbudowane funkcje wyszukiwania w sieci, pobierania danych, inne narzędzia oraz wtyczki mogą łączyć się z usługami publicznymi niezależnie od mechanizmu przesyłania opinii. Telemetria to osobny kanał: w bieżących wydaniach DSH_TELEMETRY_MODE wskazuje na FEEDBACK_ONLY, jeśli nie ustawiono inaczej, więc opinia autoryzuje eksport prefiksu dziennika sesji przez to zdarzenie, w tym dziedziczony kontekst, dla każdego dostawcy, wliczając modele lokalne. Dostarczenie nie jest gwarantowane, a autoryzowane przesyłanie może trwać po zakończeniu interakcji z opinią. Ustaw DISABLED, aby wyłączyć eksportera, lub DSH_TELEMETRY_DISABLED=1 dla opcji rezygnacji, która jest odczytywana przed uruchomieniem.

Dlaczego dsh zgłasza MISSING_CREDENTIAL, mimo że moja zmienna jest ustawiona?

Ponieważ odwołanie wskazane przez apiKeyEnv musi zostać rozpoznane w źródłach poświadczeń dsh. Zapisane poświadczenia mają pierwszeństwo przed środowiskiem uruchomieniowym, a następnie plikami .env i $DSH_HOME/.env z katalogu wywołującego. Zmienna wyeksportowana w powłoce nie dociera do usługi systemd, sesji innego użytkownika ani procesu uruchomionego przed eksportem zmiennej. Umieść wartość w pliku EnvironmentFile z uprawnieniami 600 dla danej jednostki lub wyeksportuj ją w tej samej powłoce, która uruchamia dsh. Sprawdź, co faktycznie zawiera uruchomiony proces za pomocą sudo tr '\0' '\n' < /proc/$(pgrep -f dsh | head -1)/environ.

Jakiej wersji Node.js wymaga dsh?

Node.js 24.9 lub nowszej, zgodnie z plikiem package.json w repozytorium na dzień 5 listopada 2026. Linia 22 nie jest już wspierana, a wersje Node 24.0 do 24.8 są niewystarczające. Uruchom node -v przed wykonaniem jakichkolwiek innych działań, ponieważ błąd uruchomienia wynikający z nieobsługiwanego środowiska wykonawczego wygląda jak uszkodzona instalacja i skłania użytkowników do reinstalacji pakietu zamiast środowiska wykonawczego.

Czy ten artykuł był przydatny?