Scheda OrcaRouter intitolata "DeepSeek Harness su Windows", con sottotitolo "Esiste ora un'app desktop ufficiale — per la maggior parte delle persone questi due comandi restano comunque la via più rapida". Un chip comando scuro con il testo "npx @deepseek-ai/dsh web" indica con una freccia un chip chiaro con il testo "http://127.0.0.1:3080". Sotto, tre riquadri statistici: "MIT · open source", "v0.2.1-rc.2" con didascalia "Anteprima per sviluppatori — le modifiche incompatibili vengono annunciate in anticipo", e "Tutto è un Plugin" con didascalia "Oltre 150 plugin in una distribuzione predefinita". Piè di pagina: Node 22.19 o versione successiva, poi il comando sopra, poi una scheda del browser.
Guides & Insights

DeepSeek Harness su Windows: due comandi, oppure l'app desktop ufficiale

Autore

Gideon Frost

Data di pubblicazione

Ultimi modelli · 20Vedi tutti i modelli →
Benchmark: Artificial Analysis · aggiornato ogni giorno
Torna a tutti gli articoli

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.

Se hai cercato "deepseek harness windows", i risultati ora sono un mix tra la pagina di download ufficiale di DeepSeek e una lunga coda di repository wrapper della community, e non è ovvio quale si supponga che tu debba installare. Questo articolo risponde alla vera domanda dietro la ricerca: cos'è in realtà DeepSeek Harness, qual è oggi il modo ufficiale di eseguirlo su Windows, quando conviene invece usare l'installer, quali sono le alternative da terminale e quali sono le avvertenze oneste da conoscere quando si usa uno strumento in fase di anteprima. È una guida pratica, non un post di lancio: il lancio e le tracce delle fughe di notizie sono trattati in articoli separati.

Cos'è DeepSeek Harness (e cosa non è)

DeepSeek Harness non è un modello e non ne esegue il benchmark. È il runtime dell'agente: il livello che collega un modello a strumenti, file, una shell e internet — leggendo il tuo codice, pianificando modifiche, eseguendo comandi e iterando finché l'attività non è completata. L'architettura è espressa nel suo slogan: "Tutto è un Plugin." Modelli, strumenti, competenze, sessioni, sandbox, il loop dell'agente stesso e persino la web UI sono plugin composti all'avvio, costruiti sul meta-framework Cordis — lo stesso kernel alla base dell'ecosistema di chatbot Koishi. Una distribuzione predefinita include oltre 150 plugin.

È anche, senza mezzi termini, un'anteprima. dsh è alla versione 0.2.1-rc.2, il README lo definisce un'anteprima per sviluppatori e avverte in maiuscolo che «CI SARANNO MODIFICHE CHE ROMPERANNO LA COMPATIBILITÀ». Niente di tutto ciò ha rallentato l'adozione: il progetto ha raggiunto circa 50.000 stelle su GitHub nelle prime 12 ore dalla pubblicazione il 2026-08-13 e contava 256.853 stelle e 30.970 fork al momento della lettura, il 22 ottobre 2026 — la release open source più rapida che DeepSeek abbia mai distribuito.

La risposta breve: la procedura ufficiale di Windows si compone di due comandi.

Il README ufficiale di DeepSeek riporta in una riga la procedura per eseguire su Windows: installa Node.js, poi esegui npx @deepseek-ai/dsh web. Concretamente, i passaggi sono:

• Installa Node.js 22.19+ o Node 24. La versione attuale di dsh richiede Node 22.19 o successivo; Node 24 LTS è la scelta più sicura su Windows, e il motivo è prosaico — le versioni più recenti di Node includono la decompressione zstd nativa, che dsh usa per leggere i suoi log di sessione compressi. Verifica la tua installazione con node --version in PowerShell o 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.

• Apri quell'indirizzo nel tuo browser. La Web UI è un'app web locale e il browser è il client. È la stessa interfaccia che la build Electron carica da dsh-app://app/, senza la cornice della finestra.

• Aggiungi una chiave del modello una volta. Nell'interfaccia web, apri Impostazioni → Modelli, incolla una chiave API di DeepSeek e salva. Ha effetto immediato, senza riavviare il server. dsh usa la cartella in cui l'hai avviato come posizione predefinita del filesystem e il passaggio dell'interfaccia Scegli area di lavoro ti permette di puntarlo su qualsiasi directory del progetto.

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.

Questo è l'intero percorso ufficiale se vuoi restare in un browser. Se su una macchina è già installato Node 22+, il tempo da "niente" ad "agente in esecuzione" è meno di un minuto.

