SSD Nodes Learn Hosting plans →
Przewodniki Matt ConnorAutor: Matt Connor

Błędy instalacji i wersji DeepSeek Harness

Wersja latest DeepSeek Harness nadal jest prerelease. Użyj dokładnej wersji dsh, wyczyść pamięć podręczną npx i sprawdź faktycznie uruchamiany npm.

Czym naprawdę jest instalacja DeepSeek Harness

Instalacja DeepSeek Harness sprowadza się do jednego polecenia: npx @deepseek-ai/dsh web. Nie ma instalatora ani usługi wymagającej konfiguracji. Większość problemów nie dotyczy instalacji. Dotyczą one rozwiązywania wersji: tego, którą kompilację @deepseek-ai/dsh narzędzie npx wybrało do uruchomienia, oraz tego, czy dana wersja Node.js może ją uruchomić. Po uruchomieniu domyślnym adresem nasłuchiwania jest localhost; ustawienia nasłuchiwania można zmienić za pomocą --host i --port, a wyświetlany adres używa --public-url, gdy ta opcja jest skonfigurowana. Domyślne wiązanie oraz przyczyna, dla której Web UI odpowiada wyłącznie na 127.0.0.1:3080 to odrębny problem, niezwiązany z zagadnieniami opisanymi na tej stronie.

Poniższe informacje wynikają z dwóch faktów. Po pierwsze, każda wersja @deepseek-ai/dsh opublikowana w npm do 27 October 2026 była wersją prerelease. Większość z nich to release candidate (-rc.N), a od 30 August 2026 dostępne są również kompilacje alpha (-alpha.N). Tag latest wskazuje na wersję release candidate. Na 6 November 2026 jest to 0.2.2-rc.1. Po drugie, README projektu informuje, że harness znajduje się w fazie developer preview, jest intensywnie rozwijany i będzie zawierać zmiany powodujące niezgodność. Flaga działająca w zeszłym tygodniu może nie być dostępna w tym tygodniu. Przypisz wersję, zanim zbudujesz na niej jakiekolwiek rozwiązanie.

Najpierw kilka terminów. dsh to narzędzie wiersza poleceń DeepSeek Harness. Node.js to wymagane środowisko uruchomieniowe JavaScript. npx to narzędzie do uruchamiania pakietów dostarczane z npm (node package manager); pobiera pakiet na żądanie zamiast instalować go na stałe. Jeżeli użycie słowa harness w tym zdaniu jest niejasne, harness agenta to program otaczający model, który obsługuje pętlę działania, narzędzia, uprawnienia i stan sesji. Z tego powodu nieustalony przez użytkownika numer wersji może zmienić sposób działania agenta.

Jakiej wersji Node.js wymaga dsh?

10 października 2026, gdy repozytorium było w wersji 0.2.1-alpha.2, jego główny package.json deklarował "engines": {"node": "^22.19.0 || >=24.0.0"}. Nie jest to już wymaganie. Sprawdzenie z 27 października 2026, gdy repozytorium było w wersji 0.2.1-rc.3, pokazuje, że główny package.json deklaruje "engines": {"node": ">=24.9.0"}, a kod źródłowy CLI w package.json deklaruje obecnie to samo. Nota dotycząca decyzji projektowej z 15 października 2026 wskazuje, że instalacje Node 22 muszą zostać zaktualizowane. Node 24.0 również nie wystarcza, ponieważ punkty wejścia korzystają z import.meta.main, którego brakuje w wersji 24.0. Wymagana jest więc wersja Node 24.9.0 lub nowsza. Node 20 i Node 22 odpadają. Nie można też używać żadnego wydania Node 24 wcześniejszego niż 24.9.0. Podczas sprawdzania 27 października 2026 tagi wydań dla 0.2.1-rc.2, następnie kompilacja wskazana przez latest oraz 0.2.1-rc.3 nadal zawierały stary zakres, dlatego nowe minimum pojawiło się później. Należy mimo to planować użycie wersji 24.9.0, ponieważ taki zakres deklaruje obecnie projekt.

Najpierw sprawdź bieżące środowisko.

node -v
npm -v

