refactor(components): 优化动画组件代码结构并移除冗余样式

style(pages): 使用实用类替换内联样式
refactor(composables): 简化页面标题模板逻辑
docs(components): 添加详细注释说明动画逻辑

app/components/home/HomeIntro.vue

@@ -3,119 +3,74 @@ import { ref, onBeforeUnmount } from 'vue'
 import gsap from 'gsap'
 
 const introTitle = 'ArcticNewOne'
+// 将标题拆分为单个字符，用于后续 GSAP 的逐字动画
 const introLetters = introTitle.split('')
 const introRef = ref<HTMLElement | null>(null)
 const introTitleRef = ref<HTMLElement | null>(null)
 let ctx: gsap.Context | null = null
 
+// 暴露供外部（如 index.vue）使用的异步播放方法
 const play = () => new Promise<void>((resolve) => {
   if (!introRef.value || !introTitleRef.value) return resolve()
 
+  // 获取所有需要执行动画的字符和 TM 标志 DOM 节点
   const chars = gsap.utils.toArray('.hero-intro-char', introRef.value)
   const tm = introRef.value.querySelector('.hero-intro-tm')
 
   if (!chars.length || !tm) return resolve()
 
+  // 使用 gsap.context 包装时间轴，方便在组件卸载时统一清理所有动画状态（revert）
   ctx = gsap.context(() => {
-    // 初始化样式
+    // 1. 初始化 DOM 的初始样式状态，防止闪烁
     gsap.set(introRef.value, { display: 'grid', yPercent: 0, autoAlpha: 1 })
     gsap.set(introTitleRef.value, { y: 0, autoAlpha: 1 })
+    // 将每个字符初始放置在视口下方（yPercent: 110），等待升起
     gsap.set(chars, { y: 0, yPercent: 110 })
+    // TM 标志初始透明度为 0
     gsap.set(tm, { autoAlpha: 0 })
 
+    // 2. 创建并执行时间轴
     gsap.timeline({
       defaults: { ease: 'power3.out' },
       onComplete: () => {
+        // 动画完全结束时，隐藏整个组件容器并 resolve Promise，通知外部可进行下一步
         gsap.set(introRef.value, { display: 'none' })
         resolve()
       }
     })
-      // 逐字升起
+      // 步骤 A：字符从下方逐字平滑升起入场 (stagger 产生阶梯感)
       .to(chars, { yPercent: 0, duration: 0.75, stagger: 0.055 })
-      // TM 渐显
+      // 步骤 B：TM 标志渐显入场
       .to(tm, { autoAlpha: 1, duration: 0.4, ease: 'power2.out' })
-      // 停顿 0.35s 后，整体上移并淡出标题
+      // 停顿 0.35s 后，为接下来的离场动画打上时间标签
       .addLabel('introOut', '+=0.35')
+      // 步骤 C：标题整体淡出
       .to(introTitleRef.value, { autoAlpha: 0, duration: 1.05, ease: 'power4.inOut' }, 'introOut')
+      // 步骤 D：同时，整个 Intro 黑色背景容器向上滑出屏幕
       .to(introRef.value, { yPercent: -100, duration: 1.05, ease: 'power4.inOut' }, 'introOut')
   }, introRef.value)
 })
 
+// 组件销毁前清理 GSAP 动画上下文，避免内存泄漏或在 SPA 路由切换时导致状态异常
 onBeforeUnmount(() => ctx?.revert())
 
 defineExpose({ play })
 </script>
 
 <template>
-  <div ref="introRef" class="hero-intro" aria-hidden="true">
-    <h1 ref="introTitleRef" class="hero-intro-title" :aria-label="introTitle" v-once>
-      <span class="hero-intro-word">
+  <div ref="introRef" class="fixed inset-0 z-[80] hidden place-items-center overflow-hidden bg-black text-white opacity-0 invisible will-change-transform" aria-hidden="true">
+    <h1 ref="introTitleRef" class="m-0 flex whitespace-nowrap font-bold leading-[0.9] tracking-[-0.07em] text-[clamp(36px,6.2vw,104px)]" :aria-label="introTitle" v-once>
+      <span class="relative inline-flex">
         <span
           v-for="(letter, index) in introLetters"
           :key="`${letter}-${index}`"
-          class="hero-intro-char-wrap"
+          class="relative inline-block overflow-hidden"
         >
-          <span class="hero-intro-char">{{ letter }}</span>
+          <!-- GSAP 将通过操作此元素的 translateY 来实现逐字浮现 -->
+          <span class="hero-intro-char inline-block will-change-transform">{{ letter }}</span>
         </span>
-        <span class="hero-intro-tm">TM</span>
+        <span class="hero-intro-tm absolute left-[calc(100%+0.12em)] top-[0.08em] text-[0.13em] font-bold leading-none tracking-[-0.02em] opacity-0 invisible">TM</span>
       </span>
     </h1>
   </div>
 </template>
-
-<style scoped>
-.hero-intro {
-  position: fixed;
-  inset: 0;
-  z-index: 80;
-  display: none;
-  place-items: center;
-  overflow: hidden;
-  color: #fff;
-  background: #000;
-  opacity: 0;
-  visibility: hidden;
-  will-change: transform;
-}
-
-.hero-intro-title {
-  display: flex;
-  margin: 0;
-  font-size: clamp(36px, 6.2vw, 104px);
-  font-weight: 700;
-  line-height: 0.9;
-  letter-spacing: -0.07em;
-  white-space: nowrap;
-}
-
-.hero-intro-word {
-  position: relative;
-  display: inline-flex;
-}
-
-.hero-intro-char-wrap,
-.hero-intro-char {
-  display: inline-block;
-}
-
-.hero-intro-char-wrap {
-  position: relative;
-  overflow: hidden;
-}
-
-.hero-intro-char {
-  will-change: transform;
-}
-
-.hero-intro-tm {
-  position: absolute;
-  left: calc(100% + 0.12em);
-  top: 0.08em;
-  font-size: 0.13em;
-  font-weight: 700;
-  letter-spacing: -0.02em;
-  line-height: 1;
-  opacity: 0;
-  visibility: hidden;
-}
-</style>