DeepSeek Harness, Explicado: O Runtime do Agente por Trás de "Modelo + Harness = Agente"

DeepSeek Harness — dsh para abreviar — não é um modelo. É o runtime de agente de código aberto que a DeepSeek lançou sob a licença MIT em 13 de agosto de 2026, e continua sendo a coisa mais rápida que a DeepSeek já lançou em termos de adoção: a cobertura da imprensa relatou cerca de 50.000 estrelas no GitHub nas primeiras 12 horas, e o repositório estava com 242.211 estrelas e 29.059 forks quando consultamos a API do GitHub hoje. O que ele executa é o DeepSeek V4.1 Flash, o modelo que a API da DeepSeek serve como deepseek-flash, ou o maior DeepSeek V4 Pro quando você o aponta para lá. Seu trabalho é a camada de engenharia entre um modelo de linguagem e uma tarefa concluída: edição de arquivos, execução no terminal, pesquisa na web, gerenciamento de contexto, planejamento de tarefas e chamada de outros agentes. A fórmula que a própria equipe da DeepSeek usa é Modelo + Harness = Agente — o modelo raciocina, o harness faz todo o resto.

Essa distinção é o ponto deste artigo. Quem pesquisa "deepseek harness" geralmente espera uma análise de modelo e acaba caindo na cobertura do lançamento. Então aqui está a resposta logo de cara: o DSH não é um modelo que você chama por meio de uma API. É um programa que você instala e executa — o pacote npm é @deepseek-ai/dsh, cuja tag latest agora resolve para 0.2.0-rc.2 — três linhas de lançamento depois da build 0.1.x para a qual esta página foi escrita originalmente, e além do selo de versão no cartão acima — e ele conecta qualquer modelo que você fornecer (DeepSeek V4.1 Flash por padrão) ao seu sistema de arquivos, ao seu terminal, à web e a outros agentes. Tem licença MIT, é construído sobre um framework de plugins chamado Cordis e é explicitamente uma prévia para desenvolvedores que avisa sobre mudanças que quebram compatibilidade. O aplicativo de desktop empacotado que a DeepSeek anunciou em 2 de outubro — builds para macOS e Windows, com usuários de Linux direcionados ao pacote npm — é a superfície mais recente em cima disso. Abaixo está o que ele realmente faz, como executá-lo hoje e onde ele fica aquém.

O que um harness realmente faz (e por que o termo é confuso)

Um harness é o arcabouço que permite que um modelo bruto realize trabalho no mundo real. Um modelo sozinho só consegue produzir texto. Dê a ele um harness e ele poderá ler e escrever arquivos, executar comandos no seu shell, pesquisar na web, manter um plano, chamar ferramentas, reagir a erros e avaliar quando uma tarefa está concluída. A fórmula pública da Deep​Seek — repetida na cobertura do lançamento e em suas próprias vagas de emprego — é "Modelo + Harness = Agente": o modelo fornece o raciocínio, o harness fornece todo o resto.

É por isso que o lançamento importa além de um único produto. A Deep​Seek relatou suas próprias pontuações de benchmark agêntico para seus dois últimos modelos a partir deste harness: a documentação da API DeepSeek V4 Flash afirma que seu resultado de 82,7 no Terminal-Bench 2.1 foi produzido no "Deep​Seek Harness minimal mode." O harness é o ambiente de referência do qual esses números vieram, e agora é público para qualquer pessoa reproduzir — ou contradizer.

Tudo é um plugin: a arquitetura Cordis

O design central do DSH, declarado em seu próprio README, é que tudo é um plugin. O loop do agente, adaptadores de modelo, ferramentas, habilidades, armazenamento de sessão, sandbox, agendamento e até a interface web são todos plugins Cordis. Não há núcleo privilegiado para corrigir: você estende o harness montando um plugin ao lado dos outros, e cada registro é um efeito que se desfaz quando o plugin é descarregado. O motor de plugins é o Cordis, um meta-framework cujo design é descrito no artigo da Universidade de Pequim–Deep​Seek "A Programming Paradigm for Spatiotemporal Composability."

