elvarofficial/teardown

项目介绍

teardown 是一个 Claude Code 技能：你用日常语言描述一台机器，Claude 就会把它生成为一个独立的 HTML 页面，机器以交互式 3D 模型运行。模型四周的面板显示真实运行数据，按钮可以打开真正做功的部件，无人操作时页面会自动巡览。输出是单个离线文件，不需要服务器或网络即可打开。

项目附带三台完整示例机器（V8 发动机、Cessna 飞机、Strandbeest 行走结构），以及运行时套件、打包器、逐帧录制工具和程序化音效生成。它面向希望互动理解设备原理、且已经在用 Claude Code 的人；使用者不需要会 3D 建模或网页开发，但生成的页面由该技能基于 three.js 构建。

工作原理：SKILL.md 保存 Claude 读取的说明，包括机器如何搭建、让外观正确的规则和审阅循环；sims/kit/ 运行时提供舞台与着色器预热；sims/build.mjs 把运行时、three.js 和字体内联进一个 HTML 文件。

快速使用

前提：Node.js 20 或更新版本；录制视频需要 ffmpeg；音效流程需要 Python 3。

1. 为 Claude Code 全局安装该技能：

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

2. 在安装目录里一次性安装依赖：

npm install && npx playwright install chromium

3. 在 Claude Code 中用日常语言提出需求，例如：“Build me a simulator of a 4-stroke motorcycle engine I can take apart.” 也可以直接要求录制，例如：“Make a teardown of a hydraulic excavator arm and record a 20-second video of it.”

若想先看内置示例，在仓库根目录运行：

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

在浏览器中打开生成的 HTML 文件，即可操作机器并查看面板。视频录制由 sims/capture.mjs 完成，可逐帧渲染成 60 fps 的 mp4，或渲染成用于审阅的静帧图集。

使用约束

• 需要 Claude Code 和 Node.js 20+；交互结果是一个 HTML 页面，不是原生应用。
• 在技能能产出可用页面之前，必须完成一次性的 npm install 和 Playwright Chromium 下载。
• 导出视频需要 ffmpeg；音轨流程需要 Python 3，音频以 -14 LUFS 母带处理。
• 生成的 3D 页面依赖构建时内联的 three.js；页面可离线打开，但重新构建需要上述工具链。
• 采用 MIT 许可证。README 将运行时、逐帧捕获、音效引擎和审阅规则归功于 claude-motion（MIT）；录制样本为 Freesound 的 CC0 素材，由 motion-graphics 整理。

HotRepo 点评

项目创建不到一天就进入了 HotRepo 新项目榜。2026-10-31 的 JavaScript 榜快照记录 389 颗 Star，当日新增 244；2026-11-01 的全语言榜快照记录 716 颗 Star，约 24 小时内新增 546。2026-10-31 至 2026-11-01 的每小时 Star 采样从 105 持续升到 716，说明关注是持续而非一次性的。站内没有记录到 GitHub 日榜名次，也没有 Hacker News 讨论，因此没有可引用的具体名次或讨论证据。这种增长更适合理解为对一个演示性强的 Claude Code 技能的早期兴趣，而不是对生成模拟器实际效果的衡量。

项目源码与说明