Thiết lập VKey theo cách bạn làm việc.

Bắt đầu nhanh

1. Tải VKey từ trang phát hành chính thức hoặc cài bằng WinGet.
2. Tắt các bộ gõ tiếng Việt khác để tránh hai chương trình cùng xử lý một phím.
3. Mở VKey, chọn Telex, VNI, Telex + VNI hoặc kiểu gõ tự định nghĩa.
4. Chọn chế độ V để gõ tiếng Việt và E để tạm dừng xử lý phím.

winget install PhatMT97.VKey

Nếu một ứng dụng gõ không đúng, đừng đổi thiết lập chung ngay. Hãy tạo cấu hình riêng cho ứng dụng đó và thử một cách gửi khác.

Kiểu gõ và bảng mã

VKey hỗ trợ các kiểu gõ sau:

• Telex: dùng chữ để đặt dấu và biến đổi nguyên âm.
• VNI: dùng phím số để đặt dấu.
• Telex + VNI: nhận cả hai cách gõ trong cùng một cấu hình.
• Simple Telex: giữ giá trị gốc của w, [ và ] trong nhiều tình huống hơn.
• Tự định nghĩa: cho phép gán lại các phím đặt dấu.

Các bảng mã gồm Unicode, TCVN3, VNI Windows, Unicode Compound và Vietnamese Locale. Với phần lớn ứng dụng hiện nay, nên giữ Unicode.

Cấu hình theo ứng dụng

Bạn có thể đặt kiểu gõ, bảng mã và cách gửi riêng cho từng file .exe. VKey áp dụng cấu hình khi cửa sổ tương ứng được chọn.

Khi dùng cách gửi Clipboard, dữ liệu clipboard không phải văn bản như hình ảnh có thể bị ảnh hưởng. Hãy sao lưu nội dung clipboard quan trọng trước khi thử.

Chuyển chế độ Việt và Anh

• Lưu chế độ theo ứng dụng: ghi nhớ trạng thái V hoặc E của từng ứng dụng.
• Khoá E: luôn dùng tiếng Anh và chặn phím tắt chuyển chế độ trong ứng dụng đã chọn.
• Khoá V: luôn bật tiếng Việt trong ứng dụng đã chọn.
• Tự tắt khi bàn phím CJK: chuyển sang E khi Windows dùng bố cục Trung, Nhật hoặc Hàn, sau đó bật lại khi trở về bố cục US.

Khoá chế độ theo ứng dụng áp dụng chủ yếu cho hook engine. Ứng dụng đang dùng TSF có thể có hành vi khác.

Chính tả, gõ tự do và khôi phục từ

• Kiểm tra chính tả: giảm việc đặt dấu nhầm vào chuỗi không giống âm tiết tiếng Việt.
• Gõ tự do: bỏ qua kiểm tra chính tả khi viết mã, tên riêng hoặc chuỗi đặc biệt.
• Khôi phục từ gốc: trả lại các phím ban đầu khi VKey nhận diện sai một từ.
• Danh sách loại trừ: giữ nguyên thuật ngữ, từ viết tắt hoặc chuỗi riêng của người dùng.
• Viết hoa đầu câu: hoạt động theo ngữ cảnh; TSF có thể cung cấp ngữ cảnh tốt hơn hook engine.

Engine C++20 có sẵn đáp ứng các chức năng gõ thông thường. Engine Rust cho kiểm tra chính tả nâng cao là tùy chọn và mặc định tắt.

Quản lý phím tắt

Trong mục quản lý phím tắt, bạn có thể gán tổ hợp cho các thao tác thường dùng:

• Chuyển giữa V và E.
• Khôi phục từ gốc.
• Tạm bỏ qua macro.
• Chuyển mã phần văn bản đang chọn.
• Bật hoặc tắt chế độ game cho ứng dụng đang mở.

Chế độ game không có phím tắt mặc định để tránh trùng với phím đã dùng trong game.

Sử dụng Windows TSF

VKey hỗ trợ Text Services Framework theo hai cách:

• Tăng cường ngữ cảnh: hook vẫn là cách nhập chính, TSF hỗ trợ đọc ngữ cảnh để xử lý dấu và viết hoa.
• TSF làm phương thức nhập chính: áp dụng cho các ứng dụng được thêm vào danh sách TSF. Cách này có thể phù hợp hơn với Office, ứng dụng Windows Store và một số ô nhập đặc thù.

