User Guide

Hướng dẫn sử dụng MyTeX

Hướng dẫn này khớp với cấu trúc hiện tại: Tổng quan, Xử lý TeX, Tạo đề từ Ma trận, Đề thi trực tuyến, Soạn thảo, Đấu trường và Trợ lý MTX-AI. Đề thi trực tuyến dùng phiếu HTML do Apps Script phân phối và nhận bài; ứng dụng không tạo hoặc sử dụng Google Forms.

Quy trình khuyến nghị Đấu trường Xử lý lỗi

Video giới thiệu và thao tác MyTeX · Xem trực tiếp trên Facebook

1. Cấu hình ban đầu

Chuẩn bị trước khi dùng

Tải đúng gói từ GitHub Releases chính thức, giải nén toàn bộ gói rồi mở MyTeX. Bản đóng gói không cần Python, nhưng các chức năng biên dịch vẫn cần một bộ LaTeX cài riêng.

1Nền tảng: có gói Windows x64, macOS Intel, macOS Apple Silicon và Linux x64. Linux cần môi trường desktop cùng các thư viện hệ thống Qt/XCB tương thích.
2LaTeX: cài MiKTeX, TeX Live hoặc MacTeX và bảo đảm pdflatex hoạt động. Đây là phụ thuộc riêng, không nằm trong gói MyTeX; cần cho PDF, TikZ, ảnh đề trực tuyến và trình chiếu.
3Đăng nhập MyTeX: trình duyệt cấp openid, email, profile và drive.file. Quyền Drive chỉ áp dụng cho tệp MyTeX tạo hoặc tệp người dùng chọn; không có quyền Forms, drive.appdata, Gmail hay toàn bộ Drive.
4MTX-AI: nhập API key Gemini, DeepSeek, OpenAI, Claude hoặc Grok nếu dùng Soạn thảo, Trợ lý MTX-AI hoặc chấm tự luận. Dữ liệu tương ứng có thể được gửi tới hãng đã chọn.
5Đề thi trực tuyến: cần Apps Script Web App do giáo viên tự triển khai. Script có màn hình cấp quyền riêng cho Drive, Sheets, Mail và trigger; các quyền này không được cộng vào phiên đăng nhập desktop.
6Tùy chọn: Short.io chỉ dùng để rút gọn URL; Email/Zalo chỉ cần khi gửi kết quả. Không có Short.io thì MyTeX dùng URL Apps Script gốc.

Các gói hiện chưa ký Authenticode/Developer ID và chưa notarize, nên hệ điều hành có thể cảnh báo. Mỗi bản phát hành có tệp SHA-256 để kiểm tra thủ công; bộ cập nhật chưa tự xác minh chữ ký/checksum. Chỉ tải từ liên kết chính thức, sao lưu dữ liệu và thử trọn quy trình bằng một đề nhỏ trước khi dùng thật.

2. Tổng quan

Trung tâm điều phối

Tổng quan giúp kiểm tra MyTeX đã sẵn sàng hay chưa. Từ đây có thể mở thiết lập Đề thi trực tuyến, Email, Zalo, MTX-AI, thông tin cá nhân và Giao diện.

1Mở nhanh Xử lý TeX, Tạo đề từ Ma trận, Đề thi trực tuyến, Soạn thảo, Đấu trường và Trợ lý MTX-AI.
2Theo dõi trạng thái đăng nhập MyTeX/Google ở thanh bên.
3Đổi giao diện, font chữ và bảng màu nếu cần.

3. Xử lý TeX

Chuẩn hóa nguồn và ngân hàng câu hỏi

Phân hệ này dùng để xử lý file .tex thô trước khi đưa vào ngân hàng hoặc dùng cho các bước sau. Danh mục tích hợp gồm 991 mẫu ID Toán lớp 6–12, được tổ chức theo lớp, mạch, chương, bài và chủ đề; ứng dụng không cần các tệp .tex nguồn của catalog khi chạy.

1Chọn file nguồn .tex.
2Lọc theo loại câu, ID, dạng hoặc nội dung; các bộ lọc ID phân cấp hiển thị tên chương, bài và chủ đề tương ứng.
3Mở hướng dẫn ID để tạo trang HTML tra cứu toàn bộ danh mục, hoặc kiểm tra câu hợp lệ, xuất thử và bổ sung vào ngân hàng.

4. Tạo đề từ Ma trận

Sinh đề theo ma trận

Tạo đề từ Ma trận ghép ngân hàng câu hỏi với ma trận Excel, kiểm tra đủ/thiếu câu rồi xuất đề.

1Nạp ngân hàng và ma trận.
2Kiểm tra đáp ứng theo từng khối ma trận.
3Thiết lập số mã đề và sinh file .tex/PDF.

5. Đề thi trực tuyến

Phiếu HTML, Apps Script và Drive

Phân hệ này tạo trang thi HTML, tải đề và ảnh lên thư mục Drive của MyTeX, rồi đăng ký đề với Apps Script Web App. Học sinh mở liên kết hoặc quét QR và nộp bài vào Google Sheets qua Apps Script. Tùy chế độ, trang có thể tải MathJax từ CDN và ảnh từ Drive; luồng hiện tại không tạo Google Form và ứng dụng desktop không gọi Google Forms API.

Thiết lập Apps Script một lần

1Vào Tổng quan → Đề thi trực tuyến, nhập ID thư mục Drive nếu đã có, secret và email giáo viên tùy chọn; bấm Sao chép template .gs. MyTeX có thể tạo thư mục gốc khi chưa có ID.
2Tạo dự án tại Apps Script, thay toàn bộ Code.gs bằng template, chạy hàm setup và duyệt các quyền riêng của script.
3Triển khai Web App với Execute as: Me và Who has access: Anyone. Dán URL kết thúc bằng /exec cùng secret vào MyTeX, lưu rồi bấm Kiểm tra kết nối.
4Nếu sửa Code.gs, phải vào Manage deployments, chọn phiên bản mới và triển khai lại; chỉ dán code không làm deployment đang chạy tự đổi.

