Guia de leitura

Manual do usuário do Nonead DSH Desktop

Este é um manual de operação para usuários comuns. Ele não exige que você saiba programar nem que instale antes Node.js, pnpm ou qualquer ferramenta de desenvolvimento — o pacote de instalação já traz todo o ambiente de execução; instalar é o bastante para começar a usar.

Para quem: quem está tendo o primeiro contato com o produto
Ordem de leitura: ler na ordem dos capítulos ou ir direto à seção de que você precisa

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

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 usa ferramentas.

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

Shell desktop Janela · bandeja · atualização · terminal · perfis Host (serviço em segundo plano) Carrega plugins, executa ferramentas, gerencia sessões e arquivos Interface web (o conteúdo da janela) Conversa · caixa de entrada · barra lateral · configurações
Fig. 1 O produto tem três camadas; a operação diária acontece só na de cima.
Qual a diferença para a versão web? A versão web só permite conversar. A desktop entrega o computador inteiro a ele: ler seus arquivos, rodar comandos, instalar plugins, conectar seu diretório de trabalho — tudo na sua máquina, sem dados saindo dela.

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 já 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.

PlataformaBaixeComo instalar
Windows x64Instalador .exeExecute com dois cliques e conclua seguindo as etapas indicadas
macOS (Universal: Intel / Apple silicon)Disco de imagem .dmgAbra e arraste o ícone para Applications
Linux x64.AppImagePrimeiro chmod +x para dar permissão de execução; depois abra com dois cliques ou pela linha de comando
Tabela 1 Instalação nas três plataformas. No Linux, se o FUSE estiver ausente, execute com --appimage-extract-and-run.

Nota: o Windows ARM64 é hoje uma construção experimental; os runtimes de Python / Node embutidos ainda são a carga 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 perfil padrão e inicia o serviço de interface na máquina local. Você verá primeiro um assistente:

  1. Página de boas-vindas — apresenta o posicionamento básico do produto.
  2. Mercado de plugins — escolha se o mercado de plugins da comunidade fica ativado. Escolher «não ativar» também é lembrado; ele não perguntará de novo.
  3. Controle remoto — se dispositivos como o celular podem conectar o desktop desta máquina.
  4. Computer Use — se ele pode operar seu mouse e teclado.
  5. Modo de recuperação — como usar a «rede de segurança» quando algo dá errado.
Atenção: fechar a janela não é sair. Ao clicar no fechar no canto superior direito, o aplicativo recolhe para a bandeja do sistema e continua rodando. Para sair de verdade, clique com o botão direito no ícone da bandeja e escolha «Sair».

Quatro, visão geral da tela principal

A janela principal é simples: de cima para baixo e da esquerda para a direita há apenas quatro áreas.

① Moldura desktop (36 px; arraste a janela aqui) ② Barra lateral Sessão 1 Sessão 2 Sessão 3 Workspace / arquivos / plugins ③ Área de conteúdo da conversa Você: converta as imagens desta pasta para webp Agente: 12 imagens encontradas; converter todas? Escritas pedem sua confirmação antes ④ Caixa de entrada Descreva aqui o pedido; Enter envia
Fig. 2 As quatro áreas da tela principal: ① moldura desktop ② barra lateral ③ área de conversa ④ caixa de entrada.
ÁreaPara que serve
Moldura desktopA barra escura de 36 px no topo. Arraste a janela nas partes vazias; os ícones são clicáveis.
Barra lateralLista de sessões, entradas de workspace e arquivos, e entrada de plugins. Troque de sessão quando quiser; o histórico fica.
Área de conteúdo da conversaO que você digita, as respostas dele e os resultados das ferramentas aparecem aqui.
Caixa de entradaOnde você descreve o pedido. Quanto mais específico, mais perto do resultado que você quer.
Tabela 2 A função de cada uma das quatro áreas.

Cinco, a primeira conversa

  1. Na caixa de entrada, escreva com clareza o que você quer, por exemplo «converta todos os png desta pasta para webp, mantendo as dimensões originais».
  2. Pressione Enter para enviar. Ele entende, planeja e usa ferramentas quando necessário.
  3. Operações de risco — escrita, exclusão, execução de comandos — mostram uma caixa de confirmação nativa, em que você aprova ou recusa.
  4. O resultado aparece na conversa; se não gostar, é só dizer «mude para …» sem recomeçar.
