การแก้ปัญหา
ข้อความแต่ละอย่างที่ Keebye แสดงหมายถึงอะไรและแก้ไขอย่างไร พร้อมวิธีรีเซ็ต
ปัญหาส่วนใหญ่มาจากสิทธิ์บางอย่าง โมเดลที่ยังไม่มี หรือการพิมพ์ด้วยเสียงที่ถูกหยุดไว้ เริ่มจากรายการตรวจสอบด่วน แล้วค่อยหาข้อความของคุณด้านล่าง
ปุ่มลัดไม่ทำงาน? ตรวจสิ่งเหล่านี้ก่อน
- "Enable Dictation" ถูกทำเครื่องหมายไว้ในเมนูแถบสถานะ
- คุณเข้าสู่ระบบอยู่และช่วงทดลองใช้ยังไม่สิ้นสุด (Settings › Account)
- ให้สิทธิ์ Accessibility แล้วใน System Settings › Privacy & Security › Accessibility
- ไม่มี secure input ทำงานอยู่ — เช่น Secure Keyboard Entry ใน Terminal หรือช่องรหัสผ่านที่กำลังโฟกัส
ข้อความและความหมาย
"Accessibility permission was revoked — reopen System Settings"
ไม่พบสิทธิ์ Accessibility ตอนเริ่มอัดเสียง เปิด System Settings › Privacy & Security › Accessibility แล้วเปิดสวิตช์ให้ Keebye Keebye จะเปิดใช้ปุ่มลัดอีกครั้งภายใน 2 วินาที
"Failed to start the global hotkey listener"
macOS ปฏิเสธ event tap ให้สิทธิ์ Accessibility แล้วเลือกปุ่มของคุณใหม่ใน Settings
"Could not arm <Key> — grant Keebye Accessibility access, then pick it again." หรือ "Could not switch to <Key>; still using <Key>."
การเปลี่ยนปุ่มลัดถูกปฏิเสธ ให้สิทธิ์ Accessibility แล้วเลือกปุ่มอีกครั้ง ระหว่างนี้ Keebye จะยังใช้ปุ่มเดิมต่อไป
"Microphone capture failed: <error>"
ไม่มีอุปกรณ์อินพุตเริ่มต้น หรือสตรีมเสียงล้มเหลว ตรวจอุปกรณ์อินพุตใน System Settings › Sound และตรวจว่าให้สิทธิ์ Microphone แล้ว
"Speech model still setting up — try again in a moment"
โมเดลที่เลือกยังไม่อยู่บนดิสก์หรือยังโหลดไม่เสร็จ รอให้แถบ pill ออกจากสถานะดาวน์โหลด หรือกด "Download model" ใน Settings › Speech engine
"Model download failed — reopen Keebye to retry"
ดาวน์โหลดล้มเหลวครบห้าครั้ง (เครือข่าย ข้อผิดพลาด HTTP หรือ checksum ไม่ตรง) ปิดแล้วเปิด Keebye ใหม่ การดาวน์โหลดจะทำต่อจากจุดที่หยุดไว้
"Speech Recognition permission needed — enable Keebye under System Settings › Privacy & Security › Speech Recognition"
เลือกเอนจิน Native (Apple Speech) ไว้โดยยังไม่ได้รับอนุญาต ให้สิทธิ์ Speech Recognition หรือสลับไปใช้ Parakeet หรือ Canary
"Apple Speech recognizer is not available for locale …", "Apple Speech recognized no speech" หรือ "Apple Speech timed out after 15s"
ปัญหาของเอนจิน Native อาจต้องติดตั้งโมเดลภาษาบนเครื่องผ่าน System Settings › Keyboard › Dictation มิฉะนั้นให้พูดภายใน 15 วินาทีหรือเปลี่ยนเอนจิน
"Couldn't insert: Secure input is active (<App>) — dictation is blocked" หรือ "Couldn't insert: A password field is focused — dictation is blocked"
มีช่องรหัสผ่านกำลังโฟกัสอยู่ หรือมีแอปที่เปิด Secure Keyboard Entry ไว้ (เช่น Terminal) คลิกไปที่ช่องข้อความปกติ หรือปิด Secure Keyboard Entry นี่เป็นพฤติกรรมที่ออกแบบไว้
"Text left on clipboard — paste manually"
การจำลองการกด ⌘V หรือการกดแป้นล้มเหลว ข้อความถอดเสียงอยู่บนคลิปบอร์ดของคุณแล้ว ให้กด ⌘V เอง
"Dictation hit an internal error and was reset. Please try again."
ตัวประมวลผลเซสชันฟื้นจากการแครช ลองพูดใหม่อีกครั้ง
หน้าต่างเริ่มต้นใช้งานเปิดขึ้นอีกครั้งหลังการอัปเดตหรือการติดตั้งใหม่
สิทธิ์ Accessibility เดิมค้างอยู่ ลบ Keebye ออกจาก System Settings › Privacy & Security › Accessibility ด้วยปุ่ม − เพิ่มกลับเข้าไป แล้วเปิดสวิตช์อีกครั้ง
รีเซ็ต Keebye
ปิด Keebye ลบ ~/Library/Application Support/com.keebye.app/settings.json และลบรายการ Keychain สำหรับ service com.keebye.app, account auth เปิดแอปใหม่แล้วการเริ่มต้นใช้งานจะเริ่มอีกครั้ง ข้อมูลวินิจฉัยออกทาง stderr เท่านั้น