Hyperiux Components 是一套面向 Next.js（App Router）的高质量动画效果与交互式组件库，由 Hyperiux 设计。官方仓库为 https://github.com/Hyperiux-Immersion-Labs/hyperiux-components。
【用途】 该项目用于为 Next.js 项目提供可直接安装到本地的动画效果和交互式 UI 组件。CLI 会把源码直接写入用户项目，安装后代码归用户所有，可在自己的项目中自由使用和修改。
【主要能力】 官方网站称共有 150+ 效果，其中 50+ 为免费且开源，100+ 为 Pro 效果（需 Pro 订阅）。免费效果无需任何账户即可安装。组件按类别组织，包括：
- 文字动画：字母级与行级揭示动画，含模糊、打乱、错峰、透视翻转、遮罩擦除等，例如 rectangular-text-reveal、blur-text、text-fill-animation、scramble-text。
- 环境背景：画布与粒子背景，例如 dot-transition、dotted-grid、spider-particles。
- 按钮交互：填充扫光、金属光泽、高亮、悬停文字打乱等，例如 arrow-fill-button、link-button、metallic-button、scramble-link-button、shiny-button。
- 滑块与轮播：弧形路径、3D 翻转、视差条带、缩放过渡，例如 arc-flow-carousel、dimensional-switch-slider、ellipse-carousel、orbit-flip-slider。
- 滚动驱动动画：基于 GSAP ScrollTrigger，包含视差画廊、固定序列、横向叙事、堆叠卡片，例如 sticky-content-wrapper、horizontal-feature-reveal、infinite-perspective-slider、rotation-slider、circular-split-roll、split-canvas。
- 小型独立 UI 组件：手风琴、计数器、时间线、悬停列表，例如 animated-faq、border-beam、gooey-counter、gsap-flip-card。
- 菜单与导航栏：桌面与移动端交互模式，例如 directional-menu、elevate-navbar、immersive-full-screen-nav。
- 光标特效：Canvas 2D 与 Three.js 效果，如图像拖尾、绳索跟随、液态玻璃、字符网格，例如 phantom-image-trail、pixelated-image-effect、liquid-glass-cursor、magnetic-image-trail、character-trail、rope-cursor。
- 页面与区块过渡：基于动画网格与块状运动，例如 block-transition、chess-grid-transition。
- 加载指示器：数字、堆叠、动感状态，例如 numeric-tunnel、stack-loader。
- Three.js 与 R3F 场景：自定义 GLSL 着色器，如图像轮播、像素网格、磨砂玻璃、GPU 粒子星系、3D 主视觉，例如 interactive-blur-reveal、mouse-pixelation、grid-tunnel、draggable-canvas、milky-way、fractal-glass。
【使用方式】 通过 CLI 使用：运行 init 后会在项目根目录生成 hyperiux.json 配置文件；添加免费效果时支持若干选项参数，例如 --overwrite（覆盖已有文件）、--yes（跳过确认提示）、--dry-run（预览而不写入文件）。CLI 工具以 hyperiux 名称发布在 npm 上，可用 npx hyperiux 调用。 MCP 服务器：packages/mcp-server 是一个 MCP（Model Context Protocol）服务器，让 AI 客户端（如 Claude、Cursor 等）可以浏览并安装 Vault 效果，以 hyperiux-mcp-server 名称发布在 npm 上，可通过 npx 添加到客户端的 MCP 配置中。若要对服务器本身做贡献，可将 MCP 客户端指向本地构建版本。
【项目结构】 这是一个使用 Turborepo 的 pnpm monorepo：packages/cli 为 npx hyperiux CLI 工具，发布为 hyperiux；packages/mcp-server 为 MCP 服务器，发布为 hyperiux-mcp-server；registry/effects 为按类别组织的免费效果源码。Pro 效果源码位于私有仓库，通过受保护的 API 提供；注册表索引 registry/index.json 列出所有效果的元数据，但 Pro 文件内容不公开。
【适用场景】 需要为 Next.js（App Router）项目快速引入动画和交互 UI 组件的开发者；希望借助 AI 客户端（Claude、Cursor 等）浏览与安装效果的场景。
【许可与限制】 hyperiux CLI 与 hyperiux-mcp-server 采用 MIT 许可。通过 CLI 安装的免费效果适用 Hyperiux Effects License。Pro 效果需要有效的 Hyperiux Pro 订阅，属专有内容，非开源、不可再分发。免费效果无需账户即可安装，Pro 效果需要 Pro 订阅。官方欢迎缺陷反馈与免费效果贡献，新增免费效果需遵循 CLAUDE.md 中的 “Adding a New Effect” 清单。具体安装命令、Pro 订阅价格、完整效果清单等细节，资料中暂未提供。
