Solução de problemas

A maioria dos problemas se resume a uma de três coisas: uma permissão do macOS, configurações de sessão que não batem com o jeito que você digita, ou um filtro silenciosamente excluindo o app em que você está. Siga os passos abaixo em ordem — eles vão do mais comum ao menos comum.

Como o Pulse funciona

Entender como o Pulse decide o que salvar torna a maioria dos problemas óbvia. O Pulse observa o tempo dos seus pressionamentos de tecla em todo o Mac — nunca os caracteres em si — e os agrupa em sessões de digitação. Uma sessão só é salva quando cumpre os critérios que você definiu: um número mínimo de caracteres, um número mínimo de palavras e um tempo de inatividade que marca onde uma sessão termina e a próxima começa.

Por exemplo: se você digitar uma única palavra e pausar por mais tempo do que o seu Tempo de inatividade, e tiver configurado que uma sessão válida precisa de pelo menos 4 palavras, essa palavra é descartada. Não é uma amostra significativa da sua velocidade, então nunca chega às suas estatísticas.

Separadamente, o número na barra de menus é atualizado em um intervalo que você controla com o Intervalo de atualização — então o valor exibido pode ficar um pouco atrás do que você acabou de digitar. Isso é esperado, não é um problema.

Pulse não está salvando sessões

Se a barra de menus mostra zero, nunca é atualizada ou não registrou nada de novo há um tempo, a causa mais comum de longe é um problema de permissão no macOS. Siga os passos abaixo para descobrir exatamente onde está quebrando na sua configuração.

Passo 1 — Verificar se o Pulse consegue ler o teclado

Primeiro, confirme se o Pulse está recebendo pressionamentos de tecla. O teste mais rápido é abrir o Live Metrics pela barra de menus. O HUD de Live Metrics é um pequeno painel flutuante que mostra sua velocidade de digitação em tempo real — então enquanto você digita, o número deve subir e descer com seu ritmo.

Se a velocidade reagir enquanto você digita, o Pulse consegue ler seu teclado — não é um problema de permissão. Avance para verificar as configurações de sessão.

Se ficar em zero enquanto você digita, o Pulse não está recebendo pressionamentos. Primeiro, saia do Pulse pela barra de menus e reabra. Se ainda travar em zero, é um problema de permissão — continue para o próximo passo.

Passo 2 — Verificar a permissão de Monitoramento de Entrada

O Pulse conta pressionamentos de tecla através da permissão de Monitoramento de Entrada do macOS. (Guias antigos mencionavam Acessibilidade — não é mais assim que o Pulse funciona; a permissão que você precisa é Monitoramento de Entrada.) Para verificá-la:

1. Abra Ajustes do Sistema → Privacidade e Segurança → Monitoramento de Entrada.
2. Encontre o Pulse na lista e certifique-se de que a chave está ativada.
3. Se o Pulse não estiver na lista, clique no botão + e adicione-o da sua pasta Aplicativos. (O Pulse também solicita essa permissão na primeira execução — se você clicar em Abrir Ajustes do Sistema na tela de configuração, ele leva direto para essa lista.)

O macOS vincula essa permissão quando o Pulse é iniciado, então depois de ativá-la, o Pulse precisa ser reiniciado para começar a contar. O Pulse vai oferecer para reiniciar assim que detectar a permissão concedida; em caso de dúvida, saia pela barra de menus e reabra. Depois teste novamente com Live Metrics.

Passo 3 — Se ele está na lista mas ainda não funciona

Às vezes o macOS mantém o Pulse na lista, mas a permissão fica desatualizada — desativar e reativar não resolve. Quando isso acontecer, redefina de forma limpa:

1. Saia do Pulse pela barra de menus.
2. Em Monitoramento de Entrada, selecione o Pulse e remova-o com o botão −.
3. Reinicie o Mac.
4. Volte em Monitoramento de Entrada e adicione o Pulse novamente com o botão +, certificando-se de que a chave está ativada.
5. Abra o Pulse e confirme que está funcionando com Live Metrics.

Verificar as configurações de sessão

Se o Live Metrics mostra sua velocidade mas as sessões ainda não estão sendo salvas, o Pulse está funcionando corretamente — suas configurações simplesmente não combinam com o jeito que você digita, então suas sessões estão sendo descartadas por serem curtas demais para contar.

