Risoluzione problemi

La maggior parte dei problemi si riduce a una di queste tre cause: un permesso macOS, impostazioni di sessione che non corrispondono al tuo stile di digitazione, o un filtro che esclude silenziosamente l'app in cui stai scrivendo. Segui i passaggi seguenti nell'ordine indicato — vanno dal più comune al meno frequente.

Come funziona Pulse

Capire come Pulse decide cosa salvare rende la maggior parte dei problemi ovvi. Pulse osserva la cadenza dei tuoi tasti su tutto il Mac — mai i caratteri in sé — e li raggruppa in sessioni di digitazione. Una sessione viene salvata solo se supera le soglie che hai impostato: un numero minimo di caratteri, un numero minimo di parole e un tempo di inattività che segna dove finisce una sessione e inizia la successiva.

Ad esempio: se digiti una singola parola e poi fai una pausa più lunga del tuo Tempo di inattività, e hai impostato che una sessione valida richiede almeno 4 parole, quella parola viene scartata. Non è un campione significativo della tua velocità, quindi non raggiunge mai le tue statistiche.

Separatamente, il valore nella barra dei menu si aggiorna secondo una frequenza che controlli con Intervallo di aggiornamento — quindi il dato lì può essere leggermente in ritardo rispetto a quanto hai appena digitato. È normale, non un bug.

Pulse non salva le sessioni

Se la barra dei menu mostra zero, non si aggiorna mai, o non ha registrato nulla di nuovo da un po', la causa più comune è di gran lunga un problema di permessi in macOS. Segui i passaggi seguenti per capire esattamente dove si rompe qualcosa nella tua configurazione.

Passaggio 1 — Verifica che Pulse possa leggere la tastiera

Prima di tutto, verifica che Pulse stia ricevendo i tasti. Il test più rapido è aprire Live Metrics dalla barra dei menu. L'HUD Live Metrics è un piccolo pannello flottante che mostra la tua velocità di digitazione in tempo reale — quindi mentre scrivi, il numero dovrebbe salire e scendere con il tuo ritmo.

Se la velocità reagisce mentre digiti, Pulse riesce a leggere la tastiera — non è un problema di permessi. Salta direttamente a controllare le impostazioni di sessione.

Se rimane a zero mentre digiti, Pulse non sta ricevendo i tasti. Prima prova a chiudere Pulse dalla barra dei menu e riaprirlo. Se è ancora bloccato a zero, si tratta di un problema di permessi — continua al passaggio successivo.

Passaggio 2 — Controlla il permesso Monitoraggio input

Pulse conta i tasti tramite il permesso macOS Monitoraggio input. (Alcune guide meno recenti menzionavano Accessibilità — non è più così che funziona Pulse; il permesso necessario è Monitoraggio input.) Per verificarlo:

1. Apri Impostazioni di Sistema → Privacy e sicurezza → Monitoraggio input.
2. Trova Pulse nell'elenco e assicurati che il suo interruttore sia attivo.
3. Se Pulse non è nell'elenco, clicca il pulsante + e aggiungilo dalla cartella Applicazioni. (Pulse richiede questo permesso al primo avvio — se clicchi Apri Impostazioni di Sistema dalla schermata di configurazione, ti porta direttamente a questo elenco.)

macOS assegna questo permesso all'avvio di Pulse, quindi dopo averlo attivato Pulse deve essere riavviato per iniziare il conteggio. Pulse si offrirà di riavviarsi non appena rileva il permesso; in caso di dubbio, chiudilo dalla barra dei menu e riaprilo. Poi testa di nuovo con Live Metrics.

Passaggio 3 — Se è nell'elenco ma non funziona ancora

A volte macOS mantiene Pulse nell'elenco ma il permesso diventa obsoleto — disattivarlo e riattivarlo non risolve nulla. In quel caso, resettalo in modo pulito:

1. Chiudi Pulse dalla barra dei menu.
2. In Monitoraggio input, seleziona Pulse e rimuovilo con il pulsante −.
3. Riavvia il Mac.
4. Torna a Monitoraggio input e aggiungi di nuovo Pulse con il pulsante +, poi assicurati che il suo interruttore sia attivo.
5. Apri Pulse e verifica che funzioni con Live Metrics.

Controlla le impostazioni di sessione

Se Live Metrics mostra la tua velocità ma le sessioni non vengono comunque salvate, Pulse funziona correttamente — le tue impostazioni semplicemente non corrispondono al tuo stile di digitazione, quindi le sessioni vengono scartate perché troppo brevi.

