Community影像github.com

互動式電子賀卡

將一張圖片和一則訊息轉化為互動式 3D 立體賀卡,在 WebGL 中呈現,讓卡片會隨著移動反射光線,並可打開、翻頁,還可加入動態效果。

互動式電子賀卡 是什麼?

這個技能可將使用者的圖片與訊息,轉換成一個自包含的互動式 3D 立體賀卡 HTML 檔案。卡片正面使用 WebGL 渲染,讓表面的箔紙或厚塗顏料能隨使用者移動裝置或滑鼠而捕捉光線,營造出立體感。卡片可點擊打開,展示內部的手寫風格訊息,也能翻轉看到背面。此外,還能加入雪花飄落、愛心飄浮、螢火蟲、流星閃爍等季節性或節慶動畫效果,以及光源閃爍、貓尾搖擺等「活起來」的互動。所有圖像、字型與渲染引擎都封裝在單一 HTML 檔案中,因此無需網路即可離線使用,並可輕鬆上傳至任何靜態網頁代管平台分享。此技能支援多種卡片完成風格,包括適合油畫的「顏料 (paint)」、適合插畫或線稿的「箔紙 (foil)」、以及適合照片的「印刷 (print)」質感,並提供多種箔紙顏色選擇。該工具基於 Python 腳本,包含資料驗證、預覽輔助與快照測試功能,適合開發者快速製作客製化數位賀卡。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/annnguyentt/interactive-greeting-card-skill/tree/HEAD/interactive-greeting-card

Installed? Explore more 影像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

互動式電子賀卡 是做什麼的?

製作一張讓人愛不釋手的卡片:將對方的圖片放在立體卡的正面,卡片在頁面上輕柔搖曳,表面的箔紙或顏料隨著移動的光線閃耀;點擊即可打開,看到手寫風格的字跡;還能翻轉顯示背面。只需短短幾個步驟,就能將一張圖片和少許設定,製作成一份 HTML 檔案,裡面已包含所有內容(圖片、字型、渲染器),可以直接從檔案開啟,離線也能運作,並且不需修改就能放到任何網頁代管平台上。

本技能包含的內容:

  • scripts/make_card.py:根據卡片資料(JSON)建置頁面。它會在寫入任何檔案前先檢查資料並解釋任何錯誤。
  • scripts/grid.py:在圖片上繪製帶有標籤的像素網格,其裁切方式與卡片完全一致,用來讀取位置資訊(僅在需要實體效果和顏色選取時使用)。
  • scripts/foil_preview.py:以洋紅色顯示會變成箔紙的部分,讓您可以在建置前調整箔紙效果(需要 numpy)。
  • scripts/snapshot.mjs(選擇性,需要 Node 和 Playwright):為正面、內頁和背面擷取螢幕截圖,搭配 --live 參數則可顯示實體卡片上會移動的部分以及每次點擊的效果。
  • references/options.md:列出所有設定。references/living-cards.md 解釋如何讓卡片活起來。在需要時再閱讀,不必事先全部讀完。

如何製作卡片

1. 取得圖片與訊息

您需要從對方那裡取得的兩項東西是:卡片正面的圖片,以及要寫在內頁的訊息。如果缺少任何一項,請向對方索取,或主動提議為對方代筆(詢問卡片要送給誰、以及誰送的)。其他所有設定都有合理的預設值,所以不必讓他們填寫問卷;請自行做良好選擇,並向對方說明您所做的選擇,以便他們可以更改。

按照對方給的原樣保留訊息。除非對方要求,否則不要修飾他們的文字,但請在一般手寫卡片會有換行的地方加入換行(例如問候語獨佔一行,結尾署名在最後);如果一行文字太長,紙張會在大約 20 個字母處自動換行。大約 60 字以內看起來字大且舒適;更長的訊息字體會變小,而當超出可容納範圍時,結尾會被截斷,因此建議請對方修剪過長的訊息。

