mcpField
P
papercut-explainer

papercut-explainer

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

关于 papercut-explainer

papercut-explainer 是制作 20–45 秒竖屏纸艺风格解说视频的分阶段工作流，面向创作者和 Agent，涵盖调研、脚本、分镜、渲染与质检；安装模式决定可用阶段。

主要功能

  1. 01九阶段视频工作流
  2. 02调研与事实追踪
  3. 03口播、横幅和场景三轨
  4. 04基于 Remotion 渲染场景
  5. 05占位语音或 Qwen3-TTS 配音
  6. 06基于文件的可续接项目

适用场景

  1. 01根据产品来源规划解说视频
  2. 02为现有脚本制作分镜
  3. 03渲染并检查竖屏视频
  4. 04在不同阶段间续接制作

安装

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

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

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

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
asset-prompts.md
frame-breakdown.md
motion-principles.md
remotion-recipes.md
style-guide.md
style-prompt.md

详细介绍

Papercut 讲解视频

一段约 20-45 s 的竖屏讲解视频，呈现出分层构成的纸艺动画效果：带颗粒质感和投影的纸质道具、僵硬的剪纸动画、缓慢推进的镜头搭配定格动画式纸张抖动、每个节拍都有一条胶带粘贴的标题横幅，以及逐字出现的撕纸字幕标签。使用 Remotion、可选的 AI 生成纹理素材，以及任意 TTS 制作。

每个节拍都包含三条轨道：

  • 旁白讲述故事
  • 胶带粘贴的横幅补充旁白略过的硬性事实
  • 一套全新的纸艺布景呈现旁白内容，并用粗略剪纸风格重构的产品 UI 进行演示

复用风格和叙事方式，不要复用示例中的内容。示例中的所有产品、公司和数字均为虚构。风格规则见 references/style-guide.md（第 2 节是 Style DNA）。

前期检查

  • 素材库。 先读取 $PAPERCUT_LIB，否则读取 ${XDG_CONFIG_HOME:-~/.config}/papercut-explainer/config.env 中的 PAPERCUT_LIB= 行，再不然就询问一次。绝不硬编码机器路径。第 1 至 4 阶段不需要素材库。
  • 安装模式。 承诺某个阶段前先探测安装模式（见下方“安装模式”）。
  • 系列。 找到系列文件夹（其中包含 episodes/）。若存在 SERIES.md，请阅读。

运行模式（先询问）

  1. 完整视频：从创意到 mp4：执行第 1 至 8 阶段，发布后再执行第 9 阶段。
  2. 仅脚本：策略、钩子、脚本（在分镜表后停止）。
  3. 根据现有脚本制作分镜：papercut-storyboard。询问用户提供脚本、事实和 HOOK 区块。
  4. 为其他工具编写风格提示词：提供 references/style-prompt.md 中对应的区块，然后停止。
  5. 修复或重建某个场景：运行 papercut-build（场景步骤），然后运行 papercut-qa。

信息收集（只询问缺少的信息）

  • 来源：通常是一个链接（代码仓库、产品网站、公告）。其他信息都从中研究获取。
  • 视频要证实的核心主张和主题。
  • 角色定位：谁或什么执行工作，谁提供建议或批准。与用户确认，绝不臆造产品行为。
  • CTA 关键词以及观众会获得什么（交付物）。
  • 时长：默认 22-30 s。
  • 受众水平（取自 SERIES.md），以及任何强调色或吉祥物。

将答案写入 episodes/NN-slug/research/facts.md 顶部的 BRIEF 区块（格式见 papercut-strategy）。

阶段

