Communitygithub.com

Pulupulu 动态成片

把动态影片写成 HTML 加 GSAP 时间线,用无头 Chrome 逐帧截图,再用 ffmpeg 混上旁白和音乐。

Pulupulu 动态成片 是什么?

先确认本机有 Node、ffmpeg 和 pulupulu 命令行,再做扁平矢量、文字、图表和地图。真人的脸、对口型和连续的身体动作不接,并会直接说明。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Alucard0x1/pulupulu-motion/tree/HEAD

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

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. 工作流程,按顺序

一个节拍 = 一句话 = 一个镜头。时间来自测量的语音,而非凭空创造。

  1. 简报。 主题、受众、平台、语言,以及是否有旁白。如果缺少主题,请询问;当被要求制作视频时,不要询问是否要添加旁白。
  2. 先做故事板,后写HTML — references/narration-and-captions.md。字幕是逐字的口语单词,而非其摘要。
  3. 旁白和测量。 python scripts/deepseek_voice.py beats beats.json film/assets/voice.wav --voice stella --timeline timeline.json,然后使用gate通过ASR检查每个短语。路由、语音和限制:references/narration/deepseek-tts.md。
  4. 根据timeline.json构建页面,而非故事板。契约:references/cli.md。 当故事需要任何图标库中都没有的对象时,首先将它们生成为打印面板 — references/generated-assets.md — 然后进行组装;永远不要手绘照片的替代品。
  5. 检查,然后查看。 pulupulu check .,然后 pulupulu still . --at 2,12,24 --out .om/stills 并打开这些静态帧。通过check的页面仍可能渲染出空白。
  6. 渲染 — pulupulu render . --format mp4 --fps 30。卡顿、黑帧和错误时长:references/render-traps.md。
  7. 混合与封装,使用明确的流映射 — scripts/deliver_check.py --video out/film-vN.mp4 --audio assets/mix.wav --out out/final.mp4 在一次调用中同时完成封装和验证。手动配方和闪避链:references/workflow.md。
  8. 验证你要交付的文件,而非渲染器的最新输出:python scripts/deliver_check.py out/film.mp4 --timeline timeline.json。
  9. 带着诚实的警告交付:哪些是绘制的而非基于真实素材的,以及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.pyprobe · 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。

相关技能