SSD Nodes Learn Hosting plans →
Guide Matt ConnorDi Matt Connor

DeepSeek Harness su VPS: installazione privata e sicura

Installa DeepSeek Harness su un VPS Linux, blocca la versione npm, scopri cosa fanno i plugin e usa un tunnel SSH per raggiungere la UI web sulla porta 3080.

Cos'è DeepSeek Harness

DeepSeek Harness (dsh) è un runtime per agenti Node.js che può essere eseguito su un VPS (virtual private server). Il modo sicuro per eseguirlo consiste nel vincolarlo a 127.0.0.1 e raggiungerlo dal browser tramite un tunnel SSH (secure shell). Espone una UI web (user interface) sulla porta 3080 invece di funzionare in un terminale. Nella release 0.1.0-rc.6 fissata da questa guida, il server web non richiede una password propria. Di conseguenza, una porta 3080 esposta pubblicamente offre a chiunque la trovi un agente in grado di leggere i file ed eseguire comandi con l'account Linux dell'utente. Le release più recenti, dalla 0.2.0-rc.2 alla 0.2.2-rc.2 dell'11 novembre 2026, l'ultima release elencata da GitHub il 12 novembre 2026, stampano un URL di avvio contenente un token appena generato per quel processo e lo sostituiscono con un cookie di sessione. Tuttavia, continuano ad ascoltare sull'interfaccia loopback per impostazione predefinita e continuano a rifiutare il binding su tutte le interfacce.

DeepSeek lo pubblica con licenza MIT, come pacchetto npm @deepseek-ai/dsh. Il progetto si descrive come un'anteprima per sviluppatori e dichiara che sono previste modifiche incompatibili. La versione fissata di seguito è la release di agosto 2026. Il 12 novembre 2026, il tag latest di npm indica 0.2.2-rc.1. GitHub elenca la prerelease più recente 0.2.2-rc.2, contrassegnata con il tag dsh-v0.2.2-rc.2 e rilasciata l'11 novembre 2026. Controlla il repository prima di copiarne qualsiasi componente su un sistema importante.

Un principio ricorre in tutta la progettazione: tutto è un plugin. L'adapter del modello, il registro degli strumenti, il log della sessione, la sandbox, lo scheduler e lo stesso ciclo dell'agente sono plugin caricati in un unico contesto condiviso, e ciascuno può essere sostituito. Non esiste un core privilegiato che i plugin si limitano a estendere. Questo rende il harness interessante da provare, ma rappresenta anche il punto in cui si concentra l'unico rischio concreto. L'adeguatezza di questo compromesso dipende dal termine di confronto. Il confronto con Claude Code e Omnigent mette il design basato interamente sui plugin a confronto con altre due soluzioni per quanto riguarda l'accoppiamento al modello, la licenza e la quantità di risorse di un VPS richiesta da ciascuna.

Un harness non è un modello

Il harness esegue il ciclo dell'agente. Il ragionamento avviene in un modello separato, quindi nulla funziona finché non gli fornisci una chiave API (application programming interface) oppure l'indirizzo di un endpoint del modello ospitato direttamente da te. Tutto ciò che viene descritto in questo articolo riguarda la configurazione del harness, non il comportamento del modello. È quindi utile comprendere bene la distinzione tra i due prima di passare un pomeriggio a individuare quale componente ha causato un problema.

La configurazione si esegue nell'interfaccia alla voce Settings e poi Models. DeepSeek dispone di una scheda dedicata. Nelle versioni attuali, il pulsante "Add model provider" sotto la scheda apre due modalità. "Third-party model provider" riguarda i provider per i quali il harness distribuisce un catalogo, come OpenAI e Anthropic: si incolla una chiave e il catalogo fornisce l'endpoint e l'elenco dei modelli. "Custom model API" è l'opzione più interessante: richiede un ID del provider in lettere minuscole, un nome visualizzato, un URL di base, un protocollo API, una credenziale e almeno un modello. Il selettore del protocollo offre OpenAI Chat Completions, OpenAI Responses, Anthropic Messages e Gemini API. Puoi quindi configurare un gateway o un server locale che utilizzi uno di questi protocolli. Gli endpoint con differenze nel formato delle richieste richiedono impostazioni di compatibilità. I provider personalizzati possono anche interrogare l'endpoint compatibile con OpenAI GET /models per compilare automaticamente l'elenco dei modelli.

