听写

按下按住说话键，说话，松开。松开之后整段语句会被一次性转写，文字随即插入到最前面的应用里。

按住说话键

Settings（设置）› Push-to-talk hotkey："Hold this key to dictate; release to insert." 改动即时生效。

• Fn / Globe
• 左 ⌘
• 右 ⌘（默认）
• 左 ⌥
• 右 ⌥

按住还是轻点

• 按下这个键会立刻开始录音。
• 400 ms 或更久之后松开：按住说话。录音停止，文字被插入。
• 不到 400 ms 就松开：轻点。录音继续。再轻点一次即停止并插入。
• Esc 取消正在进行的录音，不会插入任何内容。
• 单次语句上限为 300 秒（5 分钟），到时会自动停止并插入。

胶囊提示条

胶囊提示条是主屏幕底部居中的一个小面板，始终可见、可点击穿透，距屏幕底边 96 pt。它出现在所有 Spaces 中，且从不获取焦点。

• 静止状态：一个麦克风图标。
• 模型下载时显示 "Downloading speech model… NN%"，或者 "Model download failed — reopen Keebye to retry"。
• 听写过程中："Listening…" → "Transcribing…" → "Inserting…"。
• 约 2.6 秒的短提示："Couldn't insert: <reason>"、"Text left on clipboard — paste manually" 或 "Dictation paused: secure input on (<App>)"。

文字如何被插入

默认方式是 "Paste (fast)"（粘贴，快速）：Keebye 先记下你的剪贴板内容，把转写文本写成剪贴板管理器会跳过的临时剪贴板项，模拟按下 ⌘V，并在 250 ms 后恢复你原来的剪贴板内容（前提是剪贴板仍归 Keebye 所有）。"Restore clipboard after paste" 默认开启。

在 Terminal.app、iTerm2、Warp、WezTerm 和 kitty 中，粘贴会被切成不超过 2000 bytes 的分块，块与块之间间隔 50 ms。

"Typing (terminals / SSH / any layout)"（模拟键入）：Keebye 以 16 个字符为一块、每块间隔 4 ms 发送 Unicode 按键，完全不碰剪贴板。它与键盘布局无关，在 SSH 和 tmux 里同样有效。如果模拟键入失败，文字会留在剪贴板上，胶囊提示条会显示 "Text left on clipboard — paste manually"。

密码框与安全输入

如果安全输入已开启，或聚焦的元素是密码框，Keebye 不会往剪贴板写任何内容，并显示 "Couldn't insert: Secure input is active (<App>) — dictation is blocked" 或 "Couldn't insert: A password field is focused — dictation is blocked"。这类听写从不保存到历史记录。另外，只要安全输入保持开启，每 5 秒一次的轮询还会提示 "Dictation paused: secure input on (<App>)"。

预热的麦克风

麦克风流在你第一次听写时启动，之后在应用运行期间一直保持，所以首次使用后 macOS 的麦克风指示灯会持续亮着。每段语句开头都会补上滚动保留的 500 ms 预录音。一次会话中的第一次听写仍可能要承担音频流启动的延迟，而在这 500 ms 缓冲之前说出的词仍可能被截掉。音频会被重采样为 16 kHz 单声道，设备切换会在一秒内被检测到。