Você pode acompanhar isso ao vivo. Abra o HUD de Live Metrics e digite um pouco, depois pause. Quando parar, o HUD abre para mostrar a sessão: aparece em verde se a sessão foi salva, e em vermelho se foi descartada por não atingir os mínimos. Um resultado vermelho significa que seus limites são mais altos do que as rajadas que você realmente digita. O Live Metrics também lista suas sessões salvas mais recentes.

O Pulse se comporta exatamente igual com ou sem o Live Metrics aberto — o HUD apenas deixa você ver a decisão em tempo real.

Abra as Configurações no Pulse e ajuste esses valores para combinar com o jeito que você escreve. (Nem toda rajada deve ser salva — uma única palavra não é uma medida justa de velocidade — por isso esses limites existem para descartar amostras que distorceriam suas estatísticas.)

• Tempo de inatividade — segundos desde o último pressionamento antes de o Pulse encerrar a sessão atual. Defina como o tempo em que você naturalmente pausa no meio de uma tarefa. Quando você ficar ocioso por mais tempo do que isso, o Pulse fecha a sessão e a verifica contra os mínimos abaixo.
• Mínimo de caracteres — sessões com menos caracteres do que esse valor não são salvas. Reduza se você digita em rajadas curtas.
• Mínimo de palavras — o mesmo limite, contado em palavras.
• Intervalo de atualização — com que frequência o número na barra de menus é atualizado. O Pulse ainda rastreia cada pressionamento; isso controla apenas a taxa de exibição para manter o uso de recursos baixo.

Mais uma configuração pode afetar isso: o filtro de pressionamentos sintéticos. O Pulse descarta colagens, expansores de fragmentos, AppleScript e outras entradas automatizadas para que não inflem sua velocidade. Se seu hardware ou configuração gerar entradas que pareçam automatizadas, esse filtro pode descartar digitações legítimas — tente desativá-lo se suspeitar disso.

Verificar o modo de filtro

O Pulse pode incluir ou excluir apps específicos em Configurações → Filtros. O modo em que você está muda o que é salvo, por isso vale confirmar:

• Modo de exclusão — o Pulse rastreia todos os apps, exceto os da sua lista de bloqueio. Se o app em que você está digitando estiver nessa lista, nada dele é salvo.
• Modo de inclusão — o Pulse rastreia somente os apps da sua lista e ignora todo o resto. Se o app em que você está digitando não estiver na lista, nada é salvo.

Se você esperava uma sessão e ela nunca apareceu, verifique se o app está excluído — ou, no modo de inclusão, se ele foi alguma vez adicionado à lista de rastreamento.

Enviar um log de diagnóstico

Se você seguiu todos os passos acima e o Pulse ainda não está contando corretamente, um log de diagnóstico nos permite ver exatamente o que o Pulse decidiu para cada pressionamento e por quê. O log fica desativado por padrão e permanece inteiramente no seu Mac — o Pulse nunca o envia. Você o compartilha conosco apenas quando escolher.

O log registra metadados de pressionamentos — posição das teclas, tempo, o app em primeiro plano, a fonte de entrada ativa e a decisão de aceitar/descartar que o Pulse tomou — mas nunca os caracteres ou textos que você digitou. Não é possível usá-lo para reconstruir o que você escreveu.

Para capturar e enviar um log:

1. No Pulse, abra Configurações → Geral e encontre a seção Diagnósticos.
2. Ative o Log de diagnóstico. Ele grava em um arquivo local e se desativa automaticamente após 24 horas, para que uma chave esquecida nunca acumule dados.
3. Reproduza o problema — digite do jeito que você normalmente faz quando as sessões somem. Se quiser uma captura limpa, use Limpar logs antes para começar do zero.
4. Clique em Mostrar no Finder para abrir a pasta de logs (~/Library/Application Support/Pulse/DebugLogs/). Os logs são arquivos .jsonl.
5. Envie o(s) arquivo(s) por e-mail para hello@utropia.es com uma breve descrição do que você viu, sua versão do macOS e a versão do Pulse (exibida em Configurações → Sobre).

Quando terminar, desative o Log de diagnóstico (ou deixe o desligamento automático de 24 horas cuidar disso), e use Limpar logs se quiser remover os arquivos capturados do seu Mac.

Ainda travado?

O Pulse é feito por uma equipe de uma pessoa só, e um humano lê cada mensagem. Envie um e-mail para hello@utropia.es — ou use a página de contato — e responderemos em alguns dias.