To właśnie zaskakuje wielu użytkowników. 27 października 2026 opublikowany pakiet @deepseek-ai/dsh nadal nie zawierał własnego pola engines w żadnej z 38 wersji aż do 0.2.1-rc.4. Główny katalog monorepo deklaruje to pole, ale ten plik główny nie jest publikowany w npm. Kod źródłowy CLI w package.json otrzymał to pole w commicie z 15 października 2026, jednak żadna z opublikowanych kompilacji sprawdzonych 27 października nie zawierała tego pola. W rezultacie te kompilacje nie przekazywały npm wymagania dotyczącego wersji Node właściwego dla dsh. Według stanu z 6 listopada 2026 opublikowany pakiet 0.2.2-rc.1 deklaruje "engines": {"node": ">=24.9.0"}. npm traktuje engines jako informację pomocniczą, chyba że zostanie ustawione engine-strict, dlatego przy ustawieniu domyślnym należy oczekiwać najwyżej ostrzeżenia. W nieobsługiwanej wersji Node instalacja może wyglądać na poprawnie zakończoną, a błąd pojawi się później, gdy załadowany kod użyje składni lub API niedostępnych w danym środowisku uruchomieniowym. Nie istnieje jeden stabilny komunikat błędu, którego można szukać, ponieważ pierwsza błędna linia zależy od kolejności ładowania modułów. Należy odczytać node -v, zamiast analizować sam komunikat awarii.

Jeżeli używana wersja Node jest zbyt stara, nvm (node version manager) jest najmniej inwazyjnym rozwiązaniem na VPS. Instaluje się w katalogu domowym i nie modyfikuje systemowej wersji Node.

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.6/install.sh | bash
exec $SHELL -l
nvm install 24
nvm use 24
node -v

node -v powinno teraz wyświetlić wersję zaczynającą się od v24.. Jeżeli powłoka nadal zgłasza starą wersję, uruchom which node. Ścieżka spoza ~/.nvm ma zwykle jedną z dwóch przyczyn. Funkcja powłoki nvm mogła nie zostać załadowana. W takim przypadku otwórz nową powłokę logowania i spróbuj ponownie. Możliwe też, że w profilu powłoki znajduje się wiersz zmieniający PATH po wierszach, które wczytują nvm, i umieszczający inną wersję Node wcześniej. Przenieś ten wiersz przed wiersze nvm. Node 24 był linią active LTS (long term support) 10 października 2026, a 20 października 2026 przeszedł do trybu maintenance. Jego najnowsze wydanie z 29 października 2026 to 24.22.2, czyli znacznie więcej niż wymagane minimum 24.9.0. Node 26, na który również zezwala zakres >=24.9.0, przeszedł do active LTS 28 października 2026 w wersji 26.13.0. Obie wersje spełniają wymaganie minimalne i obie zawierają wersje npm z poprawką dotyczącą range-cache opisaną poniżej. Oficjalne pliki binarne Node 26 dla Linux wymagają również libatomic, które może wymagać osobnej instalacji w używanej dystrybucji.

Dlaczego npx codziennie uruchamia inną wersję?

npx @deepseek-ai/dsh web nie określa wersji. Jeśli jednak projekt w bieżącym katalogu ma już zainstalowany @deepseek-ai/dsh, npx uruchamia tę kopię. W przeciwnym razie npx odpytuje registry o wersję wskazywaną przez tag latest. Ten tag często się zmienia. 0.1.0-rc.8 wydano 19 August 2026, dwa dni po 0.1.0-rc.7. 10 October 2026 latest wskazywał na 0.2.0-rc.2, a 27 October 2026 na 0.2.1-rc.2. Za każdym razem, gdy tag się zmienia, polecenie zapisane w notatkach zaczyna uruchamiać inny kod. Dzieje się to bez pytania i bez wyświetlenia changelogu.

Każdy element tego mechanizmu można sprawdzić z poziomu wiersza poleceń.

npm view @deepseek-ai/dsh dist-tags
npm view @deepseek-ai/dsh versions --json
npm view @deepseek-ai/dsh time --json

