AI Studio 与讲义
网站自带两个 AI 辅助编辑器和一种面向文章的播放模式。它们和网站其它部分使用同一个 wanim 运行时。
想让外部模型写场景？
这些文档是写给人看的。如果你想让 ChatGPT、Claude、本地模型或其它代码生成器编写 wanim 场景，把
https://wanim.org/LLM.txt 交给它。那个文件是完整、自包含的参考：支持的子集、
InteractiveScene、控件、播放模式和分享 API。
AI Studio
打开 Studio 编辑单个动画：
- 在对话框里描述修改。助手会返回一句摘要和针对当前文件的 unified diff；预览从第一个改动片段重新运行。
- 如果新场景编译或运行失败，Studio 会把错误发回去，自动让模型修复（最多两次）。
- 如果 diff 无法应用，助手会带着错误重试，并可以回退到完整文件。
- 播放器提供 默认 / 双视图 / 幻灯片 三种节奏。模式由宿主控制，不会改动你的 Python 源码。双视图是文章模式：动画循环播放，双击画布进入可操作的蓝图。
- 分享会生成一个链接，在演练场中打开同一个场景。
two-view 模式
two-view 是讲义和文章嵌入使用的模式。它有两个状态：
- 动画从
construct()循环播放（交互场景则从蓝图的初始值开始）。 - 双击画布进入实时蓝图。读者可以拖动滑块、拖动点、按播放；动画会从当前状态重新开始。
为这两个状态写场景：blueprint() 构建控件和画面，construct() 是值得循环观看的短动画。SEPARATE = True
会让循环只播放 construct()，交互视图只显示 blueprint()。
讲义
打开讲义 Studio 编写包含多个场景的长文：
- 编辑器是 Markdown。标记为
wanim的围栏代码块会被编译并就地预览；前后照常写正文和公式。 - 每个代码块有独立的 AI 对话。助手只改这个块的代码，不影响讲义其它部分。
- 讲义里的每个 wanim 块都以 two-view 模式播放。
- 草稿保存在当前浏览器。发布时会创建只读的 KV 副本和一个编辑令牌；公开页面是
https://wanim.org/notes?show=<id>。编辑器保存着令牌，所以另一个浏览器看到的是分叉副本，而不是原文。 - 可以把整份讲义或当前文章导出为 Markdown，带或不带媒体。
应该用哪个页面？
| 需求 | 页面 |
|---|---|
| 单个动画，交互或非交互 | Studio |
| 问一个想法，得到讲解和实时场景 | Chat |
| 包含多个动画的讲义或文章 | 讲义 |
| 嵌入已完成的场景 | 演练场 或使用 wanim |