Kỹ thuật & AI
Papermorph biến giáo trình PDF thành bài học web tương tác
Papermorph giúp AI agent chuyển một mục trong giáo trình PDF thành bài học web có hình động, lời đọc và câu hỏi tự chấm.
Tóm tắt
- Papermorph giúp chuyển một mục giáo trình PDF thành bài học web có hình động và câu hỏi tự chấm.
- Agent dựng storyboard, tạo lời đọc và đồng bộ hình với tiếng. Người soạn duyệt nội dung trước khi đăng.
- Thử một bài phương trình có cân minh họa, rồi kiểm tra lời đọc, đáp án và trang web trên điện thoại.

Nếu muốn học viên thấy vì sao phải trừ cùng một số ở hai vế, bạn có thể dùng Papermorph để dựng ví dụ thành hình động có lời đọc, rồi dừng lại cho học viên tự trả lời. Xem cách dự án dùng lời đọc và câu hỏi ngay trong hình ở bản mẫu Elementary Algebra.
Ngày 21/11/2026, HubCom đọc tài liệu tại commit 839a62c và xem ghi chú phát hành của trình phát v2.11. Chúng tôi chưa chạy bài thử bên dưới hay dùng Papermorph trong dự án khách hàng.
Repo giải quyết được gì?
- Giảng từng bước từ giáo trình. Bạn chọn mục kiến thức, agent chuẩn bị ví dụ, lời đọc và chuyển động theo thứ tự giải.
- Đặt câu hỏi đúng lúc. Học viên có thể dừng ở bước đang xem, trả lời rồi mới tiếp tục. README
Chức năng
- Storyboard và lời đọc. Agent chia bài thành các đoạn ngắn, mỗi đoạn gắn lời đọc với hành động trên màn hình.
- Bài học web tĩnh. Thư mục đầu ra có trang bài học, trình phát và âm thanh để mở qua máy chủ tệp tĩnh. Tài liệu skill

Khi nào nên áp dụng?
Dùng cho bài có một thao tác cần nhìn thấy, chẳng hạn bỏ cùng số khối ở hai bên cân. Nếu dự định làm cả chương, duyệt một bài mẫu trước rồi lưu lựa chọn về giọng, hình và nhịp trong style.json. README
Lưu ý
- Môi trường chạy. Chuẩn bị
uv, FFmpeg và trình duyệt Playwright. README nêu Edge TTS chạy qua mạng và Kokoro là lựa chọn chạy cục bộ. README - Tệp nguồn. Dùng PDF bạn có quyền sử dụng. Giữ PDF và các trang trích xuất trong thư mục làm việc riêng. Tài liệu skill
Thử nghiệm
Chuẩn bị một hoặc hai trang PDF do bạn tự soạn về phương trình bậc nhất. Giao agent dựng ví dụ 2x + 3 = 7 bằng cân. Sau bước bỏ ba khối mỗi bên, chèn câu hỏi “Mỗi khối x bằng bao nhiêu?”.
Thứ tự triển khai
- Cài skill trong dự án. Với Claude Code, chạy
npx skills add DozenTwelve/Papermorph --skill papermorph --agent claude-code. README cũng hướng dẫn cài cho OpenCode. README - Giới hạn bài mẫu. Gọi
/papermorph, đưa đường dẫn PDF và yêu cầu làm một bài. Duyệt storyboard và đáp án trước khi agent dựng hình. Tài liệu skill - Mở bản xem trước. Dùng máy chủ xem trước theo hướng dẫn trong skill. Chạy bài từ đầu và trả lời ngay tại điểm dừng. Tài liệu skill
Bẫy thường gặp
- Hình chạy trước lời. Kiểm tra đúng khoảnh khắc cân bỏ ba khối ở cả hai bên.
- Đáp án đúng nhưng chấm sai. Thử một đáp án đúng và một đáp án sai để kiểm tra phản hồi.
Kiểm tra kết quả
- So từng bước với bài nguồn. Sau khi bỏ ba khối mỗi bên, hình và lời đều dẫn đến
2x = 4, rồix = 2. - Mở trên máy tính và điện thoại. Thử phát lời đọc, dừng ở câu hỏi và tiếp tục sau khi trả lời. Nghe cả đoạn sau điểm dừng nếu mở bằng iPhone hoặc iPad. Ghi chú trình phát v2.11
- Rà thư mục xuất bản. Xác nhận bài chạy khi phục vụ thư mục web tĩnh và thư mục đó không chứa PDF nguồn.
Không nằm trong bài này
Dựng sách tranh, xuất MP4 và đóng gói khóa học vào hệ thống LMS.
Thuật ngữ trong bài (4)
- Papermorph
- Skill hướng dẫn AI agent tạo bài học, sách hoặc câu chuyện tương tác chạy trên web.
- Storyboard
- Bản phác theo trình tự, ghi người học sẽ thấy và nghe gì ở từng đoạn.
- TTS
- Công cụ chuyển văn bản thành giọng đọc.
- Web tĩnh
- Trang được phục vụ từ tệp có sẵn và có thể chạy tương tác trong trình duyệt.
Câu hỏi thường gặp
Papermorph tạo video hay bài học web?
Bài thử dùng đầu ra web tĩnh có câu hỏi tương tác. Repo cũng có script xuất chương thành MP4 với phụ đề.
Có cần API key để làm bài thử đại số không?
README có lựa chọn lời đọc bằng Edge TTS hoặc Kokoro. Agent vẫn cần quyền truy cập mô hình đang dùng. Một số lựa chọn tạo giọng, hình hoặc clip trả phí cần API key riêng.
Nguồn tham khảo
- Papermorph README, DozenTwelve
- Papermorph skill, DozenTwelve
- Elementary Algebra, DozenTwelve
- Papermorph Engine v2.11, DozenTwelve