Navegação deste manual

As treze seções seguem a ordem «instalar → usar → resolver problemas». Se você só quer resolver um problema específico, vá direto à seção doze.

• Um · O que é isto — três camadas; no dia a dia você só toca na de cima.
• Dois · Instalação — qual pacote pegar em cada plataforma e como instalar.
• Três · Primeira abertura — o assistente de sete passos e o fato de «fechar não é sair».
• Quatro · Visão geral da tela principal — o que cada uma das quatro áreas controla.
• Cinco · Primeira conversa — como dizer o pedido com clareza.
• Seis · Menu da bandeja — as entradas de nível de sistema ficam todas aqui.
• Sete · Página de configurações — o que dá para mudar em cada zona.
• Oito · Profile — como alternar entre conjuntos de configuração e como voltar atrás quando a inicialização falha.
• Nove · Plugins — o que vem de fábrica, os três caminhos de instalação e como desinstalar.
• Dez · Modo de segurança e modo de recuperação — como salvar o dia quando um plugin quebra o aplicativo.
• Onze · Atualização — cinco fases e quatro operações reutilizáveis.
• Doze · Quando algo dá errado — tabela de sintomas comuns e exportação de diagnóstico.
• Treze · Dados e ajuda — onde ficam os arquivos e onde encontrar mais documentos.

Um, o que é isto

Em uma frase: ele coloca a capacidade de agente do DeepSeek Harness dentro de um aplicativo desktop: dois cliques no ícone e a conversa começa — ele lê e escreve arquivos, executa comandos e chama ferramentas.

O produto inteiro é formado por três camadas. Você só precisa lidar com a terceira; as duas primeiras rodam automaticamente em segundo plano.

Dois, instalação

Na página de download do produto, pegue o pacote da sua plataforma e execute-o com dois cliques. O pacote já embute Electron, Node.js, pnpm e o runtime DSH em versão fixa — nenhum ambiente precisa ser instalado à parte. Esta versão traz Electron 44.0.0, Node.js 24.21.0, pnpm 11.8.0, Python 3.12.14 e o runtime DSH 0.2.2-rc.1.

Atualizar por cima da versão antiga não exige fechá-la à mão. O instalador pede que a versão em execução saia, e se ela não sair em tempo, encerra-a à força antes de substituir os arquivos; se realmente não conseguir fechar, a instalação para com um erro claro, em vez de terminar e o aplicativo não abrir. Ainda assim, salve o que estiver fazendo antes de atualizar.

Nota: o Windows ARM64 é hoje uma construção experimental. O programa principal é nativo ARM64, mas parte da carga do pacote (runtimes embutidos de Python / Node / Office e alguns módulos nativos) ainda é x64, e a validação completa em dispositivos ARM não foi concluída; para uso comum, prefira a versão x64.

Três, a primeira abertura

No primeiro início, o aplicativo prepara automaticamente um conjunto de configuração padrão (um Profile chamado desktop) e inicia o serviço de interface na máquina local. Você verá primeiro um assistente de sete passos; dá para «pular a configuração» a qualquer momento e completar depois na página de configurações.

Ao concluir o assistente você entra na tela principal. Fechar a janela não é sair do aplicativo: por padrão, fechar apenas recolhe a janela para a bandeja, e o serviço em segundo plano e as tarefas em andamento continuam rodando; para sair de verdade, use «Sair» no menu da bandeja.

Quatro, visão geral da tela principal

Cinco, a primeira conversa

1. Crie uma sessão nova e escolha o diretório de trabalho.
2. Diga em uma frase «o que fazer + onde fazer + como o resultado deve ficar». Por exemplo: «leia o README deste diretório e liste em uma tabela os links de download que estão desatualizados».
3. Quando ele começar a trabalhar, acompanhe as chamadas de ferramentas e os arquivos alterados; se precisar mudar a direção, interrompa e diga o novo pedido.
4. Se o resultado não agradar, diga o que está errado; ele corrige com o contexto, sem precisar abrir outra sessão.

