Pulupulu 动态成片 是做什么的?
一部电影在这里是一个HTML时间线,由Chrome逐帧渲染。这里没有任何东西是视频编辑器:你编写一个页面,CLI以固定帧率截图,ffmpeg混入声音。
此文件是路由器。它回答:我是否可以执行此作业,我首先运行什么,什么必须通过,以及哪个页面包含详细信息。仅在你正在处理的部分加载参考页面。
1. 在承诺任何事情之前
python scripts/doctor.py # 只读:python, node, ffmpeg, CLI, 密钥, 磁盘
python scripts/doctor.py --project film/ # 同时:页面契约存在
退出码1表示此机器上无法制作电影。不要在编写场景后发现这一点。永远不要每条命令都调用npx:每次check、still和render时的网络往返是此工作流中最常见的自造成的减速。
当故事需要它没有的素材、真人的面孔或肖像、复杂的人物或动物解剖结构、连续的物理动作或口型同步时,此工具是错误的选择。 它擅长渲染平面矢量几何、排版、图表、地图、图标和彩色编码对象,而其他方面则表现不佳。请如实说明,而不是生造一个近似物:为档案材料绘制替代品是溯源问题,而非风格选择。
2. 工作流程,按顺序
一个节拍 = 一句话 = 一个镜头。时间来自测量的语音,而非凭空创造。
- 简报。 主题、受众、平台、语言,以及是否有旁白。如果缺少主题,请询问;当被要求制作视频时,不要询问是否要添加旁白。
- 先做故事板,后写HTML —
references/narration-and-captions.md。字幕是逐字的口语单词,而非其摘要。 - 旁白和测量。
python scripts/deepseek_voice.py beats beats.json film/assets/voice.wav --voice stella --timeline timeline.json,然后使用gate通过ASR检查每个短语。路由、语音和限制:references/narration/deepseek-tts.md。 - 根据
timeline.json构建页面,而非故事板。契约:references/cli.md。 当故事需要任何图标库中都没有的对象时,首先将它们生成为打印面板 —references/generated-assets.md— 然后进行组装;永远不要手绘照片的替代品。 - 检查,然后查看。
pulupulu check .,然后pulupulu still . --at 2,12,24 --out .om/stills并打开这些静态帧。通过check的页面仍可能渲染出空白。 - 渲染 —
pulupulu render . --format mp4 --fps 30。卡顿、黑帧和错误时长:references/render-traps.md。 - 混合与封装,使用明确的流映射 —
scripts/deliver_check.py --video out/film-vN.mp4 --audio assets/mix.wav --out out/final.mp4在一次调用中同时完成封装和验证。手动配方和闪避链:references/workflow.md。 - 验证你要交付的文件,而非渲染器的最新输出:
python scripts/deliver_check.py out/film.mp4 --timeline timeline.json。 - 带着诚实的警告交付:哪些是绘制的而非基于真实素材的,以及QA说明中的内容。
3. 门控
只有这些会阻塞。其他任何工具打印的内容都是阅读笔记:用参数回答或修复它,但永远不要在其未通过时报告为已通过。
| 门控 | 命令 | 证明内容 | 如果失败 |
|---|---|---|---|
| 预检 | python scripts/doctor.py | 机器可以渲染 | 停止,报告缺少什么 |
| 组成 | pulupulu check . | 页面契约,无缺失文件 | 渲染前修复 |
| 语言 | python scripts/lang-audit.py film/index.html --lang en | 无其他语言的文本,包括<script>内的字符串字面量 | 翻译字面量,重新运行 |
| 语音 | python scripts/deepseek_voice.py gate beats.json --voice stella | 每个短语都能转录回其自身单词 | 重写短语;永远不要交付片段 |
| 文件 | python scripts/deliver_check.py out/film.mp4 --timeline timeline.json(或先使用--video/--audio/--out进行封装) | 帧尺寸、帧率、音频存在且足够长、真峰值、交付大小 | 重新封装或重新编码 |
| 弹跳帧 | pulupulu qa out/film.mp4 | 无单帧弹跳 | 找到那一帧的元素 |
pulupulu qa还会报告每秒运动量、静止 ≥ 1 秒和平坦开场。这些是基于96×54灰度比较的节奏判断,因此低对比度的缓慢移动可能被判定为静止。将它们用作查看的理由,而不是必须服从的裁决。
没有门控能够证明: 电影质量好、ASR听对了数字(作为标记检查数字和专有名词)、或者字幕位于平台UI不会遮挡的位置。
4. 导致渲染失败的陷阱
完整细节和修复方法请参见references/render-traps.md。以下会使渲染完全停止:
- 将原始的
<g>/<rect>/<path>写入<div>不会渲染任何内容,也不会发出警告。将每个场景片段包装在其自己的<svg viewBox>中。 - 内联SVG
<text>中的网络字体每次都会重新栅格化该层。将文本放在HTML中,或将其绘制为形状。 feTurbulence作为逐帧滤镜(无论是内联SVG还是CSS背景)会导致渲染器卡顿。将噪声烘焙到PNG图块中一次。- 对内联SVG进行全帧GSAP 缩放会重新栅格化基底;平移合成效果良好,位图层可以进行缩放。当无法推拉时,动画化小的内部组。
repeat: -1会使时间线无限:一部87秒的电影会无声地变成117秒。计算有限的圈数。- 渲染失败后,只杀死它留下的无头Chrome。
taskkill //IM chrome.exe会关闭用户自己的浏览器。
5. 详细内容的存放位置
| 正在处理的部分 | 页面 |
|---|---|
| 命令、页面契约、安装 | references/cli.md |
| 九个步骤、项目契约、封装 | references/workflow.md |
| 故事板、字幕、单语言门控 | references/narration-and-captions.md |
| 调色板、元素预算、个性、节奏 | references/design-taste.md |
| 运动语言、技术、3D层 | references/motion-library.md |
| 增强、产品演示、讲话者、语法 | references/workflows-specialized.md |
| 音乐世界、作曲家、音效、旁白合成 | references/audio-and-music.md、references/narration/deepseek-tts.md |
| 空白、卡顿或时长错误的渲染 | references/render-traps.md |
| 检查什么以及按什么顺序 | references/verification.md |
| 风格配方、镜头语言 | references/art-motion/INDEX.md |
| 获取图标和矢量、许可证 | references/asset-sourcing.md |
| 由图像模型生成的艺术、裁切打印、安装 | references/generated-assets.md |
| 平面矢量工艺、滚动世界 | references/2d-vector-motion.md |
| 此渲染器可以处理哪些主题 | references/topic-fit.md |
| 亚秒级的计时和缓动 | references/ui-motion/ |
| 发布此技能(一次提交,v1.0) | references/publishing-skills.md、references/publishing.md |
风格配方路径(scripts/art-motion/engine/)是20 MB的随附运行时,特意不在此仓库中:技能不应让每个agent都获取一个可能永远不会使用的引擎,并且37 MB的代码树无法被审阅。它将固定版本并经过校验和验证地安装,安装到上述页面引用的确切路径:
python scripts/install_art_motion.py --check # 它存在吗?
python scripts/install_art_motion.py # 核心:库 + 演示 + 场景,20 MB
python scripts/install_art_motion.py --with-reference-films # + 学习材料,再增加 14 MB
其他所有内容——Python门控、剪辑规格、文档——都在仓库中,无需安装。永远不要提交获取到的代码树:.gitignore已经覆盖了它。
6. 脚本
| 脚本 | 功能 |
|---|---|
scripts/doctor.py | 预检,只读 |
scripts/deepseek_voice.py | probe · speak · cost · lay · beats · asr · gate — 旁白及其测量后的时间线 |
scripts/deliver_check.py | 验证交付文件:尺寸、率、音频、峰值、时长与时间线的一致性 |
scripts/lang-audit.py | 对标记和脚本字面量的单语言门控 |
scripts/art-motion/icon_audit.py | 图标族、颜色计数、联系表 |
scripts/art-motion/qa.py | 对渲染文件进行节奏和弹跳帧启发式检查 |
scripts/stamp_credit.py | 向文本文件添加by Alucard0x1行 |
7. 与人协作
展示帧,而不是形容词。每个场景一个关键帧可以避免数周的错误工作。当他们纠正你时,将修正内容放入此技能中,而不是放入聊天回复中。
交接:旁白时序和韵律 → 技能 tts-intonation · 合并或翻译另一个库 → 技能 agent-skill-sourcing · 发布前的权利和肖像权 → 技能 media-content-safety · 获取参考视频 → 技能 streaming-mirror-extraction · 3D或基于素材的镜头 → 技能 headless-three-video-render 和 cinetic · 以排版为主的电影 → 技能 kinetic-typography。