把参考图变成能拆解的 3D 机械模拟器
根据参考图制作 3D 机械模拟器,拆开部件观察内部结构。teardown 用 Three.js 让部件运动与仪表读数同步,通过自动导览展示场景,还能将同一场景逐帧导出为视频。
可用于 Claude Code
前置要求
- Node.js >= 22.20.0
- Chromium
概览
你会得到什么
- 用 Three.js 制作的机械场景,包含交互视角、剖切、部件拆解,以及由模型状态驱动的仪表。
- 交互页面与逐帧视频共用的自动导览,以及用 Python 生成配乐和音效的脚本。
- 三台自带机械示例:V8 发动机、Cessna 337 起落架和 Strandbeest,各有交互页面与影片版本。
适用场景
- 通过可观察、可操作的部件,解释机械结构和运动关系。
- 用同一套场景制作机械交互演示和讲解短片。
教程
从外观图看到机器内部
一张照片能展示机器外观,却很难说明动力怎样传到每个部件。teardown 让 AI 用 Three.js 编写三维机械场景,加入拆解、剖切、仪表和可操作的运动过程,再把同一场景拍成短片。
先看上方作者的 Mellis HB-7 蜂形机器人演示,留意:
- 机身分层打开时,内部零件怎样保持相对位置。
- 部件运动时,周围哪些仪表和状态标签跟着变化。
- 镜头怎样从整体转向局部,再回到完整机器。
下面先打开仓库自带的 Cessna 337 起落架,再用自己的参考图组织一份制作需求。
和站内图解技能怎么选
| 技能 | 更适合的任务 |
|---|---|
| teardown | 用 Three.js 制作可拆解的机械模拟器,让交互页面和视频共用模型与导览。 |
| Colorfigures | 把生活机器画成能旋转、透视和操作的彩色三维手绘图。 |
| Anatomy | 用等距机械图解解释技术概念,输出 SVG、HTML 或 React 组件。 |
安装并操作起落架示例
下面使用 Claude Code、macOS 或 Linux 终端,以及 Node.js 22.20.0 或以上版本。工具包本身要求 Node.js 20+;这里的较高版本用于当前 skills 安装器。视频导出阶段还需要 FFmpeg 和 Python 3。
- 在准备存放练习的目录打开终端,安装完整技能包:
npx skills add elvarofficial/teardown -g -a claude-code
- 将
TEARDOWN_DIR指向安装结果中包含SKILL.md和package.json的目录。默认位置如下;若安装器显示其他路径,请替换。随后安装依赖和 Chromium:
TEARDOWN_DIR="$HOME/.claude/skills/teardown"
(cd "$TEARDOWN_DIR" && npm install && npx playwright install chromium)
保留技能包的 sims/、sfx/、构建脚本和包文件,后面的构建与录制会用到它们。
- 重启 Claude Code,让它加载
teardown。回到同一个终端,构建练习页面:
mkdir -p teardown-practice
cd teardown-practice
node "$TEARDOWN_DIR/sims/build.mjs" cessna-live
-
在浏览器打开练习目录中的
teardown-out/dist/cessna-live.html,依次尝试:- 点击
TAKEOFF(起飞)和LANDING(着陆),观察起落架收起和放下。 - 切到
GEARBOX(齿轮箱)视角,打开LABELS,再启动一次运动。 - 切换
SECTION(剖切)、X-RAY PLATE(透视)和EXPLODED(拆解),比较同一机构的不同呈现。
- 点击
页面初始播放自动导览;点击控件即可接管,停止操作 25 秒后恢复导览。横屏更适合观察整套仪表。
把参考图整理成运动方案
为自己的机器准备整体图、内部结构图和已知尺寸。先选一个能解释主要原理的动作,例如手压气泵的活塞往复。
给 AI 的资料可以整理成四项:
- 部件:外壳、输入部件、传动机构和工作部件。
- 连接与尺寸:哪些部件相连,尺寸来自哪里,哪些还需要补充。
- 驱动量:选择一个控制运动的量,如曲柄角度、活塞行程或操作进度。
- 观察结果:部件位置、阀门状态、转速或其他需要解释的读数。
在 Claude Code 中打开 teardown-practice,附上参考图,填写方括号后发送。以下请求由本站编写:
使用 teardown,根据附件制作 [机械名称] 的交互式 3D 模拟器。
目标读者:[给谁看]。解释重点:[一个机械原理]。
参考资料:[图片、说明书与已知尺寸]。
主要部件及连接:[已知结构]。
驱动量:[例如活塞行程];一次完整动作先设为 4 秒。
操作:[启动、暂停、拖动进度]。
需要看到的反馈:[部件运动、状态与读数]。
先核对机构关系和尺寸,列出还需补充的资料,给出模型与运动方案,等我确认后再写代码。
检查方案时,沿动力传递方向看一遍:输入怎样运动,带动哪些部件,最终产生什么可见结果。确认后,再让 AI 制作页面。
加入拆解和导览,再修改一次节奏
继续向 Claude Code 发送:
按已确认方案制作,源码和输出都放在当前练习目录。
使用已安装 teardown 的配套代码和构建脚本,交付可在浏览器打开的页面。
增加整体、传动机构和工作部件三个视角,以及剖切、拆解和标签开关。
让几何位置、仪表和图表读取同一份运动状态。
编排一次“看整体—运行—看内部—拆解—复原”的自动导览。
观众操作时暂停导览,停止操作一段时间后恢复导览。
用浏览器检查完整动作和多个视角,交付页面路径、源码入口及构建命令。
打开成品,暂停在动作中间,切换剖切和拆解。观察标签是否仍指向对应部件,仪表是否与当前运动状态一致。
接着只改变演示节奏:
把一次完整动作从 4 秒放慢到 6 秒,保留造型、视角和控件。
同步调整部件运动、相关读数和导览事件;有转速或流量读数时,按新的运动速度重新计算。
重新构建页面,检查开始、中间和结束三个时刻,返回文件路径。
修改后,同一操作进度应展示同一机构位置,只是到达该位置更慢。这个检查方法也适用于其他机器:先核对状态,再核对时间。
把同一导览导出为短片
先用自带起落架练习录制。在上面的同一个终端、teardown-practice 目录执行;新开终端时,先重新设置 TEARDOWN_DIR。
先检查画面,再录全片
- 构建影片版本,并抽取六个时刻组成检查图:
node "$TEARDOWN_DIR/sims/build.mjs" cessna-film
node "$TEARDOWN_DIR/sims/capture.mjs" cessna-film \
--size 1600x900 --dpr 0.5 \
--stills 0,4,8,12,17,24 --cols 3 \
--out teardown-out/cessna-check.png
- 打开
teardown-out/cessna-check.png,检查整体、局部和拆解画面是否完整。再导出两秒预览,确认录制可用:
node "$TEARDOWN_DIR/sims/capture.mjs" cessna-film \
--size 1600x900 --dpr 0.5 --from 0 --to 2 --fps 30 \
--out teardown-out/cessna-preview.mp4
- 预览正常后,导出完整无声视频:
node "$TEARDOWN_DIR/sims/capture.mjs" cessna-film \
--size 1600x900 --dpr 1.2 \
--out teardown-out/cessna-silent.mp4
这里用 1600×900 的布局乘以 1.2,得到 1920×1080 视频;默认 60 fps。录制器逐帧调用场景时间,不依赖桌面实时录屏。
按导览时间配乐
继续执行以下命令,用 Python 生成起落架示例的配乐,再用 FFmpeg 合并:
python3 "$TEARDOWN_DIR/run_sfx.py" "$TEARDOWN_DIR/sims/cessna-shared/score.py"
ffmpeg -y -i teardown-out/cessna-silent.mp4 \
-i teardown-out/cessna-score.wav \
-map 0:v -map 1:a -c:v copy -c:a aac -b:a 256k \
-shortest -movflags +faststart teardown-out/cessna.mp4
打开 teardown-out/cessna.mp4,对照拆解、切换视角和起落架动作,听音效是否落在相应时刻。
换成自己的机器时,将下面的请求发给 AI:
为当前模型制作影片入口,复用交互版的模型和导览。
先出关键帧检查图与两秒低分辨率预览,确认后再导出全片。
编写代码,按导览事件生成配乐和音效。若修改时长或事件,同步更新影片脚本、时间线与配乐中的事件时间。
交付源码、交互页面、最终视频,以及在当前项目运行的构建、捕获、配乐和合并命令。
需要在线分享交互版时,再让 AI 将构建后的页面及其资源部署到静态网站;只分享视频时,使用最终的 MP4。