DeepSeek Harness na Windows: Bez aplikacji desktopowej, nie ma problemu — oficjalny sposób uruchomienia

There is no official DeepSeek Harness desktop app for Windows, and you do not need one. DeepSeek Harness (dsh) — the open-source agent runtime DeepSeek released under an MIT license on 2026-08-13 — is a Node.js tool that runs a local web server you open in your browser, with a headless CLI for the terminal as the alternative. On Windows the whole setup is two commands: install Node.js 22.19 or newer (Node 24 LTS is the safer pick), then run npx @deepseek-ai/dsh web and open http://127.0.0.1:3080. Every "DeepSeek Harness Desktop" repository on GitHub is an unofficial community wrapper around that same two-command setup — useful to some people, but not required. It is also the harness DeepSeek uses to produce the agentic coding results it reports for DeepSeek V4 Pro and DeepSeek V4 Flash, which is why the two models keep showing up in any conversation about it.

Jeśli szukałeś „deepseek harness windows”, prawdopodobnie patrzysz na stronę z tymi repo-opakowaniami i zastanawiasz się, które zainstalować. Ten artykuł odpowiada na prawdziwe pytanie kryjące się za wyszukiwaniem: czym właściwie jest DeepSeek Harness, jak oficjalnie uruchomić go dziś na Windowsie, jakie są alternatywy w terminalu oraz jakie są uczciwe zastrzeżenia dotyczące narzędzia na etapie podglądu. To poradnik, a nie post ogłoszeniowy — premiera i ślad wycieku zostały omówione w osobnych artykułach.

Czym jest DeepSeek Harness (a czym nie jest)

DeepSeek Harness nie jest modelem i nie przeprowadza testów porównawczych modeli. To środowisko uruchomieniowe agenta: warstwa, która łączy model z narzędziami, plikami, powłoką i internetem — czytając Twój kod, planując zmiany, uruchamiając polecenia i iterując, aż zadanie zostanie ukończone. Architektura jest wyrażona w jego haśle przewodnim: „Wszystko jest wtyczką." Modele, narzędzia, umiejętności, sesje, sandboxy, sama pętla agenta, a nawet interfejs webowy to wtyczki komponowane przy starcie, zbudowane na meta-frameworku Cordis — tym samym jądrze, które napędza ekosystem chatbotów Koishi. Domyślna instalacja zawiera ponad 150 wtyczek.

Jest to również zdecydowanie wersja zapoznawcza. dsh jest w wersji 0.1.0-rc.6, README określa ją jako wersję zapoznawczą dla programistów i ostrzega wielkimi literami, że „NASTĄPIĄ ZMIANY ŁAMJĄCE ZGODNOŚĆ". Nic z tego nie spowolniło przyjęcia projektu: osiągnął on około 50 000 gwiazdek na GitHubie w pierwszych 12 godzin od upublicznienia 2026-08-13, a 2026-08-16 miał ich około 126 000 — to najszybsze wydanie open-source, jakie DeepSeek opublikował.

Krótka odpowiedź: oficjalna ścieżka w systemie Windows to dwa polecenia.

Oficjalny README DeepSeek podaje w jednym wierszu sposób uruchomienia w systemie Windows: zainstaluj Node.js, a następnie uruchom npx @deepseek-ai/dsh web. Konkretnie, kroki są następujące:

• Zainstaluj Node.js 22.19+ lub Node 24.Obecne wydanie dsh wymaga Node 22.19 lub nowszego; Node 24 LTS jest bezpieczniejszym wyborem w systemie Windows, a powód jest prozaiczny — nowsze wersje Node zawierają natywną dekompresję zstd, której dsh używa do odczytu swoich skompresowanych logów sesji. Sprawdź swoją instalację za pomocą node --version w PowerShell lub cmd.

• Run the harness. Either run it on the spot with npx @deepseek-ai/dsh web, or install it once with npm install -g @deepseek-ai/dsh and then run dsh web from any folder afterwards. The first run prints the URL and starts the Web UI at http://127.0.0.1:3080.

• Otwórz ten adres w przeglądarce. Interfejs Web UI to lokalna aplikacja webowa — dlatego nie ma aplikacji desktopowej; przeglądarka jest aplikacją desktopową.

• Dodaj klucz modelu raz. W interfejsie WWW otwórz Ustawienia → Modele, wklej klucz API DeepSeek i zapisz. Działa to natychmiast, bez restartu serwera. dsh używa folderu, w którym go uruchomiono, jako domyślnej lokalizacji w systemie plików, a krok Wybierz przestrzeń roboczą w interfejsie pozwala wskazać dowolny katalog projektu.

To jest cała oficjalna ścieżka. Jeśli maszyna ma już zainstalowane Node 22+, czas od „niczego” do „uruchomionego agenta” to mniej niż minuta.