多張圖片會在同一頁面上產生多張卡片,以類似縮圖列的方式切換。這適合製作一組卡片,或同一張卡片的不同設計以供挑選。

2. 觀察圖片並選擇表面處理

表面處理決定了卡片正面如何捕捉光線。在選擇前請先觀察圖片:

圖片類型表面處理備註
帶有筆刷紋理的繪畫(油畫、不透明水彩、壓克力、濃厚水彩)paint顏料本身的筆觸會立體浮現並在光線下閃爍。如果含有金色顏料,也要讓它發亮:使用 foil.on: "colour" 並選取金色。
插畫、線稿、文字設計或扁平設計(特別是淺色紙張上)foilon: "details" 會將線條和深色細節壓印在箔紙上;"colour" 會將您選取的一種顏色(例如金色字樣)壓印在箔紙上;"darks" 則會將最暗的形狀(剪影)壓印在箔紙上。
照片print印在霧面卡片上。加上細箔紙 border 會很好看。在照片細節上使用箔紙容易顯得雜亂。

箔紙顏色:gold(經典、溫暖)、silver(冬季、婚禮、冷色調)、rose(浪漫)、copper(秋季、鄉村風格)、pink(活潑)、holo(全息效果,適合生日)。選擇能搭配圖片本身色調與場合的顏色。

在建置前(卡片資料寫好後,步驟 5)使用 foil_preview.py 檢查箔紙效果。您希望變成箔紙的部分應該呈現紮實的顏色,而且不應意外沾染到其他區域。有兩種情況常需要調整:

  • 您想要箔紙的部分與不想要箔紙的部分共用相同的顏色或明暗度,例如金色字樣位於帶有金色花蕊的花朵上方。請使用 foil.area 將箔紙限制在一個範圍內。
  • 預設的金色是淺淡且經典的。如果藝術作品使用更深沈的金色,可以設定專屬的墨色,讓箔紙能夠匹配。

references/options.md 中的「箔紙」章節列出了各種墨色、每種模式下 amount 的作用以及 area。

紙張(內頁、背面和邊緣):white、cream、blush、sage、sky、midnight,或任何 #rrggbb 色碼。如果圖片本身就是畫在淺色紙上,卡片會預設使用那種紙張顏色,這通常看起來最好。

卡片會從圖片中央裁切出形狀:portrait(5:7,預設)、square、landscape(7:5)或 original(圖片的原始比例,但在範圍內)。對於寬幅圖片請使用 landscape。如果主體靠近邊緣,請執行 grid.py 查看裁切後保留了哪些部分。

3. 為場合添加效果(選擇性)

這些效果不需要指定位置,所以在適合卡片時可以自由添加:

  • snow:雪花在正面飄落(冬季、聖誕節)
  • hearts:小愛心不時從圖片上浮起(愛情、情人節、母親節、婚禮)
  • fireflies:柔和的光點在下方區域飄移(夏夜、夢幻場景)
  • shootingStars:流星不時劃過頂端(夜空)
  • sparkle:箔紙的亮點捕捉光線並閃爍(任何箔紙卡片)

一兩種效果就很足夠了,太多會顯得雜亂。

4. 讓卡片活起來(選擇性,而且是最棒的部分)

卡片可以做到更多:圖片中的燈籠會發光、搖曳並在點擊時閃爍;太陽會散發光芒;貓尾巴會甩動,撫摸時會有愛心升起;樹枝會搖擺並掉落雪花;圍巾會在滑鼠指標的微風中飄動。這需要在圖片上指定位置,您可以透過 grid.py 的網格來讀取這些位置。請閱讀 references/living-cards.md 並按照說明操作。

請在對方要求卡片要有生命感、動畫或互動性時,或者當圖片中有明顯的光源(蠟燭、燈籠、太陽、月亮、發光的窗戶)或角色時,才進行此步驟。這會花費一些時間,所以如果要快速製作卡片,可以將其作為下一步驟提供。

