teardown README

项目的 README,来自 github.com/elvarofficial/teardown。合并为一个 markdown 文件:README.md。

teardown

A Claude Code skill that turns any machine into a 3D simulator you can take apart.

Ask how something works. Claude builds it as one offline HTML page: the machine runs in the middle, every panel around it reads the real numbers, a button opens the part doing the work, and when nobody touches it the page tours itself.

Mellis HB-7 robotic bee simulator

Telson SC-8 robotic scorpion Pelagos OC-8 robotic octopus
Telson SC-8 robotic scorpion Pelagos OC-8 robotic octopus

Install

npx skills add elvarofficial/teardown -g -a claude-code

Then, once, in the installed folder:

npm install && npx playwright install chromium

You need Node.js 20 or newer. For the video you also need ffmpeg, and for the sound Python 3.

Use

Ask Claude Code in plain words:

Build me a simulator of a 4-stroke motorcycle engine I can take apart.

How does a mechanical watch keep time? Show me as a simulator.

Make a teardown of a hydraulic excavator arm and record a 20-second video of it.

Or open one of the 3 examples first:

node sims/build.mjs v8-live          # teardown-out/dist/v8-live.html
node sims/build.mjs cessna-live
node sims/build.mjs strandbeest-live

What is inside

SKILL.md What Claude reads: how a machine is built, the rules that make it look right, the review loop.
sims/kit/ Runtime, stage, shader warm-up.
sims/v8-*, sims/cessna-*, sims/strandbeest-* 3 complete machines. -shared is the machine, -live the page you drive, -film the recorded tour.
sims/build.mjs Bundles a machine into one HTML file, three.js and fonts inlined.
sims/capture.mjs Renders the film frame by frame to a 60 fps mp4, or to review sheets of stills.
sfx/, run_sfx.py Procedural sound on the film's timeline, mastered to −14 LUFS.

Credits

Built on whaleyxbt/claude-motion (MIT): the runtime, frame capture, sound engine and review rules come from there. Recorded samples are CC0 from Freesound, prepared by Barty-Bart/motion-graphics; sources in sfx/samples/SOURCES.md.

MIT licence.

teardown (elvarofficial/teardown)

正在搜索数据库…

这是什么?一个 Claude Code 技能,可以把你描述的任何机械装置转换为交互式三维模拟器:这是一个可离线打开的单个 HTML 页面,机械装置位于中央,周围的面板显示真实数值,点击按钮即可打开正在工作的部件。
这是独立的模拟器应用,还是由 Claude Code 为我生成的东西?它是一个 Claude Code 技能,而不是独立应用。SKILL.md 教 Claude 如何构建机械模拟器,你提出需求时,Claude 会为你生成 HTML 页面。
我该如何在 Claude Code 中使用它?在项目文件夹中安装一次该技能,然后直接用日常语言让 Claude Code 构建模拟器即可,例如:“帮我做一个可以拆解的四冲程摩托车发动机模拟器。”
使用它需要先安装什么?构建模拟器页面需要 Node.js 20 或更高版本。生成视频还需要 ffmpeg,程序化生成声音则需要 Python 3。
每个模拟器都需要 ffmpeg 和 Python 吗?不需要。核心的离线 HTML 模拟器只需要 Node.js;ffmpeg 和 Python 仅用于可选的视频录制和程序化声音功能。
生成的模拟器页面实际能做什么?机械装置位于中央,周围的面板显示真实数值;点击按钮可以打开当前正在工作的部件;如果不进行任何操作,页面会自动进行导览演示。
开箱即用包含哪些示例机械?sims/ 目录中附带三套完整的机械示例:V8 发动机、Cessna 飞机和 Strandbeest 行走机构,每个示例都分为共享几何数据、可实时交互的页面以及录制的影片导览三部分。
这个项目基于什么构建?它基于 whaleyxbt/claude-motion(MIT 许可证)构建,该项目提供运行时、帧捕获、声音引擎和审核规则;three.js 和字体则内嵌打包进最终的 HTML 文件中。
能把模拟过程转换成视频吗?可以。capture.mjs 会逐帧将导览渲染为 60fps 的 MP4 视频(或静态截图的审阅图表),程序化声音使用 CC0 授权的 Freesound 音频素材,并将响度调整至 -14 LUFS。
大小
17.8 MB
星标
3.7K
更新
提交Oct 31
时长
19天
提交 · 90 天