A consequência prática é uma separação nítida de responsabilidades: os plugins adicionam capacidades; os presets decidem quais capacidades um determinado agente pode ver. O monorepo agora contém 55 pacotes em packages/ — core, llm, mcp, sandbox, context, plan, goal, workspace e outros — e a cobertura do lançamento contou com mais de 100 plugins próprios, com uma loja de plugins já reservada e 288 repositórios de plugins da comunidade coletados no GitHub nas 24 horas seguintes ao lançamento. Isso foi há seis semanas. O tópico dsh que o Deep​Seek usa para descoberta de plugins agora retorna mais de 17.000 repositórios na busca do GitHub, que consultamos em 2 de outubro de 2026 — o ecossistema continuou crescendo mesmo enquanto o próprio harness permaneceu em candidatos a lançamento.

As quatro predefinições — e quando usar cada uma

O DSH é fornecido com quatro predefinições de agente, cada uma carregando um conjunto de plugins diferente. No menu de predefinições da própria interface web:

• Standard — um agente de codificação completo: edição de arquivos, shell, pesquisa de arquivos e web, habilidades, planejamento, metas, subagentes e fluxos de trabalho. O padrão certo para a maioria dos trabalhos.

• Code — chamado de PTC, "programmatic tool calling", na cobertura da imprensa chinesa — tudo o que existe no Standard, mais um SDK do Code Mode que permite ao modelo escrever programas em TypeScript para compor chamadas de ferramentas em várias etapas em um único programa. Mais poderoso, e pode multiplicar efeitos colaterais e chamadas de ferramentas.

• Minimal — apenas bash persistente mais str_replace_editor. Construído para reproduzir execuções de benchmark; este é o preset que a Deep​Seek usou para obter a pontuação 82.7 no Terminal-Bench V4 Flash. Minimal não é inofensivo — acesso ao shell continua sendo acesso ao shell.

• Creator— o quarto diretório de presets se chama literalmente cordis — Standard com inspeção em tempo de execução, experimentos em memória de plugins do Cordis e criação de presets. O agente pode instalar, substituir ou destruir plugins no meio da conversa. Um ambiente de engenharia, não uma camada de aprovação de produção.

Qual você deve escolher? Se você está reproduzindo um benchmark, Minimal. Se você quer que o agente escreva sua própria orquestração de várias etapas, Code. Se você está construindo ou testando um plugin, Creator. Para todo o resto, comece com Standard — autoridade ampla significa que você também quer um workspace restrito e uma política de permissões rigorosa.

Trajectory: o recurso que os revisores chamam de 'DevTools for agents'

O recurso mais elogiado nas avaliações práticas é Trajectory. Cada execução grava em um log de sessão append-only — JSONL comprimido com zstd, com um envelope de evento uniforme de tipo, sequência, hora e dados — registrando tudo o que o modelo viu: prompts de sistema, raciocínio, chamadas e resultados de ferramentas, agendamento de subagentes, injeções de contexto. A visualização Trajectory permite inspeção por fonte, retomada, fork, busca e reprodução. O fork é o grande destaque: você pode alterar uma instrução e reproduzir a execução lado a lado com a original, em vez de descartar o rastro.

Concretamente, em um teste prático publicado em 15 de agosto, uma única tarefa de escrita de arquivo gerou 61 eventos de sessão, e uma tarefa trivial de "responder PONG" ainda consumiu cerca de 13.467 tokens de entrada na primeira requisição — sobrecarga de prompts de sistema padrão, esquemas de ferramentas, regras de repositório injetadas automaticamente e resumos de habilidades. Esse é o custo honesto de um arcabouço que registra tudo: você paga tokens pelo andaime e pode ver exatamente pelo que pagou.

MCP, plugins e conversar com outros agentes

MCP é onde o hype supera o build atual. O monorepo inclui um pacote mcp e a CLI traz uma dependência dsh-mcp-client, mas nenhum servidor MCP está habilitado por padrão, e a arquitetura roteia a integração de ferramentas através de plugins Cordis em vez de tratar MCP como um cidadão de primeira classe. Você pode conectar servidores MCP como fonte de ferramentas; só que ainda não é o caminho padrão.