Dlaczego każde repozytorium "DeepSeek Harness Desktop" jest nakładką.

Wyniki na pierwszej stronie dla tego zapytania to wyłącznie społecznościowe nakładki desktopowe — powłoki Electron, Tauri i WebView2, które pakują środowisko Node i uruchamiają oficjalny interfejs webowy w oknie z ramką. Nie są to produkty DeepSeek i nie dodają żadnych możliwości typu harness; dodają tylko launcher. Co je łączy:

• Uruchamiają się podwójnym kliknięciem i całkowicie unikają wiersza poleceń, co jest ich prawdziwym atutem.

• Nie są podpisane, więc Windows SmartScreen ostrzeże przy instalacji — "Więcej informacji → Uruchom mimo to" jest częścią procesu.

• Śledzą oficjalny projekt w różnym tempie: niektórzy przypinają 0.1.0-rc.5, niektórzy 0.1.0-rc.6, a niektórzy podążają za masterem, przez co wersje wrappera i harnessu z czasem się rozjeżdżają.

Przechowują te same lokalne dane, których dsh zawsze używa, w ~/.dsh, więc przełączanie się między wrapperem a oficjalnym CLI nie resetuje twoich sesji.

Kiedy wrapper jest wart zachodu? Kiedy czynnikiem decydującym jest „kliknij dwukrotnie ikonę, zobacz zasobnik, nigdy nie dotykaj terminala”, akceptując, że zewnętrzny podmiot jest teraz warstwą aktualizacji i bezpieczeństwa przed narzędziem w fazie podglądu. Kiedy nie? Oficjalna droga to dwie komendy i karta przeglądarki — jeśli masz już Node, wrapper daje ci program uruchamiający, którego możesz nie potrzebować, a w zamian dokłada własne koszty utrzymania.

Ścieżka terminalowa: headless CLI i wtyczki TUI

Jeśli przeglądarka nie jest tym, w czym pracujesz, dsh ma również historię związaną z terminalem, podzieloną na dwa tryby.

Headless to profil nieinteraktywny: dsh --profile headless "summarize this repository" uruchamia jedno zadanie bez interfejsu, wypisuje wynik i kończy działanie — tryb przyjazny dla CI. W systemie Windows jest to również tryb, którego powinny używać skrypty i zadania zaplanowane, ponieważ nie wymaga wyświetlacza ani zalogowanej sesji.

TUI to interaktywny front-end terminala w stylu Claude Code, dostarczany jako pakiety wtyczek tworzone przez społeczność, a nie w pakiecie podstawowym. Pakiety takie jak dsh-tui można zainstalować w profilu za pomocą dsh plugin --profile tui add <package> i uruchomić za pomocą dsh --profile tui; co najmniej jeden dostarcza program uruchamiający .cmd dla Windows. Warto wiedzieć, zanim spróbujesz: TUI wymaga prawdziwego terminala zarówno do wejścia, jak i wyjścia — jeśli twoja konfiguracja używa potoków lub przekierowań, dsh odmówi i każe użyć trybu headless.

Cztery presety: który do jakiego zadania?

dsh zawiera cztery wbudowane presety agentów, ale nie stanowią one drabiny trudności — to cztery różne powierzchnie narzędziowe. Domyślny ustawiasz w ~/.dsh/settings.yaml w sekcji agent-presets.default.

• Standard jest domyślny: pełny, codzienny agent — edycja plików, powłoka, wyszukiwanie w plikach i internecie, umiejętności, subagenci, planowanie. Od tego powinna zacząć większość użytkowników Windowsa.

• PTC (zwany także trybem Code) zachowuje wszystko, co ma Standard, ale zmienia sposób udostępniania narzędzi: zamiast długiej sekwencji pojedynczych wywołań narzędzi, model pisze program w TypeScript, który łączy operacje wieloetapowe — pętle, filtry, gałęzie warunkowe. Do złożonych, powtarzalnych lub wieloetapowych przepływów pracy.

• Minimal celowo ogranicza agenta do dwóch narzędzi — trwałej powłoki i edytora plików — i jest przeznaczony do oceny i testów porównawczych, a nie codziennej pracy. To preset, na którym oparte są wyniki agentów samego DeepSeeka.

• Creation (Cordis) służy do tworzenia własnych presetów: obejmuje inspekcję w czasie działania, eksperymentowanie z wtyczkami w pamięci oraz wskazówki dotyczące tworzenia presetów. Do majsterkowania przy samym harnessie.

MCP i odtwarzanie trajektorii: dlaczego warto to w ogóle uruchomić