#阶段技能读取写入
1策略papercut-strategySERIES.md、来源research/facts.md 中的 BRIEF、SERIES.md
2钩子papercut-hookBRIEFpapercut/STORYBOARD.md 顶部的 HOOK 区块
3脚本papercut-scriptBRIEF、HOOKresearch/facts.md、narration/script.json、STORYBOARD.md 中的分镜表
4分镜papercut-storyboardscript.json、STORYBOARD.mdSTORYBOARD.md 中的镜头/剪辑表、场景区块、音效计划
5脚手架与计划papercut-buildSTORYBOARD.md项目、episode.json
6配音与时间papercut-voicescript.json、voice/voice.jsonnarration/ 配音片段、public/vo/captions.json、src/plan.json
7场景、声音、渲染papercut-buildplan.json、STORYBOARD.mdsrc/scenes/*、tools/cues.json、out/*.mp4
8QApapercut-qa静帧、STORYBOARD.md修复、交付摘要
9发布后papercut-strategy（复盘）、papercut-build（采集）平台数据、项目research/analytics/、素材库晋级项

项目文件

工作流存放在文件中，而不是聊天记录里。每个阶段都会读取上述文件并写入自己的文件，因此新会话可以从任意阶段继续。

<series>/
  SERIES.md                  optional: audience, voice, palette, mascot, keyword log
  voice/voice.json           optional: voice settings (copy library/voice/voice.example.json)
  papercut-assets/           optional: overlay textures and props
  research/analytics/        optional: competitor studies and autopsies
  episodes/NN-slug/
    research/facts.md        BRIEF + facts with sources
    narration/script.json    [{"id": "l1_hook", "text": "..."}, ...]
    papercut/
      episode.json           scenes, banners, hook, gaps, bed, cuts
      STORYBOARD.md          HOOK, staging table, Camera/Cut table, scene blocks

素材库目录：library/papercut/CATALOG.md（每个组件包组件）和 library/audio/CATALOG.md（每个音效和背景音轨）。这些目录是自动生成的，因此全新检出时可能缺失或已过时。运行 python3 $PAPERCUT_LIB/tools/catalog.py 重新生成。Agent 读取目录，而不是组件包源文件。

优先复用，再编写：组件包组件、道具集或场景模板都胜过新绘制代码。按名称选择音效和背景音轨。

安装模式

  • Minimal（仅技能）：策略、钩子、脚本、分镜、风格提示词。不渲染。
  • Standard：Minimal + 使用占位语音（静音或 macOS say）进行构建和渲染，通过 library/tools/placeholder_vo.py 完成；还包括静帧 QA、音效和背景音轨，以及完整的 mp4。
  • Full：Standard + 本地 Qwen3-TTS 配音和根据真实音频生成的逐词定时字幕。

探测（只读）：

. "$(grep '^PAPERCUT_LIB=' "${XDG_CONFIG_HOME:-$HOME/.config}/papercut-explainer/config.env" | cut -d= -f2-)/env.sh"   # fills PAPERCUT_PY, QWEN_TTS_PY
node -v; ffmpeg -version | head -1
"$PAPERCUT_PY" -c 'import numpy, PIL, soundfile'
"$QWEN_TTS_PY" -c 'import qwen_tts'

前三行均通过表示已达到 Standard。qwen_tts 导入也通过则表示已达到 Full。如果某个阶段需要的内容超出当前安装所提供的范围，请用一行说明，运行 ./install.sh --doctor（从仓库根目录执行），然后交由 papercut-setup 处理，不要自行变通。可通过对已安装技能文件夹（位于 .claude/skills、.agents/skills、.config/opencode/skills 或其他运行环境的技能文件夹下）使用 readlink 查找根目录，也可以查看配置文件中的 PAPERCUT_HOME。

各阶段通用规则

  • 策略说明优先于风格说明：时长为 22-30 秒，不使用新闻风格的钩子。
  • 使用 Agent 一次并行处理相互独立的工作（场景组、背景和道具、重新渲染）。
  • 仅在收到要求时渲染。在 Remotion Studio 中预览。

共享参考资料

  • references/style-guide.md：风格 DNA、剪纸绘制、调色板、字体、纹理、镜头和抖动、运动时长、字幕、声音。
  • references/style-prompt.md：适用于其他 Agent 和生成器的通用提示词。
  • references/motion-principles.md：动画 12 条原则与组件包组件和辅助工具的对应关系，并注明各阶段的使用方式。
  • references/remotion-recipes.md：Remotion 组件示例，在没有素材库时使用。
  • references/asset-prompts.md：哪些内容应生成，哪些应通过代码构建，并附有提示词模板。
  • references/frame-breakdown.md：一个约 28 秒、以 0.2 秒为间隔的完整示例。借鉴其事件密度，不要照搬内容。

交接

制作完整短片时从阶段 1 开始，或从运行模式指定的阶段开始。完成信息收集后，运行 papercut-strategy；它会读取 SERIES.md 和 BRIEF，然后交接给 papercut-hook。每个阶段技能都会指定下一个技能。

评论

支持 Markdown