Gertie 是做什么的?
Gertie 将您编写的一个小型场景文件转换为完成的动画,输出为 Lottie JSON 和动画 SVG。您决定绘制什么以及如何运动。Gertie 负责编译、检查和渲染。
此版本涵盖编写、编译、验证和质量检查场景,提供两种输出格式,并可导出到 GIF、APNG、WebP、WebM、ProRes、HEVC、MP4 和 .lottie 归档,或直接导出到带有平台限制的目标平台(Telegram、Discord、Slack、WhatsApp 等),以及从故事板构建带字幕、转场和音乐的多场景视频,并制作文本字符(ASCII)动画。在导出前请阅读 references/export.md,制作视频前阅读 references/video.md,制作 ASCII 动画前阅读 references/ascii.md。
规则
- 切勿手动编写 Lottie JSON。请编写场景文件并编译它。
- 切勿呈现未通过
qa且零错误的成果。 - 在编写第一个场景前,请阅读
references/scene.md。跳过此步骤的模型会发明不存在的字段。 - 如果用户提供了 SVG,请导入它而非重新绘制:阅读
references/import.md。 - 如果用户提供了 Lottie 文件,请阅读
references/lottie.md。不要手动重写。 - 如果用户提供了 PNG 或 JPEG 徽标、图标或扁平插图,请进行描摹:阅读
references/trace.md。如果是一幅有纹理的绘画或照片,且用户希望它有一点动态(如眨眼、头部倾斜、飘动的背景),请阅读references/cutout.md。 - 如果用户展示了一个视频或 GIF 并希望“像这样运动的东西”,请阅读
references/motion-reference.md。 - 如果用户想要一个包含多个场景(如开场、作品集、讲解、广告)且带字幕、转场或音乐的视频,请阅读
references/video.md。每个场景单独写一个文件,然后编写.story.json,并运行story。 - 如果用户想要 ASCII 或文本字符动画(README 横幅、终端加载动画、复古风格、密集色彩丰富的字符或点阵片段),或展示了一个 ASCII 片段来模仿,请阅读
references/ascii.md。这是一个独立的引擎,有自己的场景文件(.ascii.json)和命令。简单主题:在文本文件中编写帧或生成它们。密集或流畅的东西:构建一个矢量场景,通过qa,然后将其作为配方进行转换。多个移动物体:使用图层。要模仿一个片段:使用ascii probe获取其网格和颜色。切勿用字符绘制大图形。 - 在绘制超出几个形状(如角色、插图、场景)的任何内容之前,请阅读
references/artwork.md:构建顺序、曲线路径、着色、调色板、画布大小。仅由基本图形或纯色构成的场景会引发W-ART-PRIMITIVE和W-ART-FLAT警告。 - 在编写超出简单旋转或滑动的任何内容的关键帧之前,请阅读
references/motion.md,并且对于角色,始终阅读。使用运动预设和骨骼预设而非手动放置的关键帧:它们能为动画提供缓动、预期、过冲和挤压效果。
工作流程
-
理解需求。 确定主题、运动、尺寸以及是否循环。仅当缺少答案会改变结果时才提问。否则使用默认值:512×512 画布、30 fps、2 秒、循环、透明背景。
-
编写场景 为
<name>.gertie.json。如果用户提供了 SVG,请先运行node scripts/gertie.mjs import <file.svg> --json并包含结果(参见references/import.md)。时间以秒为单位。后面的节点绘制在前面的节点之上。在合适的地方为物体指定motion预设。对于角色,构建骨骼并使用骨骼预设(references/motion.md)。 -
检查它。 在此技能文件夹内运行脚本
scripts/gertie.mjs:node scripts/gertie.mjs qa <name>.gertie.json --json这将编译场景、验证输出、在浏览器中渲染采样帧并运行渲染检查。文件输出到场景旁边的
out/目录:<name>.lottie.json、<name>.svg和<name>.sheet.png。该检查分别渲染 Lottie 和 SVG 并逐帧比较。 -
修复每个诊断结果。 每个诊断结果包含一个
code、指向场景中位置的path、一条message和一个fix。应用修复,编辑场景,然后再次运行qa。先修复错误,然后阅读警告。W-LOOP-JUMP和W-R-LOOP表示循环明显跳跃;W-R-CLIPPED表示某些内容被画布边缘裁剪。W-SYNC表示某个组的三个或更多子元素以相同的相位同步运行相同的循环,看起来机械:请为该组指定一个带phase的stagger,或为每个条目指定自己的phase。E-R-PARITY表示 Lottie 和 SVG 看起来不同,因此两个输出中有一个是错误的:它会指出帧、节点和差异图像(outputs.parity)。简化该节点的动画以查找原因,并告知用户是否是 Gertie 中的错误。 -
查看它。 打开在
outputs.sheet中命名的联系片图像。它按顺序显示八个帧,每个帧都标有帧编号和时间,绘制在棋盘格上以便透明度可见。检查是否正确的内容存在、颜色正确、帧之间的运动合理、没有任何内容被裁剪或重叠。如果不正确,请编辑场景并返回步骤 3。三次视觉修订后停止。在调试时序时,使用--sheet-frames 16以获取更多细节。 -
对照质量标准衡量 对于超出快速图标的任何内容。将场景的顶级 `