SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场papercut-build

papercut-build

设计与创作

查看项目

更新于 10-26 16:19

技能介绍

Papercut Build 是用于从分镜脚本构建并渲染单集 papercut 视频的工具，属于 papercut-explainer 技能体系。它不要求从零编写 Remotion 工程，而是基于共享库搭建每一集。

用途

该工具将前序阶段产出的分镜文件（papercut/STORYBOARD.md）和旁白脚本（narration/script.json）转化为可渲染的剧集工程：创建项目骨架、规划场景与时间轴、准备素材、并行构建各场景、配置音效与配乐，最后渲染为 MP4。

前置条件

需安装 Standard 或 Full 模式，具备库文件、Node 20+、npm、ffmpeg、Python 工具（numpy、Pillow、soundfile）以及用于音频渲染的 Chrome 或 Chromium。库路径优先取环境变量 $PAPERCUT_LIB，其次取 ~/.config/papercut-explainer/config.env 中的配置行，否则会询问一次；完全没有库时，可依据 references/remotion-recipes.md 中的草图构建。首次使用前需加载 Remotion 最佳实践技能。可用 library/tools/selftest.sh 对整条工具链做冒烟测试。

主要流程

  1. 脚手架：运行 $PAPERCUT_LIB/new_episode.sh <series-dir> NN-slug CompId [out-name]，创建剧集目录结构并复制模板工程与工具包快照；node_modules 来自 $DONOR、最新同级剧集或 npm i。不覆盖已有文件，若 papercut/package.json 已存在则停止。src/lib/ 为快照，不应在项目中直接编辑，应修改库后用 sync_kit.sh 重新同步。
  2. 计划：根据分镜填写 papercut/episode.json（scenes、banners、hook、cuts、bed、whipScene、cutSfx、gaps 等字段），运行 papercut-voice 的计时步骤，再用 stubs.py 生成场景桩，timing_md.py 写入 Timing 段。短于 1.2 秒的场景会被标记，需合并到相邻场景。
  3. 素材：按 asset-prompts.md 指引，用图像工具生成背景和复杂静态道具（透明 PNG），角色、文字、标签、仪表、按钮和 UI 用代码实现；生成图片中不得含文字。无图像工具时全部用代码加纸片滤镜构建。背景优先使用库内置 <Backdrop> 集合，需要新地点时才生成。证明截图用 capture.mjs 生成并由 RealShot 展示。
  4. 场景：先自行构建 S01Hook 作为参考场景，其余按场景分组（每组 2-3 个场景）交给并行场景智能体。智能体只写 src/scenes/<Scene>.tsx、可选的 .parts.tsx 和 tools/cue_sheet.d/<Scene>.json，不得修改 src/lib/**、其他场景、index.ts、plan.json、episode.json 或分镜。构建规则：1080x1920、30 fps、场景按工具包转场序列衔接；全局层包含旁白与音乐 <Audio>、用 <Boil> 的贴纸横幅、<WordTagCaptions>、<GrainOverlay>；每个道具包裹在 <Paper> 中，入场用 <PopIn>，场景在分镜相机内运行，不用 CSS 动画，底部 20% 保持空白，相邻场景不共用背景。默认主角为方形橙色小生物（token C.hero #D67354，暗部 C.heroLo #A9553B，别名 you），通过配件和名字标签区分角色。
  5. 音效：从 library/audio/sfx/.js 按名称选择音效，从 library/audio/beds/.json 按预设选择配乐，运行 cues.py 合并音效行并检查密度（气声类音效不超过每 2.5 秒一次），再运行 render.mjs 生成 public/audio/music.wav 与 fx.wav。
  6. 渲染：用 npx remotion studio 预览，仅在需要时运行 $PAPERCUT_LIB/tools/render.sh 输出 out/<out>.mp4。支持 --workers N（默认 3）、--conc N、--force、--keep。场景有缓存，修复后仅重渲染变动场景；但工具包、计划、旁白或字幕变化会全部重渲染。首次运行会下载 Remotion 无头 Chrome，out/cache 占用数 GB ProRes 空间。修复单场景时编辑对应 tsx，经 papercut-qa 检查后重新运行 render.sh。
  7. 收获：剧集完成后运行 harvest.py 生成只读报告，再用 catalog.py 重新生成两个目录，按 library/HARVEST.md 提升工具包修复、可复用组件、新音效和反复出现的节拍，并在 library/CHANGELOG.md 添加条目。

适用场景

适用于已有分镜和旁白脚本、需要批量制作 papercut 风格短视频剧集的流程；支持多场景并行构建与增量渲染，适合系列化内容生产。

限制

依赖较多外部组件和库文件；需要提供分镜与旁白脚本；智能体并行构建受所用 harness 是否支持子智能体影响；渲染缓存占用空间较大；具体收费与价格信息暂未提供。