ヘルプ · Pulse

トラブルシューティング

多くの問題は、次の 3 つのいずれかに起因します。macOS の権限の問題、セッション設定が実際の入力スタイルと合っていない、またはフィルターが使用中のアプリをひそかに除外している——のどれかです。以下の手順を上から順に試してください。発生頻度の高い原因から並んでいます。

Pulse の仕組み

Pulse がどのようにデータを保存するかを理解すると、ほとんどの問題の原因がはっきりします。Pulse は Mac 全体にわたってキーストロークのタイミングを監視します——入力した文字の内容は一切記録しません——そしてそのキーストロークをタイピングセッションとしてまとめます。セッションが保存されるのは、あなたが設定した条件をクリアした場合のみです。条件は「最小文字数」「最小単語数」、そして一つのセッションの終わりと次の始まりを区切る「非アクティブ時間」の 3 つです。

例を挙げます。単語を 1 つ入力してから非アクティブ時間より長く間が空き、かつセッションの最小単語数を 4 語に設定している場合、その入力は破棄されます。速度の有意なサンプルとならないため、統計には反映されません。

別の話として、メニューバーの数値は更新間隔の設定に従ってリフレッシュされます。そのため、今入力した内容より少し遅れて表示されることがあります。これは仕様であり、バグではありません。

Pulse がセッションを保存しない

メニューバーがゼロのまま、更新されない、または最近まったく記録されていない場合、圧倒的に多い原因は macOS の権限の問題です。以下の手順で、どこに問題があるかを順番に確認してください。

ステップ 1 — Pulse がキーボードを認識できているか確認する

まず、Pulse がキーストロークを受け取っているかどうかを確認します。最も手軽なテストは、メニューバーから Live Metrics を開くことです。Live Metrics HUD はリアルタイムでタイピング速度を表示する小さなフローティングパネルです。入力中、数値は入力のペースに合わせて上下するはずです。

入力に反応して数値が動く場合、Pulse はキーボードを正常に認識できています——権限の問題ではありません。セッション設定の確認に進んでください。

入力してもゼロのままの場合、Pulse がキーストロークを受け取っていません。まずメニューバーから Pulse を終了して再起動してください。それでもゼロのままであれば、権限の問題です——次のステップに進んでください。

ステップ 2 — 入力監視の権限を確認する

Pulse はキーストロークのカウントに macOS の入力監視権限を使用しています。（古いガイドにはアクセシビリティと書かれているものがありますが、現在の Pulse はその方法を使っていません。必要な権限は「入力監視」です。）確認方法は次のとおりです。

システム設定 → プライバシーとセキュリティ → 入力監視 を開きます。
リストから Pulse を探し、トグルがオンになっていることを確認します。
Pulse がリストにない場合は、+ ボタンをクリックして「アプリケーション」フォルダから追加してください。（Pulse は初回起動時にこの権限を求めます。設定画面の 「システム設定を開く」 ボタンをタップすると、このリストに直接移動できます。）

macOS はこの権限を Pulse の起動時に適用します。そのため、権限をオンにした後は Pulse を再起動しないとカウントが始まりません。権限の付与を検知すると Pulse が自動で再起動を提案します。迷ったときはメニューバーから終了して再度開いてください。その後、Live Metrics で動作を確認してください。

ステップ 3 — リストにあるのに動作しない場合

権限が古い状態で残り、トグルをオフ・オンしても変化しないことがあります。その場合は、次の手順でリセットしてください。

メニューバーから Pulse を終了します。
入力監視 で Pulse を選択し、− ボタンで削除します。
Mac を再起動します。
入力監視 に戻り、+ ボタンで Pulse を追加し直して、トグルがオンになっていることを確認します。
Pulse を開き、Live Metrics で正常に動作しているか確認します。

セッション設定を確認する

Live Metrics で速度が表示されているのにセッションが保存されない場合、Pulse 自体は正常に動作しています——設定が実際の入力スタイルと合っていないため、セッションが短すぎると判断されて破棄されています。

