DeepSeek Harness op Windows: Geen desktop-app, geen probleem — de officiële manier om het te draaien

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.

Als je hebt gezocht op "deepseek harness windows", staar je waarschijnlijk naar een pagina vol wrapper-repo's en vraag je je af welke je 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, de terminal-alternatieven en de eerlijke kanttekeningen bij het draaien van een previewtool. Het is een how-to, geen lanceringsbericht — de lancering en het lekspoor worden in aparte artikelen behandeld.

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 ook nadrukkelijk een preview. dsh is op versie 0.1.0-rc.6, de README bestempelt het als een developer preview, en waarschuwt in hoofdletters dat "ER ZULLEN COMPATIBILITEIT-BREKENDE WIJZIGINGEN KOMEN." Niets daarvan heeft de adoptie vertraagd: het project bereikte ruwweg 50.000 GitHub-sterren binnen de eerste 12 uur nadat het op 2026-08-13 openbaar werd, en stond op ongeveer 126.000 per 2026-08-16 — de snelste open-source release die DeepSeek 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 webinterface is een lokale webapp — daarom is er geen desktopapp; de browser is de desktopapp.

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

Dat is het gehele officiële pad. Als een machine al Node 22+ geïnstalleerd heeft, duurt het van “niets” tot “agent draait” minder dan een minuut.

Waarom elke "DeepSeek Harness Desktop" repo een wrapper is

De resultaten op pagina 1 voor deze zoekopdracht zijn allemaal community-desktop-wrappers — Electron-, Tauri- en WebView2-shells die een Node-runtime bundelen en de officiële webinterface in een omkaderd venster starten. Het zijn geen DeepSeek-producten en ze voegen geen harness-mogelijkheid toe; ze voegen een launcher toe. Wat ze 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 verschillende tempo’s: sommigen pinnen op 0.1.0-rc.5, sommigen op 0.1.0-rc.6, sommigen volgen master, waardoor de versies van wrapper en harness 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.

Wanneer is een wrapper het waard? Wanneer "dubbelklikken op een pictogram, een systeemvak zien, nooit een terminal aanraken" de doorslaggevende factor is, en je accepteert dat een derde partij nu de update- en beveiligingslaag vormt vóór een tool in previewfase. Wanneer niet? Het officiële pad is twee commando's en een browsertabblad — als je al Node hebt, koopt een wrapper je een launcher die je misschien niet nodig hebt, en voegt in ruil daarvoor een eigen onderhoudslast toe.

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 hebt één klik nodig, geen terminal.Er is geen officieel installatieprogramma. Als dubbelklikken niet onderhandelbaar is, ben je aangewezen op community-wrappers — die niet ondertekend zijn, dus weeg het gemak af tegen het onderhoudsoppervlak van derden.

• 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.1.0-rc.6 wordt geleverd met een waarschuwing dat er ingrijpende wijzigingen op komst zijn; tussen rc-builds kunnen plugins en profielen stoppen met werken. Vergrendel 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 de eigen API van DeepSeek: plak een sleutel in Instellingen → Modellen en klaar. Maar dsh accepteert ook een OpenAI-compatibele basis-URL — configureer DEEPSEEK_BASE_URL in de omgeving of stel de LLM-provider in via settings.yaml — wat betekent dat het model achter de harness verwisselbaar is zonder de harness aan te raken. Je kunt DeepSeek V4 Pro draaien voor de moeilijke refactor en DeepSeek V4 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.

De korte versie

DeepSeek Harness op Windows is een installatie met twee opdrachten, geen app-store-installatie: Node 22.19+ (of Node 24), daarna npx @deepseek-ai/dsh web, en dan je browser op http://127.0.0.1:3080. De 'desktop'-repositories op GitHub zijn onofficiële wrappers rond diezelfde lokale server. Voor terminals draait headless eenmalige taken voor CI, en TUI-plugins bieden een interface in Claude Code-stijl. Vier presets — Standard, PTC, Minimal, Creation — bepalen de toolomgeving, en MCP plus trajectherhaling maken het echt nuttig. Het is gratis, open source en in previewfase: pin de versie vast, houd de modelkosten in de gaten en routeer het model los van de harness.