Wtyczki dsh: jak działają i jak je bezpiecznie sprawdzać
Wtyczki dsh uruchamiają zewnętrzny kod z uprawnieniami agenta. Dowiedz się, do jakich zasobów mają dostęp i jak zweryfikować bezpieczeństwo pakietu przed instalacją.
Czym jest wtyczka dsh i jakie ma możliwości?
Wtyczki dsh to pakiety Node, które DeepSeek Harness wczytuje do własnego procesu. Po wczytaniu wtyczka wykonuje kod zewnętrzny z uprawnieniami agenta, na maszynie, do której agent ma już dostęp. Sam proces instalacji jest bardziej zabezpieczony. pnpm wstrzymuje skrypty budowania zależności do momentu ich zatwierdzenia, a dokumentacja CLI zaleca: „Zrestartuj profil po dodaniu, usunięciu lub aktualizacji pakietu”, dzięki czemu wtyczka dodana za pomocą dsh plugin wczytuje się przy następnym restarcie. Wtyczka zainstalowana przez stronę internetową Plugins może zostać zastosowana natychmiast. Między wczytaną wtyczką a resztą środowiska harness nie ma żadnych zabezpieczeń. Dlatego przed instalacją należy zadać pytanie, do czego dany kod może uzyskać dostęp i jak ograniczyć ten zakres.
dsh (DeepSeek Harness) to otwartoźródłowe środowisko agentowe DeepSeek AI, zbudowane na frameworku wtyczek o nazwie Cordis. To środkowe określenie jest kluczowe, ponieważ środowisko agentowe to program otaczający model, który zarządza pętlą, narzędziami i uprawnieniami, a wtyczka integruje się z nim dokładnie na tym poziomie. Plik README projektu wskazuje, że wszystko jest wtyczką. Adapter modelu jest wtyczką. Interfejs webowy, w którym wpisuje się polecenia, jest wtyczką. Wszystko, co instalowane jest spoza projektu, trafia do tego samego drzewa i posiada ten sam poziom zaufania, co komponenty dostarczone wraz z oprogramowaniem. Jeśli usługa nie została jeszcze uruchomiona, należy zacząć od DeepSeek Harness na VPS i wrócić tutaj przed dodaniem jakichkolwiek rozszerzeń.
W sierpniu 2026 r. plik AGENTS.md repozytorium wymieniał punkty rozszerzeń, do których wtyczka może uzyskać dostęp, obejmując:
- LLM (duży model językowy): dostawca, za którego płaci klucz API
- Shell: obsługa bash, z dostawcami lokalnymi i pwsh
- Filesystem: dostęp do plików kontrolowany politykami
- Web: dostawcy wyszukiwania i pobierania danych
- Subprocess: dostawca drzewa procesów
- Workflow: wątki robocze
- Subagent: delegowanie zadań do kolejnych agentów
- Settings and credentials: zapisana konfiguracja i zmienne środowiskowe
Lista ta została usunięta z AGENTS.md. Według stanu na 17 listopada 2026 r. plik docs/architecture.md projektu wymienia punkty rozszerzeń, dodając do istniejących (model, narzędzia, shell, system plików, subagent) backendy piaskownicy (sandbox), terminale trwałe, zadania w tle, polecenia użytkownika oraz sesje wyzwalane przez webhooki.
Wtyczka rejestruje również narzędzia w ctx.tools, a dokumentacja wyraźnie wskazuje, że schemat zarejestrowanego narzędzia staje się częścią procesu tworzenia promptu. To drugie zagadnienie jest często pomijane. Wtyczka może zmienić decyzje agenta bez wykonywania nietypowego kodu, ponieważ opis, który dostarcza, staje się tekstem odczytywanym przez model. Jest to problem o tym samym charakterze, co wstrzykiwanie promptów (prompt injection) przeciwko agentom programistycznym, z jedną różnicą: ten tekst pojawia się w momencie instalacji i pozostaje w systemie do czasu usunięcia wtyczki.
W jaki sposób dsh wyszukuje i ładuje wtyczki?
Nie istnieje globalny katalog wtyczek. Uruchomiony dsh to drzewo wtyczek tworzone podczas startu z uporządkowanych warstw, a jednostką przechowującą wybory użytkownika jest profil. $DSH_HOME domyślnie wskazuje na ~/.dsh, a każdy profil znajduje się w $DSH_HOME/profiles/<name>. Profile web oraz headless tworzą się automatycznie przy pierwszym użyciu na podstawie dostarczonych szablonów.
Katalog profilu zawiera dwa pliki, które decydują o całości konfiguracji:
package.json, zawierający zależności wtyczek spoza drzewa oraz manifestdsh.profilez uporządkowaną listąbundlescordis.patch.yml, własna warstwa poprawek nakładana na te pakiety
ls ~/.dsh
ls ~/.dsh/profiles/webProces startu nakłada warstwy w następującej kolejności, przy czym późniejsze warstwy nadpisują wcześniejsze:
- pusty katalog główny
- pakiety profilu, w kolejności określonej w manifeście
- plik
cordis.patch.ymlprofilu $DSH_HOME/cordis.patch.yml- wszelkie nakładki
--patch <path>przekazane w wierszu poleceń
Dwie flagi pozwalają wyświetlić wynik tego złożenia bez uruchamiania jakichkolwiek procesów:
dsh --profile web --dump-default-config
dsh --profile web --dump-config--dump-default-config wyświetla tylko warstwy pakietów. --dump-config dodaje warstwy poprawek profilu i użytkownika oraz wszelkie nakładki --patch, dzięki czemu stanowi najbardziej wiarygodne zestawienie tego, co zostanie załadowane przy następnym starcie. Należy sprawdzić to zestawienie przed zaufaniem maszynie przejętej od innego użytkownika.
Jedno ostrzeżenie dotyczące tych plików poprawek. Konfiguracja nie jest tutaj danymi biernymi, ponieważ format pozwala na wartości oznaczone znacznikiem !!js w bloku config wtyczki. Fragment cordis.patch.yml skopiowany z forum jest kodem, więc należy go traktować tak samo, jak skrypt powłoki pochodzący z tego samego źródła.
Co faktycznie uruchamia dsh plugin add?
dsh plugin --profile <name> <args> przekazuje swoje argumenty do pnpm wewnątrz katalogu danego profilu, dlatego pnpm musi znajdować się w zmiennej PATH. Użyte czasowniki są czasownikami 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 updateModel bezpieczeństwa instalacji wtyczki dsh jest zatem tożsamy z modelem bezpieczeństwa instalacji dowolnej zależności w stylu npm, z dodatkowym krokiem, w którym wynik jest ładowany do agenta. Pakiet dostarcza własne drzewo zależności, a każdy pakiet w tym drzewie trafia do tego samego procesu. Wszystkie informacje zawarte w jak ataki na łańcuch dostaw npm docierają do serwera mają tutaj zastosowanie bez zmian.
pnpm w wersji 10 i nowszych domyślnie nie uruchamia skryptów budowania zależności, a zatwierdzenie odbywa się dla każdego pakietu z osobna poprzez pnpm approve-builds lub ustawienie allowBuilds. W pnpm 11 zastąpiono starsze ustawienie onlyBuiltDependencies parametrem allowBuilds, więc poradnik lub stara konfiguracja nadal używająca onlyBuiltDependencies nie zatwierdza niczego w bieżącej wersji pnpm. Sprawdź posiadaną wersję pnpm:
pnpm --versionWtyczki hostowane w Git są miejscem, w którym napotkasz to po raz pierwszy. Dokumentacja CLI podaje, że wtyczka git, która dostarcza kod źródłowy, buduje go podczas instalacji za pomocą skryptu prepare, więc pierwsze polecenie add kończy się niepowodzeniem z podpowiedzią allowBuilds narzędzia pnpm. Należy skopiować wyświetlony klucz do pliku pnpm-workspace.yaml profilu i uruchomić polecenie ponownie. Zatwierdzenie tego klucza pozwala na uruchomienie procesu budowania repozytorium z uprawnieniami użytkownika. Gotowe archiwa tarball oraz lokalne kopie nie wymagają autoryzacji.
To ustawienie domyślne jest przydatne, ale jest również najbardziej ignorowaną funkcją bezpieczeństwa w tym ekosystemie. Zablokowane skrypty budowania zapobiegają uruchomieniu kodu podczas instalacji. Nie mają one jednak wpływu na samą wtyczkę, ponieważ istotą wtyczki jest to, że mechanizm ją importuje i wywołuje po restarcie profilu lub natychmiast po zastosowaniu instalacji przez stronę internetową Plugins. Wtyczka nie potrzebuje haka postinstall. Została ona zaproszona do systemu.
Co należy przeczytać przed instalacją wtyczki dsh
Pobierz opublikowane archiwum tarball i zapoznaj się z jego zawartością. Rozpakowanie archiwum nie powoduje wykonania żadnego kodu.
npm pack '<package-name>@<version>'
tar -tzf '<package-name>-<version>.tgz'
tar -xzf '<package-name>-<version>.tgz'
less package/package.jsonCztery pola w pliku package.json dostarczają większości niezbędnych informacji. Przeczytaj scripts, aby sprawdzić wpisy preinstall, install oraz postinstall. Przeczytaj dependencies w poszukiwaniu nazw, których nie rozpoznajesz lub które różnią się tylko jednym znakiem od znanych Ci nazw. Przeczytaj bin, aby sprawdzić, czy pakiet wymaga dodania czegokolwiek do zmiennej PATH. Przeczytaj main lub exports, aby zidentyfikować plik wejściowy, a następnie otwórz go i przeanalizuj jego treść.
Następnie przejrzyj kod, który zostanie faktycznie załadowany. Wtyczka reklamująca narzędzie do powiadomień nie ma powodu, aby odczytywać ~/.ssh, łączyć się z nieznanym hostem lub uruchamiać powłokę. Jeśli pakiet zawiera tylko spakowany lub zminimalizowany kod JavaScript, a w publicznym repozytorium nie ma odpowiadającego mu kodu źródłowego, jest to wystarczający powód do rezygnacji. Wybieraj wtyczki, których kod źródłowy możesz przeczytać, i preferuj rozwiązania o niewielkich rozmiarach.
Możesz również odpytać rejestr bez instalowania czegokolwiek:
pnpm view '<package-name>' dependencies
pnpm view '<package-name>' versionsPakiet opublikowany w zeszłym tygodniu, posiadający tylko jedną wersję, brak pola z adresem repozytorium oraz nazwę podszywającą się pod popularne narzędzie, to najstarsza sztuczka stosowana w każdym rejestrze. Weryfikacja pobranych plików za pomocą sum kontrolnych to nawyk, który warto wyrobić: zawsze sprawdzaj, co dokładnie pobrałeś, zanim zezwolisz na uruchomienie kodu.
Przypnij wersję i zachowaj plik blokady
Pływający zakres wersji oznacza, że kod wewnątrz procesu agenta może zmienić się przy każdej instalacji lub aktualizacji bez Twojej decyzji. Przypnij go.
dsh plugin --profile web add --save-exact '<package-name>@<version>'Umiejscowienie flagi różni się w zależności od wersji pnpm, dlatego zweryfikuj wynik zamiast polegać na samym poleceniu. Otwórz plik package.json profilu i upewnij się, że zależność jest zapisana jako konkretna wersja, bez znaków ^ lub ~ przed nią. Ten plik decyduje o tym, co zostanie zainstalowane.
Następnie zachowaj plik blokady, który przypina całe drzewo zależności przechodnich, a nie tylko nazwę najwyższego poziomu:
find ~/.dsh -maxdepth 3 -name 'pnpm-lock.yaml'Skopiuj go w miejsce, które podlega kopiom zapasowym, wraz z plikiem package.json profilu. Te dwa pliki pozwalają odtworzyć to samo drzewo na nowej maszynie. Uruchom dsh plugin --profile web update tylko wtedy, gdy zdecydujesz się na zmianę wersji, nigdy w ramach rutynowego porządkowania, a następnie przejrzyj różnice w pliku blokady.
W przypadku wtyczki instalowanej z git, a nie z rejestru, przypnij commit zamiast gałęzi. Specyfikacja w formacie github:owner/repo#<full commit sha> zapewnia stałe drzewo. Nazwa gałęzi powoduje pobranie zawartości, którą gałąź będzie zawierać w momencie kolejnego rozpoznania przez pnpm, co oznacza przekazanie decyzji podmiotowi zewnętrznemu. Sam mechanizm wymaga tej samej dyscypliny, ponieważ wydanie npm latest jest wersją kandydacką (release candidate), a nieprzypięta instalacja może w dowolnym dniu wskazać na inną wersję, co jest główną przyczyną błędów instalacji i wersji dsh.
Rynek wtyczek i wartość „kuratorstwa”
dsh posiada rynek wtyczek, który instaluje się jako wtyczka. Informuje to o architekturze rozwiązania:
dsh plugin --profile web add dshmarketPo restarcie wtyczka pojawia się jako karta na stronie Plugins, obok Installed, w dsh w wersji 0.2.1 i nowszych. Starsze hosty korzystają z Settings, a następnie Plugin Market. Plik README jasno określa ograniczenia. Instalacje są ograniczone do źródeł wymienionych w kuratorowanym rejestrze, a każda inna próba jest odrzucana. Skrypty budowania są domyślnie blokowane, a włączenie każdego z nich wymaga zatwierdzenia dla konkretnego pakietu. Wtyczki terminalowe są oznaczane przed dodaniem do profilu webowego. Najważniejsze zdanie brzmi: umieszczenie na liście nie jest równoznaczne z rekomendacją, ponieważ wtyczki są kodem stron trzecich. Ten sam plik README podaje, że większość wtyczek instalowanych w ten sposób zaczyna działać po odświeżeniu strony bez konieczności restartu, więc instalacja jednym kliknięciem może uruchomić kod wewnątrz agenta w ciągu kilku sekund.
Kuratorowana lista podnosi standard bezpieczeństwa. Nie oznacza to jednak automatycznego audytu kodu ani gwarancji, co zrobi kolejna wersja wtyczki po zmianie opiekuna konta. Instalację jednym kliknięciem należy traktować tak samo, jak traktowałoby się curl | bash od tego samego autora. Warto powtórzyć jeszcze jeden wiersz z tego README: wyeksportowana kopia zapasowa może zawierać poświadczenia z konfiguracji profilu, dlatego nigdy nie należy dołączać jej do publicznych zgłoszeń błędów ani wklejać na serwisy typu paste. Jeśli zamiast metody poszukiwana jest lista startowa, wtyczki dsh warte zainstalowania stanowi uzupełnienie tego wpisu.
Harness posiada teraz również własną ścieżkę. Eksperymentalny zestaw indeksów Custom plugin, włączany na stronie Plugins, dodaje kartę Discover zasilaną plikami indeksów dodawanymi samodzielnie. dsh nie dostarcza żadnego źródła indeksów, a dokumentacja wskazuje, że indeksy są treściami stron trzecich. dsh weryfikuje format pliku, ale nie sprawdza, co indeks deklaruje na temat tytułu, autora lub źródła wtyczki.
Uruchamianie dsh jako osobny użytkownik, nie jako root
Weryfikacja ogranicza częstotliwość występowania incydentów. Zasada najmniejszych uprawnień określa zakres dostępu w przypadku naruszenia. Na serwerze VPS wdrożenie tego drugiego elementu jest mało kosztowne.
Utwórz dla narzędzia osobne konto unixowe z własnym katalogiem domowym i nigdy nie uruchamiaj go jako root:
sudo adduser --disabled-password --gecos "" dshrun
sudo -iu dshrunWewnątrz tej sesji uruchom narzędzie, aby zapisywało dane w katalogu domowym tego konta:
npx @deepseek-ai/dsh webInterfejs webowy domyślnie działa na http://127.0.0.1:3080. Pozostaw to ustawienie. Jeśli po kliknięciu wyświetlonego linku z innej maszyny nie uzyskano odpowiedzi, wyjaśnienie znaczenia adresu wyświetlanego przez dsh wskazuje przyczynę. Dostarczona kompozycja webowa weryfikuje nagłówki Host oraz Origin i wymaga uwierzytelnionej przeglądarki lub API Peer dla każdej metody Host RPC oraz strumienia WebSocket, a dsh web odrzuca --host 0.0.0.0. Klienci API uwierzytelniają się przez /connect i otrzymują podpisane ciasteczko API. Traktuj to logowanie jako dodatkowe zabezpieczenie, a nie powód do udostępniania portu 3080. Za nim znajduje się agent posiadający dostęp do powłoki, więc wyciek tokena sesji lub błąd logowania na publicznym porcie daje nieuprawnionej osobie zdalną powłokę bez uprawnień roota, wyposażoną w przyjazny interfejs. Łącz się z nim ze swojego laptopa przez tunel SSH:
ssh -L 3080:127.0.0.1:3080 you@your-vpsNastępnie potwierdź, że żaden proces nie nasłuchuje na publicznym adresie:
ss -lnt | grep 3080Adres lokalny powinien wskazywać na 127.0.0.1:3080. Jeśli wskazuje na 0.0.0.0:3080, oznacza to, że za taki stan odpowiadają ustawienia inne niż domyślne dsh web, na przykład inna kompozycja lub zmiana w konfiguracji, a ta kompozycja posiada własny mechanizm uwierzytelniania. Dokumentacja projektu wskazuje, że bazowy serwer webowy nie posiada własnego uwierzytelniania ani polityki Origin, więc dopóki nie zostanie zweryfikowane zabezpieczenie tego portu, należy założyć, że jedyną barierą jest firewall, i przywrócić nasłuchiwanie na interfejsie loopback. Uzasadnienie zawarte w bezpiecznym uruchamianiu Claude Code na VPS ma zastosowanie do dsh bez zmian. Przydziel agentowi jeden katalog roboczy, który może zostać uszkodzony, i przechowuj poza tą maszyną wszystko, czego nie można odtworzyć. Co więcej, traktuj tę maszynę jako jednorazową maszynę wirtualną dla agentów programistycznych, ponieważ odtworzenie VPS zajmuje godzinę, podczas gdy audyt jednej maszyny trwa tydzień.
Gdzie przechowywane są klucze i dlaczego uprawnienia plików mają ograniczone zastosowanie
dsh przechowuje klucze API w $DSH_HOME/.credentials.yaml, a zmienne środowiskowe w $DSH_HOME/.env, natomiast ustawienia modelu znajdują się w cordis.patch.yml aktywnego profilu. Podczas weryfikacji tego przewodnika w październiku 2026 roku, plik $DSH_HOME/settings.yaml z wcześniejszego wydania był importowany jednorazowo i zmieniano jego nazwę na settings.yaml.imported. Informacje o tym, który klucz należy umieścić w konkretnym pliku oraz jakie dane faktycznie opuszczają serwer w poszczególnych trybach, znajdują się w sekcji konfiguracja kluczy API, modeli i punktów końcowych dsh. Warto ustalić to przed dodaniem wtyczki, ponieważ każdy skonfigurowany klucz jest dostępny do odczytu dla wtyczki. Zabezpiecz dwa wrażliwe pliki:
chmod 600 ~/.dsh/.credentials.yaml ~/.dsh/.env
ls -l ~/.dshTryb 600 nadaje właścicielowi uprawnienia do odczytu i zapisu, a wszystkim pozostałym użytkownikom nie nadaje żadnych uprawnień. Warto znać to w obu notacjach (numeryczne i symboliczne tryby chmod). Należy mieć świadomość realnej ochrony, jaką to zapewnia. Tryby plików chronią je przed innymi kontami na serwerze. Nie stanowią jednak ochrony przed wtyczką, ponieważ wtyczka działa jako użytkownik będący właścicielem tych plików, wewnątrz procesu, który je odczytuje. Dlatego utrzymywanie sekretów poza zasięgiem agenta AI oznacza, że w ogóle nie powinno się ich umieszczać na danej maszynie. Serwer z dsh powinien zawierać tylko jeden klucz modelu, którego faktycznie potrzebuje. Poświadczenia chmurowe oraz klucze podpisywania powinny być przechowywane w innym miejscu.
Dlaczego wtyczka odczytująca sieć zmienia model zagrożeń
Warstwa sieciowa (Web seam) udostępnia wtyczkom dostawców wyszukiwania i pobierania danych. Wtyczka, która pobiera stronę do sesji, sprowadza tekst, który może zostać napisany przez atakującego. Prompt modelu nie oddziela instrukcji od danych, więc pobrana strona może zawierać polecenie skierowane do agenta, a środowisko (harness) posiadające uprawnienia powłoki znajduje się o jeden posłuszny krok od jego wykonania.
Mechanizm kontroli istnieje już w środowisku. dsh-base, wspólny pierwszy pakiet profili web, headless, sdk oraz acp, zawiera piaskownicę i politykę zatwierdzania (profil sdk-minimal celowo ją pomija). Należy z tego korzystać. Sesja, która może pobierać niezaufane strony, powinna wymagać zatwierdzenia dla każdej operacji zapisu lub wykonania, aby pobrana instrukcja nie mogła samodzielnie stać się działaniem. Sekcja Ograniczanie działań agenta poprzez zatwierdzenia omawia sposób wyznaczania granic w tym zakresie. Relacja ta działa w obie strony, ponieważ własny serwer jest stroną, którą może pobrać agent innej osoby, co opisano w blokowaniu crawlerów AI na własnym serwerze.
Jak sprawdzić, co zmieniła wtyczka?
Należy wykonać migawkę przed instalacją, przeprowadzić instalację, wykonać migawkę po niej, a następnie odczytać różnice.
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.txtWynik polecenia diff wskazuje, które wpisy wtyczek zostały dodane do drzewa kompozycji podczas instalacji. Do drzewa dołącza się tylko pakiet deklarujący poprawkę typu bundle; zwykła zależność nie dodaje tam żadnych elementów, a dsh wyświetla w takim przypadku jednorazowe ostrzeżenie. Jeśli zainstalowana wtyczka, mająca realizować jedną drobną funkcję, dodaje wiele niezrozumiałych wpisów, należy przerwać proces i przejrzeć kod źródłowy przed uruchomieniem systemu. dsh plugin --profile web why <package-name> odpowiada na drugie pytanie: która z bezpośrednich zależności spowodowała pobranie danego pakietu.
Zainstalowane pakiety trafiają do katalogu node_modules danego profilu, znajdującego się w $DSH_HOME/profiles/<name>/node_modules, więc można również przejrzeć drzewo bezpośrednio na dysku:
ls ~/.dsh/profiles/web/node_modulesNależy utrzymywać drugi profil, w którym nie przeprowadza się żadnych eksperymentów. Gdy instalacja powoduje awarię środowiska, uruchomienie systemu z dsh --profile <clean-name> pozwala w kilka sekund ustalić, czy przyczyną problemu była wtyczka.
Jak usunąć wtyczkę dsh?
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.txtUsunięcie zależności nie zawsze usuwa konfigurację. Wpisy dodane do pliku cordis.patch.yml profilu pozostają w nim, ponieważ jest to plik użytkownika, a środowisko nie modyfikuje go automatycznie. Należy otworzyć ten plik i usunąć blok wskazujący na usunięty pakiet.
less ~/.dsh/profiles/web/cordis.patch.ymlNastępnie należy zająć się kwestią, której nie rozwiąże żadne polecenie odinstalowania. Jeśli wtyczka została usunięta z powodu utraty zaufania, należy założyć, że wszystkie dane, do których miała dostęp, zostały odczytane. Należy wygenerować nowy klucz API DeepSeek w konsoli dostawcy oraz zaktualizować wszelkie inne dane uwierzytelniające przechowywane w $DSH_HOME. Następnie należy zweryfikować, do jakich zasobów w sieci miało dostęp konto użytkownika systemu Unix, na którym uruchomiono wtyczkę.
Skrócona wersja
- Przed instalacją zapoznaj się z opublikowanym archiwum tar, zaczynając od
scriptsoraz pliku wejściowego. - Przypnij dokładną wersję lub konkretny commit w przypadku specyfikacji git i zachowaj plik blokady (lockfile).
- Instaluj w ramach jednego profilu i utrzymuj czysty profil, do którego można powrócić w razie awarii.
- Porównuj
--dump-configprzed i po każdej instalacji. - Uruchamiaj środowisko testowe (harness) jako osobny użytkownik unix, na interfejsie loopback, z dostępem przez SSH.
- Przechowuj jeden klucz API na serwerze i wymieniaj go w dniu usunięcia wtyczki, której nie ufasz.
Powyższe zalecenia nie stanowią powodu do unikania wtyczek. Model wtyczek sprawia, że dsh jest użyteczny, a środowiska, którego nie można rozszerzyć, nie da się utrzymać w dłuższej perspektywie. Są to powody, dla których należy wiedzieć, co zostało zainstalowane, od kogo, w jakiej wersji oraz uruchamiać całość w środowisku, które można odtworzyć.
FAQ
Czy dsh izoluje wtyczki od siebie nawzajem?
Nie. Wtyczka jest ładowana do procesu głównego przez Cordis i uzyskuje dostęp do udokumentowanych interfejsów, w tym powłoki, systemu plików, sieci, podprocesów, podagentów oraz poświadczeń. dsh-base, pierwszy współdzielony pakiet profili web, headless, sdk oraz acp, dostarcza środowisko izolowane (sandbox) oraz politykę zatwierdzania, która określa zakres działań narzędzi agenta; to właśnie ta polityka zapewnia ochronę. Nie istnieje granica uprawnień dla poszczególnych wtyczek, dlatego należy przyjąć model, w którym instalacja wtyczki oznacza rozszerzenie zaufania na jej autora oraz na każdy pakiet w drzewie zależności.
Czy można zainstalować wtyczkę dsh bez uruchamiania jej skryptów instalacyjnych?
pnpm 10 i nowsze wersje domyślnie blokują skrypty budowania zależności, a dsh plugin ... add przekazuje polecenia do pnpm, więc w aktualnej wersji pnpm instalacja nie uruchamia skryptów pakietu, chyba że użytkownik zatwierdzi dany pakiet. Wersję można sprawdzić za pomocą pnpm --version. Nie czyni to jednak nieprzejrzanej wtyczki bezpieczną. Kod wtyczki uruchamia się w momencie załadowania przez główny proces, przy kolejnym restarcie profilu po instalacji dsh plugin lub często bezpośrednio po instalacji z poziomu strony wtyczek w przeglądarce, a żadne ograniczenia czasu instalacji nie mają na to wpływu.
Gdzie fizycznie znajdują się wtyczki dsh i ich konfiguracja?
$DSH_HOME domyślnie wskazuje na ~/.dsh. Profile znajdują się w $DSH_HOME/profiles/<name>, z których każdy zawiera package.json z zależnościami wtyczek oraz manifest dsh.profile uporządkowanych pakietów, a także warstwę poprawek cordis.patch.yml. Zainstalowane pakiety trafiają do katalogu node_modules wewnątrz każdego profilu, pod ścieżką $DSH_HOME/profiles/<name>/node_modules. Klucze znajdują się w $DSH_HOME/.credentials.yaml, zmienne środowiskowe w $DSH_HOME/.env, a plik $DSH_HOME/cordis.patch.yml na poziomie użytkownika ma zastosowanie do wszystkich profili. Należy uruchomić dsh --profile web --dump-config, aby wyświetlić wynikową konfigurację bez uruchamiania systemu.
Czy instalacja z rynku wtyczek dsh jest bezpieczna?
Rynek ogranicza instalacje do źródeł z wyselekcjonowanego rejestru i blokuje skrypty budowania, chyba że zostaną one zatwierdzone dla każdego pakietu z osobna, co stanowi znaczną poprawę w stosunku do wklejania nazw pakietów z komunikatorów. Dokumentacja rynku nadal zaznacza, że obecność na liście nie stanowi rekomendacji, ponieważ wtyczki są kodem firm trzecich stworzonym przez inne osoby. Należy czytać kod źródłowy i przypinać wersje. Główny proces należy utrzymywać na koncie użytkownika, a najlepiej na maszynie, której utrata nie będzie krytyczna.