DeepSeek Harness Desktop App: co instalator faktycznie umieszcza na Twoim komputerze

Aplikacja desktopowa DeepSeek Harness to powłoka Electron wokół tego samego interfejsu webowego, który otrzymujesz z npx @deepseek-ai/dsh web, dostarczana jako trzy instalatory przeznaczone dla poszczególnych platform dla harnessu, który obecnie znajduje się w wersji 0.2.1-rc.2. Ten opis brzmi lekceważąco i nie taki jest jego zamysł. Opakowanie działającego interfejsu w kontener desktopowy to robota na weekend; opakowanie go w kontener, który ma własny katalog środowiska uruchomieniowego, utrzymuje Twoje zadania przy życiu po zamknięciu okna, sam się aktualizuje w kanale bez stabilnego wydania i zachowuje Twoje sesje podczas każdej z tych operacji — to jest ta część, która zajmuje miesiące, i to ta część warta przeczytania. Jeśli chcesz uruchomić DeepSeek-V4.1-Flash przez harness, który żyje w oknie, a nie w terminalu, to jest właśnie ten build, a interesujące pytania dotyczą tego, co dzieje się wokół okna.

Zanim przejdę do szczegółów, trzeba powiedzieć dwie rzeczy. Po pierwsze, ten artykuł zastępuje naszą wcześniejszą informację, że nie ma aplikacji desktopowej — ta informacja była poprawna, gdy ją zapisano w sierpniu 2026 r., a teraz jest błędna. Po drugie, to publiczna wersja zapoznawcza, wciąż tak oznaczona na samej stronie DeepSeek, a sposób pakowania ma niedociągnięcia, które sugeruje ta etykieta. Instalator działa. Dystrybucja wokół niego jest skromniejsza, niż można przypuszczać.

Czym właściwie jest kompilacja desktopowa

Aplikacja desktopowa to cienka warstwa Electron, której zadaniem jest uruchomienie procesu Host i wskazanie na niego okna. Okno nie tworzy własnego interfejsu czatu: ładuje zapakowane wejście Web dołączone do aplikacji pod adresem dsh-app://app/, a widoczne okna dialogowe aktualizacji pochodzą z drugiego dołączonego originu pod adresem dsh-app://shell/. Proces potomny Node jest uruchamiany w trybie RunAsNode Electrona, aby uruchomić współdzielony runner profilu, a powłoka przekazuje HTTP do uwierzytelnionego Host Web, usuwając po drodze nagłówki transfer-encoding, connection i keep-alive. Odpowiedzi z pakietów pluginów są oznaczane jako no-store, co jest drobnym szczegółem o widocznej konsekwencji: zmień plugin, a następne przeładowanie pokaże zmianę.

Ponieważ adres URL to dsh-app://, a nie localhost, nie ma stałego portu do zapamiętania ani kolizji portów, którą trzeba by obejść. Host desktopowy domyślnie nasłuchuje na porcie przydzielonym przez system operacyjny. Jeśli potrzebujesz konkretnego portu, możesz go ustawić poprzez nadpisanie webserver.config.port, ale wartość domyślna celowo nie jest stałą, a Host wiąże się z 127.0.0.1. Ma to znaczenie, jeśli dotąd kierowałeś się starszymi instrukcjami: numer 19387, który krążył w sierpniowych poradnikach instalacji, nie jest portem desktopowym, a traktowanie go jako takiego sprawi, że zaczniesz szukać usługi, której tam nie ma.

Przypinanie wersji jest bardziej rygorystyczne, niż się na pierwszy rzut oka wydaje. Electron i @deepseek-ai/dsh zawsze mają dokładnie tę samą wersję — nie zakres, nie kompatybilną wersję główną — więc aktualizacja harnessa to wydanie aplikacji desktopowej i nie istnieje obsługiwana kombinacja nowego dsh ze starym oknem. Proces Electrona zakłada blokadę pojedynczej instancji na cały czas życia procesu i wyłącznie zarządza $DSH_HOME/profiles/desktop. Ta wyłączność jest realna: CLI nie może uruchomić tego profilu, a npm zainstalowany dsh nie może go zmodyfikować. Tym, co obie instalacje dzielą, jest stan, który ma dla Ciebie znaczenie — sesje, ustawienia, dane uwierzytelniające, przestrzenie robocze i pamięć masowa, wszystko w $DSH_HOME. Tym, czego nie dzielą, są pakiety wykonywalne, aktywacja wtyczek, pliki blokad ani node_modules, dlatego instalacja wtyczki w profilu desktopowym to nie ta sama operacja co instalacja jej w profilu CLI.