O que é mais surpreendente é o que a lista de provedores de subagentes mostra. DSH pode gerar outros agentes como subagentes — incluindo, de acordo com a documentação do capability-seams, um provedor Codex e um provedor Claude Code. Essa é uma posição incomum para um concorrente assumir: DSH é um harness que pode delegar trabalho aos próprios produtos com os quais é comparado.

A história dos plugins é a verdadeira aposta de plataforma. A DeepSeek reservou uma loja de plugins, repositórios da comunidade estão marcados para facilitar a descoberta, e lojas de terceiros dentro de aplicativos já existem. As notas de versão 0.2.0-rc.2 dedicam a maior parte do texto a orientações de instalação de plugins — distinguindo plugins instalados, incompatíveis e incluídos — que é onde o esforço de engenharia ainda está concentrado. A aposta de longo prazo é que o harness, e não o modelo, se torne o ecossistema, e é por isso que a discussão de preços em torno do DSH importa mais do que qualquer funcionalidade isolada.

Como executá-lo hoje

Você precisa do Node.js 22.19 ou mais recente — o manifesto do pacote exige ^22.19.0 ou >=24 — e então um comando:

npx @deepseek-ai/dsh web

Isso inicia a interface web, servida por padrão em http://127.0.0.1:3080. Na interface: abra Configurações → Modelos, cole uma chave de API do DeepSeek e então escolha um workspace — o compositor de sessão permanece bloqueado até que você faça isso. O modelo padrão é o DeepSeek V4.1 Flash, e a política de permissão padrão é workspace-write com prompts de aprovação para todo o resto.

Existem agora cinco pontos de entrada: a interface Web, o aplicativo desktop empacotado, execuções únicas sem interface gráfica, um SDK Python que controla o DSH via JSON-RPC stdio, e --dump-config, que imprime a árvore de plugins montada (o perfil web montou 129 linhas de configuração de plugins; o headless, 81). O aplicativo desktop é o que mudou esta semana. A DeepSeek publicou builds para macOS e Windows — incluindo Macs Intel, onde nossa nota de setembro registrava que o build para Intel retornava 404 — e todos os feeds de desktop informam a versão 0.2.0-rc.2 com data de lançamento em 29 de setembro. As notas da 0.2 também incorporam o comando dsh ao aplicativo desktop para gerenciamento de plugins, então essa rota não precisa mais de uma instalação separada de Node ou pnpm. O próprio anúncio da DeepSeek descreve plugins e Workspaces como compatíveis de fábrica na 0.2 — uma alegação do fornecedor sobre um release candidate, embora as páginas de plugins e o armazenamento de workspaces que o aplicativo compartilha com a CLI estejam visíveis no repositório público. O Linux é a exceção que o próprio anúncio da DeepSeek menciona: o conjunto de alvos suportados pelo script de empacotamento é mac-arm64, mac-x64 e win-x64, não existe artefato para Linux no host de downloads da DeepSeek, e os usuários de Linux são instruídos a executar npx @deepseek-ai/dsh web. A partir do código-fonte, o caminho permanece o mesmo: git clone, pnpm install, pnpm run build e, depois, pnpm dsh web.

A parte honesta: em nível de prévia, e onde DSH é a ferramenta errada

O DSH está na versão 0.2.0-rc.2 — não é 1.0, e nem mesmo um 0.x estável: todas as 29 versões no npm e todos os 24 releases do GitHub são pré-lançamentos, e o README é explícito: "HAVERÁ MUDANÇAS QUE QUEBRAM A COMPATIBILIDADE." Análises do período de lançamento catalogam as imperfeições — falhas silenciosas no MSYS2 no Windows, obsolescência do cache de hot-reload, um atraso de persistência em lote de cerca de 200 ms que fica atrás da exibição de progresso da UI, e críticas da comunidade de que o GitHub Issues está desativado em um repositório posicionado como infraestrutura pública. A experiência padrão do produto também ainda fica atrás dos agentes de codificação refinados com os quais é comparada; uma análise prática concluiu que o lançamento de código aberto é um esqueleto de runtime de agente, ainda não um produto acabado.