In questo modo puoi indirizzare il harness verso un modello sullo stesso VPS. Ollama espone un'API compatibile con OpenAI all'indirizzo http://127.0.0.1:11434/v1/. Il campo della chiave API accetta una stringa qualsiasi, ollama per convenzione, perché il client in stile OpenAI richiede un valore e Ollama lo ignora. La documentazione di Ollama descrive anche ollama launch dsh, che installa @deepseek-ai/dsh se non è presente e lo avvia usando un modello Ollama. Verifica quindi quale versione installa prima di fare affidamento sul pin riportato sotto. Stabilire se un modello abbastanza piccolo da rientrare nel tuo VPS sia adeguato per eseguire un agente è la questione più complessa. La differenza tra Ollama e vLLM come server locale per modelli determina quanta RAM richiede la soluzione.

Le chiavi immesse nell'interfaccia sono disponibili solo per la scrittura. Il harness le memorizza in $DSH_HOME/.credentials.yaml. Le impostazioni conservano soltanto un riferimento alla credenziale, che nelle versioni attuali viene scritto nel file di patch del profilo attivo, $DSH_HOME/profiles/<profile>/cordis.patch.yml (il profilo è web per dsh web). $DSH_HOME ha come valore predefinito ~/.dsh. Tratta il file delle credenziali come un file di password, perché lo è: chiunque possa leggerlo può utilizzare il tuo budget API. Se preferisci modificare direttamente questi file invece di usare Settings, la guida ai file di configurazione, alle chiavi e agli endpoint dei modelli di dsh spiega la funzione di ogni chiave e quali dati lasciano il tuo sistema nelle diverse modalità.

Cosa serve prima dell'installazione

  • una VPS con Ubuntu 24.04 o un'altra distribuzione Linux attuale, con accesso SSH
  • Node.js 24.9 o versioni successive, perché il ramo principale del progetto e 0.2.2-alpha.2 dichiarano ora >=24.9.0 e i test CI usano Node 24 con un controllo di compatibilità su Node 24.9 e Node 26, senza un job per Node 22; le release contrassegnate fino a 0.2.1-rc.4 indicavano ancora Node 22.19 come versione accettabile, ma questo non è più il requisito minimo su cui il progetto viene compilato
  • un normale account utente, non root, perché l'agente esegue i comandi shell con l'utente che ha avviato il processo
  • pnpm nel PATH se prevedi di installare plugin, perché il comando dei plugin lo esegue tramite una shell
  • la porta 3080 chiusa sul firewall e sul firewall di rete separato del provider

Il pacchetto nodejs incluso in Ubuntu 24.04 è più vecchio di quanto richiesto dall'harness. In questa versione installa quindi Node da NodeSource o tramite nvm, invece di usare apt install nodejs. Il repository ufficiale di Ubuntu 26.10 elenca Node 24.19.0, che supera il requisito minimo Node 24.9. Se la VPS è appena stata creata, vale la pena dedicare dieci minuti al rafforzamento di SSH prima di qualsiasi altra operazione, perché il tunnel da cui stai per dipendere è sicuro soltanto quanto il server SSH che lo gestisce.

Installare DeepSeek Harness su un VPS, bloccato a una versione

node --version
npx @deepseek-ai/dsh@0.1.0-rc.6 web

npx scarica il pacchetto ed esegue il relativo binario dsh. web è un alias di --profile web, che avvia l'applicazione browser; il processo stampa l'indirizzo su cui è in ascolto. Il valore predefinito è http://127.0.0.1:3080. Questi numeri definiscono un comportamento operativo, non sono un'impostazione estetica. Perché dsh stampa un indirizzo di loopback spiega a quali richieste l'harness risponde e a quali non risponde prima che tu provi a raggiungerlo dal laptop.

