dsh-superagent: il Super-agent di DeepSeek per un repo

Un repository GitHub, un agente che ci lavora sopra e un pannello che mostra per primo quello che aspetta una persona. DeepSeek ha aperto dsh-superagent il 31 ottobre con licenza MIT: è il prototipo del "Super-agent" che il team usa internamente sopra DeepSeek Harness. Nelle prime 32 ore ha raccolto 6.544 stelle e 643 fork.

Il README chiarisce la natura del progetto: codice di ricerca, non un prodotto ufficiale, con buona parte dell'ingegneria fatta da agenti di coding. Può contenere bug, lo stile può essere incoerente, e alcuni meccanismi raccontati nell'articolo di design che lo accompagna sono direzioni future, non funzioni già presenti.

Che cosa fa

Si monta come bundle su DSH e segue un solo repository. Legge notifiche, issue, pull request ed esiti di CI; se attivi l'opzione riceve anche ogni nuovo commento del repository. Quando una persona autorizzata chiede lavoro, apre un ticket, lo esegue in una sessione e in una directory sue, e risponde dove è nata la richiesta, tipicamente con una pull request.

La differenza con un agente lanciato a mano sta in quello che succede prima: la richiesta non diventa subito lavoro.

Il ticket non nasce dalla richiesta

Ogni evento è un Trigger e finisce in uno o più Thread, le sequenze di eventi dello stesso argomento. Su ogni Thread gira una Eval in due strati. Il primo è un gate deterministico che legge la policy del team: chi può chiedere lavoro, da quale canale, con quale forza. Il secondo è il giudizio del modello. Solo un'accettazione produce un Ticket, che porta un Mandate immutabile con la policy, lo scope e l'identità del richiedente: più scope vuol dire un ticket nuovo.

La Subscription è il pezzo che cambia il comportamento nel tempo. Il ticket resta iscritto ai suoi Thread anche dopo la chiusura, e un commento umano sulla stessa pull request lo riapre senza nuova valutazione, sotto lo stesso mandato, rivalidato contro la policy in vigore. Se la policy cambia mentre il lavoro è in corso, il ticket non viene cancellato: la modifica arriva all'assegnazione attiva.

Nel documento del modello di dominio c'è anche quello che gli autori hanno scartato, col motivo: nessuna entità persona, nessuna mappatura delle identità tra canali, nessun rinvio schedulato dentro la valutazione.

L'attenzione come vincolo

La filosofia sta in una riga: prendere quanta meno attenzione umana possibile e dare quanto più valore possibile. L'agente agisce solo su richiesta o quando una regola scritta lo consente, e scrive solo quando una persona deve fare qualcosa o può usare un risultato. La modalità di accettazione predefinita del setup è observe: registra quello che avrebbe fatto e non lo esegue. Ogni messaggio su GitHub si apre dicendo che a scrivere è un agente.

Come lavora un ticket

Ogni ticket ha una sessione dedicata, worker-<id>, e una directory creata da un comando di preparazione, di solito un git worktree. Il limite di concorrenza riserva uno slot alle persone, così un messaggio umano non aspetta dietro i job automatici; il background dopo un turno ha trenta minuti, poi le shell vengono uccise.

L'auto-merge è disattivato, e quando lo accendi vale solo per la pull request del ticket, con le approvazioni sull'ultimo commit e meno di 200 righe cambiate. Richiede anche la CLI di un altro account, perché GitHub attribuisce il merge a chi lo abilita. I comandi bloccati falliscono per nome, ma un worker gira con l'utente del sistema operativo e legge la home: la documentazione lo dice, non è un confine di sicurezza.

Come si installa

Serve Node 22.19 o superiore, pnpm, git 2.32, Python 3.8, tmux, GitHub CLI 2.48, DSH nel range dichiarato dal package e un account GitHub dedicato all'agente, non una GitHub App: il sistema legge le notifiche dell'account. I comandi, in ordine, su una macchina senza profilo superagent già creato:

npm install -g @deepseek-ai/dsh@0.2.1-rc.3
git clone https://github.com/deepseek-ai/dsh-superagent-prototype
cd dsh-superagent-prototype && pnpm install && pnpm build
dsh superagent --from-default-profile web --dump-config > /dev/null
dsh plugin --profile superagent add "link:$PWD"

Il pannello vive nella Web UI di DeepSeek Harness, con una voce propria: Superagent.

Il setup lo fa un agente

Il tutorial di venti passi non c'è. Il README chiede di far leggere SETUP.md al proprio agente di coding e di farsi accompagnare: una domanda corta per messaggio, nessuna esecuzione finché le risposte non sono raccolte, un piano unico da confermare, poi l'installazione. Le credenziali non si incollano in chat, l'agente consegna i comandi da lanciare nel terminale. È la parte più solida del progetto.

I numeri del team

L'articolo che accompagna il codice, Exploring Super-agent Design, è una mezz'ora di lettura tradotta automaticamente dal cinese. Definisce il Super-agent con quattro proprietà (continuo, produttivo, proattivo, persistente) e un'architettura a due livelli: un Router che parla con le persone e non esegue, e Worker isolati che eseguono. Gli autori scrivono che una persona riesce a seguire dalle 3 alle 5 sessioni attive, ed è la ragione per cui il sistema nasconde le sessioni dietro i ticket.

L'esperimento comparativo usa un carico sintetico: circa 300 messaggi, 20 richieste di lavoro, coding simulato, cinque esecuzioni. Il completamento mediano è 12,4 minuti contro 20,4 di una singola sessione con subagenti, e i token in cache letti sono 23,2 milioni contro 6,1: il sistema spende contesto per tempi più stabili. Sono numeri del team, dichiarati preliminari, e misurano lo scheduling, non la qualità del codice.

Chi cerca un agente da mettere in produzione questa settimana non lo troverà qui: un solo commit, nessuna release, niente npm, si installa da clone. Funziona su GitHub.com e non su GitHub Enterprise Server, un'istanza segue un repository solo, e il documento di architettura chiude con due domande aperte, quali campi del Trigger fidarsi e come isolare il profilo dell'agente dagli aggiornamenti di DSH.

Voi lo mettereste su un repo di produzione con questa policy, o aspettereste la prima release?

Fonti:

deepseek-ai/dsh-superagent-prototype - GitHub, README del 2026-10-31
SETUP.md - GitHub, protocollo di setup per un agente
docs/000 Philosophy - GitHub
docs/001 Domain model - GitHub
Exploring Super-agent Design: Towards a More Autonomous Agent System - DeepSeek Harness su X, 2026-11-01
DeepSeek Harness - deepseek.com

📌 Questo articolo riassume una discussione su r/vibecodingitalia. Leggi il post originale.