A DeepSeek abriu o código de um harness onde até o ciclo é um plugin (2026)

Surya Pratap
By Surya Pratap

18 de agosto de 2026

12 min read

AI & Technology
Arquitetura do DeepSeek Harness: oito camadas substituíveis com o ciclo do agente em destaque, ao lado do custo adicional de ~10 vezes em tokens e da falha de um sandbox que só cobre o sistema de ficheirosOito camadas substituíveisHover to explore
Cada camada é um plugin, incluindo Control, o próprio ciclo do agente. As duas caixas à direita são o que essa composabilidade lhe custa.

A 13 de agosto, a DeepSeek lançou o seu harness de agentes em pré-visualização para programadores, sob licença MIT, ao mesmo tempo que passava o V4-Pro para disponibilidade geral. Vinte e oito horas depois, o repositório tinha 92 700 estrelas. Dois dias depois, mais de 8400 forks.

O número de estrelas mede atenção, não adequação, e deve ser descontado em conformidade. Mas o desenho por baixo merece o seu tempo mesmo que nunca o corra, porque assume uma posição que os outros harnesses lançados este mês não assumiram — e porque os seus dois maiores problemas são dos que herdaria no primeiro dia.

1. A terceira resposta a uma pergunta feita há dez dias

No início do mês, dois harnesses saíram com 48 horas de diferença e com apostas opostas. O Prime Agent dizia que o harness é portátil e deve ser seu: MIT, qualquer modelo. O Muse Code dizia que o harness só funciona quando o modelo foi treinado dentro dele, por isso pertence ao laboratório. Escrevemos sobre essa divisão em Two Agent Harnesses Shipped in 48 Hours, e a conclusão era que teria de escolher um lado.

O DeepSeek Harness recusa-se a escolher. Tem licença MIT, não está explicitamente preso à DeepSeek e inclui uma camada de adaptadores em forma de plugins que cobre cerca de 40 fornecedores: DeepSeek, Anthropic, OpenAI, Google, Kimi, Bedrock, Vertex, Azure e qualquer endpoint compatível com a OpenAI. Essa é a posição do Prime Agent.

Também foi desenhado em conjunto com o V4. A própria formulação da DeepSeek é Model + Harness = Agent, e a divisão do V4 em dois níveis foi construída a pensar em fluxos de trabalho com harness: o V4-Pro trata da orquestração e das decisões complexas, o V4-Flash serve as chamadas paralelas a subagentes. O harness explora comportamentos específicos do V4: cache de prefixos, gestão da cache KV e tratamento de contexto longo. Essa é a posição do Muse Code.

Porque é que reivindicar as duas coisas é interessante e não incoerente

Portabilidade e codesenho não são realmente contraditórios — são uma troca a que se pode pôr preço. Um harness portátil tem de exprimir cada fornecedor através de uma abstração comum, e as abstrações custam tokens e latência. Um harness codesenhado pode dispensar a abstração porque sabe o que está por baixo. A DeepSeek aposta que consegue pagar a portagem da portabilidade e ainda assim ganhar com o codesenho nos seus próprios modelos. A secção 3 é onde essa aposta aparece na sua fatura.

2. O que «tudo é um plugin» significa realmente

Há oito camadas substituíveis de forma independente: Inference, Tools, State, Control, Execution, Composition, Experience e Framework — esta última assente num sistema de injeção de dependências chamado Cordis.

Sete delas não surpreendem. A maioria dos harnesses sérios deixa-o trocar ferramentas e inferência. A que não é habitual é Control, que é o próprio ciclo do agente. Não o prompt que conduz o ciclo, nem a política dentro dele — o ciclo. Substitui-o por configuração, em tempo de execução.

Se alguma vez escreveu um nó supervisor no LangGraph, construiu à mão um ciclo específico e deixou-o fixo. O DeepSeek Harness trata esse ciclo como uma ranhura. Se isso é libertador ou alarmante depende inteiramente de alguém na sua equipa vir alguma vez a precisar de outro.

Há uma segunda decisão de desenho que vale mais do que o sistema de plugins: o que o modelo vê fica registado. Tudo o que o modelo pode ver é registado, e isso é imposto pela arquitetura em vez de ficar entregue a uma convenção de logging que alguém pode esquecer. Para quem já tentou reconstituir porque é que um agente fez algo há três dias, é uma propriedade de valor real, e é a parte deste lançamento que eu copiaria sem hesitar.

