---
name: process-animation
description: "Create or refine interactive 3D animations that explain a manufacturing process, laboratory protocol, assembly sequence, or device mechanism. Covers evidence, storyboarding, realistic scene construction, reversible playback, QA, and authorized publishing. Use for 工艺动画、制作流程三维演示 and scientific process explainers; not ordinary websites, motion logos, or standalone rendered images."
---

# 工艺三维动画

把真实过程转换成可探索的三维讲解：观众能看清材料如何变化、设备如何作用，以及这一步
为什么存在。代码、模型、标注与数据应指向同一条可核对的工艺路线。

## 选择当前工作范围

- **新动画**：按下述工作流从工艺证据进入分镜和实现。
- **改进现有动画**：先复用已有技术栈、模型与控制器，定位实际的科学、叙事、视觉或回放问题。
  不因本 skill 自带模板而迁移框架或重写已正常工作的页面。
- **抽象制作能力**：提取已重复出现的工序语义、采样、镜头及 UI，保留主题模型和参数；
  不把某个主题的材料、工序数量、色彩、源路径或发布凭据固定成通用规则。

用户没有指定的路线可选择代表性的一条，并尽早说明范围。只有路线、受众或交付形式的
歧义会实质改变工作时才提问；不为每个实现选择索取确认。

## 制作工作流

### 1. 定义对象和证据

先明确成品、起始材料、工艺路线、尺度、受众和交付方式。区分实验室器件、组件与工厂
整线；“完整”指这条明确路线从输入到验收的闭合，不指把所有可选技术塞进一条流程。
读 [工艺与分镜协议](references/production-protocol.md) 制作材料状态图和工序卡。
涉及真实科学或工程条件时查阅原始研究 Methods、厂商技术资料或官方标准；为关键条件
绑定出处，保留未知项。证据不足时用定性解释或明确的示意值，不补造“典型参数”。

### 2. 把流程变成可见动作

每步说明输入 → 动作 → 可观察变化 → 输出，并与下一步或支线对齐。
选择设备全景、工艺剖面或机理放大中最能解释该步的视角。按讲解需要拆章，
不固定十章、十二章或每章相同时长。
为每章规划准备、作用和完成的可见状态，以及各状态间的镜头和节奏。
讲解文本、参数和三维状态共用同一进度来源。

### 3. 建立可信的视觉表达

读 [真实感与科学表达](references/realism.md)。先校正材料尺度、接触关系、运动约束与
作用方向，再处理倒角、表面、灯光和后处理。实体外壳、剖切面和示意粒子各有明确语义。
画面里可见的“光路”“电路”“液体流动”必须符合所选器件和设备的工作关系。
不把纳米薄膜画成厚积木并称其为实物比例，不把装饰性发光当作真实热辐射或等离子体。

### 4. 实现可回放场景

读 [场景与回放约定](references/scene-authoring.md)。复用项目现有实现；需要一个新静态
起点时，可运行：

```bash
python3 <skill-dir>/scripts/animation_tool.py scaffold ./my-animation \
  --title "新的工艺动画" --vendor-dir /path/to/compatible/vendor
```

模板使用 Three.js r147 的全局脚本接口，依赖十个相配的本地 JS 文件，**不包含第三方
库本身**。这是可复现的起点，不是对其他项目的版本要求；不要为套用模板降级现有工程。
没有兼容 bundle 时，按目标版本从官方发布获取依赖并保留许可，或沿用已有构建链。
模板中的三步薄膜示例为虚构教学内容，必须改写为实际任务，不把它包装成真实配方。

### 5. 验收并修正

按 [验证与交付](references/validation-publishing.md) 逐章取样、回拖、重入、暂停并检查
真实浏览器画面。检查材料是否贯穿前后章节，显微解释是否误导尺度，以及末端状态是否
真正完成。语法通过、首屏可见和上传成功分别是不同证据。

```bash
python3 <skill-dir>/scripts/animation_tool.py validate ./my-animation --node-check
```

工具检查工艺数据、材料来源关系、阶段边界、资源引用和脚本语法；它不会认证科学正确性
或代替视觉检查。已有项目不使用模板协议时，按其实际接口验收，不伪造协议文件求通过。
此时可用 `validate <site-root> --resources-only --manifest publish.json --node-check`，
只验证资源和语法；工序与回放仍需按项目接口另验。

需要输出 MP4、自动讲解镜头或拆解视频时，读 [视频分镜与逐帧输出](references/film-authoring.md)。
它补充参考图对齐、独立机理模型、可采样的导演时间线、关键帧拼图和编码后验收。
现有 starter 只提供交互页面，不把“能录屏”当作已经实现确定性视频导出。

### 6. 交付或发布

默认完成用户要求的交付，不因使用本 skill 自动发布。已授权的发布继续完成，不重复索取
已给出的许可。选择实际托管方；若使用 W-Drop，遵循其现有 publish skill 和所有者上下文，
原位更新指定站点。没有该技能时检查托管方官方 API，不猜测接口。
先按精确文件白名单打包，排除凭据与私有工作文件：

```bash
python3 <skill-dir>/scripts/animation_tool.py package ./my-animation \
  --manifest publish.json --output /tmp/my-animation.zip
```

发布后检查公开入口、两级以上相对资源、CSP 和浏览器交互，返回实际验证的网址及限制。
用户明确要求分享 skill 时可打包本 skill；运行模板的发布白名单不自动包含 skill 源码。

## 经验与质量依据

制作新主题或评估协议是否通用时读 [案例与常见失真](references/cases.md)。它说明 RFID
和钙钛矿案例暴露的实际问题，不要求所有主题沿用相同外观或物理对象。
复杂修改优先用代表性场景试跑，再铺开；只根据观察到的问题收紧规则。