BambooMintKey_macos-v1.2.0

BambooMintKey 1.2.0 — Bản Phát Hành Nâng Cấp Kiến Trúc UI Khay Hệ Thống & Trải Nghiệm Đa Bộ Gõ (Windows, macOS & Linux)

Phiên bản 1.2.0 là bản nâng cấp kiến trúc lớn (Minor Release) của BambooMintKey, tái cấu trúc toàn diện tầng giao diện người dùng trên Windows theo mô hình System Tray độc lập (tương tự kiến trúc StatusBar trên macOS), giải quyết dứt điểm vấn đề tranh chấp biểu tượng với Google Japanese Input (Mozc) và mang lại trải nghiệm đa bộ gõ mượt mà, tiện lợi nhất.

---

🌟 Các Điểm Nổi Bật Trên Windows

1. Tách Rời Hoàn Toàn UI Sang Khay Hệ Thống (System Tray Icon Độc Lập):

   • Chuyển toàn bộ biểu tượng hiển thị E/V ra khỏi Windows Taskbar Language Bar và đưa về Khay hệ thống (Notification Area / System Tray) dưới dạng tiến trình UI độc lập, tương tự mô hình BambooMintKey.Mac.StatusBar trên macOS và các bộ gõ truyền thống UniKey/EVKey.
   • Thanh Taskbar Language Bar của Windows giờ đây sạch sẽ 100%, chỉ hiển thị duy nhất profile chuẩn: VIE: BambooMintKey.

2. Giải Quyết Triệt Để Tranh Chấp Biểu Tượng Với Google Japanese Input (あ / A):

   • Do không còn COM Item Button nhúng vào Language Bar từ Core DLL, khe hiển thị của Windows Taskbar được trả lại nguyên vẹn cho hệ thống.
   • Google Japanese Input (Mozc) và Microsoft Japanese IME có 100% không gian Taskbar của riêng mình để tự do hiển thị biểu tượng あ (Hiragana) / A (Direct Input) mà không còn bị BambooMintKey đè lên hay cướp quyền hiển thị.

3. Cơ Chế Tự Động Ẩn / Hiện (Auto-Visibility) & Watchdog Tự Phục Hồi:

   • Tự động theo dõi trạng thái Input Source của cửa sổ tiền cảnh (Foreground Window):
     • Khi người dùng chọn VIE: BambooMintKey: Tray Icon E/V chắc chắn được SHOW.
     • Khi người dùng chuyển sang bộ gõ khác (JPN: Google Japanese Input, ENG: US Keyboard...): Tray Icon E/V chắc chắn được HIDE ngay lập tức.
   • Cơ chế Watchdog Tự Hồi Sinh (Auto-Respawn tương tự macOS StatusBarLauncher):
     • Tiến trình UI duy trì một Named Mutex toàn cục (Local\BambooMintKey_UI_Process_Mutex_v1).
     • Kể cả người dùng có cố tình mở Task Manager (Process Manager) để End Task tiến trình UI, thì ngay khi người dùng gõ phím tiếp theo hoặc focus vào ô nhập liệu với BambooMintKey, Core TSF DLL phát hiện Mutex biến mất và tự động khởi chạy lại UI khay hệ thống ngay tức thì.
     • Đúng bản chất của một System IME: Người dùng không thể tắt bộ gõ bằng Task Manager mà chỉ có thể chuyển Input Method trên Language Bar để tắt/bật!
   • Loại bỏ nút "Thoát" thừa thãi: Vận hành đồng bộ với Language Bar, loại bỏ hoàn toàn nút Exit khỏi menu.

4. Hệ Thống Native Tray Context Menu Đầy Đủ & Tiện Lợi:

   • Click chuột trái vào Icon Tray: Đảo nhanh chế độ Tiếng Việt (V) $\leftrightarrow$ Tiếng Anh (E) với phản hồi thị giác tức thì.
   • Click chuột phải vào Icon Tray: Mở Menu Win32 native siêu nhẹ, hỗ trợ điều chỉnh tức thì:
     • Chế độ gõ: Tiếng Việt (V) / Tiếng Anh (E).
     • Kiểu gõ: Telex, VNI, Simple Telex.
     • Bảng mã: Unicode dựng sẵn, Unicode tổ hợp, TCVN3 (ABC).
     • Kiểu đặt dấu thanh: Kiểu mới (òa, xòe, thủy) / Kiểu cũ (oà, xoè, thuỷ).
     • Tùy chọn gõ thông minh: Cho phép bỏ dấu tự do, Gõ lặp dấu để khôi phục (ss $\rightarrow$ s), Phím 'w' đầu từ thành 'ư' (w $\rightarrow$ ư), Tự động nhận diện từ tiếng Anh.
     • Điều hướng: Mở Bảng điều khiển & Cài đặt, Xem thông tin bản quyền.

5. Đồng Bộ Dữ Liệu Thời Gian Thực 2 Chiều (Realtime 0-Microsecond IPC):

   • Bền vững: Cấu hình lưu trữ an toàn tại %AppData%\BambooMintKey\config.json.
   • Tốc độ bộ nhớ RAM: Mọi thay đổi từ Tray Menu hoặc GUI được cập nhật ngay lập tức vào vùng nhớ dùng chung 64-byte Shared Memory (Local\BambooMintKey_SharedConfig_v1) và phát tín hiệu Named Event (Local\BambooMintKey_StateChangedEvent_v1).
   • Khi người dùng ấn phím tắt bật/tắt V/E trong lúc đang gõ (trong Word, Notepad, Browser...), Core DLL cập nhật Shared Memory và Tray Icon đổi hình ảnh trong 0ms.

6. Tự Khởi Động Cùng Windows Với Chế Độ Khay Hệ Thống (--tray):

   • Đăng ký tự khởi động cùng Windows an toàn trong Registry (HKCU\...\Run).
   • Khi khởi động cùng Windows, ứng dụng tự động chạy ở chế độ ngầm (--tray), sẵn sàng phục vụ mà không bật cửa sổ to gây phiền toái.

---

📥 Hướng Dẫn Sử Dụng & Cài Đặt Trên Windows

Cài Đặt Mới / Nâng Cấp:

1. Tải tệp BambooMintKey-Setup.exe từ mục Assets bên dưới.
2. Chạy tệp cài đặt và làm theo hướng dẫn trên màn hình (Next $\rightarrow$ Install $\rightarrow$ Finish).
3. Trình cài đặt sẽ tự động nạp thư viện BambooMintKey.dll, kích hoạt dịch vụ TSF của Windows và khởi động Tray Icon chạy ngầm.

Phím Tắt Tiện Dụng:

• Win + Space: Chuyển đổi giữa các bộ gõ đã cài đặt (BambooMintKey $\leftrightarrow$ Google Japanese Input $\leftrightarrow$ English US).
• ~ (phím dưới Escape) hoặc Ctrl + Shift: Bật/tắt nhanh chế độ Tiếng Việt (V) và Tiếng Anh (E).
• Click chuột trái vào Icon Tray (V/E): Đảo nhanh trạng thái gõ.
• Click chuột phải vào Icon Tray: Mở Menu tùy chỉnh nhanh.

---

🍏 Các Điểm Nổi Bật Trên macOS

1. Đồng Bộ Hoàn Toàn Thuật Toán Lõi F# Tiên Tiến Nhất (Issue 019 & Issue 022):

   • Tái biên dịch thư viện động C-ABI NativeAOT BambooMintKeyCore.dylib đồng bộ với Lõi F# Core mới nhất.
   • Mang trọn vẹn thuật toán đồng bộ nhị trùng âm uô + w -> ươ, khắc phục dứt điểm lỗi vần dị dạng và cơ chế hoàn tác phím w đầu từ sang môi trường Apple Silicon & Intel.
   • Vượt qua 100% bộ kiểm thử tự động: 463/463 Core Unit Tests và 11/11 C-ABI Integration Tests.

