Rodar um Agent de código em um repositório
Precisa ler e editar arquivos, executar Shell, pesquisar na web, e deixar o modelo concluir de forma contínua tarefas de engenharia em vários passos.
Prévia para desenvolvedores · MIT de código aberto · 2026-08
DeepSeek Harness: faça o modelo trabalhar de forma contínua em um ambiente real
DeepSeek Harness (dsh) não é um novo modelo de chat, e sim uma camada de execução Agent de código aberto. O modelo pensa; o Harness fornece as ferramentas, as sessões, o sandbox e os logs reproduzíveis. A fórmula é simples: Agent = modelo + Harness.
Página atualizada em 2026-08-18 · Compilada a partir das informações públicas da prévia para desenvolvedores oficial
O que é o DeepSeek Harness?
Separe primeiro o «modelo» e o «Harness», e só então decida qual camada instalar.
Agent = modelo + Harness
O modelo é a alma: raciocina, divide as tarefas e decide o próximo passo.
O Harness é as mãos e o canteiro: entende o ambiente, chama ferramentas e trabalha de forma contínua em um repositório real.
DeepSeek Harness é a infraestrutura de execução Agent que a DeepSeek disponibilizou em agosto de 2026 para desenvolvedores no mundo todo (prévia para desenvolvedores). O código-fonte é aberto sob licença MIT, o pacote npm se chama @deepseek-ai/dsh, e o repositório está no GitHub em deepseek-ai/deepseek-harness.
O que ele resolve não é «lançar mais um modelo que sabe conversar», e sim: o modelo já sabe raciocinar; como editar arquivos, executar comandos, chamar ferramentas, gravar logs em um diretório real, e retomar após uma falha. Sem Harness, na maioria das vezes você para na caixa de diálogo; com Harness, o modelo consegue executar de forma contínua dentro de limites controlados.
O lema oficial é «tudo é plugin». O caminho padrão ainda exige configurar uma DeepSeek API Key. O Web UI pode ser aberto de graça; de fato executar um Agent gera custos de chamadas ao modelo. Atualmente pertence à série de prévia v0.1, e plugins centrais e APIs podem sofrer alterações incompatíveis.
Quem deve usar o DeepSeek Harness?
Não é o mesmo tipo de entrada que o chat web deste site. Escolha a ferramenta conforme a tarefa.
-
-
Criar plugins ou presets personalizados
Quer substituir o modelo, as ferramentas, o sandbox ou a UI, e montar o próprio Agent, sem alterar o tronco do Harness.
-
Só quer abrir o navegador e conversar
Não é preciso instalar Node.js. Use a entrada web DeepSeek deste site e converse diretamente com o DeepSeek-V4.
Pontos de arquitetura: tudo é plugin
DeepSeek Harness se baseia em Cordis. O núcleo só cuida do carregamento e das dependências; todas as capacidades concretas vêm dos plugins.
-
01
Núcleo Cordis
Só se ocupa da montagem, desmontagem e das relações de dependência dos plugins. Não escreve a lógica de negócio do Agent no tronco, para evitar ter de fazer fork do repositório inteiro sempre que uma capacidade muda.
-
02
Todas as capacidades são plugins
Adaptadores de modelo, ferramentas, Skills, sessões, sandbox, armazenamento, loops, agendamento e interface podem se combinar como plugins e colaborar por serviços e eventos.
-
03
Recomposição na camada de configuração
Os desenvolvedores não precisam alterar o código-fonte do Harness: podem escolher, substituir ou estender qualquer capacidade na camada de configuração, e montar um Agent conforme o cenário.
Quatro modos de execução
O mesmo núcleo de plugins carrega por padrão combinações diferentes, cobrindo a codificação do dia a dia, chamadas programáticas a ferramentas, benchmarks e presets personalizados.
Modo padrão
Um Agent de código com funcionalidades completas.
Oferece edição de arquivos, Shell, busca de arquivos e web, Skills, planejamento, objetivos, subagentes e fluxos de trabalho. Adequado às tarefas cotidianas do repositório.
Modo PTC
Combinar várias rodadas de chamadas a ferramentas com um programa.
Inclui as capacidades do modo padrão e apresenta as ferramentas pelo Code Mode SDK, para o modelo orquestrar operações em vários passos com um programa TypeScript.
Modo mínimo
A menor superfície de ferramentas, para benchmarks.
Em geral conserva só bash persistente e edição de arquivos (str_replace_editor), para observar o modelo em um ambiente minimizado.
Modo criação
Inspecionar o runtime e criar presets personalizados.
Serve para ver os plugins atuais, experimentar plugins Cordis em memória e compor novos modos de execução.
Cada execução deixa rastros
As sessões são registradas como um fluxo de eventos somente acréscimo. Retomada, fork, busca e reprodução compartilham o mesmo log.
-
Prompts de sistema, cadeia de pensamento, chamadas a ferramentas e resultados são gravados no log da sessão
-
O despacho de sub-Agent e cada injeção de contexto podem ser consultados por origem
-
A visão Trajectory ajuda você a auditar o que o modelo viu e o que fez
-
Operações de alto risco devem vir com permissões e aprovação, em vez de entregar o repositório nu ao modelo
Começar a usar
Experiência rápida ou instalação a partir do código-fonte
É preciso ter Node.js já instalado na máquina. Os requisitos de versão seguem o README do repositório oficial.
Experiência rápida
Depois de instalar o Node.js, você pode iniciar o Web UI com npx. Por padrão, ele abre na porta local 3080: http://127.0.0.1:3080
$ npx @deepseek-ai/dsh webInstalação a partir do código-fonte
Obtenha o código-fonte completo do projeto e siga as instruções do repositório para concluir a instalação (pnpm install, pnpm run build, pnpm dsh web).
$ git clone https://github.com/deepseek-ai/deepseek-harnessConfigurar API Key e modelo
Na interface, configure uma DeepSeek API Key e escolha DeepSeek-V4-Flash ou DeepSeek-V4-Pro. Recomendamos testar primeiro com o Flash.
Indicar o workspace e as permissões
Escolha o diretório do repositório e restrinja as permissões de arquivos e comandos antes de atribuir tarefas. Na fase de prévia, comandos e configuração podem mudar: siga a documentação do repositório.
Qual a diferença entre o chat web e o Harness?
O chat web DeepSeek deste site resolve «abrir e conversar»; o Harness resolve «executar de forma contínua no repositório».
| Item de comparação | Chat web DeepSeek | DeepSeek Harness |
|---|---|---|
| O que você está procurando | Entrada de chat online sem instalação | Camada de execução Agent local / em nível de código-fonte |
| Usuários típicos | Estudo, escritório, escrita, perguntas e respostas | Desenvolvedores e quem cria Agent e plugins |
| Pode alterar arquivos do repositório? | Principalmente conversa | Pode ler e escrever arquivos e executar comandos dentro das permissões |
| Como começar | Abrir a entrada deste site no navegador | Iniciar o Web UI com npx ou clonar o código-fonte |
Perguntas frequentes sobre o DeepSeek Harness
Sobre licença de código aberto, custos, escolha de modelo e diferenças em relação ao chat web.
O DeepSeek Harness é um novo modelo oficial?
Não. É o framework de execução Agent de código aberto da DeepSeek (Harness), usado para conectar modelos, ferramentas, sessões e interface. O chat e o raciocínio continuam vindo de modelos como o DeepSeek-V4.
O DeepSeek Harness é gratuito?
O código-fonte do framework é aberto sob licença MIT e pode ser obtido de graça. Executar um Agent em geral chama a API da DeepSeek e gera custos de tokens. Siga os preços oficiais e o saldo da sua chave.
É a mesma coisa que o chat web DeepSeek deste site?
Não. O chat web é para abrir o navegador e conversar; o Harness é para desenvolvedores rodarem um Agent de código em um ambiente real. Se precisa conversar, use a entrada deste site; se precisa alterar código e executar ferramentas, use o Harness.
É preciso implantar um modelo grande na máquina para usar o Harness?
Não. O caminho comum na documentação pública é usar a API em nuvem da DeepSeek. Você precisa de Node.js, de uma API Key e de um navegador; não é obrigatório ter GPU própria.
Já pode ser usado em produção?
A documentação oficial marca como prévia para desenvolvedores e indica que haverá alterações incompatíveis. Serve para aprendizado, experimentos e desenvolvimento de plugins. Avalie você mesmo a estabilidade antes da produção e fixe uma versão que tenha verificado.
O que é dsh e como iniciar?
dsh é a abreviação usual e o nome CLI do DeepSeek Harness. Depois de instalar o Node.js, execute npx @deepseek-ai/dsh web. O Web UI abre por padrão em http://127.0.0.1:3080.
Separe primeiro o cenário, depois escolha a entrada
Para conversar agora, abra o chat web DeepSeek; para rodar um Agent no repositório, use o DeepSeek Harness oficial.
Esta página é compilada pelo site DeepSeek-V4 a partir da página oficial de Harness da DeepSeek e do repositório no GitHub, para facilitar a busca e a comparação. Não é um site oficial da DeepSeek. Instalação, configuração e compatibilidade seguem a documentação oficial e o README do repositório.