Tạo, nhận bài và chấm

1Chọn một hoặc nhiều tệp .tex. Hộp thoại Xuất đề thi gom mọi lựa chọn theo thứ tự làm việc: Thông tin đề (tên đề, tiêu đề trang, liên kết rút gọn), Lịch thi & mã vào phòng, Thang điểm, Bản in PDF, Trang làm bài và Gửi kết quả cho học sinh; dòng cuối hộp thoại tóm tắt lựa chọn trước khi bấm nút. Đề có câu tự luận sẽ hiện thêm một ô điểm cho mỗi câu: mặc định chia đều, nhưng có thể đặt câu 1 là 2 điểm, câu 2 là 1 điểm, câu 3 là 0,5 điểm. Tổng các câu chính là điểm Phần IV; sửa ô Phần IV thì MyTeX chia đều lại cho các câu. Tạo lại đề từ cùng tệp .tex thì hộp thoại tự điền lại tên đề, URL rút gọn, điểm từng phần và lịch thi của lần trước (lịch chỉ dùng lại khi giờ đóng đề chưa qua). Giờ đóng phải sau giờ mở, nếu không MyTeX nhắc sửa trước khi tạo.
2Trên cùng hộp thoại chọn một trong hai thẻ: Đề trực tuyến hoặc Chỉ bản in PDF. Chọn Chỉ bản in PDF thì hộp thoại chỉ còn tên đề và mẫu bìa; bấm Xuất PDF là MyTeX biên dịch bộ đề để in, không tạo liên kết, không tải lên Drive, không thêm đề vào danh sách và không in mã QR.
3Chọn dữ liệu dạng ảnh hoặc HTML + MathJax, giao diện toàn đề hoặc từng câu, gửi kết quả, và chế độ giám sát nếu cần; sau đó tạo liên kết/QR cho học sinh. Mục Hoán vị cho mỗi học sinh một thứ tự riêng, trộn ngay khi mở trang thi: Hoán vị câu hỏi trong từng loại dùng được cho cả đề ảnh lẫn MathJax, câu chỉ đổi chỗ trong cùng phần; Hoán vị A–D chỉ có ở đề MathJax, cho câu trắc nghiệm một lựa chọn, và tự bỏ qua câu có phương án kiểu “Tất cả các phương án trên” hay “Cả A và B”. Đề MathJax được đánh lại số câu trên trang; đề ảnh giữ số gốc cho khớp chữ in trong ảnh. Bài nộp, phiếu kết quả, tệp .tex và PDF vẫn theo thứ tự gốc nên chấm không bị ảnh hưởng.
4Mỗi đề có mã MyTeX ổn định; thư mục của đề trên Drive đặt theo dạng <tên gốc>-<mã MyTeX>, ví dụ 2KT26-GK1-TT-OnTap-1-MTX-20260924-EC8NYA4R. Ứng dụng lưu bản nguồn .tex theo mã đề và sao lưu nguồn lên Drive; trong bảng kết quả toàn màn hình có thể sao chép lại .tex. Với catalog cũ, MyTeX thử tìm nguồn cục bộ/Drive và cho phép liên kết đúng tệp nếu chưa nhận ra.
5Ở Chấm bài, làm mới danh sách, mở phản hồi và chấm các bài mới. Trắc nghiệm, đúng/sai và trả lời ngắn được chấm tự động; tự luận có thể dùng MTX-AI sau khi giáo viên rà soát.
6Ở Thống kê, lọc theo đề/lớp/học sinh, xem biểu đồ tổng hợp hoặc phân tích từng câu; có thể sao chép ảnh câu hỏi để đối chiếu và xuất Excel. Trong Phân tích từng câu, nhấp đôi một câu (hoặc bấm nút bảng) để chữa câu đó bằng cửa sổ trình chiếu như ở Soạn thảo: bút, hình, tẩy viết trực tiếp lên ảnh câu, nút hiện lời giải, ←/→ chuyển câu, F11 toàn màn hình; nút Trình chiếu chữa bài mở cả đề từ màn mở đầu. Đề HTML + MathJax lấy ảnh câu từ PDF dựng đề nên chỉ trình chiếu và sao chép ảnh được trên máy đã tạo đề. Ở Đồng bộ, sao lưu hoặc khôi phục catalog và sắp xếp thư mục đề trên Drive.

Bảng phản hồi và xuất bảng điểm

Nhấp đôi một đề ở danh sách để mở bảng phản hồi. Thanh dưới bảng chỉ giữ ba việc dùng hằng ngày — Tải lại phản hồi, Chấm phản hồi đang chọn, Xuất bảng điểm — mọi thao tác còn lại nằm trong menu chuột phải ngay trên dòng bài làm.