dist-tags pokazuje, na co obecnie wskazuje latest. 10 October 2026 zarówno latest, jak i next wskazywały na 0.2.0-rc.2, a trzeci tag, alpha, wskazywał na 0.2.1-alpha.2, wydany dzień wcześniej. 27 October 2026 latest wskazywał na 0.2.1-rc.2, next na 0.2.1-rc.4, wydany dzień wcześniej, a alpha na 0.2.1-alpha.5. Na dzień 6 November 2026 latest wskazuje na 0.2.2-rc.1. 4 November 2026 next wskazywał na 0.2.1-rc.5, a alpha na 0.2.2-alpha.3. Tag latest nadal wybiera wersję prerelease. Lista versions jest ciekawsza, ponieważ zawiera luki. 10 October 2026 obejmowała 31 wersji, od 0.0.1-rc.1 do 0.2.1-alpha.2, a 27 October 2026 obejmowała 38 wersji, z których każda nadal była wersją prerelease. Linia 0.0.1 przeskakuje z -rc.2 do -rc.5, linia 0.1.0 przeskakuje z -rc.3 do -rc.6, kompilacje alpha zaczynają się od 0.1.2-alpha.2 i 0.1.3-alpha.2, a 0.1.4 w ogóle nie występuje. Na opublikowanej liście brakuje numerów, a kompilacje alpha i release candidate są wymieszane na tej samej liście. Próba odgadnięcia kolejnego -rc.N w skrypcie wdrożeniowym zakończy się niepowodzeniem. Należy odczytać listę zamiast zwiększać numer kolejno.

Dlaczego npx nadal uruchamia starą wersję?

Jest to przeciwne zgłoszenie, ale oba przypadki są możliwe, zależnie od specyfikacji pakietu, instalacji lokalnej oraz używanej wersji npm.

npx przechowuje własny katalog pakietów, oddzielony od pamięci podręcznej archiwów tarball, w folderze _npx wewnątrz pamięci podręcznej npm. Wyświetl tę ścieżkę i sprawdź jej zawartość.

npm config get cache
ls "$(npm config get cache)/_npx"

npm 10.9.3 sprawdza już rejestr dla samej nazwy pakietu poza instalacją projektu. npm 11.2.0 zmienił sposób sprawdzania aktualności pamięci podręcznej dla zakresów wersji. Gdy specyfikacją jest sama nazwa, a pakiet nie jest już zainstalowany w bieżącym projekcie, npx pobiera manifest za pomocą preferOnline: true i ponownie używa kopii z pamięci podręcznej w _npx tylko wtedy, gdy rozstrzygnięty tarball odpowiada temu zwróconemu przez rejestr. Sama nazwa nadal wskazuje wersję zainstalowaną w bieżącym projekcie, bez sprawdzania rejestru. W przypadku zakresu wersji npm 10.9.3 akceptuje zgodną wersję z pamięci podręcznej, natomiast npm 11.2.0 i nowsze sprawdzają, czy zakres nie wskazuje nowszej wersji.

O zachowaniu decyduje faktycznie uruchamiana wersja npm. Jeżeli npm nie został osobno zaktualizowany za pomocą npm install -g npm, jest to wersja dołączona do używanego wydania Node:

  • Node 20.20.2 zawiera npm 10.8.2.
  • Node 22.19.0 zawiera npm 10.9.3.
  • Node 22.23.4, najnowsze wydanie 22 na dzień 27 October 2026, zawiera npm 10.9.9.
  • Node 24.9.0, bieżąca minimalna wersja obsługiwana przez harness, zawiera npm 11.6.0.
  • Node 24.19.0 zawiera npm 11.17.0.
  • Node 24.22.2, najnowsze wydanie 24 na dzień 29 October 2026, zawiera npm 11.19.1.
  • Node 26.13.0, najnowsze wydanie 26 na dzień 29 October 2026, zawiera npm 11.20.0.

Cała linia Node 22 zawiera więc wersję npm starszą niż 11.2.0. Harness obsługiwał Node 22 do połowy October 2026 i obecnie już go nie obsługuje, ale serwer, na którym wcześniej działał dsh, może nadal korzystać z tej wersji. Dołączony do Node 22.19.0 npm 10.9.3 ponownie sprawdza samą nazwę npx @deepseek-ai/dsh web w rejestrze poza instalacją projektu, dlatego sam stary wpis _npx nie wyjaśnia używania starego kandydata wydania. Każde wydanie Node akceptowane obecnie przez harness, od 24.9.0 wzwyż, zawiera npm 11.6.0 lub nowszy. Obejmuje to również poprawkę dotyczącą pamięci podręcznej zakresów wersji. Instalacja projektu może jednak nadal mieć pierwszeństwo. Sprawdź, co raportuje narzędzie:

npx @deepseek-ai/dsh --version

Czyszczenie pamięci podręcznej npx

W npm 11.2.0 i nowszych dostępne są dedykowane podpolecenia.

npm cache npx ls
npm cache npx rm --force

Bez --force npm odmawia usunięcia całej zawartości i wyświetla Please use --force to remove entire npx cache. Najpierw użyj npm cache npx ls, gdy chcesz usunąć pojedynczy wpis według klucza, a nie wszystkie wpisy.

W npm 10 te podpolecenia nie istnieją, dlatego katalog należy usunąć ręcznie.

rm -rf "$(npm config get cache)/_npx"

npm cache clean --force nie pomaga w tym przypadku. Czyści _cacache, czyli magazyn tarballi, ale pozostawia _npx bez zmian. To rozdzielenie jest dokładnie powodem, dla którego npm dodał później podpolecenia npm cache npx. Wyczyszczenie _npx nie powoduje trwałej utraty danych: katalog zawiera pobrane pakiety, natomiast stan harness znajduje się oddzielnie w $DSH_HOME, w tym profiles/<name>, sessions, storages i .credentials.yaml, i pozostaje nienaruszony.

Jak przypiąć dokładną wersję release candidate?

Należy podać pełny ciąg wersji, w tym część -rc.N.

npx --yes @deepseek-ai/dsh@0.1.0-rc.7 web

Przykłady na tej stronie używają 0.1.0-rc.7. Należy zastąpić ją wersją, która została faktycznie przetestowana. 27 października 2026 tag latest wskazywał na 0.2.1-rc.2.

--yes akceptuje potwierdzenie instalacji pakietu przez npx bez interaktywnego monitu.

Dokładna wersja przypina pakiet dsh, ale nie gwarantuje uruchomienia w trybie offline. npx buduje klucz katalogu pamięci podręcznej na podstawie wprowadzonego ciągu specyfikacji i może użyć dokładnej wersji zainstalowanej już w tym katalogu. Jeśli jednak nie ma tam pasującej instalacji lokalnej, wcześniejsze sprawdzenie lokalnego drzewa pobiera manifest za pomocą preferOnline: true przed sprawdzeniem _npx. Dokładna wersja zainstalowana w projekcie lokalnym pozwala uniknąć tego odwołania do manifestu. Uruchomienie samej nazwy poza projektem, w którym zainstalowano dsh, również powoduje odwołanie do manifestu, także w npm 10.9.3.

Instalacja globalna działa tak samo i zapewnia krótsze polecenie.

npm install -g @deepseek-ai/dsh@0.1.0-rc.7
dsh --version

Nie znaleziono pasującej wersji dla @deepseek-ai/dsh@^0.1.0

Na dzień 27 października 2026 zwykły zakres z operatorem daszka lub tyldy nie działał dla tego pakietu. npm install -g @deepseek-ai/dsh@^0.1.0 zwróciło kod błędu ETARGET oraz wiersz No matching version found for @deepseek-ai/dsh@^0.1.0. Rejestr działa prawidłowo. Wynika to z reguły semver: zakres wersji nie pasuje do wersji prerelease, chyba że jeden z własnych komparatorów zakresu określa wersję prerelease z tymi samymi numerami major, minor i patch. Wszystkie opublikowane wersje tego pakietu na dzień 27 października 2026 były wersjami prerelease: -rc.N albo -alpha.N, a ^0.1.0 nie określało żadnej wersji prerelease, więc zakres nie pasował do niczego. Należy podać dokładną wersję.

