Karta OrcaRouter o tytule „DeepSeek Harness na Windows”, z podtytułem „Oficjalna aplikacja desktopowa już istnieje — dla większości osób te dwie komendy nadal są szybszą drogą”. Ciemny chip polecenia o treści „npx @deepseek-ai/dsh web” wskazuje strzałką na jasny chip o treści „http://127.0.0.1:3080”. Poniżej trzy pola statystyk: „MIT · open source”, „v0.2.1-rc.2” z podpisem „Wersja zapoznawcza dla deweloperów — zmiany niekompatybilne są zapowiadane z wyprzedzeniem” oraz „Everything is a Plugin” z podpisem „Ponad 150 wtyczek w domyślnym wdrożeniu”. Stopka: Node 22.19 lub nowszy, następnie powyższe polecenie, a potem karta przeglądarki.
Guides & Insights

DeepSeek Harness w Windows: dwie komendy lub oficjalna aplikacja desktopowa

Autor

Gideon Frost

Data publikacji

Najnowsze modele · 20Zobacz wszystkie modele →
Benchmarki: Artificial Analysis · aktualizowane codziennie
Powrót do wszystkich wpisów

There is an official DeepSeek Harness desktop app for Windows now, and for most people these two commands are still the faster way in. 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. 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. That address serves the same Web UI the official Electron build wraps, so the only thing the installer adds is the window. If you would rather have the window, our guide to the DeepSeek Harness desktop app covers what the installer writes, which of the three builds has no link on the download page, and why the harness and the app must always carry the same version. 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ś frazy „deepseek harness windows”, wyniki to teraz mieszanka własnej strony pobierania DeepSeek i długiego ogona repozytoriów społecznościowych wrapperów, i nie jest oczywiste, którą z nich należy zainstalować. Ten artykuł odpowiada na prawdziwe pytanie kryjące się za tym wyszukiwaniem: czym właściwie jest DeepSeek Harness, jaki jest dziś oficjalny sposób uruchomienia go w systemie Windows, kiedy zamiast tego warto użyć instalatora, jakie są alternatywy terminalowe oraz jakie są uczciwe zastrzeżenia dotyczące uruchamiania narzędzia w fazie zapowiedzi. To poradnik, a nie wpis o premierze — premierę i ślad wycieku omawiamy w osobnych materiał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.

To także — i to zdecydowanie — wersja zapoznawcza. dsh jest w wersji 0.2.1-rc.2, README określa go jako developer preview i ostrzega wielkimi literami, że „NASTĄPIĄ ZMIANY ŁAMIĄCE ZGODNOŚĆ”. Nic z tego nie spowolniło adopcji: projekt zdobył około 50 000 gwiazdek GitHub w ciągu pierwszych 12 godzin od publicznego udostępnienia 13 sierpnia 2026 r. i miał 256 853 gwiazdki oraz 30 970 forków, gdy odczytano go 22 października 2026 r. — to najszybciej przyjęte wydanie open source w historii DeepSeek.

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 internetowa, a przeglądarka jest klientem. To ten sam interfejs, który wersja Electron ładuje z dsh-app://app/, tylko bez ramki okna.

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

