跳到文档正文
Keebye 文档

安装与权限

系统要求、初始设置窗口、Keebye 请求的每一项权限、更新方式，以及模型存放的位置。

Keebye 以经过签名和公证的 DMG 形式发布，面向搭载 Apple Silicon 的 Mac。本页列出它对你的 Mac 有哪些要求，以及每项权限的作用。

系统要求

  • macOS 11.0 或更高版本。
  • 一台搭载 Apple Silicon 的 Mac。发布版本只为 arm64 构建。
  • 为默认语音模型留出空间：磁盘上约 670 MB，只下载一次。

初始设置窗口

"Welcome to Keebye" 窗口显示五个步骤。"Finish unlocks once the model is downloaded and both permissions are granted." 如果某项权限之后丢失（例如更新之后），同一个窗口会再次打开，作为修复入口。

  1. 下载语音模型 — 约 670 MB，只此一次。它会在你完成下面几步的同时进行。

  2. 麦克风权限 — 点击 "Grant microphone access"。

  3. 辅助功能权限 — 点击 "Open System Settings"，然后打开 Keebye 的开关。

  4. 选择按住说话键 — Fn / Globe、左 ⌘、右 ⌘、左 ⌥ 或右 ⌥。

  5. 试一试 — 按住热键，对着测试输入框说话。

麦克风

macOS 会这样询问："Keebye listens to your microphone only while you hold your dictation hotkey, to turn your speech into text." Keebye 在初始设置的第 2 步请求这项权限。

辅助功能

辅助功能权限让 Keebye 能监听你的热键，并把文字粘贴到任何应用里。授予后，Keebye 每 1.5 秒轮询一次授权状态，并每 2 秒重新启用热键一次，所以你不需要重启。

语音识别

只有在你选择 "Native (Apple Speech)" 引擎时才会请求。macOS 会显示："Keebye uses on-device speech recognition to turn your dictation into text. Audio stays on your Mac." 在授予之前，胶囊提示条会显示 "Speech Recognition permission needed — enable Keebye under System Settings › Privacy & Security › Speech Recognition"。

更新

每次启动正式发布版本时，Keebye 都会到 github.com/aiescu/keebye-releases 查看是否有更新的版本。如果有，它会下载、静默安装并重启应用。这个过程没有弹窗，菜单里也没有对应的选项。

模型存放在哪里

模型位于 ~/Library/Application Support/com.keebye.app/models/。下载支持断点续传，用 SHA-256 校验，最多重试五次。只有默认模型会自动下载；其他引擎要等你在 Settings（设置）里点击 "Download model" 才下载。

  • parakeet-v3 — 约 670 MB（Settings 中显示为 ~640 MB）。默认引擎。
  • parakeet-v3-fp32 — 约 2.55 GB（Settings 中显示为 ~2.4 GB）。
  • canary-v2 — 约 1.03 GB（Settings 中显示为 ~1 GB）。
  • llm/Qwen_Qwen3-1.7B-Q4_K_M.gguf — 约 1.28 GB，需主动开启，只用于本地 LLM 润色。