Dica para escrever pedidos: dizer «sobre quê», «até que padrão» e «o que não deve mudar» funciona muito melhor do que dizer apenas o que fazer. Ele não vê o contexto que você não escreveu.

Seis, o menu da bandeja

A maioria das operações de nível de sistema está no ícone da bandeja. Clique com o botão direito nele e verá estas entradas:

Abrir configurações Verificar atualização Alternar Profile Assistente de recuperação Abrir terminal DSH Sair
Fig. 3 As seis entradas do menu da bandeja; as três mais usadas são «Abrir configurações», «Verificar atualização» e «Assistente de recuperação».

Sete, a página de configurações

A página de configurações divide-se em cinco zonas funcionais, da esquerda para a direita:

Geral Profile Ferramentas Recuperação Permissões
Fig. 4 As cinco zonas da página de configurações.
ZonaO que você pode fazer ali
GeralInício automático, idioma da interface, porta web local e o cartão de atualização (com «notas da atualização» e verificação manual).
ProfileVer e criar perfis, e trocar qual Profile está em uso.
FerramentasAbrir o terminal DSH, reiniciar normalmente ou reiniciar em modo de recuperação.
RecuperaçãoListar instantâneos de saúde e fazer rollback; antes de cada rollback uma cópia do estado atual é salva.
PermissõesGerenciar permissões de sistema, como Computer Use.
Tabela 3 O uso principal das cinco zonas.
Dica: se você fixar a porta web local, as configurações salvas na interface (como preferências de alguns plugins) só voltam a ser lidas depois de reiniciar. Sem necessidade especial, mantenha o padrão e deixe o sistema atribuir a porta automaticamente.

Oito, Profile: vários perfis

Pense no Profile como «um conjunto de configurações isolado»: combinações diferentes de plugins, patches diferentes, configurações diferentes. Você pode manter vários ao mesmo tempo e trocar por cenário, sem interferência entre eles.

Profile atual ex.: desktop Bandeja → Alternar Profile Escolha um perfil Reinício ordenado alguns segundos Falha na inicialização? Volta ao último perfil que funcionou Rollback manual também pelo «Assistente de recuperação» na bandeja
Fig. 5 Fluxo de troca de Profile: escolher → reinício ordenado → rollback automático em caso de falha.

Guarde três pontos:

Nove, plugins e mercado de plugins

Plugins são a forma de dar capacidades novas a este assistente: modelos novos, ferramentas novas, painéis de interface novos, fluxos de automação novos. Plugins oficiais podem ser instalados diretamente e vários podem ficar ativos ao mesmo tempo.

Dois caminhos de instalação:

Instalar exige reiniciar. Depois de mudar plugins é preciso reiniciar o aplicativo para os novos serem carregados. Se depois de instalar nada acontecer, confirme que o comando agiu sobre o Profile que você está usando e reinicie de novo.

Dez, como usar os 35 plugins instalados

Esta seção apresenta um por um os 35 plugins realmente instalados no seu perfil desktop atual; nomes e versões foram coletados do perfil na máquina local (data do instantâneo 2026-11-08). Estão divididos em sete grupos por uso: cada grupo começa com uma visão geral e depois explica o que cada plugin faz e quando ele é usado.

35 plugins instalados · grupos por uso Memória 5 · recall automático, busca do projeto, visão do contexto, histórico de entrada, rewind Skills 8 · gestão de skills, mercado, centro; skills de engenharia; experts; GitHub; arquitetura; PPT UI 8 · continuação automática, sidebar ampliada, quadro de tarefas, grafo Git, UI inline, voz, custo, arquivamento Equipe 8 · delegação de sub-agentes, Claude Code / Codex, revisão de código, vigilância, descoberta, mercado, MCP Robôs 2 · UR real, simulação UR offline (NONEAD) Imagem 3 · bancada de imagem, bancada de vídeo React, Univer
Fig. 6 Os sete grupos por uso (manutenção de sistema tem 1: backup de configurações, item 35 no fim).