Repository "DeepSeek Harness Desktop": cosa ha cambiato l'app ufficiale

I risultati di pagina 1 per questa query sono ancora in gran parte wrapper desktop della community: shell Electron, Tauri e WebView2 che impacchettano un runtime Node e avviano l'interfaccia Web ufficiale all'interno di una finestra incorniciata. Nessuno di essi è un prodotto DeepSeek e nessuno aggiunge capacità di harness; aggiungono un launcher. Ciò che è cambiato è che da ottobre 2026 DeepSeek distribuisce un proprio installer, quindi il wrapper non è più l'unico modo per evitare un terminale. Ciò che i wrapper hanno in comune:

• Si avviano con un doppio clic ed evitano del tutto la riga di comando, che è il loro vero punto di forza.

• Non sono firmati, quindi Windows SmartScreen avviserà durante l'installazione — "More info → Run anyway" fa parte del flusso.

• Seguono il progetto ufficiale a velocità diverse: alcuni sono ancora fermamente ancorati alla 0.1.0-rc.6, altri seguono master, e molti sono stati aggiornati l'ultima volta alla 0.1.x, così la versione del wrapper e quella dell'harness finiscono per divergere nel tempo.

Memorizzano gli stessi dati locali che dsh usa sempre in ~/.dsh, quindi passare da un wrapper alla CLI ufficiale non resetta le tue sessioni.

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.

Quando vale la pena usare un wrapper? Quasi mai ormai, e questo è il cambiamento. Quando “fai doppio clic su un’icona, vedi un’icona nell’area di notifica, non tocchi mai un terminale” era il fattore decisivo, un wrapper era l’unica strada — oggi DeepSeek distribuisce il proprio installer, quindi l’unico vero vantaggio del wrapper è sparito e ciò che resta è una terza parte che si frappone, nel livello di aggiornamento e sicurezza, davanti a uno strumento in fase di anteprima. Quando è ancora giusta la via ufficiale? Due comandi e una scheda del browser — se hai già Node, né il wrapper né l’installer ti danno molto.

Il percorso da terminale: CLI headless e plugin TUI

Se il browser non è dove lavori, anche dsh ha una storia da terminale, divisa in due modalità.

Headless è il profilo non interattivo: dsh --profile headless "summarize this repository" esegue un singolo compito senza interfaccia utente, stampa il risultato ed esce — la modalità adatta alla CI. Su Windows questa è anche la modalità che gli script e le attività pianificate dovrebbero usare, perché non richiede un display né una sessione con accesso effettuato.

TUI è una porta d'ingresso interattiva del terminale in stile Claude Code, distribuita come bundle di plugin della community anziché nel pacchetto core. Pacchetti come dsh-tui si installano in un profilo con dsh plugin --profile tui add <package> e si eseguono con dsh --profile tui; almeno uno include un launcher .cmd per Windows. L'inghippo da conoscere prima di provare: una TUI richiede un terminale reale sia per l'input che per l'output — se la tua configurazione usa pipe o reindirizzamenti, dsh si rifiuterà e ti dirà di usare invece la modalità headless.

I quattro preset: quale per quale lavoro

dsh è fornito con quattro preset di agent integrati, e non sono una scala di difficoltà: sono quattro diverse superfici di strumenti. Puoi impostare il default in ~/.dsh/settings.yaml sotto agent-presets.default.

• Standard è il default: l'agente quotidiano completo — modifica di file, shell, ricerca di file e sul web, skill, sotto-agenti, pianificazione. È da qui che la maggior parte degli utenti Windows dovrebbe iniziare.

• PTC (chiamato anche Code mode) mantiene tutto ciò che offre Standard, ma cambia il modo in cui gli strumenti vengono esposti: invece di una lunga sequenza di chiamate isolate agli strumenti, il modello scrive un programma in TypeScript che compone operazioni in più passaggi — cicli, filtri, rami condizionali. Per flussi di lavoro complessi, ripetuti o in più passaggi.

• Minimalriduce deliberatamente l'agente a due strumenti — una shell persistente e un editor di file — ed è pensato per la valutazione e il benchmarking, non per l'uso quotidiano. È questa la configurazione su cui DeepSeek esegue i propri punteggi agentici.

• Creation (Cordis) serve per creare preset personalizzati: include ispezione a runtime, sperimentazione di plugin in memoria e guida alla creazione di preset. Per armeggiare con l'harness stesso.

MCP e replay della traiettoria: perché vale la pena eseguirlo