A disciplina de engenharia à vista também é invulgar: 1386 notas de decisão registadas e documentação verificada contra o código para detetar desvios, em vez de apodrecer ao lado dele.

3. O número que deve chegar ao seu CFO antes do seu CTO

A reputação da DeepSeek é ser barata. Essa reputação está agora em parte desatualizada.

O preço do V4-Pro em disponibilidade geral introduziu janelas de procura: 3,96 dólares por milhão de tokens de saída em hora de ponta, com o preço fora de ponta fixado em 50% do preço de ponta. Face às tarifas anteriores, é um aumento do preço de saída de cerca de 2,28 a 4,55 vezes.

Ponha agora isso ao lado do desenho de encaminhamento do harness. O V4-Pro orquestra. O V4-Flash distribui-se pelos subagentes. A orquestração é a parte longa, pesada em contexto e com muita saída de uma execução de agente — o que significa que o harness concentra os seus tokens caros precisamente no modelo cujo preço de saída mais subiu.

Não é uma crítica à arquitetura. Encaminhar o raciocínio para o modelo forte e o trabalho paralelo para o barato é o correto. É um aviso de que a velha conta de cabeça — «é a DeepSeek, por isso é praticamente grátis» — já não sobrevive ao contacto com uma carga de trabalho de agentes, e de que um trabalho em lote em hora de ponta custa agora o dobro de um fora de ponta.

E depois multiplique

Os primeiros testes da comunidade põem o dsh em cerca de 10 vezes o consumo de tokens do Pi e 3 vezes o de outros harnesses. Uma causa confirmada: lê tanto o CLAUDE.md como o AGENTS.md, pelo que as equipas cujas ferramentas mantêm os dois ficheiros sincronizados recebem o prompt de sistema simplesmente duplicado. É um bug e será corrigido. O custo adicional de abstração por trás do resto do múltiplo é estrutural, e soma-se aos preços de ponta acima.

4. O sandbox para no sistema de ficheiros

Esta é a conclusão que deve decidir onde está disposto a corrê-lo.

O DeepSeek Harness define um sandbox de sistema de ficheiros. Esse sandbox controla os efeitos sobre o sistema de ficheiros. O acesso à rede e a visibilidade de processos ficam fora desse vocabulário — e a aplicação é descrita como apenas parcial em ambientes Landlock mais antigos e nas atuais fronteiras de ACL do Windows.

Leia-o sem rodeios: um agente pode estar confinado a um diretório e ainda assim abrir um socket. O confinamento ao sistema de ficheiros não limita o tráfego de saída, por isso não impede a exfiltração. Além disso, o sandbox é opcional e não está ligado por omissão.

Se corre um harness sobre um repositório com credenciais, dados de clientes ou qualquer coisa sujeita a uma obrigação contratual de confidencialidade, um sandbox que só cobre o sistema de ficheiros não é o controlo de que precisa. Precisa de regras de saída na camada de rede, e precisa delas a partir do ambiente, não do harness.

O que isso significa na prática

  • Ambiente dedicado com regras de saída explícitas. Esta é a inegociável. Tudo o resto é defesa em profundidade; esta é a fronteira real.
  • Identidades separadas e de curta duração para repositórios, registos e API. Não as suas credenciais de programador.
  • Fixe as versões dos plugins e trate os presets como código executável, porque é isso que são. Um preset é uma superfície da cadeia de fornecimento.
  • Aprovação humana nas operações sensíveis, em vez de confiar que o ciclo se controla a si próprio — sobretudo quando o próprio ciclo é um plugin substituível.
  • Testes adversariais contra instruções maliciosas no repositório, saídas de ferramentas envenenadas, descoberta de segredos e fugas por ligações simbólicas.

Se leu o nosso guia de segurança de agentes, nada disto é novo. O que é novo é que um harness tão componível alarga a superfície: cada camada substituível é um sítio onde o comportamento pode ser trocado.

5. É sobre-engenharia?

A crítica mais afiada em circulação não diz que o desenho está errado, mas que os seus custos estão mal distribuídos: a complexidade e o custo adicional de tokens são pagos por todos os utilizadores, enquanto o benefício de trocar o ciclo a quente em tempo de execução só chega a uma pequena parte deles.