Eles não são isolados: no uso real formam uma cadeia que vai de «lembrar o contexto» até «entregar o resultado»:

① Lembrar memória · contexto ② Escolher skills skills · experts ③ Executar sub-agentes · robôs ④ Entregar docs · vídeo · imagem ⑤ Revisar revisão · custo Você não precisa encadear isto na mão: os plugins se conectam sozinhos pela injeção de serviços do DSH.
Fig. 7 A cadeia típica de colaboração entre plugins.
Guarde primeiro três operações gerais: instalar plugin é dsh plugin add <nome>; remover é remove; atualizar é update. Toda mudança exige reiniciar o aplicativo. O comando age por padrão no Profile ativo; para mirar outro, acrescente --profile <nome>.

Grupo 1 · Memória e contexto (5)

Este grupo resolve o «ele não lembra do que foi dito antes».

1Memória automática@a9i5k4/dsh-auto-memory3.3.17

Memória associativa ativa: antes de falar, o modelo faz recall automático das memórias relevantes, organiza-as em três camadas sozinho e ainda converte fluxos repetidos em skills.

Como usar: nenhuma operação extra; ele decide o que recordar. Para fazer uma limpeza, diga «organize as experiências recentes».

2Memória do projeto@yolk_vat-y/dsh-project-memory0.6.11

Indexa documentos (PDF / Markdown / texto) e símbolos de código em bibliotecas pesquisáveis, uma por workspace; o recall vem com citação da fonte.

Como usar: ao entrar num projeto, peça uma indexação primeiro; depois pergunte «como XX está implementado neste projeto?» e ele responde com a fonte do arquivo.

3Visão do contextodsh-context0.82.1

Mostra do que o contexto atual é feito e quanto ocupa, e permite enxugar isso para a conversa não ficar cada vez mais lenta.

Como usar: quando a conversa ficar lenta ou o contexto for avisado como longo, abra o painel dele, veja a composição e corte o histórico desnecessário.

4Histórico de entradadsh-nonead-prompt-recall0.8.7

Com a caixa de entrada vazia, ↑ traz a entrada anterior; pressione de novo para voltar mais; ↓ volta adiante. O histórico é guardado por workspace e sobrevive ao reinício. Ao lado do seletor de modelos há um botão de rewrite: reescreve o prompt que você escreveu pela metade com o modelo atual; referências @ são preservadas.

Como usar: para reaproveitar aquele prompt longo de antes sem redigitá-lo, com a caixa vazia aperte ↑.

5Rewind da conversadsh-nonead-prompt-rewind0.5.4

Rebobina a conversa dentro da janela até uma rodada anterior e pode restaurar os arquivos do workspace junto.

Como usar: quando a direção saiu errada e você quer «voltar três passos e recomeçar», use isto — mais simples que abrir uma sessão nova.

Grupo 2 · Skills e experts (8)

Este grupo resolve «diante de uma tarefa concreta, como fazê-lo seguir o método profissional».

6Gerenciador de skills@michengai/dsh-skills-manager1.2.35

Carrega de forma unificada e segura as Agent Skills locais, evitando que skills de várias fontes se sobrescrevam.

Como usar: depois de instalar uma skill nova, confirme aqui que ela foi carregada corretamente e de onde vem, e então decida quais ativar.

7Mercado de skills@weibaohui/skills-management0.9.3

Uma página para gerenciar as skills de todos os assistentes de programação locais (Claude, Codex, ZCode e mais de dez outros); dá para recolher tudo para o DSH em um clique. Vem com um mercado de 6600+ skills e ordenação pelo custo de injeção.

Como usar: antes de procurar uma skill pronta para uma capacidade, comece daqui; veja o custo em tokens antes de instalar e não instale muitas de uma vez.

8Centro de skills@linxin666/dsh-client-ui-skill-explorer0.4.15

Navega pelas skills carregadas por origem (built-in / projeto / usuário / custom / runtime); dá para ativar, desativar, criar e excluir.

Como usar: quando suspeitar que uma skill não atuou, confirme aqui a que camada ela pertence e se foi desativada.

9Skills de engenharia@wenaixi/dsh-superpower8.0.0