Blocca la versione. npx @deepseek-ai/dsh web risolve qualunque versione indichi il tag latest nel momento in cui esegui il comando, a meno che il progetto da cui lo esegui non abbia già una copia installata; in quel caso npx usa quella copia senza avvisare. In entrambi i casi, non sei tu a scegliere la versione. Inoltre, il progetto ha già pubblicato diverse release candidate e indica che sono in arrivo modifiche incompatibili. 0.1.0-rc.6 è la versione di agosto 2026 bloccata in questa procedura. Il 12 novembre 2026 latest punta a 0.2.2-rc.1, una release che stampa un URL di avvio contenente un token. GitHub elenca la prerelease più recente 0.2.2-rc.2, quindi il passaggio a un'altra versione deve essere un aggiornamento intenzionale, eseguito dopo aver letto il repository. Una versione bloccata fa sì che il sistema configurato oggi si comporti allo stesso modo il mese prossimo. L'aggiornamento diventa quindi una decisione, non un problema scoperto per caso. Se un comando con versione bloccata avvia comunque la build sbagliata o non riesce affatto a installare il pacchetto, Gli errori comuni di installazione e versione di dsh spiega come svuotare la cache di npx e verificare quale npm include il tuo Node.

Per l'uso quotidiano, installalo una volta invece di risolvere nuovamente la versione a ogni avvio.

npm install -g @deepseek-ai/dsh@0.1.0-rc.6
dsh --profile web --help

Vale la pena eseguire anche la seconda riga, perché il launcher e l'applicazione web usano insiemi di flag distinti. dsh --help mostra le opzioni del launcher. dsh --profile web --help mostra i flag accettati dall'applicazione web. Qui sono disponibili --port, --host e --trusted-host, che può essere specificato più volte.

Ora verifica su quale indirizzo è in ascolto.

ss -tlnp | grep 3080

La colonna dell'indirizzo locale dovrebbe contenere 127.0.0.1:3080. Se contiene 0.0.0.0:3080, l'interfaccia è in ascolto su tutte le interfacce di rete. In questo caso solo i firewall impediscono l'accesso da Internet. Arresta il processo prima di procedere.

Perché non devi mai pubblicare la porta 3080

Il server Web in 0.1.0-rc.6 non dispone di un livello di autenticazione. La relativa configurazione espone un host e una porta di ascolto, e questa è l'intera superficie disponibile. Il controllo degli accessi per le distribuzioni non loopback è un'impostazione separata degli host attendibili, non una schermata di accesso.

Le release più recenti ne aggiungono uno. A partire da 0.2.0-rc.2, all'avvio viene stampato un URL contenente un token appena generato per quel processo; il browser che lo apre riceve un cookie di sessione firmato e viene reindirizzato allo stesso indirizzo senza il token. Un filtro Host/Origin davanti a /api accetta il routing soltanto per loopback, per l'indirizzo di bind del listener e per le autorità indicate con --trusted-host. Questo è un'autenticazione reale, ma la documentazione del progetto avverte che l'URL stampato è una credenziale da condividere solo con gli utenti previsti e che HTTP semplice lo trasmette senza cifratura. A partire da 0.2.1-alpha.2, l'applicazione Web può anche effettuare il bind su un singolo indirizzo locale e gestire direttamente HTTPS con --tls-cert e --tls-key. Questo risolve il problema del testo in chiaro, non quello dell'esposizione. Rende più difficile l'uso improprio di una porta esposta. Non la rende adatta alla pubblicazione.

Ora considera cosa si trova dietro quella porta. L'agent modifica i file nella workspace ed esegue comandi shell, mentre le credenziali del provider si trovano su disco accanto a esso. Pertanto, nella release fissata, una porta 3080 aperta equivale a una shell remota con un'interfaccia di chat, eseguita dall'utente che l'ha avviata e con la tua API key associata. Non serve alcun exploit. Serve il numero della porta. In una release con launch token serve anche il token, che è già disponibile a chiunque possa leggere il tuo terminale, i log del servizio o il traffico non cifrato.