2. Nâng Cấp Phiên Bản Đồng Bộ 1.2.0 Trên Toàn Hệ Thống:

   • Đồng bộ số phiên bản 1.2.0 trên toàn bộ 3 thành phần macOS:
     • Dịch vụ bộ gõ bản địa Apple InputMethodKit: BambooMintKey.app
     • Tiến trình Menu Bar trạng thái E/V: BambooMintKeyStatusBar.app
     • Ứng dụng Bảng điều khiển & Cài đặt Avalonia UI: BambooMintKey.UI.Mac.app
   • Cập nhật gói cài đặt tự động bản địa .pkg và đĩa ảo kéo-thả .dmg lên phiên bản 1.2.0.

3. Cơ Chế Phím Bổ Trợ Tự Nhiên & Trải Nghiệm Gõ Mượt Mà:

   • Giữ trọn tính năng gõ nhanh song ngữ: gõ w ra ư, gõ lặp ww khôi phục w và gõ tiếp tiếng Anh tự nhiên (web, war, was).
   • Sự kiện phím Shift (.flagsChanged) được bảo toàn trọn vẹn, cho phép gõ hoa chữ cái giữa chừng hoặc hoàn tác wW -> uW mà không làm gián đoạn chuỗi gõ dở (Preedit).

---

🧠 Cải Tiến Lõi Gõ F# Core (BambooMintKey.Core) (Windows, macOS & Linux)

1. Khắc Phục Xung Đột Phím w Đầu Từ & Hoàn Tác Song Ngữ (AllowLeadingWAsU - Issue 019):

   • Khi bật tùy chọn "Phím 'w' đứng đầu từ biến thành 'ư'":
     • Gõ cùng case (ww, WW): Khôi phục chính xác ký tự thô w hoặc W.
     • Gõ mixed case (wW, Ww): Hoàn tác dấu móc trả về uW hoặc Uw, tuyệt đối tôn trọng case của từng phím gõ thô.
     • Bảo vệ từ tiếng Anh tiếp nối (IsEnglishCommitted): Sau khi thoát w, người dùng tiếp tục gõ các từ tiếng Anh (web, war, was, WWORD...) sẽ không bị dính dấu tiếng Việt ngoài ý muốn.
     • Bảo toàn 100% các tổ hợp âm tiết tiếng Việt hợp lệ (wa -> ưa, wong -> ương, ws -> ứ, wf -> ừ...).

2. Khắc Phục Sinh Vần Dị Dạng & Phân Giải Nhị Trùng Âm Chuẩn Xác (Issue 022):

   • Bóc tách thanh điệu độc lập & Đồng bộ hóa cặp nhị trùng âm uo/uô + w -> ươ:
     • Gõ dduoocjw chuyển đổi mượt mà thành được (thay vì sinh vần dị dạng đưộc).
     • Gõ luoocjw chuyển đổi thành lược (thay vì lưộc), buoocjw thành bược.
     • Tôn trọng từ gốc khi người dùng không gõ w: dduoocj ra đuộc, luoocj ra luộc.
   • Ma trận ràng buộc âm vị học (Phonotactic Grammar Matrix):
     • Chặn vần khép tại âm tiết mở: Vần uâ bắt buộc phải có phụ âm cuối mới được hình thành. Ngăn chặn triệt để hiện tượng sinh từ vô nghĩa khi gõ vuaxa -> vũa (thay vì vuẫ), buafa/buaaf -> bùa (thay vì buầ), duaxa -> dũa (thay vì duẫ).
     • Khi có phụ âm cuối (xuan + a -> xuân): Biến đổi vần khép được chấp thuận hoàn toàn hợp lệ.
   • Khóa nhị trùng âm bão hòa:
     • Cụm nguyên âm ưa đã bão hòa bị khóa biến đổi đối với phím a: suwaxa giữ nguyên sữa (thay vì tự ý sinh sữâ), muaxa -> mũa, cuaxa -> cũa.

---

📥 Hướng Dẫn Cài Đặt Trên macOS

Important

Lưu ý quan trọng cho macOS: Sau khi cài đặt xong (dù bằng file .dmg, .pkg hay .zip), bạn cần Đăng xuất (Log Out) hoặc Khởi động lại máy (Restart) một lần để macOS nạp BambooMintKey vào danh sách bàn phím dấu [+].

Cách 1: Sử Dụng Đĩa Ảo .dmg (Khuyên Dùng — Cực Kỳ Đơn Giản)

1. Tải tệp BambooMintKey-macos-arm64.dmg trong mục Assets bên dưới và click đúp mở đĩa ảo.
2. Bạn có thể:
   • Click đúp vào Cài Đặt BambooMintKey.command: Bộ gõ sẽ tự động được cài vào máy trong 1 giây mà không hỏi mật khẩu root.
   • Hoặc kéo biểu tượng BambooMintKey.app thả vào thư mục Input Methods có sẵn ngay bên cạnh.
3. Mở Cài đặt hệ thống (System Settings) $\rightarrow$ Bàn phím (Keyboard) $\rightarrow$ Nguồn nhập liệu (Input Sources).
4. Bấm dấu [+] $\rightarrow$ chọn Tiếng Việt $\rightarrow$ chọn BambooMintKey $\rightarrow$ bấm Thêm (Add).

Cách 2: Sử Dụng Gói Installer .pkg

1. Tải tệp BambooMintKey-macos-arm64.pkg.
2. Click phải vào file .pkg $\rightarrow$ chọn Mở (Open) $\rightarrow$ Bấm Tiếp tục $\rightarrow$ Cài đặt.
3. Thêm BambooMintKey trong Cài đặt hệ thống như trên.

Cách 3: Cài Đặt Thủ Công Bằng Gói Nén .zip

1. Tải file BambooMintKey-macos-arm64.zip và giải nén.
2. Mở Terminal tại thư mục vừa giải nén và chạy lệnh:

   bash ...

BambooMintKey_linux-v1.2.0

BambooMintKey 1.2.0 — Bản Phát Hành Nâng Cấp Kiến Trúc UI Khay Hệ Thống & Trải Nghiệm Đa Bộ Gõ (Windows, macOS & Linux)

Phiên bản 1.2.0 là bản nâng cấp kiến trúc lớn (Minor Release) của BambooMintKey, tái cấu trúc toàn diện tầng giao diện người dùng trên Windows theo mô hình System Tray độc lập (tương tự kiến trúc StatusBar trên macOS), giải quyết dứt điểm vấn đề tranh chấp biểu tượng với Google Japanese Input (Mozc) và mang lại trải nghiệm đa bộ gõ mượt mà, tiện lợi nhất.

---

🌟 Các Điểm Nổi Bật Trên Windows

1. Tách Rời Hoàn Toàn UI Sang Khay Hệ Thống (System Tray Icon Độc Lập):

   • Chuyển toàn bộ biểu tượng hiển thị E/V ra khỏi Windows Taskbar Language Bar và đưa về Khay hệ thống (Notification Area / System Tray) dưới dạng tiến trình UI độc lập, tương tự mô hình BambooMintKey.Mac.StatusBar trên macOS và các bộ gõ truyền thống UniKey/EVKey.
   • Thanh Taskbar Language Bar của Windows giờ đây sạch sẽ 100%, chỉ hiển thị duy nhất profile chuẩn: VIE: BambooMintKey.

2. Giải Quyết Triệt Để Tranh Chấp Biểu Tượng Với Google Japanese Input (あ / A):

   • Do không còn COM Item Button nhúng vào Language Bar từ Core DLL, khe hiển thị của Windows Taskbar được trả lại nguyên vẹn cho hệ thống.
   • Google Japanese Input (Mozc) và Microsoft Japanese IME có 100% không gian Taskbar của riêng mình để tự do hiển thị biểu tượng あ (Hiragana) / A (Direct Input) mà không còn bị BambooMintKey đè lên hay cướp quyền hiển thị.

