anidoodle
完全由代码绘制的图片、电影和交互式作品。一个纯函数绘制每一帧;另一个纯函数合成每一个音频样本。同一个源代码可以在任何机器、任何尺寸、任何时长下重建相同的像素和相同的声音。
引擎只是容易的一半。作品被丢弃是因为它没有意义,因为主题只是自身的图标,因为风格只是调色板的替换,因为音乐没有形式,或者因为创作者在审批片段时耗尽了耐心。这个技能承载了能够避免上述所有问题的工艺。
从提问开始,再构建
阅读 references/workflows/start-here.md 并运行其中的引导流程:一次一个问题,只问请求中尚未明确的内容,先给出你的建议。他们在制作什么,采用哪种风格(展示画廊图片,https://github.com/alexgreensh/anidoodle/blob/main/skills/anidoodle/assets/styles.jpg;风格列表在 references/styles/INDEX.md),什么形状(1x1、9x16、16x9、4x5 或任意宽 x 高),多长(任意时长;绝不设上限),什么声音(静音或某种音乐风格和情绪),哪些角色。如果对方说“你选”,那就选定并用一句话说明理由。在开始绘制之前将答案写入一份简短的需求说明。
你在制作什么?
| 制作类型 | 阅读文档 |
|---|---|
| 静帧:英雄图、焦点图、封面、卡片、海报、系列作品 | 下面的静帧工作流程,references/formats.md |
| 一幅自我绘制的图画(延时摄影、制作过程) | references/workflows/drawing-process.md |
| 循环动画、贴纸、动态标志、氛围横幅 | 下面的循环动画工作流程,references/formats.md |
| 故事影片,任意时长 | 下面的影片工作流程,references/workflows/long-film.md |
| 解说视频或信息图 | references/workflows/explainer.md |
| 发布或产品视频(欢迎使用他们的截图) | references/workflows/launch-video.md;基于 references/workflows/launch-video-kit.md 构建 |
| 响应用户界面的交互式网页动画 | references/workflows/interactive.md |
| 绘画课程,或“这个怎么画?” | references/workflows/teach-drawing.md |
| 在任何风格中保持完全一致的角色(从木刻到积木) | references/workflows/character-consistency.md,references/anatomy.md |
| 根据用户提供的图片匹配风格 | references/workflows/adapt-a-style.md |
| 乐谱或配乐 | references/music/README.md |
- 音乐:为影片创作你自己的乐谱(
references/music/README.md);node tools/music.mjs check <score.ts#export>必须通过后才能让人聆听。 - 音效:
references/music/sound-design.md。14 种分层、基于种子的音效,由影片帧触发(filmSfx);配乐会进行闪避,并且每个音效提示必须在其 6 dB 范围内。音效仅在真实的转向变化处使用,每部影片一个上升效果 + 一个冲击效果。 - 发布影片:
launchTemplate.ts根据数据渲染产品发布:提示、为其绘制的图板、为其创作的乐谱、文字、安装说明;节省 token 的习惯见references/working-method.md。
七大定律
- 每件作品都有意义。 静帧:一个想法,一个焦点主体,一束光。影片:一次转变,一个回报,一个回归的 token。→
references/storytelling.md - 明确写实程度。 对于动物、物体和人物,都要明确解剖结构、视角以及你参考过的资料。→
references/realism-and-craft.md,references/anatomy.md - 风格是一种标记方式。 改变媒介、边缘和标记顺序,而不仅仅是调色板。→
references/styles.md - 先在一张静帧上验证外观,然后端到端构建。 之后,设置关卡弊大于利。→
references/working-method.md - 契约是绝对的。 纯函数
(frame, env)(交互式作品还包括输入日志),仅使用rng(seed),无时钟,无ctx.filter。不得生成或下载任何内容;用户带来的图片可以嵌入,并通过哈希固定。→references/determinism-and-contract.md - 音乐需要计划,而不是形容词。 一种风格,每段一种情绪,音符作为数据,然后是测量。你无法听到它,所以在上线前需要有一位人类聆听。→
references/music/ - 一人导演,一人构建,两人都要记录一切。 当工作进程退化时,重置;文件就是记忆。→
references/working-method.md
工作流程
静帧。 (1) 用一句话说明构思;指明焦点主体和光线。 (2) 为任何存在的事物打开真实参考,并注明。 (3) 选择风格并首先阅读其图板的头部说明。 (4) 按照该媒介的顺序进行绘制。 (5) 使用 still.mjs 以完整尺寸渲染,对局部区域(面部、手、脚、关节;references/craft-bar.md)执行细节检查,进行书面评审。✋ 一次审批。 (6) 从同一源代码交付所需的所有尺寸和形状,并注明 reproducible。
循环动画。 如同静帧,外加:每个运动在循环周期内是周期性的,主体从不停止,每秒都有变化。检查接缝(最后一帧与第 0 帧对比)。✋ 一次审批,基于运动文件。
影片。 (1) 三句话描述故事(设定、转变、回报)和核心 token;对于较长的影片,一个主干加上每章节一句话。如果写不出来,就停下。 (2) 网格:一个节拍的长度为 60 x fps / bpm 帧,bpm 来自需求说明的乐谱;一个提示表包含每个帧号,并在加载时由检查器运行。 (3) 真实参考:为任何存在的事物提供。 (4) 一张外观静帧,选择最难的一帧,进行书面评审。✋ 审批。 (5) 一段 8 秒的音乐样本。 ✋ 审批。 (6) 构建整部影片;持续运行机械检查。 (7) 从渲染文件审阅一次:每个节拍的缩略图接触表,每个剪辑作为一对,静音帧数。一个优先级排序的修复清单,一次重建。 (8) ✋ 最终审批。 说明你验证了什么以及你无法验证什么。
最多三个审批关卡。审批是预算;将其花在犯错代价高昂的地方。
工艺水准
标准:一位骄傲的人类插画师会发布这个作品,还是这仅仅是机械化的形状拼接?完整的识别表见 references/craft-bar.md。最容易导致作品失败的问题:由椭圆构成的主体,一种风格仅重新着色为另一种风格,淡入而非绘制的事物,关节僵硬的人物,以及角色在镜头间绘制不一致。
任何动态作品中不得有静默:每秒必须有可见变化。一部自我绘制的影片声明 kind: "drawing" 并以更精细的标准评判;完全冻结的画面会被判定为失败。
引擎
engine/ 是可移植的艺术核心加上工具集。engine/src/canvas-core 不依赖于 DOM 或任何后端。W、H、fps 和 durationFrames 来自影片的 meta。摄像机运动(平移、缩放、视差、抖动)来自 engine/src/canvas-core/camera.ts:references/camera.md。render.mjs --blur N 使用运动模糊渲染(每帧在线性光中平均 N 个子帧);默认路径保持不变。
node <skill>/engine/tools/scaffold.mjs ~/art --film intro --format 9x16 --duration 12 # 秒
cd ~/art && npm install && npx playwright-core install chromium
node tools/still.mjs intro --frame 0 --out out/look.png --scale 2 # 一张静帧,附带其哈希值
node tools/render.mjs intro # MP4;--out x.gif|x.webm|x.apng
node tools/gate.mjs intro # 确定性、契约、静音
node tools/emit.mjs intro --out out/intro.html # 一个自包含的离线播放器
| 工具 | 功能 |
|---|---|
scaffold.mjs | 创建包含静帧和/或影片的项目;--duration,--format 或 --size,--fps,--bpm |
still.mjs / render.mjs | 帧被绘制两次并计算哈希值(--frames a,b,c --sheet 在单个浏览器中)/ 以任何格式输出作品(--from/--to,--poster-frame,--hashes) |
gate.mjs | 检查确定性、契约、静音、伪影;--self-test 证明它能够检测到失败 |
registry.mjs / gallery.mjs | 直接从图板文件中提取的风格列表 / 画廊图片 |
docs-check.mjs | 当任何文档的风格数量、长度或路径与代码不一致时失败 |
verify-export.mjs | 对渲染文件的质量保证:帧数、时长、乐谱;可选检查首帧、循环接缝、--delivery |
test.mjs (npm test) | engine/test/ 中的单元测试套件,无需浏览器 |
music.mjs | 渲染并计量乐谱;check 进行门控(调性、主音量、保护、分轨、新颖性) |
sfx.mjs | 音效工具包:list、one、kit <dir>、test |
四个后端,一个艺术核心:playwright、html-player、remotion、hyperframes。
→ references/backends-and-adapters.md
工作示例
- 风格图板在
engine/src/canvas-core/中:每种风格都有一张静帧和一部展示其绘制过程的影片,头部包含配方,references/styles/<id>.md中有详细说明。 - 机械鳞翅目在
example/中:一部 47 秒的配乐影片。scaffold.mjs ~/study --example。
学习它们。不要复制它们。 工艺水准不能通过继承来满足。
诚实的局限
你无法听到乐谱,无法看到影片运动,也无法使用交互式作品。关于它们的任何声明都来自测量或人类反馈;请说明来源。一个绿色对勾只是声明,直到你重新运行它。在信任一张静帧之前,先以 --scale 2 渲染一帧:一个通过错误变换 blit 的图层在 1x 下看起来正确,但在 2x 下就会出错。