MCQ AnkiGen: Tự Động Hóa Trích Xuất Đề Thi Y Khoa Sang Anki

Mỗi kỳ thi lâm sàng hay kết thúc học phần Y khoa, sinh viên và bác sĩ nội trú thường phải đối mặt với hàng trăm trang tài liệu trắc nghiệm (MCQ). Phần lớn tài liệu lưu hành nội bộ là bản photocopy đen trắng, file scan mờ qua nhiều thế hệ máy in, hoặc ảnh chụp vội từ thư viện với góc nghiêng và nét chữ viết tay đè lên đề bài.

Việc ngồi gõ lại từng câu hỏi, cắt dán từng đáp án A, B, C, D và tìm tài liệu tra cứu để viết phần giải thích ngốn hàng chục giờ đồng hồ quý giá — thời gian lẽ ra nên dành cho việc đọc bệnh học, thăm khám người bệnh hoặc ôn tập chủ động với thuật toán lặp lại ngắt quãng (Spaced Repetition).

Để giải quyết nút thắt này, mình xây dựng MCQ AnkiGen Pro — một công cụ mã nguồn mở ứng dụng mô hình ngôn ngữ lớn (Google Gemini) để tự động hóa toàn bộ đường ống xử lý: từ đọc tài liệu, nhận diện câu hỏi, sinh lời giải thích y khoa đến xuất file nhập trực tiếp vào Anki.

Video Hướng Dẫn Thao Tác

Video dưới đây ghi lại toàn bộ quy trình thực tế: nạp file đề thi PDF, quét nhận diện, sửa trực tiếp trên giao diện và tải file CSV sẵn sàng cho Anki.

Tổng Quan Về MCQ AnkiGen

MCQ AnkiGen được thiết kế chuyên biệt cho văn cảnh học tập Y khoa, nơi câu hỏi thường có cấu trúc tình huống lâm sàng (vignette), nhiều đáp án nhiễu gần giống nhau và cần lời giải thích dựa trên y văn cập nhật thay vì chỉ đơn thuần đưa ra một chữ cái đáp án.

Lấy Google Gemini API Key Miễn Phí

Ứng dụng kết nối trực tiếp từ trình duyệt của bạn đến Google AI Studio thông qua API Key cá nhân. Bạn được cấp hạn mức miễn phí hàng ngày đủ để xử lý hàng ngàn câu trắc nghiệm mỗi tháng.

Các bước tạo Key

1. Đăng nhập vào Google AI Studio (aistudio.google.com) bằng tài khoản Google.
2. Nhấn nút Create API key.
3. Chọn một Google Cloud Project có sẵn hoặc chọn tạo mới một dự án mặc định, sau đó nhấn Create API key in existing project (hoặc new project).
4. Sao chép chuỗi ký tự API Key bắt đầu bằng AIzaSy... và lưu lại cẩn thận.

Lưu ý bảo mật: Không chia sẻ API Key cho người khác để tránh bị dùng cạn hạn mức yêu cầu mỗi ngày.

Mẹo xoay vòng nhiều Key để nhân bội hạn mức (Tránh lỗi 429)

Mỗi API Key gắn liền với một Google Cloud Project, và mỗi Project sở hữu hạn mức số lượt yêu cầu mỗi phút (RPM) hoàn toàn riêng biệt.

Nếu bạn tải lên tài liệu dày hàng chục trang gồm nhiều đợt cắt nhỏ, việc dùng 1 key duy nhất có thể khiến hệ thống gặp mã lỗi 429 (Resource Exhausted - Vượt ngưỡng quota).

Cách nhân bội hạn mức:

1. Vào Google AI Studio → API Keys.
2. Nhấn Create API key.
3. Tại ô Google Cloud Project, bấm Create new project thay vì chọn project cũ (ví dụ đặt tên: anki-key-2, anki-key-3).
4. Nhấn Create và lưu lại key mới. Tạo 3 project đồng nghĩa với việc bạn có gấp 3 lần hạn mức miễn phí.

