DeepSeek Harness no Windows: sem aplicativo de desktop, sem problema — a forma oficial de executá-lo

There is no official DeepSeek Harness desktop app for Windows, and you do not need one. DeepSeek Harness (dsh) — the open-source agent runtime DeepSeek released under an MIT license on 2026-08-13 — is a Node.js tool that runs a local web server you open in your browser, with a headless CLI for the terminal as the alternative. On Windows the whole setup is two commands: install Node.js 22.19 or newer (Node 24 LTS is the safer pick), then run npx @deepseek-ai/dsh web and open http://127.0.0.1:3080. Every "DeepSeek Harness Desktop" repository on GitHub is an unofficial community wrapper around that same two-command setup — useful to some people, but not required. It is also the harness DeepSeek uses to produce the agentic coding results it reports for DeepSeek V4 Pro and DeepSeek V4 Flash, which is why the two models keep showing up in any conversation about it.

Se você pesquisou "deepseek harness windows", provavelmente está olhando para uma página desses repositórios wrapper e se perguntando qual instalar. Este artigo responde à pergunta real por trás da pesquisa: o que DeepSeek Harness realmente é, a forma oficial de executá-lo no Windows atualmente, as alternativas de terminal e as ressalvas honestas de usar uma ferramenta em estágio de pré-visualização. É um guia prático, não um post de lançamento — o lançamento e o rastro do vazamento são abordados em artigos separados.

O que o DeepSeek Harness é (e o que não é)

O DeepSeek Harness não é um modelo e não avalia nenhum. Ele é o runtime do agente: a camada que conecta um modelo a ferramentas, arquivos, um shell e à internet — lendo seu código, planejando mudanças, executando comandos e iterando até concluir a tarefa. A arquitetura está declarada em seu slogan: "Tudo é um Plugin." Modelos, ferramentas, habilidades, sessões, sandboxes, o próprio loop do agente e até a interface web são plugins compostos na inicialização, construídos sobre o meta-framework Cordis — o mesmo núcleo por trás do ecossistema de chatbot Koishi. Uma implantação padrão inclui mais de 150 plugins.

É também enfaticamente uma prévia. dsh está na versão 0.1.0-rc.6, o README a rotula como uma prévia para desenvolvedores, e adverte em maiúsculas que "HAVERÁ MUDANÇAS QUE QUEBRAM A COMPATIBILIDADE." Nada disso desacelerou a adoção: o projeto alcançou cerca de 50.000 estrelas no GitHub nas primeiras 12 horas de sua divulgação em 2026-08-13, e estava em aproximadamente 126.000 em 2026-08-16 — o lançamento de código aberto mais rápido que a DeepSeek já publicou.

A resposta curta: o caminho oficial do Windows é dois comandos.

O README oficial do DeepSeek dá o caminho de execução no Windows em uma linha: instale o Node.js e depois execute npx @deepseek-ai/dsh web. Concretamente, os passos são:

• Instale Node.js 22.19+ ou Node 24. A versão atual do dsh exige Node 22.19 ou mais recente; Node 24 LTS é a escolha mais segura no Windows, e o motivo é prosaico — versões mais novas do Node incluem descompressão zstd nativa, que o dsh usa para ler seus logs de sessão compactados. Verifique sua instalação com node --version no PowerShell ou cmd.

• Run the harness. Either run it on the spot with npx @deepseek-ai/dsh web, or install it once with npm install -g @deepseek-ai/dsh and then run dsh web from any folder afterwards. The first run prints the URL and starts the Web UI at http://127.0.0.1:3080.

• Abra esse endereço no seu navegador. A interface da Web é um aplicativo web local — é por isso que não há aplicativo de desktop; o navegador é o aplicativo de desktop.

• Adicione uma chave de modelo uma vez. Na interface da Web, abra Configurações → Modelos, cole uma chave de API da DeepSeek e salve. Ela entra em vigor imediatamente, sem reiniciar o servidor. O dsh usa a pasta em que você o iniciou como local padrão do sistema de arquivos, e a etapa Escolher espaço de trabalho da interface permite apontá-lo para qualquer diretório de projeto.