Embutem 15 skills de engenharia obra/superpowers (esclarecimento de requisitos, TDD, depuração sistemática, revisão de código etc.), com descrição em duas línguas e liga/desliga por skill.

Como usar: em tarefas de desenvolvimento, prefira que ele siga este fluxo; skills individuais que você não precisa podem ser desligadas para reduzir ruído.

10Equipe de experts@michengai/dsh-agency-agents1.2.26

331 agentes profissionais invocáveis cobrindo a divisão de 22 domínios; invoque um expert isolado ou monte uma equipe conforme a necessidade.

Como usar: diante de um problema que pede olhar profissional, diga «que o expert XX analise»; tarefas complexas podem ser feitas em equipe, em paralelo.

11Skills de fluxo GitHubdsh-github-skills0.2.1

Porta a semântica de fluxos GitHub do OpenAI Codex: ver PRs, tratar comentários de revisão, checar CI, publicar etc.

Como usar: no repositório, diga «veja os comentários de revisão deste PR» ou «por que o CI quebrou» e ele segue o fluxo correspondente.

12Diagramas de arquitetura@tt-a1i/archify-dsh1.0.0

Desenha requisitos ou estrutura de código como diagramas de arquitetura, fluxos e sequências interativos; saída em HTML independente, com modo escuro e exportação.

Como usar: diga «desenhe a arquitetura deste sistema»; ele lê o código antes de desenhar, não inventa o diagrama.

13PPT Masterdsh-ppt-master6.1.0

Fluxo de apresentações orientado por IA: gera PPTX editável, snapshots de página e preenche templates nativos.

Como usar: dê o tema e os pontos, ou peça que gere a partir de um documento existente; para mudar o layout, diga «trocar para template nativo».

Grupo 3 · Interface e eficiência (8)

Este grupo melhora «a tela que você vê todos os dias» e «quanto está custando».

14Sidebar ampliadadsh-better-sidebar0.30.1

Reúne árvore de arquivos, editor, mudanças, tarefas e chats paralelos numa única coluna, sem interferência entre sessões. Também expõe um serviço pelo qual outros plugins anexam suas abas e visualizadores de arquivos a esta sidebar — na seção doze, «painel direito dando 4xx» é justamente um plugin que não obteve esse serviço.

Como usar: ao mudar código, não alterne entre janelas: veja arquivos, diff e chat paralelo direto no lado direito.

15Quadro de tarefas@linxin666/dsh-client-ui-task-board0.4.15

Quadro de tarefas autoritativo do Host: cartões executam de verdade, com cron e proteção contra suspensão cross-platform.

Como usar: quebre o que precisa ser feito em cartões no quadro e deixe que ele rode em ordem ou por horário automaticamente.

16Grafo Git@linxin666/dsh-client-ui-git-graph0.4.14

Seletor de branches em sessão vazia + grafo de relações Git, com operações git reais do lado Host e checagens de segurança.

Como usar: antes de abrir uma sessão nova, veja no grafo as relações entre branches para não trabalhar na branch errada.

17UI interativa inline@changfenhuang/dsh-genui0.15.0

Renderiza componentes interativos direto na resposta: layout, gráficos, gráficos de função, formulários, quiz etc.

Como usar: quando quiser gráfico ou tabela comparativa, diga «mostre em tabela/gráfico»; ele renderiza um painel operável.

18Avisos por vozdsh-notify-say0.5.3

Notificações desktop são faladas de verdade: o TTS nativo do Windows funciona de saída (sem baixar nada), vozes VOICEVOX são opcionais e dá para voltar ao som do sistema. Ele também espera todos os sub-agentes que você despachou terminarem antes de dizer «esta rodada acabou».

Como usar: rode tarefas longas e vá fazer outra coisa; ele avisa por voz quando terminar. A voz pode ser trocada nas configurações.

19Medidor de custodsh-cost-meter1.9.58

Conta o custo da sessão e do dia, com catálogo embutido de 170+ preços de modelos e correspondência automática; também consulta a cota de assinatura de 16 Coding Plans e o saldo de Providers customizados (com qualquer endpoint HTTP), exibido em barra de progresso.

