Far girare un Agent di codice in un repository
Devi leggere e modificare file, eseguire la Shell, cercare sul web, e lasciare che il modello completi in modo continuo compiti di ingegneria in più passi.
Anteprima per sviluppatori · MIT open source · 2026-08
DeepSeek Harness: far lavorare il modello in modo continuo in un ambiente reale
DeepSeek Harness (dsh) non è un nuovo modello di chat, ma uno strato di esecuzione Agent open source. Il modello pensa; il Harness fornisce strumenti, sessioni, sandbox e log riproducibili. La formula è semplice: Agent = modello + Harness.
Pagina aggiornata il 2026-08-18 · Elaborata dalle informazioni pubbliche dell'anteprima per sviluppatori ufficiale
Cos'è DeepSeek Harness?
Distingui prima «modello» e «Harness», poi decidi quale strato installare.
Agent = modello + Harness
Il modello è l'anima: ragiona, spezza i compiti e decide il passo successivo.
Il Harness è le mani e il cantiere: comprende l'ambiente, chiama gli strumenti e lavora in modo continuo in un repository reale.
DeepSeek Harness è l'infrastruttura di esecuzione Agent che DeepSeek ha rilasciato ad agosto 2026 per gli sviluppatori di tutto il mondo (anteprima per sviluppatori). Il codice sorgente è aperto con licenza MIT, il pacchetto npm si chiama @deepseek-ai/dsh, e il repository è su GitHub all'indirizzo deepseek-ai/deepseek-harness.
Ciò che risolve non è «rilasciare un altro modello capace di chattare», ma: il modello sa già ragionare; come modificare file, eseguire comandi, chiamare strumenti, scrivere log in una directory reale, e riprendere dopo un errore. Senza Harness, di solito ti fermi nella casella di dialogo; con Harness, il modello può eseguire in modo continuo entro limiti controllati.
Lo slogan ufficiale è «tutto è un plugin». Il percorso predefinito richiede ancora di configurare una DeepSeek API Key. Il Web UI si può aprire gratis; far girare davvero un Agent genera costi di chiamate al modello. Attualmente appartiene alla serie di anteprima v0.1: plugin centrali e API possono subire cambiamenti incompatibili.
Chi dovrebbe usare DeepSeek Harness?
Non è lo stesso tipo di ingresso della chat web di questo sito. Scegli lo strumento in base al compito.
-
-
Creare plugin o preset personalizzati
Vuoi sostituire modello, strumenti, sandbox o UI, e assemblare il tuo Agent, senza modificare il tronco del Harness.
-
Vuoi solo aprire il browser e chattare
Non serve installare Node.js. Usa l'ingresso web DeepSeek di questo sito e parla direttamente con DeepSeek-V4.
Punti di architettura: tutto è un plugin
DeepSeek Harness si basa su Cordis. Il kernel si occupa solo di caricamento e dipendenze; tutte le capacità concrete arrivano dai plugin.
-
01
Kernel Cordis
Si occupa solo di montaggio, smontaggio e relazioni di dipendenza dei plugin. Non scrive la logica di business dell'Agent nel tronco, per evitare di fare fork dell'intero repository ogni volta che cambi una capacità.
-
02
Tutte le capacità sono plugin
Adattatori di modello, strumenti, Skills, sessioni, sandbox, storage, loop, scheduling e interfaccia possono combinarsi come plugin e collaborare tramite servizi ed eventi.
-
03
Ricombinazione a livello di configurazione
Gli sviluppatori non devono modificare il codice sorgente del Harness: possono scegliere, sostituire o estendere qualsiasi capacità a livello di configurazione, e assemblare un Agent in base allo scenario.
Quattro modalità di esecuzione
Lo stesso kernel di plugin carica per default combinazioni diverse, coprendo la programmazione quotidiana, le chiamate programmatiche agli strumenti, i benchmark e i preset personalizzati.
Modalità standard
Un Agent di codice con funzionalità complete.
Supporta modifica dei file, Shell, ricerca di file e web, Skills, pianificazione, obiettivi, sotto-agent e workflow. Adatto ai compiti quotidiani nel repository.
Modalità PTC
Combinare più round di chiamate agli strumenti con un programma.
Include le capacità della modalità standard e presenta gli strumenti tramite il Code Mode SDK, così il modello orchestra operazioni in più passi con un programma TypeScript.
Modalità minimale
La superficie di strumenti più piccola, per i benchmark.
Di solito conserva solo bash persistente e modifica dei file (str_replace_editor), per osservare il modello in un ambiente minimizzato.
Modalità creazione
Ispezionare il runtime e creare preset personalizzati.
Serve a vedere i plugin attuali, sperimentare plugin Cordis in memoria e comporre nuove modalità di esecuzione.
Ogni esecuzione lascia traccia
Le sessioni sono registrate come flusso di eventi solo-append. Ripresa, fork, ricerca e replay condividono lo stesso log.
-
Prompt di sistema, catena di pensiero, chiamate agli strumenti e risultati vengono scritti nel log di sessione
-
Il dispatch dei sotto-Agent e ogni iniezione di contesto si possono consultare per origine
-
La vista Trajectory ti aiuta ad audire cosa ha visto il modello e cosa ha fatto
-
Le operazioni ad alto rischio devono andare con permessi e approvazione, non consegnare il repository nudo al modello
Inizia a usarlo
Prova rapida o installazione dal codice sorgente
Serve avere Node.js già installato in locale. I requisiti di versione seguono il README del repository ufficiale.
Prova rapida
Dopo aver installato Node.js, puoi avviare il Web UI con npx. Di default si apre sulla porta locale 3080: http://127.0.0.1:3080
$ npx @deepseek-ai/dsh webInstallazione dal codice sorgente
Ottieni il codice sorgente completo del progetto e segui le istruzioni del repository per completare l'installazione (pnpm install, pnpm run build, pnpm dsh web).
$ git clone https://github.com/deepseek-ai/deepseek-harnessConfigurare API Key e modello
Nell'interfaccia, configura una DeepSeek API Key e scegli DeepSeek-V4-Flash o DeepSeek-V4-Pro. Si consiglia di provare prima con Flash.
Indicare workspace e permessi
Scegli la directory del repository e restringi i permessi di file e comandi prima di assegnare i compiti. In fase di anteprima, comandi e configurazione possono cambiare: segui la documentazione del repository.
In che cosa differiscono chat web e Harness?
La chat web DeepSeek di questo sito risolve «aprire e parlare»; Harness risolve «eseguire in modo continuo nel repository».
| Voce di confronto | Chat web DeepSeek | DeepSeek Harness |
|---|---|---|
| Cosa stai cercando | Ingresso di chat online senza installazione | Strato di esecuzione Agent locale / a livello di codice sorgente |
| Utenti tipici | Studio, ufficio, scrittura, domande e risposte | Sviluppatori e chi crea Agent e plugin |
| Può modificare i file del repository? | Principalmente conversazione | Può leggere e scrivere file ed eseguire comandi entro i permessi |
| Come iniziare | Aprire l'ingresso di questo sito nel browser | Avviare il Web UI con npx o clonare il codice sorgente |
Domande frequenti su DeepSeek Harness
Licenza open source, costi, scelta del modello e differenze rispetto alla chat web.
DeepSeek Harness è un nuovo modello ufficiale?
No. È il framework di esecuzione Agent open source di DeepSeek (Harness), usato per collegare modelli, strumenti, sessioni e interfaccia. Chat e ragionamento arrivano ancora da modelli come DeepSeek-V4.
DeepSeek Harness è gratis?
Il codice sorgente del framework è open source con licenza MIT e si può ottenere gratis. Far girare un Agent di solito chiama l'API DeepSeek e genera costi di token. Segui i prezzi ufficiali e il saldo della tua chiave.
È la stessa cosa della chat web DeepSeek di questo sito?
No. La chat web è per aprire il browser e parlare; Harness è per gli sviluppatori che fanno girare un Agent di codice in un ambiente reale. Se ti serve chattare, usa l'ingresso di questo sito; se ti serve modificare codice ed eseguire strumenti, usa Harness.
Per usare Harness bisogna distribuire un modello grande in locale?
No. Il percorso comune nella documentazione pubblica è usare l'API cloud DeepSeek. Ti servono Node.js, una API Key e un browser; non è obbligatorio avere una GPU propria.
Si può già usare in produzione?
I documenti ufficiali lo indicano come anteprima per sviluppatori e avvisano di cambiamenti incompatibili. Va bene per imparare, sperimentare e sviluppare plugin. Valuta tu stesso la stabilità prima della produzione e fissa una versione che hai verificato.
Cos'è dsh e come si avvia?
dsh è l'abbreviazione comune e il nome CLI di DeepSeek Harness. Dopo aver installato Node.js, esegui npx @deepseek-ai/dsh web. Il Web UI si apre di default su http://127.0.0.1:3080.
Distingui prima lo scenario, poi scegli l'ingresso
Per parlare subito, apri la chat web DeepSeek; per far girare un Agent nel repository, usa il DeepSeek Harness ufficiale.
Questa pagina è elaborata dal sito DeepSeek-V4 a partire dalla pagina ufficiale Harness di DeepSeek e dal repository GitHub, per facilitare ricerca e confronto. Non è un sito ufficiale DeepSeek. Installazione, configurazione e compatibilità seguono la documentazione ufficiale e il README del repository.