Anche la CLI (interfaccia a riga di comando) conferma questa impostazione. A partire da 0.1.0-rc.6, non supporta deliberatamente --host 0.0.0.0 e termina con un errore di utilizzo invece di avviarsi; anche la nuova 0.2.2-alpha.2 lo rifiuta all'avvio. Questo rifiuto è una funzione di sicurezza: non cercare quindi una patch per rimuoverlo.

Quando un tunnel non è adatto, sono ragionevoli altre due modalità di distribuzione. Inserisci il server in una rete overlay privata, in modo che disponga di un indirizzo raggiungibile tramite routing soltanto dai tuoi dispositivi; è ciò che offre un server di controllo Headscale self-hosted. Oppure anteponi un reverse proxy che autentichi la richiesta prima che raggiunga la porta 3080, ad esempio un server single sign-on Authentik che esegua forward auth. Un reverse proxy privo di autenticazione non è un controllo di sicurezza. È solo un URL più lungo.

Accedere all’interfaccia web tramite un tunnel SSH

Eseguire questo comando sul laptop, non sul server.

ssh -N -L 3080:127.0.0.1:3080 you@your-server

-L apre la porta 3080 sul laptop e inoltra tutto ciò che vi si connette attraverso la sessione SSH cifrata. La parte 127.0.0.1:3080 viene risolta sul server, quindi la connessione arriva all’harness dall’interfaccia di loopback, esattamente come se si stesse utilizzando direttamente il server. -N indica di non avviare una shell remota, perché serve soltanto il forwarding.

Aprire quindi http://127.0.0.1:3080 nel browser locale. In una release con launch token, aprire invece l’URL completo di avvio stampato dal server, incluso il token; quando l’harness viene avviato tramite SSH, stampa comunque la riga di avvio, ma non prova ad aprire automaticamente un browser. Se la porta 3080 è già occupata sul laptop, modificare il numero a sinistra: ssh -N -L 3180:127.0.0.1:3080 you@your-server, quindi aprire http://127.0.0.1:3180, modificando allo stesso modo la porta in un URL con token. Il numero a sinistra è locale, mentre quello a destra appartiene al server: cambiare soltanto il primo.

Salvarlo in ~/.ssh/config e non digitare più il valore manualmente.

Host dsh
  HostName 203.0.113.10
  User deploy
  IdentityFile ~/.ssh/id_ed25519
  LocalForward 3080 127.0.0.1:3080

A questo punto ssh -N dsh avvia il tunnel. Se il browser segnala che la connessione è stata rifiutata, in genere il tunnel è attivo ma sul lato remoto non è in ascolto alcun servizio, perché SSH inoltra la porta indipendentemente dal fatto che l’harness sia in esecuzione. Controllare il server con il comando ss riportato sopra.

Mantieni l'harness in esecuzione dopo il logout

Un comando npx termina insieme alla shell. Un servizio utente systemd rimane attivo e riavvia l'harness dopo un arresto anomalo o un riavvio. L'unità riportata qui è volutamente minimale; se vuoi eseguire l'harness con un account dedicato e con permessi ridotti, bloccare la versione direttamente nell'unità e ottenere log realmente ricercabili, la configurazione systemd headless per dsh tratta l'argomento in dettaglio.

loginctl enable-linger $USER
mkdir -p ~/.config/systemd/user
command -v dsh

enable-linger è necessario perché i servizi utente normalmente si arrestano al termine dell'ultima sessione. Senza questa impostazione, l'harness termina appena chiudi il tunnel. Usa il percorso assoluto restituito da command -v dsh e inseriscilo nell'unità, perché systemd non cerca nel PATH costruito dalla shell di login.

[Unit]
Description=DeepSeek Harness web UI
After=network-online.target

