无尘阁 · skills实验室
LAB · SKILLS 实验室 / 实验 09 · 3D 数字孪生

一句话,能造出一台会拆、会坏的机器吗?

我把文章里那台行星滚柱丝杠,做成了一个能切开、能拆散、能烧到热抱死的网页。下面这台机器是活的,不是截图:拖动旋转、拉剖切滑块、点第四幕看它超载。

底本是公众号「BeforeAGI」那篇拆解 Anatomy 与 Machine-Skill 的文章。这一页按实验室的固定四样东西写:成品、原始素材、用的是哪个 skill、边界,做法都摊开,不写「一键出片」。

底本:mp.weixin.qq.com/s/Al84ITpXR8RIQqi9zJ5hCw · 2026-10-16 · 成品:单文件 HTML,零第三方依赖 · 2026-11-06

1台可交互数字孪生
4幕 / 28 秒运镜
8根行星滚柱
0个第三方依赖
2个开源 Skill 对照
← 返回 skills 实验室
01

成品:先看这台机器

✦

直接在这一页里操作。默认自动跑 28 秒四幕,手动拖任意滑块就会停下交给你控制。

planetary-roller-screw.html · Canvas 实时渲染 · stepPhysics(state, dt) 单文件全屏打开 ↗
拖一下按住画面旋转 360°,滚轮缩放,看装配关系。
剖切 0–100%像 CT 一样扫过外壳,内部滚柱照样转。
爆炸 0–100%端盖沿主轴退开,8 根滚柱沿径向舒展。
X-Ray外壳收成一层玻璃线框,传动路径露出来。
Break-It把载荷推过额定值,看温度和效率一起塌。

左上角三条方程不是贴图,每一帧都在算:转子位置、屏幕读数、过热时的红橙辐射,全部从同一个 state 里取。这是文章里最硬的一条规矩——零件与读数共用一个物理模型,不是各画各的。

02

28 秒里发生了什么

✦

文章给 Machine-Skill 定的自动电影运镜,四幕循环。可以点成品下方的幕号直接跳过去。

BEAT 01 · 00–07s

影棚环视

360° 绕机 · 全装配

软箱光下的完整机身:钛合金外壳、散热筋、两端轴承盖。先让人看清这是一台什么机器。

01 / 04
BEAT 02 · 07–14s

动态剖切

剖切平面扫掠

局部裁剪只作用于外壳、定子套筒与螺母;切开后内部滚柱与丝杠保持完整咬合,继续自转公转。

02 / 04
BEAT 03 · 14–21s

爆炸 + X-Ray

装配轴展开

每个子装配体绑真实装配轴:端盖沿 ±Z 退开、滚柱径向舒展,配合外壳玻璃化,看动力传递路径。

03 / 04
BEAT 04 · 21–28s

过载破坏

8.0 → 19.6 kN

推过 14.0 kN 额定值到 134%,摩擦生热飙到约 280°C、效率跌到约 42%,触发热抱死与螺纹屈曲告警。

04 / 04

第四幕的读数不是写死的动画:把载荷滑块往右拉,温度按一阶惯性爬升、效率随温度和超载下滑、推力跟着掉,滚柱和绕组一起亮起热辐射。本页实测停在 19.6 kN / 278 °C / 43%,与原文的 19.6 kN / 280 °C / 42% 基本对上。

03

这台机器用的是哪个 skill

✦

文章里同时介绍了两个开源 Agent Skill,本页对应的是专攻 3D 硬件的 Machine-Skill。

AirsupHQ / machine-skill

Agent Skills · SKILL.md单文件 HTMLThree.js

一句话描述任何一台真实机器,Agent 按 Research → Build → Solve → Film 四步,输出一个完全自包含、无需打包的 .html:影棚级 3D 数字孪生,带工程 PBR 材质、实时剖切、装配轴爆炸、X-Ray、过载破坏求解,以及 28 秒四幕自动运镜。

01 / RESEARCH

查尺寸与方程

先把真实几何、材料与驱动方程研究清楚,不是凭手感建模。

02 / BUILD

影棚建模

Three.js 物理材质还原钛壳、紫铜绕组、黄铜保持架,绑好装配轴。

03 / SOLVE

实时求解

纯函数 stepPhysics(state, dt) 每帧推进,零件、读数、热辐射同源。

04 / FILM

四幕运镜

环视 → 剖切 → 爆炸透视 → 过载,28 秒自动循环。

安装命令 · 原文提供,本页未执行npx skills add AirsupHQ/machine-skill -g npx skills add wheresryan22/anatomy -g
高分提示词 · 原文示例(点明硬件、剖切位置、失效边界)/machine-skill Build a 3D interactive simulation of a planetary roller screw actuator (8 threaded rollers, copper stator windings, titanium housing) with live cutaway plane, coaxial/radial exploded view, and thermal seizure overload mode.

