← Quay lại phần Hỗ trợ

Chuyển từ Tệp văn bản hoặc CSV sang KeyVi

Đây là cách chung, dùng được cho mọi nguồn: một tệp văn bản, mỗi dòng một gõ tắt. KeyVi nhập cả hai dạng dưới đây.

Văn bản phân tách bằng phím Tab

Mỗi dòng gồm viết tắt, một ký tự Tab, rồi nội dung đầy đủ. Viết tắt dài 1 đến 32 ký tự ASCII in được, không có dấu cách, không có chữ tiếng Việt (vì viết tắt được so khớp theo phím bạn gõ: dc, không phải đc). Nội dung dài tới 4.000 ký tự.

vn	Việt Nam
dc	được
tphcm	Thành phố Hồ Chí Minh

CSV hai cột

vn,Việt Nam
dc,được
"cam on","Cảm ơn bạn rất nhiều, hẹn gặp lại"

Mã hoá UTF-8. Đặt nội dung có dấu phẩy trong dấu ngoặc kép.

Tệp xuất cài đặt của chính KeyVi

Trong Cài đặt > Giới thiệu & Hỗ trợ bạn xuất toàn bộ cài đặt ra một tệp JSON, UTF-8, tên dạng keyvi-settings-NĂMTHÁNGNGÀY.json. Trường kind luôn là settings-export; schemaVersion (số nguyên) là phiên bản định dạng; writtenBy là phiên bản ứng dụng đã ghi tệp; exportedAt là thời điểm xuất (ISO 8601, giờ UTC). Tiếp theo là settings (cài đặt), appModes (chế độ theo ứng dụng), ruleOverrides (quy tắc tương thích bạn tự đặt) và macros (gõ tắt: viết tắt trigger, nội dung expansion, theo chữ hoa adaptCase, đang bật enabled). Khi xuất, bạn có thể bỏ chọn gõ tắt và chế độ theo ứng dụng, vì gõ tắt có thể chứa chữ riêng tư; phần đã bỏ chọn sẽ không có trong tệp. Khi nhập tệp từ phiên bản mới hơn, KeyVi nhập các trường nó hiểu và liệt kê những trường bị bỏ qua.

{
  "kind": "settings-export",
  "schemaVersion": 1,
  "writtenBy": "0.1.0",
  "exportedAt": "2026-11-13T09:00:00Z",
  "settings": { },
  "appModes": { },
  "ruleOverrides": [ ],
  "macros": [
    { "id": "3F2504E0-4F89-11D3-9A0C-0305E82C3301", "trigger": "vn", "expansion": "Việt Nam", "adaptCase": true, "enabled": true }
  ]
}

Nhập vào KeyVi

  1. Mở KeyVi, vào Cài đặt > Gõ tắt > Nhập từ tệp... (hoặc chọn Chọn tệp... ở bước nhập trong lúc làm quen).
  2. Xem bảng xem trước: số dòng mới, trùng lặp và không hợp lệ. Với dòng trùng, chọn giữ bản của bạn hoặc dùng bản nhập vào.
  3. Dòng không hợp lệ được bỏ qua kèm lý do; một dòng lỗi không làm hỏng cả lần nhập.