5. 編寫卡片資料

將資料儲存為 JSON 檔案,放在圖片旁邊。單張卡片範例:

{
  "title": "艾莉,生日快樂",
  "image": "ellie-birthday.jpg",
  "alt": "一幅水彩畫,畫中有隻狐狸身處罌粟花草原。",
  "name": "狐狸與罌粟花",
  "finish": "foil",
  "foil": { "colour": "rose", "on": "details", "amount": 0.12 },
  "paper": "cream",
  "message": "親愛的艾莉,\n祝我最在乎的人生日快樂。\n這將會是你最棒的一年!\n愛你的,諾拉",
  "signature": ["滿滿的愛來自", "諾拉"],
  "effects": { "hearts": true, "sparkle": true }
}

alt 用於為螢幕閱讀器描述正面圖片;請務必填寫。name 會以小字顯示在卡片背面,除非 back 或 signature 另有指定。多張卡片請使用 "cards": [ {...}, {...} ],並在頂層設定 title 和 page。所有設定都在 references/options.md 中。

6. 建置卡片

python scripts/make_card.py card.json --check      # 檢查資料,並顯示卡片的像素尺寸
python scripts/make_card.py card.json -o card.html

JSON 中的路徑是相對於 JSON 檔案的位置。對於快速卡片,也提供一行指令的格式:

python scripts/make_card.py --image front.jpg --message "生日快樂!" --finish foil --foil gold -o card.html

如果腳本回報錯誤,它會說明問題所在以及如何修正。警告(例如缺少訊息、不認識的設定、位置超出卡片範圍)仍會建置,但請修正它們。

7. 檢查卡片

如果有 Node 和 Playwright,可以在交付前先檢視卡片:

node scripts/snapshot.mjs card.html shots/
node scripts/snapshot.mjs card.html shots/ --live   # 對於會動的卡片:同時檢查哪些部分會移動

這會將正面、光線停留在正面上的效果(front-lit:箔紙或顏料捕捉光線)、內頁和背面分別輸出為 PNG 圖片。檢查這些圖片:訊息是否容易閱讀?箔紙看起來是壓印上去的而不是斑點狀?圖片裁切的位置是否符合預期?調整後再重新建置;每次迭代都很快。如果沒有瀏覽器,請直接告知您無法預覽(箔紙預覽仍然可用)。

8. 交付卡片

將 HTML 檔案交給對方,並告訴他們如何使用:

  • 在任何瀏覽器中開啟即可看到卡片。點擊它(或按 O 鍵)即可打開;拖曳它(或按 T 鍵)即可翻面。
  • 要寄送卡片,請將其放在網路上並分享連結:GitHub Pages、Netlify Drop 或任何靜態代管平台都可以直接使用這個檔案。或者直接傳送檔案本身;它可以在離線狀態下運作。
  • 檔案大小約為一到兩 MB,其中幾乎全部都是圖片。

用一句話向對方提及您所做的選擇(表面處理、箔紙、紙張、效果),以便他們可以要求修改。

實用資訊

  • 手機拍攝的照片會自動旋轉為正確方向,大尺寸圖片會被縮小(使用 Pillow 函式庫)。透明區域會變成白色。HEIC 格式的照片需要先轉換為 JPEG,除非 Pillow 能夠讀取它們。
  • 手寫風格字型為 Caveat,已內嵌在頁面中。它涵蓋拉丁文、擴展拉丁文以及西里爾字母;其他文字系統(越南文、希臘文、中日韓表意文字)則會使用裝置本身的字型作為替代。
  • 如果不支援 WebGL,頁面仍會顯示圖片和訊息,但為平面效果。
  • 頁面設計為淺色主題:卡片置於白色背景上,帶有柔和陰影。
  • 如果想要在此技能提供的設定之外改變卡片的外觀或行為,渲染器的原始碼位於技能的 GitHub 儲存庫中(renderer/),重新建置後會取代 assets/greeting-card.js。

相關技能