Cách nhập nhiều Key vào ứng dụng: Mở ⚙️ Cài đặt → Google Gemini API Key, dán toàn bộ các key cách nhau bởi dấu phẩy ,:

AIzaSyKeyA...,AIzaSyKeyB...,AIzaSyKeyC...

MCQ AnkiGen sẽ tự động xoay vòng: khi key hiện tại chạm trần hạn mức (lỗi 429), ứng dụng tự chuyển yêu cầu tiếp theo sang key kế tiếp mà không làm ngắt quãng tiến trình bóc tách.

Mẹo chọn Model:

• Gemini 3.1 Flash-Lite (khuyên dùng): Tốc độ phản hồi nhanh nhất, nhận diện quang học (OCR) chuẩn xác và tiết kiệm quota nhất.
• Gemini 3 Pro: Tư duy phân tích bệnh học sâu nhất, phù hợp các ca lâm sàng phức tạp, nhưng thời gian xử lý mỗi trang sẽ lâu hơn.
• Gemini 2.5 Flash: Phương án dự phòng ổn định khi các dòng model mới gặp sự cố bảo trì từ phía máy chủ Google.

Quy Trình 4 Bước Chuẩn

Bước 1: Cấu hình hệ thống & Nạp tài liệu

1. Bấm biểu tượng bánh răng ⚙️ (Cài đặt) ở góc trên bên phải:

   • Dán API Key (có thể nhập nhiều key cách nhau bởi dấu phẩy).
   • Chọn Model AI phù hợp.
   • Chọn vai trò AI theo học phần: Y Khoa, Tiếng Anh, Luật, CNTT — hoặc tự nhập prompt định hướng riêng.
   • Nhấn Đã Xong để lưu cấu hình.

2. Tại khu vực Control Panel (bên trái màn hình), tải tài liệu lên bằng cách kéo thả hoặc bấm vào khung:

   • File tài liệu: PDF (tối đa 50MB/file), Word (DOCX), Text (TXT, MD).
   • File hình ảnh: PNG, JPG, JPEG, WebP, HEIC.
   • Hỗ trợ tải nhiều file cùng lúc. Mỗi file sau khi nạp thành công sẽ báo trạng thái "Đã sẵn sàng".

Bí quyết chụp ảnh đề thi/tài liệu scan:

• Giữ máy ảnh vuông góc từ trên xuống, đủ ánh sáng, tránh hiện tượng bóng tay đổ lên chữ.
• Với chữ viết tay đè lên đề, AI được huấn luyện theo phương pháp giải mã tài liệu pháp y để nhìn xuyên qua nét mực, nhưng nếu nét vẽ đè quá 70% diện tích chữ, bạn nên chụp lại góc rõ hơn.

Bước 2: Quét tài liệu (Scan Phase)

Trước khi bóc tách chi tiết từng câu, bạn nhấn nút 🛰️ QUÉT TÀI LIỆU:

1. AI rà soát nhanh toàn bộ cấu trúc văn bản.
2. Hệ thống xác định ngôn ngữ, chuyên khoa và đưa ra số lượng câu hỏi ước tính.
3. Khi thông báo "Hệ thống đã sẵn sàng" xuất hiện, bạn chuyển sang giai đoạn 2.

Bước 3: Trích xuất song song (Extract Phase)

Nhấn ✨ TRÍCH XUẤT CÂU HỎI:

1. Ứng dụng tự động chia nhỏ file PDF thành các phân đoạn 3 trang với kỹ thuật gối đầu (overlap). Kỹ thuật này ngăn chặn triệt để tình trạng mất câu hỏi nằm ở ranh giới giao nhau giữa trang trước và trang sau.
2. Các phân đoạn được gửi song song đến AI để tối ưu tốc độ.
3. Thanh tiến trình hiển thị thời gian thực số câu đã hoàn thành.

Cơ chế Kiểm toán tự động (Audit): Nếu số lượng câu hỏi trích xuất thực tế thấp hơn 80% so với ước tính ban đầu, hệ thống sẽ tự động kích hoạt tiến trình Audit để phân tích lý do thiếu sót và hỗ trợ bạn quét bù.

