故障排除

大多数问题都源于以下三类原因之一：macOS 权限问题、会话设置与你的打字习惯不符，或过滤器悄悄排除了你当前使用的应用。请按以下步骤逐一排查——从最常见的原因开始。

Pulse 的工作原理

了解 Pulse 如何决定保存哪些数据，大多数问题便迎刃而解。Pulse 监听你击键的时间节奏，覆盖 Mac 上所有应用——从不记录字符本身——并将其归组为打字会话。一个会话只有在满足你设定的条件后才会被保存：最少字符数、最少单词数，以及用于划定会话边界的不活跃时间。

举例来说：如果你输入了一个单词，随后暂停的时间超过了不活跃时间，而你要求至少 4 个单词才算有效会话，那么这个单词就会被丢弃——它无法代表你的真实速度，因此不会进入统计。

另外，菜单栏中的数字会按照你设定的更新间隔定期刷新，因此显示的数据可能稍微滞后于你刚刚完成的输入——这是正常现象，不是 bug。

Pulse 没有保存会话

如果菜单栏显示为零、从不更新，或有一段时间没有记录任何新内容，最常见的原因是 macOS 权限问题。请按以下步骤逐一排查，找出问题所在。

第一步 — 确认 Pulse 能读取键盘

首先确认 Pulse 是否正在接收击键信号。最快的测试方法是从菜单栏打开 Live Metrics。Live Metrics HUD 是一个小型悬浮面板，实时显示你的打字速度——当你打字时，数字应随着你的节奏起伏变化。

如果速度随你的打字有所反应，说明 Pulse 能够读取键盘——这不是权限问题。请跳至检查会话设置。

如果你打字时数字始终为零，说明 Pulse 没有收到击键信号。请先从菜单栏退出 Pulse 并重新打开。如果仍然卡在零，则是权限问题——继续下一步。

第二步 — 检查"输入监控"权限

Pulse 通过 macOS 的输入监控权限统计击键次数。（部分旧教程提到了"辅助功能"——那是 Pulse 的旧方式；现在需要的权限是"输入监控"。）检查方法如下：

1. 打开系统设置 → 隐私与安全性 → 输入监控。
2. 在列表中找到 Pulse，确认其开关已开启。
3. 如果列表中没有 Pulse，点击 + 按钮，从"应用程序"文件夹中添加。（Pulse 首次启动时也会申请此权限——如果你在设置界面点击打开系统设置，会直接跳转到该列表。）

macOS 在 Pulse 启动时绑定此权限，因此开启权限后，Pulse 需要重启才能开始统计。Pulse 检测到授权后会主动提示重启；如有疑问，请从菜单栏退出 Pulse 并重新打开，然后再用 Live Metrics 测试。

第三步 — 权限已在列表中，但仍然无效

有时 macOS 会保留 Pulse 在列表中，但授权已失效——反复关闭再开启也没有效果。遇到这种情况，请按以下步骤彻底重置：

1. 从菜单栏退出 Pulse。
2. 在输入监控中，选中 Pulse 并点击 − 按钮将其移除。
3. 重启 Mac。
4. 返回输入监控，点击 + 按钮重新添加 Pulse，并确认开关已开启。
5. 打开 Pulse，用 Live Metrics 确认是否正常工作。

检查会话设置

如果 Live Metrics 显示速度正常，但会话仍然没有被保存，说明 Pulse 本身运行正常——只是当前设置与你的打字习惯不符，导致会话因不够长而被丢弃。

你可以实时观察这一过程。打开 Live Metrics HUD，输入一些内容，然后停下来。当你停止后，HUD 会展开显示本次会话结果：如果会话已保存，显示为绿色；如果因不满足最低要求而被丢弃，显示为红色。红色结果意味着你的阈值高于你实际的打字片段长度。Live Metrics 也会列出最近保存的会话。

Pulse 的行为与 Live Metrics 是否打开完全无关——HUD 只是让你实时看到判断结果。

在 Pulse 中打开设置，根据你的写作方式调整以下参数。（不是每次短暂输入都应该被保存——单个单词无法代表真实速度——因此这些阈值的作用是过滤会扭曲统计的零碎样本。）

• 不活跃时间 — 自上次击键起，Pulse 等待多少秒后结束当前会话。将其设置为你在任务中自然停顿的时长。超过此时间无操作后，Pulse 会关闭会话并与以下最低要求进行比对。
• 最少字符数 — 字符数低于此值的会话不会被保存。如果你经常打短片段，可以适当降低。
• 最少单词数 — 与上项相同，以单词数为单位。
• 更新间隔 — 菜单栏数字的刷新频率。Pulse 始终追踪每一次击键；此项只控制显示刷新速率，以降低资源占用。

还有一项设置可能影响结果：合成击键过滤器。Pulse 会丢弃粘贴、片段扩展、AppleScript 及其他自动化输入，以防其虚增速度。如果你的硬件或设置产生了被识别为自动化输入的击键，这个过滤器可能会误过滤正常打字——如果你有所怀疑，可以尝试将其关闭。

检查过滤模式

你可以在 设置 → 过滤 中指定 Pulse 追踪或排除哪些应用。当前所处的模式会影响哪些内容被保存，值得确认一下：

• 屏蔽列表模式 — Pulse 追踪所有应用，除了你添加到屏蔽列表的应用。如果你正在输入的应用在该列表中，相关内容不会被保存。
• 允许列表模式 — Pulse 只追踪你添加到列表中的应用，其他应用一律忽略。如果你正在输入的应用不在列表中，相关内容不会被保存。

如果你以为某个会话会被记录，但它始终没有出现，请检查该应用是否被屏蔽——或在允许列表模式下，该应用是否已被添加到追踪列表。

发送诊断日志

如果你已按上述步骤逐一排查，Pulse 仍然统计不正确，诊断日志可以让我们精确查看 Pulse 对每次击键的判断依据。日志默认关闭，完全保存在你的 Mac 本地——Pulse 不会上传。只有你主动选择分享时，才会发送给我们。

日志记录击键的元数据——按键位置、时间、当前活跃应用、当前输入法，以及 Pulse 的接受/丢弃决策——但从不记录你输入的字符或文本。无法通过日志还原你写了什么。

捕获并发送日志的步骤：

1. 在 Pulse 中打开设置 → 通用，找到诊断部分。
2. 开启诊断日志。日志会写入本地文件，并在 24 小时后自动关闭，避免遗忘的开关积累过多数据。
3. 复现问题——按照平时会话丢失时的方式正常打字。如果需要干净的记录，可以先点击清除日志重新开始。
4. 点击在访达中显示，打开日志文件夹（~/Library/Application Support/Pulse/DebugLogs/）。日志文件为 .jsonl 格式。
5. 将文件发送至 hello@utropia.es，并附上简短说明：你遇到了什么问题、你的 macOS 版本，以及 Pulse 版本（可在设置 → 关于中查看）。

完成后，请关闭诊断日志（或等待 24 小时自动关闭），并使用清除日志将捕获的文件从 Mac 上删除。

仍然卡住了？

Pulse 由一个人独立开发，每封邮件都由真人阅读。发邮件至 hello@utropia.es——或使用联系页面——我们会在几天内回复你。