299 lines
10 KiB
Markdown
299 lines
10 KiB
Markdown
# EPEEKit 视觉风格指南
|
||
|
||
> 设计语言：**白底青绿 · 绢本山水**（灵感来源于《千里江山图》）
|
||
> 更新日期：2026-04-16
|
||
|
||
## 1. 设计语言总结
|
||
|
||
### 核心风格关键词
|
||
|
||
- **绢本白底** — 画卷绢纸的微暖白色，取代暗色系背景
|
||
- **石青石绿** — 千里江山图中的矿物质颜料色，用于框体边框和高亮
|
||
- **云烟雾气** — 所有发光和动画效果模拟山间云烟缓慢飘散
|
||
- **白纱玻璃** — 白色半透明毛玻璃面板，如薄纱覆于绢面
|
||
- **赭金点缀** — 点景人物宫殿的暖色调，用于收藏星标等少量强调
|
||
- **墨色文字** — 正文使用接近墨黑色，清晰可读
|
||
|
||
### 视觉感受
|
||
|
||
> 整体氛围应该是：白色绢底铺展，青绿山色点缀于框体和光效之中，
|
||
> 文字如墨书于纸上，偶有赭金灯火点缀其间。
|
||
> 像在白昼中远眺千里江山，青绿分明而不压迫。
|
||
|
||
---
|
||
|
||
## 2. 色彩体系
|
||
|
||
### 主色调
|
||
|
||
| 语义 | 变量名 | 色值 | 色彩隐喻 |
|
||
|------|--------|------|---------|
|
||
| 背景主色 | `--bg-primary` | `#FAFAF7` | 绢本微暖白 |
|
||
| 背景次级 | `--bg-secondary` | `#F2F1EC` | 绢纸淡米色 |
|
||
| 背景三级 | `--bg-tertiary` | `#E8E6DF` | 染旧的纸色 |
|
||
| 卡片表面 | `--bg-card` | `rgba(255, 255, 255, 0.8)` | 白纱覆面 |
|
||
| 主高亮色 | `--accent` | `#2E8B7A` | 石青 — 千里江山图的石青 |
|
||
| 高亮 hover | `--accent-hover` | `#3AA38E` | 石青亮态 |
|
||
| 辅助高亮 | `--accent-secondary` | `#3A7FB8` | 石绿蓝 — 千里江山图的石绿 |
|
||
| 热门/警告 | `--hot` | `#C4654A` | 赭石红 — 点景人物/宫殿暖色 |
|
||
| 文字主色 | `--text-primary` | `#1A1A1A` | 墨黑 |
|
||
| 文字次级 | `--text-secondary` | `#6B7B8A` | 灰蓝 |
|
||
| 边框色 | `--border` | `rgba(46, 139, 122, 0.15)` | 石青半透明 |
|
||
| 发光边框 | `--border-glow` | `rgba(46, 139, 122, 0.30)` | 石青发光态 |
|
||
| 雾气基础 | `--mist` | `rgba(46, 139, 122, 0.04)` | 淡雅云雾 |
|
||
| 赭金点缀 | `--gold` | `#B8935A` | 用于收藏星标等极少量暖色 |
|
||
|
||
### 色彩来源说明
|
||
|
||
石青（`#2E8B7A`）和石绿蓝（`#3A7FB8`）取自《千里江山图》中使用的矿物质颜料色，
|
||
经过适度加深以确保在白底 UI 上对比度足够、清晰可辨。
|
||
赭石红（`#C4654A`）来源于画中点景人物和宫殿使用的暖色颜料。
|
||
|
||
### 与旧版（暗绿底）的关键差异
|
||
|
||
真正的千里江山图是**青绿设色于绢本白底之上**——山体的石青石绿占据画面，
|
||
但大面积留白（云、水、天际）给了青绿色块呼吸感。旧版将背景设为墨绿深色，
|
||
导致全屏绿色信息量过载，层次反而被压扁。新版回归绢本白底，让青绿色作为
|
||
框体和高亮的点缀，更贴近原画精髓。
|
||
|
||
---
|
||
|
||
## 3. 排版
|
||
|
||
### 字体
|
||
|
||
```css
|
||
font-family: 'Inter', system-ui, -apple-system, sans-serif;
|
||
```
|
||
|
||
### 尺寸梯度
|
||
|
||
| 用途 | 大小 | 字重 |
|
||
|------|------|------|
|
||
| 页面标题 | 20px | 700 |
|
||
| 区块标题 | 16px | 600 |
|
||
| 正文/卡片名 | 14px | 500 |
|
||
| 辅助文字 | 12px | 400 |
|
||
| 标签/徽章 | 11px | 600 |
|
||
|
||
---
|
||
|
||
## 4. 布局架构
|
||
|
||
### 整体结构
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────┐
|
||
│ Top Nav (56px) — 白纱玻璃面板 │
|
||
├──────────┬──────────────────────────────────────────┤
|
||
│ 侧边栏 │ 主内容区（对话 / 资源库） │
|
||
│ (280px) │ (flex-1) │
|
||
│ 会话列表 │ ┌────────────────────────────────────┐ │
|
||
│ 标签筛选 │ │ 对话消息 / 图片网格 │ │
|
||
│ (fog-scroll) │ │ (fog-scroll 雾气边缘) │ │
|
||
│ │ └────────────────────────────────────┘ │
|
||
│ │ 输入区 │
|
||
└──────────┴──────────────────────────────────────────┘
|
||
```
|
||
|
||
### 间距系统
|
||
|
||
- 面板间间距：0（紧贴，用边框分隔）
|
||
- 卡片网格间距：16px
|
||
- 内容区内边距：20px
|
||
- 面板内边距：16px
|
||
|
||
---
|
||
|
||
## 5. 组件风格规范
|
||
|
||
### 5.1 导航栏
|
||
|
||
- 高度 56px，背景 `--bg-secondary` + 毛玻璃
|
||
- Logo 方块使用 `--accent` 背景 + 白色文字 + 石青发光阴影
|
||
- 导航项带图标 + 文字
|
||
- 活动项使用 `.glow-border`（云烟边框）
|
||
- 非活动项 hover 时只显示静态边框，不触发动画
|
||
|
||
### 5.2 侧边栏
|
||
|
||
- 白纱玻璃背景：`bg-[var(--bg-secondary)] backdrop-blur-xl`
|
||
- 对话图标带石青色 drop-shadow 微光
|
||
- 会话列表使用 `.fog-scroll` 实现顶底雾气渐隐
|
||
- 活动会话使用 `.glow-border`
|
||
|
||
### 5.3 聊天消息区
|
||
|
||
- 用户消息：`--accent/8` ~ `--accent/15` 渐变背景，左上切角，墨色文字
|
||
- 助手消息：`.surface-2`（白纱玻璃）+ 石青左边框
|
||
- 加载动画：石青色脉冲圆点
|
||
- 滚动区域使用 `.fog-scroll`
|
||
|
||
### 5.4 资源库卡片
|
||
|
||
- 圆角 12px
|
||
- 使用 `.neon-border` 静态发光边框
|
||
- Hover 时边框微微变亮 + 图片 scale(1.03)
|
||
- 底部信息区：`--bg-secondary/80` 毛玻璃
|
||
|
||
### 5.5 图片详情面板
|
||
|
||
- 白纱玻璃背景：`--bg-secondary/90 backdrop-blur-xl`
|
||
- 操作按钮区：石青主色 + 三级背景辅助色
|
||
|
||
---
|
||
|
||
## 6. 视觉效果
|
||
|
||
### 6.1 白纱玻璃面板
|
||
|
||
```css
|
||
.glass-panel {
|
||
background: rgba(255, 255, 255, 0.65);
|
||
backdrop-filter: blur(20px) saturate(1.1);
|
||
border: 1px solid var(--border);
|
||
}
|
||
```
|
||
|
||
白色半透明底 + 毛玻璃模糊，模拟薄纱覆于绢面的质感。
|
||
|
||
### 6.2 静态发光边框
|
||
|
||
```css
|
||
.neon-border {
|
||
border: 1px solid var(--border); /* rgba(46, 139, 122, 0.15) */
|
||
transition: border-color 200ms ease, box-shadow 200ms ease;
|
||
}
|
||
.neon-border:hover {
|
||
border-color: var(--border-glow); /* rgba(46, 139, 122, 0.30) */
|
||
box-shadow: 0 0 18px rgba(46, 139, 122, 0.08),
|
||
inset 0 0 12px rgba(46, 139, 122, 0.03);
|
||
}
|
||
```
|
||
|
||
### 6.2.1 云烟缭绕边框
|
||
|
||
用于导航活动项、活动会话等"选中态"组件。
|
||
|
||
**交互模式**：
|
||
- **常态（选中）**：石青色微弱均匀静态发光边框 + box-shadow
|
||
- **hover**：云烟缓慢缭绕效果通过 `opacity 600ms ease` 平滑淡入
|
||
- **鼠标移开**：云烟通过 `opacity 600ms ease` 平滑淡散，无跳变
|
||
|
||
**视觉感受**：hover 时边缘有一团朦胧的云烟缓慢飘过，而非锐利的光线旋转。
|
||
|
||
**技术实现**：
|
||
- `@property --glow-angle` 注册可动画角度属性
|
||
- `conic-gradient` 使用 40-50% 的宽弧段，更柔和
|
||
- 旋转周期 6s，模拟云烟的悠缓
|
||
- `::before` — 云烟边框层，mask-composite 裁出 1.5px 边框
|
||
- `::after` — 雾气扩散层，`blur(12px)`
|
||
- 两层伪元素默认 `opacity: 0`，hover 时 `opacity: 1`，transition 600ms
|
||
|
||
```css
|
||
.glow-border {
|
||
border: 1px solid rgba(46, 139, 122, 0.20);
|
||
box-shadow: 0 0 10px rgba(46, 139, 122, 0.06);
|
||
}
|
||
.glow-border::before,
|
||
.glow-border::after {
|
||
animation: mistSpin 6s linear infinite;
|
||
opacity: 0;
|
||
transition: opacity 600ms ease;
|
||
}
|
||
.glow-border:hover::before,
|
||
.glow-border:hover::after {
|
||
opacity: 1;
|
||
}
|
||
```
|
||
|
||
### 6.3 山雾背景
|
||
|
||
背景使用多层缓慢漂移的淡雅云雾（极低透明度，在白底上若隐若现）：
|
||
|
||
```css
|
||
/* 远景雾 — 60s 缓慢漂移 */
|
||
.fog-layer-far {
|
||
inset: -10%;
|
||
background:
|
||
radial-gradient(ellipse 80% 50% at 15% 75%, rgba(46, 139, 122, 0.04) ...),
|
||
radial-gradient(ellipse 60% 40% at 75% 25%, rgba(58, 127, 184, 0.03) ...),
|
||
radial-gradient(ellipse 90% 60% at 50% 50%, rgba(46, 139, 122, 0.02) ...);
|
||
animation: fogDriftFar 60s ease-in-out infinite;
|
||
}
|
||
|
||
/* 近景雾 — 45s 不同速率漂移 */
|
||
.fog-layer-near {
|
||
inset: -15%;
|
||
background:
|
||
radial-gradient(ellipse 70% 45% at 80% 70%, rgba(46, 139, 122, 0.03) ...),
|
||
radial-gradient(ellipse 50% 60% at 25% 30%, rgba(58, 127, 184, 0.025) ...);
|
||
animation: fogDriftNear 45s ease-in-out infinite;
|
||
}
|
||
```
|
||
|
||
两层雾使用不同的漂移速率和方向，模拟远山和近山的视差效果。
|
||
透明度远低于暗色版本，在白底上呈现为淡淡的青绿色氤氲。
|
||
|
||
### 6.4 雾气滚动边缘
|
||
|
||
主要滚动区域（聊天消息、会话列表）的顶部和底部使用渐变遮罩，
|
||
让内容看起来消失在云雾中：
|
||
|
||
```css
|
||
.fog-scroll {
|
||
mask-image: linear-gradient(
|
||
to bottom,
|
||
transparent 0px,
|
||
black 36px,
|
||
black calc(100% - 36px),
|
||
transparent 100%
|
||
);
|
||
}
|
||
```
|
||
|
||
纯 CSS 实现，无 JS 开销。36px 的渐变区域提供柔和的过渡。
|
||
|
||
### 6.5 过渡动画
|
||
|
||
- 所有交互元素：`transition: all 200ms ease`
|
||
- 云烟淡入淡出：600ms ease
|
||
- 面板展开/折叠：250ms ease-in-out
|
||
- 新消息出现：`fadeIn 200ms ease-out` + `translateY(8px → 0)`
|
||
- 背景雾气漂移：45-60s ease-in-out infinite
|
||
|
||
---
|
||
|
||
## 7. 与旧版（暗绿底 Cyberpunk 风格）的对比
|
||
|
||
| 维度 | 旧版暗绿 | 新版白底青绿 |
|
||
|------|----------|------------|
|
||
| 底色 | 墨绿黑 `#0C1210` | 绢本白 `#FAFAF7` |
|
||
| 高亮色 | 石青 `#4DB8A4` | 石青 `#2E8B7A`（加深适配白底） |
|
||
| 文字色 | 微绿月白 `#E0E8E2` | 墨黑 `#1A1A1A` |
|
||
| 面板质感 | 绿底毛玻璃 | 白色毛玻璃 |
|
||
| 背景雾气 | 中等透明度（暗底上可见） | 极低透明度（白底上若隐若现） |
|
||
| 发光效果 | 柔和云烟缓慢缭绕 | 保持，但阴影更轻柔 |
|
||
| 整体感受 | 深夜远山 | 白昼绢本 |
|
||
| 可读性 | 浅色字暗底，OK | 墨色字白底，更佳 |
|
||
|
||
---
|
||
|
||
## 8. 响应式断点
|
||
|
||
| 断点 | 布局 |
|
||
|------|------|
|
||
| ≥768px (md) | 双栏：侧边栏(280px) + 主内容区(flex-1) |
|
||
| <768px | 单栏：侧边栏为固定抽屉 + 主内容区全宽 |
|
||
|
||
---
|
||
|
||
## 9. 设计哲学
|
||
|
||
本风格将中国传统青绿山水画的色彩语言与现代白色 UI 设计融合：
|
||
- **绢本留白**：白底如绢纸铺展，给青绿色块留出呼吸空间
|
||
- **青绿设色**：石青石绿只用于框体边框、高亮和交互反馈，克制而鲜明
|
||
- **自然动效**：所有动画模拟自然现象（云烟飘动），而非机械闪烁
|
||
- **墨色可读**：正文使用接近纯黑的墨色，在白底上对比度极佳
|
||
- **雾气意境**：从边框云烟到背景漂移到滚动渐隐，统一的"雾"意象贯穿全站
|