原文的安装命令是 npx skills add AirsupHQ/machine-skill -g;支持 Claude Code、Antigravity、OpenCode、Codex。文章也提醒:skill 对 Claude Code 以外的 Agent 兼容性一般,官方 Demo 效果最好。

04

那 Anatomy 呢?六维摆一起看

✦

按文章第 04 节的横向对比整理。两个都是 SKILL.md 标准,分工不重叠。

维度wheresryan22 / anatomyAirsupHQ / machine-skill
一句话把抽象概念做成桌面上的等轴测精密仪器把真实硬件做成影棚里的 3D 数字孪生
渲染架构原生 SVG 为主,必要时用「SVG + WebGL + SVG」三明治图层画尾焰与马赫环,共用同一相机矩阵Three.js 单文件 HTML,MeshStandard / MeshPhysical 的 PBR 材质
零件与遮挡40–240+ 个实心零件,四阶明暗着色;画家算法,弹簧必须拆成前后半圈,配 kit/audit.mjs 几何审计按真实装配层级建模,每个子装配体绑 explodeAxis / explodeOffset,局部裁剪平面只切外壳与定子
交互重点按键改状态、状态驱动零件与角落读数同源;适合讲机制360° 环视、CT 式剖切、爆炸、X-Ray、Break-It 过载;适合看结构与失效
交付形态独立 HTML / 单文件 .svg / React·Next.js 组件,零第三方运行时完全自包含的单文件 .html,双击浏览器即开、无需构建
什么时候用技术博客、产品文档、解释限流 / 索引 / 擒纵这类抽象算法硬核机械传动、内部剖面、极限失效工况的三维演示

原文那句口诀很省事:解释软件算法与抽象原理,召唤 /anatomy;拆解复杂硬件与三维传动,召唤 /machine-skill。 这一页选了后者,因为要回答的是「切开以后里头还在不在转」。

05

原始素材,拿走就能复现

✦

实验室每篇都把输入摊开:成品、提示词、参数、方程,四份都能下载。

06

边界:哪些是 skill 做的,哪些不是

✦

这一栏是实验室的规矩,比成品更重要。

先说最要紧的一句

  • 本页成品不是运行官方 Machine-Skill 生成的。 我没有执行 npx skills add,也没有调用 /machine-skill。它是按文章公开的四步规范、用原生 Canvas 2D 软渲染手工复现的同题材教学演示。
  • 没有 Three.js,也没有 PBR。 用透视投影 + Lambert 漫反射 + Blinn-Phong 高光近似 + 画家算法排序,材质只是颜色,不是 MeshStandardMaterial / MeshPhysicalMaterial,也没有真实 Ti-6Al-4V 材料属性或 CAD 几何。
  • 物理是教学模型,不是工程验算。 温度用一阶惯性热平衡逼近,效率是经验曲线,参数调到与文章数值对齐。没有有限元、接触力学、润滑模型,不能用来判断任何真实执行器的强度、寿命或失效载荷。
  • 四幕是浏览器里实时跑的,没有导出 28 秒视频;也没有做官方画廊里那种 PBR 贴图、尾焰着色器或音频。
  • 文章里的官方 Demo 由作者用 Gemini 4 Argon 生成,作者明说对 Claude Code 以外的 Agent 兼容性一般、效果偏弱;本页没有复现官方 Demo,也没有复现其截图。
  • 安装命令、官方提示词、11.5k+ Stars 等数字均转述自原文,本页未执行、未验证。
  • ✓ 真的做到了:单文件 twin.html 零外部请求、双击可开;剖切 / 爆炸 / X-Ray / 过载 / 四幕运镜全部可交互;三条方程每帧由 stepPhysics(state, dt) 推进;零件与读数共用同一状态。

把边界写清楚,是因为这两个 skill 最容易被误读成「AI 会画 3D 图了」。文章说得很准:大模型一个像素都没吐,看到的是 Agent 写的代码在浏览器里实时算出来的。本页同理——每一个面、每一道高光,都是 JS 在画布上现算的。

07

来源与延伸

✦

底本与两个上游仓库,都能点开核对。

本页整理改写自公众号「BeforeAGI」原创文章《告别「方框加箭头」:用 Anatomy 与 Machine-Skill,把一句话变成可交互的精密机械与 3D 数字孪生》(2026-10-16,广东)。两个上游项目均遵循开放的 Agent Skills(SKILL.md)格式;原文明确提到 Anatomy 为 MIT 开源,machine-skill 的许可证本页未核对。