Três pontos para deixar o pedido claro:

• Escopo: só qual diretório, só quais arquivos — não deixe ele solto para inventar.
• Critério de aceite: o que conta como pronto (roda, testes passam, a tabela não tem célula vazia).
• Restrições: o que não pode ser tocado, o formato que precisa ser mantido, se pode ou não acessar a rede.

Seis, o menu da bandeja

Com a janela fechada, o ícone da bandeja é a entrada principal do aplicativo. Com o botão direito no ícone, você vê:

Sete, a página de configurações

A entrada de configurações fica no pé da barra lateral (Configurações → Configurações do desktop). As zonas são estas:

Oito, Profile: vários perfis

Um Profile é um ambiente de configuração independente: sessões, plugins e configurações ficam separados, sem interferência entre eles. O uso típico é «trabalho» e «pessoal» em conjuntos distintos, ou «dia a dia» e «testar plugins novos» em conjuntos distintos.

Três regras práticas:

• Se um Profile quebrou, troque para outro e continue trabalhando — não precisa consertá-lo antes.
• Um Profile novo nasce vazio (só com os componentes oficiais de base) e exige reinstalar plugins — é justamente isso que o mantém limpo.
• Excluir um Profile apaga junto os arquivos locais de configuração e de plugins, sem desfazer.

Nove, plugins: estado de fábrica e como instalar

9.1 O que vem de fábrica

O pacote de instalação não vem com nenhum plugin de terceiros. O Profile padrão criado no primeiro início carrega apenas dois componentes oficiais de base:

• @deepseek-ai/dsh-base — o núcleo do Host: sessões, ferramentas, acesso a arquivos e conexão com modelos.
• @deepseek-ai/dsh-web-app — a interface web que você vê.

Ou seja, logo depois de instalar você tem um aplicativo desktop limpo, que conversa, lê e escreve arquivos e executa comandos; mercado de plugins, equipes de especialistas, entrada de voz, quadro de tarefas, grafo de código e companhia precisam ser instalados por você. Isso é intencional: o que instalar é decisão sua, e quando algo dá errado fica fácil apontar «o último que instalei».

9.2 Os três caminhos de instalação

A página de plug-ins (na barra lateral, «Plug-ins», com o subtítulo «Instalar, habilitar e configurar plug-ins») serve a duas coisas:

• Instalar plugin novo: clique em «Adicionar plug-in», escolha «Instale um plugin de terceiros» e informe o nome do pacote npm (como dsh-xxx ou @autor/plugin), o endereço do repositório GitHub ou um diretório local. Na instalação dá para escolher a origem: «Registro padrão», «Registro oficial do npm», «Espelho da China Continental» ou um endereço npm interno personalizado.
• Gerenciar os já instalados: em «Plug-ins instalados» você ativa, desativa, desinstala e verifica atualizações, e vê a versão, a origem e o estado de execução de cada plugin.

Uma parte dos plugins é fornecida junto com o DSH: eles aparecem como «Este plug-in é fornecido com DSH · Habilite-o sem baixar outra cópia», e basta ativar; quando a versão deles é mais antiga que o DSH atual, aparece «Atualizar». Entram nessa categoria: equipes de especialistas, entrada de voz, mercado de plugins, revisão automática, terminal, busca de sessões, títulos de sessão, skills de emblema, Ralph, tradução de cadeia de pensamento, Inspector, LiveShare, Forge, ferramentas de worktree e recomendações personalizadas. Os mais pesados ou com dependências grandes, que não vêm ativados por padrão (subagente Claude Code, subagente Codex, controle de desktop Computer Use), também são ativados na página de plug-ins quando você precisar.

Os componentes de base que acompanham o DSH (como dsh-base e dsh-web-app) não aparecem na lista gerenciável da página de plug-ins; o estado deles é visto em Configurações → «Plug-ins integrados».

O mercado de plugins tem hoje duas opções: dsh-community-market (o mercado aberto embutido, com suporte a fontes de dados personalizadas) e dsh-market (o mercado popular da comunidade, com dados do awesome-dsh-plugin). Só é possível ativar um por vez.

Os três comandos do terminal (sem --profile, valem para o Profile ativo):

9.3 Instalar exige reiniciar e confirmar

Depois de instalar um plugin é preciso reiniciar o aplicativo para carregá-lo — ao concluir, a interface avisa «Instalado; reinicie DSH para carregá-lo.». Para confirmar que entrou:

1. Abra a página de plug-ins e veja se ele aparece em «Plug-ins instalados» e se está ativado.
2. Veja se a barra lateral passou a mostrar a entrada dele (páginas como mercado, quadro de tarefas, equipes de especialistas).
3. Se ainda houver dúvida, abra «Configurações → Logs», aumente o nível de log e reinicie uma vez; falha de carregamento costuma vir com erro explícito.

9.4 Desativar e desinstalar

• Desative antes de desinstalar: desativar só impede o carregamento no próximo início; os arquivos instalados e a configuração continuam lá, e dá para reativar quando quiser. Desinstalar passa por dsh plugin remove e apaga o pacote; a interface pergunta antes: «Desinstalar …?» / «O que ele fornece desaparece quando é desinstalado.». No assistente de recuperação, «desativar» aparece como «Desabilitar» — é a mesma coisa.
• Os componentes de que o próprio gerenciador de plugins precisa (Host, serviço web, acesso a arquivos) vêm marcados com «O gerenciamento de plug-ins precisa disso; ele não pode ser desligado ou desinstalado.». É o que evita transformar o aplicativo num tijolo. Componentes de base embutidos, como dsh-base e dsh-web-app, nem entram na lista gerenciável; o estado deles só aparece em Configurações → «Plug-ins integrados».
• Em Profiles atualizados de versões antigas, o mercado de plugins permanece desligado por padrão até você escolher explicitamente nas configurações. Isso não é defeito.

9.5 Quando um plugin quebra o aplicativo

Não é preciso reinstalar o sistema nem apagar o diretório de dados. Use o assistente de recuperação da seção dez: primeiro desative em «Gerenciamento de plugins» o último que você instalou e inicie; se ainda assim não abrir, use «Rollback» para voltar ao último ponto de verificação que iniciava.

Dez, modo de segurança e modo de recuperação

Os dois recursos resolvem o mesmo tipo de problema: instalei alguma coisa e não abre mais. A diferença é que o modo de segurança é «entrar limpo para trabalhar» e o modo de recuperação é «parar do lado de fora para consertar».

10.1 Modo de segurança

O modo de segurança inicia com um diretório de dados temporário e independente: ele não lê seus plugins, configurações, sessões e registros de workspace, então também não é derrubado por eles. Os dados originais não são tocados nem em um byte.

Como entrar: bandeja → «Entrar no modo de segurança…»; ou, na tela inicial do assistente de recuperação, «Modo de segurança».

O que dá para fazer no modo de segurança:

• Confirmar «se o problema é mesmo de plugin»: se no modo de segurança tudo funciona, o problema está quase certamente em um plugin ou na configuração.
• Conversar, ler e escrever arquivos pela interface web normalmente, resolvendo primeiro o que é urgente.
• Ver logs e exportar informações de diagnóstico (o pacote também sai pelo assistente de recuperação).

Limites (é assim por projeto):

• A página de configurações do desktop fica somente leitura; não dá para alterar.
• Acesso pelo navegador, acesso pela rede local, Agents-Anywhere, notificações do desktop e outros itens que dependem de configuração persistente ficam indisponíveis.
• Uma faixa «Modo de segurança» permanece no topo da interface, lembrando que você está em ambiente temporário.

