DeepSeek Harness: o runtime de agentes em que tudo é plugin

O DeepSeek Harness, também chamado de dsh, é um runtime open source para desenvolvedores que criam e operam agentes de IA. Licenciado sob MIT, o projeto está em prévia para desenvolvedores. Em vez de entregar um produto de agente fechado ou um novo modelo fundacional, ele oferece um ambiente no qual as partes de um agente podem ser escolhidas e montadas. As fontes disponíveis situam o lançamento da versão 0.1 em 13 de agosto de 2026, e não em setembro. 12

A proposta central: não há um núcleo privilegiado

No Harness, a ideia de que “tudo é um plugin” é literal. Adaptadores de modelo, ferramentas, habilidades, sessões, sandboxes, armazenamento, agendamento, o loop do agente e a interface podem ser trocados ou recompostos por configuração. Em vez de alterar uma implementação central, a extensão do runtime ocorre com a montagem de um plugin ao lado dos componentes existentes. 221

Na prática, isso é útil quando o agente precisa usar outro provedor de modelo, um conjunto mais restrito de ferramentas, uma política própria de aprovação ou um ambiente de execução diferente. Essas escolhas podem ser definidas na composição do runtime, sem manter um fork do projeto ao longo do tempo.

O papel do Cordis

O sistema é construído sobre o Cordis, framework de plugins incorporado ao Harness. Um plugin adiciona serviços, eventos tipados e efeitos reversíveis a um contexto compartilhado. Quando ele é descarregado, seus registros também podem ser desfeitos. 2122

O Cordis também oferece composição orientada por dependências. Um callback registrado para serviços necessários é descarregado e executado novamente se um desses serviços mudar; já ctx.plugin carrega um plugin com uma configuração validada pelo esquema que ele declara. 19

Para quem desenvolve extensões, isso cria pontos claros de personalização. Um plugin de ferramenta pode se registrar em ctx.tools, enquanto um gancho anterior à execução pode devolver uma decisão tipada de permitir ou negar. O mesmo ponto de extensão pode atender a políticas de permissão, sandbox e modo de planejamento. 17

Quatro modos de runtime prontos para começar

O Harness inclui quatro presets iniciais para tarefas distintas de desenvolvimento: 2

• Standard: fornece o fluxo completo e o conjunto de ferramentas de um agente de programação.
• Code: expõe ferramentas por meio de um SDK do Code Mode, permitindo que TypeScript gerado pelo modelo coordene tarefas de várias etapas.
• Minimal: disponibiliza um shell persistente e str_replace_editor, sendo útil em ambientes restritos e em benchmarks.
• Creator: acrescenta inspeção do runtime e experimentação de plugins em memória para quem cria novos presets.

Esses modos são pontos de partida, não limites permanentes. A arquitetura de plugins foi pensada para permitir que equipes substituam ou adicionem capacidades à medida que os requisitos mudam. 221

Instalação e primeiros passos

O Harness é distribuído como pacote npm e CLI @deepseek-ai/dsh. O início rápido documentado é:

npx @deepseek-ai/dsh web

Também é possível clonar o repositório de código-fonte para executar o projeto diretamente da fonte ou trabalhar no código-base. 130

Na interface web, configure uma credencial de modelo em Settings → Models e, depois, selecione um espaço de trabalho antes de montar as tarefas. O processo dsh usa como localização padrão do sistema de arquivos o diretório de onde foi iniciado. Porém, uma interface recém-aberta não tem espaço de trabalho selecionado até que um seja adicionado. 25

Observabilidade faz parte do modelo de sessão

O Harness registra em um log de sessão somente de acréscimo tudo o que o modelo vê: prompts de sistema, raciocínio, chamadas de ferramentas e seus resultados, agendamento de subagentes e injeções de contexto. A visualização Trajectory permite inspecionar esses registros por origem; os recursos de retomar, bifurcar, buscar e reproduzir usam o mesmo fluxo de eventos. 2

Assim, o log vai além de um recurso de depuração. Ele se torna o registro para analisar uma execução, revisitar uma ramificação anterior e reproduzir a sequência de eventos do runtime que moldou o comportamento do agente.

Prévia para desenvolvedores exige disciplina de compatibilidade

O Harness é explicitamente uma prévia para desenvolvedores. Por isso, equipes não devem presumir uma promessa estável de compatibilidade de longo prazo para plugins e APIs. 26

Uma abordagem prudente é fixar a versão em uso, revisar as mudanças de cada lançamento, testar atualizações em um perfil ou espaço de trabalho isolado e reproduzir sessões representativas antes de uma adoção mais ampla. Trata-se de uma recomendação prática de controle de risco com base no status de prévia — não de uma garantia documentada de que toda atualização será incompatível ou compatível com versões anteriores.

A validação de plugins deve ocorrer em dois níveis:

1. Validar o plugin em si. Verifique o esquema de configuração, os serviços exigidos, o comportamento diante de falhas e a lógica de políticas para ferramentas.
2. Validar o preset composto. Teste o plugin com o adaptador de modelo, as ferramentas, o sandbox, as permissões, o armazenamento de sessão e os demais plugins com os quais ele efetivamente operará.

A configuração do Harness foi projetada para ajudar nesse processo. Uma entrada em cordis.yml pode conter um bloco config, e o plugin expõe um esquema validado antes de sua função apply ser executada; uma configuração inválida interrompe o carregamento, em vez de iniciar o plugin parcialmente configurado. 2728 O catálogo de configuração gerado é verificado com pnpm run verify-config-catalog. 18

Para distribuição, a documentação permite empacotar uma extensão como bundle instalável e adicioná-la a um perfil com dsh plugin add. Manter bundles e configurações de forma explícita torna um runtime composto mais fácil de reproduzir, auditar, testar e atualizar. 24

Em resumo

O DeepSeek Harness é, acima de tudo, infraestrutura para quem constrói agentes: um runtime em que a conexão com o modelo, as ferramentas, as políticas, o ambiente de execução, o loop, o estado e a interface são escolhas de composição. O Cordis fornece o ciclo de vida dos plugins; os modos de runtime entregam padrões utilizáveis; e o log de sessão somente de acréscimo mantém um registro operacional detalhado. A flexibilidade é seu principal atrativo, enquanto o status de prévia para desenvolvedores torna testes criteriosos e práticas de atualização essenciais. 221