この判断はリアルタイムで確認できます。Live Metrics HUD を開いて少し入力し、止まってみてください。入力を止めると HUD がセッションの詳細を展開して表示します。セッションが保存された場合は緑色、最小条件を満たさず破棄された場合は赤色で表示されます。赤が続く場合は、設定しているしきい値が実際の入力量より高すぎるということです。Live Metrics には最近保存されたセッションも一覧表示されます。

Live Metrics を開いていても閉じていても、Pulse の動作はまったく同じです——HUD はその判断をリアルタイムで可視化するだけです。

Pulse の設定を開き、自分の入力スタイルに合わせてこれらを調整してください。（すべてのバーストを保存する必要はありません——単語 1 つでは速度の公平な指標になりません——そのため、統計を歪める可能性のある短いサンプルを除外するためにしきい値が存在します。）

非アクティブ時間 — 最後のキーストロークからこの秒数が経過すると、Pulse が現在のセッションを終了します。作業中に自然と生じる間の長さに合わせて設定してください。この時間より長く入力が止まると、セッションが閉じられ、以下の最小条件と照合されます。
最小文字数 — これより少ない文字数のセッションは保存されません。短いバーストが多い場合は値を下げてください。
最小単語数 — 同じしきい値を単語数で計測したものです。
更新間隔 — メニューバーの数値がリフレッシュされる頻度です。Pulse はすべてのキーストロークを継続的に記録しています。この設定は表示の更新頻度を制御するだけで、リソース使用量を低く保つためのものです。

もう一つ影響する設定があります。合成キーストロークフィルターです。Pulse はペースト、スニペット展開、AppleScript などの自動入力を除外し、速度が不当に高くなるのを防いでいます。ハードウェアや設定環境によって正当な入力が自動入力と判定される場合、このフィルターが通常のタイピングを破棄することがあります。心当たりがある場合はフィルターをオフにして試してみてください。

フィルターモードを確認する

Pulse は 設定 → フィルター で特定のアプリを含める・除外することができます。どのモードになっているかによって保存されるデータが変わるため、確認する価値があります。

除外モード — ブロックリストに登録したアプリ以外のすべてのアプリを計測します。今入力しているアプリがリストにある場合、そのデータは保存されません。
許可リストモード — リストに登録したアプリだけを計測し、それ以外は無視します。今入力しているアプリがリストにない場合、何も保存されません。

セッションが記録されると思っていたのに表示されない場合は、そのアプリが除外されていないか——または許可リストモードのときは、追跡リストに追加されているか——を確認してください。

診断ログを送る

上記の手順をすべて試しても Pulse が正しくカウントしない場合、診断ログを使うと各キーストロークについて Pulse がどのような判断を下したかを詳しく確認できます。ログはデフォルトでオフになっており、すべてお使いの Mac 上にのみ保存されます——Pulse がアップロードすることはありません。送信するかどうかはご自身で判断していただきます。

ログが記録するのはキーストロークのメタデータ——キーの位置、タイミング、最前面にあるアプリ、アクティブな入力ソース、Pulse が下した受理/破棄の判定——のみです。入力した文字やテキストは一切記録しません。ログから入力内容を復元することはできません。

ログを取得して送るには、以下の手順で行ってください。

Pulse の 設定 → 一般 を開き、診断セクションを確認します。
診断ログ をオンにします。ローカルファイルに記録され、24 時間後に自動でオフになるため、切り忘れてもログが際限なく蓄積されることはありません。
問題を再現します——セッションが記録されないときと同じように普段どおり入力してください。クリーンなログを取りたい場合は、先に ログをクリア して初期化してください。
Finder で表示 をクリックしてログフォルダ（~/Library/Application Support/Pulse/DebugLogs/）を開きます。ログは .jsonl ファイルです。
そのファイルを hello@utropia.es にメールで送付してください。その際、確認した症状、お使いの macOS のバージョン、および Pulse のバージョン（設定 → Pulse について に表示されます）を簡単にお書き添えください。

完了したら、診断ログ をオフに戻してください（24 時間の自動オフに任せても構いません）。Mac からログファイルを削除したい場合は ログをクリア を使用してください。

まだ解決しない場合

Pulse は一人の開発者が作っており、届いたメッセージは人が読んでいます。hello@utropia.es にメールするか、お問い合わせページからご連絡ください。数日以内にご返答します。