Trzy instalatory, jeden kanał aktualizacji, brak stabilnego wydania

Istnieją trzy instalatory i wszystkie trzy odpowiadają. Plik wykonywalny dla Windows 64-bit ma 289 385 456 bajtów i jest serwowany z HTTP 200. Obraz dysku dla Apple Silicon ma 264 990 950 bajtów, również 200. Obraz dysku dla komputerów Mac z procesorem Intel ma 289 480 824 bajtów, również 200. Wszystkie trzy zostały ostatnio zmodyfikowane 17 października 2026 r. Tylko dwa z nich są podlinkowane ze strony pobierania. Kompilacja dla Intel jest aktywna, jest osiągalna i nie ma nigdzie na deepseek.com/en/harness/ linku wskazującego na nią — jeśli korzystasz z komputera Mac z procesorem Intel i postępowałeś zgodnie z informacjami na stronie, można rozsądnie wywnioskować, że nie ma dla Ciebie kompilacji.

Wersja dla Intela również jest o jedną wersję do tyłu. Jej kanał aktualizacji podaje 0.2.1-rc.1; kanały dla Windows i Apple-silicon oba podają 0.2.1-rc.2. Jedna wersja release candidate to niewielka różnica w funkcjach, ale to realny sygnał, które cele są budowane najpierw, a które weryfikowane na końcu, i to jest dokładnie ten rodzaj informacji, który chcesz poznać, zanim powierzysz swoje sesje robocze platformie.

Kanały aktualizacji to miejsce, w którym opowieść o dystrybucji staje się niepełna. Źródła są osobne dla każdego celu, pod /dsh-desk/feeds/<target>/ na tym samym hoście. Windows x64 trafia do nightly.yml; oba cele macOS trafiają do nightly-mac.yml. Zapytaj którykolwiek z tych trzech o latest.yml lub latest-mac.yml i dostaniesz 404 — nie ma kanału stable, nie ma kanału beta i nie ma sposobu, by zrezygnować z tego, który istnieje. Własne notatki wydawnicze DeepSeek potwierdzają ten układ, a nie zaprzeczają mu: każde wydanie publikuje kanał nightly, a tylko wydania stabilne publikują kanał latest wskazujący te same artefakty. „Nightly” w tym kontekście to nazwa kanału, a nie rytm kompilacji — kanały Windows i Apple-silicon udostępniają tę samą kompilację 0.2.1-rc.2 z 17 października, przy czym pakiet Windows ma znacznik czasu 09:22 UTC, a pakiet Apple-silicon 09:57 UTC. Masz więc mechanizm automatycznej aktualizacji, odpytywanie z losowym rozrzutem, backoff do limitu jednej godziny i żadnego sposobu, by poprosić o cokolwiek innego niż to, co obecnie zawiera kanał podglądowy.

GitHub pokazuje to samo z innej strony. Repozytorium deepseek-ai/deepseek-harness — 256 559 gwiazdek i 30 921 forków w momencie odczytu 21 października 2026 r. — miało tego samego dnia 31 wydań, z których każde oznaczono jako prerelease i żadne nie miało dołączonych żadnych zasobów binarnych. Na stronie Releases nie da się niczego pobrać. Jeśli chcesz gotową kompilację, zdobędziesz ją z download.deepseek.com lub z npm, gdzie @deepseek-ai/dsh obecnie wskazuje latest na 0.2.1-rc.2. Repozytorium jest źródłem prawdy dla changelogu i ślepą uliczką, jeśli chodzi o sam artefakt, co jest wystarczająco nietypowe, by powiedzieć to wprost, bo odruchowo na widok 31 wydań oczekuje się instalatora przy którymś z nich.

Co zapisuje instalator, a czego nie chce dotykać

Instalator Windows to natywny pakiet NSIS, a nie nakładka na MSI, i zachowuje się jak natywny instalator. Otrzymujesz jasną, ciemną i automatyczną paletę — do wyboru w czasie instalacji za pomocą /THEME=light, /THEME=dark lub /THEME=auto — edytowalny katalog docelowy oraz zakres instalacji ograniczony do bieżącego użytkownika. Katalogi główne dysków są odrzucane jako lokalizacje docelowe, a niepusty katalog docelowy jest akceptowany tylko wtedy, gdy jest już zarejestrowaną instalacją, co oznacza, że instalator odmawia nadpisania niepowiązanego folderu. Podczas aktualizacji tryb cichy czeka do dziesięciu sekund na zakończenie działania uruchomionej aplikacji, a następnie zatrzymuje się z kodem wyjścia 2, jeśli aplikacja nadal działa. To uczciwa porażka, a nie uszkodzona instalacja, i da o sobie znać w każdym wdrożeniu skryptowym, które najpierw nie zamknie aplikacji.

