Papermorph视频与LMS导出教程:一键渲染1080p MP4+SRT字幕,还能打包SCORM进课堂

原创2026-10-25 16:06:351,848 阅读

Papermorph视频与LMS导出教程:一键渲染1080p MP4+SRT字幕,还能打包SCORM进课堂

Papermorph 是一个把书变成"会动、会读、能互动"网页体验的 AI Skill:教材逐帧动画+配音+测验,故事书则变成纸偶动画短片。更实用的是,它自带两条导出通道——任意一章都能一键渲染成 1080p MP4 视频 + SRT 字幕文件,整本书还能打包成 SCORM 1.2/2004 直接上传进 Canvas、Moodle 等课堂 LMS。本文带你走完全流程。

为什么导出的视频和网页页面"分毫不差" 🎬

很多"网页转视频"方案靠录屏,漂移、掉帧、每次结果都不同。Papermorph 的做法完全不同:

  • 播放器引擎把每一帧都画成"beat 时间"的纯函数,导出脚本(export.py)不是录屏,而是把时钟拨到每一帧的精确时刻去"seek 渲染"——所以视频与页面完全一致,而且每次运行结果都相同。
  • 声音按页面播放的逻辑混音:每段语音从各自 beat 的 pre 时刻进入,绘本里的音效(sfx())在场景切换处截断,BGM 带交叉淡化、有人声时自动降到 30% 音量。
  • 题目类 beat(随堂小测、章末练习)不进入视频,视频结尾会停一张结束卡,指引学习者回到交互版页面做练习(用 --link 可显示该页地址)。

下图就是 Elementary Physics 第 12 章"滑轮"一节在播放器中的画面,这类章节正是导出脚本的典型对象:

Papermorph物理章节滑轮动画截图,展示交互课堂网页渲染画面

一键导出:1080p MP4 + SRT 字幕

第 1 步:本地起一个预览服务

导出要求站点通过 HTTP 访问。用自带的无缓存预览服务器(serve.py,支持 Range 请求,拖动音频不会从头开始):

python3 .claude/skills/papermorph/scripts/serve.py 8765 site

然后打开 http://localhost:8765/<书名>/ 确认页面正常。

第 2 步:渲染视频

uv run --with playwright --with numpy .claude/skills/papermorph/scripts/export.py ch12 \
  --url http://localhost:8765/science/ \
  --link https://your-site.org/science/ch12/

常用参数一览(export.py):

参数 默认值 作用
chapter(位置参数) — 章节文件夹名,如 ch12
--url http://localhost:8765/ 本地站点地址,结尾带 /
--height 1080 视频高度,宽度自动保持 16:9
--fps 30 帧率
--out export 输出目录
--link — 结束卡上显示的交互课堂地址

跑完后你会得到两个文件:

  • export/ch12.mp4 —— 1080p、H.264 + AAC,画面是逐帧精确渲染的
  • export/ch12.srt —— 独立字幕文件(字幕刻意不烧进画面),上传视频平台时随视频一起传即可

💡 绘本类书籍(如 Joke Collection)以最后一个场景自然收尾,不生成结束卡;教材类则保留互动测验在网页端,视频只负责"讲"。

Papermorph绘本纸偶动画场景,奶牛纸偶站在农场上,底部有字幕与进度条播放器

进阶:打包 SCORM,让整本书进课堂 📚

如果你的书是用于课程的(大学课堂最常见),scorm.py 可以把整本书打包成一个标准 SCORM zip:

python3 .claude/skills/papermorph/scripts/scorm.py site/science                    # 默认 SCORM 2004
python3 .claude/skills/papermorph/scripts/scorm.py site/science --version 1.2      # 老 LMS 用 1.2
python3 .claude/skills/papermorph/scripts/scorm.py site/science --mastery 80       # 80 分判定 passed/failed

输出为 dist/science-scorm2004.zip,上传到 LMS 即可。打包过程不会改动 site/<book>/ 原目录;它会自动向每章注入 scorm-bridge.js(运行时文件见 assets/scorm/),把引擎的进度上报、完成卡、断点续学都桥接到 LMS。书有改动后重新打包一次即可。

LMS 里到底能追踪到什么?

追踪项 SCORM 1.2 SCORM 2004
完成度(所有章节到达结束卡) cmi.core.lesson_status cmi.completion_status
进度(已完成章 ÷ 总章) — cmi.progress_measure
得分(全部随堂测+练习的首次答对率,每章取最好成绩) cmi.core.score.raw cmi.score.raw / cmi.score.scaled
每章一个目标(ch01、ch02…)含状态与分数 cmi.objectives.n.* cmi.objectives.n.*
断点续学(勾选项、Continue 按钮) cmi.suspend_data cmi.suspend_data

详细说明见 references/courses.md。

交付前先本地验证

项目自带一个"模拟 LMS"(mock-lms.html):左侧跑课程,右侧实时显示所有 CMI 值和调用日志。用脚本自动走查一遍(打开章节→到达结束卡→验证续学):

uv run --with playwright .claude/skills/papermorph/assets/scorm/test/check_scorm.py dist/science-scorm2004.zip

想手动点一遍:把 zip 解压成 pkg/ 放在 mock-lms.html 旁边,用 test/serve.py 起服务后访问带 ?pkg=pkg&v=2004&reset 的地址即可。最后建议在 SCORM Cloud(免费)上再验一次,这是真实 LMS 的标准试金石。

Papermorph书架预览:物理滑轮动画、测验判分与带英文字幕的纸偶短片并列展示

上手小贴士 ⚙️

  • 依赖:导出需要 ffmpeg 和 Playwright 浏览器(uv run --with playwright playwright install chromium);起服务需要 Python。
  • 包体积:音频占 SCORM 包的大头,上传前留意 LMS 的文件大小限制。
  • 评分细节:--mastery 只在整本书完成后判定 passed/failed;若成绩应取决于答题正确率,务必加上它(学习者可以跳过步骤直达结束卡)。
  • 平台差异:Canvas 只按整体结果评分,不展示每章 objective 明细。
  • 跨书链接:结束卡里链接到其他书的文件夹链接在 LMS 包内无效,包内只保证本书闭环。
  • 想先跑起来体验全部例子,可先克隆仓库(git clone --depth 1 https://gitcode.com/gh_mirrors/pa/Papermorph),再用 serve.py 打开 site/ 下的示例书。

写在最后

从"一本书"到"三种形态"——交互式网页、1080p 带字幕视频、SCORM 课程包——Papermorph 的导出链路都沉淀成了几个短小的脚本:预览用 serve.py,视频用 export.py,LMS 用 scorm.py,课程选项全文在 courses.md。一条命令的事,让你的动画课本同时出现在网页、视频平台和课堂里。

登录后查看全文
Papermorph