Onde o DSH é a ferramenta errada? Quatro situações. Primeiro, se você quer um acabamento pronto para uso — os atuais Claude Code e Codex são mais completos, e o DSH é para quem quer o esqueleto e está disposto a finalizá-lo. Segundo, se você não consegue auditar o que executa: procedência de plugins, diffs de configuração e limites de credenciais são todos fornecidos por você mesmo, e o uso em produção exige governança que você provê. Terceiro, se você está fazendo benchmark de modelos: você não pode rodar um modelo no modo Standard e outro no Minimal e chamar a diferença de resultado de modelo — você mudou a estrutura (harness), não apenas o modelo. Quarto, se você se importa com custos de overhead de tokens: o contexto sempre ativo pode queimar milhares de tokens de entrada antes de o modelo fazer qualquer trabalho real.

O que isso significa para o DeepSeek V4.1 Flash e o DeepSeek V4 Pro

O DSH usa o DeepSeek V4.1 Flash por padrão — o modelo que a API da Deep​Seek entrega como deepseek-flash — e a versão carro-chefe DeepSeek V4 Pro (Deep​Seek-V4-Pro-0813) é da mesma família de modelos para a qual o harness foi construído. Ambos estão disponíveis hoje por meio de chamadas de API comuns, sem precisar de harness, e ambos são hospedados no OrcaRouter pelo preço de tabela da própria Deep​Seek, repassado com 0% de margem: $0.15 de entrada e $0.60 de saída por milhão de tokens para o Deep​Seek V4.1 Flash, e $0.66/$1.98 para o Deep​Seek V4 Pro. Esses são preços fora de pico, que a Deep​Seek dobra entre 01:00 e 04:00 e novamente entre 06:00 e 10:00 UTC nos dias de semana. A captura de tela abaixo é um registro de agosto da página do modelo Deep​Seek V4 Flash 0731, e os $0.15/$0.29 que ela exibe são o preço dessa versão: a página de preços da Deep​Seek agora traz uma única entrada Flash, deepseek-flash = Deep​Seek-V4.1-Flash, a $0.15/$0.60. Leia o cartão como um registro datado, não como a tarifa de hoje.

A fronteira honesta: o OrcaRouter é um roteador de modelos, não um runtime de agentes, então não hospedamos o DSH — ele não é um modelo. O que um roteador de fato responde aqui é o problema de failover que o DSH levanta. O harness é uma prévia em rápida evolução — 0.2.0-rc.2 hoje, com o aplicativo de desktop construído sobre ele ainda mais recente — e direcionar tráfego de produção para ele significa apostar em pontuações agênticas informadas pelo fornecedor. Executar os mesmos modelos Deep​Seek por uma camada de roteamento com uma única chave permite testar os números nativos do DSH enquanto mantém failover automático entre fornecedores para o tráfego que precisa continuar funcionando. O harness é o que se deve experimentar; os modelos que ele executa são o que se deve rotear com cuidado.

Conclusão

DeepSeek Harness é a coisa mais impactante que a DeepSeek disponibilizou em código aberto desde os próprios modelos, porque muda o que "DeepSeek" significa: não apenas modelos, mas a camada de agentes que os executa. Para um leitor que está decidindo o que fazer: se você constrói agentes, instale o aplicativo de desktop ou a linha de comando 0.2.0-rc.2 esta semana e execute o teste de reprodução — o Terminal-Bench 82.7 que a DeepSeek publicou para seu modelo Flash foi produzido dentro deste harness, e agora você pode verificar por conta própria. Mas trate-o como o que é: uma prévia para desenvolvedores com mudanças incompatíveis pela frente, um sistema de plugins que recompensa quem gosta de ser dono da própria stack, e um harness que ainda é mais bruto que as alternativas polidas. Se você está no Linux, o aplicativo empacotado ainda não é o caminho para você — o npm é. Os modelos por baixo são a parte confiável, e esses você pode rotear com confiança hoje.