这是什么
Paper Collage Video 是一个专为 Codex 设计的本地插画视频生产 Skill，基于 Remotion 构建，采用配置驱动的方式制作纸片分层故事、漫画化叙事和说明型视频。它负责从故事板、素材组织、动画、旁白同步到渲染与技术验收的完整流水线，同时将人的决策（内容意图、视觉方向、付费调用上限和最终成片）牢牢保留在流程中。
该项目的 GitHub 仓库由 cyberlesterr 维护，当前稳定版本为 v0.19.0，采用 MIT 许可证，已获得 231 颗星、27 个 fork，目前有 11 个开放 issue。项目仍处于 1.0.0 之前，内部协议可能继续调整，旧项目不会自动迁移。
适合谁
这个 Skill 特别适合以下人群：
- 内容创作者：想要快速生成可编辑、带旁白和字幕的纸片风格动画视频，但不想深入编程。
- 教育工作者：制作故事化、漫画化的说明视频，用于教学内容。
- 团队中的创意与技术复合角色：需要严格质量控制、人工审批流程和断点恢复能力的视频生产者。
- 希望自动化视频流水线但保留人类决策权的团队：该 Skill 强调人在循环中的角色。
能做什么
该 Skill 提供了一系列能力：
- 创建新视频：根据文字描述生成完整的纸片分层视频项目。
- 故事板与素材组织：自动构建场景、角色、动作和视觉风格，并规划素材的使用。
- 分层动画与视差效果：制作具有景深运动的纸片画面。
- 旁白同步与字幕：将文本转为语音，并同步到时间轴。
- 预览渲染：生成
preview.mp4供人工审阅。 - 断点恢复：通过
npm run project:resume --恢复中断的任务。 - 技术验收：执行质量检查与动作证明，确保视频符合规格。
- 预算控制：支持设置精确的图片调用上限，避免超支。
使用前准备
在安装使用之前，你需要准备：
- Node.js 20+ 环境（必需）。
- FFmpeg / ffprobe（本地渲染必需）。
- Python 3.11+（仅处理色键素材表时需要）。
- 若使用外部生成服务（图片、语音等），需要配置相应 Provider 的授权，并可能产生费用。
- 建议预先了解 Codex 插件的基本操作方式。
安装方法
推荐直接通过 Codex 插件安装，无需手动克隆仓库。只需将以下指令交给 Codex：
请安装这个 Codex 插件并完成初始化验证：
https://github.com/cyberlesterr/paper-collage-video
对应的官方安装命令为：
codex plugin marketplace add cyberlesterr/paper-collage-video
codex plugin add paper-collage-video@paper-collage-video
安装完成后，新建一个 Codex 任务并描述想做的视频即可。首次运行会自动创建独立的 Remotion 工作区并进行环境诊断，项目文件、依赖和渲染结果不会写入插件缓存。
使用示例
例如，你可以对 Codex 说：
用 $make-paper-collage-video 做一条约 30 秒的玄奘西行纸片分层视频。
Skill 会引导你完成关键决策节点，包括：
- 选择画幅、视觉风格和分层视差偏好。
- 确认故事与制作方案、图片调用上限，以及文本、生图和语音 Provider。
- 确认故事专属风格样张、短试听和动作证明。
- 查看
preview.mp4，批准成片方向或提出修改意见。
本地渲染完成后，如需外部发布，必须另行获得授权。
风险与注意事项
- 版本稳定性：项目仍低于 1.0.0，内部协议可能变化，旧项目可能无法自动迁移。
- 费用风险：依赖下载、FFmpeg 安装、Provider 授权和可能产生费用的调用需要人工批准，使用时需注意预算控制。
- 第三方许可：本项目依赖 Remotion，部分公司使用场景可能需要购买 Remotion Company License；项目自身许可证（MIT）不替代其他组件的条款。
- 平台支持：当前 CI 在 Ubuntu 上运行，维护者同时在 macOS 上验证。Windows 已做路径适配，但尚未纳入 CI，属于尽力支持。
- 开源协议：源码、脚本、Schema、模板、测试和文档采用 MIT 许可，但测试夹具、纸张纹理、演示媒体及其衍生产物不采用 MIT，需按 ASSET_LICENSES.md 规定的范围使用。
- 安全漏洞：安全漏洞需通过 SECURITY.md 的私密报告流程提交，不要公开披露。
请在使用前仔细阅读仓库中的 SUPPORT.md、SECURITY.md 和 THIRD_PARTY_NOTICES.md 文档，确保合规使用。