OrcaRouter-kaart met de titel 'DeepSeek Harness op Windows', ondertitel 'Er bestaat nu een officiële desktopapp — voor de meeste mensen zijn deze twee commando's nog steeds de snellere manier om binnen te komen'. Een donkere commandochip met de tekst 'npx @deepseek-ai/dsh web' wijst met een pijl naar een lichte chip met de tekst 'http://127.0.0.1:3080'. Daaronder drie statistiekvakken: 'MIT · open source', 'v0.2.1-rc.2' met het bijschrift 'Ontwikkelaarspreview — breaking changes worden vooraf aangekondigd', en 'Alles is een Plugin' met het bijschrift 'Meer dan 150 plugins in een standaarddeployment'. Voettekst: Node 22.19 of nieuwer, dan het commando hierboven, dan een browsertabblad.
Guides & Insights

DeepSeek Harness op Windows: twee commando's, of de officiële desktopapp

Auteur

Gideon Frost

Publicatiedatum

Nieuwste modellen · 20Bekijk alle modellen →
Benchmarks: Artificial Analysis · dagelijks bijgewerkt
Terug naar alle berichten

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.

Als je hebt gezocht op "deepseek harness windows", bestaan de resultaten nu uit een mix van DeepSeek's eigen downloadpagina en een lange reeks wrapperrepositories van de community, en het is niet duidelijk welke je nu eigenlijk moet installeren. Dit artikel beantwoordt de echte vraag achter de zoekopdracht: wat DeepSeek Harness eigenlijk is, de officiële manier om het vandaag op Windows te draaien, wanneer het installatieprogramma in plaats daarvan de moeite waard is, de terminalalternatieven, en de eerlijke kanttekeningen bij het draaien van een tool in de previewfase. Het is een how-to, geen lanceerbericht — de lancering en het spoor van lekken komen apart aan bod.

Wat DeepSeek Harness is (en niet is)

DeepSeek Harness is geen model en het benchmarkt er ook geen. Het is de agent-runtime: de laag die een model verbindt met tools, bestanden, een shell en het internet — die je code leest, wijzigingen plant, opdrachten uitvoert en blijft itereren tot de taak is voltooid. De architectuur wordt verwoord in de tagline: "Alles is een plug-in." Modellen, tools, vaardigheden, sessies, sandboxen, de agent-loop zelf en zelfs de web-UI zijn plug-ins die bij het opstarten worden samengesteld, gebouwd op het Cordis meta-framework — dezelfde kernel achter het Koishi chatbot-ecosysteem. Een standaardimplementatie bevat meer dan 150 plug-ins.

Het is bovendien nadrukkelijk een preview. dsh staat op versie 0.2.1-rc.2, het README-bestand noemt het een developer preview en waarschuwt in hoofdletters dat "ER COMPATIBILITEITSBREKENDE WIJZIGINGEN ZULLEN KOMEN." Niets daarvan heeft de adoptie vertraagd: het project bereikte ongeveer 50.000 GitHub-sterren binnen de eerste 12 uur nadat het op 2026-08-13 openbaar werd gemaakt, en stond op 256.853 sterren en 30.970 forks toen het op 22 oktober 2026 werd bekeken — de snelste open-source-release die DeepSeek ooit heeft uitgebracht.

Het korte antwoord: de officiële Windows-route is twee opdrachten.

De officiële README van DeepSeek geeft het Windows-startpad in één regel: installeer Node.js en voer daarna uit npx @deepseek-ai/dsh web. Concreet zijn de stappen:

• Installeer Node.js 22.19+ of Node 24.De huidige dsh-release vereist Node 22.19 of nieuwer; Node 24 LTS is de veiligere keuze op Windows, en de reden is prozaïsch — nieuwere Node-versies bevatten native zstd-decompressie, die dsh gebruikt om de gecomprimeerde sessielogs te lezen. Controleer je installatie met node --version in PowerShell of 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.

• Open dat adres in je browser. De Web UI is een lokale webapp en de browser is de client. Dat is dezelfde interface die de Electron-build laadt vanaf dsh-app://app/, op het vensteromhulsel na.

• Voeg een modelsleutel eenmalig toe. Open in de webinterface Instellingen → Modellen, plak een DeepSeek API-sleutel en sla op. Het wordt onmiddellijk van kracht, zonder serverherstart. dsh gebruikt de map waarin je het hebt gestart als standaardlocatie van het bestandssysteem, en de UI's 'Kies werkruimte'-stap laat je deze op elke projectmap richten.

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.

Dat is het volledige officiële traject als je in een browser wilt blijven. Als op een machine al Node 22+ is geïnstalleerd, duurt het van "niets" tot "agent draait" minder dan een minuut.

"DeepSeek Harness Desktop"-repo's: wat de officiële app heeft veranderd

