Gemini Practice

Gemini Practice là một addon dành cho phần mềm Anki, giúp bạn luyện tập đặt câu và hiểu nghĩa từ vựng sâu hơn với sự hỗ trợ của mô hình ngôn ngữ Gemini API (by Google). Addon này tích hợp khả năng gợi ý định nghĩa, ví dụ và đánh giá câu sử dụng từ vựng – tất cả hiển thị đẹp mắt ngay trong giao diện Anki.

🚀 Tính năng nổi bật

• Tự động tra nghĩa từ vựng bằng mô hình Gemini, hiển thị theo định dạng markdown đẹp mắt.
• Luyện đặt câu trực tiếp trên Anki và nhận phản hồi chi tiết về:
  • Ngữ pháp
  • Ngữ cảnh sử dụng từ
  • Gợi ý cải thiện
• Tùy chỉnh cấu hình dễ dàng: API Key, prompt định nghĩa, prompt đánh giá...
• Hỗ trợ markdown được tối ưu cho hiển thị trong Qt/Anki.
• Phím tắt tiện lợi: Nhấn P hoặc Alt+P để mở giao diện luyện tập ngay khi đang học bài.

📦 Cài đặt

1. Tải source code addon và đặt vào thư mục:

   <Anki addons folder>/gemini_practice
   

2. Đảm bảo đã cài các thư viện Python sau (nếu chưa có):

   nginx
   Copy code
   pip install requests markdown
   

3. Mở Anki → vào menu Tools:

   • Chọn "Luyện tập đặt câu (P/Alt+P)" để bắt đầu sử dụng.
   • Chọn "Cấu hình Gemini Practice" để điền API Key và chỉnh sửa prompt theo ý bạn.

🔧 Cấu hình

File cấu hình sẽ được tạo tự động tại:

<Anki addons folder>/gemini_practice/gemini_practice_config.json

Các trường cần thiết:

| Trường | Mô tả | | --- | --- | | api_key | API key từ Google Gemini (https://makersuite.google.com/app) | | api_url | Endpoint đầy đủ để gọi API Gemini (bao gồm ?key=...) | | prompt_definition | Prompt cho phần gợi ý định nghĩa từ vựng | | prompt_evaluation | Prompt cho phần đánh giá câu bạn đặt |

Mặc định, addon đã có sẵn API Key demo – bạn nên thay bằng key của riêng bạn để đảm bảo ổn định.

💡 Cách sử dụng

1. Trong khi học bài trên Anki, nhấn P hoặc Alt+P để mở khung luyện tập.
2. Chọn trường từ vựng (ví dụ: "Vocabulary").
3. Xem định nghĩa gợi ý từ Gemini.
4. Nhập câu bạn muốn đặt vào khung "Luyện đặt câu".
5. Nhấn Gửi đánh giá để xem phản hồi chi tiết.

📘 Lưu ý kỹ thuật

• Addon tương thích với Anki 2.1.x và Qt5/Qt6.
• Hoạt động tốt nhất khi có kết nối Internet ổn định.
• Bạn có thể mở rộng hoặc thay đổi prompt để dùng cho các mục đích khác như: kiểm tra ngữ pháp, viết đoạn văn, phân tích lỗi sai,...

✅ Giấy phép

MIT License – Tự do sử dụng và chỉnh sửa cho mục đích cá nhân hoặc học tập.