Todos os produtos
Search
Central de documentação

Qoder CN Series:Troubleshooting guide

Última atualização: Jun 29, 2026

Este tópico descreve como usar o script do Lingma para solucionar problemas de inicialização e conectividade. O script diagnostica e resolve rapidamente possíveis falhas ao coletar automaticamente informações do ambiente do sistema, configurações de rede, status do serviço Lingma e logs relacionados.

Lingma

Antes de começar

Antes de executar o script de diagnóstico, verifique os seguintes requisitos:

  • Sistema operacional: Windows

  • Permissões: Execute o script com privilégios de administrador para garantir acesso completo às configurações e aos logs do sistema.

  • Arquivo de script: Baixe e salve o script windows_lingma.bat como um arquivo .bat (exemplo: Lingma_Debug.bat).

  • Caminho de instalação: Confirme se o Lingma está instalado no diretório padrão C:\Users\<YourUsername>\.lingma.

Procedimento

  1. Execute o script: Clique em duas vezes no arquivo .bat salvo para iniciar a execução.

  2. Visualize o log: Após a conclusão do script, o arquivo de log gerado será aberto automaticamente. O caminho do arquivo aparece na janela da linha de comando. Geralmente, o log fica na mesma pasta do script e segue o formato Lingma_Log_Date_Time.txt.

Problemas comuns

Tipo de problema

Problema

Solução

Rede

Verificar configurações de proxy

O script verifica se há algum proxy ativado. Consulte a seção [Network settings: 0x0 indicates that no proxy is enabled] para validar a configuração. Caso um proxy esteja ativo, configure manualmente o proxy de rede para o Lingma em Settings.

Status do serviço Lingma

Existência do Lingma.exe

Inicialmente, o script confirma a presença do arquivo Lingma.exe. Se ocorrer um erro, verifique se o caminho de instalação está correto. Em seguida, exclua a pasta .lingma e reinicie a IDE para regenerá-la.

Teste de versão e inicialização

Analise as seções "[version test]" e "[start Lingma]" para confirmar a versão do Lingma e sua capacidade de conexão com a internet. Se o teste falhar, utilize a URL fornecida na mensagem de erro para configurar um proxy nas configurações e permitir o acesso à internet.

O processo Lingma.exe inicia, mas o login não responde

Adicione o arquivo do processo à lista de permissões do Firewall do Windows e tente fazer login novamente. O caminho é C:\Users\xxx\.lingma\bin\2.X.X\x86_64_windows\lingma.exe. As configurações da lista de permissões estão disponíveis em Painel de Controle > Sistema e Segurança > Firewall do Windows Defender > Aplicativos permitidos.

Erro de "programa incompatível" reportado

No IntelliJ IDEA, esse erro pode resultar de memória heap insuficiente, causando falha na descompactação. Para corrigir, clique em no ícone do Lingma no canto inferior direito, selecione Advanced Settings e altere o caminho para um local fora da unidade C, terminando em uma pasta vazia. Depois, reinicie o IntelliJ IDEA.

Nota

Algumas empresas podem bloquear programas binários, impedindo sua execução.

O que fazer se o status for "Lingma is starting" (ou se houver exceção de inicialização e o serviço não responder)?

  1. Confirme se seu sistema operacional e arquitetura são suportados. Em caso positivo, verifique a existência de um processo do Lingma no Gerenciador de Tarefas.

  2. Se nenhum processo for encontrado, atualize o Lingma para a versão mais recente e siga estas etapas:

    1. Encerre o processo do Lingma.

    2. Exclua a pasta .lingma (Windows: C:/Users/[Username]/.lingma; macOS: ~/.lingma).

    3. Reinicie a IDE com permissões de administrador.

  3. Caso o problema persista, abra uma janela de linha de comando (cmd) na pasta .lingma/bin/x.x.x/x86_64_windows/ e execute Lingma.exe start. Aguarde o processo aparecer no Gerenciador de Tarefas e tente fazer login novamente. Observação: Se o programa cmd do Windows estiver corrompido, o Lingma não será executado.

  4. Se um erro de "programa incompatível" for reportado, provavelmente houve uma falha na descompactação. Isso pode ocorrer devido à memória heap insuficiente no IntelliJ IDEA, resultando em falha de login. Para resolver, clique em no ícone do Lingma no canto inferior direito, selecione Advanced Settings e altere o caminho para um local fora da unidade C, terminando em uma pasta vazia. Em seguida, reinicie a IDE. Observação: Algumas empresas podem bloquear programas binários, impedindo sua execução.

  5. Se o processo ainda não aparecer, ou se aparecer mas o login não responder, adicione o arquivo do processo à lista de permissões do Firewall do Windows e tente fazer login novamente. O caminho é C:\Users\xxx\.lingma\bin\2.1.x\x86_64_windows\lingma.exe. As configurações da lista de permissões estão disponíveis em Painel de Controle > Sistema e Segurança > Firewall do Windows Defender > Aplicativos permitidos.

Compatibilidade do sistema

Informações de sistema e hardware

O script coleta a versão do sistema operacional e o modelo da CPU. Verifique a seção "[Operating system info]" para confirmar se o sistema atende aos requisitos do Lingma.

Análise de logs

Log da aplicação Lingma

O arquivo de log gerado contém as últimas 80 linhas do "lingma.log", facilitando a identificação de erros ou avisos específicos durante a execução. Analise esses registros para investigar as falhas.

Estrutura de diretórios e tamanhos de arquivos

Além disso, o script fornece a estrutura e os tamanhos dos arquivos na pasta de instalação do Lingma. Utilize essas informações para verificar o uso do espaço em disco ou validar a integridade dos arquivos.

Problemas além da autossolução

Entre no grupo do DingTalk 53770000738 (Lingma Public Preview Communication Group) e entre em contato com o assistente oficial de suporte.