mcpField
P
papercut-qa

papercut-qa

github.com/0xs4n4tg创意与媒体9951 次安装2 周前更新
代码仓库

关于 papercut-qa

papercut-qa 是用于检查 Papercut 视频静帧的技能，供制作人员逐场景及整条预览片核对视觉风格与分镜。它提供渲染联系表、检查清单和返修流程。

主要功能

  1. 01按时间点渲染静帧联系表
  2. 02依照风格指南和分镜检查画面
  3. 03核对纸张质感、字幕与动态
  4. 04检查旁白、字幕和事件同步
  5. 05列出占位素材并交接返修

适用场景

  1. 01制作过程中逐场景检查视觉效果
  2. 02最终渲染前检查整条预览片
  3. 03发现问题后返修场景并重新检查

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/0xs4n4tg/papercut-explainer --skill papercut-qa

安装后在 Claude Code 中输入/papercut-qa确认已加载。

详细介绍

Papercut QA

依据 Style DNA 和分镜检查静帧的风格，而非内容。制作过程中按场景检查一次，并在最终渲染前对整段影片检查一次。

预检

  • 安装：Standard 或 Full。静帧需要已搭建 Remotion 的项目；联系表需要安装了 numpy 和 Pillow 的 Python（$PAPERCUT_PY）。缺少依赖时，先运行 ./install.sh --doctor，再运行 papercut-setup。
  • 素材库：使用 $PAPERCUT_LIB；否则使用 ~/.config/papercut-explainer/config.env 中的 PAPERCUT_LIB= 行；若两者都没有，则询问一次。
  • 先阅读：../papercut-explainer/references/style-guide.md 第 2 节中的 Style DNA，以及背景图表 library/papercut/public/bg/backdrops/_sheet.jpg。每张图约消耗 0.7-1.5k 个 token，因此只打开当前步骤所需的内容。
  • 关于节奏密度，查看 ../papercut-explainer/references/frame-breakdown.md（末尾的 “Pacing stats”）：场景平均时长为 2.8 秒，每个场景有 2-4 个离散视觉事件；重读词上每 0.4-0.8 秒出现一个视觉事件；大约每 0.6 秒换一页新字幕。只复制节奏密度，不要复制内容。

1. 渲染静帧

在项目的 papercut/ 文件夹中运行：

$PAPERCUT_LIB/tools/qa.sh NAME FROM-TO NTH [SCALE=0.3] [COLS=9]
  • 每次检查使用 4-6 个时间戳。检查某个场景时，NTH 约为其帧数除以 4。检查整段影片时省略 FROM-TO，并调高 NTH。
  • 输出为 out/qa/NAME_0.jpg（范围较长时还会有 _1、_2），每张表最多包含 45 帧。阅读联系表；每张表保持较小。
  • 每个场景运行一条 QA 命令，绝不要同时进行两次渲染。每个场景最多修改两轮。
  • 对照分镜检查：场景的第 0 帧、关键事件是否出现在对应词语处、画面是否有裁切，以及是否有内容遮挡横幅或字幕区域。

2. 检查清单

  • 所有物体看起来都像纸制品：有纸张纹理、粗糙边缘、投影和叠纸阴影；没有轮廓线或渐变。
  • 世界摄像机移动流畅。只有横幅和标签会轻微地逐帧变化。
  • 横幅位置固定并用胶带粘贴，包含 3-7 个词，每条只传达一个事实，且绝不重复旁白。单看横幅也能读出一份事实清单。
  • 每个布景都呈现旁白句中的具体词语；数字是实体道具；CTA 前有一个回扣布景。
  • 每个数字和 UI 标签都能追溯到事实列表。脚本至少包含一项坦诚说明的局限，并且功能组合恰好有三项。
  • 字幕：每个词对应一个标签，倾斜，在词语开始时弹出；每页 1-3 个标签，位于 68-80% 区域，绝不出现在人脸上。
  • 只有角色、字幕和信号使用高饱和度。
  • 每个重读词都有一个视觉事件，同时始终保持环境动态。
  • 在横幅变化时切换画面（导览和新闻类的布景为 1.5-3 秒，隐喻段落最长 5 秒）；底部 20% 区域保持干净。
  • **HOOK 区块（SAY / WRITE / SHOW / ALIGN）必须完全按原文出现在屏幕上：**第 0 帧展示 SHOW 时刻的动作进行中，且画面上显示 WRITE 标题；第一句旁白是 SAY。
  • 每个场景都有摄像机移动，最多有一次翻页或撕纸；进入 CTA 时要有胶带拉动或鞭甩转场；每个转场都有对应的 SFX。
  • 画面中能看出幽默设计：全片只采用一种形式；每个点子都有一个服装道具；有一个受挫的节拍；第 0 帧的道具在 CTA 布景中以变化后的形态回归；每个笑点都能在 1 秒内看懂，且绝不遮挡横幅、字幕或关键数字。
  • 旁白和横幅中的词汇符合 SERIES.md 中的受众水平。
  • 旁白、字幕和事件同步（在 Studio 中逐个切点来回拖动检查）。

如果某项未通过，修复场景文件（或素材库中的工具包，绝不要修改项目中的 src/lib/），然后重新运行该场景。使用 papercut-build 重新构建场景。

3. 交付

打开 Studio 预览，列出场景及其时长，并说明哪些内容是占位内容：语音、音乐、SFX、素材。如果语音是占位内容，说明如何重新配音（papercut-voice）。发布后，将数据交给 papercut-strategy 进行复盘。

原则检查

以 5 fps 逐帧检查一个场景，并对照 ../papercut-explainer/references/motion-principles.md：每次大动作前都有预备动作（2），所有动作都有缓动（6），撞击后有物体拖尾（5），一个焦点道具（3），一个夸张的节拍（10），层叠阴影且阴影风格一致（11）。

交接

修复工作交回给 papercut-build（场景或声音）或 papercut-voice（同步）。通过检查后，短片就完成了：用户提出要求时，使用 $PAPERCUT_LIB/tools/render.sh 渲染。

评论

支持 Markdown