Riêng tư
Nguyên tắc: nội dung bạn gõ không rời khỏi máy và không được ghi xuống ổ đĩa, trừ một trường hợp do chính bạn bắt đầu (bản ghi thao tác gõ để báo lỗi, mô tả bên dưới). Lưu lượng mạng tự động duy nhất của ứng dụng là kiểm tra cập nhật.
Cập nhật lần cuối: 13/11/2026. Trang này được lưu cùng mã nguồn; mọi điểm kết nối mạng mới phải được ghi vào đây trước khi phát hành.
Tóm tắt
- Không telemetry, không dịch vụ phân tích, không SDK báo cáo sự cố, không cấu hình hay quy tắc tải từ xa.
- Không có cửa sổ web tải nội dung từ xa. Ghi chú phát hành hiện mà không tải tài nguyên ngoài.
- Ô mật khẩu và chế độ nhập bảo mật của macOS luôn được bỏ qua. Đây không phải là cài đặt.
- Chỉ cần một quyền: Trợ năng (macOS 12 tới 26) hoặc Điều khiển thiết bị và truy cập dữ liệu (macOS 27). Nếu macOS đòi thêm, ứng dụng nói rõ lý do. Không có quyền Ghi màn hình, Automation hay Toàn quyền truy cập ổ đĩa.
- Khi thiếu quyền, bàn phím của bạn vẫn gõ bình thường (ứng dụng nhả phím ra, không giữ lại).
Ứng dụng lưu gì trên máy bạn
| Dữ liệu | Nơi lưu | Ghi chú |
|---|---|---|
| Cài đặt, quy tắc theo ứng dụng, chế độ Việt/Anh theo ứng dụng, gõ tắt | ~/Library/Application Support/KeyVi/ | Chỉ lưu những lựa chọn bạn tự đặt. Thư mục chỉ mình bạn đọc được. Gõ tắt là nội dung do bạn viết, có thể chứa chữ riêng tư. |
| Bản sao lưu cài đặt | ~/Library/Application Support/KeyVi/backups/ | Giữ 5 bản gần nhất để khôi phục khi tệp bị hỏng. |
| Nhật ký sức khoẻ ứng dụng | ~/Library/Logs/KeyVi/ | Chỉ có sự kiện không chứa nội dung (loại phím, mã kết quả, thời gian). Tối đa 5 tệp, mỗi tệp 1 MB, giữ 14 ngày. |
| Bản ghi thao tác gõ (chỉ khi bạn bấm bắt đầu) | ~/Library/Logs/KeyVi/captures/ | Xem mục bên dưới. Tự xoá sau 24 giờ, không nằm trong bản sao lưu Time Machine. |
| Trạng thái cập nhật (Sparkle) | ~/Library/Preferences/vn.kal.keyvi.plist và ~/Library/Caches/vn.kal.keyvi/ | Do hệ thống quản lý theo mặc định. |
Mọi tệp ghi bằng cách ghi an toàn (ghi tệp tạm rồi đổi tên) để cập nhật hay mất điện không làm hỏng cài đặt. Đường dẫn đầy đủ để xoá nằm ở mục "Xoá dữ liệu" bên dưới.
Ứng dụng gửi gì đi
Chỉ một thứ: kiểm tra cập nhật, mỗi 24 giờ (bạn tắt được trong Cài đặt).
- Ứng dụng tải
https://keyvi.kal.vn/appcast.xmlqua HTTPS, rồi tải bản cập nhật từ cùng máy chủ khi bạn đồng ý hoặc khi cập nhật tự động đang bật. VERIFY Nếu bản cập nhật cũng được lưu ở GitHub Releases, trang này sẽ ghi rõ. - Như mọi yêu cầu web, máy chủ thấy địa chỉ IP của bạn và tên cùng phiên bản ứng dụng. Ứng dụng không gửi hồ sơ cấu hình hệ thống (tính năng này của Sparkle bị tắt).
- Bản cập nhật phải mang chữ ký EdDSA hợp lệ, nếu không ứng dụng từ chối cài.
- Ngoài ra không có yêu cầu mạng nào khác. Có kiểm tra tự động trong quy trình phát hành để bảo đảm tệp chạy chỉ chứa các địa chỉ máy chủ đã khai báo.
Dữ liệu chẩn đoán gồm gì, không gồm gì
Khi bạn bấm Báo lỗi..., ứng dụng tạo một báo cáo văn bản và cho bạn xem đúng nội dung sẽ gửi trước khi sao chép hay lưu. Báo cáo không bao giờ được gửi tự động.
Có trong báo cáo
- Phiên bản và bản dựng ứng dụng, kênh cập nhật.
- Phiên bản macOS, loại máy (Apple silicon hoặc Intel), bố cục bàn phím, các nguồn nhập đang bật (chỉ mã định danh).
- Trạng thái các quyền, trạng thái Secure Input và ứng dụng có thể đang giữ nó.
- Ứng dụng đang gõ (mã định danh và phiên bản), quy tắc tương thích đang áp dụng.
- Cài đặt không chứa nội dung (kiểu gõ, các công tắc), thống kê thời gian xử lý, 50 sự kiện sức khoẻ gần nhất, các bộ gõ khác đang chạy.
- Loại phím gần đây (chữ cái, chữ số, xoá lùi, phím bổ trợ), không bao giờ là giá trị phím.
Không bao giờ có trong báo cáo
- Chữ bạn đã gõ, từ, giá trị của ô nhập, nội dung bảng nhớ tạm (clipboard).
- Tiêu đề cửa sổ, địa chỉ trang web, đường dẫn tệp trong thư mục cá nhân của bạn (ngoài thư mục riêng của KeyVi).
- Nội dung gõ tắt (chỉ ghi số lượng).
- Danh sách chế độ theo ứng dụng của bạn, trừ mục của đúng ứng dụng bạn đang báo lỗi.
Bản ghi thao tác gõ (tuỳ chọn, do bạn bắt đầu)
Đây là trường hợp duy nhất chữ bạn gõ chạm tới ổ đĩa, và bạn thấy rõ lúc nó diễn ra. Nó giúp tái hiện lỗi khó mà báo cáo thường không đủ.
- Chỉ bắt đầu khi bạn chủ động bấm trong cửa sổ Chẩn đoán và xác nhận.
- Mặc định 60 giây, tối đa 180 giây, rồi tự dừng. Suốt thời gian đó có biểu tượng thanh menu khác và một bảng đếm ngược kèm nút Dừng.
- Không ghi gì khi macOS đang ở chế độ nhập bảo mật hoặc khi ô mật khẩu đang được chọn.
- Lưu cục bộ, không nằm trong sao lưu, tự xoá sau 24 giờ hoặc ngay khi bạn xuất hay huỷ. Bạn xem được bản đọc được trước khi chia sẻ. Không bao giờ tự tải lên.
Bảng nhớ tạm (clipboard)
Ứng dụng chỉ ghi vào bảng nhớ tạm khi bạn bấm Mở GitHub trong cửa sổ báo lỗi (để dán báo cáo vào GitHub), và cửa sổ nói rõ điều đó trước khi ghi. Ngoại lệ còn lại là chế độ tương thích "dán" mà bạn tự bật cho một ứng dụng cụ thể; chế độ này lưu rồi khôi phục bảng nhớ tạm quanh mỗi lần dán và được giải thích khi bạn bật.
Trang web
- Phân tích truy cập: Umami, do dự án tự vận hành. Các trang của trang web này (không phải ứng dụng, không phải trang ghi chú phát hành) tải mã của Umami từ
https://stats.kal.vn, một máy chủ do chính dự án vận hành, và gửi tới đó lượt xem trang: địa chỉ trang, tiêu đề trang, trang dẫn tới, kích thước màn hình và ngôn ngữ của trình duyệt. Umami không dùng cookie và không lưu gì trong trình duyệt của bạn; dự án không thu thập dữ liệu cá nhân và không lập hồ sơ người dùng. Để đếm số người xem, máy chủ tạo một mã lượt truy cập bằng cách băm một chiều địa chỉ IP và trình duyệt của bạn cùng một giá trị đổi mỗi tháng; địa chỉ IP không được lưu, chỉ lưu quốc gia và thành phố ước tính từ địa chỉ đó cùng loại trình duyệt, hệ điều hành và thiết bị. Nếu trình duyệt của bạn bật Do Not Track, không có gì được gửi đi. Dự án chỉ xem số liệu tổng hợp (theo trang, nguồn truy cập và quốc gia); dữ liệu không được chia sẻ với ai và không có quảng cáo. - Không cookie, không bộ nhớ cục bộ để theo dõi. Phông chữ là phông có sẵn trên máy bạn; mã, hình ảnh, bản cập nhật và tệp cài đặt (DMG) đều phục vụ từ chính máy chủ của trang này.
- Máy chủ web ghi mỗi yêu cầu chỉ với thời điểm, phương thức, đường dẫn (không có phần truy vấn), mã kết quả và kích thước; không ghi địa chỉ IP, trình duyệt hay trang dẫn tới. Từ nhật ký này, mỗi ngày chúng tôi đếm số yêu cầu tới
appcast.xmlđể ước lượng số máy đang dùng, và số lượt tải từng tệp; chỉ giữ con số tổng theo ngày. - Kết nối đi qua Cloudflare và bộ định tuyến của máy chủ trước khi tới máy chủ web; như mọi trang web, các lớp này thấy địa chỉ IP của bạn trong lúc xử lý yêu cầu. VERIFY Xác minh thời gian lưu nhật ký của hai lớp này trước khi công bố.
- Số lượt cài qua Homebrew lấy từ bộ đếm công khai của Homebrew.
Báo lỗi và hỗ trợ
Khi bạn mở một issue trên GitHub hoặc gửi email, nội dung bạn viết do bạn quyết định và tuân theo chính sách của GitHub hoặc nhà cung cấp email của bạn. KeyVi không tự gửi những gì bạn đã gõ.
Ủng hộ
Ứng dụng không lưu hay gửi thông tin người ủng hộ. Việc chuyển tiền diễn ra giữa bạn và ngân hàng của bạn hoặc GitHub, theo chính sách riêng của họ.
Xoá dữ liệu
Thoát KeyVi, kéo ứng dụng vào Thùng rác, rồi xoá các thư mục trong bảng ở trên. Nếu cài bằng Homebrew, một lệnh làm hết:
brew uninstall --cask --zap keyvi