把 Lispr 用到极致。
Lispr 是有意做得小巧的 — 没有设置窗口，没有账户，没有意外。本页介绍它能做什么、如何修复偶尔出岔子的少数情况，以及你的声音去了哪里。
首次设置
Lispr 在首次启动时会带你走完这些步骤 — 这里把同样的流程写下来，万一你需要重做。
1. 麦克风
Lispr 需要听到你。macOS 首次会询问；如果你错过了提示或撤销了权限，请在 系统设置 → 隐私与安全性 → 麦克风 中授予 — 打开 Lispr。
2. 辅助功能
Lispr 把识别的文本插入到光标所在位置 — 这需要「辅助功能」权限。请在 系统设置 → 隐私与安全性 → 辅助功能 中授予 — 打开 Lispr。
3. Input Monitoring（仅 macOS 10.15+）
以便 Lispr 在其他 App 处于前台时也能听见你按住触发键。请在 系统设置 → 隐私与安全性 → Input Monitoring 中授予。自 0.33 起，Lispr 通过 IOHIDRequestAccess 规范地请求该权限。
这些权限授予时既不会创建账户，也不会从你的机器发送任何东西到外面。它们只是解锁了 Lispr 真正工作所需的 macOS 部分。
日常使用
按住说话
按住右 ⌥ 键，开口说话，松开。文本会出现在任意 App 的光标处。就是这样 — 没有唤醒词、没有监听模式、没有设置。
锁定（免提）模式
双击触发键，Lispr 就会持续录音，直到你再次双击。需要双手自由时很有用。
录音中途取消
录音时按 Esc 即可丢弃你说的内容 — 不转写、不插入。
替代触发键
如果你 Mac 上的右 ⌥ 已被其他快捷键占用，Lispr 也支持 Fn 作为按住说话的触发键。
语言
Lispr 通过多语言的 Whisper 转写。语言自动检测 — 你甚至可以在句子中途切换，它能跟上。识别约 99 种语言，无需任何设置。
智能拼接句子
如果你口述一句，紧接着再口述一句，Lispr 会在两者之间加上句号和空格 — 不会出现连成一长串的句子。自动拼接只会在它自己上次插入之后发生，所以你自己输入的文本不会被动到。
剪贴板
Lispr 内部使用剪贴板来插入文本 — 但插入完后会立刻恢复你之前复制的内容。一个小时前复制的链接或段落，⌘V 还是会返还给你。
更新
Lispr 通过 Sparkle 自动更新 — 新版本签名后，已安装的 Lispr 会在下次启动时提示你。每个版本变更详见 更新日志。
故障排除
触发键没反应
- 检查 Input Monitoring 已授予（上文第 3 步）— 否则 Lispr 看不到后台 App 的按键。
- 确保没有其他 App 在抢右 ⌥ — Karabiner、BetterTouchTool、Raycast 热键、Magnet 等。如有，请从菜单栏图标把 Lispr 切到 Fn。
「我们没听清」
Lispr 会过滤极短和静音的录音（自 0.39 起）— 这些里 10 次有 9 次都是短暂的静默，而不是漏掉的话。如果出现这个提示而你 确实 说了话：开口前把键再多按住一会儿，并在菜单栏图标中检查所选的输入设备是否正确。
文本进到错的 App
Lispr 在你 松开 触发键的那一刻向当前聚焦的光标插入。如果你录音中途切换了 App，文本会进入新 App。提示：按住键之前先把光标放到目标位置。
菜单栏图标不见了
- 特别是在 macOS 11–12 上，早期构建（≤ 0.24）可能丢失图标 — 从 更新日志 页面升级到最新版；该问题已在 0.25 修复。
- 如果你用的是较新的 macOS 仍然看不见：可能是菜单栏太满，图标被藏在 Control Center / Bartender 下面。试试隐藏几个图标，给菜单栏腾点地方。
转写超时
如果你的网络抖了一下，Lispr 现在会在 10 秒后放弃（自 0.34 起），并显示一条友好的提示。再试一次 — 下一次请求通常会成功，因为 Lispr 在瞬时故障时也会自动重试（自 0.31 起）。
Sparkle 拉不到更新
DMG 和 appcast 都从 proxy.lispr.ai 经一条 TCP-only 路径提供（自 0.39 起）— 这能绕过部分网络上出现的 HTTP/3 问题。如果你的网络仍然封锁它，你随时可以直接从 lispr.ai 下载最新的 Lispr.dmg 手动替换应用。
10 分钟录音上限
Lispr 会在 10 分钟时停下单次录音，并显示本地化的提醒（自 0.37 起）— 这是一个软上限，避免意外的马拉松录音被一路放过。需要更长的口述时，松开再开始新的录音。
隐私速览
完整说明在 隐私政策；这里是大多数人会问的简短版。
我的声音去了哪里？
从你的 Mac 经加密连接到我们运营的边缘代理，再由它转发给 Groq 做转写。Groq 把文本返回，代理再把文本回到你的 Mac，音频立即被丢弃。什么也不存到服务器。什么也不用来训练模型。
有账户吗？
没有。没有注册、没有密码、没有资料。没有可登录的地方，因为没有可登录的地方。
日志呢？
自 0.40 起，出错时 Lispr 可以发送诊断用的 X-Lispr-* 请求头 — 这些是请求头（时间、错误码），不是音频也不是转写，并且我们不会在服务器侧保留它们。
能离线工作吗？
不能 — 转写在云端运行，正因为如此它才既快（自 0.41 起，端到端中位数约 300 毫秒）又准。如果你需要完全本地的听写，macOS 内置的「听写」是一个不错的替代；这就是我们在速度和语言覆盖上做出的取舍。