Dwie funkcje uzasadniają używanie dsh zamiast zwykłego klienta czatu. Po pierwsze, wbudowany jest klient Model Context Protocol (MCP) — polecenie /mcp oraz zakładka MCP w ustawieniach podłączają zewnętrzne serwery MCP do środowiska, więc te same narzędzia, z których korzystają twoje inne agenty, można podłączyć do dsh. Po drugie, każda sesja jest zapisywana w dzienniku o trybie append-only, a widok Trajectory pozwala przeglądać przebieg według źródła, wznawiać go, rozwidlać, przeszukiwać i odtwarzać. To jest różnica między debugowaniem agenta przez wpatrywanie się w jego ostateczną odpowiedź a przechodzeniem krok po kroku przez to, dlaczego wykonał każde wywołanie.

Kiedy oficjalna ścieżka jest złą odpowiedzią

• Potrzebujesz jednego kliknięcia, bez terminala. Nie ma oficjalnego instalatora. Jeśli podwójne kliknięcie to konieczność, polegasz na wrapperach społecznościowych — które są niepodpisane, więc porównaj wygodę z utrzymaniem przez strony trzecie.

• Twój komputer z Windowsem jest stary lub zablokowany. dsh wymaga Node 22.19+ (lub Node 24). Na zarządzanej maszynie oznacza to instalację środowiska uruchomieniowego i prawdopodobnie zgodę, której nie masz.

• To jest wersja zapoznawcza, która potrafi się zepsuć. 0.1.0-rc.6 zawiera ostrzeżenie, że nadchodzą zmiany zrywające zgodność; pomiędzy buildami rc wtyczki i profile mogą przestać działać. Zamroź wersję dla wszystkiego, co jest skryptowane.

• Rachunek za model spoczywa na Tobie.dsh jest darmowe; każde zadanie spala tokeny z klucza, który skonfigurowałeś. Pętla agenta ponownie odczytuje pliki i ponawia próby, a rozwlekły model przy trudnym zadaniu może w ciągu popołudnia zużyć zaskakująco duży budżet. To właśnie wybór modelu, a nie wybór harnessu, decyduje o koszcie.

• Stały abonament może być lepszy niż rozliczenie za tokeny. Jeśli korzystasz z planu jednego laboratorium i mieścisz się w jego limitach, abonament ryczałtowy jest często tańszy niż jakakolwiek ścieżka per-token. Routing wygrywa, gdy mieszasz modele lub chcesz mieć failover — ale nie domyślnie.

Przekieruj model za uprzążą.

Natywna ścieżka to własne API DeepSeeka: wklej klucz w Settings → Models i gotowe. Ale dsh akceptuje też adres bazowy zgodny z OpenAI — ustaw DEEPSEEK_BASE_URL w zmiennych środowiskowych lub skonfiguruj dostawcę LLM w settings.yaml — co oznacza, że model działający za harnessem można podmienić bez ruszania samego harnessu. Możesz użyć DeepSeek V4 Pro do trudnego refaktoru i DeepSeek V4 Flash do tanich, mechanicznych edycji na tej samej lokalnej instalacji dsh.

To warstwa, którą zajmuje OrcaRouter. Jeden adres bazowy zgodny z OpenAI, ponad 200 modeli, zero narzutu — cennik dostawcy przekazywany jeden do jednego — oraz automatyczne przełączanie na zapasowy model, gdy dostawca ograniczy szybkość lub zacznie działać wolniej. Wskaż na to dsh, a harness zostaje na Twojej maszynie, podczas gdy katalog modeli staje się decyzją routingu, a nie zakupem. Dwa uczciwe zastrzeżenia: nie hostujemy dsh — działa on lokalnie na Twoim komputerze z Windows, a my jesteśmy tylko warstwą dostępu do modeli, jeśli chcesz korzystać z modeli spoza własnego API DeepSeek. A w przypadku pojedynczego ciężkiego modelu mieszczącego się w limitach planu, płaski abonament często okazuje się tańszym rozwiązaniem niezależnie od routera.

Krótka wersja

DeepSeek Harness na Windows to konfiguracja za pomocą dwóch poleceń, a nie instalacja ze sklepu z aplikacjami: Node 22.19+ (lub Node 24), następnie npx @deepseek-ai/dsh web, a potem przeglądarka pod adresem http://127.0.0.1:3080. Repozytoria „desktop” na GitHubie to nieoficjalne nakładki na ten sam lokalny serwer. W terminalach tryb headless uruchamia jednorazowe zadania dla CI, a wtyczki TUI oferują interfejs w stylu Claude Code. Cztery presety — Standard, PTC, Minimal, Creation — określają zestaw narzędzi, a MCP plus odtwarzanie trajektorii sprawiają, że całość jest naprawdę użyteczna. Jest darmowy, open source i na etapie podglądowym: przypnij wersję, obserwuj rachunek za model i kieruj model oddzielnie od harnessu.