Portfolio Genesis
一键生成作品集。生成完整的、可部署的网站,具备专业的 GSAP 动画、响应式设计以及独特的美感,看起来像手工制作,而非 AI 生成。用户只需在浏览器中打开 index.html,即可看到高质量的作品集。
理念
- 每个作品集都在讲述一个故事。设计本身即是作品集中的第一个项目。
- 反模板化:生成的任何两个作品集看起来都不相同。主题由用户的领域、个性和基调驱动。
- “打开 index.html,让你惊叹”——零 npm,零构建步骤,即时满足。
- 约束即自由:原生 HTML/CSS/JS + GSAP 迫使你使用手工感的创意 CSS。
- 三个精心呈现的项目胜过二十个普通卡片。质量胜于数量。
- 滚动体验即是作品集本身。每次像素滚动都应感觉有目的性。
流程
第 1 步:信息收集
从用户提示中提取:
- 身份:姓名、昵称/别名、角色/头衔
- 简介:1-3 句话(如果未提供,则根据上下文综合)
- 项目:标题、描述、标签、链接、交易金额、角色
- 社交:X、Discord、Telegram、GitHub、LinkedIn、邮箱、YouTube(只包含已提供的)
- 头像:文件路径或使用姓名首字母生成 CSS 渐变圆
- 统计:经验年限、项目数量、社区影响力、探索过的工具
- 基调:专业 | 黑客 | 创意 | 优雅 | 俏皮 | 简约 | 赛博
如果用户提供的信息极少,则生成具有上下文相关占位数据的内容,并标记注入点:<!-- CUSTOMIZE: Replace with your Twitter handle -->。如果未提供任何 URL,则完全省略社交按钮——切勿渲染 href="#"。
第 2 步:主题选择
使用下面的决策树从 5 个主题中进行选择。然后阅读 references/themes/{theme-name}.md 中的主题文件。
用户是否在加密/Web3/区块链领域?
是 → 提到了“干净”/“简约”? → mono-minimal
否则 → midnight-glass(默认)或 neon-cyberpunk(如果提到了“霓虹”/“赛博”)
用户是否是设计师/艺术家/创意工作者?
是 → 偏好深色? → midnight-glass
否则 → warm-organic(默认)或 paper-brutalist(如果提到了“编辑”/“印刷”)
用户是否是开发者/工程师?
是 → midnight-glass(默认)或 mono-minimal(如果提到了“干净”/“简约”)
用户是否是学生/初学者?
是 → warm-organic(友好)或 neon-cyberpunk(如果年轻/有活力)
用户是否是商务/专业人士?
是 → mono-minimal(默认)或 warm-organic(如果“平易近人”)
显式覆盖(最高优先级):
“深色”/“玻璃” → midnight-glass
“浅色”/“干净”/“纸张” → paper-brutalist
“霓虹”/“赛博”/“未来主义” → neon-cyberpunk
“温暖”/“大地色”/“有机” → warm-organic
“简约”/“单色”/“排版” → mono-minimal
第 3 步:生成文件
按此顺序读取参考文件:
references/themes/{selected-theme}.md——颜色、字体、卡片样式references/animations/gsap-patterns.md——动画配方references/sections/hero-variants.md——选择英雄布局references/typography/font-pairings.md——确认字体选择
准确生成 3 个文件:index.html、css/style.css、js/main.js
英雄布局决策
是否提供了头像图片?
是 → 居中头像(默认)
例外:拥有强大项目展示的设计师 → 分割英雄
否 → 强调标题/标语? → 全屏排版
否则 → 简约(姓名 + 角色 + 滚动指示器)
角色描述数量:
1 → 单个大号副标题
2-3 → 点分隔的副标题行
4+ → 使用 GSAP 文本交换实现动画角色轮换
项目部分决策
项目数量:
0 → 跳过项目。改为添加技能/技术标签云部分
1-2 → 大型特色卡片(全宽或 2 列并带有额外内边距)
3-4 → 两列网格,尺寸相等
5-8 → Bento 网格(1 个大卡片 + 若干小卡片)
9+ → 显示前 6 个项目并带有“查看全部”链接,或水平滚动
第 4 步:质量检查
在输出文件之前,运行交付前检查清单。
输出结构
index.html
完整的语义化 HTML5。包含 Google Fonts 和 GSAP 3.12.5 的 CDN 链接。所有内容内联。部分:导航、英雄、关于、项目(如适用)、可选的字幕/技能、联系、页脚。包括:
<!DOCTYPE html>、<html lang="en">、charset、viewport<title>包含用户姓名 + 角色<meta name="description">包含简介- OG 标签:
og:title、og:description、og:type(website) - Google Fonts
<link rel="preconnect">+ 样式表 - GSAP + ScrollTrigger CDN,带有
defer <link rel="stylesheet" href="css/style.css"><script src="js/main.js" defer>位于 body 末尾
css/style.css
所有样式。在 :root 定义 CSS 自定义属性(至少 20 个变量,涵盖颜色、字体、间距、圆角、缓动)。完全响应式(768px + 480px 断点)。必须包括:
- 重置:
*, *::before, *::after { margin:0; padding:0; box-sizing:border-box } html { scroll-behavior: smooth }+ 自定义滚动条body { overflow-x: hidden; -webkit-font-smoothing: antialiased }::selection使用主题强调色- 噪点叠加(内联 SVG feTurbulence,透明度 0.02-0.04)
.reveal-up { opacity: 0; transform: translateY(30px) }初始状态@media (prefers-reduced-motion: reduce)——禁用所有动画,隐藏光标发光- 每个装饰性固定/绝对定位元素:
pointer-events: none
js/main.js
包装在 DOMContentLoaded 中的 GSAP 动画。以 GSAP 可用性检查开始:
if (typeof gsap === 'undefined') {
document.querySelectorAll('.reveal-up').forEach(el => {
el.style.opacity = '1';
el.style.transform = 'none';
});
return;
}
注册 ScrollTrigger。包含:英雄入场时间线、滚动揭示、统计计数器、卡片倾斜、光标发光、磁性按钮、视差效果、导航收缩。阅读 references/animations/gsap-patterns.md 了解精确实现。
个性化点
| 位置 | 数据源 | 备用方案 |
|---|---|---|
<title> | 姓名 + 角色 | “Portfolio” |
<meta description> | 角色 + 技能 | 根据角色生成 |
| OG 标签 | 与标题/描述相同 | 相同 |
| 导航标志 | 括号中的句柄 [MX] | 姓名首字母 |
| 英雄 h1 | 角色或身份陈述 | 领域 + “Builder” |
| 英雄副标题 | 用 · 分隔的角色 | 3 个技能领域 |
| 英雄徽章 | @句柄 | “@username” |
头像 src + alt | 用户路径 | 带有姓名首字母的 CSS 渐变圆 |
| 社交按钮 | 仅实际 URL | 如果无 URL 则省略按钮 |
| “关于”标题 | 个人陈述 | “Building at the intersection of X, Y & Z” |
| “关于”简介 | 用户提供或综合 | 3 句简介 |
| 标签 | 技能领域 | 根据角色/项目生成 |
| 统计卡片 | 实际数字 + 标签 | 根据上下文估算 |
| 项目卡片 | 标题、描述、标签、链接 | 根据项目信息生成 |
| 联系卡片 | 平台、句柄、URL | 仅已提供的平台 |
| 页脚 | 姓名 + new Date().getFullYear() | 通过 JS 动态年份 |
反模式
| # | 反模式 | 为什么会失败 | 应该怎么做 |
|---|---|---|---|
| 1 | 使用 Inter/Roboto 作为标题字体 | 立即暴露为“AI 生成”。这些是正文字体,不是展示字体。 | 使用独特的展示字体:Syne、Outfit、Instrument Serif、Bricolage Grotesque、Unbounded |
| 2 | 白色背景上的紫色渐变 | 自 2023 年以来排名第一的“AI 生成垃圾”视觉陈词滥调。每个人都能认出。 | 深色背景搭配鲜艳强调色,或温暖调色板。 |
| 3 | 默认使用 Space Grotesk | 2023 年时还独特,现在成为 AI 生成网站中最过度使用的字体。 | 在 12 个精选配对中轮换。仅当用户明确品牌使用时才使用。 |
| 4 | opacity:0 没有 GSAP 备用方案 | 如果 GSAP CDN 失败,整个站点不可见。空白页面。 | JS 第一行:检查 typeof gsap,如果未定义,将所有 .reveal-up 设置为可见。 |
| 5 | 出色的英雄区域,折线以下部分平庸 | “惊叹”在滚动时消失。电影级英雄区域下方是千篇一律的卡片。 | 每个部分都给予同等的设计关注。滚动之旅即是作品集本身。 |
| 6 | 社交链接使用 href="#" | 使网站明显是假的。破坏可信度。 | 使用实际 URL。如果未提供,则完全省略按钮。 |
| 7 | 所有地方使用相同的动画时间设置 | 所有内容以相同速度和相同缓动进行,感觉像机器人。 | 变化持续时间(0.4s-1.2s)。每个元素使用不同的缓动。使用负偏移交错。 |
| 8 | 装饰元素没有 pointer-events: none | 装饰球、噪点、光标发光会阻挡下方内容的鼠标点击。 | 每个装饰性固定/绝对定位元素都获得 pointer-events: none。 |
| 9 | 渐变文本位于渐变背景上 | 无法阅读。两个竞争渐变相互抵消。 | 渐变文本仅位于纯色/接近纯色的深色背景上。每个视觉区域一个渐变。 |
| 10 | 卡片上缺少 cursor: pointer | 卡片看起来可交互,但光标保持默认,用户困惑。 | 在每个具有悬停状态或点击处理程序的元素上设置 cursor: pointer。 |
| 11 | 在 UI 中使用 Emoji 图标 | 普遍的“AI 制造”信号。没有设计努力。 | 来自 assets/social-icons.svg 的内联 SVG。导航、按钮、标题中无 emoji。 |
| 12 | width: 100vw | 在 Windows 上,包含滚动条宽度 → 水平溢出。 | 使用 width: 100% 或 overflow-x: hidden(在 body 上)。 |
| 13 | 为 5 个图标加载图标库 | 额外的 HTTP 请求、FOUC、CDN 依赖,只为约 2KB 的 SVG 路径。 | 直接在 HTML 中内联 SVG。5-8 个社交图标约 2KB 内联。 |
| 14 | 通用 CTA 文本 | “Let's Connect” / “Get In Touch”——每个 AI 作品集都使用这些。 | 匹配个性:"Let's Build Something"(建设者)、“Say gm”(加密)、“Drop a Line”(休闲)。 |
| 15 | 头像缺少 alt | 无障碍失败。屏幕阅读器不宣布任何内容。 | alt="[用户姓名]" ——简单、描述性。 |
| 16 | 4 种以上颜色的彩虹渐变文本 | 看起来像玩具。多色渐变很少有效。 | 最多 2-3 种来自同一色系的颜色(粉色→紫色,不是粉色→绿色→蓝色)。 |
必需动画
阅读 references/animations/gsap-patterns.md 了解实现。每个站点必须包含:
- 英雄入场时间线 —— 交错
.from():头像(back.out)、徽章、标题行、副标题、社交图标(back.out 交错)、滚动指示器。使用负偏移重叠。 - 滚动揭示 ——
.reveal-up元素从{y:30, opacity:0}动画,起始点为start: "top 85%"。在视口组内交错。 - 统计计数器 —— 通过
onUpdate从 0 动画到目标值。滚动时触发。 - 卡片倾斜 —— mousemove → 根据光标偏移旋转
rotateX/rotateY。transformPerspective: 1000。鼠标离开时重置。 - 光标发光 —— 600px 径向渐变跟随鼠标,使用
requestAnimationFrame+ 0.08 线性插值。 - 磁性按钮 —— 社交按钮向光标移动(0.3x 因子),使用
elastic.out(1, 0.5)弹回。 - 视差背景 —— 装饰性元素在滚动时移动,使用
scrub: 1。 - 导航收缩 —— 在 80px 滚动深度时切换
.scrolled类。
可选(根据主题/内容添加):
- 带滚动速度提升的跑马灯
- 逐字母分割文本揭示(赛博朋克/戏剧性)
- 5 个以上项目的水平滚动
- 悬停时渐变文字闪烁
- 部分标签从左滑入
质量检查清单
结构:
- 生成了所有 3 个文件(index.html、css/style.css、js/main.js)
- 存在 DOCTYPE、charset、viewport、lang 属性
- 包含用户实际信息的 OG 元标签
-
:root中的所有 CSS 自定义属性 - 带有
defer的 GSAP CDN 链接 - JS 在 body 末尾使用
defer链接
内容:
- 注入了所有用户数据(姓名、链接、项目、简介)
- 没有通用占位符(“Lorem ipsum”、“Your Name Here”)
- 社交链接使用实际 URL,对于已提供的链接没有
href="#" - 页脚具有正确的姓名和动态年份
视觉:
- 字体配对不是 Inter、Roboto、Arial 或 Space Grotesk(除非用户指定)
- 没有紫色配白色的配色方案
- UI 中没有 Emoji 图标
- 颜色对比度符合 WCAG AA 标准(正文文本 4.5:1)
- 在 375px、768px、1440px 分辨率下响应式良好——没有水平滚动
-
prefers-reduced-motion禁用动画并隐藏光标发光
技术:
- 存在 GSAP 备用方案(typeof 检查 + 透明度重置)
- 所有装饰性元素都有
pointer-events: none - CSS 中没有
width: 100vw - 所有交互元素都有
cursor: pointer - 图片有
alt属性 - 外部链接有
target="_blank" rel="noopener"