O pormenor que a sustenta é concreto. Os plugins declarativos do Codex, baseados em pastas, recarregam em dois ou três segundos. Os plugins substituíveis em tempo de execução têm de tratar referências pendentes, terminar tarefas em curso e coordenar dependências — só o módulo de gestão do ciclo de vida tem 750 linhas. É complexidade real em troca de uma capacidade que a maioria das equipas vai configurar uma vez e nunca mais tocar.

A minha leitura: a crítica tem razão sobre quem paga e não tem razão ao tratar isso como desqualificante. A infraestrutura demasiado flexível para o caso de uso de hoje é a forma de descobrir qual será o do próximo ano. Mas não deve pagar essa fatura com um prazo de produto em cima, e «talvez venhamos a precisar disto» não é razão para o correr sobre código de produção este trimestre.

Os benchmarks são, além disso, divulgados pela própria empresa. Os 87,9 do V4-Pro no Terminal Bench 2.1 e os 62,7 no DeepSWE não foram reproduzidos de forma independente, e a DeepSeek já foi criticada no passado por resultados divulgados pelo próprio fornecedor que não era possível reproduzir.

6. O sinal de maturidade que as pessoas ignoram

A versão é a 0.1.0-rc.5. Nada está etiquetado. O README avisa em maiúsculas sobre alterações que vão quebrar a compatibilidade.

É o projeto a dizer-lhe, na linguagem mais clara de que dispõe, para ainda não construir nada crítico em cima dele. Um repositório pode ter 92 700 estrelas e continuar a ser infraestrutura anterior à 1.0 — são factos sem relação entre si, e confundi-los é como as equipas acabam presas a uma release candidate que já não existe.

7. O que eu faria de facto este mês

Vale a pena já

Faça um piloto contido em tarefas estreitas e reversíveis — geração de testes, refactorings limitados — num ambiente dedicado com regras de saída. Meça o seu próprio consumo de tokens face ao seu harness atual, em vez de confiar no múltiplo de quem quer que seja, incluindo o deste artigo.

Vale a pena copiar já

A invariante «o que o modelo vê fica registado». Pode adotá-la no harness que já usa, esta semana, sem adotar mais nada daqui. É a melhoria duradoura mais barata de todo o lançamento.

Vale a pena esperar

Uma primeira versão etiquetada e a estabilização das interfaces. A reprodução dos benchmarks por terceiros. Uma abordagem ao sandbox que cubra o tráfego de rede de saída. Três a seis meses é um prazo razoável antes de reavaliar.

Não vale a pena

Torná-lo o plano de controlo de produção, ou aproximá-lo de qualquer operação autónoma perante clientes, só pelo embalo do momento. O próprio projeto não afirma estar pronto.

O resumo honesto

O DeepSeek Harness é o mais ambicioso em arquitetura dos três harnesses lançados este mês, e o menos maduro. Recusa a escolha entre portátil e codesenhado que os outros dois impunham, o que é genuinamente interessante, e faz da rastreabilidade uma garantia estrutural em vez de um hábito, o que é genuinamente útil.

Também gasta cerca de dez vezes os tokens da alternativa mais leve, encaminha os seus gastos para um modelo cuja saída acabou de ficar duas a quatro vezes mais cara, e traz um sandbox que não impede um agente de falar com a internet.

Faça o piloto numa caixa com a rede fechada. Copie já a ideia do registo. Volte ao resto quando houver algo etiquetado a que voltar.

Fontes: Pré-visualização para programadores do DeepSeek Harness · DeepSeek V4-Pro em GA, harness e preços de ponta · The New Stack, sobre a arquitetura de plugins · TechNode, sobre o posicionamento face ao Claude Cowork · Resumo do lançamento pela MarkTechPost · Justin3go, a crítica de sobre-engenharia e as medições de tokens · Wavect, prontidão para produção e âmbito do sandbox · AIToolsReview, análise da licença, das camadas e dos preços

IdeaToMVP Academy

Want to build with AI — not just read about it?

4-week live cohort for founders. Learn to ship AI agents, scope MVPs, and automate your business — taught by the same team that writes these guides.

Explore the Academy →
Share this post :