Resolução de problemas

A maioria dos problemas resume-se a uma de três coisas: uma permissão do macOS, as definições de sessão que não correspondem à forma como escreves, ou um filtro que exclui silenciosamente a app em que estás a trabalhar. Segue os passos abaixo por ordem — vão do mais comum para o menos frequente.

Como funciona o Pulse

Perceber como o Pulse decide o que guardar torna a maioria dos problemas óbvios. O Pulse observa o ritmo das tuas teclas no Mac — nunca os próprios caracteres — e agrupa-as em sessões de escrita. Uma sessão só é guardada quando cumpre os critérios que definiste: 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 seguinte começa.

Por exemplo: se escreves uma única palavra e depois fazes uma pausa mais longa do que o teu Tempo de inatividade, e tens uma sessão válida configurada para exigir pelo menos 4 palavras, essa palavra é descartada. Não é uma amostra representativa da tua velocidade, pelo que nunca chega às tuas estatísticas.

Separadamente, o valor na barra de menus atualiza-se com a periodicidade que controlas através do Intervalo de atualização — por isso pode ficar ligeiramente atrasado em relação ao que acabaste de escrever. Isso é esperado, não é um erro.

O Pulse não está a guardar sessões

Se a barra de menus mostra zero, nunca atualiza ou não registou nada de novo há algum tempo, a causa mais comum é um problema de permissões no macOS. Segue os passos abaixo para perceber exatamente onde a tua configuração está a falhar.

Passo 1 — Confirma que o Pulse consegue ler o teclado

Primeiro, confirma que o Pulse está a receber teclas. O teste mais rápido é abrir as Métricas em direto a partir da barra de menus. O HUD de Métricas em direto é um pequeno painel flutuante que mostra a tua velocidade de escrita em tempo real — por isso, enquanto escreves, o número deve subir e descer com o teu ritmo.

Se a velocidade reage enquanto escreves, o Pulse consegue ler o teclado — este não é um problema de permissões. Avança para verificar as definições de sessão.

Se ficar em zero enquanto escreves, o Pulse não está a receber teclas. Primeiro, sai do Pulse pela barra de menus e volta a abri-lo. Se ainda ficar em zero, é um problema de permissões — continua para o passo seguinte.

Passo 2 — Verifica a permissão de Monitorização de entradas

O Pulse conta teclas através da permissão de Monitorização de entradas do macOS. (Guias mais antigos mencionavam Acessibilidade — já não é assim que o Pulse funciona; a permissão de que precisas é Monitorização de entradas.) Para verificar:

1. Abre as Definições do Sistema → Privacidade e Segurança → Monitorização de entradas.
2. Localiza o Pulse na lista e confirma que o respetivo botão está ativado.
3. Se o Pulse não estiver na lista, clica no botão + e adiciona-o a partir da pasta Aplicações. (O Pulse também solicita esta permissão no primeiro arranque — se clicares em Abrir Definições do Sistema no ecrã de configuração, vai diretamente para esta lista.)

O macOS vincula esta permissão quando o Pulse arranca, pelo que depois de a ativares, o Pulse precisa de ser reiniciado para começar a contar. O Pulse oferece-se para reiniciar assim que deteta a concessão; em caso de dúvida, sai pela barra de menus e volta a abri-lo. Depois testa novamente com as Métricas em direto.

Passo 3 — Se estiver na lista mas ainda não funcionar

Por vezes o macOS mantém o Pulse na lista mas a concessão fica obsoleta — desativar e reativar não resolve. Quando isso acontece, repõe de forma limpa:

1. Sai do Pulse pela barra de menus.
2. Em Monitorização de entradas, seleciona o Pulse e remove-o com o botão −.
3. Reinicia o Mac.
4. Volta a Monitorização de entradas e adiciona o Pulse com o botão +, certificando-te de que o botão fica ativado.
5. Abre o Pulse e confirma que está a funcionar com as Métricas em direto.

Verifica as definições de sessão

Se as Métricas em direto mostram a tua velocidade mas as sessões ainda não estão a ser guardadas, o Pulse está a funcionar corretamente — as tuas definições é que não correspondem à forma como escreves, pelo que as sessões estão a ser descartadas por serem demasiado curtas para contar.

