Descrição geral
O DeepSeek Harness é suportado nativamente no App Catalog do ZimaOS e toda a configuração demora apenas alguns minutos. Consulte a página do DeepSeek Harness na App Store para conhecer os detalhes mais recentes da app.
O DeepSeek Harness (dsh) é o agente de IA de código aberto da DeepSeek — pense nele como um programador prestativo que vive no seu servidor doméstico. Fala com ele no navegador, descreve o que quer, e ele planeia e faz o trabalho numa pasta do seu NAS. Não é preciso saber programar: o agente trata da parte técnica por si.
Instalado no ZimaOS, funciona 24/7 no seu próprio hardware. Controla-o a partir do telemóvel através do ZimaClient e os seus projetos ficam nas suas unidades, não na nuvem.
Pré-requisitos
- Um servidor doméstico ZimaOS em funcionamento.
- Hardware mínimo: um CPU de dois núcleos e pelo menos 2 GB de memória.
- Uma chave API de qualquer fornecedor de modelos de IA — DeepSeek, OpenAI (GPT), Anthropic, OpenRouter ou qualquer outro fornecedor de terceiros funcionam, tal como modelos de inferência local no seu próprio hardware (abordado no próximo tutorial desta série). Obtenha uma chave num minuto na secção Adicionar um fornecedor de modelos abaixo.
App Catalog
- Encontre o DeepSeek Harness no App Catalog do ZimaOS. Abra a App Store → procure por “DeepSeek Harness”.
- Clique em Instalar e aguarde um momento.
- Está pronto a usar!
Autorize um diretório de dados
O agente precisa de uma pasta nas suas unidades para guardar os workspaces. Faça isto logo após a instalação:
No cartão da app, clique no menu de opções no canto superior direito para abrir as definições do contentor.
Na secção Volumes (ou mapeamento de caminhos), adicione uma regra de volume: defina o Caminho do contentor como
/root/e o Caminho do host como a pasta que quer usar para os dados do agente, por exemplo/media/SSD-Storage/DSH.
- Reinicie o contentor — não é preciso reiniciar o NAS. A partir de agora, todos os workspaces que o agente criar ficam diretamente nessa pasta das suas unidades.
Crie o seu primeiro workspace
Abra o DeepSeek Harness a partir do cartão da app — o navegador mostra a Web UI. Crie o seu primeiro workspace; graças à autorização de pasta acima, tudo o que o agente cria é guardado diretamente nas suas unidades.
Adicione um fornecedor de modelos
Vá a Definições > Modelos e adicione um fornecedor, depois cole a sua chave API:
- DeepSeek — registe-se na plataforma DeepSeek e copie a sua chave
- GPT (OpenAI) — a sua chave da OpenAI
- OpenRouter — uma chave para muitos modelos
- Um servidor de modelos no seu próprio hardware — abordado no próximo tutorial desta série
A sua primeira tarefa
Agora dê ao agente o seu primeiro trabalho real. Descreva a app que quer por palavras simples — o exemplo abaixo pede um monitor de recursos que mostre em tempo real a CPU, a memória, o disco e a rede do seu host ZimaOS, a correr como uma app em contentor.
Veja-o trabalhar: a sessão mostra o plano, o código e o resultado — sem escrever uma única linha.
Após algumas rondas de conversa, o agente transforma a ideia numa app real — sem precisar de conhecimentos de programação. O resultado é um gestor de recursos ao nível do sistema que funciona dia e noite, vigiando a saúde do disco, a segurança da rede e o ciclo de vida dos contentores no seu ZimaOS.
Aceda ao DeepSeek Harness via telemóvel
Aceda ao DeepSeek Harness através da app móvel ZimaClient — ligação P2P direta ao seu servidor doméstico, sem relay na nuvem e sem configuração de VPN. Funciona em casa ou em viagem.
 |
 |
|---|
Com a ligação P2P pode verificar o progresso do seu agente e todos os seus serviços alojados em qualquer altura e lugar — a mesma Web UI, diretamente no seu telemóvel.
O seu servidor doméstico é agora um agente
É toda a configuração. O seu servidor doméstico deixou de ser apenas uma caixa de armazenamento — é um agente físico que vive no seu próprio hardware:
- Controle a partir do telemóvel — abra a Web UI através do ZimaClient em qualquer lugar e verifique sessões, reveja resultados ou envie uma nova tarefa. O seu agente está a um toque, em casa ou fora.
- Vibe coding sem escrever código — descreva uma funcionalidade por palavras simples e deixe o agente planeá-la e escrevê-la num workspace que vive nas suas unidades, não na nuvem.
- Automação doméstica — dê-lhe qualquer tarefa à volta do seu servidor doméstico: organizar ficheiros, gerar relatórios a partir dos seus dados, automatizar trabalhos repetitivos. Corre no próprio NAS, por isso continua a trabalhar a toda a hora.
- Diagnostique uma app avariada — quando o Jellyfin deixa de transmitir ou o Home Assistant fica às escuras, cole os sintomas e deixe o agente ler os registos e a configuração diretamente no NAS para encontrar e corrigir a causa. Acabaram-se as adivinhas dentro de uma caixa negra.
- Mantenha a sua pilha de apps — o agente lê os seus ficheiros Docker Compose e acompanha-o em atualizações, alterações de configuração e migrações, para que a sua pilha autoalojada continue a ser mantível durante anos — não apenas até à próxima atualização.
Notas de utilização
- Dê-lhe hardware próprio. O agente funciona melhor como agente de sandbox físico num dispositivo dedicado — mantenha-o longe do seu NAS principal com todos os seus dados, para que as experiências na sandbox nunca toquem no que importa.
- Dois níveis de autorização. Uma autorização de pasta dá ao agente acesso a dados no ZimaOS. Autorizar o socket do Docker é um segundo nível, muito mais alto — dá ao agente gestão de contentores ao nível do sistema, próxima do controlo ao nível de SSH. Conceda cada nível deliberadamente, e só conceda o nível de socket quando uma tarefa precisar mesmo dele.
- Defina a permissão de sandbox como acesso total. Dentro do dsh, defina a permissão de execução da sandbox como acesso total para que o agente possa executar tarefas sem pedir aprovação a cada passo.
- Tudo o que o agente escreve é visível no Files. Graças ao mapeamento do workspace, todo o código-fonte que o agente escreve fica na pasta autorizada — navegue e verifique no ZimaOS Files a qualquer momento.
Próximos passos
- Inferência local: aponte o fornecedor para um servidor de modelos no seu próprio hardware e execute o agente totalmente offline — o próximo tutorial desta série.
- Automatizar serviços com o dsh: crie e execute serviços de automação no ZimaOS — um tutorial posterior desta série.
Ligações de referência
Para mais detalhes, consulte a documentação oficial do DeepSeek Harness:
- Instalação e todos os caminhos de implementação – guia de instalação
- Usar a Web UI – guia da Web UI
- Fornecedores de modelos – guia de fornecedores
- Código-fonte – repositório no GitHub
Leituras adicionais no Tech AI Hub da ZimaSpace: