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 seis 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 pré-instalados — 35 plugins em sete categorias, um a um, além de como gerenciar e como instalar de novo.
• 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.

Esta versão (edição Essentials) tem outra diferença em relação à versão genérica do repositório: não é um aplicativo vazio, «com a casca pronta esperando você instalar plugins», mas traz no instalador 35 plugins já escolhidos e que funcionam bem juntos. Na primeira abertura depois de instalar, essas capacidades já estão esperando na página de plugins — sem precisar procurar um por um no npm.

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. A desinstalação também confirma e fecha os programas em execução antes, para não esbarrar em arquivo em uso no meio do processo.

Nota: a página de download oferece hoje Windows x64, macOS Universal e Linux x64. A compilação arm64 para Linux é feita no canal de teste e ainda não entrou no link estável; em dispositivos ARM, se aparecer problema com módulo nativo, use a versão x64 da plataforma correspondente ou a compilação do canal de teste.

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, com seis passos; dá para «pular a configuração» a qualquer momento e completar depois na página de configurações:

A última página mostra primeiro uma visão geral por categoria: memória e contexto, interface e workspace, agentes e skills, documentos e mídia, código e engenharia, robótica e simulação, conexão e automação — cada categoria diz «o que ela pode fazer por você» e quantos plugins tem. Só depois de clicar em «Concluir e começar» o assistente instala um a um e, na vez de cada plugin, mostra o nome, a versão, a categoria, a descrição completa e um agradecimento a quem o criou. Durante a instalação você não precisa fazer nada; basta esperar o progresso terminar — são 35 pacotes, então a primeira abertura demora um pouco mais que o normal.

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

Com os plugins pré-instalados, a barra lateral e a caixa de entrada ganham mais algumas entradas: central de skills, quadro de tarefas, painel de custos, histórico de entrada, equipes de especialistas e assim por diante. Todas vêm dos plugins da seção nove; desligar o plugin correspondente faz a entrada desaparecer.

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ê:

A edição anterior deste manual falava em «modo: aprimorado / compatível / estendido»; isso foi removido: a partir da 2.2.9 o modo de janela é fixo e só resta «Aparência da janela (material)» nas configurações.

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:

No modo de segurança esta página é somente leitura, e itens como acesso pelo navegador, rede local, controle remoto e notificações também ficam desativados — é assim por projeto, não é defeito.

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 tem só os componentes oficiais de base; os 35 plugins pré-instalados entram apenas no Profile em que o assistente foi concluído. Se trocou de Profile e quer continuar usando, confira a lista real na página de plugins e instale o que faltar.
• Excluir um Profile o move para o diretório de backup de recuperação (não apaga na hora), e as sessões e configurações compartilhadas são preservadas; mas, para aquele Profile, ele deixa de estar disponível — confirme antes de agir.

Nove, plugins pré-instalados

Esta seção é o destaque desta edição do manual. O instalador da 2.2.9 traz 35 plugins, distribuídos em sete categorias, instalados automaticamente no Profile atual quando o assistente é concluído pela primeira vez. A seguir vem «o que está instalado e como isso acontece», depois cada categoria item por item e, por fim, como gerenciar e como instalar de novo.

9.1 O que vem pré-instalado de fábrica

O instalador distribui junto os pacotes compactados dos 35 plugins (o diretório plugins/) e os instala um a um no Profile ao final do primeiro assistente. Não são «download opcional»: estão lá assim que a instalação termina — abra a página de plugins e você vê todos os 35 em «Plugins instalados», ativados por padrão.

9.2 Como a pré-instalação acontece

Alguns detalhes que vale saber:

• A instalação é feita um a um, e cada plugin mostra no assistente o nome, a versão, a categoria, a descrição e o autor. Não feche a janela antes de terminar.
• O critério de sucesso é o nome do pacote aparecer nas dependências do package.json do Profile, não o comando ter saído sem erro; ao final o nome também é acrescentado a profile.bundles, senão fica «instalado, mas não ativado».
• A falha de um plugin não impede a inicialização: se algum falhar, aparece uma caixa-resumo listando nome e motivo e o caso vai para o log do desktop (bundled plugin not installed: <nome>: <motivo>), e o assistente termina normalmente. Depois, confira na página de plugins quais realmente estão na lista.
• Só entra no Profile em que o assistente foi concluído. Um Profile criado depois nasce limpo; se precisar, rode o assistente de novo ou instale pela página de plugins.

9.3 Lista detalhada por categoria

A seguir, os 35 plugins nas sete categorias. O v depois do nome é a versão que acompanha o pacote; a frase «Indicado para» é uma sugestão de escolha, não uma limitação de função.

9.4 Desativar, desinstalar e instalar de novo

• 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 «o que ele fornece desaparece quando é desinstalado».
• Desinstalar um plugin pré-instalado libera pouco espaço: o .tgz original do instalador continua em plugins/ no diretório do programa; o que se apaga é a cópia instalada no Profile. Para realmente enxugar, é preciso outro instalador sem esses pacotes, não desinstalar um por um.
• Instalar de novo: Configurações → Ferramentas do desktop → «Assistente de configuração», rode até a página 6 e clique em «Concluir e começar»; ele repõe no Profile os pacotes que faltam. Também dá para instalar à mão pelos caminhos da 9.5.
• Componentes protegidos não podem ser tocados: os componentes de que o próprio gerenciador de plugins precisa (Host, serviço web, acesso a arquivos etc.) vêm marcados com «necessário ao gerenciamento de plugins, não pode ser desativado ou desinstalado»; componentes de base integrados como dsh-base e dsh-web-app nem entram na lista gerenciável e só mostram o estado em «Configurações → Plugins integrados».

9.5 Instalar plugins por conta própria: três caminhos

A página de plugins (na barra lateral, «Plugins», com o subtítulo «Instalar, ativar e configurar plugins») serve a duas coisas:

• Instalar um plugin novo: clique em «Adicionar plugin», escolha «Instalar 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, espelho da China Continental ou um registro npm interno personalizado.
• Gerenciar os já instalados: em «Plugins 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.

O mercado de plugins tem duas opções: dsh-community-market (o mercado aberto embutido, com suporte a fontes de dados personalizadas, Beta) e dsh-market (o mercado popular da comunidade, com dados do awesome-dsh-plugin e nome de pacote dshmarket). Só é possível ativar um por vez; o mercado é ele mesmo um plugin, então também dá para ligar e desligar direto na página de plugins.

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

9.6 Instalar exige reiniciar e confirmar

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

1. Abra a página de plugins e veja se ele aparece em «Plugins 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, custos).
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.7 E se um plugin quebrar 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. Vale igual para os plugins pré-instalados — não há diferença em relação aos que você instalou depois.

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, controle remoto e notificações do desktop, entre 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 «Assistente 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: para voltar ao último estado que iniciava, use «Rollback» no assistente de recuperação. Se quiser trocar para o instalador de um canal estável, pegue a versão correspondente na página de download e instale por cima — Profile e plugins são preservados.

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.
• CHANGELOG.md: as mudanças de cada versão; a entrada 2.2.9 traz uma «lista de plugins integrados (35)» igual à deste manual.

Agradecimentos

Este produto é construído sobre o upstream DeepSeek Harness e a comunidade de código aberto: Electron, Node.js, pnpm, Python, além do sistema de plugins Cordis e do ecossistema de bundles oficiais. Agradecemos aos mantenedores do upstream e a todos os contribuidores.

Os 35 plugins distribuídos com o pacote vêm dos seguintes autores e equipes (em ordem alfabética; um mesmo autor pode contribuir com vários):

A versão, o autor e a descrição completa de cada plugin vêm no plugins/manifest.json do pacote e também aparecem nos detalhes de cada um na página de plugins.

O manual é atualizado junto com as versões. Se encontrar algo que não corresponde à versão atual, abra um issue no GitHub / GitCode.