Podes observar isto em direto. Abre o HUD de Métricas em direto e escreve um pouco, depois faz uma pausa. Quando paras, o HUD abre-se para mostrar a sessão: aparece a verde se a sessão foi guardada, e a vermelho se foi descartada por não cumprir os mínimos. Um resultado vermelho significa que os teus limiares são mais altos do que os intervalos de escrita que praticas. As Métricas em direto também listam as sessões guardadas mais recentes.

O Pulse comporta-se exatamente da mesma forma quer as Métricas em direto estejam abertas ou não — o HUD apenas permite ver a decisão em tempo real.

Abre as Definições no Pulse e ajusta estes valores para se adequarem à forma como escreves. (Nem todos os intervalos devem ser guardados — uma única palavra não é uma medida representativa da velocidade — por isso estes limiares existem para descartar amostras que distorceriam as tuas estatísticas.)

• Tempo de inatividade — segundos desde a última tecla antes de o Pulse encerrar a sessão atual. Define-o para corresponder ao tempo que habitualmente pausas no meio de uma tarefa. Quando ficas parado mais tempo do que este valor, o Pulse fecha a sessão e verifica se cumpre os mínimos abaixo.
• Mínimo de caracteres — sessões com menos caracteres do que este valor não são guardadas. Baixa-o se escreves em intervalos curtos.
• Mínimo de palavras — o mesmo limiar, contado em palavras.
• Intervalo de atualização — com que frequência o valor na barra de menus é atualizado. O Pulse continua a registar todas as teclas; isto apenas controla a taxa de atualização do mostrador para manter o uso de recursos baixo.

Mais uma definição pode afetar isto: o Filtro de teclas sintéticas. O Pulse ignora colas, expansores de snippets, AppleScript e outras entradas automatizadas para que não inflacionem a tua velocidade. Se o teu hardware ou configuração produz entrada com aspeto automatizado, este filtro pode descartar escrita legítima — tenta desativá-lo se suspeitares disso.

Verifica o modo de filtros

O Pulse pode incluir ou excluir apps específicas em Definições → Filtros. O modo em que estás altera o que é guardado, por isso vale a pena confirmar:

• Modo de exclusão — o Pulse monitoriza todas as apps exceto as que estão na tua lista de bloqueio. Se a app em que estás a escrever estiver nessa lista, nada dela é guardado.
• Modo de inclusão — o Pulse monitoriza apenas as apps da tua lista e ignora todo o resto. Se a app em que estás a escrever não estiver na lista, nada é guardado.

Se esperavas uma sessão e ela nunca apareceu, verifica se a app está excluída — ou, em modo de inclusão, se alguma vez foi adicionada à lista monitorizada.

Envia-nos um registo de diagnóstico

Se seguiste os passos acima e o Pulse ainda não está a contar corretamente, um registo de diagnóstico permite-nos ver exatamente o que o Pulse decidiu para cada tecla e porquê. O registo está desativado por predefinição e fica inteiramente no teu Mac — o Pulse nunca o envia. Partilhas-no connosco apenas quando o escolheres fazer.

O registo guarda metadados de teclas — posições de teclas, temporização, a 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 o texto que escreveste. Não pode ser usado para reconstruir o que escreveste.

Para capturar e enviar um registo:

1. No Pulse, abre Definições → Geral e localiza a secção Diagnósticos.
2. Ativa o Registo de diagnóstico. Guarda num ficheiro local e desativa-se automaticamente ao fim de 24 horas para que um botão esquecido não acumule dados.
3. Reproduz o problema — escreve da forma como costumas escrever quando as sessões desaparecem. Se quiseres uma captura limpa, usa Limpar registos primeiro para começar do zero.
4. Clica em Mostrar no Finder para abrir a pasta de registos (~/Library/Application Support/Pulse/DebugLogs/). Os registos são ficheiros .jsonl.
5. Envia o(s) ficheiro(s) por e-mail para hello@utropia.es com uma breve nota a descrever o que observaste, a tua versão do macOS e a tua versão do Pulse (indicada em Definições → Acerca de).

Quando terminares, desativa o Registo de diagnóstico (ou deixa que o desligamento automático das 24 horas trate disso) e usa Limpar registos se quiseres remover os ficheiros capturados do teu Mac.

Ainda com problemas?

O Pulse é desenvolvido por uma equipa de uma pessoa, e um humano lê cada mensagem. Envia um e-mail para hello@utropia.es — ou usa a página de contacto — e responderemos em poucos dias.