ULTERIORI LETTURE
Ulteriori Letture per DeepSeek Harness
Tutorial, documentazione e procedure dettagliate passo passo per progettare con DeepSeek Harness, come elencato nella guida pubblicata.
DeepSeek Harness 
OpenDesign Progettare con
DeepSeek Harness in
OpenDesign.
Come progettare interfacce con DeepSeek Harness in OpenDesign: profilo console riutilizzabile, skill e scelta del provider, una tabella utenti admin dal brief al file revisionato, e i limiti da conoscere prima di iniziare.
TRE PUNTI DI PARTENZA PER DEEPSEEK HARNESS
Scegli il tuo punto di ingresso a DeepSeek Harness
QUESTA GUIDA · DESIGN UI
Crea un'interfaccia con DeepSeek Harness
Il percorso qui va dal brief e dai riferimenti, attraverso le regole di progettazione, fino a un risultato HTML che puoi revisionare.
Leggi questa guida CONFIGURAZIONEInstalla DeepSeek Harness senza prerequisiti
Non è richiesto Node.js, pnpm o dsh preinstallati. Esegui l'installer da una riga per il tuo sistema operativo: installa DeepSeek Harness…
Vai alla configurazione CONFRONTOScopri in cosa DeepSeek Harness è diverso
In cosa DeepSeek Harness si distingue da DeepSeek TUI (`deepseek` / `codewhale`), OpenCode e Claude Code per le attività di progettazione—e quando un altro flusso di lavoro è la scelta migliore.
Vedi il confrontoIn questa pagina Esempio
Attività di progettazione DeepSeek Harness completa
Dal brief all'interfaccia in DeepSeek Harness
Un'attività di progettazione seguita dal brief e dai vincoli che consegni all'artefatto che ritorna—e i controlli che esegui ancora prima di dichiararla conclusa. L'interfaccia sottostante è illustrativa, creata per questa pagina; non è una esecuzione registrata di DeepSeek Harness.
1Brief di design e vincoli
BriefCrea la pagina utenti per una console di amministrazione: una tabella ricercabile che copre ruolo, team, stato e ultimo accesso, più azioni in blocco e paginazione. Usa la skill console tramite un profilo riutilizzabile. Desktop e telefono.
- Design systemOpenDesign tela color carta con Albert Sans e un singolo accento verde
- BreakpointDesktop a 1440px e mobile a 390px senza scorrimento orizzontale
- InterazioniRicerca, filtri, selezione riga, azioni in blocco e paginazione
- OutputUn singolo file HTML autonomo che utilizza hook stabili
data-od-id
2Chi fa cosa: tu, DeepSeek Harness, OpenDesign
- Voi
Tu scrivi il brief, scegli il design system e stabilisci i criteri di accettazione.
- DeepSeek Harness
DeepSeek Harness pianifica il layout, scrive HTML, CSS e JavaScript, poi rivede su richiesta.
- OpenDesign
OpenDesign fornisce il design system e la skill, esegue il rendering dell'anteprima e conserva ogni versione come file di progetto.
- Revisione
Prima della consegna, controlla la gerarchia visiva, la spaziatura a griglia da 8px, entrambi i breakpoint e ogni interazione.
3Artefatto DeepSeek Harness: tabella di amministrazione a 1440px e 390px
4Revisione prima della consegna
Layout
Griglia e spaziatura
Barra degli strumenti, tabella e paginatore si allineano alla griglia da 8px; larghezze di colonna fisse evitano che le righe saltino.
Gerarchia
Gerarchia visiva
Nome e ruolo in primo piano; l'accento appare solo sul ruolo proprietario.
Responsive
Layout mobile
La tabella si trasforma in un elenco che mostra nome, email e ruolo; i filtri si spostano in un pannello.
Interazione
Controlli di interazione
Cerca, filtra per ruolo, seleziona due righe, esegui un'azione in blocco, poi avanza di pagina.
Adeguatezza
Dove DeepSeek Harness si adatta—e dove no
DeepSeek Harness è adatto quando
- Istruzioni di progetto. Prendi le regole di brand e dei componenti da AGENTS.md o CLAUDE.md.
- Skill riutilizzabili. Metti l'arte frontend e la verifica sotto `.dsh/skills` o `.agents/skills`.
- Scelta del provider. Instrada il lavoro su codice/specifiche a DeepSeek solo testo e gli screenshot a un percorso abilitato alle immagini.
- Profili componibili. Assembla un runtime mirato dagli strumenti, dalle policy e dai plugin UI richiesti dal flusso di lavoro.
Scelga un altro workflow quando
- Hai bisogno di file vettoriali modificabili. L'output è HTML, non un documento di progettazione modificabile; cerca un flusso di lavoro vettoriale separato per il formato di asset di cui hai bisogno.
- Non hai riferimenti né vincoli. Senza un design system o esempi, il risultato tende a un aspetto generico; scrivi il brief prima di generare.
- Non hai la credenziale necessaria a questo agente. Hai bisogno di una chiave API DeepSeek o di un'altra credenziale provider configurata. OpenDesign non fornisce né fa da proxy per le credenziali.
- Il tuo team lavora in DeepSeek o Reasonix. Questi agenti hanno pagine dedicate; la configurazione cambia da agente a agente anche se lo spazio di lavoro di progettazione rimane coerente. Vedi agenti correlati.
Compatibilità
Requisiti di DeepSeek Harness prima di iniziare
Questa pagina tratta DeepSeek Harness quando l'app desktop di OpenDesign è il punto di connessione. Sono stati consultati riferimenti pubblicati al 6 settembre 2026.
Ambito degli strumentiDeepSeek Harness, di DeepSeek AI
DeepSeek Harness (`dsh`) è l'agent harness open source ufficiale di DeepSeek AI. Modelli, strumenti, sessioni, permessi, filesystem, skill, subagenti e UI sono assemblati come plugin Cordis dalla sua interfaccia Web locale e dal runner headless. L'obiettivo qui è progettare interfacce con DeepSeek Harness all'interno di OpenDesign, non gestire l'interfaccia di DeepSeek Harness stessa. Quali agenti può usare OpenDesign è registrato nelle sue note di configurazione.
Account e autenticazioneAPI key DeepSeek o un'altra configurata
Una chiave API DeepSeek, o un'altra credenziale provider già configurata. In OpenDesign, vai su Impostazioni → Modelli & provider → Local CLI e esegui una nuova scansione. Nessuna quota o prezzo è promesso in questa pagina.
Sistema e versioniApp desktop o codice sorgente
Le build desktop sono elencate nella pagina di download. I requisiti di Node.js e pnpm dalla guida rapida del sorgente contano quando si esegue dal sorgente; non si applicano a un'installazione da pacchetto desktop. La versione minima di DeepSeek Harness compatibile qui non è stata verificata.
Verifica della connessioneIl segnale di riuscita
Usa i passaggi di connessione visualizzati dalla tua versione installata, poi assegna a DeepSeek Harness un compito modesto. Controlla che DeepSeek Harness lo abbia eseguito e che l'artefatto possa essere aperto. Il solo download non prova che la connessione funzioni.
Inizia con l’app desktop
Tre passaggi per configurare DeepSeek Harness
Inizia scaricando; completa la configurazione di DeepSeek Harness corrispondente alla tua versione installata; poi verifica un piccolo risultato. Seguire questo percorso non richiede di compilare OpenDesign dal sorgente.
- 1
Scarica l’app desktop OpenDesign
Scegli l'installer creato per la tua macchina, installalo e avvia l'app.
Scarica OpenDesignCHECKPOINTDovresti vedere l'app desktop aperta. Se è già installata, passa al passaggio successivo invece di scaricarla di nuovo. - 2
Prepara la connessione a DeepSeek Harness
Usa le istruzioni di DeepSeek Harness fornite con la versione che hai installato. In OpenDesign, apri Impostazioni → Modelli & provider → Local CLI e scegli esegui nuova scansione.
deepseek-ai/deepseek-harnesscurl -fsSL 'https://open-design.ai/install-dsh.sh?version=1' | shTratto dalle note di configurazione di DeepSeek Harness nella guida pubblicata; verifica il comando corrente con la documentazione del fornitore.
CHECKPOINTVerifica l'agente e l'account che intendevi usare. Se non è disponibile, rivedi prima la compatibilità invece di passare a un compito più grande. - 3
Esegui un singolo piccolo compito con DeepSeek Harness
Mantieni il brief modesto, il che ti permette di giudicare l'intero ciclo, inclusa una revisione.
Brief inizialeCrea una schermata di impostazioni contenente un modulo del profilo e una conferma di salvataggio. Applica le mie regole di progettazione. Verificala a larghezze desktop e mobile.
CHECKPOINTApri il risultato, controlla lo stato di salvataggio e chiedi una modifica specifica. Il file generato inizia la revisione; non è il traguardo finale.
Se OpenDesign verrà eseguito dal sorgente, usa invece la guida rapida tecnica.
Il workflow di design di DeepSeek Harness
Flusso di lavoro di progettazione con DeepSeek Harness: cinque passaggi
Questa procedura segue la tabella utenti di amministrazione dal brief al file revisionato. Ogni passaggio indica il tuo input, il lavoro di DeepSeek Harness, il contributo di OpenDesign e ciò che verifichi.
- 1
Brief di design
Un breve brief in linguaggio semplice — da tre a sei righe. Indica chi usa la schermata, cosa deve realizzare e quali piattaforme contano.
- LeiRedigi il brief. Se hai uno screenshot di riferimento, allegalo.
- DeepSeek HarnessAnalizza il brief e il file di istruzioni del progetto; se un requisito è ambiguo, chiede prima di procedere.
- OpenDesignOspita il progetto e la superficie del prompt, e fornisce la skill corrispondente al tipo di artefatto.
- VerificaAssicurati che il brief specifichi i criteri di accettazione. Stabilirli prima della generazione costa meno che correggerli dopo.
- 2
Vincoli di design
Un design system più alcuni non negoziabili. Questa combinazione è ciò che mantiene l'output in linea con il brand invece che generico.
- LeiScegli il design system, poi indica i breakpoint e i componenti che devono apparire.
- DeepSeek HarnessPrima di scrivere qualsiasi codice, carica nel contesto i token DESIGN.md e le regole di postura del design.
- OpenDesignFornisce la libreria del design system e collega il sistema scelto al template della skill.
- VerificaVerifica che i token corrispondano al tuo brand: un singolo accento, font corretti, raggio corretto.
- 3
Genera l'interfaccia
DeepSeek Harness produce un unico file HTML autonomo — layout, stili, interazioni e hook stabili.
- LeiAttendi, o rispondi a una domanda di chiarimento. Non c'è nulla da configurare.
- DeepSeek HarnessPianifica le sezioni, scrive HTML, CSS e JavaScript, esegue il file e ripara tutto ciò che fallisce.
- OpenDesignMemorizza l'artefatto nella cartella del progetto e lo indicizza in modo che l'anteprima possa trovarlo.
- VerificaAspetta. Giudica il file dopo che è stato renderizzato, non leggendo il sorgente.
- 4
Anteprima
All'interno di OpenDesign, il file viene renderizzato alle larghezze richieste. Questo è il punto in cui il design viene giudicato.
- LeiCambia le larghezze, prova le interazioni e lascia commenti sui singoli elementi.
- DeepSeek HarnessLegge i tuoi commenti sull'anteprima e prepara la revisione successiva.
- OpenDesignRenderizza l'anteprima ed espone i target
data-od-idin modo che commenti e modifiche possano agganciarsi agli elementi. - VerificaControlla gerarchia, contrasto, overflow a 390px, stati di focus e moderazione nell'uso dell'accento.
- 5
Revisiona e verifica
Richiedi modifiche indicando gli elementi nell'anteprima. Ogni revisione arriva come un nuovo file; nulla viene sovrascritto senza traccia.
- LeiTraduci i commenti in richieste e decidi quando il compito è terminato.
- DeepSeek HarnessApplica le modifiche sul posto e riesegue il file.
- OpenDesignMantiene le versioni affiancate; quando hai finito, esporta un'immagine o l'HTML.
- VerificaRicontrolla solo l'area modificata, poi l'intera pagina una volta per ogni breakpoint.
Risorse
Risorse di Design per DeepSeek Harness
Skill Esplori le skill Design system Esplori i sistemi Template Esplora i template Plugin Esplori i plugin
Skill di design
Tipi di artefatto che DeepSeek Harness può generare in OpenDesign, con una skill per tipo.
Design System
Token del brand e componenti che colleghi prima che DeepSeek Harness generi qualsiasi output.
Template
Punti di partenza per presentazioni, landing page e schermate di prodotto.
Plugin di Design per DeepSeek Harness
Plugin di design creati per l'Harness, ciascuno con le proprie note di configurazione.
Limitazioni
Limiti di DeepSeek Harness, controlli manuali e fallback
- AmbitoQuesta pagina riguarda DeepSeek Harness come agente connesso a OpenDesign, non tutte le funzionalità di DeepSeek Harness.
- Limiti di UtilizzoI limiti di utilizzo e il costo dipendono dalla credenziale utilizzata (chiave API DeepSeek o un'altra credenziale del provider configurata). Qui non si fa alcuna affermazione sui quote gratuiti.
- ReteI file di progetto locali non implicano inferenza offline. Controlla le impostazioni del provider del tuo agente e le politiche sui dati prima di condividere input sensibili.
- L'Output È HTMLGli artefatti vengono forniti come file HTML, non come file di progettazione vettoriale.
- Revisione manualeRivedi accessibilità, contenuti reali, aderenza al brand e correttezza delle interazioni nell'anteprima. Qualsiasi autoverifica da parte dell'agente è solo un primo passaggio.
- FallbackSe l'agente non è disponibile o un'attività fallisce, consulta le istruzioni di connessione e autenticazione della versione installata. Conserva l'errore e l'ultimo artefatto funzionante prima di modificare la configurazione.
FAQ
Domande Comuni su DeepSeek Harness e OpenDesign
Cos'è DeepSeek Harness?
DeepSeek Harness (`dsh`) è l'agent harness open-source ufficiale di DeepSeek AI. Combina modelli, strumenti, contesto, sessioni, policy, orchestrazione e UI attraverso un albero di plugin Cordis. La release pubblica è attualmente una developer preview sotto licenza MIT.
Come Installo e Avvio DeepSeek Harness?
Esegua l'installer a una riga per il suo sistema operativo — macOS/Linux: `curl -fsSL 'https://open-design.ai/install-dsh.sh?version=1' | sh` (gli one-liner per PowerShell e CMD sono nella sezione di configurazione sopra). Non è richiesto alcun Node.js, pnpm o dsh preinstallato, e non è necessario `sudo`. L'installer apre `dsh web` alla fine; proceda oltre l'avviso di preview e salvi solo la chiave API stessa sotto Settings → Models → DeepSeek → API Key. Confermi che il provider e il modello funzionino, interrompa la Web UI con `Ctrl+C`, installi OpenDesign 0.19.1 o versione successiva, ripeta la scansione degli agenti Local CLI, collegi la card della Harness e clicchi su Test.
L'Installer Sovrascriverà il Mio Node.js Esistente?
No. Quando gli ambienti sono assenti, installa una toolchain isolata di Node.js e DeepSeek Harness all'interno della sua directory utente; non modifica il Node.js di sistema né sostituisce le versioni utilizzate da altri progetti. Se ha già Node.js, pnpm e dsh compatibili, l'installer li rileva e li riutilizza invece di scaricarli di nuovo.
Il Terminale Non Trova Dsh Dopo l'Installazione — Cosa Fare?
Aprite prima una nuova finestra del terminale. OpenDesign esegue automaticamente la scansione delle directory degli strumenti a livello utente più comuni, quindi normalmente non è necessario modificare il PATH; se OpenDesign è già aperto, andate alla pagina Local Agent e cliccate su Rescan. Se il rilevamento continua a fallire, verificate che la schermata finale del programma di installazione abbia segnalato DeepSeek Harness come pronto, quindi condividete tale output insieme al messaggio di test di OpenDesign quando richiedete assistenza.
DeepSeek Harness È un Progetto Ufficiale DeepSeek?
Sì. Il repository è pubblicato sotto l'organizzazione GitHub `deepseek-ai` e descrive dsh come un harness per agenti sviluppato da DeepSeek AI. È concesso in licenza MIT ed è esplicitamente contrassegnato come developer preview.
Che cosa apporta l’harness al design
DeepSeek Harness (`dsh`) è un agent harness 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 distintiva è “tutto è un plugin”. Cordis compone un albero in cui l'adattatore del modello, il registro degli strumenti, il ciclo dell'agente, il filesystem, la shell, la sandbox, le skill, i subagenti, la persistenza e la UI possono essere montati, sostituiti o modificati con patch tramite profili e bundle. I profili `web` e `headless` forniti sono punti di partenza, non prodotti fissi.
Web UI locale: `npx @deepseek-ai/dsh web` avvia uno spazio di lavoro nel browser su `127.0.0.1:3080` per impostazione predefinita. Aggiungi un modello, scegli uno spazio di lavoro ed esegui le attività dall'interfaccia conversazionale.
Modalità headless: il profilo `headless` esegue una nuova sessione persistita, stampa la risposta finale ed esce — utile per audit scriptati, build e verifiche di design ripetibili.
Runtime componibile: i profili impilano bundle di plugin e le tue patch. Ciò consente a un team di cambiare provider, strumenti, policy e comportamento della UI senza eseguire il fork di un ciclo dell'agente.
Stato: anteprima per sviluppatori; sono previsti cambiamenti che rompono la compatibilità
Sviluppatore: DeepSeek AI (progetto ufficiale)
Licenza: MIT
Comando principale: `npx @deepseek-ai/dsh web`
La sua idea distintiva è “tutto è un plugin”. Cordis compone un albero in cui l'adattatore del modello, il registro degli strumenti, il ciclo dell'agente, il filesystem, la shell, la sandbox, le skill, i subagenti, la persistenza e la UI possono essere montati, sostituiti o modificati con patch tramite profili e bundle. I profili `web` e `headless` forniti sono punti di partenza, non prodotti fissi.
Web UI locale: `npx @deepseek-ai/dsh web` avvia uno spazio di lavoro nel browser su `127.0.0.1:3080` per impostazione predefinita. Aggiungi un modello, scegli uno spazio di lavoro ed esegui le attività dall'interfaccia conversazionale.
Modalità headless: il profilo `headless` esegue una nuova sessione persistita, stampa la risposta finale ed esce — utile per audit scriptati, build e verifiche di design ripetibili.
Runtime componibile: i profili impilano bundle di plugin e le tue patch. Ciò consente a un team di cambiare provider, strumenti, policy e comportamento della UI senza eseguire il fork di un ciclo dell'agente.
Stato: anteprima per sviluppatori; sono previsti cambiamenti che rompono la compatibilità
Sviluppatore: DeepSeek AI (progetto ufficiale)
Licenza: MIT
Comando principale: `npx @deepseek-ai/dsh web`
DeepSeek Harness può fare 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 di progetto e mantenere una sessione tra un'iterazione e l'altra. Ciò che non fornisce da solo è il gusto visivo: un lavoro di design utile ha comunque bisogno di regole di brand, riferimenti, strumenti, permessi e un ciclo che renderizza e verifica il risultato.
Contesto di design persistente: il caricatore di istruzioni predefinito legge `AGENTS.md` e `CLAUDE.md` dalla gerarchia del progetto. Metti token, regole dei componenti, breakpoint responsive e criteri di revisione dove ogni esecuzione può vederli.
Skill riutilizzabili: le skill locali possono risiedere in `.dsh/skills` o `.agents/skills`. Una skill frontend può impacchettare il brief esatto, la checklist, gli esempi e gli script che impediscono a ogni attività UI di partire da zero.
Scelta del provider in base al compito: la Web UI può configurare DeepSeek, provider in catalogo come Anthropic o OpenAI e endpoint personalizzati compatibili con OpenAI. Usa una route dichiarata abilitata alle immagini per l'input di screenshot; usa la route nativa DeepSeek per testo, codice, DOM e lavoro guidato da specifiche.
L'harness porta gli input; il gusto viene comunque da un design system, una skill mirata e riferimenti concreti.
Il limite importante è lo stesso per ogni agente: la componibilità non è il gusto. Senza vincoli deliberati di tipografia, spaziatura, componenti e interazione, il runtime automatizzerà fedelmente un risultato generico. Il ruolo di OpenDesign è fornire e organizzare quegli input di design.
Contesto di design persistente: il caricatore di istruzioni predefinito legge `AGENTS.md` e `CLAUDE.md` dalla gerarchia del progetto. Metti token, regole dei componenti, breakpoint responsive e criteri di revisione dove ogni esecuzione può vederli.
Skill riutilizzabili: le skill locali possono risiedere in `.dsh/skills` o `.agents/skills`. Una skill frontend può impacchettare il brief esatto, la checklist, gli esempi e gli script che impediscono a ogni attività UI di partire da zero.
Scelta del provider in base al compito: la Web UI può configurare DeepSeek, provider in catalogo come Anthropic o OpenAI e endpoint personalizzati compatibili con OpenAI. Usa una route dichiarata abilitata alle immagini per l'input di screenshot; usa la route nativa DeepSeek per testo, codice, DOM e lavoro guidato da specifiche.
L'harness porta gli input; il gusto viene comunque da un design system, una skill mirata e riferimenti concreti.
Il limite importante è lo stesso per ogni agente: la componibilità non è il gusto. Senza vincoli deliberati di tipografia, spaziatura, componenti e interazione, il runtime automatizzerà fedelmente un risultato generico. Il ruolo di OpenDesign è fornire e organizzare quegli input di design.
Passaggio 1: installa e configura DeepSeek Harness
Non è necessario che Node.js, pnpm o dsh siano preinstallati. Esegui l'installer da una riga per il tuo sistema operativo: installa la toolchain di DeepSeek Harness verificata da OpenDesign, poi apre la pagina di configurazione della chiave API. L'installer non tocca mai il Node.js di sistema e non richiede `sudo` né privilegi di amministratore; un ambiente compatibile esistente viene riutilizzato automaticamente.
macOS / Linux — apri Terminale, incolla questa riga e premi Invio (Apple Silicon, Intel Mac e le principali distribuzioni Linux x64/arm64 sono supportate; Alpine Linux non è ancora supportato):
Windows PowerShell — apri PowerShell, incolla questa riga e premi Invio:
Windows CMD — apri Prompt dei comandi, incolla questa riga e premi Invio:
Verifica la presenza di versioni compatibili di Node.js, pnpm e DeepSeek Harness e le riutilizza quando presenti — nulla viene scaricato due volte.
Quando gli ambienti mancano, installa una toolchain isolata di Node.js e DeepSeek Harness all'interno della tua directory utente.
Fissa la release verificata da OpenDesign, così gli aggiornamenti automatici non possono compromettere la compatibilità.
Verifica lo SHA-256 del download di Node.js e interrompe l'installazione in caso di mancata corrispondenza.
Crea una voce `dsh` che OpenDesign può individuare, senza sovrascrivere il tuo Node.js globale.
Comunica solo con l'endpoint di installazione di OpenDesign, nodejs.org e il registro npm; non carica file di progetto né chiavi API.
Apri la Web UI di Harness: l'installer esegue `dsh web` per te quando termina. Normalmente apre `http://127.0.0.1:3080`; se il browser non si apre, copia l'indirizzo stampato dal terminale e usa esattamente quell'indirizzo. Ogni volta che devi riconfigurare in seguito, esegui di nuovo `dsh web`.
Aggiungi la chiave API di DeepSeek: supera l'avviso di anteprima, poi salva o applica la chiave quando richiesto. Se il prompt non compare, apri Impostazioni → Modelli → DeepSeek → Chiave API. Incolla solo la chiave — non `DEEPSEEK_API_KEY=...` e senza virgolette. La modifica ha effetto immediato; non devi riavviare `dsh web`. Creane una sulla DeepSeek Platform se necessario.
Conferma il modello, poi chiudi l'interfaccia di configurazione: il provider DeepSeek dovrebbe risultare configurato e i suoi modelli dovrebbero comparire nel selettore. Se vedi `MISSING_CREDENTIAL`, riapri la scheda DeepSeek e salva di nuovo la chiave. Dopo che un prompt di prova funziona, premi `Ctrl+C`; `dsh web` non deve restare aperto mentre usi OpenDesign.
DeepSeek Harness memorizza le credenziali del provider come segreti di sola scrittura: l'interfaccia può indicare se una chiave è configurata, ma non può leggere o mostrare la chiave in chiaro. OpenDesign riutilizza questo dsh installato dall'utente e la sua configurazione dei modelli senza copiare la chiave in OpenDesign. L'installer fissa già la release verificata da OpenDesign, quindi non è necessaria alcuna gestione manuale della versione. Consulta la guida ufficiale dei provider per il comportamento delle credenziali a monte.
Usa la sezione di configurazione corrente per i comandi e i dettagli specifici della versione, che potrebbero cambiare.
Esempio di comando storico dalla guida precedente; verifica la sintassi corrente nella documentazione del fornitore collegata.
Esempio di comando storico dalla guida precedente; verifica la sintassi corrente nella documentazione del fornitore collegata.
macOS / Linux — apri Terminale, incolla questa riga e premi Invio (Apple Silicon, Intel Mac e le principali distribuzioni Linux x64/arm64 sono supportate; Alpine Linux non è ancora supportato):
Windows PowerShell — apri PowerShell, incolla questa riga e premi Invio:
Windows CMD — apri Prompt dei comandi, incolla questa riga e premi Invio:
Verifica la presenza di versioni compatibili di Node.js, pnpm e DeepSeek Harness e le riutilizza quando presenti — nulla viene scaricato due volte.
Quando gli ambienti mancano, installa una toolchain isolata di Node.js e DeepSeek Harness all'interno della tua directory utente.
Fissa la release verificata da OpenDesign, così gli aggiornamenti automatici non possono compromettere la compatibilità.
Verifica lo SHA-256 del download di Node.js e interrompe l'installazione in caso di mancata corrispondenza.
Crea una voce `dsh` che OpenDesign può individuare, senza sovrascrivere il tuo Node.js globale.
Comunica solo con l'endpoint di installazione di OpenDesign, nodejs.org e il registro npm; non carica file di progetto né chiavi API.
Apri la Web UI di Harness: l'installer esegue `dsh web` per te quando termina. Normalmente apre `http://127.0.0.1:3080`; se il browser non si apre, copia l'indirizzo stampato dal terminale e usa esattamente quell'indirizzo. Ogni volta che devi riconfigurare in seguito, esegui di nuovo `dsh web`.
Aggiungi la chiave API di DeepSeek: supera l'avviso di anteprima, poi salva o applica la chiave quando richiesto. Se il prompt non compare, apri Impostazioni → Modelli → DeepSeek → Chiave API. Incolla solo la chiave — non `DEEPSEEK_API_KEY=...` e senza virgolette. La modifica ha effetto immediato; non devi riavviare `dsh web`. Creane una sulla DeepSeek Platform se necessario.
Conferma il modello, poi chiudi l'interfaccia di configurazione: il provider DeepSeek dovrebbe risultare configurato e i suoi modelli dovrebbero comparire nel selettore. Se vedi `MISSING_CREDENTIAL`, riapri la scheda DeepSeek e salva di nuovo la chiave. Dopo che un prompt di prova funziona, premi `Ctrl+C`; `dsh web` non deve restare aperto mentre usi OpenDesign.
DeepSeek Harness memorizza le credenziali del provider come segreti di sola scrittura: l'interfaccia può indicare se una chiave è configurata, ma non può leggere o mostrare la chiave in chiaro. OpenDesign riutilizza questo dsh installato dall'utente e la sua configurazione dei modelli senza copiare la chiave in OpenDesign. L'installer fissa già la release verificata da OpenDesign, quindi non è necessaria alcuna gestione manuale della versione. Consulta la guida ufficiale dei provider per il comportamento delle credenziali a monte.
Usa la sezione di configurazione corrente per i comandi e i dettagli specifici della versione, che potrebbero cambiare.
& ([scriptblock]::Create((irm 'https://open-design.ai/install-dsh.ps1?version=1')))Esempio di comando storico dalla guida precedente; verifica la sintassi corrente nella documentazione del fornitore collegata.
curl -fsSL "https://open-design.ai/install-dsh.cmd?version=1" -o "%TEMP%\install-dsh.cmd" && call "%TEMP%\install-dsh.cmd"Esempio di comando storico dalla guida precedente; verifica la sintassi corrente nella documentazione del fornitore collegata.
Esegui il ciclo di build e revisione dell'interfaccia
Per il lavoro sull'interfaccia, rendi espliciti il brief e il ciclo di accettazione. Il percorso DeepSeek predefinito è solo testo, quindi la base più affidabile è un flusso di lavoro code-and-spec; allega screenshot solo dopo aver selezionato un percorso del modello che dichiara input di immagini.
Avvia dsh dal repository, scegli quella directory come workspace e seleziona il percorso del modello per questa attività.
Inserisci il contratto del brand in `AGENTS.md`, `CLAUDE.md` o in un `DESIGN.md` referenziato: token, primitive, spaziatura, tipografia, breakpoint, stati e pattern vietati.
Carica una skill frontend mirata da `.dsh/skills` o `.agents/skills`; tieni esempi e script di validazione accanto alle istruzioni.
Chiedi all'agente di riutilizzare i componenti esistenti, eseguire l'applicazione e validare gli stati responsive con i test del progetto o gli strumenti del browser.
Esamina il risultato visibile, registra delta specifici e itera con commit piccoli. Annulla i passaggi deboli invece di accumulare correzioni su una base scadente.
Un prompt utile nomina sia i vincoli visivi sia le prove di verifica:
Se uno screenshot è essenziale, configura prima un provider in grado di gestire immagini. DeepSeek Harness rifiuta un'immagine prima dell'invio quando il percorso selezionato non dichiara il supporto per le immagini — una protezione utile contro l'eliminazione silenziosa del riferimento.
Esempio di comando storico dalla guida precedente; verifica la sintassi corrente nella documentazione del fornitore collegata.
Avvia dsh dal repository, scegli quella directory come workspace e seleziona il percorso del modello per questa attività.
Inserisci il contratto del brand in `AGENTS.md`, `CLAUDE.md` o in un `DESIGN.md` referenziato: token, primitive, spaziatura, tipografia, breakpoint, stati e pattern vietati.
Carica una skill frontend mirata da `.dsh/skills` o `.agents/skills`; tieni esempi e script di validazione accanto alle istruzioni.
Chiedi all'agente di riutilizzare i componenti esistenti, eseguire l'applicazione e validare gli stati responsive con i test del progetto o gli strumenti del browser.
Esamina il risultato visibile, registra delta specifici e itera con commit piccoli. Annulla i passaggi deboli invece di accumulare correzioni su una base scadente.
Un prompt utile nomina sia i vincoli visivi sia le prove di verifica:
Se uno screenshot è essenziale, configura prima un provider in grado di gestire immagini. DeepSeek Harness rifiuta un'immagine prima dell'invio quando il percorso selezionato non dichiara il supporto per le immagini — una protezione utile contro l'eliminazione silenziosa del riferimento.
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.Esempio di comando storico dalla guida precedente; verifica la sintassi corrente nella documentazione del fornitore collegata.
Rendi riutilizzabile il flusso di lavoro con plugin e skill
DeepSeek Harness si differenzia maggiormente sotto la superficie della chat. Il suo albero di plugin consente ai team di rendere il flusso di lavoro di design parte del runtime anziché un prompt incollato in ogni sessione.
AGENTS.md e CLAUDE.md: il plugin di istruzioni carica il file globale utente e la gerarchia del progetto, poi rileva i file di istruzioni annidati pertinenti dopo le operazioni su file first-party. Usalo per regole di design durevoli, non per richieste una tantum.
Skill del filesystem: il registro delle skill individua le radici di progetto e utente, classifica i duplicati ed espone uno strumento `skill` rivolto al modello. Questa è una sede naturale per artigianato frontend, accessibilità, QA responsive e procedure di design system.
Profili e bundle: un profilo impila bundle di plugin ordinati più patch utente. I team possono mantenere una composizione incentrata sul design con il provider, gli strumenti, i criteri di autorizzazione e le fonti delle skill di cui hanno effettivamente bisogno.
MCP e capacità esterne: l'albero dei sorgenti include capacità client MCP, ma la configurazione rivolta all'utente è ancora orientata agli sviluppatori. Tratta le integrazioni come lavoro su plugin versionato durante l'anteprima, non come un flusso stabile con casella di controllo.
Prima di costruire un flusso di lavoro interno di lunga durata, ispeziona l'albero effettivo con `dsh --profile web --dump-config`. Quell'output mostra ciò che è effettivamente montato e patchabile; è più affidabile che presumere che ogni pacchetto nel repository sia attivo nel profilo distribuito.
AGENTS.md e CLAUDE.md: il plugin di istruzioni carica il file globale utente e la gerarchia del progetto, poi rileva i file di istruzioni annidati pertinenti dopo le operazioni su file first-party. Usalo per regole di design durevoli, non per richieste una tantum.
Skill del filesystem: il registro delle skill individua le radici di progetto e utente, classifica i duplicati ed espone uno strumento `skill` rivolto al modello. Questa è una sede naturale per artigianato frontend, accessibilità, QA responsive e procedure di design system.
Profili e bundle: un profilo impila bundle di plugin ordinati più patch utente. I team possono mantenere una composizione incentrata sul design con il provider, gli strumenti, i criteri di autorizzazione e le fonti delle skill di cui hanno effettivamente bisogno.
MCP e capacità esterne: l'albero dei sorgenti include capacità client MCP, ma la configurazione rivolta all'utente è ancora orientata agli sviluppatori. Tratta le integrazioni come lavoro su plugin versionato durante l'anteprima, non come un flusso stabile con casella di controllo.
Prima di costruire un flusso di lavoro interno di lunga durata, ispeziona l'albero effettivo con `dsh --profile web --dump-config`. Quell'output mostra ciò che è effettivamente montato e patchabile; è più affidabile che presumere che ogni pacchetto nel repository sia attivo nel profilo distribuito.
DeepSeek Harness, DeepSeek TUI e OpenDesign
DeepSeek Harness e DeepSeek TUI sono progetti separati con eseguibili diversi. OpenDesign ora supporta entrambi come agenti locali, quindi la scelta riguarda quale runtime vuoi — non se l'uno o l'altro può entrare nello spazio di lavoro di design.
DeepSeek Harness (`dsh`) — Harness ufficiale DeepSeek AI basato sui plugin con UI Web locale e profili headless; adattatore first-party OpenDesign — Usare sessioni, provider e composizione di plugin di Harness all'interno del flusso di lavoro degli artefatti di OpenDesign
DeepSeek TUI (`deepseek` / `codewhale`) — Un agente di coding da terminale separato con il proprio adattatore OpenDesign — Un flusso di lavoro DeepSeek terminal-first senza l'architettura dei profili di Harness
OpenCode — Agente da terminale open-source maturo e agnostico rispetto ai provider — Cambiare modello all'interno di un flusso di lavoro TUI stabile con AGENTS.md e MCP
Claude Code — Agente di coding maturo su terminale, IDE, desktop e superfici web — Ragionamento frontend, riferimenti ricchi di immagini e integrazioni di design consolidate
OpenDesign — Spazio di lavoro di design nativo per agenti e libreria attorno agli agenti di coding supportati — Design system curati, skill, artefatti visivi e un flusso di lavoro locale indipendente da un singolo fornitore di modelli
Scegli DeepSeek Harness quando vuoi la sua UI Web ufficiale, il sistema di profili, il catalogo modelli e le sessioni Harness riprendibili. Scegli DeepSeek TUI all'interno di OpenDesign quando preferisci il flusso di lavoro terminal-first di quell'agente. Restano runtime distinti anche se OpenDesign ora può avvolgere l'uno o l'altro nello stesso processo di design.
Strumento — Cos'è — Miglior utilizzo nel design
DeepSeek Harness (`dsh`) — Harness ufficiale DeepSeek AI basato sui plugin con UI Web locale e profili headless; adattatore first-party OpenDesign — Usare sessioni, provider e composizione di plugin di Harness all'interno del flusso di lavoro degli artefatti di OpenDesign
DeepSeek TUI (`deepseek` / `codewhale`) — Un agente di coding da terminale separato con il proprio adattatore OpenDesign — Un flusso di lavoro DeepSeek terminal-first senza l'architettura dei profili di Harness
OpenCode — Agente da terminale open-source maturo e agnostico rispetto ai provider — Cambiare modello all'interno di un flusso di lavoro TUI stabile con AGENTS.md e MCP
Claude Code — Agente di coding maturo su terminale, IDE, desktop e superfici web — Ragionamento frontend, riferimenti ricchi di immagini e integrazioni di design consolidate
OpenDesign — Spazio di lavoro di design nativo per agenti e libreria attorno agli agenti di coding supportati — Design system curati, skill, artefatti visivi e un flusso di lavoro locale indipendente da un singolo fornitore di modelli
Scegli DeepSeek Harness quando vuoi la sua UI Web ufficiale, il sistema di profili, il catalogo modelli e le sessioni Harness riprendibili. Scegli DeepSeek TUI all'interno di OpenDesign quando preferisci il flusso di lavoro terminal-first di quell'agente. Restano runtime distinti anche se OpenDesign ora può avvolgere l'uno o l'altro nello stesso processo di design.
Strumento — Cos'è — Miglior utilizzo nel design
Evita i fallimenti che rovinano l'output visivo
Gli errori più grandi derivano dal trattare un'anteprima come un prodotto stabile, dal trattare una route solo testo come un modello di visione, o dal trattare un harness flessibile come una fonte di gusto visivo.
Fissa prima di personalizzare: Le modifiche che rompono la compatibilità sono una politica esplicita dell'anteprima. Fissa la versione npm e mantieni le patch del profilo abbastanza piccole da poter essere riviste dopo un aggiornamento.
Controlla le modalità del modello selezionato: La route nativa chat-completions di DeepSeek è solo testo. Per screenshot-to-code, seleziona e dichiara una route provider in grado di gestire immagini invece di dare per scontato che l'allegato venga compreso.
Fornisci il gusto come dati: Dai all'agente token, componenti canonici, stati di riferimento e pattern proibiti. Un runtime modulare senza un contratto di design produce comunque UI generiche.
Verifica cosa monta effettivamente il profilo: I pacchetti del repository sono capacità, non prova che il profilo predefinito li abbia abilitati. Ispeziona la configurazione composta prima di documentare un'integrazione o di farvi affidamento.
Ogni mitigazione è una decisione di contesto e verifica. È esattamente il lavoro che un livello di design dovrebbe rendere ripetibile invece di lasciare che ogni progetto lo riscopra da zero.
Fissa prima di personalizzare: Le modifiche che rompono la compatibilità sono una politica esplicita dell'anteprima. Fissa la versione npm e mantieni le patch del profilo abbastanza piccole da poter essere riviste dopo un aggiornamento.
Controlla le modalità del modello selezionato: La route nativa chat-completions di DeepSeek è solo testo. Per screenshot-to-code, seleziona e dichiara una route provider in grado di gestire immagini invece di dare per scontato che l'allegato venga compreso.
Fornisci il gusto come dati: Dai all'agente token, componenti canonici, stati di riferimento e pattern proibiti. Un runtime modulare senza un contratto di design produce comunque UI generiche.
Verifica cosa monta effettivamente il profilo: I pacchetti del repository sono capacità, non prova che il profilo predefinito li abbia abilitati. Ispeziona la configurazione composta prima di documentare un'integrazione o di farvi affidamento.
Ogni mitigazione è una decisione di contesto e verifica. È esattamente il lavoro che un livello di design dovrebbe rendere ripetibile invece di lasciare che ogni progetto lo riscopra da zero.
Passo 2: Scarica OpenDesign 0.19.1 o versione successiva
Una volta che dsh funziona localmente, il resto avviene in OpenDesign. L'integrazione di DeepSeek Harness è disponibile in OpenDesign 0.19.1 e versioni successive.
Ottieni la build desktop corrente dalla pagina di download di OpenDesign, installala e avvia l'app.
Ottieni la build desktop corrente dalla pagina di download di OpenDesign, installala e avvia l'app.
Passaggio 3: Rileva DeepSeek Harness
Apri Impostazioni → Modelli e provider → CLI locale, poi scegli Riscansiona. Riavvia OpenDesign o riscansiona di nuovo se era già aperto durante l'installazione. La scheda DeepSeek Harness appare quando OpenDesign trova l'eseguibile `dsh` dal passaggio 1.
Passaggio 4: Connetti il profilo OpenDesign
Seleziona la scheda DeepSeek Harness. Se dice “Configurazione della connessione richiesta”, conferma “Installa e seleziona”. OpenDesign verifica il proprio componente, chiede a dsh di installarlo nel profilo `open-design`, riscansiona e verifica la connessione.
Questo è il punto di controllo: versione di Harness rilevata, “Sincronizzato da CLI” e un'azione Test funzionante.
Questo completa la connessione. L'interfaccia utente e `od agent setup deepseek-harness --json` usano lo stesso percorso di configurazione locale; ogni esecuzione avvia `dsh --profile open-design --stdio`, mentre Harness mantiene l'identità della sessione per i turni successivi.
Questo è il punto di controllo: versione di Harness rilevata, “Sincronizzato da CLI” e un'azione Test funzionante.
Questo completa la connessione. L'interfaccia utente e `od agent setup deepseek-harness --json` usano lo stesso percorso di configurazione locale; ogni esecuzione avvia `dsh --profile open-design --stdio`, mentre Harness mantiene l'identità della sessione per i turni successivi.
Passaggio 5: Avvia un'attività di design
Conferma che la scheda mostri la versione di Harness e “Sincronizzato dalla CLI”, poi fai clic su Test. Dopo che il test è superato, apri o crea un progetto, scegli DeepSeek Harness e un modello sincronizzato, e invia la tua richiesta di design.
DeepSeek Harness modifica lo spazio di lavoro reale; OpenDesign mantiene insieme la richiesta, l'avanzamento, l'anteprima e l'artefatto finale.
Il confine rimane semplice: Harness possiede dsh, le credenziali, i modelli e le sessioni; OpenDesign possiede il profilo di connessione verificato e lo spazio di lavoro di design. OpenDesign è indipendente da DeepSeek AI, e DeepSeek e DeepSeek Harness sono marchi dei rispettivi proprietari.
Esempio di comando storico della guida precedente; verifica la sintassi attuale nella documentazione del fornitore collegata.
DeepSeek Harness modifica lo spazio di lavoro reale; OpenDesign mantiene insieme la richiesta, l'avanzamento, l'anteprima e l'artefatto finale.
Il confine rimane semplice: Harness possiede dsh, le credenziali, i modelli e le sessioni; OpenDesign possiede il profilo di connessione verificato e lo spazio di lavoro di design. OpenDesign è indipendente da DeepSeek AI, e DeepSeek e DeepSeek Harness sono marchi dei rispettivi proprietari.
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 OpenDesign to preview.Esempio di comando storico della guida precedente; verifica la sintassi attuale nella documentazione del fornitore collegata.
DeepSeek Harness è ufficiale?
Sì. È sviluppato da DeepSeek AI e pubblicato con licenza MIT.