关键字 · 结构图
把界面组件画成一张苹果风的技术结构图:开源技能 Dimensional Drawing 标好内边距、间距、圆角和图层,还能做成十秒动画
开源技能 Dimensional Drawing:把界面组件画成苹果尺寸图风格的一页技术图纸,标好内边距、间距、圆角和图层,还能做成十秒动画。
苹果会为每一款设备公开发布尺寸图(dimensional drawings),方便配件厂商做出刚好合适的保护壳。这种图很安静、很密,一张纸、几个视图、几个小小的细节圈,到处都是数字。视频里介绍的 Dimensional Drawing,就是教你的编程 AI 用同样的画法去画你自己的界面组件。
README 的一句话介绍是:丢给它一个界面组件,还你一张一页的技术图纸。内边距、间距、圆角、图层,还有它在视口里的位置,都量好、标好。比如一张卡片或一个对话框,画出来就是一张规格表,交给任何人,他都能照着把它的「结构」重新搭出来。
它由 Enes Ozturk 开发,采用 MIT 许可,免费使用。先说清楚一点:它只是借用苹果尺寸图的画法,不是苹果做的,也和苹果没有任何关系;技能本身还禁止在图里放标志和品牌名。
01它是什么,里面有什么
这个仓库里有两个技能(skill),可以装进 Claude Code、Codex、Cursor、Gemini CLI 等编程 AI:
- dimensional-drawing:画图的技能,附带卡片和对话框两份示范图,都是单个 HTML 文件;
- dimensional-drawing-motion:把画好的图变成一段大约十秒的动画,附带参考场景和样式表,以及两种渲染方式。
画出来的是一张图纸:最上面是标题栏和关键变量,下面是一整张密集的图,包括说明、平面图、分层爆炸图、细节视图(嵌套圆角、圆角半径、主体)和变量表。输出是一个独立的 HTML 文件;在 claude.ai 上,可以把它发布成一个 Artifact。
02它的几条规矩
README 把它的画法总结成几条「家规」,这也是它看起来专业的原因:
- 只用黑白灰:不用颜色,靠线条粗细、虚线和斜线阴影来区分不同的东西;
- 画结构,不画内容:文字内容故意不画,只标「标题槽 · 自适应」「操作按钮 · 包裹内容」「内容槽 · 填满」这类结构,这样文字改了,图依然成立;
- 用变量,不直接写数字:比如 S1、R2,以及 H1 = 2·S1 + H3、R2 = R1 − B − S6 这样的关系式;
- 不带品牌:用 UI-CARD-001 这样中性的名字;
- 绝不编数值:不知道的值一律写 [TBD],也就是「待定」。
03适合谁,能拿什么当输入
- 设计师和前端开发:把组件的间距、圆角、层级关系一次讲清楚,交接时少来回问;
- 做设计系统的团队:给每个组件出一张统一风格的规格图;
- 内容创作者:那段自己画出来的动画很适合放进视频里讲解一个界面。
你可以给它的来源有:仓库里的一个代码文件、一个 Storybook 组件页、一个网址,或者一张截图。它也能画实体物品,用第三角投影视图、毫米单位,只用公开发布的规格,README 还开玩笑说可以试试画一个保温杯(仓库里没有附这个示例)。
04你需要准备什么
- 一个编程 AI:Claude Code、claude.ai 或 Claude 桌面版、Codex、Cursor 等。除了你已经在用的 agent,不需要额外的账号或 API key;
- 画图本身不需要别的软件,输出就是一个 HTML 文件;
- 做动画有两种方式:在 claude.ai 用 Claude 的 Motion artifact 导出 MP4;或者不用 Claude,在本机用 Playwright 加 ffmpeg 渲染,需要 Node 18 或以上和 ffmpeg;
- 费用:技能免费,MIT 开源;花的只是你自己 agent 的使用量。
05上手步骤
以下按 README 的安装和用法整理。
- 第 1 步:安装技能:Claude Code:运行 git clone https://github.com/enesozturk/dimensional-drawing,再运行 cp -r dimensional-drawing/skills/* ~/.claude/skills/。claude.ai 或 Claude 桌面版:把一个技能文件夹(比如 skills/dimensional-drawing)打包成 zip,在「设置 → Capabilities → Skills」里添加。其他 agent(Codex、Cursor、Gemini CLI 等):运行 npx skills add enesozturk/dimensional-drawing,或者让 agent 直接读那几个 SKILL.md 文件。
- 第 2 步:指着一个组件,让它画:直接跟 agent 说,并指明来源,例如:Make a dimensional drawing of the Card component in src/components/Card.tsx,或者「把我们的设置对话框的结构画出来,风格跟示例一样」。
- 第 3 步:检查图纸:打开生成的 HTML,看看标题栏、平面图、爆炸图和变量表。凡是来源里没给出的数值,它会写 [TBD];如果你是从截图画的,这类地方会比较多,需要你自己补上真实数值。
- 第 4 步:让它动起来:跟 Claude 说 animate this drawing,它会在 Motion artifact 里做好,你导出 MP4,这是作者调好节奏的主要方式。不用 Claude 的话,进入 skills/dimensional-drawing-motion/adapters/headless 文件夹,运行 npm install,再按 README 用 node render.mjs 指定场景文件、样式表和输出文件来渲染。
06它做不到什么,要注意什么
- 和苹果无关:只是苹果风格的画法,不是苹果的工具,也没有任何合作;
- 示范是通用组件:仓库里的动图、MP4 和图片画的是它自带的通用对话框和卡片,不是某个真实 App 的界面;
- 从截图画不会完全准确:截图里看不出的数值会留成 [TBD],不会帮你猜;
- 一键导出 MP4 依赖 claude.ai 的 Motion artifact;本机渲染要先 npm install,还要装 ffmpeg;
- 其他动画库没测过:README 写明 Remotion、Motion Canvas、GSAP、Lottie 等都没有测试过;
- 不画文字内容:这是故意的,如果你需要标注具体文案,要另外处理。
07常见问题
问:要钱吗?
答:不用。它是 MIT 开源的技能,除了你已经在用的 agent,不需要别的账号或 API key。
问:图里为什么没有颜色和文字?
答:这是它的规矩。只用黑白灰,用线条区分;只画结构不画内容,这样文案改了图依然准确。
问:能画手机、杯子这类实物吗?
答:可以,用第三角投影视图和毫米单位,但只用公开发布的规格。
问:动画能加背景音乐吗?
答:默认不加音乐和旁白,你明确要求的话才会加。
08相关链接
资料来源
下一个好用的工具是什么?
每条视频都有一篇完整详情。关注 @serrini666,第一时间看到新分享。