3. Cơ Chế Tự Động Ẩn / Hiện (Auto-Visibility) & Watchdog Tự Phục Hồi:

   • Tự động theo dõi trạng thái Input Source của cửa sổ tiền cảnh (Foreground Window):
     • Khi người dùng chọn VIE: BambooMintKey: Tray Icon E/V chắc chắn được SHOW.
     • Khi người dùng chuyển sang bộ gõ khác (JPN: Google Japanese Input, ENG: US Keyboard...): Tray Icon E/V chắc chắn được HIDE ngay lập tức.
   • Cơ chế Watchdog Tự Hồi Sinh (Auto-Respawn tương tự macOS StatusBarLauncher):
     • Tiến trình UI duy trì một Named Mutex toàn cục (Local\BambooMintKey_UI_Process_Mutex_v1).
     • Kể cả người dùng có cố tình mở Task Manager (Process Manager) để End Task tiến trình UI, thì ngay khi người dùng gõ phím tiếp theo hoặc focus vào ô nhập liệu với BambooMintKey, Core TSF DLL phát hiện Mutex biến mất và tự động khởi chạy lại UI khay hệ thống ngay tức thì.
     • Đúng bản chất của một System IME: Người dùng không thể tắt bộ gõ bằng Task Manager mà chỉ có thể chuyển Input Method trên Language Bar để tắt/bật!
   • Loại bỏ nút "Thoát" thừa thãi: Vận hành đồng bộ với Language Bar, loại bỏ hoàn toàn nút Exit khỏi menu.

4. Hệ Thống Native Tray Context Menu Đầy Đủ & Tiện Lợi:

   • Click chuột trái vào Icon Tray: Đảo nhanh chế độ Tiếng Việt (V) $\leftrightarrow$ Tiếng Anh (E) với phản hồi thị giác tức thì.
   • Click chuột phải vào Icon Tray: Mở Menu Win32 native siêu nhẹ, hỗ trợ điều chỉnh tức thì:
     • Chế độ gõ: Tiếng Việt (V) / Tiếng Anh (E).
     • Kiểu gõ: Telex, VNI, Simple Telex.
     • Bảng mã: Unicode dựng sẵn, Unicode tổ hợp, TCVN3 (ABC).
     • Kiểu đặt dấu thanh: Kiểu mới (òa, xòe, thủy) / Kiểu cũ (oà, xoè, thuỷ).
     • Tùy chọn gõ thông minh: Cho phép bỏ dấu tự do, Gõ lặp dấu để khôi phục (ss $\rightarrow$ s), Phím 'w' đầu từ thành 'ư' (w $\rightarrow$ ư), Tự động nhận diện từ tiếng Anh.
     • Điều hướng: Mở Bảng điều khiển & Cài đặt, Xem thông tin bản quyền.

5. Đồng Bộ Dữ Liệu Thời Gian Thực 2 Chiều (Realtime 0-Microsecond IPC):

   • Bền vững: Cấu hình lưu trữ an toàn tại %AppData%\BambooMintKey\config.json.
   • Tốc độ bộ nhớ RAM: Mọi thay đổi từ Tray Menu hoặc GUI được cập nhật ngay lập tức vào vùng nhớ dùng chung 64-byte Shared Memory (Local\BambooMintKey_SharedConfig_v1) và phát tín hiệu Named Event (Local\BambooMintKey_StateChangedEvent_v1).
   • Khi người dùng ấn phím tắt bật/tắt V/E trong lúc đang gõ (trong Word, Notepad, Browser...), Core DLL cập nhật Shared Memory và Tray Icon đổi hình ảnh trong 0ms.

6. Tự Khởi Động Cùng Windows Với Chế Độ Khay Hệ Thống (--tray):

   • Đăng ký tự khởi động cùng Windows an toàn trong Registry (HKCU\...\Run).
   • Khi khởi động cùng Windows, ứng dụng tự động chạy ở chế độ ngầm (--tray), sẵn sàng phục vụ mà không bật cửa sổ to gây phiền toái.

---

📥 Hướng Dẫn Sử Dụng & Cài Đặt Trên Windows

Cài Đặt Mới / Nâng Cấp:

1. Tải tệp BambooMintKey-Setup.exe từ mục Assets bên dưới.
2. Chạy tệp cài đặt và làm theo hướng dẫn trên màn hình (Next $\rightarrow$ Install $\rightarrow$ Finish).
3. Trình cài đặt sẽ tự động nạp thư viện BambooMintKey.dll, kích hoạt dịch vụ TSF của Windows và khởi động Tray Icon chạy ngầm.

Phím Tắt Tiện Dụng:

• Win + Space: Chuyển đổi giữa các bộ gõ đã cài đặt (BambooMintKey $\leftrightarrow$ Google Japanese Input $\leftrightarrow$ English US).
• ~ (phím dưới Escape) hoặc Ctrl + Shift: Bật/tắt nhanh chế độ Tiếng Việt (V) và Tiếng Anh (E).
• Click chuột trái vào Icon Tray (V/E): Đảo nhanh trạng thái gõ.
• Click chuột phải vào Icon Tray: Mở Menu tùy chỉnh nhanh.

---

🍏 Các Điểm Nổi Bật Trên macOS

1. Đồng Bộ Hoàn Toàn Thuật Toán Lõi F# Tiên Tiến Nhất (Issue 019 & Issue 022):

   • Tái biên dịch thư viện động C-ABI NativeAOT BambooMintKeyCore.dylib đồng bộ với Lõi F# Core mới nhất.
   • Mang trọn vẹn thuật toán đồng bộ nhị trùng âm uô + w -> ươ, khắc phục dứt điểm lỗi vần dị dạng và cơ chế hoàn tác phím w đầu từ sang môi trường Apple Silicon & Intel.
   • Vượt qua 100% bộ kiểm thử tự động: 463/463 Core Unit Tests và 11/11 C-ABI Integration Tests.

2. Nâng Cấp Phiên Bản Đồng Bộ 1.2.0 Trên Toàn Hệ Thống:

   • Đồng bộ số phiên bản 1.2.0 trên toàn bộ 3 thành phần macOS:
     • Dịch vụ bộ gõ bản địa Apple InputMethodKit: BambooMintKey.app
     • Tiến trình Menu Bar trạng thái E/V: BambooMintKeyStatusBar.app
     • Ứng dụng Bảng điều khiển & Cài đặt Avalonia UI: BambooMintKey.UI.Mac.app
   • Cập nhật gói cài đặt tự động bản địa .pkg và đĩa ảo kéo-thả .dmg lên phiên bản 1.2.0.

3. Cơ Chế Phím Bổ Trợ Tự Nhiên & Trải Nghiệm Gõ Mượt Mà:

   • Giữ trọn tính năng gõ nhanh song ngữ: gõ w ra ư, gõ lặp ww khôi phục w và gõ tiếp tiếng Anh tự nhiên (web, war, was).
   • Sự kiện phím Shift (.flagsChanged) được bảo toàn trọn vẹn, cho phép gõ hoa chữ cái giữa chừng hoặc hoàn tác wW -> uW mà không làm gián đoạn chuỗi gõ dở (Preedit).

---

🧠 Cải Tiến Lõi Gõ F# Core (BambooMintKey.Core) (Windows, macOS & Linux)

