SuperAPI AI 工具集

interface-bts

设计与创作

查看项目

更新于 10-29 16:15

技能介绍

用途 interface-bts 是一个把项目中一个具体交互画成 A4 规格海报的技能,目标是呈现界面“幕后”的运动方式:组件怎样从输入走到输出,哪些数值驱动变化。它不是重设计、不是实时调试浮层,也不是视频。海报记录的是界面当前的行为。

主要能力 海报通常包含以下部分:

  • Figure 1:真实组件,冻结在运动中的某一帧,并在其上标注尺寸。
  • 标注(callouts):给编号部件加注释,说明每个部件变化什么、为什么。
  • Figure 2:驱动该交互的曲线或映射。
  • 关键时刻(moments):一行可点选的瞬间,可重新驱动组件。
  • 规格说明:触发条件、属性、时长、缓动和减弱动效。 读者看完应能用一句话说出它如何运作。

使用方式 以斜杠命令指定目标交互,例如:/interface-bts the dropdown in components/menu.tsx。随后按阶段进行:

  1. 研究交互:找到组件、调用方、样式、处理函数和动画代码,运行并亲自操作,追踪输入→决策→输出,明确触发、变化量、驱动值及每个值的来源;探测慢输入、反向、中断、静止态和减弱动效等情形。
  2. 在对话中确认海报方案:列出标题句、主瞬间、三个按故事顺序排列的瞬间、2–4 条标注、Figure 2 的类型和一两项关键尺寸,获得用户同意后再构建。
  3. 冻结真实组件:用组件自身的处理函数驱动,通过 getAnimations()、pause()、set currentTime 或动画库自身时间线暂停在真实动画上;所有数字都从运行中的组件读取,不得手写时长、缓动或阈值;无法读取的值标注为估计值。弹簧动画需读取其物理参数(stiffness、damping、mass)并按其响应作图。
  4. 组装海报:固定 A4 竖版,在 794×1123 画板上排版后整体缩放适配;所有海报集中展示在 /specs 页面的一行中,工具栏可切换纸张、强调色、横竖版和字体。
  5. 打磨并按测量验证:检查重叠、适配、关键时刻重驱动结果一致性、工具栏设置、减弱动效等;附带 scripts/overlaps.js 可用于运行 btsPosterOverlaps() 检查。

配套实现 assets/kit/ 提供 React 与 CSS Modules 实现,可复制到项目中(如 Next.js 的 app/specs/kit/ 或 src/specs/kit/),每个海报作为旁边的一个页面构建。assets/example/ 是一个完成的复制按钮海报,可作为起点。组件包括 SpecPage、useTransitionSpec、SpecStrip、各种绘图与读数工具等。

适用场景 适合需要把交互运动机制清楚讲给他人、形成规格文档的团队或个人。可用于记录转场、交叉淡入、拖拽、滚动映射、关键帧循环、阈值、弹簧动画等,并覆盖减弱动效的说明。

限制 海报只记录现有行为,不承担改造需求;组件若涉及 floating-ui 定位、固定窗口、屏幕测量或焦点移动,需要先阅读 references/drivers.md。竖直横版、手写字体等仅在 /specs 中提供。收费、平台支持范围等信息暂未提供。