Como usar: antes de uma tarefa longa, veja o gasto do dia; ao trocar de modelo, compare o preço unitário para não fazer trabalho barato com modelo caro.

20Arquivador de sessões@michengai/dsh-archive-manager1.2.8

Arquiva, restaura, marca como favorita e exclui definitivamente sessões, e diagnostica logs de sessão corrompidos.

Como usar: quando a lista de sessões ficar longa, arquive as antigas; quando uma sessão não abrir, use-o para diagnosticar o log.

21Continuação automáticadsh-client-auto-continue0.17.4

Quando a sessão é interrompida por motivos não humanos — erro de rede, por exemplo — ele envia sozinho uma mensagem de continuação no seu lugar e reconecta a conversa; o motor roda no processo do Host, então continua funcionando mesmo que você feche a aba do navegador. Por padrão ele só faz recuperação de interrupção; para seguir num ciclo autônomo depois de terminar, é preciso ativá-lo manualmente nas configurações.

Como usar: ligue-o quando a rede estiver instável ou quando for rodar tarefas longas — ao voltar, a conversa já está reconectada; se quiser que ele trabalhe sozinho rodada após rodada, ative separadamente o ciclo autônomo.

Grupo 4 · Colaboração e desenvolvimento (8)

Este grupo transforma «um assistente» em «uma equipe».

22Delegação de sub-agentes@deepseek-ai/dsh-tool-subagent0.2.2-rc.1

Ferramenta de delegação de sub-agentes para o modelo: passa uma subtarefa independente a outro agente sem ocupar o contexto da conversa atual.

Como usar: quando a tarefa se dividir em partes independentes, peça despacho paralelo; a conversa principal só recebe as conclusões.

23Sub-agente Claude Code@deepseek-ai/dsh-subagent-claude-code0.2.2-rc.1

Sub-agente Claude Code descartável baseado no Agent SDK oficial: entrega a tarefa a ele, que roda até o fim e devolve o resultado.

Como usar: quando precisar das capacidades do Claude Code (edições em escala, rodar testes), invoque-o pelo nome.

24Sub-agente Codex@deepseek-ai/dsh-subagent-codex0.2.2-rc.1

Sub-agente Codex descartável baseado no protocolo oficial app-server.

Como usar: quando quiser entregar uma implementação ao Codex para concluí-la sozinho, use-o; convive com o sub-agente Claude Code.

25Revisão de código@michengai/dsh-code-review1.0.8

Revisão de código estilo Codex: sub-agente nativo independente, escopo de revisão opcional e relatório em duas línguas.

Como usar: antes do commit, pergunte «revise as mudanças desta rodada»; ele verifica por escopo: diff, código relacionado e arquivos não commitados.

26Agente de vigilância do repositóriodsh-superagent0.1.0

Agente proativo para um único repositório GitHub: monitora GitHub (Feishu opcional) e avalia solicitações conforme regras.

Como usar: ative quando quiser que ele vigie issues / PRs por você; confirme antes sobre qual repositório atua e quais regras disparam.

27Descoberta de pluginsdsh-find-plugins0.3.0

Busca plugins em cinco catálogos comunitários + busca GitHub / npm em tempo real, ordenando por relevância × confiança × novidade × popularidade.

Como usar: antes de adicionar uma capacidade, pergunte «existe um plugin assim?» — é mais certeiro que vasculhar o mercado.

28Mercado de pluginsdshmarket1.73.14

Mercado de plugins visual na interface: navegar, buscar e instalar em um clique.

Como usar: abra o mercado na página de configurações, achou, clique em instalar; só vale depois de reiniciar.

29Conector MCPdsh-mcp-connector0.2.94

Mercado MCP que conecta fontes de dados empresariais, financeiros, legais, de patentes e pesquisa; gerencia autorização, busca e chamada.

Como usar: quando precisar de dados externos, procure aqui o conector e autorize; antes de chamar, veja que permissão ele exige.

Grupo 5 · Controle de robôs (2, desenvolvidos pela NONEAD)

Este grupo faz o DSH dirigir braços Universal Robots em linguagem natural.

30UR realdsh-nonead-universal-robots0.8.6