1Chuột phải vào một bài: chấm bài đang chọn, chấm tay phần tự luận, mở phiếu kết quả, gửi Email/Zalo, xem lịch sử chấm & gửi, xóa phản hồi. Chọn nhiều dòng bằng Ctrl/Shift thì thao tác áp dụng cho cả nhóm. Cuối menu còn có việc của cả đề: sửa đáp án & thang điểm, phân tích từng câu, sao chép .tex của đề.
2Xuất bảng điểm: bấm Xuất bảng điểm rồi chọn .xlsx, .csv hoặc .json. Bảng gồm họ tên, lớp, mã số, email, trạng thái, giờ bắt đầu, giờ nộp, thời lượng, điểm tổng và điểm từng phần (trắc nghiệm, đúng/sai, trả lời ngắn, tự luận), lần chấm, chế độ chấm, tình trạng gửi kết quả, cảnh báo giám sát và đường dẫn phiếu.
3Tệp .xlsx có thêm trang Thong tin ghi mã đề, tiêu đề, liên kết và vài con số tổng hợp (số bài nộp, điểm trung bình, cao nhất, thấp nhất); điểm là ô số nên cộng trung bình ngay trong Excel được. Tệp .csv lưu kèm BOM nên mở bằng Excel không vỡ dấu tiếng Việt; tệp .json giữ nguyên cấu trúc để nạp sang phần mềm khác.
4Bảng Danh sách đề thi ở trang chính và bảng Tất cả đề thi trực tuyến đều bỏ hẳn hàng nút. Chuột phải vào một đề là có đủ: mở bảng phản hồi · tải lại phản hồi · xem tất cả đề toàn màn hình — mở liên kết học sinh · mở thư mục đề trên Drive · mở thư mục phiếu kết quả — sao chép thông tin đề · sao chép .tex (chỉ phần câu hỏi, bỏ mọi khai báo) · mở .tex nguồn · mở PDF nguồn (bản in kèm mã QR) · xuất bảng điểm — chấm tất cả bài mới · sửa đáp án & thang điểm · phân tích từng câu — xóa đề. Trước khi xóa, MyTeX liệt kê những gì sẽ mất: đề khỏi danh sách, phản hồi và phiếu kết quả lưu trên máy, URL rút gọn trên Short.io (nếu có); thư mục đề trên Drive và bài nộp trong Google Sheets được giữ nguyên.
5Mỗi mục trong menu có icon riêng theo nhóm việc để nhìn là nhận ra ngay: xanh dương cho việc mở/xem, xanh lá cho sao chép và xuất dữ liệu, tím cho việc chấm và đáp án, cam cho việc gửi kết quả, đỏ cho việc xóa.

Viết đáp án trả lời ngắn cho đúng

Đáp án trong \shortans{...} được thầy cô gõ bằng LaTeX, còn học sinh gõ số trần trên điện thoại. MyTeX đưa cả hai về cùng một dạng trước khi so, nên các cách viết dưới đây đều chấm đúng.

1Số thập phân: \shortans[0]{$2{,}8$}, \shortans{2,8} hay $0{,}50$ đều được. Học sinh gõ 2,8, 2.8 hoặc 2,80 đều tính đúng; dấu trừ gõ kiểu -1,25 hay −1,25 cũng vậy.
2Phân số: $\dfrac{14}{5}$ được quy về 2,8, nên học sinh gõ phân số hay số thập phân đều đúng.
3Số lớn: $12\,345$ là 12345 — lệnh \, được hiểu là dấu cách mảnh, không phải dấu phẩy thập phân.
4Phần trăm: $35\%$ khớp với cả 35 và 35%.
5Nên tránh: đáp án còn ở dạng ký hiệu như $\sqrt{2}$ , $10^{3}$ hoặc có kèm đơn vị như $2{,}8\,\text{m}$ . Máy không tự quy ra số gần đúng, nên học sinh gõ 1,41 hay 2,8 sẽ bị tính sai. Hãy ghi thẳng giá trị mà đề yêu cầu và nói rõ trong đề bài về đơn vị cùng số chữ số thập phân.

Điểm hiện trên màn hình học sinh ngay lúc nộp do Apps Script tính, còn phiếu kết quả do MyTeX chấm lại. Hai bên dùng cùng bộ quy tắc này, nên chỉ cần template đã cập nhật thì hai điểm luôn khớp nhau.

Bộ đề in kèm QR

Bản in chọn ngay trong hộp thoại Xuất đề thi, mục Bản in PDF → Kèm mã QR: Xuất sau khi tạo xong đề (khuyên dùng, mã QR trỏ tới đề đã sẵn sàng), In nhanh (có PDF sau vài giây, đề hoàn tất ở nền) hoặc Không xuất bản in. Tạo đề xong MyTeX làm luôn theo lựa chọn đó, không hỏi lại. Mỗi đề trong bộ giữ nguyên tiêu đề, thời gian, mã vào phòng thi và mã QR để học sinh quét làm bài; phân hệ Soạn thảo dùng cùng lựa chọn và cùng mẫu bìa này.

1
Chọn Mẫu bìa — tên mẫu đặt theo đúng hình dáng bìa, mẫu mặc định đứng đầu danh sách:
- Không bìa – vào thẳng đề (mặc định): không trang bìa, không mục lục, không đánh số đề. Ít giấy và ít mực nhất.
- Bìa khung viền cổ điển: khung viền kép quanh trang, chữ canh giữa như bìa đề in sẵn của trường.
- Bìa kẻ ô vuông hiện đại: tiêu đề lớn canh trái trên lưới kẻ ô, vạch màu chia khối.
- Bìa gạch màu tối giản: như trên nhưng rút gọn, chỉ còn vài gạch màu và khối chữ.
- Bìa xanh thương hiệu MyTeX: dải navy dọc mép trái kèm logo chữ E của ứng dụng, màu teal chủ đạo, thẻ số liệu đề và câu.
- Bìa vở ô ly học trò: nền giấy kẻ ô có lề đỏ và lỗ đóng gáy, nhãn vở dán băng keo với chỗ để học sinh tự điền họ tên và lớp.
Trừ mẫu không bìa, năm mẫu còn lại đều có trang mục lục danh sách đề.
2Tệp PDF xuất ra đặt tên theo tệp .tex của đề, ví dụ tap-hop-phep-toan-de-01_QR.pdf; in nhiều đề một lượt thì tên có dạng <đề đầu>_va_<n>de_QR.pdf. Nhờ vậy in nhiều đợt không đè lên nhau.
3Thông tin trên bìa và đầu mỗi đề lấy từ Tổng quan → Thiết lập cá nhân, giống nhau ở mọi nơi in đề: Soạn thảo, bản in kèm mã QR, bản chỉ xuất PDF và bộ đề của Lọc đề. Đầu đề ghi tên bộ đề (trống thì ghi ĐỀ THI), nguồn hoặc người biên soạn, cơ sở giáo dục, tên đề và thời gian làm bài; nhập 90 sẽ in thành 90 phút. Trường nào bỏ trống thì dòng tương ứng tự ẩn chứ không in dữ liệu mặc định.
4Muốn thêm mẫu riêng, chép tệp boDeQR_<tên>.tex vào thư mục templates/GoogleForm; MyTeX tự đưa mẫu mới vào danh sách chọn.

