Solução de problemas

A maioria dos problemas cai em um de quatro grupos: permissões do macOS, configuração do provedor de IA, renomeações e licença, ou uma pasta que não está sendo monitorada. Ache o seu sintoma abaixo. Se nada aqui resolver, use o Exportar diagnóstico e mande um e-mail para a gente.

---

Os arquivos não estão sendo renomeados#

A Watch Folder não está ativa. Confira o estado de monitoramento da pasta na barra lateral: ela precisa aparecer como monitorada, com o Auto ligado para o processamento automático. Veja Watch Folders.

O NameQuick não consegue acessar a pasta. O macOS exige que você libere o acesso à pasta de forma explícita. Adicione a pasta de novo pelo botão + para o macOS mostrar o pedido de permissão outra vez, ou confira em Ajustes do Sistema → Privacidade e Segurança → Arquivos e Pastas.

O tipo de arquivo não é compatível. Confira os formatos de arquivo compatíveis. O NameQuick cobre mais de 30 formatos, mas não todos.

Você está no modo de conferência. Os nomes podem estar esperando a sua aprovação, em vez de terem falhado. Abra o app e veja a lista de arquivos a processar. Veja Modos de renomeação.

Problemas de permissão#

"O macOS bloqueou o auxiliar" (início automático no login): abra Ajustes do Sistema → Itens de Início de Sessão, permita o NameQuick em segundo plano e tente de novo. A mensagem dentro do app guia você por esses passos.

Automação do Finder: o NameQuick pede permissão de automação do Finder para que as renomeações sejam aplicadas na hora. Se você recusou uma vez, reative em Ajustes do Sistema → Privacidade e Segurança → Automação → NameQuick.

Notificações: se você não está vendo as notificações de lote concluído, libere o NameQuick em Ajustes do Sistema → Notificações.

Erros do provedor de IA#

"Adicione sua chave de API em Configurações → IA": o provedor selecionado está sem chave. Adicione uma (guia) ou mude para o Managed ou para um modelo local.

As renomeações falham mesmo com uma chave válida: normalmente a conta do provedor está sem crédito de cobrança. Confira o painel de faturamento do provedor; uma chave sem crédito por trás não funciona.

Erros de limite de uso ou de cota: o provedor está te limitando. Lotes menores ajudam; contas novas ganham limites maiores automaticamente depois de alguns dias.

"Falta um modelo de visão" em imagens ou PDFs digitalizados: o seu modelo local só trabalha com texto. Baixe um modelo com capacidade de visão e selecione-o em Configurações → IA (guia de modelos locais).

Keychain bloqueado ou indisponível: o NameQuick guarda as chaves no Keychain do macOS. Desbloqueie o keychain do seu Mac (normalmente ele desbloqueia no login) e tente de novo.

Modelo local inacessível: confirme que o servidor do Ollama ou do LM Studio está mesmo rodando e que o endereço em Configurações → IA bate (http://127.0.0.1:11434 para o Ollama, localhost:1234 para o LM Studio).

Renomeações, teste e licença#

Todo o detalhe operacional, como ativação, mudança de Mac e o que consome uma renomeação, está em Licença, teste e renomeações.

Teste esgotado: o teste Self-Managed inclui 50 renomeações, sem cartão e sem prazo; o teste do Managed dura 14 dias e inclui 50 renomeações, o que terminar primeiro. Quando acabar, escolha um plano em Configurações → Uso ou na página de preços: renomeações Managed a partir de US$ 12 por mês, ou a licença Self-Managed de US$ 69 uma única vez, com a sua própria chave ou um modelo local. Valores em dólar americano (USD).

Sem renomeações (Managed): as renomeações do seu mês acabaram. Em Configurações → Uso você vê o saldo e a data de renovação, e pode subir de faixa quando quiser. As renomeações não acumulam: elas são zeradas a cada período de faturamento mensal, e os planos anuais recebem as renomeações do ano inteiro de uma vez.

A licença não valida offline: o NameQuick tem períodos de tolerância offline, então ficar um tempo curto sem conexão não é problema. Se a validação continuar falhando com você online, confira o relógio do sistema e qualquer VPN ou firewall, e depois procure o suporte com o diagnóstico.

Problemas de reconhecimento de texto e de qualidade#

PDFs digitalizados recebem nomes genéricos: digitalizações de resolução muito baixa dão pouco material ao reconhecimento de texto. Digitalize de novo a 300 DPI quando der.

Os nomes saem no idioma errado: defina o idioma de saída que você prefere nas configurações; o NameQuick nomeia em vários idiomas.

Um nome saiu errado: toda renomeação é reversível. Ache o arquivo na visão Processados da Biblioteca e reverta; as datas originais ficam intactas de qualquer jeito.

---

Precisa de ajuda#

• Exportar diagnóstico pelo menu do app e anexe ao seu e-mail. O arquivo contém logs, não o conteúdo dos seus arquivos.
• Mostrar logs, se você quiser dar uma olhada antes.
• Escreva para support@namequick.app. Inclua a sua versão do macOS, o que você esperava e o que aconteceu. Tem gente de verdade do outro lado, e a resposta costuma ser rápida.
• Ideias de recurso e roteiro do produto: namequick.featurebase.app/roadmap.