1. Khắc Phục Xung Đột Phím w Đầu Từ & Hoàn Tác Song Ngữ (AllowLeadingWAsU - Issue 019):

   • Khi bật tùy chọn "Phím 'w' đứng đầu từ biến thành 'ư'":
     • Gõ cùng case (ww, WW): Khôi phục chính xác ký tự thô w hoặc W.
     • Gõ mixed case (wW, Ww): Hoàn tác dấu móc trả về uW hoặc Uw, tuyệt đối tôn trọng case của từng phím gõ thô.
     • Bảo vệ từ tiếng Anh tiếp nối (IsEnglishCommitted): Sau khi thoát w, người dùng tiếp tục gõ các từ tiếng Anh (web, war, was, WWORD...) sẽ không bị dính dấu tiếng Việt ngoài ý muốn.
     • Bảo toàn 100% các tổ hợp âm tiết tiếng Việt hợp lệ (wa -> ưa, wong -> ương, ws -> ứ, wf -> ừ...).

2. Khắc Phục Sinh Vần Dị Dạng & Phân Giải Nhị Trùng Âm Chuẩn Xác (Issue 022):

   • Bóc tách thanh điệu độc lập & Đồng bộ hóa cặp nhị trùng âm uo/uô + w -> ươ:
     • Gõ dduoocjw chuyển đổi mượt mà thành được (thay vì sinh vần dị dạng đưộc).
     • Gõ luoocjw chuyển đổi thành lược (thay vì lưộc), buoocjw thành bược.
     • Tôn trọng từ gốc khi người dùng không gõ w: dduoocj ra đuộc, luoocj ra luộc.
   • Ma trận ràng buộc âm vị học (Phonotactic Grammar Matrix):
     • Chặn vần khép tại âm tiết mở: Vần uâ bắt buộc phải có phụ âm cuối mới được hình thành. Ngăn chặn triệt để hiện tượng sinh từ vô nghĩa khi gõ vuaxa -> vũa (thay vì vuẫ), buafa/buaaf -> bùa (thay vì buầ), duaxa -> dũa (thay vì duẫ).
     • Khi có phụ âm cuối (xuan + a -> xuân): Biến đổi vần khép được chấp thuận hoàn toàn hợp lệ.
   • Khóa nhị trùng âm bão hòa:
     • Cụm nguyên âm ưa đã bão hòa bị khóa biến đổi đối với phím a: suwaxa giữ nguyên sữa (thay vì tự ý sinh sữâ), muaxa -> mũa, cuaxa -> cũa.

---

📥 Hướng Dẫn Cài Đặt Trên macOS

Important

Lưu ý quan trọng cho macOS: Sau khi cài đặt xong (dù bằng file .dmg, .pkg hay .zip), bạn cần Đăng xuất (Log Out) hoặc Khởi động lại máy (Restart) một lần để macOS nạp BambooMintKey vào danh sách bàn phím dấu [+].

Cách 1: Sử Dụng Đĩa Ảo .dmg (Khuyên Dùng — Cực Kỳ Đơn Giản)

1. Tải tệp BambooMintKey-macos-arm64.dmg trong mục Assets bên dưới và click đúp mở đĩa ảo.
2. Bạn có thể:
   • Click đúp vào Cài Đặt BambooMintKey.command: Bộ gõ sẽ tự động được cài vào máy trong 1 giây mà không hỏi mật khẩu root.
   • Hoặc kéo biểu tượng BambooMintKey.app thả vào thư mục Input Methods có sẵn ngay bên cạnh.
3. Mở Cài đặt hệ thống (System Settings) $\rightarrow$ Bàn phím (Keyboard) $\rightarrow$ Nguồn nhập liệu (Input Sources).
4. Bấm dấu [+] $\rightarrow$ chọn Tiếng Việt $\rightarrow$ chọn BambooMintKey $\rightarrow$ bấm Thêm (Add).

Cách 2: Sử Dụng Gói Installer .pkg

1. Tải tệp BambooMintKey-macos-arm64.pkg.
2. Click phải vào file .pkg $\rightarrow$ chọn Mở (Open) $\rightarrow$ Bấm Tiếp tục $\rightarrow$ Cài đặt.
3. Thêm BambooMintKey trong Cài đặt hệ thống như trên.

Cách 3: Cài Đặt Thủ Công Bằng Gói Nén .zip

1. Tải file BambooMintKey-macos-arm64.zip và giải nén.
2. Mở Terminal tại thư mục vừa giải nén và chạy lệnh:

   bash ...

windows-v1.2.0

feat(windows): auto-dismiss tray context menu on mouse leave and fix …

BambooMintKey_macos-v1.1.5

BambooMintKey 1.1.5 — Bản Phát Hành Chính Thức (macOS & Linux)

Phiên bản 1.1.5 đánh dấu cột mốc quan trọng: BambooMintKey chính thức hỗ trợ nền tảng macOS, mang đến trải nghiệm gõ tiếng Việt Telex thuần bản địa, tốc độ cao, ổn định tuyệt đối và đồng bộ giao diện người dùng theo chuẩn Apple Text System.

---

🌟 Các Điểm Nổi Bật Trên macOS

1. Bộ Gõ Bản Địa Chuẩn Apple InputMethodKit (BambooMintKey.app):

   • Vận hành trực tiếp qua giao thức NSTextInputClient của hệ điều hành macOS.
   • Hoàn toàn không dùng hook phím ảo (CGEventTap), không giả lập phím xóa lùi Backspace, loại bỏ triệt để hiện tượng giật con trỏ, nuốt phím hay xung đột bảo mật.
   • Tái sử dụng trọn vẹn lõi thuật toán Telex F# thông qua thư viện động C-ABI NativeAOT (BambooMintKeyCore.dylib), tối ưu bộ nhớ cực nhẹ (~4MB).

2. Tích Hợp Menu Bar Động Với Biểu Tượng Cờ Việt Nam (BambooMintKeyStatusBar.app):

   • Hiển thị biểu tượng động chữ V (tiếng Việt) và chữ E (tiếng Anh) màu vàng trên nền đỏ (quốc kỳ Việt Nam) ngay trên thanh trạng thái macOS.
   • Tự động đồng bộ theo Input Source: Khi người dùng kích hoạt BambooMintKey (B), biểu tượng EV tự động xuất hiện. Khi chuyển sang các bộ gõ khác (ABC, Simple Telex...), biểu tượng EV tự động ẩn đi để giữ thanh Menu Bar gọn gàng.
   • Tự động khởi chạy an toàn: Bộ gõ IMK tự động đảm bảo ứng dụng Menu Bar luôn hoạt động kể cả sau khi reset hay khởi động lại máy tính.
   • Phím tắt chuyển nhanh V/E tức thì bằng phím ~ (phím dưới Escape, giống chuẩn Windows & Linux).

3. Khắc Phục Hoàn Toàn Lỗi Phím Mũi Tên & Điều Hướng Trong Preedit:

   • Khi đang gõ dở một từ (preedit) mà người dùng nhấn các phím mũi tên (Trái, Phải, Lên, Xuống) hoặc các phím điều hướng (Home, End, PageUp, PageDown, Escape): bộ gõ tự động chốt dứt khoát từ đang gõ vào văn bản trước khi chuyển giao phím cho ứng dụng.
   • Con trỏ di chuyển mượt mà vào giữa từ mà không làm biến dạng chữ, không sinh ký tự lạ (\u{F700}..\u{F703}), và không phát sinh rác chữ khi gõ Space tiếp theo.

4. Hiển Thị Soạn Thảo Tự Nhiên (Chuẩn Apple Text Styling):

   • Chuẩn hóa thuộc tính Marked Text (kTSMHiliteRawText), giúp các ứng dụng bản địa của Apple (Safari, Apple Notes, TextEdit, Pages...) hiển thị từ đang gõ hoàn toàn không có đường gạch chân, mang lại cảm giác chữ sạch đẹp, không che khuất dấu nặng (.).