De resultaten op pagina 1 voor deze zoekopdracht zijn nog steeds grotendeels community-desktopwrappers — Electron-, Tauri- en WebView2-schillen die een Node-runtime bundelen en de officiële webinterface in een omlijst venster starten. Geen ervan is een DeepSeek-product, en geen ervan voegt harness-mogelijkheden toe; ze voegen een launcher toe. Wat is veranderd, is dat DeepSeek sinds oktober 2026 een eigen installer levert, dus de wrapper is niet langer de enige manier om een terminal te vermijden. Wat de wrappers gemeen hebben:

Ze worden met een dubbelklik gestart en vermijden de commandoregel volledig, wat hun echte verkoopargument is.

• Ze zijn niet ondertekend, dus Windows SmartScreen zal bij installatie waarschuwen — "Meer info → Toch uitvoeren" is onderdeel van het proces.

• Ze volgen het officiële project in verschillend tempo: sommige houden nog steeds 0.1.0-rc.6 vast, sommige volgen master, en veel ervan zijn voor het laatst bijgewerkt tegen 0.1.x, waardoor de wrapper en de harness-versie na verloop van tijd uit elkaar lopen.

• Ze slaan dezelfde lokale gegevens die dsh altijd gebruikt onder ~/.dsh op, dus het wisselen tussen een wrapper en de officiële CLI reset je sessies niet.

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.

Wanneer is een wrapper de moeite waard? Tegenwoordig bijna nooit, en dat is de verandering. Toen "dubbelklik op een pictogram, zie een systeemvak, raak nooit een terminal aan" de doorslaggevende factor was, was een wrapper de enige route — DeepSeek levert vandaag zijn eigen installer, dus het enige echte voordeel van de wrapper is verdwenen en wat overblijft is een derde partij die in de update- en beveiligingslaag staat voor een tool in de previewfase. Wanneer is het officiële pad nog steeds de juiste keuze? Twee commando's en een browsertabblad — als je Node al hebt, levert noch de wrapper noch de installer je veel op.

De terminalroute: headless CLI- en TUI-plugins

Als de browser niet is waar je werkt, heeft dsh ook een terminalverhaal, opgesplitst in twee modi.

Headless is het niet-interactieve profiel: dsh --profile headless "summarize this repository" voert één taak uit zonder UI, print het resultaat en sluit af — de CI-vriendelijke modus. Op Windows is dit ook de modus die scripts en geplande taken moeten gebruiken, omdat er geen beeldscherm of aangemelde sessie nodig is.

TUI is een interactieve terminalfront-end in Claude Code-stijl, geleverd als community-pluginbundels in plaats van in het kernpakket. Pakketten zoals dsh-tui worden in een profiel geïnstalleerd met dsh plugin --profile tui add <package> en uitgevoerd met dsh --profile tui; ten minste één wordt geleverd met een Windows .cmd-launcher. Het nadeel dat u moet weten voordat u het probeert: een TUI vereist een echte terminal voor zowel invoer als uitvoer — als uw opstelling pipes of redirects gebruikt, zal dsh weigeren en u vertellen om in plaats daarvan headless te gebruiken.

De vier presets: welke voor welke klus?

dsh wordt geleverd met vier ingebouwde agent-presets, en ze vormen geen moeilijkheidsladder — het zijn vier verschillende tooloppervlakken. Je stelt de standaard in in ~/.dsh/settings.yaml onder agent-presets.default.

• Standaard is de standaardinstelling: de volledige dagelijkse agent — bestandsbewerking, shell, bestands- en webzoekopdracht, vaardigheden, subagenten, planning. Dit is waarmee de meeste Windows-gebruikers moeten beginnen.

• PTC (ook wel Code-modus genoemd) behoudt alles wat Standard heeft, maar verandert hoe tools worden aangeboden: in plaats van een lange reeks geïsoleerde toolaanroepen schrijft het model een TypeScript-programma dat bewerkingen in meerdere stappen samenstelt — lussen, filters, conditionele vertakkingen. Voor complexe, herhaalde of uit meerdere stappen bestaande workflows.

• Minimal beperkt de agent bewust tot twee tools — een persistente shell en een bestandseditor — en is gericht op evaluatie en benchmarking, niet op dagelijks werk. Dit is de preset waarop DeepSeek's eigen agentische scores draaien.

• Creation (Cordis) is voor het bouwen van aangepaste presets: het omvat runtime-inspectie, experimenteren met plug-ins in het geheugen en begeleiding bij het maken van presets. Voor het sleutelen aan de harness zelf.

MCP en trajectreplay: waarom dit überhaupt de moeite waard is om te draaien