Due caratteristiche giustificano l'uso di dsh rispetto a un semplice client di chat. In primo luogo, un client Model Context Protocol (MCP) è integrato: un comando /mcp e una scheda Settings MCP collegano server MCP esterni all'harness, così gli stessi strumenti che usano i tuoi altri agenti si integrano in dsh. In secondo luogo, ogni esecuzione viene scritta in un log di sessione append-only, e la vista Trajectory ti consente di ispezionare un'esecuzione per fonte, riprenderla, biforcare, cercarla e riprodurla. Questa è la differenza tra fare debug di un agente fissando la sua risposta finale e ripercorrere passo dopo passo il motivo di ogni chiamata.

Quando il percorso ufficiale è la risposta sbagliata

• Ti serve un'installazione con un clic, senza terminale. Da ottobre 2026 esiste un installer ufficiale, quindi questo non è più un motivo per ricorrere a un wrapper. Resta comunque un buon motivo per evitare il terminale, ed è una scelta legittima: quello che scambi è la scheda del browser con una finestra Electron che si nasconde invece di chiudersi e si aggiorna da sola su un canale privo di release stabili.

• Il tuo computer Windows è vecchio o bloccato. dsh richiede Node 22.19+ (o Node 24). Su una macchina gestita, ciò comporta l'installazione del runtime e probabilmente un'approvazione che non hai.

• È un'anteprima, e si rompe. La 0.2.1-rc.2 arriva con un avviso che sono in arrivo modifiche incompatibili; tra le build rc, plugin e profili possono smettere di funzionare, e nella build desktop l'harness e la shell Electron devono sempre avere esattamente la stessa versione. Blocca la versione per qualsiasi cosa gestita tramite script.

• La spesa per i modelli è a tuo carico. dsh è gratuito; ogni attività consuma token sulla chiave che hai configurato. Un ciclo dell'agente rilegge i file e ritenta, e un modello verboso su un compito difficile può spendere un budget sorprendente in un pomeriggio. È qui che la scelta del modello, non la scelta dell'harness, domina i costi.

• Un abbonamento flat può battere il routing per token. Se vivi all'interno del piano di un singolo laboratorio sotto i suoi limiti, l'abbonamento flat è spesso più economico di qualsiasi percorso per token. Il routing vince quando mescoli modelli o vuoi failover — non di default.

Instrada il modello dietro l'harness.

Il percorso nativo è l'API di DeepSeek stessa: incolla una chiave in Impostazioni → Modelli e sei pronto. Ma dsh accetta anche un base URL compatibile con OpenAI — imposta DEEPSEEK_BASE_URL nell'ambiente oppure configura il provider LLM in settings.yaml — il che significa che il modello dietro l'harness è intercambiabile senza toccare l'harness. Puoi usare DeepSeek V4 Pro per il refactoring difficile e DeepSeek V4.1 Flash per modifiche meccaniche a basso costo, sulla stessa installazione locale di dsh.

È questo lo strato che occupa OrcaRouter. Un unico URL di base compatibile con OpenAI, oltre 200 modelli, zero ricarichi — il prezzo di listino del provider viene applicato direttamente — e failover automatico quando un provider limita la frequenza o degrada le prestazioni. Punta dsh su di esso e l'harness resta sulla tua macchina, mentre il catalogo modelli diventa una decisione di routing, non un acquisto. Due avvertenze oneste: non ospitiamo dsh — gira localmente sul tuo computer Windows — e siamo solo il livello di accesso ai modelli se vuoi modelli oltre l'API di DeepSeek. E per un singolo modello pesante entro i limiti del piano, l'abbonamento flat è spesso la scelta più economica, indipendentemente dal 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.

La versione breve

DeepSeek Harness su Windows resta una configurazione in due comandi per la maggior parte delle persone: Node 22.19+ (o Node 24), poi npx @deepseek-ai/dsh web, quindi il browser su http://127.0.0.1:3080. Esiste una build Electron ufficiale a partire da ottobre 2026 e vale la pena solo se vuoi una finestra che sopravvive alla chiusura; i repo "desktop" della community su GitHub avvolgono lo stesso server locale e non hanno più alcun vantaggio rispetto al download ufficiale di DeepSeek. Per i terminali, l'esecuzione headless esegue attività one-shot per la CI, e i plugin TUI offrono un'interfaccia in stile Claude Code. Quattro preset — Standard, PTC, Minimal, Creation — scelgono la superficie degli strumenti, e MCP più la riproduzione delle traiettorie lo rendono davvero utile. È gratuito, open source e in fase di anteprima alla 0.2.1-rc.2: fissa la versione, tieni d'occhio il costo del modello e instrada il modello separatamente dall'harness.