You are currently viewing teardown biến Claude Code thành công cụ dựng simulator 3D tháo máy

teardown biến Claude Code thành công cụ dựng simulator 3D tháo máy

Nếu bạn từng hỏi một con AI “động cơ 4 thì hoạt động thế nào” và nhận về một đoạn văn dài, repo này làm khác hẳn. elvarofficial/teardown là một skill cho Claude Code: bạn mô tả một cái máy bằng lời, Claude dựng nó thành một trang HTML offline, máy chạy ở giữa, các panel xung quanh đọc số liệu thật, có nút mở từng bộ phận đang làm việc, và khi không ai chạm vào thì trang tự tour.

Nó làm gì, cụ thể

Không phải chatbot vẽ hình minh họa. Đầu ra là một file HTML duy nhất, nhúng sẵn three.js và font, chạy không cần mạng, không cần server. Mỗi machine trong repo có ba phiên bản: -shared là phần mô hình, -live là trang bạn điều khiển, -film là bản tour được ghi lại.

README có 3 ví dụ hoàn chỉnh: v8-live, cessna-live, strandbeest-live. Tức là động cơ V8, máy bay Cessna, và cái Strandbeest nổi tiếng của Theo Jansen. Bạn gõ một câu như “làm cho tôi simulator động cơ xe máy 4 thì có thể tháo ra”, Claude đọc SKILL.md (mô tả cách dựng máy, các quy tắc để hình nhìn đúng, vòng review) rồi build ra trang.

Phần âm thanh cũng không phải trang trí. Thư mục sfx/ với run_sfx.py tạo âm thanh procedural theo timeline của film, master về −14 LUFS. Muốn ghi video thì sims/capture.mjs render từng frame ra mp4 60 fps, hoặc xuất ra các sheet ảnh tĩnh để review.

Vì sao 664 sao sau một ngày

Repo tạo ngày 30/10/2026, cập nhật ngày 31/10/2026. Một ngày, 664 sao, 100% JavaScript, license MIT. Con số đó nói lên điều đáng nói: đây là dạng tool mà dev nhìn phát là muốn thử ngay, vì nó cắt đúng một chỗ đau quen thuộc.

Ai học cơ khí, điện tử, hay đơn giản là tò mò cấu tạo máy, đều từng xem mấy video “teardown” trên YouTube với tốc độ 0.5x để hiểu thứ tự lắp ráp. teardown đảo chiều việc đó: thay vì xem người khác tháo, bạn tự tháo. Và nó gắn vào Claude Code, chỗ mà một bộ phận dev đã có sẵn trong workflow.

Điểm khác biệt nằm ở chữ “skill”. Đây không phải một web app bạn phải deploy hay một thư viện phải import. Nó là một bộ hướng dẫn cho agent, kèm runtime và pipeline build. Cài xong là Claude tự biết cách dựng máy mới.

Cài và chạy thử

Yêu cầu Node.js 20 trở lên. Cài skill cho Claude Code:

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

Sau đó vào thư mục đã cài, chạy một lần:

npm install && npx playwright install chromium

Muốn xuất video thì cần thêm ffmpeg, muốn phần âm thanh thì cần Python 3. Giờ mở Claude Code và nói bằng tiếng người, ví dụ:

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

Hoặc build sẵn một trong 3 máy mẫu để xem nó ra cái gì trước khi tự viết prompt:

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

Mở file HTML trong teardown-out/dist/ là chạy. Không cần internet, không phụ thuộc gì thêm.

Ai nên dùng

  • Giáo viên dạy cơ khí, vật lý, hoặc kỹ thuật muốn có demo tháo lắp mà không cần mua model thật.
  • Dev đang làm technical content, docs, hoặc khóa học cần visual giải thích cấu tạo máy.
  • Người viết blog kỹ thuật muốn có clip tour 20 giây thay cho ảnh tĩnh.
  • Bất kỳ ai có Claude Code và tò mò muốn thấy agent dựng scene 3D từ một câu prompt.

Tôi sẽ không nói nó thay được CAD hay phần mềm mô phỏng vật lý chuyên nghiệp. Nó là công cụ giải thích trực quan, không phải công cụ thiết kế.

Ưu điểm và hạn chế

Ưu: output là một file HTML độc lập, dễ share, dễ nhúng vào web hoặc slide. License MIT thoáng. Có sẵn pipeline ghi video và âm thanh, không phải tự viết. Có 3 máy mẫu thật để đối chiếu trước khi tin vào chất lượng sinh ra. Và cái quan trọng: nó dựa trên runtime của whaleyxbt/claude-motion (cũng MIT), nên phần capture frame và sound engine không phải hàng tự phát minh lại.

Hạn chế thì phải nói rõ. Repo mới một ngày tuổi, chưa có cộng đồng kiểm chứng, API có thể đổi. Chất lượng simulator phụ thuộc hoàn toàn vào Claude dựng đúng hay không, và README không đưa ra cam kết gì về độ chính xác vật lý. Muốn thử nhiều prompt thì mỗi lần sinh là một lần gọi model, tốn token. Cài đặt cần Playwright với Chromium, riêng chỗ này đã nặng hơn nhiều so với một npm package thường. Tài liệu hiện chỉ có README và SKILL.md, chưa có document site hay issue mẫu.

Về license thì yên tâm: MIT cho code chính. Sample âm thanh lấy từ Freesound theo CC0, nguồn ghi trong sfx/samples/SOURCES.md. Nếu đem dùng thương mại, đọc file đó cho chắc.

Kết luận

664 sao trong ngày đầu, repo một ngày tuổi, 3 máy mẫu chạy được, output là HTML offline đơn file. Nếu bạn đã có Claude Code và từng muốn giải thích một cái máy cho ai đó mà lời nói không đủ, đây là thứ đáng bỏ 10 phút cài thử. Còn nếu bạn cần mô phỏng chính xác để kỹ sư dùng, chờ thêm vài tháng xem repo có sống tiếp không đã. Link: elvarofficial/teardown.

Chia sẻ bài này

TelegramXFacebookZalo
Đăng ngày 01/11/2026
Giang Na
Về tác giả: Giang Na
Người lập ra blog từ 2015 với những bài về Blogspot. Giờ tập trung vào cách đưa AI vào việc thường ngày, theo hướng thực dụng và dễ làm theo.

Giang Na

Người lập ra blog từ 2015 với những bài về Blogspot. Giờ tập trung vào cách đưa AI vào việc thường ngày, theo hướng thực dụng và dễ làm theo.