Progetta con DeepSeek Harness.
DeepSeek Harness può creare landing page, interfacce di prodotto, dashboard e prototipi frontend perché sa leggere un repository, modificare codice UI reale, eseguire comandi, caricare istruzioni del progetto e mantenere una sessione tra le iterazioni. Ciò che non offre da solo è il gusto visivo: un lavoro di design utile richiede comunque regole del brand, riferimenti, strumenti, autorizzazioni e un ciclo che esegua il rendering e verifichi il risultato.
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.
Il modello ha comunque bisogno di una direzione visiva. Il modo più semplice per fornirla è collegare DeepSeek Harness a Open Design: Open Design offre il design system, le skill frontend, l’anteprima degli artefatti e l’interfaccia di revisione; dsh svolge il lavoro di programmazione. Questa guida illustra il flusso dalla [pagina ufficiale di DeepSeek Harness](https://www.deepseek.com/harness/) e dal [repository del codice sorgente](https://github.com/deepseek-ai/deepseek-harness) fino a un’interfaccia completa.
DeepSeek Harness può occuparsi di design?
DeepSeek Harness può creare landing page, interfacce di prodotto, dashboard e prototipi frontend perché sa leggere un repository, modificare codice UI reale, eseguire comandi, caricare istruzioni del progetto e mantenere una sessione tra le iterazioni. Ciò che non offre da solo è il gusto visivo: un lavoro di design utile richiede comunque regole del brand, riferimenti, strumenti, autorizzazioni e un ciclo che esegua il rendering e verifichi il risultato.
- 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.
Passaggio 1: Installa e configura DeepSeek Harness
Per prima cosa, verifica che DeepSeek Harness funzioni da solo. Installa la release dsh testata e apri la Web UI locale per configurare la chiave API e il modello prima di aprire Open Design. L’anteprima per sviluppatori richiede Node.js `^22.19.0` o `>=24.0.0`.
# Open Design currently tests DeepSeek Harness 0.1.0-rc.6
# Requires Node.js ^22.19.0 or >=24.0.0
npm install -g @deepseek-ai/[email protected]
# Verify the local executable
dsh --version
# Start the local Web UI and configure a provider and model
dsh web
# Open http://127.0.0.1:3080- Apri la Web UI di Harness: Esegui `dsh web`. Normalmente apre `http://127.0.0.1:3080`; se il browser non si apre, copia l’indirizzo mostrato dal terminale e usa esattamente quello.
- Aggiungi la chiave API DeepSeek: Supera l’avviso sull’anteprima e salva o applica la chiave quando richiesto. Se la richiesta non appare, apri Impostazioni → Modelli → DeepSeek → Chiave API. Incolla solo la chiave, senza `DEEPSEEK_API_KEY=...` né virgolette. La modifica ha effetto immediato; non occorre riavviare `dsh web`. Se necessario, creane una su DeepSeek Platform.
- Conferma il modello e chiudi la UI di configurazione: Il provider DeepSeek dovrebbe risultare configurato e i suoi modelli dovrebbero apparire nel selettore. Se compare `MISSING_CREDENTIAL`, riapri la scheda DeepSeek e salva nuovamente la chiave. Dopo che un prompt di prova ha funzionato, premi `Ctrl+C`; `dsh web` non deve restare aperto mentre usi Open Design.
DeepSeek Harness archivia le credenziali dei provider come segreti di sola scrittura: la UI può indicare se una chiave è configurata, ma non può leggerne o mostrarne il valore in chiaro. Open Design riutilizza il dsh installato dall’utente e la sua configurazione dei modelli senza copiare la chiave in Open Design. Per un flusso affidabile, mantieni dsh fissato alla release testata `0.1.0-rc.6`. Consulta la guida ufficiale dei provider per il comportamento originale delle credenziali.
Passaggi 2–5: Collega DeepSeek Harness a Open Design
Quando dsh funziona in locale, il resto avviene in Open Design. L’integrazione con DeepSeek Harness è disponibile in Open Design 0.19.1 e versioni successive.
- 2 · Scarica Open Design 0.19.1 o successivo: Scarica la build desktop attuale dalla pagina di download di Open Design, installala e avvia l’app.
- 3 · Rileva DeepSeek Harness: Apri Impostazioni → Modelli e provider → Local CLI, quindi scegli Esegui nuova scansione. Riavvia Open Design o ripeti la scansione se era già aperto durante l’installazione. La scheda DeepSeek Harness appare quando Open Design trova l’eseguibile `dsh` del passaggio 1.
- 4 · Collega il profilo Open Design: Seleziona la scheda DeepSeek Harness. Se mostra “Configurazione della connessione richiesta”, conferma “Installa e seleziona”. Open Design verifica il proprio componente, chiede a dsh di installarlo nel profilo `open-design`, esegue una nuova scansione e testa la connessione.
- 5 · Avvia un’attività di design: Verifica che la scheda mostri la versione Harness e “Sincronizzato dalla CLI”, quindi fai clic su Test. Al termine del test, apri o crea un progetto, scegli DeepSeek Harness e un modello sincronizzato e invia la richiesta di design.
La connessione è completata. La UI e `od agent setup deepseek-harness --json` usano lo stesso percorso di configurazione locale; ogni esecuzione avvia `dsh --profile open-design --stdio`, mentre Harness conserva l’identità della sessione per i turni successivi.
Create a polished product landing page in this workspace.
Use DESIGN.md, AGENTS.md, and the installed frontend skill as the visual contract.
Reuse the project tokens and components; include desktop and mobile states.
Run the app, inspect the rendered result, fix visible spacing and hierarchy issues,
and leave the final HTML and assets in the project for Open Design to preview.
Il confine è semplice: Harness gestisce dsh, credenziali, modelli e sessioni; Open Design gestisce il profilo di connessione verificato e il workspace di design. Open Design è indipendente da DeepSeek AI, e DeepSeek e DeepSeek Harness sono marchi dei rispettivi proprietari.
Esegui il ciclo di compilazione e revisione UI
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.
Rendi il flusso di lavoro riutilizzabile con plugin e skill
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.
Evita gli errori che rovinano l'output visivo
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.
Cosa offre l’harness al design
DeepSeek Harness (`dsh`) è un harness per agenti con licenza MIT sviluppato da DeepSeek AI. La pagina ufficiale del prodotto presenta il progetto; il repository GitHub contiene il codice sorgente, la cronologia delle release e le guide mantenute. L’anteprima pubblica per sviluppatori include una Web UI locale e profili headless.
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, DeepSeek TUI e Open Design
DeepSeek Harness e DeepSeek TUI sono progetti separati con eseguibili diversi. Open Design ora supporta entrambi come agenti locali, quindi la scelta riguarda il runtime desiderato, non se uno dei due può entrare nell'area di lavoro di progettazione.
| 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; adattatore nativo di Open Design | Utilizzo delle sessioni, dei provider e della composizione dei plug-in Harness all'interno del flusso di lavoro degli artefatti di Open Design |
| DeepSeek TUI (`deepseek` / `codewhale`) | Un agente di codifica terminale separato con il proprio adattatore Open Design | Un flusso di lavoro DeepSeek incentrato sul terminale senza l'architettura del profilo Harness |
| 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 DeepSeek Harness se vuoi la sua Web UI ufficiale, il sistema di profili, il catalogo dei modelli e sessioni Harness ripristinabili. Scegli DeepSeek TUI all’interno di Open Design se preferisci il flusso di lavoro di quell’agente incentrato sul terminale. Restano runtime distinti, anche se Open Design ora può integrare entrambi nello stesso processo di design.
Utilizzo di DeepSeek Harness per la progettazione: domande frequenti
-
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 la CLI testata con `npm install -g @deepseek-ai/[email protected]`, quindi esegui `dsh web`. Supera l’avviso sull’anteprima e salva soltanto la chiave API in Impostazioni → Modelli → DeepSeek → Chiave API. Verifica che il provider e il modello funzionino, arresta la Web UI con `Ctrl+C`, installa Open Design 0.19.1 o successivo, esegui una nuova scansione degli agenti Local CLI, collega la scheda Harness e fai clic su Test.
-
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?
Sì. Open Design rileva l’installazione ufficiale di dsh, installa un componente di profilo verificato di proprietà di Open Design dopo una conferma esplicita, sincronizza il catalogo dei modelli Harness ed esegue DeepSeek Harness come agente locale supportato nativamente. Open Design non installa dsh né riceve i segreti del provider gestiti da Harness.
-
08 Dove archivia DeepSeek Harness la mia chiave API?
Configura la chiave in DeepSeek Harness, non in Open Design. La guida ufficiale dei modelli indica che le chiavi dei provider sono archiviate in `$DSH_HOME/.credentials.yaml` come segreti di sola scrittura: la UI può verificare se una chiave è configurata, ma non può leggerne o mostrarne il valore in chiaro. Open Design non ti chiede di incollare la chiave nell’app né la scrive nella configurazione di Open Design.
Progetta con DeepSeek Harness in Open Design.
Installa il runtime ufficiale dsh, collegalo una volta, quindi utilizza i design system, le skill, i modelli sincronizzati e le anteprime degli artefatti locali di Open Design in un unico flusso di lavoro.