Controla braços UR em linguagem natural: ler estado, mover joints, linhas retas, force mode, I/O e registros, rastreamento de esteira etc., com a mesma lógica do nUR MCP Server próprio.

Como usar: primeiro diga «conectar 192.168.x.x», depois faça os movimentos. Comandos de movimento estão sob portão de aprovação por padrão e exigem sua confirmação item a item.

31Simulação UR offlinedsh-nonead-ursim0.3.14

A mesma lógica em versão de simulação offline: dirige um braço UR virtual para validar trajetórias quando não há robô real.

Como usar: primeiro faça o movimento funcionar na simulação e confirme que não colide, então vá ao robô real; a simulação cobre cinemática apenas, sem semântica de force mode nem I/O.

Grupo 6 · Imagem e mídia (3)

Este grupo transforma o resultado em algo entregável direto: imagem, vídeo, documento.

32Bancada de geração de imagemdsh-image-gen0.10.3

Leva a geração de imagem estilo ChatGPT para o DSH: suporta Gemini, OpenAI, Seedream e DashScope, e também workflows ComfyUI locais; vem com uma canvas de bancada onde você rabisca e escolhe imagens de referência.

Como usar: diga «desenhe uma …» e ele gera a imagem, anexada direto na conversa; para mudar uma imagem existente, diga «mude esta para …». Trocar de fornecedor ou modelo precisa ser dito explicitamente; por padrão ele usa o configurado nas configurações.

33Bancada de vídeo Reactdsh-remotion0.10.5

Skills oficiais do Remotion + busca de projeto, templates, ordenação de material, preview no Studio e exportação MP4.

Como usar: ative ao produzir um vídeo ou abertura; primeiro veja templates e depois mude — mais rápido que escrever componentes do zero. O primeiro preparo do ambiente baixa dependências e exige rede.

34Preview de documentos Univerdsh-univer-office0.4.0

Integração DSH + Univer: preview inline de documentos, janelas flutuantes de Worktree e ações de revisão no fim da sessão.

Como usar: quando ele produzir planilha / documento / apresentação, o resultado aparece em preview no painel, sem baixar para ver.

Grupo 7 · Manutenção de sistema (1)

35Backup de configuraçõesdsh-config-manager0.4.3

Backup, restauração, exportação, importação, migração e sincronização de toda a configuração DSH: settings, plugins, MCP, skills, presets de agentes etc.

Como usar: antes de uma mudança grande, exporte uma vez; ao trocar de máquina, restauração por importação é muito mais rápida que reconfigurar item a item.

Esta lista é um instantâneo e muda conforme você instala e remove. Para saber o que está instalado agora e em que versão, compare no mercado de plugins da página de configurações ou leia as dependencies em profiles/desktop/package.json no diretório de dados.

Também não vale ligar tudo de uma vez. Quanto mais plugins, maior o contexto e o custo de inicialização. O «mercado de skills» acima mostra o custo de injeção de cada skill; estime antes de instalar. O que você não usa por ora pode ficar desativado e ser ligado quando precisar.

Onze, atualização

O aplicativo verifica versões novas em segundo plano, discretamente, sem incomodar. Quando encontra uma versão nova, só avisa na bandeja — nunca abre janela por conta própria.

Verificar Nova versão aviso na bandeja Baixar Instalar Reinício conclui Falha não afeta a versão atual: na bandeja dá para «tentar instalar de novo»; o pacote já baixado fica guardado e não precisa ser baixado outra vez.
Fig. 8 As cinco fases da atualização; qualquer etapa que falha mantém a versão atual.

Algumas ligações úteis:

OperaçãoEfeito
Pular esta versãoEssa versão deixa de ser avisada depois; vale mesmo após reiniciar
Deixar de pularLimpa o registro de omissão e a versão volta a ser avisada
Tentar instalar de novoReusa o pacote instalado já baixado, sem baixar de novo
Instalar e reiniciarQuando estiver pronto, instala e reinicia direto
Tabela 4 As quatro operações relacionadas à atualização.

Doze, quando algo dá errado

Compare primeiro com a tabela abaixo; a maioria dos problemas se resolve sozinho.