Chấm lại, chấm tay và gửi lại

Mỗi lần chấm được đánh số thành một lần chấm. Chấm lại không ghi đè bản cũ: phiếu cũ được sao lưu vào thư mục lich-su-cham và toàn bộ lịch sử vẫn tra cứu được.

1Sửa đáp án: trong bảng phản hồi, nhấp chuột phải rồi chọn Sửa đáp án & thang điểm để sửa khóa đáp án từng câu và thang điểm từng phần. Số câu và cấu trúc đề giữ nguyên. Đáp án mới được đồng bộ về catalog, Drive và Apps Script; sau đó MyTeX hỏi có chấm lại ngay các bài đã chấm hay không. Menu chuột phải của danh sách đề cũng có mục Sửa đáp án & thang điểm cho cùng việc này. Tab Đáp án tự luận còn có ô Điểm tối đa cho từng câu, nên chấm xong thấy câu nào nặng hơn thì chỉnh lại thang điểm rồi chấm lại; Tổng điểm tự luận luôn bằng tổng các câu.
2Đề in sai thì sửa thẳng khóa đáp án: ở cột Đáp án đúng của phần trắc nghiệm, để trống nghĩa là câu bị hủy — mọi bài đều được trọn điểm câu đó, kể cả bài bỏ trống. Ghi nhiều phương án như A,C (hoặc A,B,C,D) nghĩa là học sinh chọn một trong những phương án đó đều được điểm. Phiếu kết quả ghi rõ Câu hủy - trọn điểm hoặc liệt kê A, C để học sinh biết vì sao được điểm. Không cần bỏ câu hay sửa tay từng bài nữa.
3Chấm tay tự luận: chọn Chấm lại / Đáp án → Chấm tay phần tự luận trên một phản hồi đã chấm ít nhất một lần (cần chấm một lần để lấy bài làm về). Mỗi câu là một thẻ riêng gồm bài làm dạng chữ, ảnh bài làm, ô điểm và ô nhận xét. Hộp thoại mở vừa màn hình đang dùng: phần bài làm và ảnh cuộn riêng, còn ô điểm, ô nhận xét cùng nút Lưu bản chấm luôn hiện ở dưới. Có nút Trọn điểm/0 điểm để chấm nhanh, nút Câu trước/Câu sau để chuyển câu, và dòng tổng điểm tự luận cập nhật ngay khi nhập.
4Ghi chú lên bài làm: nhận xét dạng chữ được đưa vào cột nhận xét của phiếu; với ảnh, dùng bút đỏ vẽ trực tiếp lên bài làm của học sinh, có Hoàn tác và Xóa. Ảnh đã ghi chú được lưu kèm phiếu và đánh dấu rõ trong phiếu kết quả.
5Gửi lại: phiếu của bản chấm lại mang nhãn Bản chấm lại lần n và Giáo viên chấm tay; email đổi tiêu đề và tin Zalo ghi rõ đây là bản thay cho bản trước. Hộp thoại gửi cho biết bao nhiêu bài có bản chấm mới hơn lần đã gửi, nên không gửi nhầm bản cũ. Khi học sinh tự nhắn Zalo bot xin kết quả hoặc phiếu chấm, bot cũng đánh dấu bản chấm lại và ghi lượt gửi đó vào cùng lịch sử chấm.
6Xem lịch sử: chọn Chấm lại / Đáp án → Lịch sử chấm & gửi để xem từng lần chấm kèm thời điểm, chế độ chấm (tự động / chấm lại / chấm tay), điểm và trạng thái đã gửi Email/Zalo. Cột Lần chấm trong bảng phản hồi cũng cảnh báo khi bản chấm hiện tại mới hơn bản đã gửi.

Template Apps Script hiện tại là phiên bản 22. Khóa đáp án trắc nghiệm nhận cả ô trống (câu bị hủy, mọi bài trọn điểm) lẫn nhiều phương án đúng (A,C); đáp án trả lời ngắn viết bằng LaTeX được quy đổi trước khi so (phân số ra số thập phân, \, là dấu cách mảnh, bỏ \%), nên điểm hiện lúc nộp khớp điểm trên phiếu. Ảnh bài tự luận được tải lên từng tệp rồi mới gửi gói đáp án, trình duyệt hỏi lại máy chủ để xác nhận bài đã lưu nên bài nhiều ảnh hay mạng chập chờn cũng không tạo bài nộp trùng. Đang dùng template cũ hơn thì dán lại Code.gs và triển khai lại Web App theo bước 4 ở trên; đề đã phát hành trước đó vẫn nộp được bình thường.

Mỗi đề gắn chặt với Web App đã tạo ra nó: URL Apps Script được nhúng vào trang thi ngay lúc tạo đề. Nếu sau này bạn bấm New deployment hoặc chuyển sang dự án Apps Script khác, các đề cũ vẫn nộp bài về nơi cũ — MyTeX tự đọc phản hồi theo đúng deployment của từng đề nên danh sách bài nộp không bị trống. Đổi lại, muốn nâng cấp template cho những đề cũ thì phải dán Code.gs mới vào đúng dự án đó và dùng Manage deployments → Edit để giữ nguyên URL.

Short.io không cho hai link trùng tên, nên tạo lại đề từ cùng một tệp .tex khi link cũ còn tồn tại sẽ ra link _v2, _v3… Xóa đề trong MyTeX sẽ xóa luôn URL rút gọn của đề trên Short.io, nên tên được dùng lại ở lần tạo sau. Link còn sót lại (đề xóa lúc mất mạng hoặc khi chưa có API key) thì vào Tổng quan → Đề thi trực tuyến, bấm Reset URL rút gọn ở mục Short.io để chọn và xóa (link của đề đã xóa khỏi MyTeX được chọn sẵn). Học sinh mở link đã xóa sẽ không vào được đề; đề còn dùng tự chuyển về URL Apps Script gốc.

