For AI agents: full index at https://keebye.com/llms.txt

Chuyển đến nội dung tài liệu
Tài liệu Keebye

Cài đặt và quyền

Yêu cầu hệ thống cho Mac và Windows, cửa sổ onboarding, từng quyền Keebye xin, cách cập nhật hoạt động và nơi lưu model.

Keebye phát hành dưới dạng file DMG đã ký và công chứng cho máy Mac Apple Silicon, và dưới dạng bộ cài (.exe hoặc .msi) cho Windows 10 và 11 bản 64-bit. Trang này liệt kê những gì nó cần từ máy tính của bạn và từng quyền dùng để làm gì.

Yêu cầu hệ thống

  • Mac: macOS 11.0 hoặc mới hơn.
  • Mac: một máy Mac Apple Silicon. Bản phát hành cho Mac chỉ được build cho arm64.
  • Windows: Windows 10 hoặc 11 trên PC 64-bit (x64).
  • Chỗ trống cho model giọng nói mặc định: khoảng 670 MB trên đĩa, tải một lần.

Cài đặt trên Windows

Chạy Keebye_<version>_x64-setup.exe, hoặc file .msi nếu bạn cài phần mềm từ gói MSI. Sau đó Keebye khởi động ở khay hệ thống và mở cùng cửa sổ onboarding như trên Mac.

Cửa sổ onboarding

Cửa sổ "Welcome to Keebye" hiện năm bước. "Finish unlocks once the model is downloaded and both permissions are granted." Trên Windows, cả hai bước cấp quyền đều hiện là đã cấp, nên Finish chỉ chờ model. Cùng cửa sổ đó sẽ mở lại về sau như một chỗ để sửa nếu một quyền bị mất, chẳng hạn sau khi cập nhật.

  1. Tải model giọng nói — khoảng 670 MB, một lần duy nhất. Việc này chạy trong lúc bạn hoàn tất các bước bên dưới.

  2. Quyền Microphone — nhấn "Grant microphone access".

  3. Quyền Accessibility — trên Mac, nhấn "Open System Settings" và bật Keebye lên.

  4. Chọn phím nhấn-để-nói — Fn / Globe, ⌘ trái, ⌘ phải, ⌥ trái hoặc ⌥ phải (các phím tương ứng trên Windows có trong Bắt đầu với Keebye).

  5. Thử ngay — giữ hotkey và nói vào ô kiểm thử.

Microphone

Trên Mac, macOS hỏi: "Keebye listens to your microphone only while you hold your dictation hotkey, to turn your speech into text." Keebye xin quyền này ở bước 2 của onboarding. Trên Windows, Keebye không hiện hộp thoại nào; Windows cấp quyền micro khi bắt đầu ghi âm.

Accessibility (Mac)

Trên Mac, quyền Accessibility cho Keebye theo dõi hotkey của bạn và dán văn bản vào bất kỳ ứng dụng nào. Keebye kiểm tra quyền mỗi 1.5 giây và kích hoạt lại hotkey mỗi 2 giây sau khi được cấp, nên bạn không cần khởi động lại. Windows không cần quyền tương đương.

Speech Recognition (Mac)

Trên Mac, chỉ được xin khi bạn chọn engine "Native (Apple Speech)". macOS hiện: "Keebye uses on-device speech recognition to turn your dictation into text. Audio stays on your Mac." Trước khi được cấp, thanh pill hiện "Speech Recognition permission needed — enable Keebye under System Settings › Privacy & Security › Speech Recognition".

Cập nhật

Mỗi lần khởi chạy một bản release, Keebye xem github.com/aiescu/keebye-releases có phiên bản mới hơn không. Nếu có, nó tải về, cài im lặng và khởi động lại ứng dụng. Không có hộp thoại nào và cũng không có mục menu nào cho việc này. Nguồn cập nhật hiện chỉ có bản cho Mac, nên trên Windows bạn cập nhật bằng cách tải bộ cài mới hơn từ keebye.com.

Model được lưu ở đâu

Model nằm trong ~/Library/Application Support/com.keebye.app/models/ trên Mac và %APPDATA%\com.keebye.app\models\ trên Windows. Việc tải có thể tiếp tục khi bị ngắt, được kiểm bằng SHA-256 và thử lại tối đa năm lần. Chỉ model mặc định tự tải; các engine khác tải khi bạn nhấn "Download model" trong Settings.

  • parakeet-v3 — khoảng 670 MB (Settings hiện ~640 MB). Bản mặc định.
  • parakeet-v3-fp32 — khoảng 2.55 GB (Settings hiện ~2.4 GB).
  • canary-v2 — khoảng 1.03 GB (Settings hiện ~1 GB).
  • llm/Qwen_Qwen3-1.7B-Q4_K_M.gguf — khoảng 1.28 GB, phải tự bật, chỉ dùng cho bước đánh bóng bằng LLM cục bộ.