Deinstalator wyznacza granicę, którą większość deinstalatorów wyznacza błędnie. Usuwa katalog userData Electrona, katalog produktu w %APPDATA% oraz pamięć podręczną aktualizatora w %LOCALAPPDATA%. Nie dotyka katalogu domowego harnessa — ~/.dsh ani miejsca, na które wskazuje DSH_HOME — gdzie przechowywane są Twoje sesje, ustawienia, dane logowania i wtyczki. Przekazanie --updated lub /KEEP_APP_DATA zachowuje również dane Electrona. Odinstalowanie i ponowna instalacja to więc obsługiwany sposób naprawy zepsutego okna bez utraty pracy — i jest to świadoma decyzja projektowa, a nie przypadek.

Warto wiedzieć o dołączonych środowiskach uruchomieniowych, ponieważ są duże i znajdują się poza katalogiem aplikacji. Python z numpy, pandas, python-docx, python-pptx, openpyxl, Pillow, lxml i XlsxWriter oraz Node i pnpm są instalowane w $DSH_HOME/dsh-runtimes/dsh-primary-runtime — zwykle ~/.dsh/... na obu platformach — gdy obszar roboczy po raz pierwszy zadeklaruje, że ich potrzebuje. Dlatego zajęte miejsce na dysku po tygodniu użytkowania nie jest takie samo jak po instalacji i dlatego odinstalowanie, które zachowuje $DSH_HOME, zachowuje również kilkaset megabajtów środowisk uruchomieniowych.

Ustawienia są odczytywane jednorazowo przy starcie z desktop/settings.json wewnątrz katalogu userData Electrona, co w systemie Windows oznacza %APPDATA%\@deepseek-ai\dsh-desktop\desktop\settings.json, a w systemie macOS oznacza ~/Library/Application Support/@deepseek-ai/dsh-desktop/desktop/settings.json. DSH_HOME nie przenosi tego pliku — warto to podkreślić, ponieważ jest to jedyny fragment konfiguracji, który nie podąża za zmienną, za którą podąża wszystko inne. Ustawienia aktualizacji w tym pliku są wyrażone w milisekundach: intervalMs domyślnie wynosi 600 000, a maxBackoffMs domyślnie wynosi 3 600 000 i musi być co najmniej równy intervalMs. Wartość jitter domyślnie wynosi 0,2, jest ograniczana do zakresu od zera do jednego oraz ma dolny limit jednej sekundy, nigdy nie przekraczając limitu backoff. Limit bezczynności wynoszący 60 000 milisekund na połączenie dotyczy ruchu HTTP związanego z aktualizacjami, jednak aktywne pobieranie nie ma limitu całkowitego czasu trwania — wolne łącze nie zostanie przerwane w trakcie pobierania.

Zamknięcie okna nie zamyka aplikacji

Na obu platformach zamknięcie okna powoduje jego ukrycie. W systemie macOS służy do tego Command-W, a w systemie Windows — przycisk zamykania, Alt-F4 lub opcja Zamknij na pasku zadań. Windows przed pierwszym ukryciem prosi o potwierdzenie i zapisuje flagę background-close-confirmed w katalogu userData Electrona, dzięki czemu pyta tylko raz, a nie za każdym razem. Windows przez cały czas działania utrzymuje też ikonę w zasobniku systemowym. macOS nie dostarcza żadnej ikony na pasku menu, przez co stan ukrycia jest tam naprawdę niewidoczny — aplikacja działa, zadania są wykonywane, a nic na ekranie o tym nie informuje, dopóki nie otworzysz jej ponownie przez dsh://open lub z zasobnika, w zależności od platformy.

To, co przetrwa ukrycie, jest właśnie tym użytecznym elementem. Uruchomione zadania działają dalej, a przy następnym pokazaniu okna wyświetla się ten sam dokument z tą samą sesją, tymi samymi szkicami i tą samą pozycją przewijania. To inne zachowanie niż w przypadku karty przeglądarki, którą zamykasz i otwierasz ponownie — i właśnie dlatego wersja desktopowa w ogóle ma sens, jeśli Twoja praca wiąże się z długotrwałymi zadaniami agenta: możesz zamknąć okno i pozwolić zadaniu się dokończyć.

