O que é DeepSeek Harness?
O DeepSeek Harness (dsh) é o harness de agentes de código aberto da própria DeepSeek, lançado como prévia para desenvolvedores em agosto de 2026. Na configuração padrão, é um agente de programação e de trabalho geral que lê e edita arquivos em um workspace, roda comandos, delega a subagentes, mantém um plano e agenda tarefas recorrentes. Você o conduz por uma Web UI local (npx @deepseek-ai/dsh web), um app desktop oficial para macOS e Windows, um modo headless, um servidor ACP ou um SDK Python. Por baixo, tudo é plugin sobre o framework Cordis: adaptadores de modelo, ferramentas, o sandbox, o armazenamento de sessões, a UI e o próprio loop do agente podem ser trocados.
É TypeScript com licença MIT, com cerca de 267.000 estrelas e 32.000 forks no GitHub para um repositório criado em 13 de agosto de 2026, e o pacote npm @deepseek-ai/dsh foi baixado cerca de 680.000 vezes na semana até 29 de outubro de 2026. Não há versão estável: a mais recente é a release candidate v0.2.1-rc.5, de 30 de outubro de 2026, o README promete mudanças que quebram compatibilidade, e o aviso de segurança diz que o projeto não passou por auditoria de segurança. As issues do GitHub estão desativadas; o feedback vai para o Discussions, que reúne cerca de 11.500 tópicos.
DeepSeek Harness vale a pena?
O DeepSeek Harness é a forma séria mais barata de rodar um agente sobre os modelos da DeepSeek, e uma coisa arriscada de instalar em uma máquina que guarde algo que importe para você. O agente em si cobre o mesmo terreno que Claude Code, Codex e OpenCode. O argumento é a arquitetura: cada parte é um plugin, e o Creator mode deixa o agente escrever e instalar novos plugins para você. Uma comunidade se formou em semanas, e a lista awesome-dsh-plugin já conta 8.076 plugins.
Essa abertura também é o problema de segurança. Os plugins não rodam em sandbox. A documentação do Cordis os descreve como código confiável no mesmo processo, e instalar um pacote executa seu código no processo Host, e é por isso que o agente precisa de Full access ou da sua aprovação para fazê-lo. Ninguém verifica os plugins de forma centralizada: o DSH não traz índice de plugins, a aba Discover só lê os arquivos de índice que você adiciona, e a documentação adverte que títulos, autores e origens de um índice são afirmações não verificadas. Os mantenedores do awesome-dsh-plugin conferem se um plugin instala e faz o que sua linha descreve, e dizem com todas as letras que estar na lista não é uma revisão de segurança e que as aprovações de ferramentas não isolam o código dos plugins. O sandbox de comandos (bwrap, Seatbelt ou Landlock, parcial no Windows) e o modo padrão workspace-write com pedidos de aprovação controlam o que o modelo executa, não o que um plugin faz.
Ele não se limita à DeepSeek. Settings → Models aceita uma chave de API da DeepSeek ou login de conta, tem entradas de catálogo para provedores como Anthropic, OpenAI, Kimi e GLM, e aceita qualquer gateway que fale OpenAI Chat Completions, OpenAI Responses ou Anthropic Messages. A economia favorece a DeepSeek, porém. No pico, o deepseek-flash custa US$ 0,30 por milhão de tokens de entrada sem cache, US$ 0,006 com cache e US$ 1,20 de saída; o deepseek-v4-pro custa US$ 1,32, US$ 0,044 e US$ 3,96. As tarifas fora de pico são a metade, e as janelas de pico (01:00 às 04:00 e 06:00 às 10:00 UTC em dias úteis) caem no expediente chinês, então uma manhã europeia paga o preço cheio, enquanto o expediente americano fica inteiro fora de pico. Pelas nossas contas, uma sessão que lê 10 milhões de tokens de entrada, 90% deles em cache, e escreve 500.000 custa cerca de US$ 3,70 no V4 Pro no pico e cerca de US$ 0,95 no Flash. Busca e fetch na web, gratuitos até agora, passam a ser cobrados a US$ 0,75 por 1.000 requisições a partir de 1 de novembro de 2026.
Os padrões de dados merecem a atenção de quem compra. Na API oficial da DeepSeek, um plugin de log de sessão vem ativado por padrão e anexa o log completo da sessão, até 8 MiB por requisição, às requisições seguintes ao modelo; segundo a referência da CLI, esses envios podem incluir texto das mensagens, argumentos e resultados de ferramentas e caminhos do workspace. Ele é desligado em Settings → General. À parte, gravar um /feedback envia a sessão ao coletor da DeepSeek, a menos que DSH_TELEMETRY_MODE=DISABLED esteja definido. A política de privacidade da DeepSeek diz que ela coleta, processa e armazena dados pessoais na República Popular da China e lista o treinamento dos seus modelos entre as finalidades, e pela nossa leitura os termos da plataforma não oferecem opção de retenção zero nem de hospedagem regional. Apontar o DSH para outro provedor elimina essa preocupação, e a vantagem de preço junto.
A própria documentação da API da DeepSeek lista Claude Code, Codex e OpenCode como front ends compatíveis com seus modelos, então tokens baratos da DeepSeek não exigem o DSH. O OpenCode oferece a mesma liberdade de provedor em uma linha de versões estável, e Claude Code e Codex são construídos em torno dos modelos dos próprios fabricantes. O que o DSH acrescenta é um harness que você pode desmontar e remontar, ao preço de um software de prévia que o próprio aviso de segurança diz que não deve ser tratado como seguro.
Onde ele se destaca
Um desenvolvedor solo que já paga tokens da API da DeepSeek
Rodar um agente de programação o dia todo por alguns dólares
Rode npx @deepseek-ai/dsh web, adicione a chave de API e escolha um workspace. O deepseek-flash no pico custa US$ 0,30 por milhão de tokens de entrada sem cache, contra US$ 1,32 do V4 Pro, e mover jobs longos em lote para fora do pico corta qualquer uma das contas pela metade.
Um engenheiro de plataforma criando um agente interno para uma equipe de produto de 40 pessoas
Lançar um agente da empresa com ferramentas, regras de aprovação e armazenamento de sessões próprios, sem fazer fork de uma base de código
Escreva plugins Cordis e publique-os em um registro npm privado ou em um arquivo de índice da equipe servido por https, que o gerador de referência monta a partir de uma lista simples. Fixe uma release candidate, porque a prévia promete mudan ças incompatíveis, e reserve tempo para testar de novo a cada atualização.
Um líder de segurança em uma fintech europeia a quem perguntaram se a equipe pode instalar o DSH
Decidir qual configuração, se alguma, é aceitável
Exija uma VM ou contêiner descartável, como recomenda o aviso de segurança, encaminhe os modelos por um gateway aprovado que não seja da DeepSeek ou desligue o envio de logs de sessão, defina DSH_TELEMETRY_MODE=DISABLED e permita plugins apenas de um índice interno. O software é gratuito; a revisão e a questão da residência dos dados são o custo real.
Um pesquisador de avaliação rodando benchmarks de agentes
Rodar muitas tarefas de agente isoladas a partir de Python
pip install deepseek-harness-sdk inclui o runtime, então não é preciso Node.js no sistema. O perfil sdk-minimal roda no modo danger-full-access, então cada tarefa precisa do próprio workspace, ID de sessão e contêiner.
Antes de decidir
- Configuração
- npx @deepseek-ai/dsh web precisa de Node.js e abre a Web UI em 127.0.0.1:3080; adicione uma chave da DeepSeek em Settings → Models e escolha um workspace. As builds desktop oficiais cobrem Macs com Apple silicon e Windows de 64 bits. O SDK Python é o deepseek-harness-sdk; o nome deepseek-harness no PyPI pertence a um projeto sem relação. Vincular a Web UI a 0.0.0.0 não é suportado.
- Integrações
- DeepSeek por chave de API ou login de conta, provedores de catálogo incluindo anthropic, openai, moonshotai e zai, e gateways personalizados via OpenAI Chat Completions, OpenAI Responses ou Anthropic Messages; MCP, LSP, ACP, modo headless e um SDK Python. Plugins são instalados a partir de npm, Git ou tarballs com dsh plugin add. Os índices da comunidade incluem awesome-dsh-plugin e dsh-market; o DSH Desktop da anywhere-labs (cerca de 34.300 estrelas) é um cliente não oficial que declara não ter vínculo com a DeepSeek, e o coeasy/dsh-go é um marketplace de duas estrelas que propõe níveis de confiança para publicadores assinados.
- Dados e privacidade
- Na API oficial da DeepSeek, o log completo da sessão, até 8 MiB por requisição, é anexado por padrão às requisições ao modelo (opção em Settings → General). O /feedback envia a sessão ao coletor da DeepSeek, a menos que DSH_TELEMETRY_MODE=DISABLED. A política de privacidade da DeepSeek coloca o armazenamento de dados pessoais na República Popular da China. As sessões ficam guardadas localmente como JSONL em $DSH_HOME; as chaves ficam em $DSH_HOME/.credentials.yaml.
- Custo em escala
- O harness é gratuito e não tem edição paga ou enterprise. Na DeepSeek, o custo é de tokens: uma sessão que lê 10 milhões de tokens de entrada (90% em cache) e escreve 500.000 custa cerca de US$ 3,70 no V4 Pro no pico ou US$ 0,95 no Flash, metade disso fora de pico. Busca e fetch custam US$ 0,75 por 1.000 requisições a partir de 1 de novembro de 2026; os limites de concorrência são 2.500 para o Flash e 500 para o V4 Pro.
- Limites
- Pré-1.0, com release candidates a cada poucos dias e mudanças incompatíveis prometidas; sem auditoria de segurança; o sandbox no Windows é parcial. As issues estão desativadas, então os relatos de bugs ficam entre cerca de 11.500 tópicos do Discussions. Nenhum aviso de segurança foi publicado, o que para um projeto de 11 semanas diz pouco.
O que é bom
- Cada parte, até o loop do agente, pode ser trocada como plugin
- Funciona com Anthropic, OpenAI e qualquer gateway compatível, não só com a DeepSeek
- Tokens da DeepSeek a partir de US$ 0,30 por milhão de entrada sem cache, metade disso fora de pico
- Web UI, app desktop, modo headless, ACP e um SDK Python a partir de uma única base de código
O que não é
- Prévia para desenvolvedores sem auditoria de segurança e com mudanças incompatíveis prometidas
- Os plugins rodam sem sandbox no processo host, sem verificação central
- Os logs de sessão vão por padrão para a DeepSeek na API oficial
- A política de privacidade da DeepSeek coloca o armazenamento dos dados na China
Ideal para
Desenvolvedores na API da DeepSeek que querem um agente que possam reconstruir a partir de plugins, rodando em uma máquina ou VM sem nada sensível.
Alternativas ao DeepSeek Harness
DeepSeek Harness: perguntas frequentes
- DeepSeek Harness vale a pena?
- Tokens baratos da DeepSeek e um harness que você pode reconstruir peça por peça, embrulhados em código de prévia sem auditoria que envia por padrão os logs das suas sessões para a DeepSeek. Damos nota 3.7 de 5.
- Quanto custa DeepSeek Harness?
- Gratuito e de código aberto (MIT); você paga o uso do modelo. Na API da DeepSeek no horário de pico, o deepseek-flash custa US$ 0,30 por milhão de tokens de entrada sem cache e US$ 1,20 por milhão de tokens de saída, e o deepseek-v4-pro US$ 1,32 e US$ 3,96; as tarifas fora de pico são a metade.
- Quais são as desvantagens de DeepSeek Harness?
- Prévia para desenvolvedores sem auditoria de segurança e com mudanças incompatíveis prometidas; os plugins rodam sem sandbox no processo host, sem verificação central; os logs de sessão vão por padrão para a DeepSeek na API oficial; a política de privacidade da DeepSeek coloca o armazenamento dos dados na China.
- Para quem DeepSeek Harness é indicado?
- Desenvolvedores na API da DeepSeek que querem um agente que possam reconstruir a partir de plugins, rodando em uma máquina ou VM sem nada sensível.
- Quanto custa DeepSeek Harness para uma equipe ou em produção?
- O harness é gratuito e não tem edição paga ou enterprise. Na DeepSeek, o custo é de tokens: uma sessão que lê 10 milhões de tokens de entrada (90% em cache) e escreve 500.000 custa cerca de US$ 3,70 no V4 Pro no pico ou US$ 0,95 no Flash, metade disso fora de pico. Busca e fetch custam US$ 0,75 por 1.000 requisições a partir de 1 de novembro de 2026; os limites de concorrência são 2.500 para o Flash e 500 para o V4 Pro.
- DeepSeek Harness é seguro para dados da empresa?
- Na API oficial da DeepSeek, o log completo da sessão, até 8 MiB por requisição, é anexado por padrão às requisições ao modelo (opção em Settings → General). O /feedback envia a sessão ao coletor da DeepSeek, a menos que DSH_TELEMETRY_MODE=DISABLED. A política de privacidade da DeepSeek coloca o armazenamento de dados pessoais na República Popular da China. As sessões ficam guardadas localmente como JSONL em $DSH_HOME; as chaves ficam em $DSH_HOME/.credentials.yaml.
- Quais são as melhores alternativas ao DeepSeek Harness?
- As alternativas mais próximas que analisamos são OpenCode, OpenAI Codex CLI, Cline e Aider.
Respostas verificadas em 31 de out. de 2026.
