Goxvi v0.0.1

Bản phát hành đầu tiên của Goxvi — bộ gõ tiếng Việt cho Windows 11, xây dựng theo chuẩn Text Services Framework (TSF). Bộ gõ chạy trực tiếp bên trong tiến trình của ứng dụng đang nhập liệu nên hoạt động với cả ứng dụng Win32 cổ điển, ứng dụng nền web (Electron, trình duyệt) lẫn ứng dụng Windows Store (UWP), kể cả ứng dụng 32-bit như Zalo Desktop.

Cài đặt

1. Tải goxvi-setup-0.0.1.exe bên dưới và chạy (cần quyền Administrator — installer đăng ký bộ gõ machine-wide cho cả x64 lẫn x86).
2. Cuối trình cài có sẵn lựa chọn "Đặt Goxvi làm bàn phím tiếng Việt ngay bây giờ" (tick sẵn).
3. Chuyển qua lại giữa tiếng Việt và tiếng Anh bằng Win + Space — giống đổi bàn phím Windows bình thường.

Gỡ cài đặt qua Settings → Apps như ứng dụng thường (bộ gõ tự hủy đăng ký khi gỡ).

Yêu cầu: Windows 11, hoặc Windows 10 ≥ 1809 (có kèm binary x86 cho Windows 10 bản 32-bit — chưa test trên máy 32-bit thật). Không cần .NET hay runtime nào khác.

Tính năng

Hai kiểu gõ (chọn trong app Goxvi Settings, mặc định Telex)

• Simple Telex: aa ee oo dd aw ow uw uow + dấu thanh s f r x j, z xóa dấu. Không có w đứng một mình thành ư — gõ xen tiếng Anh (web, wow, windows...) không bị biến dạng.
• VNI: a6/e6/o6 → â/ê/ô, o7/u7 → ơ/ư (uo7 → ươ), a8 → ă, d9 → đ, số 1–5 = dấu thanh.
• Gõ tắt diphthong: ư + o tự thành ươ (gõ nưoc ra nước nhanh hơn một phím).

Hai kiểu đặt dấu thanh

• Kiểu cũ (mặc định): hòa, thúy — dấu ở nguyên âm đầu.
• Kiểu mới: hoà, thuý — dấu theo âm chính.

Gõ tắt (macro kiểu UniKey)

Khai báo cặp viết tắt → nội dung thay thế trong Goxvi Settings (vd trc → trước, vn → Việt Nam). Gõ trigger rồi kết thúc từ (space, dấu câu, Enter...) là tự thay. Trigger chỉ nhận chữ thường a–z; gõ TRC/Trc sẽ không thay. Có công tắc bật/tắt riêng.

Trải nghiệm gõ kiểu UniKey

• Composition ẩn — không gạch chân chữ đang gõ.
• Esc hủy dấu từ đang gõ dở, trả về đúng chuỗi phím thô (việt + Esc → vieejt).
• Xóa lùi thông minh: gõ sai rồi xóa, phần còn lại hợp lệ thì tự bỏ dấu lại (nhuwg + ⌫ → như).
• Không mất chữ khi click chuột / chuyển cửa sổ — từ đang gõ dở được chốt lại trước khi ứng dụng xử lý click (Telegram, Sublime Text, ô rename của Explorer...).
• Từ đang gõ được chốt trước phím điều hướng — PageUp/Enter trong terminal, SSH, ô F2 rename... nhận đúng chữ đã gõ, không bị lẫn thứ tự.

Riêng tư & an toàn

• Không xử lý phím trong ô mật khẩu (nhận diện qua input scope IS_PASSWORD).
• Hoạt động hoàn toàn ngoại tuyến — không có nội dung gõ hay cấu hình nào rời khỏi máy; bản Release không ghi log nội dung gõ.
• Mã nguồn mở toàn bộ (MIT), engine gõ tách riêng khỏi lớp Windows và có 166 unit test.

Cấu hình

Toàn bộ cấu hình nằm trong %APPDATA%\Goxvi\config.json, chỉnh qua app Goxvi Settings (Start Menu). Thay đổi có hiệu lực trong ~2 giây, áp dụng từ từ tiếp theo bạn gõ — không cần khởi động lại.

Giới hạn đã biết

• Chỉ hỗ trợ layout bàn phím QWERTY.
• Không chạy trên secure desktop (màn hình UAC, đăng nhập) — có chủ đích.
• Bản x86 cho Windows 10 32-bit mới xác minh qua WoW64, chưa test trên OS 32-bit thật.
• Installer chưa ký số — SmartScreen có thể cảnh báo khi chạy lần đầu (chọn More info → Run anyway). Đối chiếu SHA-256 bên dưới trước khi cài.

Checksum

SHA-256 (goxvi-setup-0.0.1.exe):
0054AED7B6D7303D43A71FDB403F9D360F850730F2692877011D2E14DF39B08C

Tự build từ mã nguồn

Cần VS 2022 (MSVC v143) + Windows 11 SDK + Inno Setup 6 — xem README:

.\scripts\build.ps1 -Config Release   # TIP x64 + x86 + Goxvi.exe
.\scripts\build-installer.ps1         # ra dist\goxvi-setup-0.0.1.exe