5. Giao Diện Cài Đặt Bản Địa Avalonia UI (BambooMintKey.UI.Mac.app):

   • Giao diện cấu hình hiện đại với đầy đủ 6 tab: Tùy chọn gõ nâng cao, Phím tắt, Bảng gõ tắt (Macro), Khung thử nghiệm (Sandbox) và Thông tin.
   • Sử dụng font chữ hệ thống bản địa .AppleSystemUIFont.
   • Lưu trữ cấu hình an toàn, nguyên tử tại ~/Library/Application Support/BambooMintKey/config.json, tự động đồng bộ thời gian thực đa chiều (IMK ↔ StatusBar ↔ UI) qua cơ chế File Watcher.

6. Đóng Gói Trình Cài Đặt Bản Địa macOS (.pkg Installer):

   • Hỗ trợ gói cài đặt chuẩn macOS .pkg (BambooMintKey-macos-arm64.pkg): Người dùng chỉ cần click đúp chuột để cài đặt tự động toàn bộ bộ gõ và ứng dụng cấu hình vào hệ thống mà không cần gõ bất kỳ dòng lệnh nào.
   • Tích hợp kịch bản gỡ cài đặt sạch sẽ uninstall.sh.
   • Tích hợp đường ống CI/CD tự động trên GitHub Actions (.github/workflows/release-macos.yml) chạy trên runner macos-latest (Apple Silicon).

---

📥 Hướng Dẫn Cài Đặt Trên macOS

Important

Lưu ý quan trọng cho macOS: Sau khi cài đặt xong (dù bằng file .dmg, .pkg hay .zip), bạn cần Đăng xuất (Log Out) hoặc Khởi động lại máy (Restart) một lần để hệ thống macOS nạp BambooMintKey vào danh sách bàn phím dấu [+].

Cách 1: Sử Dụng Đĩa Ảo .dmg (Khuyên Dùng — Cực Kỳ Đơn Giản)

1. Tải tệp BambooMintKey-macos-arm64.dmg trong mục Assets bên dưới và click đúp mở đĩa ảo.
2. Bạn có thể:
   • Click đúp vào Cài Đặt BambooMintKey.command: Bộ gõ sẽ tự động được cài vào máy trong 1 giây mà không hỏi mật khẩu root.
   • Hoặc kéo biểu tượng BambooMintKey.app thả vào thư mục Input Methods có sẵn ngay bên cạnh.
3. Mở Cài đặt hệ thống (System Settings) $\rightarrow$ Bàn phím (Keyboard) $\rightarrow$ Nguồn nhập liệu (Input Sources).
4. Bấm dấu [+] $\rightarrow$ chọn Tiếng Việt $\rightarrow$ chọn BambooMintKey $\rightarrow$ bấm Thêm (Add).

Cách 2: Sử Dụng Gói Installer .pkg

1. Tải tệp BambooMintKey-macos-arm64.pkg.
2. Click phải vào file .pkg $\rightarrow$ chọn Mở (Open) $\rightarrow$ Bấm Tiếp tục $\rightarrow$ Cài đặt.
3. Thêm BambooMintKey trong Cài đặt hệ thống như trên.

Cách 3: Cài Đặt Thủ Công Bằng Gói Nén .zip

1. Tải file BambooMintKey-macos-arm64.zip và giải nén.
2. Mở Terminal tại thư mục vừa giải nén và chạy lệnh:

   bash install.sh

3. Thêm BambooMintKey trong Cài đặt hệ thống như trên.

---

🐧 BambooMintKey 1.1.5 — Phần Linux (Fcitx 5)

Bản cập nhật 1.1.5 cho Linux sửa lỗi xung đột giữa chế độ gõ song ngữ (Việt – Anh) và tùy chọn "Phím 'w' đứng đầu từ thành 'ư'" (AllowLeadingWAsU), giúp người dùng gõ được chữ w/W độc lập và các từ tiếng Anh bắt đầu bằng w mà không bị kẹt hay biến dạng.

Điểm mới và cải tiến

• Sửa lỗi hoàn tác (undo) phím w đứng đầu từ khi bật AllowLeadingWAsU:
  • Trước đây, gõ lặp phím w để khôi phục ký tự thô lại sinh ra uw / UW / Uw (tự chèn thêm chữ u), khiến người dùng không thể gõ chữ w/W độc lập hay bắt đầu gõ từ tiếng Anh (web, win, word, what...).
  • Nay: ww $\rightarrow$ w, WW $\rightarrow$ W, Ww $\rightarrow$ Uw, và wW $\rightarrow$ uW (mixed-case undo horn, không tự ý viết hoa).
• Bảo vệ từ tiếng Anh tiếp nối sau khi khôi phục w: gõ wweb $\rightarrow$ web, wwar $\rightarrow$ war (không thành wả), wwas $\rightarrow$ was (không thành wá).
• Không tự ý viết hoa: để gõ chữ hoa (ví dụ WORD) phải gõ hoa toàn bộ (WWORD); các tổ hợp tiếng Việt hợp lệ (wa $\rightarrow$ ưa, wong $\rightarrow$ ương, ws $\rightarrow$ ứ) được bảo toàn tuyệt đối.

Thay đổi kỹ thuật

• src/BambooMintKey.Core/Engine/TelexEngine.fs: phân biệt trường hợp cùng case (khôi phục w/W) và mixed-case wW/Ww (undo horn -> uW/Uw) trong nhánh isUndoModifier.
• tests/BambooMintKey.Core.Tests/UppercaseModifierTests.fs: bổ sung các test gõ song ngữ (ww, WW, Ww, wW, wweb, wwar, wwas, WWORD).
• src/BambooMintKey.UI.Linux/BambooMintKey.UI.Linux.fsproj: nâng Version lên 1.1.5.
• src/BambooMintKey.Fcitx5/CMakeLists.txt, scripts/linux/bamboomintkey.spec: nâng version lên 1.1.5.

Cài đặt (Linux)

1. Tải gói phù hợp ở mục Assets bên dưới (.deb, .rpm hoặc .tar.gz).
2. Cài đặt rồi thêm bộ gõ BambooMintKey vào danh sách Input Method trong fcitx5-configtool.
3. Khởi động lại Fcitx5 (hoặc đăng xuất/đăng nhập) để kích hoạt.

Tham chiếu

• Tài liệu điều tra & phương án xử lý: docs/3.Issue/019_LeadingW_As_U_Bilingual_Conflict_And_Undo_Fix.md

BambooMintKey_linux-v1.1.5

BambooMintKey 1.1.5 — Bản Phát Hành Chính Thức (macOS & Linux)

Phiên bản 1.1.5 đánh dấu cột mốc quan trọng: BambooMintKey chính thức hỗ trợ nền tảng macOS, mang đến trải nghiệm gõ tiếng Việt Telex thuần bản địa, tốc độ cao, ổn định tuyệt đối và đồng bộ giao diện người dùng theo chuẩn Apple Text System.

---

🌟 Các Điểm Nổi Bật Trên macOS

1. Bộ Gõ Bản Địa Chuẩn Apple InputMethodKit (BambooMintKey.app):

   • Vận hành trực tiếp qua giao thức NSTextInputClient của hệ điều hành macOS.
   • Hoàn toàn không dùng hook phím ảo (CGEventTap), không giả lập phím xóa lùi Backspace, loại bỏ triệt để hiện tượng giật con trỏ, nuốt phím hay xung đột bảo mật.
   • Tái sử dụng trọn vẹn lõi thuật toán Telex F# thông qua thư viện động C-ABI NativeAOT (BambooMintKeyCore.dylib), tối ưu bộ nhớ cực nhẹ (~4MB).

