1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | teardown |
| 作者/维护者 | elvarofficial |
| 来源链接 | https://github.com/elvarofficial/teardown |
| 许可证 | MIT |
| GitHub Stars / Forks | 904 / 153(GitHub API,2026-11-02 读取) |
| 最新版本 | 无版本标签;主分支最近一次提交 2026-10-31 |
| 安装方式 | npx skills add elvarofficial/teardown -g -a claude-code,再在技能目录执行 npm install && npx playwright install chromium;需要 Node 20+ |
数据来源:上述数字取自 GitHub API;功能与评分依据来自仓库 README、SKILL.md 与示例。
2. 功能介绍与亮点
一句话:把一台机器做成一个可拆解的离线 3D 页面——中间是运转的机器,四周的仪表读的是同一套模型算出的真实数字,点一个按钮就拆开正在做功的那个部件。
- 模型驱动,不是动画:曲轴角、行程或风速作为唯一输入,所有姿态与读数都由它算出来,所以页面、影片与音效不会各跑各的。
- 可拆解:剖切、爆炸视图、相机视角、子系统按钮;没人操作时页面会自己巡游,一碰就交还控制权。
- 可录成片:同一套代码逐帧录成 60fps 视频,并按同一条时间线生成程序化配乐。
- 三个现成范本:十字曲轴 V8(含点火顺序与缸压曲线)、Cessna 337 主起落架收放、Theo Jansen 的 Strandbeest 二十条腿。
- 零依赖产物:生成的是一份约 800KB 的离线 HTML,不联网也能打开。
3. 适用场景
所属分类:前端与设计。
- 要把机械原理讲清楚的技术写作者与教育者;
- 做产品原理演示、内部培训材料的工程团队;
- 想给文档配一个「能动手拆」的 3D 图,而不是静态截图的开发者;
- 需要一条 60fps 讲解视频、又不想手工打关键帧的创作者。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 技能安装后用自然语言触发 |
| Codex | 需适配 | SKILL.md 是通用格式,安装与命令需按平台调整 |
| OpenClaw | 需适配 | 需要平台支持技能目录并允许执行 Node 脚本 |
| Hermes Agent | 未验证 | 未找到该平台的接入示例 |
5. 推荐理由
它把「解释一台机器怎么工作」从写文档变成造一个能拆的东西:部件怎么动、数字从哪来、拆开看哪一层,全在同一个模型里。对做技术讲解的人来说,这比静态插图多了一层说服力,也比纯动画少了「看起来对、其实算错」的风险。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 6 | 904 stars、153 forks;建仓三天接近千星,传播集中在技术演示与机械社区 |
| 可用性 | 7 | 一条命令安装,但首次要装 Playwright 内核;出片还需 ffmpeg 与 Python 3 |
| 安全性 | 8 | 见下方清单;本地 Node 构建与渲染,不联网、不需要凭据 |
安全性检查清单:
| 项 | 结果 |
|---|---|
| ① 执行 shell 与权限 | 仓库内 Node 脚本负责建模、构建与录屏,通过 Playwright 起 Chromium;作用域限于工作目录 |
| ② 联网外发 | 产物是离线 HTML;构建与录屏不访问外部服务 |
| ③ 凭据 | 不需要任何 API key 或账号 |
| ④ 可疑指令 | 未见注入或夹带推广;SKILL.md 以工程约束为主 |
| ⑤ 作者信誉 | 公开作者与仓库,示例完整;音效素材标注了 CC0 来源 |
| ⑥ License | MIT,且注明了借用组件的出处 |
| ⑦ 维护时间 | 2026-10-31 仍在更新 |
扣分点:首次安装要额外装浏览器内核;生成质量取决于机器模型是否被正确建模,复杂机构仍需人工校对。
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
| anatomy | 生成等距视角的机械插画(SVG/WebGL) | 产出是静态或轻交互的插图;teardown 产出可拆解、可操作的 3D 页面 |
| web-artifacts-builder | 生成通用的网页交互作品 | 不针对机械建模,也没有「同一模型驱动读数与影片」的约束 |
| remotion-best-practices | 用 Remotion 写代码做视频 | 绑定 Remotion 且偏视频;teardown 的产物首先是可交互页面,视频是附带 |
核心差异:它把「建模、驱动、读数、拆解、录片」压进同一份代码,别的技能通常只覆盖其中一段。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价,仓库 issues 为空(2026-11-02)。
9. 其他补充
- 三个示例都带 live / film / shared 三套文件,可以直接复制最接近的一个改。
- 录屏、音效与审片规则借用了 claude-motion 等项目,出处写在文档里。
- 生成的页面约 800KB,适合离线分发,不适合直接嵌进内容管理系统。
10. 安装使用方式
npx skills add elvarofficial/teardown -g -a claude-code
# 然后在技能目录里执行一次
npm install && npx playwright install chromium
装好后直接用自然语言描述,例如「做一个四冲程摩托发动机的可拆解模拟器」「液压挖掘机臂的拆解,并录 20 秒视频」。
11. 注意事项
- 需要 Node 20+;视频要 ffmpeg,配乐要 Python 3(只用标准库)。
- 首次安装会下载 Chromium,占用几百 MB。
- 复杂机构需要你提供真实尺寸与运动关系,否则模型只是好看。
- 产物是离线 HTML,交互性强但不适合直接放进普通文章页。