Esse é todo o caminho oficial. Se uma máquina já tiver o Node 22+ instalado, o tempo de "nada" até "agente em execução" é inferior a um minuto.

Por que todo repositório "DeepSeek Harness Desktop" é um wrapper

Os resultados da página 1 para esta consulta são todos wrappers de desktop da comunidade — shells Electron, Tauri e WebView2 que empacotam um runtime Node e iniciam a interface web oficial em uma janela emoldurada. Eles não são produtos DeepSeek e não adicionam capacidade de harness; eles adicionam um lançador. O que eles têm em comum:

Eles são iniciados com duplo clique e evitam totalmente a linha de comando, que é o seu verdadeiro ponto de venda.

• Eles não são assinados, então o Windows SmartScreen exibirá um aviso na instalação — "Mais informações → Executar mesmo assim" faz parte do fluxo.

• Eles acompanham o projeto oficial em ritmos diferentes: alguns fixam a versão 0.1.0-rc.5, outros a 0.1.0-rc.6, alguns seguem o master, então a versão do wrapper e a versão do harness divergem com o tempo.

• Eles armazenam os mesmos dados locais que o dsh sempre usa em ~/.dsh, então alternar entre um wrapper e a CLI oficial não redefine suas sessões.

Quando um wrapper vale a pena? Quando o fator decisivo é "dar duplo clique num ícone, ver uma bandeja, nunca tocar num terminal", e você aceita que um terceiro agora é a camada de atualização e segurança na frente de uma ferramenta em fase de pré-visualização. Quando não vale? O caminho oficial são dois comandos e uma aba do navegador — se você já tem Node, um wrapper lhe dá um lançador que você talvez nem precise, e adiciona sua própria superfície de manutenção em troca.

A rota do terminal: plugins headless de CLI e TUI

Se o navegador não é onde você trabalha, o dsh também tem uma história no terminal, dividida em dois modos.

Headless é o perfil não interativo: dsh --profile headless "summarize this repository" executa uma tarefa sem interface, imprime o resultado e sai — o modo amigável para CI. No Windows, este também é o modo que scripts e tarefas agendadas devem usar, porque não precisa de uma tela nem de uma sessão com login efetuado.

TUI é uma interface de terminal interativa no estilo do Claude Code, distribuída como conjuntos de plugins da comunidade em vez de no pacote principal. Pacotes como dsh-tui são instalados em um perfil com dsh plugin --profile tui add <package> e executados com dsh --profile tui; pelo menos um inclui um lançador .cmd para Windows. O detalhe que vale saber antes de tentar: uma TUI exige um terminal real tanto para entrada quanto para saída — se a sua configuração usar pipes ou redirecionamento, o dsh recusará e dirá para usar headless em vez disso.

As quatro predefinições: qual usar para cada trabalho

dsh inclui quatro predefinições de agente integradas, e elas não são uma escada de dificuldade — são quatro superfícies de ferramentas diferentes. Você define o padrão em ~/.dsh/settings.yaml sob agent-presets.default.

• Standard é o padrão: o agente completo do dia a dia — edição de arquivos, shell, pesquisa de arquivos e web, habilidades, subagentes, planejamento. É com ele que a maioria dos usuários do Windows deve começar.

• PTC (também chamado de Code mode) mantém tudo o que o Standard tem, mas muda a forma como as ferramentas são expostas: em vez de uma longa sequência de chamadas de ferramentas isoladas, o modelo escreve um programa TypeScript que compõe operações de várias etapas — loops, filtros, desvios condicionais. Para fluxos de trabalho complexos, repetidos ou de várias etapas.

• Minimal reduz deliberadamente o agente a duas ferramentas — um shell persistente e um editor de arquivos — e é voltado para avaliação e benchmarking, não para trabalho diário. Este é o preset no qual as próprias pontuações de agente da DeepSeek são executadas.

• Creation (Cordis) serve para construir presets personalizados: inclui inspeção em tempo de execução, experimentação de plugins em memória e orientação para criação de presets. Para mexer com o próprio harness.

MCP e replay de trajetória: por que vale a pena executar isso afinal