Bước 4: Kiểm tra, lọc & chỉnh sửa kết quả

Sau khi hoàn tất, danh sách câu hỏi xuất hiện tại khung kết quả bên phải:

Các công cụ trên thanh Toolbar

Chỉnh sửa trực tiếp từng câu hỏi

• Di chuột (hover) lên câu hỏi bất kỳ sẽ xuất hiện hai nút: 🖊 Sửa và 🗑 Xóa.
• Khi bấm Sửa, bạn có thể:
  • Thay đổi nội dung thân câu hỏi và các phương án A, B, C, D, E.
  • Chọn lại đáp án đúng bằng nút chọn radio tròn.
  • Cập nhật phần giải thích bệnh học.
  • Nhấn nút Lưu thay đổi (hoặc bấm tổ hợp phím tắt Ctrl + Enter).
  • Nhấn Hủy bỏ (hoặc bấm phím Escape).

Đối Chiếu Dữ Liệu Với Split View

Vấn đề thường gặp nhất khi ứng dụng AI vào dữ liệu y khoa là hiện tượng đọc sai chỉ số xét nghiệm, sai đơn vị thuốc ($\mu$g sang mg) hoặc nhầm lẫn dấu âm tính/dương tính.

Để kiểm soát điều này, bạn bấm nút 📊 (Columns) trên thanh tiêu đề để bật chế độ Split View:

• Bên trái: Hiển thị tài liệu gốc (ảnh chụp hoặc bản PDF ban đầu).
• Bên phải: Hiển thị bảng câu hỏi do AI vừa bóc tách.

Bạn có thể vừa cuộn xem trang sách gốc vừa kiểm tra đối chiếu trực tiếp kết quả, phát hiện ngay sai sót nếu có.

Lưu ý thao tác: Nên bật Split View sau khi đã hoàn thành khâu trích xuất. Khi muốn nạp thêm file mới, hãy tắt Split View để giao diện quay về khung tải file rộng rãi.

Xuất File CSV Và Cấu Trúc Dữ Liệu

Khi đã hài lòng với bộ câu hỏi:

• Sao chép CSV (Copy CSV): Copy toàn bộ bảng dữ liệu vào clipboard để dán trực tiếp vào Google Sheets hoặc Excel phục vụ học nhóm.
• Tải file CSV Anki: Tải về tệp tin .csv được format chuẩn UTF-8 BOM. Định dạng này đảm bảo các ký tự tiếng Việt có dấu, ký hiệu lâm sàng ($\pm$, $\ge$, $\rightarrow$) luôn hiển thị chuẩn mực trên mọi hệ điều hành.

File CSV chứa 10 cột dữ liệu chuẩn hóa:

Question | A | B | C | D | E | CorrectAnswer | ExplanationHTML | Source | Difficulty

Trong đó, cột ExplanationHTML đã được bọc sẵn mã HTML định dạng với màu sắc tương phản cao, thẻ cảnh báo lâm sàng và cơ chế sinh lý bệnh học rõ ràng.

Các Tính Năng Bổ Trợ Đáng Chú Ý

Nhập Dữ Liệu Vào Anki Desktop

Bước 1: Mở Anki Desktop

Nếu chưa có Anki, bạn có thể tải bản cài đặt chính thức tại apps.ankiweb.net.

Bước 2: Chuẩn bị Note Type

Cách 1: Dùng Note Type 3MCQ có sẵn (Khuyên dùng)

1. Tải file 3MCQ.apkg từ liên kết ở đầu bài viết.
2. Mở Anki Desktop → vào File → Import → chọn file 3MCQ.apkg.
3. Note Type "3MCQ" sẽ tự động được thêm vào kho thẻ của bạn kèm toàn bộ mã màu và font chữ được cấu hình sẵn.

Cách 2: Tự tạo Note Type thủ công

Nếu muốn tự cấu hình, bạn vào Tools → Manage Note Types → Add:

1. Tạo một Note Type mới (ví dụ đặt tên: MCQ Y Khoa).
2. Khai báo đúng 10 trường dữ liệu (Fields) theo danh sách:
   • Question
   • A, B, C, D, E
   • CorrectAnswer
   • ExplanationHTML
   • Source
   • Difficulty
