DeepSeek Harness per il design.
Un modello può scrivere JSX, ma un agente di design efficace ha bisogno di più del semplice output del modello. Gli servono regole del brand, riferimenti, strumenti, autorizzazioni e un ciclo che esegua il rendering e verifichi il risultato. DeepSeek Harness espone questi elementi circostanti anziché nasconderli.
Per il lavoro sulle interfacce, rendi espliciti il brief e il ciclo di accettazione. La route DeepSeek predefinita supporta solo testo, quindi la base più affidabile è un flusso di lavoro basato su codice e specifiche; allega screenshot solo dopo aver selezionato una route del modello che dichiari il supporto per l'input di immagini.
Questa flessibilità è utile nel lavoro di design, perché la qualità dell'UI generata dipende dall'harness che circonda il modello: regole di progetto persistenti, skill riutilizzabili, il provider giusto per input testuali o visivi, strumenti per file e shell e un ciclo di verifica. Questa guida illustra la configurazione funzionante più rapida, i limiti rilevanti per le attività di UI e l'effettivo confine con Open Design: dsh non dispone ancora di un adattatore Open Design ufficiale, mentre l'adattatore DeepSeek TUI esistente è una CLI diversa.
Configura DeepSeek Harness da zero
L'anteprima pubblica richiede Node.js `^22.19.0` o `>=24.0.0`. Al primo utilizzo, il comando npm inizializza il profilo web, consentendoti di accedere a un'UI locale funzionante senza clonare il repository.
# 1. Start the official DeepSeek Harness Web UI
# Requires Node.js ^22.19.0 or >=24.0.0
npx @deepseek-ai/dsh web
# 2. Open the local UI (default)
# http://127.0.0.1:3080
# 3. In Settings → Models, add a DeepSeek API key
# or configure another supported provider.
# 4. Choose the project directory as your workspace.
# Optional: run one headless job after the profile is initialized
npx @deepseek-ai/dsh --profile headless "Audit this UI against AGENTS.md"
- Le credenziali restano referenziate: La Web UI archivia i segreti dei provider in `$DSH_HOME/.credentials.yaml`; le impostazioni conservano un riferimento alle credenziali e l'UI riceve un descrittore oscurato anziché la chiave vera e propria.
- Considera l'anteprima un'infrastruttura con versione bloccata: I responsabili della manutenzione avvertono esplicitamente che verranno introdotte modifiche incompatibili. Blocca la versione per il flusso di lavoro del team e verifica le modifiche di ogni release prima di aggiornare.
Perché un harness basato sui plugin è adatto al lavoro di design
Un modello può scrivere JSX, ma un agente di design efficace ha bisogno di più del semplice output del modello. Gli servono regole del brand, riferimenti, strumenti, autorizzazioni e un ciclo che esegua il rendering e verifichi il risultato. DeepSeek Harness espone questi elementi circostanti anziché nasconderli.
- Contesto di design persistente: Il caricatore di istruzioni predefinito legge `AGENTS.md` e `CLAUDE.md` dalla gerarchia del progetto. Inserisci token, regole dei componenti, breakpoint responsive e criteri di revisione dove ogni esecuzione possa trovarli.
- Skill riutilizzabili: Le skill locali possono risiedere in `.dsh/skills` o `.agents/skills`. Una skill frontend può racchiudere il brief, la checklist, gli esempi e gli script necessari affinché ogni attività di UI non riparta da zero.
- Scelta del provider in base all'attività: La Web UI può configurare DeepSeek, provider presenti nel catalogo come Anthropic o OpenAI ed endpoint personalizzati compatibili con OpenAI. Per l'input di screenshot, usa una route dichiarata come compatibile con le immagini; per attività basate su testo, codice, DOM e specifiche, usa la route nativa di DeepSeek.
Il limite importante è lo stesso per ogni agente: la componibilità non equivale al gusto. Senza vincoli intenzionali per tipografia, spaziatura, componenti e interazioni, il runtime automatizzerà fedelmente un risultato generico. Il ruolo di Open Design è fornire e organizzare questi input di design.
Un flusso di lavoro pratico con DeepSeek Harness per UI e frontend
Per il lavoro sulle interfacce, rendi espliciti il brief e il ciclo di accettazione. La route DeepSeek predefinita supporta solo testo, quindi la base più affidabile è un flusso di lavoro basato su codice e specifiche; allega screenshot solo dopo aver selezionato una route del modello che dichiari il supporto per l'input di immagini.
- Avvia dsh dal repository, scegli quella directory come spazio di lavoro e seleziona la route del modello per questa attività.
- Inserisci il contratto del brand in `AGENTS.md`, `CLAUDE.md` o in un file `DESIGN.md` referenziato: token, primitive, spaziatura, tipografia, breakpoint, stati e pattern vietati.
- Carica una skill frontend mirata da `.dsh/skills` o `.agents/skills`; conserva esempi e script di convalida insieme alle istruzioni.
- Chiedi all'agente di riutilizzare i componenti esistenti, avviare l'applicazione e convalidare gli stati responsive con i test o gli strumenti del browser già presenti nel progetto.
- Esamina il risultato visibile, annota differenze specifiche e procedi per piccoli commit. Ripristina le iterazioni deboli anziché stratificare correzioni su una base inadeguata.
Un prompt efficace specifica sia i vincoli visivi sia le prove di verifica:
Implement the account dashboard in React + TypeScript.
Reuse the components and tokens named in AGENTS.md and DESIGN.md.
Use a 240px sidebar, a 12-column content grid, and the documented
mobile navigation pattern. Include loading, empty, error, and focus states.
Run the app and existing UI checks, inspect desktop and mobile breakpoints,
and report the exact files and states you verified.Se uno screenshot è indispensabile, configura prima un provider compatibile con le immagini. DeepSeek Harness rifiuta un'immagine prima dell'invio quando la route selezionata non dichiara il supporto per le immagini: una protezione utile contro l'eliminazione silenziosa del riferimento.
Plugin, skill e contesto del progetto
DeepSeek Harness si distingue soprattutto sotto la superficie della chat. Il suo albero di plugin consente ai team di integrare il flusso di lavoro di design nel runtime, invece di incollare un prompt in ogni sessione.
- AGENTS.md e CLAUDE.md: Il plugin delle istruzioni carica il file globale dell'utente e la gerarchia del progetto, quindi rileva i file di istruzioni nidificati pertinenti dopo le operazioni sui file native. Usalo per regole di design durature, non per richieste una tantum.
- Skill nel file system: Il registro delle skill individua le radici del progetto e dell'utente, assegna priorità ai duplicati ed espone al modello uno strumento `skill`. È il luogo naturale per procedure relative alla cura del frontend, all'accessibilità, al QA responsive e al sistema di design.
- Profili e bundle: Un profilo sovrappone bundle di plugin ordinati e patch dell'utente. I team possono mantenere una composizione incentrata sul design con il provider, gli strumenti, la policy di autorizzazione e le fonti delle skill di cui hanno effettivamente bisogno.
- MCP e funzionalità esterne: L'albero dei sorgenti include funzionalità client MCP, ma la configurazione destinata agli utenti è ancora orientata agli sviluppatori. Durante l'anteprima, considera le integrazioni come lavoro su plugin con versioni definite, non come un flusso stabile basato su caselle di controllo.
Prima di creare un flusso di lavoro interno destinato a durare, esamina l'albero effettivo con `dsh --profile web --dump-config`. L'output mostra ciò che è realmente montato e modificabile; è più affidabile che presumere che ogni pacchetto del repository sia attivo nel profilo distribuito.
Insidie dell'anteprima per sviluppatori e del design
Gli errori più gravi derivano dal considerare un'anteprima come un prodotto stabile, un percorso solo testuale come un modello visivo o un harness flessibile come una fonte di gusto visivo.
- Blocca la versione prima di personalizzare: Le modifiche che interrompono la compatibilità fanno esplicitamente parte della policy dell'anteprima. Blocca la versione npm e mantieni le patch dei profili sufficientemente piccole da poter essere riesaminate dopo un aggiornamento.
- Controlla le modalità di input supportate dal modello selezionato: La route nativa per i completamenti chat di DeepSeek supporta solo testo. Per convertire screenshot in codice, seleziona e dichiara una route del provider compatibile con le immagini, anziché presumere che l'allegato venga compreso.
- Fornisci il gusto sotto forma di dati: Fornisci all'agente token, componenti canonici, stati di riferimento e pattern vietati. Un runtime modulare senza un contratto di design produce comunque un'UI generica.
- Verifica cosa monta effettivamente il profilo: I pacchetti del repository rappresentano funzionalità, non dimostrano che il profilo predefinito le abbia abilitate. Esamina la configurazione composta prima di documentare un'integrazione o farvi affidamento.
Ogni misura correttiva è una decisione relativa a contesto e verifica. È esattamente il lavoro che un livello di design dovrebbe rendere ripetibile, invece di lasciare che ogni progetto debba riscoprirlo.
Che cos'è davvero DeepSeek Harness
DeepSeek Harness (`dsh`) è un harness per agenti con licenza MIT sviluppato da DeepSeek AI. L'anteprima pubblica per sviluppatori include una Web UI locale e un runner headless. Non è un modello né una semplice interfaccia grafica per terminale: è il runtime che assembla modello, strumenti, contesto, autorizzazioni, sessioni e interfaccia utente in un agente.
La sua idea centrale è che «tutto è un plugin». Cordis compone un albero in cui l'adattatore del modello, il registro degli strumenti, il ciclo dell'agente, il file system, la shell, la sandbox, le skill, i subagenti, la persistenza e l'UI possono essere montati, sostituiti o modificati tramite profili e bundle. I profili `web` e `headless` inclusi sono punti di partenza, non prodotti rigidi.
- Web UI locale: `npx @deepseek-ai/dsh web` avvia per impostazione predefinita uno spazio di lavoro nel browser su `127.0.0.1:3080`. Aggiungi un modello, scegli uno spazio di lavoro ed esegui le attività dall'interfaccia di conversazione.
- Modalità headless: Il profilo `headless` esegue una nuova sessione persistente, stampa la risposta finale e termina: è utile per audit, build e controlli di design ripetibili tramite script.
- Runtime componibile: I profili sovrappongono bundle di plugin e patch personalizzate. In questo modo, un team può cambiare provider, strumenti, policy e comportamento dell'UI senza creare un fork del ciclo dell'agente.
- Sviluppatore: DeepSeek AI (progetto ufficiale)
- Stato: anteprima per sviluppatori; sono previste modifiche che interrompono la compatibilità
- Licenza: MIT
- Comando principale: `npx @deepseek-ai/dsh web`
DeepSeek Harness rispetto a DeepSeek TUI e agli altri agenti di design
È facile confondere i nomi. DeepSeek Harness e DeepSeek TUI, attualmente elencato in Open Design, sono progetti distinti con eseguibili e stato di integrazione diversi.
| Strumento | Che cos'è | Utilizzo migliore per il design |
|---|---|---|
| DeepSeek Harness (`dsh`) | Harness ufficiale di DeepSeek AI basato sui plugin, con Web UI locale e profili headless; anteprima per sviluppatori | Team che desiderano comporre runtime, skill, provider, policy e UI attorno a un flusso di lavoro di design |
| DeepSeek TUI (`deepseek` / `codewhale`) | Un agente di programmazione separato per terminale e l'adattatore DeepSeek attualmente supportato da Open Design | Usare DeepSeek all'interno di Open Design oggi |
| OpenCode | Agente open source maturo per terminale, indipendente dal provider | Cambiare modello all'interno di un flusso di lavoro TUI stabile con AGENTS.md e MCP |
| Claude Code | Agente di programmazione maturo disponibile in terminale, IDE, desktop e web | Ragionamento sul frontend, riferimenti ricchi di immagini e integrazioni di design consolidate |
| Open Design | Spazio di lavoro e libreria di design agent-native per agenti di programmazione supportati | Sistemi di design selezionati, skill, artefatti visivi e un flusso di lavoro locale indipendente dal fornitore del modello |
Scegli dsh quando vuoi estendere l'harness stesso. Scegli DeepSeek TUI all'interno di Open Design quando vuoi l'adattatore DeepSeek attualmente supportato e un livello di design pronto all'uso. In futuro potrebbero convergere tramite un nuovo adattatore, ma oggi non sono intercambiabili.
Usa DeepSeek Harness con uno spazio di lavoro di design incentrato sugli agenti
Open Design e DeepSeek Harness occupano livelli adiacenti. dsh compone un runtime per agenti; Open Design seleziona i sistemi di design, le skill e il flusso di lavoro locale per gli artefatti che rendono un agente utile per il lavoro visivo. Open Design non offre ancora un adattatore `dsh` dedicato, quindi oggi il flusso di lavoro più accurato consiste nell'usarli affiancati.
- Installa Open Design e usa i suoi sistemi di design e le sue skill per definire il contratto visivo del progetto.
- Conserva il file `DESIGN.md` risultante, i riferimenti e le istruzioni di progetto nello stesso repository che DeepSeek Harness apre come spazio di lavoro.
- Esegui dsh per esperimenti basati sui plugin e attività di programmazione; riutilizza gli stessi token, regole, asset e criteri di convalida, anziché mantenere un secondo brief di design.
- Quando oggi hai bisogno di DeepSeek direttamente in Open Design, seleziona l'adattatore DeepSeek TUI esistente. Considera un futuro adattatore dsh come un'integrazione separata, non come una funzionalità già disponibile.
Il risultato è un'unica base di codice di tua proprietà e un solo contratto di design portabile tra due strumenti a funzionamento locale. Open Design rimane indipendente da DeepSeek AI; DeepSeek e DeepSeek Harness sono marchi dei rispettivi proprietari.
Domande frequenti su DeepSeek Harness
-
01 Che cos'è DeepSeek Harness?
DeepSeek Harness (`dsh`) è l'harness per agenti open source ufficiale di DeepSeek AI. Combina modelli, strumenti, contesto, sessioni, policy, orchestrazione e UI tramite un albero di plugin Cordis. La release pubblica è attualmente un'anteprima per sviluppatori con licenza MIT.
-
02 Come si installa e si avvia DeepSeek Harness?
Installa una versione supportata di Node.js, quindi esegui `npx @deepseek-ai/dsh web`. Per impostazione predefinita, avvia la Web UI locale su `http://127.0.0.1:3080`. Aggiungi un modello in Settings → Models, scegli uno spazio di lavoro e avvia una sessione.
-
03 DeepSeek Harness è un progetto ufficiale di DeepSeek?
Sì. Il repository è pubblicato nell'organizzazione GitHub `deepseek-ai` e descrive dsh come un harness per agenti sviluppato da DeepSeek AI. È distribuito con licenza MIT ed è esplicitamente contrassegnato come anteprima per sviluppatori.
-
04 DeepSeek Harness può creare un'UI a partire da screenshot?
Solo quando la route del provider selezionato dichiara il supporto per l'input di immagini. In dsh, la route per i completamenti chat di DeepSeek supporta solo testo e l'harness rifiuta gli allegati di immagini prima dell'invio su una route esclusivamente testuale. Per gli screenshot, usa un provider compatibile con le immagini oppure descrivi l'obiettivo tramite codice, DOM, token e specifiche scritte.
-
05 DeepSeek Harness supporta AGENTS.md e le skill?
Sì. Il suo plugin per le istruzioni carica AGENTS.md e i file di progetto compatibili con CLAUDE.md. Il provider di skill del file system individua le skill del progetto in `.dsh/skills` e `.agents/skills`, oltre alle radici configurate dell'utente e dei bundle.
-
06 Qual è la differenza tra DeepSeek Harness e DeepSeek TUI?
Sono strumenti distinti. DeepSeek Harness usa l'eseguibile `dsh` ed è un runtime ufficiale di DeepSeek AI basato sui plugin, con Web UI e modalità headless. DeepSeek TUI usa il dispatcher `deepseek` o `codewhale` ed è l'adattatore DeepSeek separato attualmente supportato da Open Design.
-
07 Open Design supporta DeepSeek Harness?
Non ancora come adattatore ufficiale dedicato. Open Design supporta attualmente l'adattatore DeepSeek TUI separato. Puoi comunque usare i sistemi di design, le skill, i file DESIGN.md e gli artefatti di Open Design insieme a dsh nello stesso repository locale.
-
08 Dove archivia DeepSeek Harness la mia chiave API?
La guida ufficiale ai modelli indica che le chiavi dei provider sono archiviate in `$DSH_HOME/.credentials.yaml`. Le impostazioni conservano solo un riferimento alle credenziali e la Web UI riceve un descrittore oscurato anziché il segreto vero e proprio.
Crea il livello di design attorno al tuo flusso di lavoro DeepSeek.
Usa fin da subito i sistemi di design locali, le skill e il flusso di lavoro per gli artefatti di Open Design e mantieni lo stesso contratto di progetto pronto per qualsiasi runtime per agenti tu scelga in futuro.