SintomaO que fazer
A janela desapareceuVeja a bandeja do sistema. Fechar a janela só a esconde, não encerra o aplicativo.
Cliquei e nada aconteceu / giro eternoEspere um pouco; se seguir sem resposta, reinicie pelo menu da bandeja ou «reiniciar em modo de recuperação».
Quebra na inicialização / não entraUse o «Assistente de recuperação» para voltar à última configuração que funcionou. Antes do rollback o estado atual é copiado automaticamente, então o próprio rollback pode ser revertido.
Instalei um plugin e ele não atuaConfirme que o comando agiu sobre o Profile certo e reinicie o aplicativo.
Pedi uma imagem e ela não veioA geração de imagem exige configurar antes um fornecedor de imagem nas configurações (credencial de API ou conta de assinatura logada). Sem isso, ele só diz que não há fornecedor disponível.
O comando não existe no terminalAbra de novo um «Terminal DSH» pela bandeja; o desktop não altera o PATH do sistema.
Painéis como «Arquivos» à direita sempre dão 4xxNormalmente um plugin está pendurado por falta de serviço dependente. Em logs/ no diretório de dados, procure por pending (waiting for service:, desative o plugin correspondente e reinicie.
Não recebi aviso de atualizaçãoA verificação em segundo plano é silenciosa. Veja o resultado manualmente com «Verificar atualização» na bandeja ou nas configurações.
Tabela 5 Sintomas comuns e como tratá-los.

Exportar diagnóstico

Se o problema precisar ser reportado aos mantenedores, clique com o botão direito no ícone da bandeja e exporte o pacote de diagnóstico. Ele coleta os logs recentes; credenciais identificáveis nos logs são mascaradas, mas caminhos locais, nomes de workspace e IDs de sessão podem ficar — antes de publicar, confira o conteúdo você mesmo.

Treze, onde ficam os dados e onde buscar ajuda

ConteúdoLocal
Diretório de dados (sessões / configurações / logs)Por padrão ~/.dsh; no Windows, %USERPROFILE%\.dsh
Logslogs/ dentro do diretório de dados
Posição e tamanho da janelawindow-state.json no diretório de dados do aplicativo
Configurações desktop (inclusive porta)desktop-preferences.json no diretório de dados
Sobrecarga de variáveis de ambiente.env no diretório de dados do aplicativo (estrito KEY=VALUE, sem sobrescrever variáveis reais)
Tabela 6 Locais comuns dos arquivos.

Mais documentos

Última sugestão: trate este manual como mapa, não como especificação. O que realmente precisa ser lembrado no dia a dia são três coisas: dizer o pedido com clareza na caixa de entrada, olhar a caixa de confirmação antes de uma escrita e, quando não achar a janela, procurar na bandeja.

Agradecimentos

Este manual existe por causa do trabalho de outras pessoas.

A DeepSeek e a equipe upstream do DeepSeek Harness — o produto é construído sobre o upstream sem modificações: loop do agente, chamadas de ferramentas, host de plug-ins e interface web vêm de lá, e seu código e documentação públicos são a base técnica deste manual.

Quem mantém os 35 plug-ins — a maioria são projetos comunitários independentes. Agrupados por dono do repositório: estas são as contas e organizações do GitHub:

O instalador também se apoia em projetos de código aberto: Electron, electron-builder, pnpm, os runtimes de Node.js e Python, e muitas pessoas na árvore de dependências upstream. Se faltar um nome ou houver erro, abra uma issue no repositório.

Sobre a publicadora:Este manual e o produto são publicados pela Nonead Technology. A Nonead Technology (Suzhou Nonead Robot Technology Co., Ltd.) não tem qualquer relação, vínculo ou associação com a DeepSeek ou suas afiliadas — o produto é desenvolvido e mantido de forma independente, não representa a posição da DeepSeek e não é autorizado nem endossado por ela.
Razão social:Suzhou Nonead Robot Technology Co., Ltd.
Endereço:Sala 9-10, 4.º andar, Edifício B, Tengfei Xinsu Fang, rua Xinghan 5, Parque Industrial de Suzhou, Jiangsu, China
Site:https://www.nonead.com
Telefone:0086-0512-67263000
E-mail:service@nonead.com