跳到主要内容
中文
← 技能
技能 · 链接

把机器原理,做成能透视的三维手绘图

把日常设备的工作原理做成三维手绘图,可以旋转、操作和透视内部。Colorfigures 中的部件工作时,对应标签会高亮,最终输出一个可在浏览器打开的独立 HTML 页面。

@Aprilzz423 Colorfigures
  • 技术图解
  • SVG
  • 交互

可用于 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,浏览器用于预览和截图检查。

  1. 在终端执行官方安装命令:
mkdir -p ~/.claude/skills && curl -fsSL https://april-zhu.com/colorfigures/colorfigures.tar.gz | tar -xz -C ~/.claude/skills
  1. 重启 Claude Code,让它读取 colorfigures,确认能找到 SKILL.md、assets/core.js、assets/examples/ 和 scripts/build.py。
  2. 在终端新建练习目录,将自带的吐司机示例打包为可独立打开的页面:
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。在浏览器打开这个文件,按顺序操作:

  1. 用 Choose shade 选择烘烤档位。
  2. 点击 Push the lever(压下拨杆),观察面包下沉、加热和弹出。
  3. 面包弹出后,用 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。

透视检查,再做一次局部修改

打开成品,按操作顺序试一遍,再换角度观察:

  1. 关闭透视,拖动到侧面和背面,检查外壳、拨杆和电源线是否完整,前后遮挡是否合理。
  2. 打开透视和标签,再启动烘烤。标签应指向实际部件,并跟随部件移动;加热、解锁和弹出时,高亮应对应当前过程。
  3. 切换到手机宽度。标签应变成编号,名称列在图下方,按钮仍能操作。

选择当前成品中的一个烘烤档位,把下方 [档位名称] 换成它的实际名称,再发送这条局部修改请求:

只调整 [档位名称] 档的加热演示时长为 6 秒,保留现有造型、按钮、其他档位和配色。
同步调整面包变色、双金属片弯曲和锁扣释放的时间,避免面包先弹出、加热元件还亮着。
重新打包 toaster-final.html,检查一次完整过程,并返回修改前后的关键状态截图。

这里改变的是演示节奏。时长变化时,视觉反馈和内部动作需要一起调整,才能继续说明同一个过程。

换成你自己的物件

先选有明确动作的小型设备,例如打气筒、咖啡机或扭蛋机。填好下面的方括号,再发给 AI:

使用 colorfigures,制作 [物件名称] 的三维手绘交互图。
读者:[给谁看]。要解释的原理:[只选一个重点]。
参考资料:[说明书、照片或可靠来源的链接/文件路径]。
主要部件与连接:[已知结构]。
介质或物品的移动路线,如空气、水或扭蛋:[从哪里到哪里]。
观众操作:[按先后顺序列出]。每一步的可见结果:[运动、状态、读数或颜色变化]。
透视中要展示:[关键内部部件]。配色:[选择或描述]。
先核对工作过程和部件,再给方案;确认后制作、旋转检查、看透视与手机截图,最后交付独立 HTML。

换物件时,重点重写工作过程、连接关系和操作反馈。绘画风格可以沿用,内部结构需要依据新物件重新设计。

Colorfigures 采用 MIT 许可,基于 April Zhu 的 ISO-GLOW、Tolga Cohce 的 iso-figure,并借鉴 Anatomy 的透视方法。分发技能或包含其代码的页面时,保留相应版权与许可声明;具体条款见技能包 LICENSE。