Ta reguła działa w obie strony. Zwykły zakres nigdy nie przejdzie samoczynnie na nową wersję release candidate, ale zakres określający wersję prerelease może tak zrobić. ^0.1.0-rc.7 oznacza >=0.1.0-rc.7 <0.2.0-0, dlatego akceptuje 0.1.0-rc.8 i zaakceptowałby końcową wersję 0.1.0, natomiast 0.1.1-rc.1 pozostaje wykluczone, ponieważ jego numery są inne. Jest to częściowo przypięty stan między dokładną wersją a zmiennym tagiem. Zmienia on uruchamianą wersję bez żadnej zmiany po stronie użytkownika. Jeśli ma być używana wyłącznie przetestowana wersja, należy podać dokładną wersję.

Czy należy używać npx, czy zainstalować dsh globalnie?

Użyj npx do wstępnego sprawdzenia, ponieważ pakiet pozostaje w katalogu pamięci podręcznej, który wiesz już jak wyczyścić. Użyj przypiętej instalacji globalnej dla wszystkiego, co musi działać po restarcie, na przykład agenta programistycznego utrzymywanego na serwerze VPS.

Obie metody mogą powodować rozbieżności na maszynie, na której użyto obu, więc należy je porównać.

which dsh
dsh --version
npx @deepseek-ai/dsh --version

which dsh brak wyników zaraz po udanej instalacji globalnej prawie zawsze oznacza, że globalny katalog binarny npm nie znajduje się w Twoim PATH. Uruchom npm prefix -g, aby wyświetlić ścieżkę główną; pliki binarne znajdują się w folderze bin wewnątrz niej.

Uwaga dotycząca bezpieczeństwa. npx pobiera i wykonuje kod z rejestru za każdym razem, gdy rozwiązuje nową zależność, co na serwerze stanowi realne zagrożenie, a nie tylko teoretyczne. Przypinanie wersji jest częścią rozwiązania. Reszta znajduje się w sposobach, w jakie ataki na łańcuch dostaw npm docierają do serwera.

Znaczenie wersji deweloperskiej preview dla odtwarzalności

0.1.0-rc.6 opublikowano 13 sierpnia 2026, a 0.1.0-rc.7 17 sierpnia 2026. Dzieliły je cztery dni. Tempo nie spadło: między 19 sierpnia a 9 października 2026 opublikowano 24 kolejne wersje, w tym 0.2.0-rc.1 28 września oraz 0.2.0-rc.2 następnego dnia. Kolejne siedem wersji wydano między 14 a 26 października 2026, aż do 0.2.1-rc.4. Przy takim tempie instrukcje napisane miesiąc temu mogą opisywać wiersz poleceń, który już nie istnieje. Dotyczy to również tej strony. Każde twierdzenie dotyczące wersji należy opatrzyć datą, także we własnych notatkach.

Dwa nawyki ułatwiają pracę z wersją preview. W każdym poleceniu i każdym skrypcie należy przypinać dokładną wersję, aby ponowne zbudowanie serwera wybierało tę samą wersję dsh. Samo to nie odtwarza zależności. Opublikowany pakiet 0.2.2-rc.1 używa zakresów takich jak js-yaml: ^4.3.2 i commander: ^15.0.0 oraz nie zawiera pliku npm shrinkwrap. Aby instalować zależności w sposób powtarzalny, należy trzymać dsh w lokalnym projekcie z zatwierdzonym plikiem package-lock.json i ponownie budować projekt za pomocą npm ci. Następnie należy odczytywać wynik pomocy z przypiętej kompilacji, a nie z dowolnego poradnika.

npx @deepseek-ai/dsh@0.1.0-rc.7 --help
npx @deepseek-ai/dsh@0.1.0-rc.7 web --dump-config

