Fudoki là một công cụ phân tích tiếng Nhật và tổng hợp giọng nói chạy hoàn toàn trong trình duyệt, giúp bạn tách từ, xem từ loại, phiên âm và nghe đọc văn bản mà không cần tài khoản. Nếu bạn đang học tiếng Nhật hoặc làm việc với văn bản Nhật ngữ, repo GitHub này đáng để thử ngay.

Thank you for reading this post, don't forget to subscribe!

Những điểm chính

• Fudoki là ứng dụng web local-first, dữ liệu không rời khỏi trình duyệt, không cần tài khoản hay đồng bộ đám mây.
• Công cụ dùng Kuromoji.js để tách từ, hiển thị từ loại, kana và romaji; sau đó dùng Web Speech API để đọc to văn bản.
• Hỗ trợ từ điển JMdict, Markdown, JSON export/import, PWA offline và giao diện đa ngôn ngữ ja/en/zh.
• Phù hợp cho người học tiếng Nhật, dịch giả, người đọc tài liệu và bất kỳ ai muốn phân tích văn bản Nhật nhanh trong trình duyệt.

Fudoki là gì và giải quyết vấn đề gì?

Fudoki là một ứng dụng web tương tác để phân tích văn bản tiếng Nhật và đọc thành tiếng, được thiết kế theo hướng local-first. Nó giải quyết bài toán đọc hiểu tiếng Nhật khi bạn gặp câu dài, không rõ từ nào bắt đầu từ nào, hoặc không biết cách phát âm chính xác.

Thay vì phải sao chép từng câu sang từ điển hay công cụ dịch, bạn dán văn bản vào Fudoki, hệ thống sẽ tách thành từng token, gắn nhãn từ loại, kana, romaji và có thể đọc to. Toàn bộ xử lý diễn ra trong trình duyệt nhờ Kuromoji.js và Web Speech API, nên không cần gửi dữ liệu lên máy chủ. Bạn có thể xem chi tiết tại repository gốc trên GitHub.

Tên Fudoki được lấy cảm hứng từ bộ địa chí cổ Nhật Bản thời Nara, với tinh thần ghi chép lại không khí, nhịp điệu và cấu trúc của ngôn ngữ. Công cụ không phải là một cuốn sách, mà giống một cuốn sổ tay giúp bạn quan sát cách câu chữ vận hành.

Vì sao Fudoki phù hợp cho việc học tiếng Nhật?

Fudoki phù hợp cho việc học tiếng Nhật vì nó kết hợp phân tích từ vựng, phiên âm và âm thanh trong cùng một giao diện, giúp bạn không phải chuyển đổi liên tục giữa nhiều công cụ. Người học có thể xem cấu trúc câu, ghi nhớ cách đọc rồi nghe lại để luyện phát âm.

Điểm mạnh là chế độ xem token với màu sắc theo từ loại: danh từ màu xanh lá, động từ xanh dương, tính từ cam, trạng từ tím, trợ từ đỏ, thán từ vàng. Với người mới, việc nhận biết ranh giới từ trong tiếng Nhật vốn khó vì không có dấu cách; Fudoki giúp việc này trở nên trực quan. Ngoài ra, từ điển JMdict đi kèm cho phép nhấp vào thẻ từ để xem bản dịch, giúp tra cứu nhanh ngay trong lúc đọc.

Một điểm cộng nữa là chế độ đọc theo từ, theo dòng hoặc toàn bài kết hợp tốc độ từ 0,5 đến 2,0. Bạn có thể chọn giọng đọc, thay đổi tốc độ ngay khi đang phát, và Fudoki sẽ phát lại từ vị trí gần nhất với cài đặt mới. Cách này rất hữu ích khi nghe một câu khó và cần nghe chậm lại mà không muốn tua tay.

Những tính năng nổi bật của Fudoki

Fudoki gói gọn trong một trang web nhưng có nhiều tính năng đáng chú ý: quản lý tài liệu, phân tích từ vựng, speech synthesis, từ điển JMdict, Markdown, PWA offline và giao diện đa ngôn ngữ. Điểm ấn tượng nhất là mọi thứ đều chạy local, không có tài khoản hay đồng bộ đám mây.

Phân tích văn bản theo từng token

Phân tích văn bản dựa trên Kuromoji.js, một thư viện tách từ tiếng Nhật chạy bằng JavaScript. Kết quả trả về dạng các thẻ token nhỏ, mỗi thẻ có chấm màu và gạch chân tương ứng với từ loại. Bạn có thể chuyển qua lại giữa chế độ soạn thảo và chế độ phân tích ngay trong vùng chính.

Phát âm linh hoạt

Phần speech synthesis dùng Web Speech API, cho phép phát âm theo cấp độ từ, dòng hoặc toàn bộ văn bản. Người dùng có thể chọn giọng, chỉnh tốc độ 0,5 đến 2,0. Nút Play khi đang phát sẽ chuyển thành icon stop, và có nút Pause/Resume riêng để điều khiển chính xác. Các cài đặt giọng đọc và tốc độ được lưu trong localStorage.

Từ điển và quản lý dữ liệu

Fudoki tích hợp JMdict, bạn nhấn vào thẻ từ là thấy bản dịch. Phần quản lý tài liệu ở sidebar có tìm kiếm, bộ lọc, yêu thích và tự động lưu. Dữ liệu có thể xuất/nhập dạng JSON để sao lưu. Bản PWA hỗ trợ offline pack, nghĩa là sau khi tải, bạn vẫn dùng được khi mất mạng.

