Solução de problemas

Inicialização

“Julia não detectado” ou “Atualização do Julia necessária”

O SciForesight exige o Julia 1.13 ou superior instalado na máquina — o instalador não o embute. A tela de inicialização diz se o Julia não foi encontrado ou se a versão detectada é anterior à exigida (1.11 e 1.12 não funcionam). Instale ou atualize pelo Juliaup e use Verificar novamente na própria tela, sem reiniciar o aplicativo:

winget install julia -s msstore
juliaup update

Se o Julia está instalado em um local que o aplicativo não procura, use Selecionar executável manualmente e aponte para o julia.exe.

A primeira abertura demora ou falha em “Instalando e compilando dependências”

Na primeira abertura, e depois de cada atualização, o Julia baixa os pacotes e os pré-compila — alguns minutos são normais, e o log aparece ao vivo na tela. Se falhar, as causas mais comuns são falta de internet ou de acesso pelo proxy/firewall corporativo aos repositórios de pacotes do Julia, e pouco espaço livre em disco na pasta %USERPROFILE%\.julia. Resolvido o acesso, basta abrir o aplicativo de novo.

“Backend indisponível”

O serviço local não respondeu dentro do tempo esperado. Use Reiniciar backend; se persistir, abra a pasta de logs pelo botão da própria tela e envie o trecho relevante à equipe.

Licença

“Assinatura da licença inválida” / Signature verification failed

A verificação Ed25519 reprovou o conteúdo do arquivo. As causas, em ordem de frequência:

• o arquivo foi aberto e salvo em um editor, alterando a formatação do JSON;
• o download foi interrompido e o arquivo está truncado;
• o arquivo foi renomeado a partir de uma licença antiga de outra conta.

Solução: peça o reenvio do arquivo original à equipe, pelo mesmo atendimento que aprovou a sua solicitação de versão de teste, e substitua o arquivo local sem editá-lo. Confira que o envelope tem exatamente as duas chaves esperadas:

{
  "payload_base64": "...",
  "signature_base64": "..."
}

“Licença expirada”

A licença assinada vale pelo período acordado a partir da emissão, e um reenvio do arquivo não reinicia a contagem. Depois do vencimento há 14 dias de carência com tudo funcionando; passada a carência (ou os 30 dias da avaliação local), o aplicativo fica em modo somente leitura — consultas e exportações seguem disponíveis. Os projetos e o corpus permanecem intactos no disco: assim que uma licença válida for importada, tudo volta a abrir sem reingestão. Para renovar ou migrar para uma licença corporativa, procure a equipe comercial.

O aplicativo não reconhece a licença

A licença é importada pela própria tela de licença (Gerenciar licença → Importar licença), escolhendo o arquivo no seletor do Windows — copiar o arquivo para uma pasta não tem efeito. Verifique se o navegador não salvou o arquivo como active.scifore-license.txt — a extensão oculta é uma armadilha frequente — e se a licença foi emitida para o identificador desta máquina: uma licença de outro computador é recusada.

Ingestão

“Nenhuma coluna válida encontrada”

O arquivo foi reconhecido como CSV, mas o cabeçalho não corresponde a nenhum dialeto conhecido. Verifique o separador (vírgula ou ponto e vírgula) e a codificação (UTF-8). Se o arquivo passou por um editor de planilhas, reexporte da base original.

Acentos aparecem corrompidos

Sintoma clássico de arquivo salvo em Latin-1 e lido como UTF-8. Reexporte com codificação UTF-8 em vez de converter — a conversão posterior costuma consolidar o erro.

Get-Content .\export.csv -Head 5

Muitos registros rejeitados

O relatório de ingestão lista o motivo de cada rejeição. Quase sempre é ausência de campo obrigatório, o que significa que a exportação foi feita com um perfil de campos incompleto. Veja o que marcar em Fontes suportadas.

Cocitação e acoplamento indisponíveis

Essas análises dependem das referências citadas. Na Web of Science, exporte com Full Record and Cited References; no Scopus, marque References em Customize export.

Análise

Um autor com produção implausível

É colisão de desambiguação: pessoas diferentes agrupadas sob a mesma entidade. Revise manualmente e reexecute — o procedimento está em Desambiguação de entidades.

Clusters duplicados no mapa

O oposto: fragmentação. A mesma entidade aparece em várias grafias e se espalha por comunidades diferentes. Ajuste as regras de consolidação e reconstrua o corpus.

O mapa saiu quase vazio

Verifique o limiar mínimo de ocorrências. Um limiar alto em um corpus pequeno elimina praticamente todos os nós. Reduza o limiar ou amplie o recorte temporal.

IA, busca semântica e análise de termos

“Selecione e instale um Transformer local em Configurações primeiro”

A busca semântica, a rede de similaridade e a análise de termos usam o modelo de embeddings local. Em Configurações, escolha a fonte de embeddings Transformer local, use a verificação do modelo e confirme o download (cerca de 91 MB, uma única vez) — depois disso ele funciona offline.

A rede de similaridade veio vazia ou avisa que o corpus não está indexado

A rede parte do índice vetorial das publicações. Abra a Busca semântica, use Criar índice e volte à rede. Se ela ainda ficar esparsa, reduza o limiar de similaridade ou aumente o número de vizinhos (k).

A análise de termos diz “dados insuficientes” ou “separação fraca”

É o diagnóstico de confiabilidade funcionando: com poucas ocorrências, ou com grupos que se sobrepõem, os sentidos não têm sustentação estatística. Use o K automático, amplie o intervalo de anos, tente uma variação do termo (singular/plural, sigla ou expansão) ou aumente o máximo de ocorrências analisadas.

O aplicativo avisa que falta a chave de API

A chave é por provedor, e o aviso nomeia o provedor do modelo de chat ativo. Cadastre a chave desse provedor em Configurações (Google, Anthropic, OpenAI, DeepSeek ou Voyage AI) ou troque o modelo ativo. As chaves ficam no cofre de credenciais do Windows.

Desempenho

A ingestão está muito lenta

Corpora acima de algumas dezenas de milhares de registros exigem memória. Feche outros aplicativos pesados, prefira ingerir tudo de uma vez em vez de repetir ingestões incrementais grandes, e confira o espaço livre em disco — os índices intermediários ocupam mais do que os arquivos de origem.

O mapa trava ao interagir

Renderizar milhares de nós simultaneamente é custoso. Aumente o limiar de ocorrências ou aplique um recorte temporal: além de destravar a interação, mapas menores comunicam melhor, como discutido em Mapas e visualizações.