作品集生成器
一鍵生成作品集。產生完整、可部署的網站,具備專業的 GSAP 動畫、響應式設計,以及看起來像手工打造的獨特美學——絕非 AI 生成。使用者只需在瀏覽器中開啟 index.html,就能看到一個具備生產級品質的作品集。
理念
- 每個作品集都在訴說一個故事。設計本身就是作品集中的第一個項目。
- 反模板:生成的任何兩個網站看起來都不會一樣。主題由使用者的領域、個性和語氣驅動。
- 「開啟 index.html,然後發出 WOW 的讚嘆」——零 npm、零建置步驟,即時獲得滿足感。
- 限制 = 自由:純 vanilla HTML/CSS/JS + GSAP 迫使你創作出感覺像手工打造的創意 CSS。
- 包含 3 個精心呈現的項目的作品集,勝過 20 個一般卡片。重質不重量。
- 滾動體驗本身就是作品集。每一個滾動的像素都應該感覺是刻意的。
流程
步驟 1:資訊收集
從使用者提示中提取:
- 身份:姓名、代號/別名、角色/職稱
- 簡歷:1-3 句話(若未提供,則從上下文綜合)
- 項目:標題、描述、標籤、連結、交易金額、角色
- 社交連結:X、Discord、Telegram、GitHub、LinkedIn、電子郵件、YouTube(僅包含有提供的)
- 頭像:檔案路徑或使用姓名縮寫生成 CSS 漸層圓形
- 統計數據:經驗年資、項目數量、社群觸及率、已探索的工具
- 語氣:專業 | 駭客 | 創意 | 優雅 | 俏皮 | 極簡 | 賽博
如果使用者提供的輸入極少,則生成具有上下文相關佔位符數據的內容,並標記注入點:<!-- CUSTOMIZE: 替換為你的 Twitter 帳號 -->。如果完全未提供 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 → 2 欄網格,尺寸相等
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"></body>前的最後一個<script src="js/main.js" defer>
css/style.css
所有樣式。CSS 自訂屬性放在 :root(至少 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)— 停用所有動畫,隱藏游標光暈- 每個裝飾性的 fixed/absolute 元素:
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 個技能領域 |
| 英雄徽章 | @handle | 「@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 | 沒有 GSAP 備用方案的 opacity:0 | 如果 GSAP CDN 失敗,整個網站都看不見。空白頁面。 | JS 第一行:檢查 typeof gsap,如果未定義則將所有 .reveal-up 設為可見。 |
| 5 | 英雄區塊很棒,但摺疊線以下很普通 | 「WOW」的感覺在滾動時消失。電影般的英雄區塊下方是千篇一律的卡片。 | 每個區段都獲得同等的設計關注。滾動之旅本身就是作品集。 |
| 6 | 社交連結使用 href="#" | 使網站明顯是假的。扼殺可信度。 | 使用實際 URL。如果沒有提供,則完全省略該按鈕。 |
| 7 | 到處使用相同的動畫時間 | 所有東西都以相同的速度和相同的緩動函數移動,感覺很機械。 | 變化持續時間(0.4s-1.2s)。每個元素使用不同的緩動函數。使用負偏移交錯。 |
| 8 | 裝飾元素沒有 pointer-events: none | 球體、噪點、游標光暈會阻擋下方內容的滑鼠點擊。 | 每個裝飾性的 fixed/absolute 元素都獲得 pointer-events: none。 |
| 9 | 漸層文字搭配漸層背景 | 無法閱讀。兩個競爭的漸層互相抵消。 | 漸層文字僅用於純色/接近純色的深色背景。每個視覺區域一個漸層。 |
| 10 | 卡片上缺少 cursor: pointer | 卡片看起來可互動,但游標保持預設。使用者會困惑。 | 每個具有懸停狀態或點擊處理器的元素都加上 cursor: pointer。 |
| 11 | 在使用者介面中使用表情符號圖示 | 普遍的「AI 做的」信號。沒有設計用心。 | 從 assets/social-icons.svg 使用內聯 SVG。導航、按鈕、標頭中不使用表情符號。 |
| 12 | width: 100vw | 在 Windows 上有捲軸時,會包含捲軸寬度 → 水平溢出。 | 使用 width: 100% 或 body 上的 overflow-x: hidden。 |
| 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="[User's name]" — 簡單、描述性。 |
| 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 lerp。 - 磁性按鈕 — 社交按鈕朝游標移動(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 meta 標籤
- 所有 CSS 自訂屬性都在
:root中 - 帶有
defer的 GSAP CDN 連結 - JS 在 body 底部使用
defer連結
內容:
- 已注入所有使用者數據(姓名、連結、項目、簡歷)
- 沒有通用佔位符(「Lorem ipsum」、「Your Name Here」)
- 社交連結使用實際 URL,針對已提供的連結沒有
href="#" - 頁尾有正確的姓名和動態年份
視覺:
- 字體配對不是 Inter、Roboto、Arial 或 Space Grotesk(除非使用者指定)
- 沒有紫色配白色的配色方案
- 使用者介面中沒有表情符號圖示
- 顏色對比符合 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"