用途
Hyperiux 是一份面向“源码复制型”特效库的操作指南，而不是可导入的 hyperiux 运行时包。它用于在 Hyperiux-Immersion-Labs/hyperiux-components 上游仓库中检查某个具体的 Vault 特效，规划经批准后的集成方案，或在宿主项目中诊断已安装特效的问题。资料明确其适用范围是 Hyperiux 专属的源码与安装器行为；若涉及其他库，应按该库自身源码处理。
主要能力
- 锁定操作边界：记录目标特效、宿主路由、期望交互，以及任务是否允许改动应用，默认检查类请求仅限源码阅读。
- 许可证与框架核对：应先阅读 LICENSE_EFFECTS；即使元数据标注 tier: free，也须按特效许可使用。CLI/MCP 的 MIT 许可不代表已安装特效是 MIT。特效可在成品项目中使用和修改，但独立片段、模板、库、注册表和竞争性分发受限。还需确认宿主 React、路由、Tailwind、别名和依赖版本；README 面向 Next.js App Router，CLI 检测也识别 React/Vite 与 Pages Router，但检测不等于全部特效都支持这些环境。
- 源码级检查：同时阅读 registry.json 与源码，记录 tier、依赖、registry 依赖、exportName、exportKind、文件目标、客户端边界和公开 props；当源码默认值与 registry 元数据不一致时，应报告差异。
- 安装器副作用评审：文档列出 npx hyperiux init、npx hyperiux add rectangular-text-reveal --dry-run、npx hyperiux add rectangular-text-reveal 等命令，但强调这些是文档记录而非检查阶段应执行的指令。应固定经评审的 CLI 版本，避免未指定版本的 npx 漂移。--dry-run 仍会读取认证状态并拉取 registry。真实 add 可能安装依赖、递归处理 registry 依赖、写入特效文件、更新配置/锁状态、记录安装统计、戳 README 并发送遥测。尤其 pinned resetGlobalCss 会用仅含 @import "tailwindcss"; 的内容覆盖已配置的 CSS 文件，应视为阻断性变更；必要时提供经评审且合规的手动集成方案，执行安装器前须获得明确批准并保留现有 CSS；不应把 --overwrite 或 --yes 当作日常便利参数。
- 生命周期与无障碍：交互控件应保持原生且可键盘访问；装饰性光标或画布层不得捕获输入或成为唯一信息路径。拆分文本应保留一个可读的无障碍名称和语义标题结构。动画初始化失败或无 JavaScript 时，有意义内容仍应可见。资料提到被检查的 reveal 初始内联不透明度为 0，依赖脚本显现；其 reduced-motion 分支仍会让行移动 32px 历时 0.9 秒，若需消除位移应提供静态可读替代方案。还应保留 GSAP timeline、ScrollTrigger、拆分节点、包装器和监听器/观察器/RAF 的清理，检查重挂载与 prop 变化；装饰性重复工作离屏和后台标签页应暂停。
- 按授权验证：仅源码任务应分别报告已检查的契约与未解决的运行时检查；经批准集成后，应在真实宿主路由上测试键盘/触摸输入、焦点、减少动效、窗口尺寸变化、路由退出/重入和重复挂载卸载，确认样式未被破坏、无重复拆分包装器或活跃 timeline 累积。
使用方式
资料以技能说明形式给出，包含“何时使用”和分步指令、示例与参考。示例场景包括：为现有 Next 落地页检查 rectangular-text-reveal 并返回依赖、许可证适配性、隐藏内容/减少动效风险和保留 CSS 的集成计划；以及在可复用组件起步项目中发布这些免费特效时，说明独立再分发的限制，交付物仅为原创指导与上游链接。
适用场景
检查具体 Vault 特效及其依赖、许可、导出与 React 生命周期；规划已批准的特效集成；在宿主项目中诊断已安装特效；在允许 init/add 改动现有应用前评审 CLI 写入。若要做已有页面的动画泄漏或离屏工作审计，应使用性能工作流，本指南仅保留 Hyperiux 专属的源码与安装器行为。
限制
资料为 1.0.0 版，上游证据为固定 pin 的源码级证据；未提供 Vue、原生移动端或框架无关支持。Pro 获取、账户访问、凭据、订阅支出和外部 MCP 配置均属于需单独批准的边界，公开源码任务应保持公开。源码审查不能证明运行时安全。