Giao diện được thiết kế theo phong cách Linear, có dark/light theme, dropdown và dialog tự vẽ, không dùng native controls. Ngoài ra, trình soạn thảo Markdown tích hợp EasyMDE với toolbar tối giản gồm in đậm, in nghiêng, heading, quote, list, link và preview. Trang cũng hỗ trợ tối ưu mobile-first với drawer tài liệu và bottom dock, đặc biệt chú ý safe-area trên màn hình 390×844.

Hướng dẫn cài đặt và sử dụng Fudoki

Bạn có thể dùng Fudoki trực tuyến ngay tại địa chỉ https://fudoki.iamcheyan.com, hoặc chạy local trên máy chỉ với một lệnh Python. Theo mình, cách local phù hợp khi bạn muốn dùng hoàn toàn ngoại tuyến và giữ dữ liệu riêng tư trong môi trường kiểm soát.

1. Tải mã nguồn từ repository hoặc giải nén thư mục dự án vào một thư mục bất kỳ.
2. Mở terminal trong thư mục chứa file index.html.
3. Chạy lệnh python3 -m http.server 8000.
4. Mở trình duyệt và truy cập http://localhost:8000.
5. Dán văn bản tiếng Nhật vào, chuyển sang chế độ phân tích, nhấn vào từ để xem nghĩa và dùng nút play để nghe đọc.

Sau khi chỉnh sửa file JavaScript, bạn có thể kiểm tra cú pháp bằng lệnh node --check static/main-js.js. Nếu cập nhật dữ liệu từ điển JMdict, hãy đặt file vào thư mục static/libs/dict/.

Ai nên dùng và ai không nên dùng Fudoki?

Fudoki phù hợp nhất với người học tiếng Nhật trình độ sơ trung cấp, người cần đọc tài liệu tiếng Nhật thường xuyên, và những ai ưu tiên quyền riêng tư vì không muốn gửi văn bản lên cloud. Nó cũng hữu ích cho người dùng offline hoặc muốn một công cụ gọn nhẹ trong trình duyệt.

Nếu bạn cần một hệ thống học từ vựng có bài tập, nhắc nhở, đồng bộ nhiều thiết bị hoặc hỗ trợ cộng tác nhóm, Fudoki chưa phải lựa chọn tối ưu. Vì dữ liệu nằm trong trình duyệt, bạn sẽ không có tài khoản để đồng bộ lịch sử học từ máy này sang máy khác. Ngoài ra, phân tích của Kuromoji.js chủ yếu ở mức hình thái, không phải phân tích cú pháp ngữ pháp chuyên sâu. Nếu bạn cần giải thích ngữ pháp chi tiết, nên kết hợp với giáo trình hoặc công cụ khác.

Về mặt hạn chế, giao diện hiện hỗ trợ tiếng Nhật, Anh và Trung, chưa có tiếng Việt. Người dùng Việt vẫn có thể thao tác tốt vì chức năng chính là dán văn bản và xem kết quả, nhưng nếu muốn một giao diện thuần Việt, bạn cần chờ bản cập nhật hoặc tự đóng góp.

Câu hỏi thường gặp

Fudoki có miễn phí không?

Fudoki được phát hành theo giấy phép MIT, nghĩa là bạn có thể dùng miễn phí, chỉnh sửa và đóng góp cho dự án. Các thư viện đi kèm cũng có giấy phép riêng: Kuromoji.js dùng Apache 2.0, JMdict dùng Creative Commons Attribution-ShareAlike 3.0.

Dữ liệu của tôi có bị gửi lên máy chủ không?

Theo README, Fudoki không có tài khoản, không đồng bộ cloud, toàn bộ tài liệu lưu trong trình duyệt. Vì vậy dữ liệu văn bản của bạn không cần rời khỏi máy khi dùng bản local. Bản online hoạt động tương tự, nhưng bạn vẫn nên kiểm tra cơ chế lưu trữ của trình duyệt.

Fudoki có hỗ trợ tiếng Việt không?

Giao diện Fudoki hiện hỗ trợ ba ngôn ngữ là tiếng Nhật, tiếng Anh và tiếng Trung, chưa có tiếng Việt. Tuy vậy, cách dùng không phức tạp: bạn dán text, xem token, nhấn vào từ để tra nghĩa, nên người Việt vẫn có thể sử dụng mà không gặp nhiều trở ngại.

Có cần kết nối Internet để dùng Fudoki không?

Bản online cần Internet lần đầu, nhưng Fudoki hỗ trợ PWA offline pack, giúp bạn tải ứng dụng về máy. Sau khi tải tài nguyên, bạn có thể dùng các tính năng chính khi mất mạng. Nếu muốn chắc chắn hoạt động ngoại tuyến, hãy chạy local bằng python3 -m http.server 8000.

Fudoki có thay thế được từ điển tiếng Nhật chuyên sâu không?

Fudoki tích hợp JMdict để tra nghĩa nhanh khi click vào token, nhưng nó không phải ứng dụng từ điển chuyên sâu. JMdict phù hợp để hiểu nghĩa theo ngữ cảnh hơn là luyện tập từ vựng, ghi chú và hệ thống ôn tập. Với nhu cầu học sâu, bạn nên dùng thêm công cụ chuyên dụng.

Kết luận

Fudoki là một công cụ phân tích tiếng Nhật đáng thử cho người học, dịch giả và bất kỳ ai cần đọc hiểu văn bản Nhật trong trình duyệt. Điểm mạnh nằm ở thiết kế local-first, tách từ trực quan, đọc to linh hoạt và hỗ trợ offline. Bạn có thể truy cập bản online hoặc chạy local chỉ với một lệnh Python. Nếu thấy hữu ích, hãy để lại sao trên GitHub hoặc đóng góp cho dự án.