Resolução de problemas

Cada entrada tem o sintoma, a causa e o que fazer. As mensagens do lançador aparecem em português, com o prefixo ploy:. Quando uma causa ou uma solução ainda não está documentada, a entrada di-lo.

O Ollama não está instalado ou não arranca#

Sintoma: ploy: o Ollama não está instalado (brew install ollama). ou ploy: o Ollama não arrancou (ver ~/Library/Logs/ploy-ollama.log).

Causa. O comando ollama não existe, ou o servidor não respondeu em 30 segundos depois de o lançador o iniciar.

O que fazer. Instala o Ollama. Se não arrancou, lê o registo em ~/Library/Logs/ploy-ollama.log.

Falta o modelo base#

Sintoma: ploy: falta o modelo base. Corre: ollama pull qwen3:8b

Causa. O Ploy cria o qwen3-ploy a partir do qwen3:8b, que não está descarregado.

O que fazer. Corre ollama pull qwen3:8b e abre o Ploy outra vez.

O modelo precisa de ser recriado#

Sintoma: ploy: não consegui criar o modelo.

Causa. O lançador recria o qwen3-ploy quando não existe, ou quando o seu template ainda não deixa o pedido ligar e desligar o raciocínio. A criação falhou. As causas possíveis desta falha não estão documentadas.

O que fazer. Confirma que o qwen3:8b existe e, na pasta do código, corre ollama create qwen3-ploy -f bench/Modelfile.qwen3-ploy.

O modelo demora a carregar#

Sintoma: ploy: aviso: o modelo não carregou a tempo.

Causa. O pré-carregamento espera 180 segundos. Além disso, as definições do servidor Ollama que o lançador escolhe (um pedido de cada vez, um modelo em memória, 15 minutos de permanência) só se aplicam quando é ele a iniciar o Ollama. Se já estava a correr, ficam as dele.

O que fazer. Espera e tenta outra vez. Para o lançador aplicar as definições, termina o Ollama que estava a correr e abre o Ploy.

A janela fica à espera ao abrir uma pasta em Documentos#

Sintoma: o serviço de uma app nova fica pendurado, sem erro.

Causa. O macOS protege a pasta Documentos app a app, e o serviço fica à espera de que respondas a um diálogo de permissão.

O que fazer. Responde ao diálogo. Para o evitar, o projeto predefinido do Ploy fica em ~/Projetos Ploy/Projeto Padrão e os projetos novos do Nesko ficam em ~/Projetos Ploy.

O botão do microfone mostra "Não consegui transcrever"#

Causa. A mensagem é a mesma para várias falhas: o macOS não deu acesso ao microfone (pergunta na primeira vez que carregas no botão), falta o ffmpeg ou o whisper-cli (o Ploy procura-os no PATH, em /opt/homebrew/bin e em /usr/local/bin), falta o modelo ggml-small.bin, ou a gravação passa de 20 MB.

O que fazer. Responde ao pedido do macOS e confirma os dois programas. O modelo deve estar na pasta models, dentro da pasta de dados, ou no caminho de PLOY_WHISPER_MODEL. Como repor uma permissão do microfone já recusada ainda não está documentado.

O Ploy escreve português do Brasil#

Causa. O Qwen3 desvia-se para o português do Brasil mesmo quando lhe dizem para não o fazer. O Ploy repete a regra no fim de cada pedido em português e passa as respostas por um filtro. O filtro só troca palavras do Brasil que têm um equivalente exato em Portugal (os termos brasileiros para ficheiro, utilizador e equipa, por exemplo) e a construção progressiva com gerúndio. Não toca em código, nomes de ficheiros, endereços nem palavras com maiúscula a meio da frase, e as palavras ambíguas não estão na lista. Um modelo em bruto usado pelo nome não passa pelo filtro.

O que fazer. Pede para reescrever em português de Portugal e usa os modelos Ploy.

A conversa perde o fio, ou a página vem cortada#

Causa. A janela de contexto é de 16 384 tokens. Uma conversa longa é compactada num resumo, e o browser corta a página aos 6000 caracteres.

O que fazer. Para um assunto novo, abre uma conversa nova. Guarda o que importa com /lembrar, e noutra conversa escreve @ para citar a memória desta. Numa página cortada, pede ao modelo para procurar a parte de que precisas.

O Ploy pergunta tudo depois de ler a web#

Sintoma: o pedido diz que uma página web foi lida e que a ação precisa da tua confirmação.

Causa. A conversa ficou marcada com ploy_tainted. Ver Segurança.

O que fazer. Lê cada pedido e decide. Para trabalho que não precisa da web, abre uma conversa nova, que começa sem a marca.

O browser recusa abrir um segundo site#

Sintoma: a mensagem diz que a sessão já leu uma página e que abrir outro site precisa da pessoa.

Causa. É a regra de um só site de browser_open. Depois de uma página ser lida, só abre sites já visitados nessa conversa. Não há uma confirmação que levante a regra na mesma conversa.

O que fazer. Abre uma conversa nova para o outro site.

As ferramentas de browser não funcionam#

Sintoma: nem aparecem, ou respondem No page is open yet ou That page was closed.

Causa. As ferramentas só funcionam em conversas abertas na janela da app. A primeira mensagem quer dizer que o modelo tentou ler ou clicar antes de abrir um endereço. A segunda, que o separador foi fechado.

O que fazer. Usa a janela, não o terminal, e pede ao modelo para abrir o endereço outra vez.

O Veta responde sem pesquisar#

Sintoma: a linha de progresso diz que a pesquisa está desligada, que não leu nenhuma fonte, ou que não conseguiu proteger a conversa.

Causa. Pode ser PLOY_WEB=0. Pode não haver páginas legíveis (resultados vazios, páginas não públicas, com menos de 200 caracteres de texto, ou que demoraram mais de 15 segundos). Ou a conversa não pôde ser marcada e o Veta, por segurança, não usa o que leu.

O que fazer. Tira PLOY_WEB=0, reformula o pedido e tenta outra vez.

O Nesko parou ou deixou passos bloqueados#

Causa. Um passo que falha três vezes fica bloqueado e a execução segue para os outros. A execução em si pára quando o modelo não consegue escrever os documentos ou um plano utilizável, quando o plano não é aprovado (ou não chega a ser aprovado em três rondas), quando a pessoa a pára, ou quando o serviço que a executava desaparece.

O que fazer. O cartão por cima do compositor mostra o motivo e o último resultado de cada passo. Escreve continuar para retomar e parar para parar. Ver Nesko.

Outros casos#

• Não vejo o qwen3-ploy no seletor. Os modelos Ollama em bruto estão escondidos de propósito. Define PLOY_SHOW_RAW_MODELS=1 ou usa-os pelo nome (ollama/qwen3-ploy).
• O ploy run fica à espera num script. Com o stdin fora de um terminal, o ploy run lê-o até fechar. Acrescenta < /dev/null.
• binário não encontrado, a correr a partir do código-fonte. Falta a versão compilada. Compila-a:

cd packages/cli && PLOY_BUN_RANGE=">=1.3.14" bun run script/build.ts --single --skip-install --skip-web-ui