3. Tại phần Cards → Back Template, dán đoạn mã hiển thị:

{{FrontSide}}
<hr id="answer" />
<div style="font-family: 'Inter', -apple-system, sans-serif; padding: 12px; line-height: 1.6;">
  {{ExplanationHTML}}
</div>

Bước 3: Nhập file CSV vào bộ thẻ

1. Trong Anki Desktop, nhấn phím tắt Ctrl + I (hoặc Cmd + I trên macOS) hoặc chọn menu File → Import.
2. Chọn file .csv vừa được xuất từ MCQ AnkiGen.
3. Trong bảng điều khiển Import:
   • Type: Chọn 3MCQ (hoặc tên Note Type bạn vừa tạo).
   • Deck: Chọn bộ thẻ mục tiêu bạn muốn lưu (hoặc tạo một Deck mới).
   • Field separator: Chọn dấu phẩy (Comma ,).
   • Allow HTML in fields: Bắt buộc tích chọn. Đây là điều kiện tiên quyết để Anki giữ lại màu sắc, khung cảnh báo và định dạng in đậm/nghiêng của phần giải thích.
4. Kiểm tra phần ánh xạ trường (Field mapping): Đối chiếu 10 cột của CSV tương ứng đúng thứ tự từ Question đến Difficulty.
5. Nhấn nút Import.

Thành Quả Và Trải Nghiệm Ôn Tập

Video ngắn dưới đây ghi lại thành quả bộ thẻ sau khi nhập vào Anki và thao tác lật thẻ thực tế:

Thẻ tạo ra từ quy trình này tương thích hoàn toàn với:

• Anki Desktop (Windows, macOS, Linux).
• AnkiMobile (iOS, iPadOS).
• AnkiDroid (Android).
• Thuật toán lên lịch FSRS thế hệ mới của Anki.

So Sánh Và Cài Đặt Các Chế Độ Chạy

MCQ AnkiGen hỗ trợ ba hình thức vận hành tùy theo nhu cầu và mức độ hiểu biết kỹ thuật của bạn:

Bảng so sánh 3 phương thức

1. Hướng dẫn chạy bản Node.js (Cho người thích làm việc trên máy tính)

Yêu cầu máy tính đã cài đặt Node.js (phiên bản 18 trở lên).

# Cách A: Dùng Git để tải mã nguồn
git clone https://github.com/tranhoait123/anki-mcq-export.git
cd anki-mcq-export

# Cách B (Nếu không quen Git):
# Vào https://github.com/tranhoait123/anki-mcq-export, nhấn "Code → Download ZIP", rồi giải nén.

# Cài đặt thư viện phụ thuộc (chỉ chạy lần đầu)
npm install

# Khởi chạy ứng dụng
npm run dev

Mở trình duyệt truy cập địa chỉ http://localhost:5173. Giao diện và dữ liệu hoạt động giống hệt phiên bản online nhưng mã nguồn nằm hoàn toàn trên ổ cứng của bạn.

2. Hướng dẫn chạy bản Python Streamlit

Dành cho các bạn sinh viên đã quen với môi trường Python:

# Cài đặt thư viện
pip install -r requirements.txt

# Khởi chạy ứng dụng
streamlit run streamlit_app.py

Trình duyệt sẽ tự động mở tại http://localhost:8501. Tại sidebar, bạn nhập Gemini API Key, tải tài liệu lên và nhấn nút 🚀 Bắt đầu trích xuất.

Bảng Xử Lý Sự Cố Và Mẹo Tối Ưu

Bảng tra cứu lỗi thường gặp

5 Mẹo tối ưu đường ống xử lý