[Service]
Type=simple
WorkingDirectory=%h/projects/site
ExecStart=/usr/local/bin/dsh web
Restart=on-failure
RestartSec=5

[Install]
WantedBy=default.target

WorkingDirectory non è un dettaglio estetico. Il processo dsh usa la directory da cui viene avviato come posizione predefinita nel filesystem. Di conseguenza, un servizio avviato nella directory errata indirizza l'agente alla cartella sbagliata. Tuttavia, quella directory è solo un valore predefinito: una nuova Web UI non ha alcun workspace selezionato finché non ne aggiungi uno in Choose workspace, e la guida del progetto indica di aggiungere la directory da cui hai avviato dsh. La guida non contiene alcun indicatore di versione e la stessa formulazione è già presente in 0.1.0-rc.7, quindi è ragionevole aspettarsela anche nella release bloccata. Imposta nell'unità la directory del progetto, quindi seleziona quel workspace nell'interfaccia.

systemctl --user daemon-reload
systemctl --user enable --now dsh
systemctl --user status dsh

Un'unità che non si avvia ha quasi sempre un percorso ExecStart errato oppure una versione di Node rifiutata dal binario; journalctl --user -u dsh -n 50 indica quale dei due problemi si verifica. In una release che usa il token di avvio, il journal contiene anche l'URL di avvio con token e ogni riavvio ne stampa uno nuovo. Lo stesso schema consente di mantenere in esecuzione qualsiasi agente di programmazione su un VPS, con modalità di errore identiche.

Cosa può fare un plugin

