DeepSeek Harness developer preview: Everything is a plugin

Punti chiave

1. Data / fonte. 13 agosto 2026, pagina prodotto deepseek.com/harness, non firmata. Il repository deepseek-ai/deepseek-harness è stato aperto lo stesso giorno con licenza MIT. Angolo interpretativo: la componibilità basata su plugin non ha nulla di notevole nel 2026; l'elemento distintivo sta altrove, in docs/architecture.md piuttosto che sulla pagina di vendita. ### L'invariante di logging > « Model-visible means logged. Anything that reaches a model request must be reconstructable from the log, and a runtime invariant asserts it. This is why a new model-visible input requires a new session event: extend SessionEventMap and render from the log. » Ne derivano tre proprietà. È un vincolo eseguibile, non un'intenzione dichiarata: l'harness fallisce se il contesto raggiunge il modello senza essere scritto nel log. Il log diventa la fonte, non un registro di eventi — deriveMessages() proietta la cronologia del modello a partire dallo stream, e « Fork, resume, transcripts, telemetry, and persistence all derive from this stream », senza alcuno stato parallelo che possa disallinearsi. Infine, è una risposta ingegneristica alla domanda che ogni post-mortem di un incidente agentico si pone: cosa ha effettivamente visto l'agente? Un criterio estraibile per chiunque valuti un harness: tutto ciò che raggiunge il modello è ricostruibile da un unico log, e questa proprietà è asserita a runtime? ### Tracciabile non significa archiviabile | Dove | Cosa viene scritto | |---|---| | Pagina prodotto | « Every run is traceable » — resume, fork, search, replay sullo stesso stream | | README.md | « THERE WILL BE COMPATIBILITY-BREAKING CHANGES. » | | CLAUDE.md | « dsh-session keeps SESSION_FORMAT_VERSION at 0 with no compatibility promise » ; « Backends reject old on-disk formats » | In concreto: una sessione registrata oggi può diventare illeggibile dopo un aggiornamento, con il backend che la rifiuta attivamente invece di tentare una migrazione. La posizione è deliberata e datata — « Pre-release stance: foundation over blast radius. Remove this section at the first tagged release. With no external consumers, prefer the correct foundation over compatibility shims ». Regola pratica: non basare compliance, audit o retention sui log di DSH prima della prima release taggata; l'indicatore da monitorare è la scomparsa della sezione « Pre-release stance » da CLAUDE.md, che DeepSeek stessa designa come segnale. ### La cronologia | Data | Evento | |---|---| | 13 agosto 2026 | DSH pubblicato con licenza MIT + DeepSeek-V4-Pro raggiunge la GA (DeepSeek-V4-Pro-0813), supporto nativo per la OpenAI Responses API, integrazione ottimizzata per Codex | | 16 agosto 2026, 16:00 UTC | Nuovo listino prezzi API: tariffe di picco / fuori picco, « Off-peak rates are 50% lower than peak » | | 14 agosto 2026 | Z.ai annuncia GLM-5.3 con lo stesso schema tariffario per fascia oraria — [[zai-glm-53-emergent-cyber-2026-08-14]] | L'harness viene regalato, l'inferenza viene resa più cara: un harness MIT capace di instradare verso qualsiasi provider ha valore per DeepSeek solo se genera volume di token. Due avvertenze: la cifra di circa 4,5× sul prezzo dei token in output di V4-Pro proviene dalla stampa, non dall'annuncio API, che pubblica solo il principio e il −50%; e un listino ancorato a un fuso orario asiatico sposta il costo reale per un team europeo. ### « Everything is a plugin »: stato dell'arte al 13 agosto | Livello | Cosa viene rilasciato | Stato | |---|---|---| | Modelli | dsh-llm-deepseek (route deepseek-official) e dsh-llm-pi-ai, un adapter generico multi-provider costruito su @earendil-works/pi-ai | mantenuto — « an OpenAI-compatible gateway, a self-hosted server, or a provider newer than the installed catalog is configuration, not a code change » | | Esecuzione / sandbox | seam ctx.fs, ctx.shell, ctx.subprocess, ctx.sandbox; POC E2B | meccanismo in atto, un backend remoto allo stadio di POC | | UI / distribuzione | bundle dsh-base, dsh-web-app, dsh-headless; profili web e headless | mantenuto | | Loop dell'agente | core/agent-loop descritto come « the default driver » dietro l'interfaccia Agent | mantenuto per costruzione | | Ecosistema di terze parti | topic dsh-plugin, pagina "Community plugins" | da monitorare — nessun ecosistema esiste al giorno zero | La frase che rende credibile la promessa è architetturale: « There is no privileged core to patch: you extend dsh by mounting a plugin beside the others, and registrations are effects that unwind when their plugin unloads. » Corollario operativo: « Seams are why one provider swap changes the whole product. Filesystem and subprocess providers share one execution world, so pointing them at a remote sandbox moves Bash, PTY, and LSP with them, with no provider forks. » Un principio riutilizzabile al di fuori di DSH: un seam esiste solo se i tre ruoli — Service Definition, Service Provider, Consumer — sono progettati insieme, « one role alone is not a seam ». Verifica in un solo comando: dsh --profile web --dump-config stampa l'albero effettivamente avviato, e « any row it prints can be replaced by a patch of your own ». ### Mode Minimal Rilasciato « for benchmarking models in a minimal environment », con BENCHMARK.md che punta alla variante jsonrpc-agent dell'SDK Python. Il contesto chiarisce l'intento: il giorno successivo, un laboratorio cinese ha documentato la misurazione del proprio modello e di quelli dei concorrenti « in Claude Code 2.1.207 », con l'harness di un concorrente che funge da infrastruttura di misurazione condivisa. DSH integra nel prodotto, con licenza MIT, l'harness di benchmarking minimale. Avvertenza: al 13 agosto non è stato pubblicato alcuno score, e nulla indica che una terza parte abbia adottato questo harness. Posta in gioco della portabilità sottostante: [[janakiram-agent-platform-portability-contract-2026-07-20]]. ### Il nucleo appartiene a una terza parte DSH è costruito su Cordis (cordiverse, un progetto indipendente), il cui design è pubblicato in un paper di terze parti — A Programming Paradigm for Spatiotemporal Composability. Nel repository, Cordis è vendorizzato (vendor/cordis e nove moduli fratelli: cosmokit, hmr, loader, schemastery, timer…) con un manifesto e una procedura di sincronizzazione. Tre letture valgono simultaneamente: DeepSeek accredita la propria dipendenza anziché rimarchiarla; la vendorizzazione congela la versione e rimuove la dipendenza dalla disponibilità, al costo di un onere di sincronizzazione da mantenere; e l'argomento centrale del prodotto poggia sulla proprietà intellettuale di un progetto comunitario che DeepSeek non controlla. Per chi valuta la tenuta nel tempo di DSH, lo stato di salute di cordiverse/cordis è una variabile importante almeno quanto quella del repository di DeepSeek stessa. ### La Safe Use Policy > « Because Harness has the ability to run code and execute actions on your machine, it introduces unique security risks. Although most foundation models include basic safeguards against prompt injection, inherent risks remain […] In some cases, the Agent may execute commands embedded in content, even if those commands conflict with the assigned task. » Le precauzioni raccomandate formano una dottrina d'uso applicabile indipendentemente da DSH: una macchina virtuale dedicata; verificare gli output; non fornire informazioni sensibili o riservate; richiedere l'approvazione umana per qualsiasi operazione dagli effetti significativi; scomporre istruzioni complesse in operazioni isolate, per « reduce the risk that a single erroneous command affects multiple parts of the system simultaneously »; installare solo plugin, server MCP, Skill, Hook e dipendenze provenienti da fonti fidate e verificate. Quest'ultimo punto è in tensione con l'argomento di vendita: la superficie di attacco cresce con la componibilità. Vedi [[valente-zalewski-beyond-zero-enterprise-security-ai-era-2026-07-20]]. ### La modellazione turn / step, degna di essere ripresa « A step is one model request plus the tools it calls. A turn is zero or more steps: it opens before its first input is claimed and closes once nothing is owed. » Il flusso completo è pubblicato: turn/start → agent/pre-step → step/start → agent/request → llm/stream → tool/call → tools/pre-execute|execute|post-execute → step/end → agent/turn-stopping → turn/end, con tre domini di estensione distinti — session events (fatti durevoli che sopravvivono a un reload), agent events (intercettazione del lavoro in corso), capability events (policy e adapter su un seam, « without importing the loop »). Due dettagli di design tratti da un'esperienza operativa reale: « a rejected or empty first claim still closes a durable turn that spent no step, so the log records the attempt » — il turn che non ha fatto nulla viene comunque loggato, senza di che il rifiuto sarebbe invisibile a un post-mortem; e la distinzione tra waterfall (agent/pre-step, agent/request, llm/stream, tools/, dove i listener devono chiamare next()) e serial (agent/turn-stopping, senza next()), che rende esplicito il contratto di delega per ogni evento. ### Dettaglio del repository L'albero radice di deepseek-ai/deepseek-harness contiene CLAUDE.md (una copia letterale di AGENTS.md), .claude/skills e una directory .agents. Un repository open source pubblicato nel 2026 da un laboratorio di frontiera documenta le proprie convenzioni per gli agenti sullo stesso piano di quelle per gli umani: uno standard di repository degno di essere adottato. ### Igiene della citazione 1. Distinguere la pagina dal repository. Le affermazioni forti provengono da docs/architecture.md, CLAUDE.md e dai file README.md dei pacchetti. Citare « DSH's architecture documentation », mai « la pagina di lancio ». 2. 120.060 star e 11.831 fork in tre giorni (rilevati il 16 agosto 2026 tramite l'API GitHub) misurano l'attenzione, non l'adozione, e sono destinati a deperire. 3. Le tariffe non figurano nell'annuncio archiviato: citare il principio picco/fuori picco e il −50%, reperire altrove le cifre in $/M. 4. « Open source » qui significa MIT e nient'altro: nessuna governance aperta, nessuna roadmap pubblica, nessun impegno di compatibilità. Codice aperto pubblicato da un vendor, non un progetto comunitario — una distinzione esaminata in [[mozilla-state-of-open-source-ai-2026-07]].