Twee functies rechtvaardigen het gebruik van dsh boven een gewone chatclient. Ten eerste is er een Model Context Protocol (MCP)-client ingebouwd — een /mcp-commando en een Settings MCP-tabblad verbinden externe MCP-servers met de harness, zodat dezelfde tools die jouw andere agents gebruiken, in dsh worden geïntegreerd. Ten tweede wordt elke run weggeschreven naar een append-only sessielog, en de Trajectory-weergave stelt je in staat een run te inspecteren op bron, te hervatten, te forken, te doorzoeken en opnieuw af te spelen. Dat is het verschil tussen een agent debuggen door naar het uiteindelijke antwoord te staren en stap voor stap doorlopen waarom elke aanroep is gedaan.

Wanneer het officiële pad het verkeerde antwoord is

• Je wilt één klik, geen terminal. Sinds oktober 2026 is er een officiële installer, dus dit is niet langer een reden om naar een wrapper te grijpen. Het is nog steeds een goede reden om de terminal over te slaan, en dat is een legitieme keuze: wat je inruilt, is het browsertabblad voor een Electron-venster dat zich verbergt in plaats van sluit en zichzelf bijwerkt via een kanaal zonder stabiele release.

• Je Windows-computer is oud of vergrendeld. dsh heeft Node 22.19+ (of Node 24) nodig. Op een beheerde machine betekent dat een runtime-installatie en mogelijk een goedkeuring die je niet hebt.

• Het is een preview, en het breekt. 0.2.1-rc.2 wordt geleverd met een waarschuwing dat er breaking changes aankomen; tussen rc-builds kunnen plugins en profielen stoppen met werken, en in de desktopbuild moeten de harness en de Electron-shell altijd exact dezelfde versie hebben. Pin je versie voor alles wat gescript is.

• De modelrekening is voor jou. dsh is gratis; elke taak verbruikt tokens op de sleutel die je hebt geconfigureerd. Een agentlus herleest bestanden en probeert opnieuw, en een model dat veel output genereert, kan bij een moeilijke taak op een middag een verrassend budget verbruiken. Hier is het de modelkeuze, niet de keuze van de harness, die de kosten domineert.

• Een vast abonnement kan voordeliger zijn dan per-token-routing. Als je binnen het plan van één lab blijft en onder de limieten, is het vaste abonnement vaak goedkoper dan elke per-token-route. Routing wint wanneer je modellen mixt of failover wilt — niet standaard.

Routeer het model achter de harness

Het native pad is DeepSeek's eigen API: plak een sleutel in Instellingen → Modellen en je kunt gaan. Maar dsh accepteert ook een OpenAI-compatibele base-URL — stel DEEPSEEK_BASE_URL in de omgeving in of configureer de LLM-provider in settings.yaml — wat betekent dat het model achter de harness verwisselbaar is zonder de harness aan te passen. Je kunt DeepSeek V4 Pro draaien voor de zware refactor en DeepSeek V4.1 Flash voor goedkope mechanische bewerkingen, op dezelfde lokale dsh-installatie.

Dat is de laag die OrcaRouter inneemt. Eén OpenAI-compatibele basis-URL, 200+ modellen, nul opslag — de prijslijst van de provider wordt doorberekend — en automatische failover wanneer een provider rate-limits oplegt of degradeert. Wijs dsh ernaar en de harness blijft op je machine, terwijl de modelcatalogus een routeringsbeslissing wordt in plaats van een aankoop. Twee eerlijke kanttekeningen: wij hosten dsh niet — het draait lokaal op je Windows-machine, en wij zijn alleen de modeltoegangslaag als je modellen buiten DeepSeek's eigen API wilt gebruiken. En voor een enkel zwaar model binnen de limieten van het plan is het vaste-prijsabonnement vaak de goedkopere keuze, ongeacht de router.

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.

De korte versie

DeepSeek Harness op Windows is voor de meeste mensen nog steeds een installatie met twee commando's: Node 22.19+ (of Node 24), dan npx @deepseek-ai/dsh web, en vervolgens je browser op http://127.0.0.1:3080. Er bestaat sinds oktober 2026 een officiële Electron-build, en die is alleen de moeite waard als je een venster wilt dat blijft bestaan nadat je het hebt gesloten; de community-"desktop"-repositories op GitHub omvatten diezelfde lokale server en bieden geen voordeel meer ten opzichte van DeepSeek's eigen download. Voor terminals voert headless eenmalige taken uit voor CI, en TUI-plugins bieden een interface in de stijl van Claude Code. Vier presets — Standard, PTC, Minimal, Creation — bepalen het gereedschapsoppervlak, en MCP plus trajectory replay maken het echt nuttig. Het is gratis, open source en in previewfase op 0.2.1-rc.2: pin de versie, houd de modelrekening in de gaten en routeer het model apart van de harness.