Khi TSF là phương thức nhập chính, Windows có thể gạch chân tạm thời phần chữ đang được soạn. Đây là trạng thái composition bình thường.

Gõ tắt và macro

Macro thay một chuỗi ngắn bằng nội dung dài hơn. Nội dung có thể có xuống dòng và dài tới 20.000 ký tự.

• Chọn phím kích hoạt như Space, Enter hoặc Tab.
• Có thể dùng macro trong chế độ tiếng Anh nếu tùy chọn tương ứng được bật.
• Kiểu viết hoa của kết quả có thể theo cách viết của từ kích hoạt.

Ví dụ: cấu hình dc thành một địa chỉ đầy đủ, sau đó gõ dc và phím kích hoạt để chèn nội dung.

Chuyển mã và biến đổi chữ

Công cụ chuyển mã làm việc trên phần văn bản đang chọn. Các thao tác gồm:

• Chuyển giữa Unicode, TCVN3, VNI Windows, Unicode Compound và Vietnamese Locale.
• Chuyển HOA, chuyển thường, viết hoa đầu câu hoặc bỏ dấu.
• Tự động dán kết quả và chọn lại phần văn bản vừa thay đổi.
• Chuyển tuần tự qua nhiều phép biến đổi bằng cùng một phím tắt.

Trước khi dùng trên tài liệu quan trọng, nên thử với một đoạn văn bản ngắn để kiểm tra ứng dụng đích có giữ nguyên lựa chọn hay không.

Cấu hình cho game

Chế độ game gửi lại phím gốc để game vẫn nhận W, A, S, D khi Telex xử lý dấu.

Bạn có thể bật theo hai cách:

1. Thêm file .exe của game trong Cấu hình từng ứng dụng và chọn Chế độ game.
2. Gán phím tắt Bật / tắt chế độ game cho app đang mở, sau đó nhấn ngay trong game.

Nếu game chạy bằng quyền Administrator, Windows có thể chặn VKey đang chạy với quyền thường. Chỉ chạy VKey bằng quyền Administrator khi ứng dụng đích thực sự yêu cầu.

Khởi động cùng Windows và watchdog

VKey đăng ký autostart theo một trong hai cơ chế:

• Chế độ thường dùng Registry của tài khoản hiện tại.
• Chế độ chạy với quyền Administrator dùng Task Scheduler.

Sau khi cập nhật hoặc di chuyển thư mục VKey, hãy tắt rồi bật lại Khởi động cùng Windows để ghi đường dẫn mới. Nếu autostart vẫn lỗi, tắt VKey và làm theo hướng dẫn gỡ cấu hình autostart cũ, sau đó mở VKey và bật lại.

Watchdog là tùy chọn riêng, mặc định tắt. Khi được bật, chương trình giám sát có thể khởi động lại VKey sau khi ứng dụng ngừng phản hồi hoặc thoát bất thường. Thoát VKey theo cách thông thường sẽ không kích hoạt khởi động lại.

Xử lý sự cố và bảo mật

VKey không đặt dấu trong một ứng dụng

1. Kiểm tra VKey đang ở chế độ V.
2. Tắt các bộ gõ khác.
3. Tạo cấu hình riêng cho ứng dụng và thử cách gửi phù hợp.
4. Nếu ứng dụng chạy bằng quyền Administrator, kiểm tra mức quyền của VKey.
5. Thử TSF nếu ô nhập không tương thích với hook engine.

Windows hoặc phần mềm diệt virus cảnh báo

Chỉ tải VKey từ GitHub Releases chính thức. Trước khi tạo ngoại lệ, hãy xác minh bản tải theo hướng dẫn antivirus và Sigstore. Trạng thái ký số có thể khác theo từng phiên bản.

Debug Log

Debug Log có thể ghi lại thao tác bàn phím để chẩn đoán lỗi. File log có thể chứa mật khẩu hoặc dữ liệu nhạy cảm.

Trước khi gửi log:

1. Mở file và đọc lại nội dung.
2. Xóa các dòng không liên quan.
3. Chỉ gửi đoạn cần thiết để tái hiện lỗi.

Đọc thêm tài liệu bảo mật và GUIDE.md gốc trên GitHub.