跳到主要内容
中文
← 技能
技能 · 代码仓库

把参考图变成能拆解的 3D 机械模拟器

根据参考图制作 3D 机械模拟器,拆开部件观察内部结构。teardown 用 Three.js 让部件运动与仪表读数同步,通过自动导览展示场景,还能将同一场景逐帧导出为视频。

@elvar_official teardown
  • 交互模拟
  • 技术图解
  • 交互
  • 机械模拟

可用于 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。

  1. 在准备存放练习的目录打开终端,安装完整技能包:
npx skills add elvarofficial/teardown -g -a claude-code
  1. 将 TEARDOWN_DIR 指向安装结果中包含 SKILL.md 和 package.json 的目录。默认位置如下;若安装器显示其他路径,请替换。随后安装依赖和 Chromium:
TEARDOWN_DIR="$HOME/.claude/skills/teardown"
(cd "$TEARDOWN_DIR" && npm install && npx playwright install chromium)

保留技能包的 sims/、sfx/、构建脚本和包文件,后面的构建与录制会用到它们。

  1. 重启 Claude Code,让它加载 teardown。回到同一个终端,构建练习页面:
mkdir -p teardown-practice
cd teardown-practice
node "$TEARDOWN_DIR/sims/build.mjs" cessna-live
  1. 在浏览器打开练习目录中的 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。

先检查画面,再录全片

  1. 构建影片版本,并抽取六个时刻组成检查图:
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
  1. 打开 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
  1. 预览正常后,导出完整无声视频:
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。