把机器原理,做成能透视的三维手绘图
把日常设备的工作原理做成三维手绘图,可以旋转、操作和透视内部。Colorfigures 中的部件工作时,对应标签会高亮,最终输出一个可在浏览器打开的独立 HTML 页面。
可用于 Claude Code · Codex · Gemini CLI
前置要求
- Python 3
- Chrome / Chromium
概览
你会得到什么
- 可独立打开的 HTML 图解,包含可旋转三维模型、操作按钮、缩放和外壳配色控件。
- 内部结构透视,部件工作时对应标签高亮;手机端用编号和列表展示标签。
- 手绘 SVG 引擎、三个可修改示例,以及将图解打包为单文件的 Python 脚本。
适用场景
- 通过按钮操作和部件运动,解释家电、售货机等生活设备的工作原理。
- 为课堂、文章和产品讲解制作彩色、可操作的插图。
教程
看懂一台机器怎样运转
外观图能展示洗衣机的样子。要解释它怎样进水、加热和转动,还需要展示内部结构。Colorfigures 把生活设备画成可操作的三维手绘图:拖动改变视角,透视显示内部,部件运动时对应标签亮起。
上方是作者约 25 秒的洗衣机演示,也可以打开交互版本自己试。留意三处:
- 旋转:从正面、侧面和背面观察同一台机器。
- 透视:打开
See-through,看滚筒、管路与传动部件的位置。 - 过程与标签:打开
Labels,观察洗衣过程中哪些部件在工作。
图解采用墨线轮廓、平涂色块、纸面背景和蓝色投影。交付物是一个独立 HTML 文件,收件人可以在浏览器中打开和操作。
和 Anatomy 怎么选
- Colorfigures:围绕生活物件的真实操作流程制作彩色手绘模型,重点是旋转观察、内部透视和部件标签。
- Anatomy:用机械图解表达技术概念,适合技术文档和产品说明,可输出 SVG、HTML 或 React 组件。
安装技能,预览吐司机示例
下面使用 Claude Code、macOS 或 Linux 终端、Python 3,以及 Chrome 或 Chromium。Python 用于打包 HTML,浏览器用于预览和截图检查。
- 在终端执行官方安装命令:
mkdir -p ~/.claude/skills && curl -fsSL https://april-zhu.com/colorfigures/colorfigures.tar.gz | tar -xz -C ~/.claude/skills
- 重启 Claude Code,让它读取
colorfigures,确认能找到SKILL.md、assets/core.js、assets/examples/和scripts/build.py。 - 在终端新建练习目录,将自带的吐司机示例打包为可独立打开的页面:
mkdir -p colorfigures-practice
cd colorfigures-practice
python3 "$HOME/.claude/skills/colorfigures/scripts/build.py" \
"$HOME/.claude/skills/colorfigures/assets/examples/toaster.html" \
toaster-demo.html
终端应显示 wrote toaster-demo.html。在浏览器打开这个文件,按顺序操作:
- 用
Choose shade选择烘烤档位。 - 点击
Push the lever(压下拨杆),观察面包下沉、加热和弹出。 - 面包弹出后,用
Take the toast取走面包。
再打开透视和标签,找出加热元件、弹簧与锁扣。
本站已构建并检查这份官方示例的加热、弹出和手机标签显示。技能包还附有台灯和抓娃娃机示例。
Windows 可从官方页面下载 ZIP,将其中完整的 colorfigures 文件夹放进用户目录下的 .claude/skills/,再重启 Claude Code。Codex 和 Gemini 的安装方式也见该页。
把操作过程写成制作需求
先明确你想解释的原理,再决定按钮和部件。本例沿用示例中的双金属片式吐司机,重点讲“加热后如何触发弹出”。
| 要说明什么 | 本例怎么写 |
|---|---|
| 给谁看 | 第一次了解吐司机内部结构的读者 |
| 工作过程 | 压下托架,通电加热,双金属片弯曲,释放锁扣,弹簧推起面包 |
| 观众操作 | 放入面包、选择档位、压下拨杆、取走面包 |
| 需要看到的反馈 | 面包位置和颜色、加热元件状态、锁扣与弹簧运动、标签高亮 |
在 Claude Code 打开 colorfigures-practice,发送下面的本站练习请求。
/colorfigures
为第一次了解吐司机结构的读者,制作双金属片控制弹出的三维手绘图。
先阅读技能的三个示例和引擎,核对这种吐司机的工作过程,列出主要部件及它们怎样连接。
提供放入面包、选择档位、压下拨杆和取走面包的操作;没有面包时不能开始烘烤。
让面包下沉、加热、变色、锁扣释放和弹出按顺序发生,部件标签随工作状态高亮。
保留旋转、缩放、See-through 和 Labels 控件。
先给工作过程、部件清单和按钮方案,等我确认后再写代码。
检查方案时,确认每个按钮都有看得见的效果:压下拨杆后,托架、面包和加热状态一起变化;弹出时,加热结束,锁扣和弹簧配合动作。若部件只是装饰,或按钮只改文字,就补充它应参与的过程。
确认方案后,继续发送:
按已确认方案制作 toaster.html,输出源码和可独立打开的 toaster-final.html。
从已加载的 colorfigures 中找到 scripts/build.py,使用它打包;技能文件留在安装目录,源码和输出放在当前练习目录。
按技能流程用 Chrome 检查多个角度、透视和标签、完整操作顺序,以及手机布局;打开截图,修复遮挡、缺失部件和错误状态,最多三轮。
交付实际文件路径、打包命令和按钮说明。
打包脚本会把绘图引擎嵌入最终 HTML。重新修改源码后,需要再打包,浏览器打开的也应是更新后的 toaster-final.html。
透视检查,再做一次局部修改
打开成品,按操作顺序试一遍,再换角度观察:
- 关闭透视,拖动到侧面和背面,检查外壳、拨杆和电源线是否完整,前后遮挡是否合理。
- 打开透视和标签,再启动烘烤。标签应指向实际部件,并跟随部件移动;加热、解锁和弹出时,高亮应对应当前过程。
- 切换到手机宽度。标签应变成编号,名称列在图下方,按钮仍能操作。
选择当前成品中的一个烘烤档位,把下方 [档位名称] 换成它的实际名称,再发送这条局部修改请求:
只调整 [档位名称] 档的加热演示时长为 6 秒,保留现有造型、按钮、其他档位和配色。
同步调整面包变色、双金属片弯曲和锁扣释放的时间,避免面包先弹出、加热元件还亮着。
重新打包 toaster-final.html,检查一次完整过程,并返回修改前后的关键状态截图。
这里改变的是演示节奏。时长变化时,视觉反馈和内部动作需要一起调整,才能继续说明同一个过程。
换成你自己的物件
先选有明确动作的小型设备,例如打气筒、咖啡机或扭蛋机。填好下面的方括号,再发给 AI:
使用 colorfigures,制作 [物件名称] 的三维手绘交互图。
读者:[给谁看]。要解释的原理:[只选一个重点]。
参考资料:[说明书、照片或可靠来源的链接/文件路径]。
主要部件与连接:[已知结构]。
介质或物品的移动路线,如空气、水或扭蛋:[从哪里到哪里]。
观众操作:[按先后顺序列出]。每一步的可见结果:[运动、状态、读数或颜色变化]。
透视中要展示:[关键内部部件]。配色:[选择或描述]。
先核对工作过程和部件,再给方案;确认后制作、旋转检查、看透视与手机截图,最后交付独立 HTML。
换物件时,重点重写工作过程、连接关系和操作反馈。绘画风格可以沿用,内部结构需要依据新物件重新设计。
Colorfigures 采用 MIT 许可,基于 April Zhu 的 ISO-GLOW、Tolga Cohce 的 iso-figure,并借鉴 Anatomy 的透视方法。分发技能或包含其代码的页面时,保留相应版权与许可声明;具体条款见技能包 LICENSE。