Câu hỏi trước khi cài đặt

Dành cho người muốn học ngoại ngữ bằng tài liệu tự chọn và sẵn sàng ôn lại trong nhiều tháng hoặc nhiều năm. Bạn chọn từ trong sách, phụ đề, bài học hoặc hội thoại, rồi kamishibai tạo thẻ với những từ đó. Chương trình không thay thế khóa học: bạn tự quyết định chủ đề và thứ tự học.

Anki phụ trách ôn tập theo phương pháp lặp lại ngắt quãng: thẻ đã nhớ tốt sẽ xuất hiện sau những khoảng thời gian dài dần, còn thẻ đã quên sẽ quay lại sớm hơn. Số thẻ mới và giới hạn mỗi ngày được điều chỉnh trong Anki.

Tôi tin rằng nhờ thế hệ tác nhân AI mới, chúng ta có thể làm phần mềm mang dấu ấn riêng dễ như viết blog trước đây: chia sẻ trải nghiệm của mình qua những cách làm mà người khác có thể dễ dàng áp dụng. Kamishibai là cách tôi thử nghiệm ý tưởng đó. Trước hết, đây là công cụ chính tôi dùng hằng ngày và phát triển từ trải nghiệm sử dụng thực tế.

Mangaka, tức tác giả manga, tự mình kết hợp câu chuyện, nét vẽ và tính cách nhân vật thành một tác phẩm thống nhất. Tôi thích cách sáng tác ấy. Đó cũng là lý do tôi chọn phong cách hình ảnh này cho kamishibai: tôi thích một dự án có góc nhìn riêng, thể hiện từ ý tưởng đến diện mạo.

Ở chế độ chính, bạn nhập danh sách từ hoặc cách diễn đạt muốn học. Không cần đưa tất cả về dạng gốc trong từ điển: kamishibai sẽ cố nhận diện nội dung bạn nhập và đưa ra các nghĩa để chọn. Mỗi nghĩa được chọn sẽ có một thẻ riêng kèm câu ví dụ.

Nếu câu chưa phù hợp, bạn có thể nói rõ muốn sửa gì rồi tạo lại. Nếu đã soạn sẵn nội dung thẻ, bạn cũng có thể đưa vào theo định dạng cards JSON. Phần này được giải thích riêng bên dưới.

Kamishibai chuẩn bị tài liệu: tạo câu, phần giải thích, giọng đọc và hình minh họa, rồi đóng gói thành tệp .apkg — một bộ thẻ có thể mở trong Anki.

Anki tổ chức ôn tập: hiển thị thẻ, lưu mức đánh giá của bạn và lên lịch cho lần ôn tiếp theo.

Kamishibai cũng tạo PDF để làm thẻ giấy. Bạn có thể in ra và cắt thành thẻ nếu muốn học không cần màn hình.

Không. Sau khi cài đặt, bạn chạy kamishibai trong terminal, một cửa sổ có giao diện bằng văn bản. Chương trình sẽ hướng dẫn từng bước: thêm từ, chọn nghĩa, kiểm tra thẻ và tạo bộ thẻ. Bạn không cần viết mã.

Để tự động hóa, chương trình có các lệnh riêng trả về dữ liệu JSON. Script và tác nhân AI có thể dùng chúng, nhưng cách sử dụng thông thường không cần đến.

Bạn chọn từ và nghĩa; các mô hình AI tạo tài liệu theo quy tắc được đặt trong kamishibai. Những quy tắc này xác định cấu trúc thẻ và yêu cầu đối với câu, phần giải thích, giọng đọc và hình minh họa.

Trước khi tạo, bạn có thể chọn độ khó và loại câu: câu kể, câu hỏi, hội thoại hoặc kết hợp các loại. Bạn cũng có thể kiểm tra kết quả và yêu cầu tạo lại kèm những điều muốn sửa.

Có 22 ngôn ngữ: Anh, Trung, Tây Ban Nha, Nhật, Pháp, Đức, Hàn, Nga, Ý, Bồ Đào Nha, Hindi, Ả Rập, Thổ Nhĩ Kỳ, Ba Lan, Ukraina, Indonesia, Việt, Thái, Hy Lạp, Hebrew, Hà Lan và Séc.