1. Nhiều Key = Tốc độ tối đa: Khởi tạo 3 đến 5 API Key từ các dự án Google Cloud khác nhau để tránh tình trạng phải chờ hạ nhiệt sau mỗi phân đoạn.
2. Tài liệu lớn không lo đầy bộ nhớ: Hệ thống tự động cắt nhỏ PDF theo từng cụm 3 trang gối đầu, nên bạn có thể nạp các bộ tài liệu dày hàng chục trang mà không sợ tràn ngữ cảnh.
3. Cá nhân hóa vai trò AI:
   • Khi ôn Dược lý: "Tập trung giải thích cơ chế phân tử, thụ thể, tương tác thuốc và tác dụng phụ đặc thù."
   • Khi ôn Nhi khoa: "Lưu ý phân nhóm tuổi, các mốc phát triển tâm vận động và liều lượng theo cân nặng."
   • Khi ôn Ngoại khoa: "Nhấn mạnh chỉ định phẫu thuật tuyệt đối, giải phẫu định khu và phân độ chấn thương."
4. Tận dụng chế độ Review trước khi xuất: Bấm nút Review để xem trước tấm thẻ với góc nhìn của Anki, giúp bạn tinh chỉnh câu từ ngay tại chỗ.
5. Dữ liệu IndexedDB bền bỉ: Bạn có thể tắt máy, mở lại vào hôm sau mà không lo mất đề thi đang làm dở. Khi hoàn tất toàn bộ học phần, bấm nút ⚠️ Xóa hết để làm mới không gian làm việc.

Câu Hỏi Thường Gặp (FAQ)

Ứng dụng có thu phí không?

Hoàn toàn miễn phí. Dự án được phát hành dưới dạng mã nguồn mở trên GitHub. Bạn chỉ cần tự tạo một Google Gemini API Key miễn phí theo hướng dẫn ở trên là có thể dùng thoải mái.

Dữ liệu tài liệu của tôi có bị gửi đi đâu không?

Tài liệu của bạn chỉ được gửi trực tiếp từ trình duyệt đến máy chủ Google Gemini API theo chính sách bảo mật của Google. Trang web không sở hữu máy chủ lưu trữ trung gian, không lưu lại đề thi hay thông tin cá nhân của bạn.

File scan quá mờ hoặc có chữ viết tay, AI có đọc được không?

AI được cấp prompt chuyên môn về giải mã tài liệu pháp y, có thể đọc xuyên chữ viết tay và tự động sửa các lỗi chính tả phổ biến trong OCR. Tuy nhiên, nếu tài liệu bị nhòe mực hoặc mất chữ quá 70%, AI sẽ bỏ qua câu đó nhằm ngăn chặn nguy cơ bịa đặt kiến thức y khoa sai lệch.

Tôi có thể dùng công cụ này cho các ngành học khác không?

Có. Trong phần Cài đặt, bạn chỉ cần chọn lại vai trò: Tiếng Anh, Luật, Công nghệ thông tin hoặc tự viết mô tả mục tiêu của mình. Hệ thống sẽ bóc tách câu hỏi và sinh lời giải thích phù hợp với văn cảnh của ngành đó.

Quy Trình Tóm Tắt 9 Bước

1. 🌐 Mở ứng dụng: Truy cập mcqankigen.drponz.com.
2. 🔑 Lấy API Key: Truy cập aistudio.google.com/app/apikey tạo key miễn phí.
3. ⚙️ Cài đặt: Dán API Key vào ô cấu hình, chọn model Gemini 3.1 Flash-Lite.
4. 📄 Nạp file: Kéo thả tài liệu PDF, ảnh chụp đề thi hoặc file Word vào khung tải.
5. 🛰️ Quét sơ bộ: Nhấn nút QUÉT TÀI LIỆU để hệ thống ước tính số lượng câu hỏi.
6. ✨ Trích xuất: Nhấn TRÍCH XUẤT CÂU HỎI để AI xử lý song song và sinh lời giải.
7. ✏️ Hậu kiểm: Bật Split View để đối chiếu với bản gốc, chỉnh sửa câu hỏi nếu cần.
8. 📥 Xuất dữ liệu: Bấm Xuất CSV Anki để nhận tệp tin chuẩn UTF-8 BOM.
9. 📲 Nhập Anki: Mở Anki Desktop → File → Import → Chọn Note Type 3MCQ → Tích chọn Allow HTML in fields → Hoàn tất.