Crie designs com DeepSeek Harness.
O DeepSeek Harness pode criar landing pages, interfaces de produto, dashboards e protótipos frontend porque consegue ler um repositório, editar código real de UI, executar comandos, carregar instruções do projeto e manter uma sessão entre iterações. O que ele não oferece por conta própria é bom gosto visual: um trabalho de design útil ainda exige regras de marca, referências, ferramentas, permissões e um ciclo que renderize e verifique o resultado.
Para trabalhos de interface, deixe explícitos o briefing e o loop de aceite. A rota padrão da DeepSeek aceita somente texto, então a base mais confiável é um fluxo orientado por código e especificações; anexe screenshots somente depois de selecionar uma rota de modelo que declare suporte a entrada de imagens.
O modelo ainda precisa de direção visual. A forma mais simples de fornecê-la é conectar o DeepSeek Harness ao Open Design: o Open Design oferece o design system, skills de frontend, prévia dos artefatos e uma interface de revisão; o dsh realiza o trabalho de programação. Este guia percorre esse fluxo desde a [página oficial do DeepSeek Harness](https://www.deepseek.com/harness/) e o [repositório de código-fonte](https://github.com/deepseek-ai/deepseek-harness) até uma interface concluída.
O DeepSeek Harness consegue fazer design?
O DeepSeek Harness pode criar landing pages, interfaces de produto, dashboards e protótipos frontend porque consegue ler um repositório, editar código real de UI, executar comandos, carregar instruções do projeto e manter uma sessão entre iterações. O que ele não oferece por conta própria é bom gosto visual: um trabalho de design útil ainda exige regras de marca, referências, ferramentas, permissões e um ciclo que renderize e verifique o resultado.
- Contexto de design persistente: O carregador de instruções padrão lê `AGENTS.md` e `CLAUDE.md` na hierarquia do projeto. Coloque tokens, regras de componentes, breakpoints responsivos e critérios de revisão onde todas as execuções possam acessá-los.
- Skills reutilizáveis: As skills locais podem ficar em `.dsh/skills` ou `.agents/skills`. Uma skill de frontend pode reunir o briefing, o checklist, os exemplos e os scripts exatos que evitam que cada tarefa de UI comece do zero.
- Escolha de provedor por tarefa: A Web UI pode configurar a DeepSeek, provedores do catálogo como Anthropic ou OpenAI e endpoints personalizados compatíveis com OpenAI. Use uma rota declarada como compatível com imagens para inserir screenshots; use a rota nativa da DeepSeek para trabalhos orientados por texto, código, DOM e especificações.
O limite importante é o mesmo para todos os agentes: modularidade não é bom gosto. Sem restrições deliberadas de tipografia, espaçamento, componentes e interação, o ambiente de execução automatizará fielmente um resultado genérico. O papel do Open Design é fornecer e organizar esses insumos de design.
Etapa 1: Instale e configure o DeepSeek Harness
Primeiro, confirme que o DeepSeek Harness funciona sozinho. Instale a versão testada do dsh e abra sua Web UI local para configurar a chave de API e o modelo antes de abrir o Open Design. A versão prévia para desenvolvedores requer Node.js `^22.19.0` ou `>=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- Abra a Web UI do Harness: Execute `dsh web`. Normalmente, ele abre `http://127.0.0.1:3080`; se o navegador não abrir, copie o endereço exibido no terminal e use exatamente esse endereço.
- Adicione a chave de API DeepSeek: Avance após o aviso de versão prévia e salve ou aplique a chave quando solicitado. Se a solicitação não aparecer, abra Configurações → Modelos → DeepSeek → Chave de API. Cole somente a chave, sem `DEEPSEEK_API_KEY=...` nem aspas. A mudança entra em vigor imediatamente; não é necessário reiniciar `dsh web`. Se necessário, crie uma na DeepSeek Platform.
- Confirme o modelo e feche a UI de configuração: O provedor DeepSeek deve aparecer como configurado, e seus modelos devem ser exibidos no seletor. Se você vir `MISSING_CREDENTIAL`, abra novamente o cartão DeepSeek e salve a chave outra vez. Quando uma mensagem de teste funcionar, pressione `Ctrl+C`; `dsh web` não precisa permanecer aberto enquanto você usa o Open Design.
O DeepSeek Harness armazena credenciais de provedores como segredos somente para gravação: a UI pode informar se uma chave está configurada, mas não pode ler nem exibir a chave em texto simples. O Open Design reutiliza esse dsh instalado pelo usuário e sua configuração de modelos sem copiar a chave para o Open Design. Para um fluxo de trabalho confiável, mantenha o dsh fixado na versão testada `0.1.0-rc.6`. Consulte o guia oficial de provedores para entender o comportamento original das credenciais.
Etapas 2–5: Conecte o DeepSeek Harness ao Open Design
Quando o dsh estiver funcionando localmente, o restante acontece no Open Design. A integração com o DeepSeek Harness está disponível no Open Design 0.19.1 e versões posteriores.
- 2 · Baixe o Open Design 0.19.1 ou posterior: Obtenha a versão desktop atual na página de download do Open Design, instale-a e abra o aplicativo.
- 3 · Detecte o DeepSeek Harness: Abra Configurações → Modelos e provedores → Local CLI e escolha Verificar novamente. Reinicie o Open Design ou verifique novamente se ele já estava aberto durante a instalação. O cartão DeepSeek Harness aparece quando o Open Design encontra o executável `dsh` da etapa 1.
- 4 · Conecte o perfil do Open Design: Selecione o cartão DeepSeek Harness. Se ele mostrar “Configuração de conexão necessária”, confirme “Instalar e selecionar”. O Open Design verifica seu próprio componente, pede ao dsh para instalá-lo no perfil `open-design`, verifica novamente e testa a conexão.
- 5 · Inicie uma tarefa de design: Confirme que o cartão mostra a versão do Harness e “Sincronizado pela CLI” e clique em Testar. Depois que o teste passar, abra ou crie um projeto, escolha DeepSeek Harness e um modelo sincronizado e envie sua solicitação de design.
Isso conclui a conexão. A UI e `od agent setup deepseek-harness --json` usam o mesmo caminho de configuração local; cada execução inicia `dsh --profile open-design --stdio`, enquanto o Harness preserva a identidade da sessão para os turnos seguintes.
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.
O limite é simples: o Harness gerencia dsh, credenciais, modelos e sessões; o Open Design gerencia o perfil de conexão verificado e o workspace de design. O Open Design é independente da DeepSeek AI, e DeepSeek e DeepSeek Harness são marcas comerciais de seus respectivos proprietários.
Execute o ciclo de build e revisão da UI
Para trabalhos de interface, deixe explícitos o briefing e o loop de aceite. A rota padrão da DeepSeek aceita somente texto, então a base mais confiável é um fluxo orientado por código e especificações; anexe screenshots somente depois de selecionar uma rota de modelo que declare suporte a entrada de imagens.
- Inicie o dsh a partir do repositório, escolha esse diretório como workspace e selecione a rota de modelo para esta tarefa.
- Coloque o contrato da marca em `AGENTS.md`, `CLAUDE.md` ou em um `DESIGN.md` referenciado: tokens, elementos primitivos, espaçamento, tipografia, breakpoints, estados e padrões proibidos.
- Carregue uma skill de frontend focada a partir de `.dsh/skills` ou `.agents/skills`; mantenha os exemplos e scripts de validação junto às instruções.
- Peça ao agente para reutilizar os componentes existentes, executar o aplicativo e validar os estados responsivos com os testes ou as ferramentas de navegador do próprio projeto.
- Revise o resultado visível, registre diferenças específicas e faça iterações em commits pequenos. Reverta tentativas fracas em vez de acumular correções sobre uma base ruim.
Um prompt útil especifica tanto as restrições visuais quanto as evidências de verificação:
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 um screenshot for essencial, primeiro configure um provedor compatível com imagens. O DeepSeek Harness recusa a imagem antes do envio quando a rota selecionada não declara suporte a imagens — uma proteção útil contra o descarte silencioso da referência.
Torne o fluxo de trabalho reutilizável com plug-ins e skills
O maior diferencial do DeepSeek Harness está sob a superfície do chat. Sua árvore de plugins permite que as equipes incorporem o fluxo de design ao ambiente de execução, em vez de colar um prompt em cada sessão.
- AGENTS.md e CLAUDE.md: O plugin de instruções carrega o arquivo global do usuário e a hierarquia do projeto e, depois, identifica arquivos de instruções aninhados relevantes após operações de arquivo nativas. Use-o para regras de design duradouras, não para solicitações pontuais.
- Skills no sistema de arquivos: O registro de skills descobre as raízes do projeto e do usuário, classifica duplicatas e expõe uma ferramenta `skill` voltada ao modelo. É o local natural para práticas de frontend, acessibilidade, QA responsivo e procedimentos de design system.
- Perfis e pacotes: Um perfil empilha pacotes de plugins ordenados, além de modificações do usuário. As equipes podem manter uma composição voltada a design com o provedor, as ferramentas, a política de permissões e as fontes de skills que realmente precisam.
- MCP e recursos externos: A árvore de código-fonte inclui recursos de cliente MCP, mas a configuração voltada ao usuário ainda é orientada a desenvolvedores. Durante a versão prévia, trate as integrações como trabalho de plugins versionados, não como um fluxo estável com caixas de seleção.
Antes de criar um fluxo interno duradouro, inspecione a árvore efetiva com `dsh --profile web --dump-config`. Essa saída mostra o que está realmente montado e pode ser modificado; ela é mais confiável do que supor que todos os pacotes do repositório estejam ativos no perfil incluído.
Evite falhas que prejudicam o resultado visual
Os maiores erros vêm de tratar uma versão prévia como um produto estável, uma rota que aceita somente texto como um modelo de visão ou um harness flexível como fonte de bom gosto visual.
- Fixe a versão antes de personalizar: Mudanças que quebram a compatibilidade fazem parte da política explícita da versão prévia. Fixe a versão do npm e mantenha as modificações de perfil pequenas o suficiente para serem revisadas depois de uma atualização.
- Verifique as modalidades do modelo selecionado: A rota nativa de chat-completions da DeepSeek aceita somente texto. Para transformar screenshots em código, selecione e declare uma rota de provedor compatível com imagens, em vez de supor que o anexo será compreendido.
- Forneça o bom gosto como dados: Forneça ao agente tokens, componentes canônicos, estados de referência e padrões proibidos. Um ambiente de execução modular sem um contrato de design ainda produz uma UI genérica.
- Verifique o que o perfil realmente monta: Os pacotes do repositório são recursos, não uma prova de que o perfil padrão os habilita. Inspecione a configuração composta antes de documentar uma integração ou depender dela.
Cada medida de mitigação é uma decisão de contexto e verificação. Esse é exatamente o trabalho que uma camada de design deve tornar reproduzível, em vez de deixar cada projeto redescobri-lo.
O que o harness oferece ao design
O DeepSeek Harness (`dsh`) é um harness de agentes desenvolvido pela DeepSeek AI sob a licença MIT. A página oficial do produto apresenta o projeto; o repositório no GitHub contém o código-fonte, o histórico de versões e os guias mantidos. A versão prévia pública para desenvolvedores inclui uma Web UI local e perfis headless.
Sua ideia central é que “tudo é um plugin”. O Cordis compõe uma árvore em que o adaptador de modelo, o registro de ferramentas, o loop do agente, o sistema de arquivos, o shell, a sandbox, as skills, os subagentes, a persistência e a UI podem ser montados, substituídos ou modificados por meio de perfis e pacotes. Os perfis `web` e `headless` incluídos são pontos de partida, não produtos fixos.
- Web UI local: `npx @deepseek-ai/dsh web` inicia, por padrão, um workspace no navegador em `127.0.0.1:3080`. Adicione um modelo, escolha um workspace e execute tarefas pela interface de conversa.
- Modo headless: O perfil `headless` executa uma nova sessão persistida, imprime a resposta final e encerra — útil para auditorias automatizadas, builds e verificações de design reproduzíveis.
- Ambiente de execução modular: Os perfis empilham pacotes de plugins e suas próprias modificações. Assim, uma equipe pode trocar provedores, ferramentas, políticas e o comportamento da UI sem criar um fork do loop de um agente.
- Desenvolvedor: DeepSeek AI (projeto oficial)
- Status: versão prévia para desenvolvedores; são esperadas mudanças que quebrem a compatibilidade
- Licença: MIT
- Comando principal: `npx @deepseek-ai/dsh web`
DeepSeek Harness, DeepSeek TUI e Open Design
DeepSeek Harness e DeepSeek TUI são projetos separados com executáveis diferentes. Open Design agora oferece suporte a ambos como agentes locais, portanto, a escolha é sobre qual runtime você deseja - e não se algum deles pode entrar no espaço de trabalho de design.
| Ferramenta | O que é | Melhor uso em design |
|---|---|---|
| DeepSeek Harness (`dsh`) | Harness oficial da DeepSeek AI centrado em plugins, com Web UI local e perfis headless; adaptador nativo do Open Design | Usando sessões Harness, provedores e composição de plug-ins dentro do fluxo de trabalho do artefato Open Design |
| DeepSeek TUI (`deepseek` / `codewhale`) | Um agente de codificação de terminal separado com seu próprio adaptador Open Design | Um fluxo de trabalho DeepSeek que prioriza o terminal sem a arquitetura de perfil Harness |
| OpenCode | Agente de terminal open-source maduro e agnóstico quanto a provedores | Alternar entre modelos em um fluxo estável de TUI com AGENTS.md e MCP |
| Claude Code | Agente de programação maduro disponível em terminal, IDE, desktop e web | Raciocínio de frontend, referências com muitas imagens e integrações de design consolidadas |
| Open Design | Workspace e biblioteca de design agent-native ao redor de agentes de programação compatíveis | Design systems e skills selecionados, artefatos visuais e um fluxo local independente de um único fornecedor de modelos |
Escolha DeepSeek Harness se você quer sua Web UI oficial, o sistema de perfis, o catálogo de modelos e sessões do Harness que podem ser retomadas. Escolha DeepSeek TUI dentro do Open Design se preferir o fluxo de trabalho desse agente centrado no terminal. Eles continuam sendo runtimes distintos, embora o Open Design agora possa integrar qualquer um deles ao mesmo processo de design.
Usando DeepSeek Harness para design: Perguntas frequentes
-
01 O que é o DeepSeek Harness?
O DeepSeek Harness (`dsh`) é o harness de agentes open-source oficial da DeepSeek AI. Ele combina modelos, ferramentas, contexto, sessões, políticas, orquestração e UI por meio de uma árvore de plugins do Cordis. A versão pública está atualmente em fase prévia para desenvolvedores, sob a licença MIT.
-
02 Como instalar e executar o DeepSeek Harness?
Instale a CLI testada com `npm install -g @deepseek-ai/[email protected]` e execute `dsh web`. Avance após o aviso de versão prévia e salve somente a chave de API em Configurações → Modelos → DeepSeek → Chave de API. Confirme que o provedor e o modelo funcionam, encerre a Web UI com `Ctrl+C`, instale o Open Design 0.19.1 ou posterior, verifique novamente os agentes de Local CLI, conecte o cartão Harness e clique em Testar.
-
03 O DeepSeek Harness é um projeto oficial da DeepSeek?
Sim. O repositório é publicado na organização `deepseek-ai` do GitHub e descreve o dsh como um harness de agentes desenvolvido pela DeepSeek AI. Ele é licenciado sob a MIT e está explicitamente marcado como versão prévia para desenvolvedores.
-
04 O DeepSeek Harness pode criar UI a partir de screenshots?
Somente quando a rota do provedor selecionado declara suporte a entrada de imagens. A própria rota de chat-completions da DeepSeek no dsh aceita somente texto, e o harness rejeita anexos de imagem antes do envio em uma rota que aceita somente texto. Use um provedor compatível com imagens para screenshots ou descreva o objetivo por meio de código, DOM, tokens e especificações escritas.
-
05 O DeepSeek Harness oferece suporte a AGENTS.md e skills?
Sim. Seu plugin de instruções carrega arquivos de projeto compatíveis com AGENTS.md e CLAUDE.md. Seu provedor de skills no sistema de arquivos descobre as skills do projeto em `.dsh/skills` e `.agents/skills`, além das raízes configuradas do usuário e dos pacotes incluídos.
-
06 Qual é a diferença entre o DeepSeek Harness e o DeepSeek TUI?
São ferramentas separadas. O DeepSeek Harness usa o executável `dsh` e é uma Web UI oficial da DeepSeek AI com ambiente de execução headless centrado em plugins. O DeepSeek TUI usa o dispatcher `deepseek` ou `codewhale` e é o adaptador separado da DeepSeek atualmente compatível com o Open Design.
-
07 O Open Design oferece suporte ao DeepSeek Harness?
Sim. O Open Design detecta sua instalação oficial do dsh, instala um componente de perfil verificado do próprio Open Design após sua confirmação explícita, sincroniza o catálogo de modelos do Harness e executa o DeepSeek Harness como agente local com suporte nativo. O Open Design não instala dsh nem recebe os segredos do provedor gerenciados pelo Harness.
-
08 Onde o DeepSeek Harness armazena minha chave de API?
Configure a chave no DeepSeek Harness, não no Open Design. Segundo o guia oficial de modelos, as chaves dos provedores são armazenadas em `$DSH_HOME/.credentials.yaml` como segredos somente para gravação: a UI pode verificar se uma chave está configurada, mas não pode ler nem exibir seu valor em texto simples. O Open Design não pede que você cole a chave no aplicativo nem a grava na configuração do Open Design.
Projete com DeepSeek Harness em Open Design.
Instale o runtime oficial do dsh, conecte-o uma vez e use os design systems, skills, modelos sincronizados e prévias de artefatos locais do Open Design em um fluxo de trabalho.