riso-windowseat

项目简介

riso-windowseat 是一个由 Claude Code 驱动的 Riso 印刷风格动画仓库，作者通过自然语言指令让 AI 编程助手编写代码，生成一系列完全由代码渲染的实验性动画短片。每一部短片的每一个像素和每一段声音都是程序生成的——无图片素材、无外部字体、无网络请求，仅靠一个 index.html 中的 Canvas 2D 和 Web Audio 实现。仓库最初作为《Window Seat》一片的发布载体，随后衍生出一个可复用的 AI 编程工作流和工具包，后续五部短片均以此为基础制作。

核心亮点

• 零素材纯代码动画：所有画面由 Canvas 2D 绘制指令生成，贴片图像、字体、音频文件均不参与；每帧都是时间的纯函数，seek(t) 可精确定位到任意时刻
• AI 编程工作流：作者负责创意方向和影片设计，Claude Code 负责代码实现，完整的 SKILL.md + 规则文档 + 验证工具链支撑工作流运转
• Riso 印刷视觉风格：每部短片的视觉语言借鉴 Riso（Risograph）孔版印刷的质感——有限的色版、高对比的半色调、颗粒感叠印效果
• 程序化音频：配乐与音效均由代码合成（Web Audio API），乐谱与画面时间轴精确对齐，关键节点（如火车过隧道、烟火绽放）有独立的音效 cue
• 完整验证工具链：tools/ 目录下包含定格检查（contact sheet）、帧精度验证（1:1 crop）、响度分析（loudness sheet）等脚本，确保每一帧可审计

收录短片

Window Seat（78 秒）——夜间火车车窗视角，窗台水杯随加速倾斜，途经金色站台、运河城市、烟花湖面、星轨夜空，最后破晓上高架。配乐原创钢琴曲，六八拍，节奏与画面时间轴精确对齐。

Roost（70 秒）——黄昏时分椋鸟群飞的单镜头，鸟群以 2–3 像素墨点呈现，鸟群密度转化为 Riso 印刷的深浅色调；游隼冲过，鸟群俯冲入芦苇荡。弦乐配乐从画面事件读取时间 cue。

Held（70 秒）——一只纸风筝的线在山坡桩上磨损断裂，断线后飘过港湾城镇、被教堂风标短暂挂住、最终被帆船前支索接住，在暮色中重新升起。绳索物理模拟，配乐使用 CC0 mbira、竖琴、钟琴和弦乐。

Nonpareil（70 秒）——俯视纸 Riso 染色过程：颜料滴入染槽后被梳子和细齿拖成 Nonpareil 纹样，花形落在中央后被拉向边缘，一张纸滚过浴槽表面翻开，最终落在旁边镜面对称。染色为闭合几何，每帧精确；音符是手碟的敲击声。

技术架构

仓库结构分为 films/（6 部短片，各含 FILM.md 设计文档）、tools/（验证工具）、docs/（工艺文档：分镜、绘图、音效、声音质量标准）、studies/（交互式 A/B 研究）、.claude/skills/（riso-film、riso-still、riso-score 三个技能包）。

核心技能：

• riso-film：完整影片制作流程，从设计文档到帧验证到 MP4 导出
• riso-still：静态 Riso 风格海报生成
• riso-score：配乐生成，配乐 cue 从画面事件读取

所有工具均为无依赖的 Node.js + Python 脚本，FFmpeg 用于 MP4 编码。

应用场景

场景一：AI 编程能力展示 用自然语言指令让 Claude Code 从零开始生成一部完整动画短片，涵盖数学动画、物理模拟、视觉设计、配乐合成——是 AI 编程工具综合能力的可视化 Demo

场景二：Riso 印刷风格创作 无需印刷设备和专用油墨，即可用代码生成 Riso 风格的静态海报或动态影像，适合设计师和独立创作者快速产出视觉内容

场景三：程序化音频与视觉同步 影片的每一段配乐和音效 cue 都从画面事件中读取时间戳，展示了程序化音频与视觉时间轴精确对齐的工作方法，可作为音画同步编程的参考案例

场景四：AI 编程工作流教学 作者公开了完整的 FILM.md 设计文档、SKILL.md 工作流和 CLAUDE.md 会话契约，任何人可以在本地 Clone 仓库后用 Claude Code 复现或改编短片

适用人群

• 对 AI 编程工具（Claude Code、Codex 等）综合能力感兴趣，想看实际产出的开发者
• 独立动画创作者和视觉艺术家，寻找低门槛的 Riso 风格创作工具
• 对程序化音频（Web Audio API）音画同步实现感兴趣的音乐/技术交叉领域创作者
• 想学习如何用自然语言驱动 AI 完成复杂多模态任务的工程师和产品人

出品方

由独立开发者 sevenevesai（GitHub: sevenevesai/riso-windowseat）创建和维护，基于 Claude Code 实现，MIT 协议开源。部分音频素材使用 CC0 1.0 和 CC BY 3.0 协议（见各短片 AUDIO-SOURCES.md）。配套技能包见 .claude/skills/。

更新动态

仓库持续维护，当前 v1.0 Release 包含 Window Seat、Roost、Held、Nonpareil、Lumen 和 Emergence 六部短片的完整源码和 MP4。工具链持续更新以支持新的渲染验证需求。

官方链接

GitHub 仓库：https://github.com/sevenevesai/riso-windowseat 官网：https://seveneves.ai/riso/ MP4 下载（v1.0 Release）：https://github.com/sevenevesai/riso-windowseat/releases/tag/v1.0