Documentation & Shortcuts

คู่มือการติดตั้งและทางลัดการใช้งาน

ขั้นตอนการเปิดสิทธิ์บน macOS ตามหลักการจำกัดสิทธิ์ขั้นสูงสุด (Strict Permission Scope) พร้อมคู่มือทางลัดการพิมพ์และ Copy Cache

1. การติดตั้งและการอนุญาตสิทธิ์บน macOS

KeyXamathi ยึดหลัก Strict Permission Scope (§13) โดยขอสิทธิ์ Accessibility เพียงอย่างเดียว และไม่ขอสิทธิ์ Input Monitoring แยกต่างหากโดยเด็ดขาด เพื่อความปลอดภัยสูงสุดและความสบายใจของผู้ใช้งาน

1

เปิดสิทธิ์ Accessibility (การเข้าถึงเพื่อควบคุมแป้นพิมพ์)

สิทธิ์นี้ช่วยให้ KeyXamathi สลับเลย์เอาต์ภาษาทันทีที่กดปุ่มสลับ (0ms) และส่งคำสั่งแก้ไขคำผิดภาษาให้อัตโนมัติ

เปิด System Settings > Privacy & Security > Accessibility แล้วเปิดสวิตช์อนุญาตสำหรับ KeyXamathi

🛡️
ทำไมจึงไม่ต้องเปิดสิทธิ์ Input Monitoring?

สิทธิ์ Accessibility ครอบคลุมการทำงานของ Event Tap อย่างสมบูรณ์แล้ว เราออกแบบระบบให้ตรวจสอบสิทธิ์ก่อนเปิด Event Tap เสมอ ทำให้ไม่มีหน้าต่างขอสิทธิ์ Input Monitoring เด้งขึ้นมารบกวนหรือสร้างความกังวลใจ

2. คีย์ลัดหลักสำหรับการพิมพ์ (Typing Shortcuts)

คุณสามารถกดใช้ปุ่ม Ctrl (⌃) หรือ Fn (fn) ร่วมกับ Shift (⇧) ได้ตามความถนัดของมือ:

⌃⇧Z หรือ Fn⇧Z
ยกเลิก / แปลงกลับ (Undo / Redo)
ใช้เมื่อระบบเพิ่งแปลงคำให้แล้วต้องการสลับกลับไปกลับมา หรือกดปุ่ม Backspace 1 ครั้งทันทีหลังคำถูกแปลงเพื่อยกเลิก
⌃⇧X หรือ Fn⇧X
สลับภาษาคำปัจจุบัน (Cycle Language)
ใช้เมื่อพิมพ์ผิดภาษาแต่ระบบไม่กล้าแปลงให้อัตโนมัติ กดเพื่อบังคับสลับภาษาคำล่าสุดวนลูป ไทย ↔ อังกฤษ ↔ ลาว
⌃⇧O หรือ Fn⇧O
ยืนยันคำแนะนำ (Confirm Suggestion)
ใช้เมื่อมีป๊อปอัปคำแนะนำภาษาขึ้นมาขณะพิมพ์ประโยคยาว กดเพื่อยอมรับคำแนะนำทันที
⌃⇧A หรือ Fn⇧A
จำคำนี้ไว้ (Add to Whitelist)
ใช้เมื่อระบบแปลงคำที่ไม่ต้องการแก้ เพื่อจำคำนั้นเข้าคลังคำศัพท์ส่วนตัวและสลับคำเดิมกลับทันที

3. การใช้งาน Copy Cache & สนิปเป็ตปักหมุด (Opt-In Feature)

ความสามารถเสริมเพื่อเพิ่มประสิทธิภาพการทำงาน กักเก็บใน RAM ชั่วคราว ปลอดภัย 100%:

⌃⇧V หรือ Fn⇧V
เปิดหน้าต่างลอย Quick Paste
เปิดหน้าต่างค้นหาและวางประวัติคลิปบอร์ดล่าสุด พร้อมแสดงผลการแปลง Layout อัตโนมัติ
⌃⇧1 ⌃⇧2 ⌃⇧3
วางสนิปเป็ตปักหมุดด่วน (Direct Snippets)
วางข้อความที่ปักหมุดไว้ลำดับ 1, 2, 3 ทันทีโดยไม่ต้องเปิดหน้าต่างเมนู

คีย์ลัดในหน้าต่าง Quick Paste:

  • ⌘1 ถึง ⌘9 — วางข้อความต้นฉบับลำดับที่ 1–9 ทันที
  • ⌥1 ถึง ⌥9 — วางคำแปล Layout (เช่น คัดลอก 'dbo' วางเป็น 'กิน') ทันที
  • ⌘⌫ — ลบรายการบนสุดออกจากแคช
  • Esc — ปิดหน้าต่างลอยทันที