用途
Papercut Explainer 是一个将链接转化为风格化短视频的端到端工作流。它生成的视频看起来像分层手工纸复活：带颗粒感的纸质道具、投影、刚性剪裁动画、慢速推镜与定格纸面抖动，每个节拍有一条胶带横幅和一个逐词撕纸字幕标签。
目标输出是约 20-45 秒的竖屏（9:16）解释视频，默认时长 22-30 秒。
主要能力
每个节拍运行三条轨道：
- 画外音讲故事；
- 胶带横幅补充画外音省略的硬事实；
- 一套新的纸质布景图解画外音的内容，并用粗略的剪纸重建产品 UI 进行演示。
工作流分为 9 个阶段：
- Strategy（策略）：读取 SERIES.md 和来源，写入 BRIEF 和 SERIES.md。
- Hook（钩子）：读取 BRIEF，写入 HOOK 块。
- Script（脚本）：读取 BRIEF 和 HOOK，写入 facts.md、script.json 和 staging table。
- Storyboard（分镜）：读取 script.json 和 STORYBOARD.md，写入 Camera/Cut table、场景块和 SFX 计划。
- Scaffold and plan（脚手架与计划）：读取 STORYBOARD.md，写入项目和 episode.json。
- Voice and timing（配音与计时）：读取 script.json，写入 voice.json、narration takes、captions.json 和 plan.json。
- Scenes, sound, render（场景、声音、渲染）：读取 plan.json 和 STORYBOARD.md，写入场景、cues.json 和 mp4。
- QA（质检）：读取静帧和 STORYBOARD.md，进行修复并输出交付摘要。
- After posting（发布后）：读取平台数据，写入 analytics 和库推广。
提供多种运行模式：
- Full reel：从想法到 mp4，阶段 1-8，发布后执行阶段 9；
- Script only：仅策略、钩子、脚本；
- Storyboard from existing script：需要脚本、事实和 HOOK 块；
- Style prompt for another tool：输出风格提示词；
- Fix or rebuild one scene：修复或重建单个场景。
使用方式
项目文件存放在系列目录中，包括 SERIES.md（可选：受众、声音、调色板、吉祥物、关键词日志）、voice.json（可选）、papercut-assets/（可选）、research/analytics/（可选）和 episodes/NN-slug/ 下的 research/facts.md、narration/script.json、papercut/episode.json、papercut/STORYBOARD.md。
工作流依赖库目录，通过 $PAPERCUT_LIB 环境变量或配置文件 ${XDG_CONFIG_HOME:-~/.config}/papercut-explainer/config.env 中的 PAPERCUT_LIB= 行解析，不得硬编码机器路径。阶段 1-4 不需要库。
安装模式：
- Minimal：仅技能（策略、钩子、脚本、分镜、风格提示词），不渲染。
- Standard：Minimal + 使用占位语音（静音或 macOS say）构建和渲染，静帧 QA、SFX 和背景音、完整 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。
适用场景
适合需要快速制作产品解释、仓库介绍、公告短视频的场景，尤其是希望采用剪纸/手工纸风格且无需真实拍摄的竖屏内容。
限制
- 示例中的产品、公司和数字均为虚构，应复用风格和叙事方式，而非示例内容。
- 风格规则位于 references/style-guide.md（第 2 节为 Style DNA）。
- 渲染仅在要求时执行，预览在 Remotion Studio 中进行。
- 策略笔记优先于风格笔记：22-30 秒，不使用新闻框架钩子。
- 是否支持具体收费、平台或价格暂未提供。
- 音色设置和吉祥物等可选内容暂未提供具体方法。