AGILE TEAM
Skip to content

UI 风格分析与升级方案

一、当前设计风格识别

主风格:Linear × Apple Premium Design

项目首页(GlassHome)明确标注 "Linear × Apple Premium Design",整体属于 SaaS 产品级暗色优先文档站

维度当前实现
色彩体系Indigo → Purple → Pink 渐变(#6366f1#8b5cf6#ec4899),暗色底 #09090b
HeroAurora Gradient Mesh + Grid Overlay + Film-Grain Noise 三层纹理叠加
卡片1px divider 分隔、hover 顶部渐变色条 scaleX 动画、微妙前景覆盖
团队卡片Glassmorphism(backdrop-filter: blur)+ 鼠标跟随 radial-gradient
排版超大标题 90px / -0.045em、章节 eyebrow 线 + uppercase 标签
按钮渐变填充主按钮 + 线框次按钮、hover translateY(-2px) + 加深阴影
动画heroUp 入场、meshShift 呼吸、dotBreathe 脉搏,全部 cubic-bezier
代码高亮github-light / github-dark 双主题
全局smooth scroll、box-sizing border-box、--vp-layout-max-width: 1440px

参考对标

参考站说明
Linear.appHero 渐变网格 + 深色底 + 极简排版 — 当前首页主要参考
Apple Developer高级排版节奏 + 大留白 + 渐变标题
Element Plus Docs文档站内容宽度、侧边栏、组件演示布局
tzagileteam.com团队内部参考站

二、适合当前项目的高级 UI 风格

基于已有的 Linear × Apple 基因,以下风格 天然兼容,可以增量引入而不破坏现有设计语言:

1. Vercel/Next.js 风 — 极简黑白 + 锐利边界

特征说明
代表vercel.comnextjs.org
核心纯黑白为主色,accent 仅用于少量高亮;1px 锐利边框;无圆角或极小圆角
适合场景代码块、CLI 文档、技术规范页面
融入方式在 Skill 技术文档页使用更紧凑的黑白布局、terminal 风格代码展示

2. Stripe 风 — 渐变流体 + 精致微动画

特征说明
代表stripe.comstripe.com/docs
核心多层渐变叠加(mesh gradient)、流体动画、微妙光影;卡片有呼吸感
适合场景首页、Skill 流水线可视化、功能模块总览
融入方式首页已有 mesh gradient 基础,可在流水线页增加 animated gradient border、流程连线动画

3. Raycast 风 — 毛玻璃 + 键盘优先

特征说明
代表raycast.com
核心深度 backdrop-filter blur、高对比度文字、快捷键标签(kbd)、command palette 风格
适合场景搜索体验、快捷操作指引、CLI 工具文档
融入方式团队卡片已有 glassmorphism,可扩展到全局卡片风格;CLI 页面增加 kbd 标签美化

4. Notion / Arc 风 — 暖色调 + 柔和阴影

特征说明
代表notion.soarc.net
核心暖灰底色、柔和大圆角、pastel accent、图标插画风
适合场景知识库、使用指南、教程类页面
融入方式使用指南和教程页面可用更柔和的配色和插画风图标

5. Framer / Awwwards 风 — 视差滚动 + 大排版

特征说明
代表framer.com、各大 Awwwards 获奖站
核心超大标题(120px+)、视差滚动、scroll-triggered 动画、全屏 section
适合场景首页、宣传展示页
融入方式首页增加滚动触发动画、Feature 区域增加 parallax 效果

三、当前风格可融合的酷炫升级

以下是在 不破坏现有 Linear × Apple 风格 前提下,可以增量叠加的高级效果:

🔥 高优先(推荐立即实施)

1. Animated Gradient Border(流光边框)

卡片/代码块边框用 conic-gradient 旋转动画,营造科技感。

css
.card-glow {
  position: relative;
  border-radius: 16px;
  background: var(--vp-c-bg);
}
.card-glow::before {
  content: '';
  position: absolute;
  inset: -1px;
  border-radius: 17px;
  background: conic-gradient(from var(--angle, 0deg),
    #6366f1, #8b5cf6, #ec4899, #6366f1);
  z-index: -1;
  animation: borderRotate 4s linear infinite;
}
@keyframes borderRotate {
  to { --angle: 360deg; }
}
@property --angle {
  syntax: '<angle>';
  initial-value: 0deg;
  inherits: false;
}

适用:首页 Feature 卡片、Skill 流水线卡片、团队成员卡片

2. Spotlight / Cursor Glow(光标追踪光效)

鼠标移动时卡片背景产生柔和的聚光灯效果(团队卡片已有,可推广全局)。

css
.card:hover::after {
  background: radial-gradient(
    600px circle at var(--mouse-x) var(--mouse-y),
    rgba(99, 102, 241, 0.06), transparent 40%
  );
}

适用:所有可交互卡片、侧边栏 hover 效果

3. Scroll-Triggered Reveal(滚动触发入场)

Feature 区域和内容区使用 IntersectionObserver 触发 fade-in-up 动画,而非页面加载就全部展示。

typescript
// composable: useScrollReveal
const observer = new IntersectionObserver((entries) => {
  entries.forEach(e => {
    if (e.isIntersecting) {
      e.target.classList.add('revealed');
      observer.unobserve(e.target);
    }
  });
}, { threshold: 0.1, rootMargin: '0px 0px -60px 0px' });

适用:首页 Feature grid、文档页 h2 章节、统计数字

4. Glassmorphism Nav(毛玻璃导航栏)

导航栏增加 backdrop-filter: blur + 半透明背景,滚动时生效。

css
.VPNav {
  background: rgba(9, 9, 11, 0.72) !important;
  backdrop-filter: saturate(180%) blur(20px) !important;
  -webkit-backdrop-filter: saturate(180%) blur(20px) !important;
}
:root:not(.dark) .VPNav {
  background: rgba(255, 255, 255, 0.78) !important;
}

适用:全局导航栏(参考 Apple 官网的滚动导航效果)

5. Typed Number Counter(数字滚动动画)

首页统计数字(精选 Skill / 最佳实践 / AI 工作流)使用 countUp.js 或 CSS counter 滚动效果。

适用:首页 Stats 区域

⚡ 中优先(进阶提升)

6. Bento Grid Layout(便当盒布局)

Apple 风格的不等大卡片网格,大卡片 2:1、小卡片 1:1 混排。

┌──────────────┬───────┐
│              │       │
│   大卡片      │ 小卡片 │
│   (2 col)    │       │
├───────┬──────┴───────┤
│       │              │
│ 小卡片 │   大卡片      │
│       │   (2 col)    │
└───────┴──────────────┘

适用:首页 Feature 区域重构、Skill 总览页

7. Dark Mode Glow Typography(发光文字)

标题文字增加柔和的 text-shadow 发光效果(仅暗色模式)。

css
.dark .hero-title .title-gradient {
  text-shadow: 0 0 80px rgba(99, 102, 241, 0.5);
}
.dark .section-heading {
  text-shadow: 0 0 40px rgba(99, 102, 241, 0.15);
}

适用:首页标题、各章节标题

8. Animated Skeleton Loading(骨架屏)

页面切换时使用渐变闪烁骨架屏过渡,而非白屏/闪屏。

适用:路由切换、团队页加载

9. Interactive Flow Diagram(交互式流程图)

Skill 流水线页面使用 SVG 动画流程图(带脉冲连线 + hover 高亮),替代纯文本 ASCII 流程图。

适用skill-pipeline.md 页面

10. Gradient Divider(渐变分割线)

章节间分割线从纯色 1px 升级为渐变淡入淡出分割线。

css
.section-divider {
  height: 1px;
  background: linear-gradient(90deg,
    transparent, var(--vp-c-brand-1), var(--vp-c-brand-2), transparent
  );
  opacity: 0.3;
}

适用:全局章节分割、首页 section 之间

🎨 低优先(锦上添花)

11. Particle / Star Field Background(粒子星空背景)

首页 Hero 区域增加轻量粒子效果(不用 canvas,用纯 CSS 实现星点闪烁)。

12. 3D Tilt Card(3D 倾斜卡片)

团队卡片在 hover 时增加 3D 透视倾斜效果(transform: perspective(800px) rotateY())。

13. Animated Code Block(代码块打字机效果)

首页或文档中的核心代码块使用打字机动画逐行展示。

14. Dark/Light Mode Transition(主题切换过渡动画)

切换明暗模式时使用圆形扩散 clip-path 过渡(参考 VitePress 新版的 View Transition API)。

15. Magnetic Button(磁吸按钮)

CTA 按钮在鼠标靠近时产生微妙的"被吸引"偏移效果。


四、实施优先级矩阵

效果复杂度视觉冲击力破坏性推荐优先级
Glassmorphism Nav⭐⭐⭐⭐⭐
Animated Gradient Border⭐⭐⭐⭐⭐
Glow Typography (dark)⭐⭐⭐⭐
Gradient Divider⭐⭐⭐⭐
Scroll-Triggered Reveal⭐⭐⭐⭐
Cursor Glow (全局)⭐⭐⭐⭐
Number Counter⭐⭐⭐
Bento Grid⭐⭐⭐
Interactive Flow Diagram⭐⭐⭐
3D Tilt Card⭐⭐
Particle Background⭐⭐
Theme Transition⭐⭐
Skeleton Loading⭐⭐
Animated Code Block
Magnetic Button

五、技术栈兼容性

效果依赖现有技术栈支持
CSS 动画类(border/glow/divider)纯 CSS / SCSS✅ 直接用
backdrop-filter浏览器原生✅ 现有团队卡片已用
Scroll RevealIntersectionObserver✅ Vue composable
Number CountercountUp.js 或纯 JS✅ 轻量
SVG Flow Diagram纯 SVG + CSS animation✅ 嵌入 Vue 组件
View TransitionVitePress 内置支持✅ alpha.12 已支持
@property (渐变角度动画)CSS Houdini⚠️ Firefox 127+ 才支持

六、总结

当前项目的 Linear × Apple Premium 风格已经是顶级文档站审美层次,主要可以在以下方向继续提升:

  1. 深度(Depth) — Glassmorphism Nav + Glow Typography,增加层次感
  2. 动效(Motion) — Scroll Reveal + Gradient Border,增加生命感
  3. 交互(Interaction) — Cursor Glow 全局化 + Interactive Diagram,增加参与感
  4. 细节(Polish) — Gradient Divider + Number Counter,增加精致度

建议实施路线:先做 Glassmorphism Nav + Glow Typography + Gradient Divider(半天可完成),再做 Scroll Reveal + Gradient Border(1 天),最后按需做 Bento Grid 和 Interactive Flow。

You may not distribute, modify, or sell this software without permission.