第 5 篇/共 11 篇
teardown 實測:把機器做成可拆解 3D 模擬
teardown 是給 Claude Code 用的開源 Skill,能把引擎、起落架、連桿機構做成可以拆開看的離線 3D 網頁,還能錄成 60 fps 影片配音效。MK 實際 clone 核對 repo 裡的真實數字,整理安裝前置、用法、限制與適合誰。
想搞懂 V8 引擎或飛機起落架怎麼動,光看文字永遠隔了一層?teardown 讓 Claude Code 把一台機器做成可以拆開、會自己導覽的 3D 網頁,還能直接錄成影片。 我把 repo 抓下來翻了一遍,還拿計算機把範例裡的齒輪、連桿數字對過一輪,下面跟大家分享。
teardown 是什麼?
teardown 是一個 Claude Code Skill,作者 elvarofficial,MIT 授權,2026-10-30 才剛上線。
圖說:teardown 的 GitHub 首頁。來源:elvarofficial/teardown,截圖於 2026-11-02。
它要解決的問題很直白:AI 講機械原理只能給你文字,零件之間怎麼互動,你得自己腦補。
裝了之後,你用白話說「做一個能拆開的四行程機車引擎模擬器」,Claude 就會照 SKILL.md 裡的做法:
- 做出一頁不用連網的 HTML:機器在中間運轉,旁邊的面板顯示真實數字。
- 每個子系統一顆按鈕,按下去就把正在出力的那個零件切開或透視給你看。
- 放著不動時,網頁會自己帶著游標導覽;你一點,它就把控制權交還給你。
- 同一份程式還能一格一格錄成 60 fps 影片,配上用 Python 合成、對準節拍的音效。
圖說:README 裡的機器蜜蜂示範,從動畫中取兩格。圖片來源:teardown 官方 README(授權 MIT)。
| 項目 | 數字 | 來源(查證日期 2026-11-02) |
|---|---|---|
| GitHub 星數 | 963 | GitHub API |
| 授權 | MIT | LICENSE |
| 建立日期 | 2026-10-30 | GitHub API |
| 最後提交 | 2026-10-31 | commits |
底層的執行框架、逐格錄影、音效引擎和檢查規則,是作者從 whaleyxbt/claude-motion(MIT)延伸來的;錄音素材則是 Freesound 上的 CC0 音效。
圖說:README 的機器蠍子示範。圖片來源:teardown 官方 README(授權 MIT)。
圖說:README 的機器章魚示範。圖片來源:teardown 官方 README(授權 MIT)。
這三個漂亮的動圖是作者用 teardown 做的展示品,不在 repo 的範例資料夾裡。真正附原始碼、可以自己建置的範例是 V8 引擎、塞斯納起落架和仿生獸三個。
實測:它說的「真實數字」是真的嗎?
這個 Skill 最大的賣點是「真實尺寸、同一個來源」:面板上每個數字,跟零件怎麼動,都來自同一個函式。所以我乾脆把三個範例的參數挖出來,自己手算一遍。
圖說:我從原始碼抄出來的參數和手算結果。來源:MK 實測,2026-11-02。
- 塞斯納 337 起落架(
cessna-shared/gear.js):32 齒、模數 4 mm 的小齒輪,節圓直徑 128 mm,轉半圈是 π × 128 ÷ 2 ≈ 201.06 mm,程式裡寫的齒條行程剛好是 0.201 m。對得上! - 十字曲軸 V8(
v8-shared/kin.js):缸徑 101.6 mm,點火順序 1-8-4-3-6-5-7-2,跟SKILL.md寫的一樣。 - Theo Jansen 仿生獸(
strandbeest-shared/jansen.js):用 Jansen 那組有名的連桿長度,用「兩個圓的交點」一個一個解出關節位置,整支檔案 67 行,跟SKILL.md說的「67 行連桿求解器」一致。
老實說,這次我先沒有把範例建成網頁、也沒錄影片,只做了原始碼和數字的核對。想親眼看 3D 效果的人,照下面的步驟裝好,跑一行 node sims/build.mjs v8-live 就能打開。
怎麼安裝?
先準備好:
- Node.js 20 以上。
- 要錄影片的話要有 ffmpeg,要配音效的話要有 Python 3(只用標準函式庫)。
圖說:README 的安裝與使用說明。來源:teardown README。
影片裡我說「一行指令就能裝好」,這裡更正一下:實際上是兩步。
第一步,安裝 Skill:
npx skills add elvarofficial/teardown -g -a claude-code
第二步,到裝好的資料夾裡跑一次:
npm install && npx playwright install chromium
第二步會下載一個 Chromium 瀏覽器(錄影用),檔案不小,第一次要等一下。
怎麼用?
直接用白話問 Claude Code,README 給的例子:
> 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.
用中文問也行,例如「做一個能拆開看的液壓挖土機手臂模擬器,錄 20 秒影片」。
圖說:repo 裡每個檔案負責什麼。來源:teardown README「What is inside」。
每個範例都拆成三個資料夾:-shared 是機器本體,-live 是可以操作的網頁,-film 是錄影用的導覽腳本。要做自己的機器,複製最接近的那個來改最快。
用之前要知道的事
- 一定要給參考資料:
SKILL.md第一條規則就是「從參考出發,不要憑想像」。只丟一句話,做出來的機器會很普通;給照片、剖面圖、規格,才會像真的。 - 很吃顯示卡:作者提醒,獨顯跑得到 60 fps 的頁面,在筆電內顯可能只剩 15 fps,所以範例內建了降畫質的分級。
- 錄影不是即時:
capture.mjs是一格一格算圖再壓成影片,機器越複雜越久。 - 會花不少額度:Claude 看不到影片,所以 Skill 要它一張張看截圖拼貼、反覆修正,來回很多次。
MK 觀點:適合誰、不適合誰
適合:
- 機械、物理、工程科系的老師,想做互動教材或短影片。
- 做科普的創作者,想要「把機器拆開給你看」的畫面。
- 熟 three.js 的前端工程師,可以把它當成一套結構很乾淨的範本。
不適合:
- 用沒有獨顯的舊筆電,或不想裝 Node.js、Chromium 的人。
- 想「一句話就生出精準模型」的人,沒有參考圖和尺寸,品質會打折。
- 需要算受力、流體的工程模擬,它是視覺化教學工具,不是 CAE 軟體。
我的看法:概念真的很酷,範例的數字也經得起我拿計算機驗;但想做出自己的機器,還是得準備資料、耐心來回修。
常見問題
Q:teardown 可以做任何機器嗎? 理論上可以,但品質看參考資料。Skill 明確要求先找照片、剖面圖和真實尺寸,憑一句話做的機器會很普通。
Q:做好的網頁能放到自己的網站嗎? 可以。輸出是單一 HTML,three.js 和字型都包在裡面;Skill 也建議單頁控制在 1 MB 內,社群分享時才抓得到預覽卡。
Q:錄影片一定要顯示卡嗎? 不一定,但很建議。錄影工具會顯示它用到哪張 GPU,如果是軟體算圖,速度會慢很多。
Q:可以商用嗎? 程式是 MIT 授權,可以商用;附的音效素材是 CC0。你自己做的機器,要注意參考圖片本身的版權。
延伸閱讀
- 同系列:answer-me-with-html 實測:答案變網頁
- 同系列:founder-skill 實測:AI 幫你審創業點子
- 同系列:anatomy 實測
- 背景知識:AI 怎麼同時看圖、聽聲音?
追蹤 MK,掌握最新 AI 工具應用
每週分享 GitHub 飆星實測、AI 工具教學與提示詞,短影片版都在社群。