用途:为有意义的界面状态变化定义有边界的微交互反馈,先明确“什么变了、用户需要理解什么”,再选择动效、高亮、状态文本、触觉或声音等通道。无状态变化或定向作用的特效属于装饰,不应进入交互映射。
主要能力:按语义触发器(activate、focus、hover、state-change、validation、completion、gesture-end)记录前后状态与意图(acknowledge、confirm、reject、reveal、connect、progress、settle);说明哪些信息已无需动效即可传达;给出完整动效、减少动效与无动效替代,以及所有等效输入路径;定义中断、取消、重复与限流行为。参考 references/patterns.md 与 references/contract.md。
使用方式:将结果写成交互映射;需要保存产物时调用 artifact_path(name, "semantic-micro-interactions", "json"),不要自行拼接 .design 路径。校验命令:python3 scripts/validate_map.py <map.json>。声音仅输出语义标识(如 action.confirmed),交由 humane:sound-effects 处理,默认关闭且静默时含义不变。
限制:优先使用原生控件与平台键盘约定;hover 不得承载必需信息或唯一控件;导航、提交、破坏性操作与持久变更须在激活/抬起时提交;拖拽需同时提供键盘与非拖拽单指针路径;动效不得移动焦点;非必要空间位移、视差、缩放、路径与旋转须有减少动效替代;拒绝环境循环、频闪、重复抖动与延迟真实状态的效果。这些是受 WCAG 启发的 Humane 生产策略,并非全部为 WCAG AA 规范要求。时长、尺寸、颜色与字体归 design-tokens;叙事滚动归 narrative-scrollytelling;声音资产与播放归 sound-effects;任务成功验证归 walkthrough。验证需覆盖键盘、指针、触摸、完整/减少/无动效、声音关闭、中断、快速重复与错误/慢速状态,未测项标记 Not verified。