Cài đặt và quyền

Keebye phát hành dưới dạng file DMG đã ký và công chứng cho máy Mac Apple Silicon. Trang này liệt kê những gì nó cần từ máy Mac của bạn và từng quyền dùng để làm gì.

Yêu cầu hệ thống

• macOS 11.0 hoặc mới hơn.
• Một máy Mac Apple Silicon. Bản phát hành chỉ được build cho arm64.
• 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ử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." 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. 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. 2

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

3. 3

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

4. 4

   Chọn phím nhấn-để-nói — Fn / Globe, ⌘ trái, ⌘ phải, ⌥ trái hoặc ⌥ phải.

5. 5

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

Microphone

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.

Accessibility

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.

Speech Recognition

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.

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

Model nằm trong ~/Library/Application Support/com.keebye.app/models/. 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ộ.