Duas funcionalidades justificam o uso do dsh em vez de um cliente de chat simples. Primeiro, um cliente Model Context Protocol (MCP) é integrado — um comando /mcp e uma aba MCP em Configurações conectam servidores MCP externos à plataforma, de modo que as mesmas ferramentas que seus outros agentes usam se conectam ao dsh. Segundo, cada execução é gravada em um log de sessão somente de acréscimo, e a visão Trajectory permite inspecionar uma execução por fonte, retomá-la, ramificá-la, pesquisá-la e reproduzi-la. Essa é a diferença entre depurar um agente olhando para sua resposta final e percorrer passo a passo o motivo de cada chamada.

Quando o caminho oficial é a resposta errada

• Você precisa de um clique, sem terminal.Não há instalador oficial. Se o duplo clique é inegociável, você está em wrappers da comunidade — que não são assinados, então pese a conveniência contra a superfície de manutenção de terceiros.

• Sua máquina Windows está antiga ou bloqueada. o dsh precisa do Node 22.19+ (ou Node 24). Em uma máquina gerenciada, isso significa uma instalação de runtime e possivelmente uma aprovação que você não tem.

• É uma prévia, e ela quebra. 0.1.0-rc.6 vem com um aviso de que mudanças que quebram estão por vir; entre builds rc, plugins e perfis podem parar de funcionar. Fixe sua versão para qualquer coisa scriptada.

• A conta do modelo é sua. dsh é gratuito; cada tarefa queima tokens na chave que você configurou. Um loop de agente relê arquivos e tenta novamente, e um modelo verboso em uma tarefa difícil pode gastar um orçamento surpreendente em uma tarde. É aqui que a escolha do modelo, não a da ferramenta, domina o custo.

• Uma assinatura fixa pode superar o roteamento por token. Se o seu uso está dentro do plano de um único lab e abaixo dos limites dele, a assinatura fixa geralmente é mais barata do que qualquer rota por token. O roteamento vence quando você mistura modelos ou quer failover — não por padrão.

Roteie o modelo atrás do harness.

O caminho nativo é a API própria da DeepSeek: cole uma chave em Configurações → Modelos e pronto. Mas o dsh também aceita uma URL base compatível com OpenAI — defina DEEPSEEK_BASE_URL no ambiente ou configure o provedor de LLM no settings.yaml — o que significa que o modelo por trás do harness pode ser trocado sem tocar no harness. Você pode rodar o DeepSeek V4 Pro para o refatoramento difícil e o DeepSeek V4 Flash para edições mecânicas baratas, na mesma instalação local do dsh.

Essa é a camada que o OrcaRouter ocupa. Uma única URL base compatível com a OpenAI, mais de 200 modelos, zero markup — preço de tabela do provedor repassado — e failover automático quando um provedor limita a taxa ou degrada. Aponte o dsh para ele e o harness permanece na sua máquina enquanto o catálogo de modelos vira uma decisão de roteamento em vez de uma compra. Duas ressalvas honestas: não hospedamos o dsh — ele roda localmente na sua máquina Windows — e somos apenas a camada de acesso aos modelos se você quiser modelos além da API da própria DeepSeek. E, para um único modelo pesado dentro dos limites do plano, a assinatura fixa geralmente é a opção mais barata, independentemente do roteador.

A versão curta

O DeepSeek Harness no Windows é uma configuração de dois comandos, não uma instalação por loja de aplicativos: Node 22.19+ (ou Node 24), depois npx @deepseek-ai/dsh web, e então seu navegador em http://127.0.0.1:3080. Os repositórios "desktop" do GitHub são wrappers não oficiais em torno desse mesmo servidor local. Para terminais, o headless executa tarefas únicas para CI, e os plugins TUI oferecem uma interface no estilo Claude Code. Quatro predefinições — Standard, PTC, Minimal, Creation — escolhem a superfície de ferramentas, e o MCP mais a reprodução de trajetória tornam isso genuinamente útil. É gratuito, de código aberto e em fase de pré-visualização: fixe a versão, observe a cobrança do modelo e roteie o modelo separadamente do harness.