Zakończenie to osobna akcja z własną logiką. Przed zakończeniem powłoka sprawdza Host pod kątem działających agentów, w tym podagentów i agentów oczekujących na zatwierdzenie, wiadomości w kolejce, zadań działających lub zatrzymywanych oraz aktywnych zaplanowanych przypomnień. Jeśli żaden z nich nie występuje, kończy działanie po cichu. Jeśli którykolwiek z nich występuje, otrzymujesz natywne okno dialogowe potwierdzenia zatytułowane Zakończyć DeepSeek Harness? z jednym z trzech wyjaśnień w zależności od tego, co wykryto: zadania zostaną przerwane, zaplanowane zadania nie zostaną uruchomione albo oba te przypadki. Host, który nigdy nie osiągnął stanu gotowości, nie mógł rozpocząć żadnych zadań, więc zakończenie w tym stanie przebiega bez pytania. Rozróżnienie między „zamknięciem” a „zakończeniem” jest sednem projektu i obowiązuje na obu platformach, mimo że tylko jedna z nich pokazuje trwałą ikonę.

Polecenie dsh i kolejność, która ma znaczenie

Instalator może umieścić dsh w Twojej zmiennej PATH, co pozwala uruchamiać CLI na tym samym katalogu domowym harnessu, którego używa aplikacja desktopowa. Odpowiednia opcja to Zarządzaj poleceniem dsh… i znajduje się bezpośrednio pod Sprawdź aktualizacje… w menu, oferując trzy działania: Zainstaluj, Napraw i Usuń. W systemie macOS zapisuje launcher w /usr/local/bin/dsh i w razie potrzeby poprosi o autoryzację administratora; w systemie Windows rejestruje polecenie w zmiennej PATH bieżącego użytkownika.

Dwie zasady dotyczące kolejności działań łatwo przeoczyć i irytująco odkryć po fakcie. Pierwsza: uruchom Remove przed odinstalowaniem aplikacji desktopowej, ponieważ deinstalator nie usuwa rejestracji dsh. Jeśli najpierw odinstalujesz, pozostanie wpis w PATH wskazujący na plik binarny, który już nie istnieje. Druga: jeśli przeniesiesz aplikację w inne miejsce, użyj Repair w systemie macOS lub Install z nowej lokalizacji w systemie Windows, zamiast zakładać, że rejestracja przeniesie się razem z aplikacją.

Zarządzanie wtyczkami w profilu desktopowym ma swoją specyfikę. Ponieważ Electron ma wyłączne prawa do $DSH_HOME/profiles/desktop podczas działania, instalowanie do tego profilu nie jest czymś, co robisz przy otwartej aplikacji. Obsługiwana sekwencja polega na jednokrotnym uruchomieniu aplikacji desktopowej, zamknięciu jej, a następnie uruchomieniu dsh plugin --profile desktop add <package> z wiersza poleceń. Pakiet trafia do profilu desktopowego i jest aktywny przy następnym otwarciu okna.

To, co opakowanie już ci mówi, jest niedokończone

Sekcja znanych ograniczeń w README jest wyjątkowo szczera, a dwa z jej punktów to te, które dotkną Cię najpierw.

• Logowanie do konta nie jest połączone. Przycisk Zaloguj się jest wyłączony. Zamiast tego pierwsze uruchomienie otwiera okno powitalne o wymiarach 600 na 700 z formularzem klucza API; Zapisz i kontynuuj zapisuje klucz w deweloperskim magazynie poświadczeń, a Skonfiguruj później otwiera rzeczywisty obszar roboczy bez zapisywania klucza. Naciśnięcie Zaloguj się tam, gdzie jest widoczne, otwiera skonfigurowaną stronę platformy w przeglądarce systemowej, przy czym Host odpowiada za wymianę PKCE i tymczasowe wywołanie zwrotne loopback — mechanizmy istnieją, powiązanie konta nie. W praktyce licz się z koniecznością zapewnienia klucza.

• Podpisywanie wydania i notaryzacja są wymienione jako wymagające środowiska produkcyjnego wydania. To README zachowuje ostrożność, a jednocześnie to miejsce, w którym pomiar jest użyteczniejszy niż zdanie. Opublikowany plik wykonywalny Windows ma ważny podpis Authenticode z łańcuchem rozszerzonej walidacji: GlobalSign Root CA–R3, poprzez GlobalSign Code Signing Root R45 i GlobalSign GCC R45 EV CodeSigning CA 2020, aż do certyfikatu końcowego wydanego dla Hangzhou DeepSeek Artificial Intelligence Co., Ltd. z jurysdykcją wymienioną jako CN / Zhejiang / Hangzhou i kategorią działalności prywatnej organizacji. Znacznik czasu RFC-3161 na tym podpisie wskazuje 2026-10-17T09:22:04Z, co odpowiada dacie wydania w kanale aktualizacji Windows z dokładnością do minuty, a skrót SHA-512 pobranego pliku odpowiada opublikowanemu w tym kanale hashowi bajt po bajcie. Tak więc w Windows plik binarny jest dziś podpisany, opatrzony znacznikiem czasu i zgodny hashowo, niezależnie od tego, co README mówi o tym, że proces nie został w pełni przygotowany do produkcji. Strona macOS to odrębne zagadnienie i nie weryfikowaliśmy tam notaryzacji; nie przenoście wyniku dla Windows na ten obszar.

