Papermorph视频与LMS导出教程:一键渲染1080p MP4+SRT字幕,还能打包SCORM进课堂
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 章"滑轮"一节在播放器中的画面,这类章节正是导出脚本的典型对象:
一键导出: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)以最后一个场景自然收尾,不生成结束卡;教材类则保留互动测验在网页端,视频只负责"讲"。
进阶:打包 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 的标准试金石。
上手小贴士 ⚙️
- 依赖:导出需要
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。一条命令的事,让你的动画课本同时出现在网页、视频平台和课堂里。


