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.
Papermorph biến giáo trình PDF thành bài học web tương tác

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
Hai sơ đồ ròng rọc trong bài học Elementary Physics của Papermorph.
Một cảnh trong bài học về ròng rọc của Papermorph. Nguồn: README Papermorph · Mở bài học

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

  1. 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
  2. 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
  3. 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ồi x = 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

Trao đổi cùng HubCom ↗