Raporty o awariach i jeden szczegół, który warto znać

Raporty o awariach są zapisywane jako crash-<UTC time>-<source>.log w ~/Library/Logs/DeepSeek Harness na macOS lub w katalogu logs w ścieżce userData Electrona w systemie Windows, a przechowywanych jest dziesięć najnowszych. Ta liczba zachowywanych raportów jest wystarczająco mała, by miało to znaczenie: jeśli coś wielokrotnie zawodzi, a przez kilka dni nie zajrzysz, log, który wyjaśniłby pierwszą awarię, zniknie. Skopiuj katalog, jeśli debugujesz coś występującego sporadycznie.

Ścieżka odzyskiwania dla uszkodzonej konfiguracji jest równie konkretna. Powłoka zmienia nazwę cordis.patch.yml na cordis.patch.yml.bak-<timestamp> bez analizowania go, więc plik zostaje zachowany, a nie naprawiony, a aplikacja uruchamia się z ustawieniami domyślnymi. Jeśli ręcznie edytowałeś ten plik, Twoje zmiany trafiły do .bak i nadal można je odczytać.

Co to oznacza dla wcześniejszej porady „brak aplikacji desktopowej”

W sierpniu 2026 r. opublikowaliśmy wskazówki, że harness nie ma aplikacji desktopowej i że użytkownicy Windows powinni korzystać z wersji terminalowej — było to wówczas prawdą, a teraz jest nieaktualne. Wersja terminalowa nadal działa i nadal jest właściwym wyborem dla serwera, kontenera czy czegokolwiek obsługiwanego skryptowo. Zmieniło się to, że wersja desktopowa nie jest zabawkową nakładką: ma osobny profil, utrzymuje zadania przy życiu po zamknięciu okna, aktualizuje się sama i współdzieli stan z CLI w kierunku, który ci pomaga. Jeśli odkładałeś skorzystanie z wersji desktopowej, ponieważ wcześniejszy artykuł mówił, że ona nie istnieje, ten powód zniknął.

Same kroki instalacji są opisane w naszym przewodniku instalacji i celowo nie są tu powtarzane. Czego ten przewodnik nie może ci powiedzieć, to który z trzech instalatorów nie ma linku na stronie pobierania, która wersja docelowa jest o jedno wydanie do tyłu, że nie ma stabilnego kanału aktualizacji, do którego można by się zapisać, oraz że plik binarny dla Windows jest podpisany, mimo że README twierdzi, iż podpisywanie należy do przyszłego wydania. To właśnie te fakty decydują, czy kompilacja desktopowa jest tym, co warto zainstalować, i dlatego ta strona istnieje osobno.

Jeśli wolisz niczego nie instalować

Instalowanie harnessa tylko po to, by sięgnąć do jednego modelu, to mnóstwo dodatkowych elementów do utrzymania przy niewielkiej ilości pracy, a aplikacja desktopowa jest wersją zapoznawczą z jednym kanałem aktualizacji i kompilacją na Intela, do której nikt nie podaje linku. Jeśli tym, czego naprawdę chcesz, jest DeepSeek-V4.1-Flash — model domyślny harnessa, ten sam, którego obsługę dodają informacje o wydaniu 0.2.1-rc.2 — endpoint API załatwia to bez instalatora, bez katalogu profilu i bez ikony w zasobniku, o której musisz pamiętać, że działa.

Porównanie, którego należy dokonać, nie polega na abstrakcyjnym zestawieniu aplikacji desktopowej z API. Chodzi o to, czy praca wymaga agenta, który potrafi utrzymać otwarty obszar roboczy mimo zamkniętego okna, uruchamiać skrypty na twojej maszynie i utrzymywać sesję aktywną przez wiele godzin — w którym to przypadku warto pogodzić się z opisanymi powyżej problemami z pakowaniem, a wersja desktopowa to jedyny sposób, aby uzyskać takie zachowanie — czy też praca polega na strumieniu żądań do modelu, który jest już gdzieś obsługiwany. W drugim przypadku katalog modeli jest krótszą ścieżką, a nic w tym artykule tego nie zmienia.