Terminal-window card titled 'Run DeepSeek Harness on Windows' with eyebrow 'Windows · PowerShell', showing a dark terminal window with the lines 'PS> node --version' (comment: needs v22.19+, Node 24 LTS safer), 'PS> npm install -g @deepseek-ai/dsh', 'PS> dsh web' (comment: arrow to http://127.0.0.1:3080), and 'PS> dsh --profile headless "summarize this repo"' (comment: one-shot, prints & exits), with a footer sourcing the commands to the deepseek-ai/deepseek-harness README and user guide, August 2026. OrcaRouter logo composited bottom-right.

To cała oficjalna ścieżka, jeśli chcesz pozostać w przeglądarce. Jeśli na maszynie jest już zainstalowany Node 22+, czas od „nic” do „działającego agenta” wynosi mniej niż minutę.

„DeepSeek Harness Desktop” — repozytoria: co zmieniła oficjalna aplikacja

Wyniki na pierwszej stronie tego zapytania to nadal w większości społecznościowe nakładki desktopowe — powłoki Electron, Tauri i WebView2, które dołączają środowisko uruchomieniowe Node i uruchamiają oficjalny interfejs Web UI w obramowanym oknie. Żadna z nich nie jest produktem DeepSeek i żadna nie dodaje możliwości związanych z harness; dodają launcher. Zmieniło się to, że od października 2026 r. DeepSeek dostarcza własny instalator, więc nakładka nie jest już jedynym sposobem na uniknięcie terminala. Co łączy te nakładki:

• 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óre wciąż są przypięte do 0.1.0-rc.6, niektóre podążają za master, a wiele ostatnio aktualizowano względem 0.1.x, więc wrapper i wersja harness 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.

Two-column card titled 'Official dsh vs the GitHub 'desktop' wrappers' with eyebrow 'What page 1 of this search actually shows'. Left column 'Official dsh' with checkmarks: two commands + browser UI, Web UI at 127.0.0.1:3080, headless CLI + TUI plugins, you control the version, no install wizard. Right column 'Community wrappers' with crosses: double-click installer, bundles Node + official UI, unsigned — SmartScreen warns, version drift: rc.5 / rc.6 / master, third-party update layer. Footer: every page-1 'DeepSeek Harness Desktop' repo wraps the official web UI — none is a DeepSeek product. OrcaRouter logo composited bottom-right.

Kiedy nakładka ma sens? Obecnie prawie nigdy — i na tym polega zmiana. Gdy decydującym czynnikiem było „kliknij dwukrotnie ikonę, zobacz ikonę w zasobniku, nigdy nie dotykaj terminala”, nakładka była jedyną drogą — DeepSeek dostarcza dziś własny instalator, więc jedyna realna zaleta nakładki zniknęła, a pozostaje strona trzecia stojąca w warstwie aktualizacji i bezpieczeństwa przed narzędziem w fazie wersji zapoznawczej. Kiedy oficjalna ścieżka nadal jest właściwa? Dwie komendy i karta przeglądarki — jeśli masz już Node, ani nakładka, ani instalator nie dają ci wiele.

Ś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. Od października 2026 dostępny jest oficjalny instalator, więc to już nie jest powód, by sięgać po wrapper. Nadal jest to jednak dobry powód, by pominąć terminal, i to uzasadniony wybór: w zamian za kartę przeglądarki dostajesz okno Electron, które ukrywa się zamiast zamykać i aktualizuje się w kanale bez stabilnego wydania.

• 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 i się psuje. 0.2.1-rc.2 jest wydawany z ostrzeżeniem, że nadchodzą zmiany łamiące zgodność; między kompilacjami rc wtyczki i profile mogą przestać działać, a w kompilacji desktopowej harness i powłoka Electron muszą zawsze mieć dokładnie tę samą wersję. Przypnij swoją wersję wszędzie tam, gdzie cokolwiek 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 DeepSeek: wklej klucz w Ustawienia → Modele i gotowe. Ale dsh przyjmuje też bazowy URL zgodny z OpenAI — wystarczy ustawić DEEPSEEK_BASE_URL w środowisku lub skonfigurować dostawcę LLM w settings.yaml — co oznacza, że model stojący za harnessem można wymienić bez dotykania samego harnessu. Możesz uruchomić DeepSeek V4 Pro do trudnego refaktoru, a DeepSeek V4.1 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.

Screenshot of the OrcaRouter model page for DeepSeek V4 Pro: the Flagship badge, roughly $0.44 input / $0.88 output per 1M tokens, a 1M-token context window, 384K max output, and 1.6T total / 49B active parameters, with OpenAI-compatible code samples.

Krótka wersja

DeepSeek Harness w Windows to dla większości ludzi nadal konfiguracja w dwóch poleceniach: Node 22.19+ (lub Node 24), następnie npx @deepseek-ai/dsh web, a potem przeglądarka pod http://127.0.0.1:3080. Oficjalna kompilacja Electron istnieje od października 2026 r. i jest warta uwagi tylko wtedy, gdy chcesz okno, które przetrwa zamknięcie; społecznościowe repozytoria „desktop” na GitHubie opakowują ten sam lokalny serwer i nie mają już przewagi nad własnym plikiem do pobrania od DeepSeek. W przypadku terminali tryb headless wykonuje zadania jednorazowe dla CI, a wtyczki TUI zapewniają interfejs w stylu Claude Code. Cztery presety — Standard, PTC, Minimal, Creation — określają dostępny zestaw narzędzi, a MCP i odtwarzanie trajektorii czynią go naprawdę przydatnym. Jest darmowy, otwartoźródłowy i na etapie preview w wersji 0.2.1-rc.2: przypnij wersję, pilnuj rachunku za model i kieruj model oddzielnie od harnessu.