Drugą częścią odtwarzalności jest profil. dsh --profile <name> uruchamia profil zapisany w $DSH_HOME/profiles/<name>, a profile web i headless są tworzone na podstawie dostarczonych szablonów przy pierwszym użyciu. W profilu można umieścić poprawkę zawierającą ustawienia modelu i endpointu, ale zapisane klucze API znajdują się w $DSH_HOME/.credentials.yaml. Ustawienia przechowują odwołania do poświadczeń, dlatego przypięta wersja i działająca konfiguracja to dwie osobne kwestie, które należy poprawnie skonfigurować. Poprawki na poziomie katalogu domowego oraz wiersza poleceń mogą zastępować ustawienia profilu. Pakiety wbudowane są rozwiązywane z instalacji dsh, która jest aktualnie uruchomiona. Oznacza to, że zmiana przypiętej wersji zmienia również te pakiety. Wtyczki spoza drzewa zachowują się inaczej. Znajdują się w katalogu profilu, a dsh plugin --profile <name> add <package> przekazuje ich argumenty do pnpm w celu ich instalacji. Dlatego pnpm musi znajdować się w PATH. dsh wyraźnie informuje o tym, gdy nie jest dostępny. Każda dodana wtyczka działa z tymi samymi uprawnieniami co agent. Warto więc sprawdzić, do jakich zasobów wtyczka może uzyskać dostęp przed jej instalacją. Własny plik package.json profilu deklaruje te wtyczki. Należy zachować jego pnpm-lock.yaml i używać pnpm install --frozen-lockfile, aby odtworzyć również wersje ich zależności.

Ten podział będzie znajomy osobom, które przechowywały narzędzia Python w izolowanych środowiskach na serwerze: narzędzie i dodawane do niego elementy są przypinane w osobnych miejscach. Po uruchomieniu środowiska kolejne pytanie zwykle dotyczy sieci, a nie wersji. W tym miejscu przydatne są dostęp do interfejsu Web dsh na zdalnym VPS oraz bardziej szczegółowa instrukcja instalowania DeepSeek Harness na VPS.

Błędy argumentów, które rzeczywiście mogą wystąpić

Błędy te pochodzą z własnego parsera CLI i każdy z nich wskazuje dokładny problem. Treść komunikatów w większości pozostaje taka sama między kompilacjami, ale nie zawsze. Poniższe komunikaty sprawdzono względem 0.2.0-rc.2 6 października 2026.

error: --profile <name> is required

Uruchomiono npx @deepseek-ai/dsh bez podkomendy i profilu. Samodzielne polecenie uruchamia profil, dlatego wymaga jego nazwy. dsh web działa bez --profile, ponieważ parser interpretuje pierwsze słowo bez prefiksu jako nazwę profilu i uruchamia dostarczony profil web.

error: --patch needs a path

--patch przekazano bez następującej po nim wartości. Flagę można powtarzać, a każde jej wystąpienie wymaga ścieżki do jednego pliku.

error: --dump-config and --dump-default-config are mutually exclusive

Należy wybrać jedną opcję. W 0.2.0-rc.2, na które wskazywała kompilacja latest z 6 października 2026, komunikat wymienia trzecią flagę i ma treść error: --dump-config, --dump-default-config, and --dump-config-schema are mutually exclusive, ponieważ --dump-config-schema, które wyświetla JSON Schema dla wpisów profili i poprawek, zostało dodane do pozostałych dwóch opcji. --dump-default-config wyświetla warstwy dostarczonego pakietu i nie akceptuje żadnego --patch. --dump-config wyświetla złożoną konfigurację profilu. Wszystkie trzy opcje nie uruchamiają harnessu, ale zebranie schematu importuje moduły pluginów i może wywoływać gettery oraz leniwie tworzone konstruktory. Należy analizować wyłącznie zaufane pluginy i wymuszać zewnętrzny limit czasu w skryptach.

error: plugin needs pnpm arguments to forward (e.g. add <package>)

dsh plugin --profile <name> przekazano bez argumentów do przekazania dalej. Podkomenda inicjalizuje profil, jeśli go brakuje, a następnie przekazuje pozostałą część wiersza poleceń do pnpm. Dlatego wymaga argumentów takich jak add @scope/dsh-plugin-example.

FAQ

Jakiej wersji Node.js wymaga DeepSeek Harness?

Node.js 24.9.0 lub nowszej. W odczycie z 27 października 2026, przy repozytorium w wersji 0.2.1-rc.3, plik główny package.json deklarował >=24.9.0. 10 października 2026 deklarował ^22.19.0 || >=24.0.0, ale notatka projektowa z 15 października 2026 usunęła obsługę Node 22 i podniosła minimalną wersję powyżej 24.0. Node 20 i Node 22 nie będą działać. Nie będzie działać również wersja Node 24 starsza niż 24.9.0. 27 października 2026 żaden opublikowany build npm nie miał własnego pola engines, więc npm nie mógł ostrzec ani zablokować instalacji na podstawie wymaganej przez dsh wersji Node. Zamiast tego nieobsługiwane środowisko kończyło działanie błędem na późniejszym etapie. Opublikowany pakiet 0.2.2-rc.1 sprawdzony 6 listopada 2026 deklaruje już >=24.9.0 w engines.node. npm domyślnie wyświetla ostrzeżenie i odrzuca niezgodne środowisko, gdy włączono engine-strict. Najpierw sprawdź node -v. Każde wydanie Node spełniające wymaganie minimalne zawiera npm 11 lub nowszy, w tym poprawkę npm 11.2.0 dotyczącą zakresu wersji używanego przez npx.

