SuperAPI AI 工具集

anatomy

设计与创作

查看项目

更新于 10-18 07:30

技能介绍

Anatomy 是一个用于制作技术解释图解的技能,运行在 Aeon 运行时上,通过 GitHub Actions 作业无头执行。它的核心思路是:让物理物件本身承担解释功能,不画方框、箭头和标签;先构思一台真实、做工精良、机制与概念一一对应的机器,再用大量小而精确的零件把它搭出来。

主要能力

技能提供八个完整示例,覆盖从最简单到最复杂的用法。dial-indicator 是最小的示例,一个装在支架上的千分表,约 300 行代码。desk-computer 是框架无关的 SVG 桌面电脑,键盘可以打字,输入的文字显示在 CRT 屏幕上,关机时画面收缩成一条线和一个点。arcade-cabinet 是拆掉侧板的直立街机柜,硬币沿滑槽滚下触发开关,脉冲沿电缆逐段传到电路板,CRT 预热并进入演示模式。raptor-engine 是悬挂在试车台上的火箭发动机,可拆解为 11 个组件,配有 WebGL 火焰和蒸汽效果。ripple-tank 是从 44 度俯视的学校纹波水槽,包含两层 WebGL 效果。test-rig 是弹簧支架上的玻璃按钮与探针和千分表。spot-plate 是六对玻璃水滴,每对由同一距离场绘制,贴近时会融合成一块玻璃。turning-dial 是可选的 3D 模式,一个真实三维旋转的密码转盘配小型机械手。

使用方式

在 Aeon 上运行时,技能会在 GitHub Actions 作业中无头执行,作业在 50 分钟时被终止。运行流程包括:读取图解主题,若无主题则记录并退出;在约 35 至 40 分钟内完成研究、构建、检查、提交和通知;将技能复制到临时目录中工作,不在技能目录内写入文件;构建一个自包含的 HTML 页面并截图;将结果复制到 output/anatomy 目录;记录到状态文件并发送通知。框架无关的示例用 node examples/<name>/build.mjs 构建,加 --light 切换浅色主题。检查项包括构建、--audit 几何审计、lines.mjs 和桌面及手机截图。

适用场景

适合需要把抽象技术概念(如共享 GPU 上下文、缓存键、渲染目标、可分离模糊、高度剖面、光照与朝向关系)转化为直观物理图解的场合。每个图都以机器为解释载体,读者通过识别机器来理解概念。

限制

在 Aeon 上运行有严格的时间和规模限制:只构建 Figure 尺寸(40 至 80 个零件,至多一层 WebGL),Hero、Epic 和 3D 模式会被降级为 Figure 并在通知中说明完整版会增加什么。运行环境没有 React 或 TypeScript 工具链,必须使用框架无关的路径。无头运行中不能向用户提问或等待选择。若脚本找不到 Chrome,需设置 CHROME_PATH。每次运行只产出一个图。