Mỗi bộ thẻ dùng một cặp: ngôn ngữ đang học và ngôn ngữ dành cho bản dịch, phần giải thích. Bạn có thể ghép bất kỳ hai ngôn ngữ nào trong danh sách. Chất lượng tài liệu phụ thuộc vào khả năng xử lý cặp ngôn ngữ đó của các mô hình.

Nếu cần ngôn ngữ khác, hãy gửi yêu cầu trên GitHub để cùng xem có thể làm gì.

Để tạo thẻ, bạn cần:

• Máy tính chạy macOS, Linux hoặc Windows.
• Kết nối Internet: văn bản, giọng đọc và hình minh họa được tạo qua Gemini API.
• Khóa Gemini API của riêng bạn. Tạo khóa trong Google AI Studio →

Để ôn tập, hãy cài Anki →

Nếu ngôn ngữ đã chọn cần kiểm tra chữ trong hình ngay trên máy, chương trình cũng sẽ tải các mô hình nhận dạng văn bản (OCR) trong lần tạo hình minh họa đầu tiên.

Có bản dựng sẵn cho macOS, Linux và Windows.

• macOS và Linux: cài qua Homebrew hoặc script cài đặt.
• Windows: chạy script cài đặt qua Git Bash, MSYS hoặc Cygwin.

Các lệnh và liên kết đến script nằm trong phần cài đặt.

Kamishibai miễn phí và có mã nguồn mở. Bạn trả riêng chi phí gọi Gemini bằng khóa API của mình.

Mức tham khảo là khoảng 15 USD cho 100 thẻ có văn bản, giọng đọc và hình minh họa. Đây là ước tính: tổng chi phí phụ thuộc vào lượng tài liệu, số lần tạo lại và giá của các mô hình. Chương trình đã chọn sẵn mô hình, nên bạn không cần cấu hình chúng để bắt đầu.

Nếu học bốn thẻ mới mỗi ngày, một bộ trăm thẻ sẽ đủ cho 25 ngày. Những câu đã học vẫn cần được ôn tiếp sau đó. Vì vậy, tôi chọn những từ mình thực sự muốn dùng và ưu tiên chất lượng thẻ hơn việc giảm chi phí tạo xuống mức thấp nhất.

Cài đặt, phiên làm việc, bộ nhớ đệm và các tệp đã tạo được lưu trên máy tính của bạn. Kamishibai không có máy chủ riêng để tạo thẻ.

Để tạo và kiểm tra tài liệu, chương trình dùng khóa API của bạn để gửi từ, câu và hình minh họa cần kiểm tra đến Gemini. Khi đồng bộ qua Anki, bộ thẻ đã hoàn thành và các tệp hình, âm thanh cũng được gửi đến AnkiWeb.

Khóa đã lưu nằm trong tệp cài đặt trên máy, không phải kho mật khẩu của hệ điều hành. Đừng gửi tệp này cho người khác hoặc đưa nó vào kho mã nguồn công khai.

Có. Nhưng theo trải nghiệm của tôi, thế hệ mô hình hiện tại đã cho kết quả khá ổn định. Tôi cũng dành nhiều công sức để cải thiện chất lượng thẻ hoàn chỉnh.

Hiện giọng đọc là phần ổn định nhất và khá gần với lời nói tự nhiên. Các mô hình căn độ khó của câu chưa chính xác bằng: chúng cố bám theo trình độ đã chọn, nhưng đôi lúc vẫn tạo câu dễ hơn hoặc khó hơn.

Hình minh họa dễ có lỗi nhất: AI vẫn có thể vẽ thêm cánh tay thứ ba cho một người. Vì vậy, ứng dụng có các mô hình AI riêng để đánh giá hình đã tạo. Hình không đạt kiểm tra sẽ được tạo lại.

Kiểm tra tự động không bảo đảm toàn bộ tài liệu đều đúng. Với câu còn nghi ngờ, nên đối chiếu từ điển hoặc hỏi giáo viên, rồi tạo lại thẻ nếu cần.

Một tác nhân AI như Claude Code có thể sử dụng kamishibai. Bạn mô tả việc cần làm, tác nhân thực hiện qua các lệnh của chương trình. Chẳng hạn, bạn có thể giao các việc sau:

• Chọn từ theo chủ đề hoặc từ văn bản của bạn.
• Chọn nghĩa cần học và tạo thẻ.
• Kiểm tra kết quả, tạo lại thẻ chưa đạt trước khi nhập vào Anki.

Chương trình có JSON CLI cho việc này: các lệnh trả về dữ liệu JSON mà không cần hỏi đáp trong terminal. Tác nhân có thể chạy việc tạo thẻ ở chế độ nền và xử lý nhiều phiên cùng lúc.

Hãy đưa tác nhân liên kết đến llms.txt. Tệp này giải thích cách cài đặt hoặc cập nhật kamishibai và lấy hướng dẫn tích hợp cho phiên bản đang dùng. Việc sử dụng tác nhân và tạo thêm thẻ có thể làm tăng chi phí.

Khi cần giữ nguyên cách diễn đạt đã có, chẳng hạn câu trong bài học hoặc đoạn hội thoại ngắn. Thay vì danh sách từ, bạn đưa nội dung thẻ vào tệp cards JSON — một tệp văn bản có cấu trúc quy định sẵn.

Tệp phải có đầy đủ các trường bắt buộc của thẻ, không chỉ riêng câu ví dụ. Bạn có thể tự chuẩn bị hoặc giao cho tác nhân AI. Câu chữ trong tệp được giữ nguyên, không viết lại. Kamishibai sẽ thêm giọng đọc và hình minh họa, rồi tạo bộ thẻ Anki dạng APKG cùng PDF để in.

Cấu trúc, trường bắt buộc và ví dụ có trong cards-json.md →

Có. Kamishibai tạo thẻ trên máy tính, còn bạn có thể ôn bằng ứng dụng Anki trên điện thoại.

• Mở tệp .apkg đã tạo trong Anki trên máy tính. Nếu nhấp đúp không bắt đầu nhập, chọn Tệp → Nhập.
• Đồng bộ bộ sưu tập qua AnkiWeb.
• Đăng nhập cùng tài khoản trong ứng dụng điện thoại rồi đồng bộ để tải thẻ, hình ảnh và âm thanh.

Để học không cần màn hình, bạn có thể in PDF, cắt và gấp thành thẻ. Thẻ giấy không có giọng đọc hay lịch ôn tự động.

Văn bản, giọng đọc và hình minh họa do các mô hình thuộc dòng Gemini tạo ra. Kamishibai đưa ra hướng dẫn, kiểm tra một phần kết quả và ghép tài liệu thành thẻ.

Giọng đọc được mô hình tổng hợp, không phải bản thu của người đọc. Hãy kiểm tra âm thanh cùng các nội dung khác trước khi bắt đầu học.

Nếu không nhớ nghĩa của câu hoặc từ khóa, hãy bấm “Lại”. Anki sẽ đưa thẻ đó trở lại sớm hơn. Điều này áp dụng cho cả thẻ mới lẫn thẻ bạn đã biết trong nhiều tháng.

Nên đánh giá nghiêm đến đâu còn tùy bạn đang luyện điều gì. Lúc đầu, tôi chấp nhận lỗi nhỏ ở mạo từ hoặc giới từ nếu đã nhớ nghĩa và những từ chính. Khi câu đã quen, tôi bắt đầu yêu cầu bản thân chính xác ở cả những chi tiết này.

Nếu một thẻ cứ liên tục gây khó, hãy xem lại câu: tình huống có rõ không, có quá nhiều điều chưa biết không? Đôi khi đơn giản hóa hoặc đổi ví dụ hữu ích hơn là cố nhớ mãi câu cũ.

Không có mốc thời gian cố định. Kết quả phụ thuộc vào trình độ ban đầu, các câu đã chọn, việc ôn đều đặn và liệu bạn có sử dụng ngôn ngữ đó ngoài Anki hay không.

Bạn có thể lấy 50 câu đầu đã học chắc làm dịp kiểm tra: có dễ nhớ lại cách diễn đạt quen thuộc hơn không, có nhận ra chúng trong bài đọc mới không, có dùng được khi nói chuyện không? Đây không phải ngưỡng mà cứ vượt qua là chắc chắn có “cảm nhận ngôn ngữ”. Hãy nhìn vào những việc mình đã làm được, không chỉ số lượng thẻ.