VINHMATH · ỨNG DỤNG MÁY TÍNH
BẢN DÙNG THỬ MÁY TÍNH

Tải bằng tài khoản VinhMath đã được cấp quyền tải riêng cho ứng dụng.
Chỉ dùng gói đúng hệ điều hành/kiến trúc và đối chiếu SHA-256 được công bố.
SHA-256 xác nhận nội dung tệp, không phải chữ ký xác nhận nhà phát hành.

CÁC THÀNH PHẦN ĐƯỢC TÁCH RIÊNG
- VMExam: trình soạn tài liệu, chưa có ngân hàng đề.
- VMpdf: trình đọc PDF và ghi chú độc lập; có thể kết nối với VMExam.
- Ngân hàng đề và AI local không nằm trong các gói dùng thử này.
- TeX phải được cài riêng nếu muốn biên dịch PDF trên máy.

TRƯỚC KHI CÀI HOẶC THAY BẢN
Lưu bài, đóng ứng dụng và sao lưu hồ sơ/tài liệu/ghi chú. Giữ bản cũ để quay lui.
Không chép dữ liệu vào resources/app hoặc bên trong .app; không xóa hồ sơ khi gỡ.
Các gói hiện chưa có chữ ký nhà phát hành đã xác nhận. Nếu hệ thống chặn hoặc
thông tin tệp không khớp, dừng và liên hệ VinhMath; không tắt bảo vệ toàn máy.

WINDOWS 64-BIT (INTEL/AMD)
VMExam: mở tệp AppOnly-Setup.exe để cài chương trình.
VMpdf: giải nén toàn bộ ZIP vào thư mục riêng có quyền ghi, rồi mở VMpdf.exe.
Không chỉ lấy riêng tệp .exe ra khỏi các tệp đi kèm.
VMExam đã kiểm hoạt động từ thư mục gói; kiểm cài/nâng cấp bằng bộ cài chưa chạy.
Không tắt SmartScreen hoặc phần mềm bảo vệ để bỏ qua một tệp chưa xác minh.

MAC CHIP APPLE SILICON (M1/M2/M3/M4…)
Mac: VMExam 0.9.17 và VMpdf 0.3.6. Windows/Linux vẫn dùng bản đã công bố riêng.
Giải nén .tar.gz, giữ nguyên toàn bộ cấu trúc; không chép đè vào gói .app cũ.
VMExam: giữ VMExam.app và VMExam-module.json cạnh nhau trong một thư mục riêng.
VMpdf: giữ cả thư mục VMpdf, gồm VMpdf.app và VMpdf-module.json; khi kết nối
từ VMExam, chọn thư mục VMpdf này, không chỉ chọn riêng tệp bên trong .app.
Lưu bài và đóng cả hai app cũ trước khi mở bản mới. Không xóa hồ sơ/ghi chú.
Gói mới đã sửa chữ ký thư viện Electron, vị trí manifest và chế độ RAM/Retina.
Đây là bản ký ad-hoc chưa được Apple notarize; macOS có thể chặn mở.
Chưa kiểm cài/nâng cấp trên Mac của người dùng. Nếu bị chặn, liên hệ để được
hướng dẫn theo từng tệp đã xác minh; không tắt Gatekeeper, xóa quarantine hàng
loạt hoặc chạy lệnh mở khóa toàn hệ thống. Không dùng gói này cho Mac Intel.

LINUX X64
Giải nén toàn bộ .tar.gz và giữ nguyên các tệp/quyền trong gói.
Đây là gói portable, không phải DEB/AppImage. Máy cần thư viện Electron và
cấu hình sandbox phù hợp. Nếu thiếu thư viện hoặc không mở được, dừng và báo lỗi.
Không chạy ứng dụng bằng root hoặc thêm --no-sandbox để lách lỗi.

BIÊN DỊCH LATEX TRÊN MÁY
Windows/Linux: https://tug.org/texlive/
Mac: https://tug.org/mactex/
Cài tự nguyện từ trang chính thức. Sau đó vào cài đặt LaTeX trong VMExam, chọn
thư mục TeX, kiểm tra engine và biên dịch một tệp nhỏ trước khi dùng cho lớp.
Ứng dụng không tự tải/cài TeX hay tự xin quyền quản trị.
Chưa kiểm biên dịch TeX trên Mac CI; không coi mở được PDF là đã kiểm biên dịch.

GHÉP VMpdf VỚI VMExam
Giải nén VMpdf vào thư mục riêng và mở VMpdf trước. Trong VMExam, dùng chức năng
kết nối VMpdf, chọn đúng gói rồi đối chiếu/xác nhận manifest được hiển thị.
Giữ nguyên VMpdf-module.json cùng toàn bộ chương trình, không sửa manifest.
Luồng kết nối khi VMpdf đã mở đã được kiểm trên Windows/Mac/Linux. Mở lạnh
VMpdf từ VMExam chưa được xác nhận trên mọi nền tảng.

GIỚI HẠN VÀ PHẢN HỒI
Không có gói AI local được phát hành trong đợt này. Không có ngân hàng đề được
tự tải hoặc tự nạp. Nguồn mua/sưu tầm cần được quản lý và cấp quyền riêng.
Khi báo lỗi, ghi tên ứng dụng, phiên bản, hệ điều hành, bước đã làm và thông báo;
không gửi mật khẩu hoặc dữ liệu học sinh. Bản dùng thử không bảo đảm mọi máy
cấu hình yếu đều đạt cùng hiệu năng.