Không chia sẻ secret Apps Script hoặc API key Short.io. Liên kết học sinh có thể truy cập công khai theo cấu hình Anyone; hãy dùng mã phòng, thời gian mở/đóng và chỉ gửi liên kết cho đúng nhóm. Chế độ giám sát hỗ trợ ghi nhận hành vi nhưng không phải cơ chế chống gian lận tuyệt đối. Nhật ký câu tự luận không ghi theo từng lần gõ: chỉ ghi khi học sinh xóa một đoạn dài hoặc viết lại phần lớn bài (kèm trích đoạn cũ và mới), cùng lúc chèn hoặc bỏ ảnh bài làm. Với câu trắc nghiệm đã hoán vị, nhật ký ghi chữ cái gốc cho khớp phiếu kết quả, kèm chữ học sinh nhìn thấy, ví dụ B (hiển thị A). Khi câu hỏi được hoán vị, mỗi ô Hành vi trên phiếu kết quả mở đầu bằng dòng Đang ở: Phần I - Câu 9 trên đề của học sinh, cho biết câu gốc của hàng đó nằm ở vị trí nào trên đề học sinh làm, để đối chiếu với các dòng “Đến Phần I - Câu 9” trong nhật ký.

6. Soạn thảo

Soạn đề bằng MTX-AI và chuyển đổi TeX ↔ Word

1Chọn một trong năm chế độ: Chuyển sang LaTeX, Sáng tác đề mới, Sinh theo chủ đề (ba chế độ dùng AI đã chọn), docx sang TeX và TeX sang docx (hai chế độ chuyển đổi tệp). Ví dụ trong ô soạn và dòng nhắc đổi theo chế độ đang chọn.
2Nhập yêu cầu trực tiếp hoặc thêm/dán văn bản, ảnh, PDF, .tex, .txt hay .md. Nhấn Enter để gửi, Shift+Enter để xuống dòng. PDF được tách thành ảnh trước khi gửi tới mô hình AI có hỗ trợ ảnh, tối đa 30 trang mỗi tệp.
3Với sáng tác, chọn Chỉ đổi số, đổi tên, Dễ hơn, Khó hơn, Nâng cao hoặc yêu cầu riêng. Với sinh theo chủ đề, đặt số câu cho từng phần; nếu mô tả đã ghi rõ (ví dụ “8 câu trắc nghiệm, 2 câu đúng sai”) thì MyTeX điền sẵn để kiểm tra lại.
4Ở bước xác nhận có thể đổi lại chế độ ngay tại chỗ. Bảng tùy chọn cho biết khối lượng dữ liệu sắp gửi và số lượt gọi AI; nút Bắt đầu xử lý chỉ mở khi các tùy chọn đã hợp lệ. Kết quả được lưu thành .tex và có thể tự sao chép vào bảng tạm.
5Tick Xuất prompt thay vì gửi MTX-AI nếu muốn mang yêu cầu sang chatbot khác; các tùy chọn con chỉ hiện ra khi tùy chọn cha được tick, nên bảng luôn gọn. Khi xuất prompt, MyTeX gộp phần chữ (văn bản đã nhập, tệp .tex/.txt/.md, lớp văn bản của PDF) và không gọi API; ảnh phải tự đính kèm bằng nút Sao chép ảnh.
6Tick thêm Tự động OCR ảnh vào prompt để MyTeX đọc chữ trong ảnh và PDF scan ngay trên máy rồi gắn thẳng vào prompt — không gọi API, không gửi ảnh ra ngoài, không cần khóa AI. Ô Công cụ OCR liệt kê đúng những công cụ hợp với hệ điều hành đang chạy: Windows có Windows OCR (sẵn trong máy), Tesseract và pytesseract; macOS/Linux có Tesseract và pytesseract. Công cụ chưa cài vẫn hiện trong danh sách nhưng bị khóa, di chuột vào để xem cách cài. PDF đã có lớp văn bản thì vẫn đọc theo cách cũ cho nhanh.
7Trong lúc chạy có thể bấm Dừng xử lý; nếu lỗi hoặc dừng giữa chừng, dùng Thử lại hay Đưa về ô soạn để giữ nguyên nội dung đã nhập.
8Dùng Sao chép .tex, Lưu .tex, Mở .tex, Biên dịch PDF, Trình chiếu hoặc Tạo đề trực tuyến. Luôn đọc lại nội dung, số liệu và đáp án do AI tạo.
9docx sang TeX: đính kèm tệp .docx rồi gửi. MyTeX đọc hoàn toàn trên máy, không cần khóa AI: tách câu theo “Câu 1.”, nhận phương án A/B/C/D, ý đúng/sai a)b)c)d), phần Lời giải và Đáp án; công thức Office Math đổi sang LaTeX; ảnh nhúng tách ra thư mục images/ và chèn lại bằng \includegraphics. Phương án được Word in đậm, gạch chân hoặc tô đỏ sẽ nhận \True.
10Muốn mã sát chuẩn hơn thì tick thêm Chuẩn hóa ex_test bằng MTX-AI: MyTeX gửi mã vừa tạo cho mô hình đã chọn soát lại cú pháp (bọc $...$ , sửa \choice/\choiceTF/\shortans, viết lại \loigiai) mà không thêm bớt câu. Nếu kết quả trả về thiếu câu, MyTeX tự giữ bản chuyển trên máy để không mất nội dung.
11TeX sang docx: đính kèm tệp .tex, chọn Word Equation hoặc MathType cho công thức, chọn Lời giải hoặc Đề thi cho nội dung, rồi bấm Xuất .docx. Môi trường tikzpicture và bảng được render thành ảnh chèn đúng vị trí.

Mô hình AI là dịch vụ bên ngoài và có thể trả kết quả sai. Không gửi dữ liệu nhạy cảm; giáo viên chịu trách nhiệm rà soát nội dung trước khi sử dụng hoặc phát cho học sinh.

