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

Deep​Seek Harness — dsh, para abreviar — não é um modelo. É o runtime de agente open-source que a Deep​Seek lançou sob a licença MIT em 13 de agosto de 2026, e, em termos de adoção, é a coisa mais rápida que a Deep​Seek já lançou: a cobertura da imprensa relata cerca de 50.000 estrelas no GitHub nas primeiras 12 horas, e o repositório estava com 125.922 estrelas e 12.523 forks quando consultamos a API do GitHub hoje. Sua função é a camada de engenharia entre um modelo de linguagem e uma tarefa concluída: edição de arquivos, execução no terminal, busca na web, gerenciamento de contexto, planejamento de tarefas e chamada de outros agentes. A fórmula que a própria equipe da Deep​Seek usa é Modelo + Harness = Agente — o modelo raciocina, o harness faz todo o resto.

Essa distinção é o ponto deste artigo. Pessoas que buscam por "deepseek harness" geralmente esperam uma análise do modelo, mas acabam encontrando cobertura do lançamento. Então aqui está a resposta logo de cara: 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, atualmente 0.1.0-rc.6 — e ele conecta qualquer modelo que você fornecer (DeepSeek V4 Flash por padrão) ao seu sistema de arquivos, ao seu terminal, à web e a outros agentes. É licenciado sob MIT, construído sobre um framework de plugins chamado Cordis, e é explicitamente uma prévia para desenvolvedores que alerta sobre mudanças que quebram compatibilidade. Abaixo está o que ele realmente faz, como executá-lo hoje e onde ele deixa a desejar.

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 interesses: plugins adicionam capacidades; presets decidem quais capacidades um determinado agente pode ver.O monorepo inclui 49 pacotes em packages/ — core, llm, mcp, sandbox, context, plan, goal e outros — e a cobertura do lançamento conta com mais de 100 plugins de primeira parte, com uma loja de plugins já reservada e 288 repositórios de plugins da comunidade coletados no GitHub em até 24 horas após o lançamento, encontráveis sob a tag de tópico dsh-plugin.

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 Deep​Seek reservou uma loja de plugins, repositórios da comunidade são marcados para descoberta, e lojas de terceiros dentro do aplicativo já existem. O jogo de longo prazo é que o harness, não o modelo, se torne o ecossistema — e é por isso que a discussão sobre preços da DSH importa mais do que qualquer recurso individual.

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

Isto inicia a interface web, servida em http://127.0.0.1:3080 por padrão. Na interface: abra Configurações → Modelos, cole uma chave de API Deep​Seek e escolha um espaço de trabalho — o compositor de sessão permanece bloqueado até que você faça isso. O modelo padrão é DeepSeek V4 Flash, e a política de permissão padrão é workspace-write com solicitações de aprovação para tudo o mais.

Existem quatro pontos de entrada no total: a interface web, execuções únicas headless, um SDK Python que aciona o DSH via JSON-RPC stdio, e --dump-config, que imprime a árvore de plugins montada (o perfil web monta 129 linhas de configuração de plugins; o headless, 81). A partir do código-fonte, o caminho é git clone, pnpm install, pnpm run build, e então pnpm dsh web.

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

DSH está na versão 0.1.0-rc.6, e o README é explícito: "HAVERÁ MUDANÇAS QUE QUEBRAM A COMPATIBILIDADE." Avaliações publicadas nesta semana catalogam as arestas — falhas silenciosas sob MSYS2 no Windows, obsolescência do cache de hot-reload, um atraso de persistência em lote de aproximadamente 200ms que atrasa a exibição do progresso na UI, e críticas da comunidade de que o GitHub Issues está desabilitado em um repositório posicionado como infraestrutura pública. A experiência padrão do produto também ainda fica aquém 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 DeepSeek V4 Flash e DeepSeek V4 Pro

O DSH usa como padrão o DeepSeek V4 Flash, e a principal versão DeepSeek V4 Pro (Deep​Seek-V4-Pro-0813) é da mesma família de modelos para a qual o harness foi criado. Ambos estão disponíveis hoje por meio de chamadas de API comuns — sem necessidade de harness — e ambos estão hospedados no OrcaRouter pelo preço de tabela da própria Deep​Seek: aproximadamente US$ 0,15 por milhão de tokens de entrada e US$ 0,29 por milhão de tokens de saída para o DeepSeek V4 Flash, e aproximadamente US$ 0,44/US$ 0,88 para o DeepSeek V4 Pro, repassados com margem de 0%.

O limite honesto: OrcaRouter é um roteador de modelos, não um runtime de agentes, portanto, não hospedamos DSH — ele não é um modelo. O que um roteador genuinamente responde aqui é o problema de failover que DSH levanta. O harness é uma prévia em rápida evolução, e apontar tráfego de produção para ele significa apostar em pontuações agentivas relatadas pelos fornecedores. Executar os mesmos modelos Deep​Seek por meio de uma camada de roteamento em 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 deve ser experimentado; os modelos que ele executa são o que deve ser roteado com cuidado.

Conclusão

O Deep​Seek Harness é a coisa mais significativa que a Deep​Seek disponibilizou em código aberto desde os próprios modelos, porque muda o que "Deep​Seek" significa: não apenas modelos, mas a camada de agentes que os executa. Para quem está decidindo o que fazer: se você constrói agentes, instale-o esta semana e rode o teste de reprodução — as pontuações do V4 Flash e do V4 Pro que a Deep​Seek publicou vieram deste harness, e agora você mesmo pode conferi-las. Mas trate-o como o que ele é: uma prévia para desenvolvedores 0.1.0-rc.6, com mudanças que quebram compatibilidade pela frente, um sistema de plugins que recompensa quem gosta de ser dono da própria stack e um harness ainda mais cru do que as alternativas refinadas. Os modelos subjacentes são a parte confiável — e é para eles que você pode rotear com confiança hoje.