Como sair: bandeja → «Sair do modo de segurança e reiniciar…». Ao sair, o ambiente temporário é limpo automaticamente no próximo início normal, sem ficar ocupando espaço em disco.

10.2 Assistente de recuperação (modo de recuperação)

Quando você cai aqui:

• Você entra de propósito, pela bandeja em «Reiniciar no modo de recuperação», ou em Configurações → Versão e atualizações → «Reiniciar no modo de recuperação».
• A inicialização falha repetidamente e o aplicativo recua sozinho para o assistente.
• Quando a interface não sobe de jeito nenhum, aparece uma janela separada «Recuperar o DSH Desktop», em que dá para tentar a recuperação de novo, sem reiniciar o serviço em segundo plano.

O assistente informa três coisas: por que você entrou (a entrada manual aparece como «entrou manualmente no modo de recuperação»), qual Profile e qual diretório estão em uso e em que passo a inicialização parou (inicialização do Electron → preparação do ambiente do shell → preparação do runtime do desktop → escolha do Profile → composição da configuração de plugins → início dos serviços de plugins → início da interface do desktop → confirmação do resultado). Onde parou delimita o alcance do problema.

Como o rollback funciona: a cada início bem-sucedido o aplicativo guarda um «ponto de verificação de inicialização» — a configuração que funcionava naquele instante. O rollback devolve, de uma vez, o Profile, o settings.yaml e o estado de ativação dos plugins àquele momento. Os pontos aparecem como «recuperável», «ilegível» ou «ainda sem ponto de verificação»; «ilegível» significa que aquele ponto se corrompeu — use um mais antigo.

Restaurar as configurações de fábrica: o diretório de dados atual é movido inteiro para a lixeira (no Windows, a Lixeira) e, no reinício, um Profile padrão novo é criado. Arquivos de projeto fora do diretório de dados não são apagados — só a configuração e as sessões do próprio aplicativo. Antes de executar, confirme que você realmente não precisa mais das sessões antigas.

10.3 Como sair

Depois de consertar não é preciso limpar nada à mão: saia do assistente de recuperação e inicie o aplicativo normalmente. Se você clicar em «Reiniciar» dentro do modo de recuperação, ele refaz o fluxo normal de inicialização; se falhar de novo, volta ao assistente, sem entrar em laço infinito.

Onze, atualização

Cinco fases: verificar → baixar → instalar → reiniciar → confirmar a versão. Quatro operações reutilizáveis:

• Verificação manual: bandeja → «Verificar atualização…», ou Configurações → Versão e atualizações → «Verificar atualização».
• Reiniciar: Configurações → Versão e atualizações → «Reiniciar»; se houver aviso de atualização na barra de título, também dá para clicar nele.
• Limpar restos de instalação: uma atualização que falha geralmente é arquivo preso por uma instância antiga. Saia pelo menu da bandeja e rode o instalador de novo; não é preciso apagar diretório à mão.
• Voltar atrás: do canal de teste para a versão estável, use «Instalar versão estável…» na bandeja; para voltar ao último estado que iniciava, use «Rollback» no assistente de recuperação.

Doze, quando algo dá errado

Exportar informações de diagnóstico

Bandeja → «Exportar informações de diagnóstico…», ou o mesmo item no pé da página de configurações. O pacote traz caminhos locais, logs, informações do sistema e trechos de memória de uma eventual queda. Leia antes de compartilhar: caminhos e trechos de sessão podem conter informação privada.

Treze, onde ficam os dados e onde buscar ajuda

Mais documentos

• README.md / README.zh.md: instalação, build e ambiente de desenvolvimento.
• docs/: arquitetura, processo de publicação e guia de desenvolvimento de plugins.
• No mesmo diretório, Nonead-DSH-Desktop-User-Manual.en.md e as versões HTML em oito idiomas: o conteúdo corresponde, o que facilita comparar.