teardown

环境要求

• Node.js 20 或更新版本
• 可执行 npx 命令的终端环境
• 可选：ffmpeg（用于导出视频）
• 可选：Python 3（用于生成声音）

安装与启动步骤

1. 1确认 Node 版本

   先检查本机 Node.js 版本，低于 20 需先升级，否则后续安装与构建会失败。

   node -v

   复制

2. 2安装 teardown 技能

   用 npx 把该技能全局安装到 Claude Code，命令中的 -g 表示全局、-a 指定代理。

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

   复制

3. 3安装运行依赖

   进入技能安装后的文件夹，安装 npm 依赖并下载 Playwright 的 Chromium 浏览器。

   cd teardown
   npm install && npx playwright install chromium

   复制

4. 4检查可选工具

   需要导出视频时装 ffmpeg，需要声音时装 Python 3；可先查看是否已存在。

   ffmpeg -version
   python3 --version

   复制

5. 5构建自带示例

   先跑官方示例验证环境，产物输出到 teardown-out/dist/ 目录下的 HTML 文件。

   node sims/build.mjs v8-live

   复制

6. 6浏览器查看结果

   用浏览器直接打开生成的 HTML 文件；页面为离线单页，含交互拆解与自动播放演示。

7. 7用自然语言生成

   在 Claude Code 中用一句话描述想拆解的机器，例如四冲程摩托车发动机、机械表、挖掘机臂。

如何确认成功

命令执行完毕后能在 teardown-out/dist/ 下看到 v8-live.html，用浏览器打开可交互拆解即成功。

常见问题

注意事项

• 安装与构建过程需要联网下载 npm 包与 Chromium，请保证网络可正常访问包源。
• 生成的模拟器是离线 HTML 单页，构建后可直接用浏览器打开，无需额外服务。
• 可选依赖缺失不会阻断建模，只影响视频与声音输出。