O DeepSeek Harness é a forma mais rápida de rodar localmente um agente de programação baseado em plugins, e seu verdadeiro poder está no ecossistema: um único comando instala skills do GitHub, um market da comunidade adiciona skins e plugins de memória, e a limpeza é simplesmente apagar uma pasta. Este guia percorre as três operações que realmente importam — instalar uma Skill, pegar plugins no market e remover tudo de forma limpa — para que você vá do zero a um harness personalizado em cerca de dez minutos.
Por que a camada de plugins é a parte que realmente conta
O DeepSeek Harness (dsh) é o runtime de agentes open-source da DeepSeek, construído sobre o microkernel Cordis, e seu lema é “tudo é um plugin”: o adaptador de modelo, as ferramentas, as skills, as sessões, o sandbox, o armazenamento, o agendador e até a interface que você vê são todos plugins. Essa arquitetura transforma personalização em instalação. Em vez de fazer um fork do repositório para mudar o comportamento, você adiciona ou remove plugins com um comando ou uma mensagem no chat, e os efeitos colaterais são rastreados para que as desinstalações sejam limpas.
Inicie com um único comando antes de qualquer coisa
Você só precisa do Node.js 18+ na máquina. O comando npx inicia uma web UI em http://127.0.0.1:3080 e a abre no seu navegador:
npx @deepseek-ai/dsh web
Se preferir um cliente desktop, o build da comunidade feito pela Anywhere Lab (cerca de 14.000 estrelas no GitHub) empacota a mesma Web UI e adiciona um ponto de entrada para o market de plugins. Rodar a partir do código-fonte também funciona, mas para experimentos com plugins o caminho via npx mantém tudo descartável. Veja nosso quickstart do DeepSeek Harness para o passo a passo completo da primeira execução.
Instale uma Skill direto de um link do GitHub
Skills são a forma mais fácil de estender o harness — são pacotes simples de prompt mais fluxo de trabalho com um SKILL.md, e você não precisa clonar nada. Encontre uma skill que queira, cole a URL do GitHub dela no chat e peça ao dsh para instalá-la. Um tutorial da comunidade demonstra isso com o ppt-master, uma skill de geração de PowerPoint: enviar a URL do SKILL.md faz a instalação, e um prompt seguinte como “crie uma apresentação sobre este tema” entrega todo o fluxo de design ao agente.
# equivalente no terminal para instalações de plugins
dsh plugin --profile web add github:csyangwen/dsh-memory-evolve
Desde a atualização 0820, os comandos /goal e /plan também aceitam imagens e referências de arquivos pelo menu @, então você pode anexar capturas de tela diretamente em tarefas orientadas por skills — desde que o adaptador de modelo suporte visão (veja a nota abaixo).
Explore o market de plugins e skins
Além das skills, a comunidade publica skins de interface e plugins de memória. O site dsh-skin-market lista 189 plugins de skin — portais retrô, temas de fundo do mar, notas adesivas e mais — todos instaláveis de dentro da Web UI. Plugins de memória como o dsh-memory-evolve trocam o cabeçalho simples de chat/trajectory por um dashboard com skills, todos e memória persistente. Não há uma loja central para se cadastrar; você adiciona plugins por referência do GitHub e o kernel Cordis cuida do carregamento, da resolução de dependências e do descarregamento reversível.
Desinstalação: três cenários, sem resíduos
- Execução via npx: nada foi instalado globalmente. Feche o terminal ou encerre o processo e o serviço para — não é preciso npm uninstall.
- Clone do código-fonte: pare o serviço e apague a pasta deepseek-harness.
- Cliente desktop: desinstale como qualquer aplicativo comum.
Para apagar também as sessões, as configurações e as credenciais, remova o diretório ~/.dsh. Essa é toda a história da limpeza.
Dicas práticas
- Combine o modelo com a tarefa: o DeepSeek-V4-Pro é apenas texto, então prompts multimodais falham com o adaptador padrão. A atualização rc.8 conectou a entrada de imagens ao pipeline do harness; você ainda precisa de um modelo com suporte a visão (por exemplo, via ponte dsh-vision) para realmente enxergar. Detalhes no nosso artigo sobre multimodal do rc.8.
- Use o modo criativo para experimentos de UI: os plugins de skin e de interface se comportam melhor quando você alterna o harness para o modo criativo antes de iterar.
- Espere mudanças que quebram compatibilidade: o projeto está em developer preview; fixe as versões dos plugins se for construir em cima deles.
- Delegue a instalação: você pode entregar a URL do repositório ao Codex ou ao WorkBuddy e deixar um agente instalar o dsh para você — o primeiro passo para aprender uma ferramenta agora pode ser delegar o aprendizado.
FAQ
Preciso de uma GPU ou de hardware especial para rodar o DeepSeek Harness?
Não. O harness em si roda em Node.js 18+ e é independente de hardware; a inferência do modelo acontece na API da DeepSeek, não na sua máquina.
O DeepSeek Harness consegue ver imagens?
Desde a atualização 0820/rc.8, o pipeline de entrada aceita imagens no chat, no /goal e no /plan — mas somente se o adaptador de modelo suportar visão. O DeepSeek-V4-Pro não suporta, então combine-o com um modelo de visão compatível com OpenAI (por exemplo, via plugin dsh-vision) para tarefas com imagens.
Como removo o DeepSeek Harness completamente?
Encerre o processo (a execução via npx não instala nada globalmente), apague a pasta do projeto se você clonou o código-fonte e remova ~/.dsh para limpar sessões, configurações e credenciais.
Recursos
- deepseek-ai/deepseek-harness (MIT)
- dsh-skin-market — 189 plugins de skin
- tópico dsh-plugin no GitHub
- skill ppt-master