Puoi osservarlo in diretta. Apri l'HUD Live Metrics e digita un po', poi fai una pausa. Quando ti fermi, l'HUD si espande per mostrare la sessione: appare in verde se la sessione è stata salvata, e in rosso se è stata scartata per non soddisfare i minimi. Un risultato rosso significa che le tue soglie sono più alte dei blocchi che digiti normalmente. Live Metrics mostra anche le sessioni salvate più di recente.

Pulse si comporta in modo identico sia che Live Metrics sia aperto sia che non lo sia — l'HUD ti permette solo di vedere la decisione in tempo reale.

Apri Impostazioni in Pulse e adatta questi valori al tuo modo di scrivere. (Non ogni blocco di testo dovrebbe essere salvato — una singola parola non è una misura equa della velocità — quindi queste soglie esistono per scartare i campioni che distorcerebbero le tue statistiche.)

• Tempo di inattività — secondi dall'ultimo tasto prima che Pulse chiuda la sessione in corso. Impostalo indicativamente sulla durata delle tue pause naturali durante il lavoro. Quando resti inattivo più a lungo di questo valore, Pulse chiude la sessione e la confronta con i minimi seguenti.
• Caratteri minimi — le sessioni con meno caratteri di questo valore non vengono salvate. Abbassalo se digiti in blocchi brevi.
• Parole minime — la stessa soglia, contata in parole.
• Intervallo di aggiornamento — con quale frequenza si aggiorna il valore nella barra dei menu. Pulse continua a tracciare ogni tasto; questo controlla solo la frequenza di visualizzazione per mantenere basso il consumo di risorse.

Un'altra impostazione può influire su questo: il Filtro tasti sintetici. Pulse scarta incolla, snippet expander, AppleScript e altri input automatizzati affinché non gonfino la tua velocità. Se il tuo hardware o la tua configurazione produce input che sembra automatizzato, questo filtro potrebbe scartare digitazione legittima — prova a disattivarlo se sospetti sia così.

Controlla la modalità dei filtri

Pulse può includere o escludere app specifiche in Impostazioni → Filtri. La modalità attiva cambia cosa viene salvato, quindi vale la pena verificare:

• Modalità esclusione — Pulse traccia tutte le app tranne quelle nella lista di blocco. Se l'app in cui stai digitando è in quella lista, nulla viene salvato.
• Modalità inclusione — Pulse traccia solo le app nella tua lista e ignora tutto il resto. Se l'app in cui stai digitando non è nella lista, nulla viene salvato.

Se ti aspettavi una sessione e non è mai apparsa, controlla se l'app è esclusa — oppure, in modalità inclusione, se è mai stata aggiunta alla lista di tracciamento.

Inviaci un log diagnostico

Se hai seguito i passaggi sopra e Pulse non conteggia ancora correttamente, un log diagnostico ci permette di vedere esattamente cosa ha deciso Pulse per ogni tasto e perché. Il log è disattivato per impostazione predefinita e rimane interamente sul tuo Mac — Pulse non lo carica mai. Lo condividi con noi solo quando lo scegli tu.

Il log registra i metadati dei tasti — posizioni dei tasti, timing, l'app in primo piano, la sorgente di input attiva e la decisione di accettare/scartare presa da Pulse — ma mai i caratteri o il testo che hai digitato. Non può essere utilizzato per ricostruire ciò che hai scritto.

Per acquisire e inviare un log:

1. In Pulse, apri Impostazioni → Generali e trova la sezione Diagnostica.
2. Attiva Registrazione diagnostica. Registra su un file locale e si disattiva automaticamente dopo 24 ore, così un interruttore dimenticato non accumula dati.
3. Riproduci il problema — digita come fai normalmente quando le sessioni scompaiono. Se vuoi un'acquisizione pulita, usa prima Cancella log per ripartire da zero.
4. Clicca Mostra nel Finder per aprire la cartella dei log (~/Library/Application Support/Pulse/DebugLogs/). I log sono file .jsonl.
5. Invia il/i file via email a hello@utropia.es con una breve descrizione di cosa hai visto, la tua versione di macOS e la versione di Pulse (indicata in Impostazioni → Informazioni).

Quando hai finito, disattiva Registrazione diagnostica (o lascia che la disattivazione automatica dopo 24 ore faccia il suo lavoro), e usa Cancella log se vuoi rimuovere i file acquisiti dal tuo Mac.

Ancora bloccato?

Pulse è sviluppato da una persona sola, e ogni messaggio viene letto da un essere umano. Scrivi a hello@utropia.es — oppure usa la pagina dei contatti — e ti risponderemo entro qualche giorno.