2. Tích Hợp Menu Bar Động Với Biểu Tượng Cờ Việt Nam (BambooMintKeyStatusBar.app):

   • Hiển thị biểu tượng động chữ V (tiếng Việt) và chữ E (tiếng Anh) màu vàng trên nền đỏ (quốc kỳ Việt Nam) ngay trên thanh trạng thái macOS.
   • Tự động đồng bộ theo Input Source: Khi người dùng kích hoạt BambooMintKey (B), biểu tượng EV tự động xuất hiện. Khi chuyển sang các bộ gõ khác (ABC, Simple Telex...), biểu tượng EV tự động ẩn đi để giữ thanh Menu Bar gọn gàng.
   • Tự động khởi chạy an toàn: Bộ gõ IMK tự động đảm bảo ứng dụng Menu Bar luôn hoạt động kể cả sau khi reset hay khởi động lại máy tính.
   • Phím tắt chuyển nhanh V/E tức thì bằng phím ~ (phím dưới Escape, giống chuẩn Windows & Linux).

3. Khắc Phục Hoàn Toàn Lỗi Phím Mũi Tên & Điều Hướng Trong Preedit:

   • Khi đang gõ dở một từ (preedit) mà người dùng nhấn các phím mũi tên (Trái, Phải, Lên, Xuống) hoặc các phím điều hướng (Home, End, PageUp, PageDown, Escape): bộ gõ tự động chốt dứt khoát từ đang gõ vào văn bản trước khi chuyển giao phím cho ứng dụng.
   • Con trỏ di chuyển mượt mà vào giữa từ mà không làm biến dạng chữ, không sinh ký tự lạ (\u{F700}..\u{F703}), và không phát sinh rác chữ khi gõ Space tiếp theo.

4. Hiển Thị Soạn Thảo Tự Nhiên (Chuẩn Apple Text Styling):

   • Chuẩn hóa thuộc tính Marked Text (kTSMHiliteRawText), giúp các ứng dụng bản địa của Apple (Safari, Apple Notes, TextEdit, Pages...) hiển thị từ đang gõ hoàn toàn không có đường gạch chân, mang lại cảm giác chữ sạch đẹp, không che khuất dấu nặng (.).

5. Giao Diện Cài Đặt Bản Địa Avalonia UI (BambooMintKey.UI.Mac.app):

   • Giao diện cấu hình hiện đại với đầy đủ 6 tab: Tùy chọn gõ nâng cao, Phím tắt, Bảng gõ tắt (Macro), Khung thử nghiệm (Sandbox) và Thông tin.
   • Sử dụng font chữ hệ thống bản địa .AppleSystemUIFont.
   • Lưu trữ cấu hình an toàn, nguyên tử tại ~/Library/Application Support/BambooMintKey/config.json, tự động đồng bộ thời gian thực đa chiều (IMK ↔ StatusBar ↔ UI) qua cơ chế File Watcher.

6. Đóng Gói Trình Cài Đặt Bản Địa macOS (.pkg Installer):

   • Hỗ trợ gói cài đặt chuẩn macOS .pkg (BambooMintKey-macos-arm64.pkg): Người dùng chỉ cần click đúp chuột để cài đặt tự động toàn bộ bộ gõ và ứng dụng cấu hình vào hệ thống mà không cần gõ bất kỳ dòng lệnh nào.
   • Tích hợp kịch bản gỡ cài đặt sạch sẽ uninstall.sh.
   • Tích hợp đường ống CI/CD tự động trên GitHub Actions (.github/workflows/release-macos.yml) chạy trên runner macos-latest (Apple Silicon).

---

📥 Hướng Dẫn Cài Đặt Trên macOS

Important

Lưu ý quan trọng cho macOS: Sau khi cài đặt xong (dù bằng file .dmg, .pkg hay .zip), bạn cần Đăng xuất (Log Out) hoặc Khởi động lại máy (Restart) một lần để hệ thống macOS nạp BambooMintKey vào danh sách bàn phím dấu [+].

Cách 1: Sử Dụng Đĩa Ảo .dmg (Khuyên Dùng — Cực Kỳ Đơn Giản)

1. Tải tệp BambooMintKey-macos-arm64.dmg trong mục Assets bên dưới và click đúp mở đĩa ảo.
2. Bạn có thể:
   • Click đúp vào Cài Đặt BambooMintKey.command: Bộ gõ sẽ tự động được cài vào máy trong 1 giây mà không hỏi mật khẩu root.
   • Hoặc kéo biểu tượng BambooMintKey.app thả vào thư mục Input Methods có sẵn ngay bên cạnh.
3. Mở Cài đặt hệ thống (System Settings) $\rightarrow$ Bàn phím (Keyboard) $\rightarrow$ Nguồn nhập liệu (Input Sources).
4. Bấm dấu [+] $\rightarrow$ chọn Tiếng Việt $\rightarrow$ chọn BambooMintKey $\rightarrow$ bấm Thêm (Add).

Cách 2: Sử Dụng Gói Installer .pkg

1. Tải tệp BambooMintKey-macos-arm64.pkg.
2. Click phải vào file .pkg $\rightarrow$ chọn Mở (Open) $\rightarrow$ Bấm Tiếp tục $\rightarrow$ Cài đặt.
3. Thêm BambooMintKey trong Cài đặt hệ thống như trên.

Cách 3: Cài Đặt Thủ Công Bằng Gói Nén .zip

1. Tải file BambooMintKey-macos-arm64.zip và giải nén.
2. Mở Terminal tại thư mục vừa giải nén và chạy lệnh:

   bash install.sh

3. Thêm BambooMintKey trong Cài đặt hệ thống như trên.

🗑️ Gỡ Cài Đặt Trên macOS

Cách 1 & 2 (.dmg / .pkg): Gỡ bằng file double-click (khuyên dùng)

1. Mở Finder → Go → Applications (⇧⌘A), hoặc mở lại đĩa .dmg đã tải.
2. Click đúp file Gỡ Cài Đặt BambooMintKey.command.
3. Terminal mở ra tự chạy gỡ; nhập mật khẩu quản trị khi được hỏi (vì bộ gõ cài ở thư mục hệ thống).
4. Hoàn tất: bộ gõ và app Cài đặt được xóa sạch, danh sách Input Sources được làm mới.

Cách 3 (.zip): Gỡ bằng lệnh

bash uninstall.sh            # gỡ app, giữ lại cấu hình
bash uninstall.sh --purge    # gỡ app + xóa luôn cấu hình

Note

Uninstaller mặc định giữ lại cấu hình (thân thiện khi cài lại). Muốn gỡ hoàn toàn thì dùng --purge, hoặc xóa tay thư mục ~/Library/Application Support/BambooMintKey.

---

🐧 BambooMintKey 1.1.5 — Phần Linux (Fcitx 5)

Bản cập nhật 1.1.5 cho Linux mang đến các cải tiến quan trọng về tính tương thích ngôn ngữ, xử lý triệt để xung đột phím w và chuẩn hóa quy tắc chính tả tiếng Việt trong lõi gõ Telex.

Điểm mới và cải tiến

• Khắc phục triệt để các tổ hợp nguyên âm dị thường và phân giải phím móc w (Issue 022):
  • Phân giải thông minh cho nguyên âm đôi uo/uô: Gõ dduoocjw ra được (thay vì sinh vần dị thường đưộc), luoocjw ra lược, trong khi gõ luoojc vẫn giữ trọn vẹn luộc.
  • Chuẩn hóa biến dạng âm tiết mở: Loại bỏ tình trạng sinh dấu mũ dị thường khi bỏ dấu thanh trên các từ âm tiết mở (vuaxa $\rightarrow$ vũa thay vì vuẫ, buafa/buaaf $\rightarrow$ bùa thay vì buầ, suwaxa $\rightarrow$ sữa thay vì sữâ).
  • Kiểm soát ngữ âm chặt chẽ: Tự động loại trừ và chuẩn hóa các cụm nguyên âm không tồn tại trong tiếng Việt như ưô, uâ (khi không có phụ âm cuối), uă, ữâ.