Un plugin è un modulo che aggiunge servizi, eventi tipizzati ed effetti reversibili a un contesto condiviso. I punti di estensione sono la parte che richiede maggiore attenzione:

  • registrare un provider del modello su ctx.llm
  • aggiungere strumenti disponibili al modello su ctx.tools
  • fornire il backend della shell dietro ctx.shell
  • fornire l'accesso al filesystem o la relativa policy dietro ctx.fs
  • registrare comandi per l'utente su ctx.commands
  • eseguire attività in background tramite ctx.jobs
  • avvolgere i processi generati con un backend ctx.sandbox
  • intercettare richieste e chiamate agli strumenti tramite gli eventi agent/* e tools/*
  • estendere lo stato persistente della sessione
  • controllare l'interfaccia tramite ctx.agents

Leggi questo elenco dal punto di vista di un attaccante. Un plugin può fornire il livello filesystem e il livello shell, oltre a inserirsi nel percorso di ogni chiamata agli strumenti effettuata dal modello. Nessuna finestra di autorizzazione separa un plugin da questi punti di integrazione, perché un plugin è normale codice Node caricato nello stesso processo di tutto il resto. Installare un plugin significa eseguire codice di terzi con i permessi del tuo agente, che corrispondono ai permessi del tuo utente Unix.

È la stessa decisione relativa all'affidabilità che prendi quando colleghi un server MCP a un agent su un VPS, dove MCP significa model context protocol. Per questo eseguire in sicurezza un coding agent su un VPS inizia dall'account con cui viene eseguito, non dal modello, e per questo gli attacchi alla supply chain di npm hanno effetti così gravi sui server: la compromissione avviene durante l'installazione e non viene mostrato alcun prompt.

Da dove provengono i plugin

I plugin risiedono nei profili. Un profilo è una composizione denominata archiviata in $DSH_HOME, che per impostazione predefinita è ~/.dsh. La directory di ogni profilo contiene i plugin esterni all'albero che installa. La CLI li gestisce inoltrando gli argomenti direttamente a pnpm e usando la directory del profilo come directory di lavoro.

dsh plugin --profile web add github:deepseek-harness/turtle-ui
dsh plugin --profile web remove turtle-ui

Poiché gli argomenti raggiungono pnpm senza modifiche, add, remove, update e why si comportano come in qualsiasi progetto pnpm. Un plugin può essere un pacchetto npm o un riferimento GitHub. pnpm deve essere prima disponibile nel PATH. Su Node 24, corepack enable pnpm lo inserisce nel PATH. Node 25 ha smesso di distribuire Corepack, quindi su Node 25 e versioni successive installalo con npm install -g pnpm.

L'individuazione avviene tramite un topic GitHub. Gli autori dei plugin aggiungono il topic dsh-plugin al proprio repository. Per trovare i plugin disponibili si consulta quel topic. Un topic è un'etichetta che l'autore applica al proprio repository. Nessuno lo verifica o lo firma. La pagina del topic ordina i risultati in base alle stelle, che misurano la popolarità e non la sicurezza.

Le versioni attuali includono anche un bundle sperimentale di indici per plugin Custom. Attivalo nella sezione Plugins. Nella scheda Discover puoi aggiungere un indice, cioè un file JSON recuperato da un URL fornito da te. L'harness non include alcun indice predefinito. Controlla il formato del file, ma non verifica i titoli, gli autori o le fonti dichiarate da un marketplace. Inoltre, chiunque si trovi sul percorso di rete può modificare un indice servito tramite http: in chiaro. Un marketplace è un catalogo scritto da terzi, non una revisione.

Quattro abitudini rendono questa gestione sostenibile. Leggi il codice sorgente prima dell'installazione, perché la maggior parte dei plugin è abbastanza piccola da poter essere esaminata in dieci minuti. Fissa la versione o il commit esatto invece di seguire un branch. Esegui l'harness con un utente che non possieda altro, su un VPS che saresti disposto a ricreare. Assegna all'agent una chiave API dedicata con un limite di spesa dedicato, separata dalla chiave usata dai servizi di produzione. Quando esamini un plugin e vuoi sapere quali file comportano il rischio, la guida alla verifica di un plugin dsh analizza il manifest, il punto di ingresso e i punti di estensione registrati dal plugin.

Se preferisci confrontare le architetture prima di sceglierne una, l'harness multi-agent Omnigent risolve lo stesso problema con una struttura diversa. Le differenze diventano evidenti quando entrano in gioco i plugin. Se decidi di mantenere due o tre harness sullo stesso host invece di sceglierne uno, mettere ogni harness dietro un'unica API self-hosted evita di creare un tunnel per ogni porta, al costo di un servizio aggiuntivo che deve essere associato a loopback e protetto con una password reale fin dal primo giorno.

Cosa si rompe per primo

Node è troppo vecchio. Il branch principale del progetto e 0.2.2-alpha.2 richiedono Node 24.9 o versioni successive. I test CI vengono eseguiti su Node 24, con un controllo di compatibilità su Node 24.9 e Node 26; non viene eseguito alcun test su Node 22. Le versioni precedenti contrassegnate fino a 0.2.1-rc.4 indicavano Node 22.19 come versione accettabile, ma il progetto non viene più compilato per questa versione. Un runtime precedente non riesce ad avviarsi perché il codice usa sintassi e API che non supporta. Esegui node --version prima di qualsiasi altra operazione.

La porta 3080 è già occupata. Potrebbe essere occupata da un secondo harness, da un processo rimasto attivo o da un'applicazione non correlata che usa anch'essa la porta 3080. Individua il processo con ss -tlnp | grep 3080, quindi arrestalo oppure avvia l'harness su un'altra porta con dsh web --port 3180. --port appartiene all'applicazione Web, quindi va eseguito dopo web.

Il browser non riesce a connettersi attraverso il tunnel. Verifica di aver aperto 127.0.0.1 e non l'indirizzo pubblico del server, perché la porta inoltrata esiste soltanto sul tuo laptop. Verifica quindi che l'harness sia in ascolto sul server: SSH configura l'inoltro indipendentemente dal fatto che all'estremità remota ci sia un servizio in ascolto.

dsh plugin non riesce ad avviarsi. Il comando è un wrapper per pnpm, quindi l'assenza del binario pnpm ne interrompe l'esecuzione prima che inizi qualsiasi operazione sui plugin. In Node 25 e versioni successive questo è lo stato predefinito, perché Corepack non viene più distribuito con Node.

L'agent non riesce a vedere il progetto. Una nuova Web UI non ha alcun workspace selezionato finché non ne aggiungi uno, e il composer della sessione rimane non disponibile fino a quel momento. Il processo usa la directory da cui è stato avviato soltanto come posizione predefinita nel filesystem. Di conseguenza, un'unità il cui WorkingDirectory è la home directory indirizza l'agent verso la tua home directory. Seleziona il workspace nella UI oppure correggi l'unità e ricaricala.

FAQ

È sicuro esporre l'interfaccia Web di DeepSeek Harness sulla porta 3080?

No. Nella versione bloccata 0.1.0-rc.6 il server Web non dispone di autenticazione propria e l'agente che esegue le operazioni modifica file ed esegue comandi shell con l'account che ha avviato il processo; inoltre, la chiave API del provider è archiviata sullo stesso disco. A partire da 0.2.0-rc.2, inclusa 0.2.2-rc.1, la release latest di npm del 12 novembre 2026 e la più recente prerelease 0.2.2-rc.2, l'URL di avvio visualizzato contiene un token di avvio che il browser scambia con un cookie di sessione. Tuttavia, quell'URL è una credenziale che HTTP in chiaro trasmette senza cifratura, quindi le indicazioni non cambiano. Mantieni il listener su 127.0.0.1 e raggiungilo tramite un tunnel SSH. Funziona anche una rete overlay privata o un reverse proxy che autentichi ogni richiesta prima che raggiunga la porta. A partire dalla versione 0.1.0-rc.6 la CLI rifiuta --host 0.0.0.0 e termina con un errore di utilizzo; anche 0.2.2-alpha.2 continua a rifiutarlo. Questo indica chiaramente come gli autori valutano questa configurazione.

È necessaria una chiave API DeepSeek o posso usare un modello locale?

Entrambe le opzioni funzionano, perché harness è un runtime e non un modello. In Settings, quindi in Models, puoi incollare una chiave nella scheda DeepSeek o in un provider del catalogo. In alternativa, puoi scegliere "Add model provider", quindi "Custom model API", e specificare un URL di base compatibile con OpenAI Chat Completions, OpenAI Responses, Anthropic Messages o Gemini API. Un server Ollama locale risponde su http://127.0.0.1:11434/v1/ e accetta qualsiasi stringa nel campo della chiave API. Le chiavi vengono salvate in $DSH_HOME/.credentials.yaml, che per impostazione predefinita è ~/.dsh/.credentials.yaml.

Che cosa concede realmente a un plugin l'installazione di un plugin DeepSeek Harness?

Concede i permessi dell'account che esegue harness. Un plugin è codice Node caricato nello stesso processo. I punti di estensione includono il backend shell, il livello del filesystem, il registro degli strumenti e gli eventi che avvolgono ogni chiamata a uno strumento. Nessun meccanismo isola un plugin da questi punti di integrazione, a meno che non sia il plugin stesso a fornire la sandbox. Leggi il codice sorgente prima dell'installazione ed esegui harness con un account che non possieda risorse importanti.

Quale versione devo installare e continuerà a funzionare?

Installa una versione precisa, ad esempio npx @deepseek-ai/dsh@0.1.0-rc.6 web. Questa è la versione di agosto 2026 fissata in questo documento. Il 12 novembre 2026 il tag latest di npm punta a 0.2.2-rc.1. GitHub elenca la prerelease più recente 0.2.2-rc.2, pubblicata l'11 novembre, e la CLI attuale richiede Node 24.9 o versioni successive. Il progetto si definisce una developer preview e dichiara che sono previste modifiche che possono rompere la compatibilità. Di conseguenza, un comando senza versione fissata può comportarsi in modo diverso da un giorno all'altro. Controlla il repository prima di eseguire l'aggiornamento e prevedi modifiche alle chiavi di configurazione e alle interfacce dei plugin finché la versione inizia ancora con 0.

Questo articolo ti è stato utile?