Jak wymusić, aby npx użył najnowszego dsh zamiast wersji z pamięci podręcznej?

npm 10.9.3 i bieżące wersje npm ponownie sprawdzają rejestr dla samej nazwy pakietu, chyba że bieżący katalog jest projektem z zainstalowanym dsh. W takim przypadku npx uruchamia lokalną kopię. Użyj npx @deepseek-ai/dsh@latest --version, aby jawnie zażądać tagu latest z rejestru. npm 11.2.0 zmienił sprawdzanie aktualności dla zakresów wersji, a nie dla samych nazw pakietów. Wyczyść pamięć podręczną npx za pomocą npm cache npx rm --force w npm 11.2.0 i nowszym albo usuń katalog za pomocą rm -rf "$(npm config get cache)/_npx" w npm 10. Następnie potwierdź wynik poleceniem npx @deepseek-ai/dsh --version. Pamiętaj, że npm cache clean --force czyści inny katalog i nie rozwiąże tego problemu.

Dlaczego instalacja @deepseek-ai/dsh@^0.1.0 kończy się błędem?

27 października 2026 npm zwracał kod błędu ETARGET oraz wiersz No matching version found for @deepseek-ai/dsh@^0.1.0.. Wszystkie opublikowane buildy dostępne podczas tego sprawdzenia były wydaniami prerelease, takimi jak 0.2.0-rc.2 lub 0.2.1-alpha.2. Zakres semver nie pasuje do wersji prerelease, chyba że sam zakres zawiera wydanie prerelease z tymi samymi numerami major, minor i patch. Zainstaluj dokładny ciąg wersji wraz z sufiksem. Uruchom npm view @deepseek-ai/dsh versions --json, aby sprawdzić dostępne wersje, ponieważ w sekwencji występują luki.

Czy należy zainstalować dsh globalnie, czy uruchamiać go przez npx?

npx nadaje się do pierwszego sprawdzenia, ponieważ pakiet pozostaje w katalogu pamięci podręcznej. Harness tworzy również trwały stan profilu. Przypięta instalacja globalna, na przykład npm install -g @deepseek-ai/dsh@0.1.0-rc.7, jest odpowiednia dla zastosowań, które muszą działać stale, ponieważ wersja zmienia się tylko po jej jawnej zmianie. Jeżeli po instalacji globalnej nie można znaleźć polecenia dsh, katalog globalnych plików binarnych npm nie znajduje się w zmiennej PATH. Polecenie npm prefix -g wyświetla katalog główny, w którym ten katalog się znajduje.

Czy DeepSeek Harness jest już wystarczająco stabilny, aby na nim budować?

Jeszcze nie, zgodnie z własnym opisem projektu. README stwierdza, że projekt znajduje się w fazie developer preview, jest szybko rozwijany i będzie zawierać zmiany powodujące niezgodność. Wydania release candidate 0.1.0-rc.6 i 0.1.0-rc.7 opublikowano w odstępie 4 dni w sierpniu 2026. Wydania 0.2.0-rc.1 i 0.2.0-rc.2 opublikowano w odstępie 1 dnia we wrześniu 2026. Wydania 0.2.1-rc.1 i 0.2.1-rc.2 opublikowano tego samego dnia w październiku 2026. W październiku 2026 zmienił się również obsługiwany zakres wersji Node. Przypnij dokładną wersję i odczytaj --help z tej przypiętej wersji, a nie z dowolnego poradnika. Opatruj własne notatki datą, aby można było ocenić, jak bardzo się zdezaktualizowały.

Czy ten artykuł był przydatny?