OCR trên máy chỉ đọc được chữ thường: công thức toán bị làm phẳng (mất dấu mũ, vỡ phân số), dễ nhầm l/I với 1 hay O với 0, và không mô tả được hình vẽ hay bảng biến thiên. Prompt xuất ra đã kèm sẵn phần lưu ý để chatbot tự khôi phục, nhưng với đề nhiều công thức hoặc có hình thì vẫn nên bấm Sao chép ảnh để dán kèm ảnh gốc. Muốn đọc dấu tiếng Việt chính xác hơn: Windows cài gói ngôn ngữ Tiếng Việt trong Settings → Time & language; Tesseract cài thêm gói tesseract-ocr-vie (Linux), tesseract-langpack-vie (Fedora) hoặc brew install tesseract-lang (macOS).

7. Đấu trường

Thi trực tiếp bằng điện thoại

Đấu trường có hai chế độ, chọn ở ô Chế độ. LAN: máy giáo viên mở máy chủ nội bộ, học sinh cùng mạng LAN/hotspot quét mã QR, xem ảnh câu hỏi và gửi đáp án trên trang trả lời. ZALO: học sinh quét mã QR để mở chat với Bot Zalo, nhắn mã đấu trường để vào đúng phòng đang mở, rồi nhắn đáp án từng câu cho bot; câu hỏi vẫn chiếu trên màn hình lớp.

1Nạp đề .tex; hệ thống đọc 3 loại câu: trắc nghiệm, đúng/sai, trả lời ngắn.
2Thiết lập thời gian riêng cho từng loại câu và bật/tắt tự chuyển khi hết giờ.
3Chế độ LAN: bấm Mở máy chủ, cho học sinh vào bằng QR hoặc liên kết. Chế độ ZALO: bấm Mở đấu trường Zalo; MyTeX tự bật bot nếu chưa chạy, tạo mã đấu trường 6 chữ số và mã QR mở chat với bot.
4Dùng Bắt đầu/Mở lại, Khóa, Câu tiếp để điều khiển phiên thi.
5Mở Xem đầy đủ khi cần trình chiếu. Câu hỏi nằm trên mặt bảng viết (bảng trắng, bảng xanh, bảng đen hoặc giấy ô ly, có lưới tùy chọn), phần bảng còn lại để giảng bài. Thanh công cụ vẽ và điều hướng được gộp thành một hàng gọn; dùng mũi tên cuộn ở hai bên khi cửa sổ hẹp. Thanh này có màu bút, dạ quang, nhóm hình, cỡ nét, kiểu nét, độ đậm, tẩy, hoàn tác/làm lại, gõ chữ, laser và lưu ảnh bảng.
6Bật Hiện lời giải khi muốn chuyển màn giáo viên sang trang lời giải; nút sẽ đổi trạng thái để tránh nhầm lẫn khi đang giảng.
7Trong trình chiếu bài giảng và Đấu trường, dùng ← / ↑ để về trang trước, → / ↓ để sang trang tiếp, kể cả khi bảng vẽ hoặc khung cuộn đang được chọn. Khi đang nhập chữ, chỉnh số hoặc chọn trong menu, phím mũi tên vẫn điều khiển ô đang dùng. Bấm giữ con lăn chuột (nút giữa) rồi kéo để di chuyển bảng khi đang phóng to hoặc cần xem phần bảng phía dưới. Ảnh câu hỏi mặc định phủ hết bề ngang bảng; muốn chừa thêm chỗ viết thì giảm Cỡ ảnh câu hỏi trong menu kiểu bảng.
8Bấm Kết thúc (cờ đích, có cả trên thanh công cụ khi xem đầy đủ) khi xong phiên: câu đang mở bị khóa, máy chủ LAN hoặc Bot Zalo ngắt kết nối (chế độ ZALO gửi điểm và thứ hạng cuối cho từng học sinh), còn dữ liệu làm bài vẫn giữ nguyên và được lưu trữ vào thư mục ket_qua_dau_truong. MyTeX cũng tự lưu trữ trước khi nạp đề khác hoặc Xóa toàn bộ đáp án.
9Xuất Excel ghi tệp .xlsx gồm: Xếp hạng (hạng, người chơi, kênh LAN/Zalo, Zalo ID, tên Zalo, email học sinh đã đăng ký với Bot Zalo, tổng điểm, số câu đúng và đáp án từng câu tô xanh/đỏ), Chi tiết (từng người × từng câu: đáp án, đúng/sai, điểm, thời gian), Theo câu (tỉ lệ đúng, thời gian trung bình, phân bố đáp án) và Thông tin phiên. Học sinh vào qua Zalo mà chưa đăng ký email với bot thì cột Email để trống.
10Phân tích mở bảng thống kê từng câu (tỉ lệ đúng, thời gian trung bình câu đúng, phân bố đáp án, sao chép ảnh câu) cùng biểu đồ tỉ lệ đúng theo câu, phân bố điểm và top người chơi — tương tự nút Phân tích của Đề thi trực tuyến. Xuất Excel và Phân tích dùng được cả khi đấu trường đang chạy.

Trong trình chiếu bài giảng và Đấu trường, mở nút kiểu bút cạnh các ô màu để chọn nét mặc định (chuột), bàn tay cầm viết, bút máy, bút lông hoặc phấn. Có thể chọn riêng hình con trỏ: chuột, bàn tay cầm viết, ngòi bút hoặc dấu cộng. Giữ chuột phải và kéo để chọn vùng; nhấn Delete để xóa phần ghi chú trong vùng, Esc để bỏ chọn và Ctrl+Z để khôi phục. Ảnh câu hỏi và nền bảng được giữ nguyên. Nút chọn vùng (V) cũng cho phép kéo bằng chuột trái. Dán ảnh bằng Ctrl+V, nhấn Enter để đặt ảnh lên bảng.

