DeepSeek Harness para design.
Um modelo pode escrever JSX, mas um agente de design útil precisa de mais do que a saída do modelo. Ele precisa de regras da marca, referências, ferramentas, permissões e um loop que renderize e verifique o resultado. O DeepSeek Harness expõe essas peças ao redor do modelo, em vez de ocultá-las.
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.
Essa flexibilidade é útil para o trabalho de design porque a qualidade da UI gerada depende do harness ao redor do modelo: regras persistentes do projeto, skills reutilizáveis, o provedor certo para entradas de texto ou imagem, ferramentas de arquivos e shell e um loop de verificação. Este guia mostra a configuração funcional mais rápida, os limites relevantes para tarefas de UI e a fronteira real com o Open Design: o dsh ainda não é um adaptador oficial do Open Design, enquanto o adaptador existente para DeepSeek TUI é uma CLI diferente.
Configure o DeepSeek Harness do zero
A versão prévia pública exige Node.js `^22.19.0` ou `>=24.0.0`. O comando npm inicializa o perfil web no primeiro uso, para que você possa acessar uma UI local funcional sem clonar o repositório.
# 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"
- As credenciais permanecem referenciadas: A Web UI armazena os segredos dos provedores em `$DSH_HOME/.credentials.yaml`; as configurações mantêm uma referência à credencial, e a UI recebe um descritor ocultado em vez da chave literal.
- Trate a versão prévia como infraestrutura com versão fixada: Os mantenedores avisam explicitamente que ocorrerão mudanças que quebram a compatibilidade. Fixe a versão usada no fluxo da equipe e revise as alterações de cada versão antes de atualizar.
Por que um harness centrado em plugins combina com o trabalho de design
Um modelo pode escrever JSX, mas um agente de design útil precisa de mais do que a saída do modelo. Ele precisa de regras da marca, referências, ferramentas, permissões e um loop que renderize e verifique o resultado. O DeepSeek Harness expõe essas peças ao redor do modelo, em vez de ocultá-las.
- 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.
Um fluxo prático do DeepSeek Harness para UI e frontend
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.
Plugins, skills e contexto do projeto
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.
Armadilhas da versão prévia para desenvolvedores e do design
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 DeepSeek Harness realmente é
O DeepSeek Harness (`dsh`) é um harness de agentes desenvolvido pela DeepSeek AI sob a licença MIT. A versão prévia pública para desenvolvedores inclui uma Web UI local e um executor headless. Ele não é um modelo nem apenas uma interface para o terminal: é o ambiente de execução que reúne um modelo, ferramentas, contexto, permissões, sessões e interface do usuário em um agente.
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 vs. DeepSeek TUI e outros agentes de design
É fácil confundir os nomes. O DeepSeek Harness e o DeepSeek TUI atualmente listado no Open Design são projetos separados, com executáveis e status de integração diferentes.
| 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; versão prévia para desenvolvedores | Equipes que querem compor o ambiente de execução, as skills, os provedores, as políticas e a UI ao redor de um fluxo de design |
| DeepSeek TUI (`deepseek` / `codewhale`) | Um agente de programação separado para terminal e o adaptador da DeepSeek atualmente compatível com o Open Design | Usar a DeepSeek dentro do Open Design hoje |
| 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 o dsh quando o próprio harness for o que você quer ampliar. Escolha o DeepSeek TUI dentro do Open Design quando quiser o adaptador da DeepSeek atualmente compatível e uma camada de design pronta. Eles podem convergir por meio de um adaptador futuro, mas hoje não são intercambiáveis.
Use o DeepSeek Harness com um workspace de design agent-native
O Open Design e o DeepSeek Harness ocupam camadas adjacentes. O dsh compõe um ambiente de execução de agentes; o Open Design seleciona os design systems, as skills e o fluxo local de artefatos que tornam um agente útil para trabalhos visuais. O Open Design ainda não oferece um adaptador dedicado para `dsh`, então, hoje, o fluxo correto é usá-los lado a lado.
- Instale o Open Design e use seus design systems e suas skills para estabelecer o contrato visual do projeto.
- Mantenha o `DESIGN.md`, as referências e as instruções de projeto resultantes no mesmo repositório que o DeepSeek Harness abre como workspace.
- Execute o dsh para experimentos centrados em plugins e tarefas de código; reutilize os mesmos tokens, regras, ativos e critérios de validação, em vez de manter um segundo briefing de design.
- Quando precisar da DeepSeek diretamente dentro do Open Design hoje, selecione o adaptador DeepSeek TUI existente. Trate um futuro adaptador para dsh como uma integração separada, não como um recurso atual.
O resultado é uma única base de código sob seu controle e um único contrato de design portátil entre duas ferramentas local-first. O Open Design continua independente da DeepSeek AI; DeepSeek e DeepSeek Harness são marcas comerciais de seu respectivo proprietário.
Perguntas frequentes sobre o DeepSeek Harness
-
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 uma versão compatível do Node.js e execute `npx @deepseek-ai/dsh web`. Por padrão, ele inicia a Web UI local em `http://127.0.0.1:3080`. Adicione um modelo em Settings → Models, escolha um workspace e inicie uma sessão.
-
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?
Ainda não como um adaptador dedicado e oficial. Atualmente, o Open Design oferece suporte ao adaptador separado DeepSeek TUI. Mesmo assim, você pode usar os design systems, as skills, os arquivos DESIGN.md e os artefatos do Open Design junto ao dsh no mesmo repositório local.
-
08 Onde o DeepSeek Harness armazena minha chave de API?
O guia oficial de modelos informa que as chaves de provedores são armazenadas em `$DSH_HOME/.credentials.yaml`. As configurações mantêm apenas uma referência à credencial, e a Web UI recebe um descritor ocultado em vez do segredo literal.
Crie a camada de design ao redor do seu fluxo com a DeepSeek.
Use hoje os design systems, as skills e o fluxo local de artefatos do Open Design e mantenha o mesmo contrato de projeto pronto para qualquer ambiente de execução de agentes que você escolher depois.