design: 增强设计系统(渐变/玻璃拟态/SEO-GEO/页面布局) + 元宝提示词解读
This commit is contained in:
1 parent
e7dc9808c0
commit
a1bea39d9f
2 files changed
+180
-4
No files matched your search
@@ -1,7 +1,7 @@
|
||||
# 七虎AI · DESIGN.md
|
||||
|
||||
> **用途**:这是七虎 AI PaaS 平台的**唯一设计事实源(single source of truth)**。任何 AI 编码代理在新增/修改前端页面或组件时,必须读取本文件并严格遵守其中的设计 token、组件规范与 Do/Don't。
|
||||
> **风格方向**:温暖科技感 + 极简主义(Warm Tech Minimalism)。浅色为主,靛蓝 `#5B5FED` 为唯一品牌色。
|
||||
> **风格方向**:温暖科技感 + 极简主义(Warm Tech Minimalism)。浅色为主(护眼雾白底),靛蓝 `#5B5FED` 为唯一品牌色;允许克制的「淡蓝紫→淡青蓝」渐变与轻量玻璃拟态(Glassmorphism);前台必须符合 SEO/GEO 语义规范。
|
||||
> **生成方式**:基于平台现有 `frontend/src/styles/global.css` 的真实 token 固化升华,并经由 `ui-ux-pro-max` 技能的数据驱动生成器校验风格一致性。
|
||||
> 关联文件:`design-system/MASTER.md`(Master+Overrides 模式,含组件 CSS 样板)、`.impeccable.md`(impeccable 技能入口)。
|
||||
|
||||
@@ -64,6 +64,19 @@
|
||||
| `--color-sidebar-hover` | `#EAECF2` | 侧栏项 hover |
|
||||
| `--color-sidebar-active` | `#E1E3F0` | 侧栏项激活 |
|
||||
|
||||
### 渐变 / Gradients(新增,源自"护眼科技感 + 渐变"需求)
|
||||
平台允许**克制**的渐变,用于背景 / 装饰 / 主行动点,绝非赛博朋克式高饱和。所有渐变必须先定义为 token:
|
||||
| 语义名 | 值 | 角色 |
|
||||
|---|---|---|
|
||||
| `--gradient-brand` | `linear-gradient(135deg, #EEEDFF 0%, #E3F0FF 100%)` | Hero / 区块浅底(淡蓝紫 → 淡青蓝) |
|
||||
| `--gradient-brand-strong` | `linear-gradient(135deg, #5B5FED 0%, #4F8DF9 100%)` | 主 CTA / Banner 强调(品牌色渐变,不刺眼) |
|
||||
| `--gradient-aurora` | `radial-gradient(60% 60% at 30% 20%, rgba(91,95,237,.10), transparent 70%)` | 仅 Hero 装饰光斑,绝不直接衬文字 |
|
||||
|
||||
**渐变铁律**:
|
||||
- 渐变只作背景 / 装饰 / CTA;**承载正文文字的表面必须纯色**(`#FFFFFF` / `#F8F9FB`),确保 ≥4.5:1。
|
||||
- 拒绝全屏流动 / 循环渐变动画(aurora 8–12s loop)作用于文字区;装饰光斑在 `prefers-reduced-motion` 下静止。
|
||||
- 不引入品牌色之外的第三色相做渐变(仅「靛蓝 → 青蓝」的同系过渡)。
|
||||
|
||||
**对比度约束**:文本在浅色表面上至少 4.5:1(WCAG AA)。`--color-text-tertiary` 仅用于非关键提示,不用于正文。
|
||||
|
||||
## 3. Typography Rules
|
||||
@@ -117,6 +130,24 @@
|
||||
- overlay:`rgba(0,0,0,0.5)` + `backdrop-filter: blur(4px)`。
|
||||
- 弹窗:`background:#fff; border-radius: var(--radius-xl); padding: var(--space-3xl); box-shadow: var(--shadow-xl);` 右侧抽屉(detail drawer)用于 Agent/技能详情。
|
||||
|
||||
### Glassmorphism(轻量玻璃拟态变体)
|
||||
用于浮层 / 导航 / Hero 叠加 / 横幅,营造通透科技感(技能库 Glassmorphism 条目:backdrop blur 10–20px、半透明白 15–30%、细边框)。
|
||||
```css
|
||||
.glass {
|
||||
background: rgba(255,255,255,0.65);
|
||||
backdrop-filter: blur(16px) saturate(140%);
|
||||
-webkit-backdrop-filter: blur(16px) saturate(140%);
|
||||
border: 1px solid rgba(255,255,255,0.7);
|
||||
box-shadow: var(--shadow-md);
|
||||
}
|
||||
```
|
||||
- 浮层导航 / 横幅 / Hero 卡片用 `.glass`;**正文内容卡保持纯白 `#FFFFFF`**(对比与清晰度优先)。
|
||||
- 文字在玻璃面上必须 ≥4.5:1(玻璃面下若为渐变底,需加深文字或加底纹)。
|
||||
|
||||
### Neumorphism(默认禁用)
|
||||
用户原话提到"轻拟态(Neumorphism)或玻璃拟态的轻量化变体"。技能库明确标注 Neumorphism **对比度低(⚠ Low contrast)**,不利护眼。
|
||||
**决策:默认禁用完整新拟态**;若需"轻量"立体感,仅允许在**无文字的装饰表面**用极淡 inset 阴影,且不得影响可读性。优先采用 Glassmorphism 轻量变体。
|
||||
|
||||
## 5. Layout Principles
|
||||
|
||||
- **间距阶梯**(必须用语义 token,禁止随意像素):`xs4 / sm8 / md12 / lg16 / xl20 / 2xl24 / 3xl32 / 4xl40 / 5xl48`。
|
||||
@@ -159,12 +190,63 @@
|
||||
## 8. Responsive Behavior
|
||||
|
||||
断点:`375px`(手机)/ `768px`(折叠 sidebar 为 64px 或抽屉)/ `1024px`(平板)/ `1440px`(桌面最大宽)。
|
||||
- 移动端:sidebar 转底部 tab 或抽屉;主内容单列;触摸目标 ≥40px。
|
||||
- 移动端:sidebar 转**底部 tab 栏**(前台门户)或**左侧抽屉**(后台,因菜单项多);主内容单列;触摸目标 ≥44px。
|
||||
- 平板:sidebar 折叠 64px,悬停展开。
|
||||
- 栅格在窄屏降列数(12→6→1)。
|
||||
- 禁止横向滚动;表格在窄屏转卡片或横向滚动容器。
|
||||
- 禁止横向滚动;表格在窄屏转卡片或横向滚动容器(包 `overflow-x-auto`)。
|
||||
- 必须 `<meta name="viewport" content="width=device-width, initial-scale=1">`;固定导航需 `padding-top` 补偿高度,避免遮挡首屏内容。
|
||||
|
||||
## 9. Agent Prompt Guide
|
||||
## 10. SEO & GEO 规范(前台必须)
|
||||
|
||||
平台需"不推广也能被搜索引擎与各大模型联网搜索(GEO)发现"。
|
||||
|
||||
### 结构(语义化 HTML5)
|
||||
- 每页一个 `<h1>`;区块用 `<section>` / `<article>`;技能卡用 `<article>` 包裹(标题 `<h2>`/`<h3>`)。
|
||||
- 必须 `<meta name="viewport">`、`<title>`、`<meta name="description">`、Open Graph 标签。
|
||||
- 前台用 `<header><nav><main><footer>` 语义骨架;后台为应用壳,SEO 权重低。
|
||||
|
||||
### 富媒体摘要(Rich Snippets / JSON-LD)
|
||||
- 技能页 / 技能卡:`SoftwareApplication` schema,含 `aggregateRating`、`offers`(`price:0` / 订阅)、`downloadCount`。
|
||||
- 技能市场:`BreadcrumbList`;痛点 / FAQ 区:`FAQPage`。
|
||||
- 预留展示槽:评分星、价格、下载量在卡片右上角(Lucide 图标 + 数字,非 emoji)。
|
||||
|
||||
### 关键词突出(GEO 友好)
|
||||
- 核心词「无限Token」「AI变现」「办公提效」「低成本养龙虾(= 低成本微调 / 托管模型)」用 `.kw` 样式(品牌色 + 600 字重)在首页价值区高亮。
|
||||
- `.kw { color: var(--color-accent); font-weight:600; }`
|
||||
|
||||
### 技术
|
||||
- `sitemap.xml` + `robots.txt`;技能详情独立可索引 URL;所有图片 `alt`。
|
||||
|
||||
## 11. 页面级布局总览(前台 + 后台)
|
||||
|
||||
> 详细页级 override 将在实际开发时落入 `design-system/pages/*.md`(Master + Overrides)。此处为总览与验收基准。
|
||||
|
||||
### 前台首页(Home)
|
||||
1. 浮层玻璃顶栏(logo + 主导航 + 登录 / 注册)
|
||||
2. Hero:轮播 Banner(技能广告位)+ 平台定位一句话 + 主 CTA
|
||||
3. 平台定位区:图标 + 短文网格(痛点:API 贵 / Prompt 难调试 / 数据孤岛 / 无变现渠道)
|
||||
4. 平台价值区:可视化数据点(低价订阅 / 无限 Token / 垂直办公模板 / 交易市场 / 低成本养龙虾)
|
||||
5. 热门技能榜 Top5(排行榜 / 徽章)
|
||||
6. Footer(SEO 链接 + 富媒体摘要)
|
||||
|
||||
### 技能市场(Skill Market)
|
||||
- 顶部广告位 → 左侧筛选(分类 / 场景标签)→ 右侧卡片流(每排 5,图标 / 名称 / 简介 / 下载量)
|
||||
- 分页:每页 100,上下翻页;每个技能 = `<article>` + JSON-LD
|
||||
|
||||
### 应用服务(Apps)
|
||||
- 网格布局;每应用独立卡片(名称 / 介绍 / 「进入应用」按钮)
|
||||
|
||||
### 用户工作台(Workspace,登录后)
|
||||
- 左侧固定导航:AI 聊天 / IM Bot(子:微信 / 企微 / 飞书 / QQ / 悟空 IM)/ 知识库 / 技能市场 / 应用服务 / Token 驾驶舱 / 会员订阅 / 进化看板 / 个人设置
|
||||
- 右侧内容区留白;移动端导航转抽屉
|
||||
|
||||
### 后台数据驾驶舱(Admin Dashboard)
|
||||
- 6 张 KPI 卡:总用户 / 7日活跃、模型统计(启用 / 全部)、对话统计(有效 / 活跃窗口)、知识库文档数、今日订阅(成功)、Token 消耗(今日 / 本周)
|
||||
- 大模型消耗趋势(近 30 天 面积图)
|
||||
- 操作日志 + 审计日志 双栏(每 20 条 / 页,可下载)
|
||||
- 其余后台:AI 技能中心 / 平台运营 / 商业变现 / 系统管理(标准 B 端布局,侧栏分类清晰)
|
||||
|
||||
## 12. Agent Prompt Guide
|
||||
|
||||
> 当被要求"做/改一个七虎AI 的页面或组件"时,代理必须:
|
||||
> 1. 先读本文件(DESIGN.md)与 `design-system/MASTER.md`;
|
||||
@@ -182,8 +264,12 @@ text #101214 secondary #545A65 tertiary #8B919E
|
||||
ok #219B5E warn #E8922C err #D9383A info #3B82F6
|
||||
border #E3E6EB sidebar #F5F6F9
|
||||
font Inter / JetBrains Mono
|
||||
grad --gradient-brand (淡紫→淡青) / --gradient-brand-strong (靛蓝→青蓝 CTA)
|
||||
glass .glass (rgba(255,255,255,.65) + blur(16px) + 1px 白边)
|
||||
kw .kw 高亮关键词(无限Token/AI变现/办公提效)
|
||||
```
|
||||
|
||||
**推荐 prompt 模板**
|
||||
- "在七虎AI 中新增一个 [页面],遵循 DESIGN.md 的 Warm Tech Minimalism 风格,品牌色用 #5B5FED,图标用 Lucide,间距用 token。"
|
||||
- "把 [组件] 改成符合 DESIGN.md §4 的卡片规范,hover 用 --shadow-lg + translateY(-2px)。"
|
||||
- "新增前台 [页面] 时遵循 DESIGN.md §10 的 SEO/GEO 规范:语义化 HTML5 + JSON-LD 富媒体摘要 + `.kw` 高亮核心词;Hero/Banner 可用 `.glass` 与 `--gradient-brand`。"
|
||||
Reference in new issue
Block a user