Cách tính điểm (cả LAN và ZALO): mỗi câu tối đa 100 điểm, nhân với hệ số thời gian — trả lời ngay khi mở câu được trọn điểm, càng gần hết giờ càng ít. Trắc nghiệm và trả lời ngắn: đúng mới có điểm. Đúng/Sai: tính theo số ý (trong 4 ý a–d) học sinh xét đúng — chọn ý đúng hoặc bỏ không chọn ý sai đều tính là xét đúng: đúng 4/4 ý được 100%, 3/4 ý 50%, 2/4 ý 20%, 1/4 ý 10% số điểm (rồi nhân hệ số thời gian). Học sinh được báo ngay số ý đúng và điểm câu đó; bảng Excel ghi đáp án đúng một phần dạng a (3/4), tô vàng.

Chế độ ZALO — học sinh nhắn gì cho bot: gửi mã đấu trường để vào phòng, có thể kèm tên sau mã (ví dụ 482913 Nguyễn Văn An); không kèm tên thì bảng xếp hạng dùng tên Zalo. Khi giáo viên mở câu, bot báo số câu, loại câu và thời gian. Trắc nghiệm nhắn A–D; đúng/sai nhắn các ý đúng (ac) hoặc 4 ký tự Đ/S theo thứ tự a→d (ĐSĐS), không ý nào đúng nhắn 0; trả lời ngắn nhắn đáp án (2,5). Mỗi câu chỉ nhận một lần và tính tốc độ theo lúc tin nhắn tới bot. Lệnh trong phòng: điểm, tên <họ tên>, thoát. Khi giáo viên đóng đấu trường, bot gửi điểm và thứ hạng cuối cho từng học sinh.

Gửi link đề (ô chọn cạnh Tự chuyển, chỉ có ở chế độ ZALO): khi mở đấu trường, MyTeX tải ảnh các câu hỏi lên thư mục dau_truong trên Google Drive và bot gửi kèm link ảnh trong tin báo mỗi câu, để học sinh xem đề ngay trên điện thoại. Ảnh đã tải được dùng lại cho lần mở sau; build lại đề thì tải bản mới. Nếu câu đã mở mà ảnh chưa tải xong, bot gửi bổ sung link khi ảnh sẵn sàng. Cần đăng nhập Google; ảnh được chia sẻ ở chế độ "ai có liên kết cũng xem được".

