Guia · Atualizado em 10 de novembro de 2026 · Por Cameron Voss e West Mao

DeepSeek SuperAgent no Windows: WSL vs configuração nativa do Windows (novembro de 2026)

Escolha uma rota do Windows, entenda os limites e verifique seu ambiente antes de instalar.

Resposta rápida

Para uma máquina Windows, o WSL 2 fornece ao protótipo um ambiente Linux mais próximo da configuração orientada para Unix publicada. O Windows nativo tem problemas de compatibilidade relatados pela comunidade; portas de terceiros são projetos separados. WSL ajuda na compatibilidade, mas não é um limite de segurança para o trabalho de agentes não confiáveis.

DeepSeek SuperAgent é um protótipo de pesquisa construído no DeepSeek Harness, não um produto oficial da DeepSeek ou software pronto para produção. Ele precisa de um provedor de modelo configurado separadamente. Este guia segue a documentação publicada; não executamos uma implantação completa para este artigo.

O DeepSeek Harness em execução no Windows não estabelece por si só que cada script de serviço do SuperAgent e fluxo de trabalho seja executado lá. Escolha o ambiente para todo o fluxo de trabalho: instalação, credenciais do GitHub, árvores de trabalho por ticket, supervisão e revisão do serviço.

Você deve escolher WSL 2, Windows nativo ou um host Linux separado?

Route	O que oferece	O que verificar
WSL 2	Ferramentas Linux e sistema de arquivos em uma máquina Windows; mais próximo do fluxo de trabalho tmux e Python publicado.	Montagens, interoperabilidade, credenciais e rede do Windows ainda podem expor recursos do host. Não testamos essa implantação de ponta a ponta.
Windows nativo	Ferramentas nativas do Windows e fluxo de trabalho de desktop.	Os relatórios da comunidade descrevem problemas de script de serviço, caminho e ferramenta de trabalho em versões específicas. Não presuma que uma configuração corrigida se aplica à sua versão.
Host Linux ou VM separado	Um local mais distinto para gerenciar o tempo de execução e as credenciais.	O isolamento depende da configuração da VM, das pastas compartilhadas, do acesso à rede e das credenciais. Uma VM não é automaticamente segura.

Por que a configuração original é estranha no Windows nativo?

O fluxo de trabalho do serviço publicado usa Python e tmux. Um usuário do Windows relatou que o script de serviço importa o módulo fcntl somente Unix, que alguma validação de diretório rejeitou caminhos de letras de unidade do Windows e que as sessões de trabalho não tinham as ferramentas esperadas em sua configuração específica. Esse relatório usou Windows 11 e DSH CLI 0.2.1-rc.3; isso não prova que todas as versões têm as mesmas falhas ou que seus patches locais são correções mantidas.

Portas e wrappers do Windows da comunidade podem alterar essas suposições. Trate-os como implementações de terceiros, revise seu código e permissões e verifique sua versão e status de manutenção antes de executá-los. Não testamos de forma independente uma porta nativa para este guia.

Como você prepara o WSL 2?

Em uma instalação compatível do Windows, abra o PowerShell como administrador e use o comando de instalação da Microsoft:

wsl --install

Conclua qualquer reinicialização solicitada e conclua a criação do usuário Linux. No PowerShell, wsl --list --verbose mostra as distribuições instaladas e sua versão WSL. Se o WSL já estiver instalado, inspecione primeiro seu estado atual, em vez de presumir que o comando cria um novo ambiente isolado.

Dentro da distribuição Linux, use versões Linux de Node.js, pnpm, Git, Python, tmux, GitHub CLI e DeepSeek Harness. Mantenha o clone funcional no sistema de arquivos Linux ao executar ferramentas Linux; o acesso entre sistemas de arquivos pode ser mais lento. Não coloque tokens pessoais ou segredos de produção no diretório inicial do usuário do serviço.

Como você mantém o host do Windows e os dados de teste separados?

WSL pode interagir com o Windows e acessar unidades montadas do Windows. Um nome de usuário Linux separado ou um repositório no diretório inicial do Linux reduz a mixagem acidental, mas não impede, por si só, o acesso ao host. Para código não confiável, use um ambiente gerenciado separadamente com isolamento deliberado, rede limitada e credenciais que possam ser revogadas com segurança. Verifique todas as pastas e montagens compartilhadas antes de conceder acesso a um trabalhador.

Dentro desse ambiente, crie um usuário GitHub dedicado para o agente e uma configuração CLI separada. Comece com um repositório de teste, um solicitante permitido e proteção de ramificação. O trabalhador executa com as permissões do sistema operacional do usuário do serviço, portanto, o acesso também deve ser limitado no nível do sistema operacional e da infraestrutura.

Qual é a sequência de configuração do WSL?

Abra o shell do Linux e verifique node -v, pnpm -v, git --version, python3 --version, tmux -V, gh --version e dsh --version.
Verifique os pré-requisitos atuais do protótipo e a faixa de versões do Harness. Configure um provedor de modelo e uma conta GitHub CLI de agente dedicado no ambiente.
Clone e construa o protótipo, crie o perfil dedicado para uma nova instalação e instale o pacote. Não execute o comando de criação de perfil em um perfil existente porque ele substitui sua configuração.
Configure o painel local, GitHub Source, solicitante permitido e preparação da árvore de trabalho do executor. Comece em observe para candidatos inferidos, com revisão humana e mesclagem automática desativadas.
Verifique scripts/dsh-superagent status e, em seguida, use uma pequena solicitação explícita no repositório de teste. Solicitações explícitas podem ser executadas em modo de observação.

Para obter o fluxo completo do problema até a revisão, use o guia de configuração e custo do SuperAgent existente. Uma verificação de dependência bem-sucedida é apenas um ponto de partida; verifique a criação do ticket, o espaço de trabalho, as permissões e a diferença resultante separadamente.

O que você deve verificar quando algo falha?

Sintoma	O que inspecionar
Erro `tmux` ou Python	Confirme que você está executando o script de serviço do Linux dentro do WSL, com as ferramentas necessárias do Linux instaladas.
Não GitHub resposta	Verifique o login do wrapper do agente, o acesso ao repositório, o solicitante permitido e o status da origem.
O ticket não pode preparar o checkout	Verifique se o caminho do clone do Linux existe e se o comando prepare usa o sistema de arquivos e as credenciais corretas.
O trabalhador não possui as ferramentas esperadas	Registre o DSH e as versões do pacote e inspecione a predefinição do worker. Um relatório do Windows observou isso em uma versão; não é um diagnóstico universal.
O painel não consegue acessar o serviço	Verifique se o processo está em execução e para onde o painel está vinculado. Evite expor um painel de gerenciamento local a uma rede sem controles apropriados.

Perguntas frequentes

WSL é uma sandbox?

Não. WSL e Windows podem interoperar; configure o isolamento real separadamente para trabalhos não confiáveis.

Este guia comprova suporte nativo do Windows?

Não. Ele descreve os requisitos publicados e os relatórios individuais da comunidade, não um teste nativo completo do Windows.

Posso usar minha conta diária do GitHub como agente?

O projeto recomenda uma conta de agente dedicada. Separe-o da sua identidade normal e conceda apenas o acesso necessário para o teste.

Veja os preços dos Coding Plans