• Sửa lỗi hoàn tác (undo) phím w đứng đầu từ khi bật AllowLeadingWAsU (Issue 019):
  • Trước đây, gõ lặp phím w để khôi phục ký tự thô lại sinh ra uw / UW / Uw (tự chèn thêm chữ u), khiến người dùng không thể gõ chữ w/W độc lập hay bắt đầu gõ từ tiếng Anh (web, win, word, what...).
  • Nay: ww $\rightarrow$ w, WW $\rightarrow$ W, Ww $\rightarrow$ Uw, và wW $\rightarrow$ uW (mixed-case undo horn, không tự ý viết hoa).
• Bảo vệ từ tiếng Anh tiếp nối sau khi khôi phục w: gõ wweb $\rightarrow$ web, wwar $\rightarrow$ war (không thành wả), wwas $\rightarrow$ was (không thành wá).
• Không tự ý viết hoa: để gõ chữ hoa (ví dụ WORD) phải gõ hoa toàn bộ (WWORD); các tổ hợp tiếng Việt hợp lệ (wa $\rightarrow$ ưa, wong $\rightarrow$ ương, ws $\rightarrow$ ứ) được bảo toàn tuyệt đối.

Thay đổi kỹ thuật

• src/BambooMintKey.Core/Engine/ModifierRules.fs: bổ sung tone-agnostic matching, cluster harmonization (uô + w $\rightarrow$ ươ), ngăn chặn cụm nguyên âm dị thường (ưô).
• src/BambooMintKey.Core/Engine/ToneRules.fs: chuẩn hóa cụm uâ không có phụ âm cuối về ua khi đặt dấu thanh.
• src/BambooMintKey.Core/Engine/SyllableParser.fs: từ chối các âm tiết mở không hợp lệ (uâ, ă, oă) để kích hoạt cơ chế hồi phục fallback.
• src/BambooMintKey.Core/Engine/TelexEngine.fs: tự động bảo toàn và tái áp dụng dấu thanh khi biến đổi modifier trên âm tiết đã mang thanh điệu; phân biệt trường hợp cùng case (khôi phục w/W) và mixed-case wW/Ww.
• tests/BambooMintKey.Core.Tests/RuleTests.fs: bổ sung bộ test kiểm thử phonotactic rules toàn diện cho Issue 022.

Cài đặt (Linux)

1. Tải gói phù hợp ở mục Assets bên dưới (.deb, .rpm hoặc .tar.gz).
2. Cài đặt rồi thêm bộ gõ BambooMintKey vào danh sách Input Method trong fcitx5-configtool.
3. Khởi động lại Fcitx5 (hoặc đăng xuất/đăng nhập) để kích hoạt.

Tham chiếu

• Tài liệu điều tra & phương án xử lý phím W: docs/3.Issue/019_LeadingW_As_U_Bilingual_Conflict_And_Undo_Fix.md
• Báo cáo phân tích ngữ âm & giải thuật biến dị nguyên âm: docs/3.Issue/022_Phonotactic_VowelCluster_Mutations_And_Disambiguation.md

BambooMintKey_Linux_v1.1.4

BambooMintKey 1.1.4 (Linux)

Bản cập nhật sửa 2 lỗi liên quan đến preedit dở dang trên Linux (Fcitx 5), ảnh hưởng tới các ứng dụng Chromium/Electron có cơ chế tự động điền/soạn thảo "thông minh".

Điểm mới và cải tiến trong bản 1.1.4

• Sửa lỗi tự copy–chèn chữ khi bấm phím mũi tên trên thanh URL của trình duyệt nhân Chromium (Chrome, Opera):

  • Trước đây, khi đang ở chế độ preedit chưa kết thúc bằng Space, bấm các phím di chuyển (lên / xuống / trái / phải) khiến bộ gõ tự chèn chữ một cách vô tội vạ dù không gõ thêm.
  • Nay engine chủ động commit chuỗi đang gõ dở trước khi nhả phím mũi tên cho ứng dụng, tránh omnibox của Chromium tự commit/điền lại preedit sai vị trí.

• Sửa lỗi chữ đầu tiên bị xóa khi gõ chữ + Space trong khung chat AI của Antigravity IDE:

  • Sửa thứ tự commit trong commitText: commit chuỗi trước, rồi mới xóa preedit & làm mới UI (theo đúng chuẩn fcitx5-bamboo), tránh app Electron/Chromium nhận "preedit rỗng" trước "commit" rồi hiểu nhầm thành thao tác xóa chữ.

Thay đổi kỹ thuật (Linux Fcitx5 addon)

• src/BambooMintKey.Fcitx5/engine.cpp:
  • Commit preedit trước khi forward các phím không xử lý được (mũi tên, Home/End, PageUp/Down, F1–F12, tổ hợp phím tắt hệ thống).
  • Sửa thứ tự commit trong commitText (commit trước, reset/updatePreedit sau).

Cài đặt (Linux)

1. Tải gói phù hợp ở mục Assets bên dưới (.deb, .rpm hoặc .tar.gz).
2. Cài đặt rồi thêm bộ gõ BambooMintKey vào danh sách Input Method trong fcitx5-configtool.
3. Khởi động lại Fcitx5 (hoặc đăng xuất/đăng nhập) để kích hoạt.

Tham chiếu

• Tài liệu điều tra & phương án xử lý: docs/3.Issue/015_Linux_Preedit_Commit_Order_And_ArrowKey.md

BambooMintKey v1.1.3

BambooMintKey 1.1.3

Bản cập nhật khắc phục lỗi ký tự xuống dòng (\n/\r) bị ghi vào chuỗi khi nhấn Enter lúc đang gõ — nguyên nhân khiến tên file/thư mục bị ngắt dòng và việc tạo file không kết thúc được.

Điểm mới và cải tiến trong bản 1.1.3

• Nhấn Enter chốt chữ chuẩn IME (không còn dính dấu xuống dòng):
  • Trước đây khi gõ xong một từ tiếng Việt rồi nhấn Enter (ví dụ để đặt tên file, đổi tên thư mục), Core Engine nối luôn mã xuống dòng (\n trên Linux/Fcitx5, \r trên Windows/TSF) vào chuỗi kết quả. Hệ quả: tên file bị ghi thành tenfile\n và phím Enter bị "nuốt" khiến thao tác tạo file không hoàn tất.
  • Nay Enter chỉ chốt từ (commit chuỗi thuần túy, không kèm ký tự xuống dòng) và nuốt phím. Nhấn Enter lần 1 để chốt chữ, lần 2 để hệ điều hành nhận lệnh xuống dòng/xác nhận — đúng chuẩn UX của các bộ gõ CJKV.
  • Không ảnh hưởng tới Space, Tab và dấu câu: các phím này vẫn giữ nguyên hành vi chốt từ kèm ký tự ngắt như trước.

Sửa lỗi

• Sửa lỗi chuỗi commit bị dính ký tự xuống dòng khi nhấn Enter trong lúc đang gõ (ảnh hưởng cả Windows TSF và Linux Fcitx5 do cùng đi qua TelexEngine.processKey).
• Sửa lỗi lặp phím hủy dấu mũ khi chữ đã ghép dấu thanh: trước đây gõ exee không trả về exe (vì ễ = ê + ngã là một ký tự Unicode dựng sẵn, không còn chứa ê riêng lẻ). Nay nhận diện modifier qua phân rã Unicode nên exee → exe, xeee → xee như mong muốn.
• Sửa lỗi từ tiếng Anh có đuôi phụ âm tắc bị ép dấu sắc: trước đây sort → sót, corp → cóp (do quy tắc âm tắc cuối ép dấu hỏi/huyền/ngã thành sắc). Nay engine ưu tiên backtrack tiếng Anh nên sort → sort, corp → corp.