Chế độ ZALO cần cấu hình bot tại Tổng quan → Zalo. Cần dán Liên kết bot để có mã QR mở đúng bot: mở trang bot trong Zalo → Chia sẻ → sao chép liên kết (dạng https://zalo.me/<dãy số>); dán cả liên kết đọc từ mã QR của bot như http://zalo.me/…?src=qr cũng được. Id trong liên kết này khác mã bot nên MyTeX không tự suy ra được; chưa dán thì đấu trường vẫn mở nhưng không có mã QR. Đóng đấu trường không tắt bot, để học sinh vẫn tra cứu kết quả được. Nhật ký bên phải ghi mỗi tin học sinh nhắn (📩 tên · câu n: "D" → đã nhận); học sinh báo đã nhắn mà bot không trả lời thì xem ở đây để biết tin có tới máy hay không.

Chế độ LAN: nếu điện thoại không vào được, kiểm tra máy tính và điện thoại cùng mạng, tường lửa Windows và địa chỉ IP hiển thị trên liên kết học sinh.

8. Trợ lý MTX-AI

Hỏi đáp thao tác MyTeX

1Cấu hình MTX-AI tại Tổng quan, rồi mô tả thao tác hoặc lỗi bằng tiếng Việt.
2Đính kèm ảnh màn hình nếu cần phân tích tình huống cụ thể; che email, mã bài, secret và dữ liệu học sinh trước khi gửi.
3Trợ lý chỉ hỗ trợ phạm vi MyTeX và dùng các tệp HTML trong docs làm nguồn kiến thức; câu trả lời vẫn cần được người dùng kiểm tra.

9. Quy trình khuyến nghị

Đi theo thứ tự ổn định nhất

1Đăng nhập MyTeX, sau đó cấu hình MTX-AI/Email/Zalo nếu cần tại Tổng quan.
2Dùng Xử lý TeX để chuẩn hóa nguồn và ngân hàng.
3Dùng Tạo đề từ Ma trận để áp ma trận và xuất đề.
4Nếu cần nội dung mới, dùng Soạn thảo, kiểm tra lại kết quả rồi chuyển tiếp sang PDF, trình chiếu hoặc đề trực tuyến.
5Nếu cần file Word, dùng chế độ TeX sang docx trong Soạn thảo và kiểm tra lại công thức, hình, bảng trong tệp đầu ra.
6Chọn Đề thi trực tuyến để phát phiếu HTML và lưu phản hồi, hoặc Đấu trường cho phiên tương tác trực tiếp trong cùng mạng.
7Đồng bộ phản hồi, chấm, xem thống kê và gửi phiếu kết quả nếu dùng Đề thi trực tuyến.

10. FAQ

Xử lý sự cố thường gặp

MTX-AI chưa sẵn sàng

Vào Tổng quan -> MTX-AI và nhập API key Gemini, DeepSeek, OpenAI, Claude hoặc Grok. MyTeX xác thực hãng và tải các mô hình tạo nội dung. Chọn mô hình mặc định, sau đó có thể chọn riêng mô hình và mức suy nghĩ cho từng chế độ Soạn thảo, Trợ lý MTX-AI, chấm tự luận và tạo đề qua Zalo. Cùng một mô hình được dùng cho nhiều chế độ; dòng để mặc định kế thừa mô hình phía trên. Mức suy nghĩ khả dụng tùy mô hình; lựa chọn Theo mặc định của hãng không gửi tham số suy nghĩ. Với Gemini 2.5, mức suy nghĩ là ngân sách token; mức cao có thể xử lý lâu hơn và dùng thêm token. Gemini mặc định chọn bản Flash mới nhất. Nếu dùng ảnh/PDF với DeepSeek, hãy chọn deepseek-flash cho chế độ liên quan. Mã lỗi DeepSeek 402 nghĩa là tài khoản không đủ số dư API; kiểm tra số dư trên DeepSeek Platform.

Chưa vào được app

MyTeX yêu cầu đăng nhập trước khi dùng. Hoàn tất cửa sổ Google trên trình duyệt rồi quay lại ứng dụng. Nếu phiên cũ còn quyền Biểu mẫu hoặc drive.appdata, mở Kết nối tài khoản Google, xóa kết nối MyTeX rồi đăng nhập lại để chỉ cấp quyền tối thiểu; thao tác này không xóa tệp Drive.

Apps Script vẫn báo template cũ

Sau khi dán template mới vào Code.gs, vào Deploy → Manage deployments, sửa Web App, chọn phiên bản mới, giữ Execute as: Me/Who has access: Anyone rồi triển khai lại. Mở URL_EXEC?action=ping trong cửa sổ ẩn danh: bản hiện tại phải trả JSON có template_version từ 22; nếu hiện trang đăng nhập Google thì quyền truy cập Web App chưa đúng.

Đề thi trực tuyến không tạo được

Kiểm tra Internet, đăng nhập Google, ID thư mục Drive, URL /exec và secret. Bấm Kiểm tra kết nối; secret trong MyTeX phải trùng MYTEX_SECRET của Script Properties.

Học sinh nộp bài tự luận báo “Failed to fetch”

Lỗi này đến từ template Apps Script cũ gửi tất cả ảnh trong một request duy nhất. Dán lại Code.gs phiên bản mới nhất (22) và triển khai lại Web App, rồi tạo lại liên kết đề. Nếu vẫn gặp, kiểm tra mạng của học sinh và nhắc các em chờ dòng trạng thái báo Đã nộp bài thành công trước khi đóng trang; bài nộp lại cùng phiên sẽ không bị tính thành hai lượt.

Đáp án trả lời ngắn viết bằng LaTeX có bị chấm sai không

Không. \shortans[0]{$2{,}8$}, \shortans{2,8}, $\dfrac{14}{5}$ , $12\,345$ hay $35\%$ đều được quy về đúng con số trước khi so với bài làm của học sinh. Chỉ những đáp án còn ở dạng ký hiệu ( $\sqrt{2}$ , $10^{3}$ ) hoặc kèm đơn vị mới không khớp với số học sinh gõ — xem mục Viết đáp án trả lời ngắn cho đúng. Lưu ý phải dùng template Apps Script từ phiên bản 22 thì điểm hiện lúc nộp mới khớp phiếu kết quả.

Đề có câu sai: không có phương án đúng hoặc có nhiều phương án đúng

Nhấp chuột phải vào đề hoặc bài làm, chọn Sửa đáp án & thang điểm rồi sửa ngay ô Đáp án đúng của câu đó: để trống nếu câu phải hủy (mọi bài được trọn điểm câu đó), hoặc ghi A,C nếu có nhiều phương án đúng. Bấm Lưu đáp án, chọn chấm lại các bài đã chấm, rồi gửi lại phiếu. Đáp án mới cũng được đẩy sang Apps Script nên bài nộp sau đó hiện điểm đúng ngay lúc nộp.

Hộp thoại chấm tay trên màn hình nhỏ

Hộp thoại tự co theo màn hình (kể cả máy 13-14 inch hoặc Windows phóng 125%): phần bài làm và ảnh cuộn riêng, còn ô điểm, ô nhận xét và nút Lưu bản chấm luôn nằm trong tầm mắt. Nếu vẫn thấy chật, kéo rộng hộp thoại hoặc dùng nút Câu trước/Câu sau thay cho thanh tab.

Đã gửi kết quả nhưng đáp án bị sai

Dùng Sửa đáp án & thang điểm để sửa khóa đáp án rồi chấm lại; bản chấm cũ vẫn được giữ trong lịch sử. Sau đó gửi lại Email/Zalo — phiếu và tin nhắn mới đều ghi rõ là bản chấm lại nên học sinh không nhầm với bản trước.

Muốn Zalo bot vẫn chạy khi đã tắt MyTeX

Vào Tổng quan → Zalo và tick Chạy nền: bot tách ra thành tiến trình riêng nên không tắt theo cửa sổ MyTeX. Tick thêm Tự khởi động cùng Windows để mở máy là bot chạy ngay. Mỗi mã bot chỉ được một nơi lắng nghe, nên khi chạy nền thì nút Khởi động trong MyTeX bị khóa; bỏ tick là bot nền dừng hẳn. Nhật ký trong hộp thoại hiển thị lại cả những gì bot đã làm lúc MyTeX đang tắt. Mở Đấu trường chế độ Zalo thì MyTeX tạm dừng bot nền để tự nhận đáp án, rồi trả bot về chạy nền khi đóng đấu trường hoặc thoát MyTeX; ngược lại, đang mở đấu trường Zalo thì chưa bật được Chạy nền.

Đấu trường không vào được từ điện thoại

Kiểm tra máy tính và điện thoại cùng mạng, tường lửa, cổng đang dùng và thử mở đường dẫn /ping trên điện thoại.

Tạo đề báo thiếu câu

Ngân hàng chưa đáp ứng ma trận. Bổ sung câu ở Xử lý TeX hoặc điều chỉnh ma trận.

PDF trong Soạn thảo không đọc được

Kiểm tra file PDF có mở được không. MyTeX sẽ tách PDF thành ảnh trước khi gửi MTX-AI; file scan mờ hoặc quá dài nên chia nhỏ trước khi chạy.

Trình chiếu MTX-AI không tạo ảnh

Kiểm tra pdflatex trong Tổng quan và thử biên dịch PDF trước. Trình chiếu dùng mẫu đề trực tuyến để render từng câu thành ảnh.

Cập nhật không ghi đè được

Đóng MyTeX hoàn toàn, bảo đảm thư mục cài đặt có quyền ghi rồi thử lại. Windows/Linux cập nhật bằng cách chép tại chỗ nên cần sao lưu; nếu vẫn lỗi, tải gói mới nhất và giải nén thủ công vào thư mục mới.