feitangyuan/motion-web

解决的问题

motion-web 解决了创意网页开发中的「AI 滑稽感（AI slop）」问题——即 AI 生成的动画往往过于通用、线性且缺乏物理真实感。它提供了一个框架，用于构建高触感、以运动为先的网站，将运动视为核心材料而非装饰性附加物，确保交互体验自然且专业。

工作原理

该项目作为 AI 代理（如 Claude）和前端工程师的「技能」使用。它结合了一组物理定律（如弹簧阻尼系统、各向异性力、Verlet 积分）与严格的验证系统。为防止合成漂移或无响应交互，它使用基于 Playwright 的无头预言机（verify_case.py），通过数学方式断言位移比、形变误差和状态收敛，确保代码实际按预期运行。

适用人群

专为希望使用原生 Three.js、Canvas 2D、WebGL 和 CSS 构建高端、创意性交互网站的 AI 代理和前端工程师设计，无需依赖重型构建工具或外部 CDN。

主要亮点

• 物理驱动的运动：实现真实世界物理，包括二阶弹簧阻尼系统和步进抖动，带来触觉反馈。
• 自动化验证：包含无头测试套件，数学验证动画和交互是否正常运行。
• 零依赖：所有案例均为独立运行的单文件 HTML 页面，无外部网络依赖。
• 多样化的案例研究：提供七个经验证的交互示例，涵盖软体时钟、WebGL2 墨水人群、因果生态系统和 Verlet 绳帘等。