Cài đặt

1. Tải file BambooMintKey1.1.3-Setup.exe ở mục Assets bên dưới, chạy bộ cài và làm theo hướng dẫn trên màn hình (hỗ trợ cài đặt im lặng: BambooMintKey1.1.3-Setup.exe /VERYSILENT /NORESTART).
2. Hoặc cài qua Windows Package Manager (WinGet) sau khi manifest được duyệt:

   winget install BambooMintKey.BambooMintKey

Mã băm xác thực (SHA-256)

• BambooMintKey1.1.3-Setup.exe: [TBD](sha256:46acaf6636fb7a11167f1068970736a3ffc36a0bfbc1f1937c38384d63782e65)

BambooMintKey v1.1.2

BambooMintKey 1.1.2

Bản cập nhật tập trung khắc phục lỗi tùy chọn gõ (gồm "Phím w đứng đầu từ thành ư") bị reset về mặc định khi đổi qua menu taskbar, và đồng bộ trạng thái Việt/Anh (V/E) xuyên suốt mọi ứng dụng.

Điểm mới và cải tiến trong bản 1.1.2

• Lưu cấu hình bền vững khi đổi qua menu taskbar:
  • Trước đây các tùy chọn đổi từ menu chuột phải ở taskbar (gồm "Phím w đứng đầu thành ư", "Gõ lặp dấu để khôi phục", kiểu gõ, bảng mã...) chỉ ghi vào bộ nhớ tạm, không ghi vào config.json, nên bị reset về mặc định sau khi khởi động lại hoặc mở lại bảng cài đặt.
  • Nay mọi thay đổi đều được ghi ngược vào config.json (ghi nguyên tử) và giữ nguyên sau khi khởi động lại.
• Trạng thái Việt/Anh (V/E) chia sẻ xuyên suốt mọi ứng dụng:
  • Trước đây mỗi ứng dụng có thể ghi nhớ trạng thái V/E riêng. Nay compartment TSF được đặt toàn cục (TF_CLIENTID_NULL), trạng thái V/E dùng chung cho toàn hệ thống, chuyển ứng dụng không làm thay đổi chế độ gõ.
• Lưu trạng thái V/E xuyên phiên:
  • Trạng thái Việt/Anh giờ được lưu vào config.json và được khôi phục đúng sau khi khởi động lại (giống hành vi của Unikey).

Sửa lỗi

• Sửa lỗi tùy chọn "Phím w đứng đầu từ thành ư" bị bỏ tích khi mở lại bảng cài đặt: nguyên nhân là giá trị đổi từ taskbar không được lưu vào config.json.
• Sửa lỗi trạng thái Việt/Anh bị ghi nhớ theo từng ứng dụng, nay dùng chung cho toàn hệ thống.

Cài đặt

1. Tải file URL Cloud R2
2. Hoặc cài qua Windows Package Manager (WinGet) sau khi manifest được duyệt:

   winget install BambooMintKey.BambooMintKey

Mã băm xác thực (SHA-256)

• BambooMintKey1.1.2-Setup.exe: 08da21c0ecffa1f667a537f3db41dc1866aa370accd4db6e665d36122b943971

BambooMintKey v1.1.1

BambooMintKey 1.1.1

Bản cập nhật tập trung khắc phục các lỗi hoàn dấu (gõ lặp phím) bị ngược chiều, hoàn thiện tính năng phím w đứng đầu từ thành ư, và sửa lỗi cấu hình bị reset trên Linux.

Điểm mới và cải tiến trong bản 1.1.1

• Kích hoạt tính năng "Phím w đứng đầu từ thành ư" (AllowLeadingWAsU):
  • Trước đây cờ này chỉ hiển thị trên giao diện nhưng động cơ gõ không xử lý (tính năng bị "chết").
  • Nay gõ w đơn độc ở đầu từ sẽ sinh ra nguyên âm ư: w → ư, wa → ưa, wu → ưu, wi → ưi, ws → ứ.
  • Mặc định là tắt; khi bật sẽ được lưu lại và không bị tắt theo mỗi lần chuyển chế độ V/E.
• Ưu tiên tiếng Việt khi hoàn dấu (gõ lặp phím):
  • Cơ chế hoàn dấu giờ rút đúng về một ký tự thô theo chuẩn gõ tiếng Việt, kể cả khi chuỗi trùng với từ tiếng Anh.

Sửa lỗi

• Sửa lỗi hoàn dấu bị ngược: goxx → gox, horr → hor, mass → mas (trước đây lặp dấu lại trả về nguyên chuỗi thay vì rút bớt một ký tự).
• Sửa hoàn dấu cho phím w (modifier): aww → aw, oww → ow, uww → uw.
• Sửa lỗi cụm ươ khi gõ w đứng đầu: Wowng → Ương, wongw → ương (trước đây bị giữ nguyên chưa biến đổi).
• Sửa undo phím w đứng đầu: Ww → Uw, wiw → uiw (trước đây trả về W / wiw sai).
• Giữ nguyên ngữ cảnh âm tiết khi hoàn tác từ tiếng Anh, cho phép phím dấu/modifier tiếp theo vẫn biến đổi đúng: hopwj → hợp.
• Loại bỏ tùy chọn "Tự động khôi phục từ tiếng Anh" (trùng lặp chức năng với từ điển tiếng Việt) khỏi giao diện cài đặt.
• Sửa lỗi cấu hình trên Linux: Fcitx5 native config ghi đè allowLeadingWAsU về mặc định (tắt) mỗi khi nạp config, làm mất cấu hình người dùng đã bật; nay config.json (do Settings GUI ghi) là nguồn duy nhất cho các tùy chọn gõ.

Cài đặt

1. Tải file: URL Cloud R2
2. Hoặc cài qua Windows Package Manager (WinGet) sau khi manifest được duyệt:

   winget install BambooMintKey.BambooMintKey

Mã băm xác thực (SHA-256)

• BambooMintKey1.1.1-Setup.exe: fe87130e6dde111ef4380bb7269fbfb6f3a26d22c37ba2346ce5db6e5b0a263e

BambooMintKey v1.1.0

BambooMintKey 1.1.0

Bản cập nhật tập trung nâng cao trải nghiệm gõ tiếng Việt với động cơ dự đoán thông minh, đồng thời khắc phục các lỗi ký tự còn sót trong các bản phím cụ thể.

Điểm mới và cải tiến trong bản 1.1.0

• Thêm Predict Engine (động cơ dự đoán):
  • Tăng tốc độ và độ chính xác khi chuyển đổi tổ hợp phím tiếng Việt.
  • Hỗ trợ dự đoán kết quả gõ ngay cả khi người dùng chưa nhập đủ dấu thanh hoặc kết thúc âm tiết.
  • Giảm thiểu hiện tượng phím bị "tắc" hoặc phải chờ xử lý trong các ứng dụng nặng.

Sửa lỗi

• Sửa lỗi ký tự rn trong bảng mã Telex/VARI.
• Sửa lỗi ký tự rm trong bảng mã Telex/VARI.
• Sửa lỗi ký tự st trong bảng mã Telex/VARI.
• Sửa lỗi ký tự sp trong bảng mã Telex/VARI.

Cài đặt

1. Microsoft Store (khuyên dùng - đã sẵn sàng):
   
   
   
2. Tải file: Link download từ Cloud R2
3. Hoặc cài qua Windows Package Manager (WinGet) sau khi manifest được duyệt:

   winget install BambooMintKey.BambooMintKey

Mã băm xác thực (SHA-256)

• BambooMintKey1.1.0-Setup.exe: 9b847596347ef6f65d299fed6fd5d7de06d89f6f9bf7658a961060ec76bd0273