Community图像github.com

互动3D贺卡生成器

将一张图片和一段留言转化为一封可交互的3D立体贺卡,支持WebGL渲染,可离线运行并生成自包含的HTML文件。

互动3D贺卡生成器 是什么?

该技能专注于将用户提供的图片和留言转化为一个高度交互的3D立体贺卡HTML文件。它通过WebGL技术实现贺卡的立体折叠效果,封面带有箔纸或厚涂颜料般的光泽感,会随鼠标移动而反射光线;轻触即可打开,展示手写风格的留言,并能翻转查看背面。贺卡还可以添加动态效果(如飘雪、浮动的爱心、萤火虫、流星和闪光点),并支持更复杂的“活卡”交互:用户可点击卡片上特定元素(如灯笼、太阳、猫尾巴)触发动画。工具集包含多个Python脚本用于构建、预览和调试,以及一个可选的Node/Playwright快照脚本用于视觉检查。输出为一个自包含的HTML文件(约1-2MB),内含图片、字体和渲染器,无需网络连接即可在任何现代浏览器中打开,适用于生日、节日、婚礼、感谢、问候等多种场合。

兼容平台~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(彩虹色、生日)。匹配图片本身的色调和场合。

在构建前用 foil_preview.py 检查箔纸效果(一旦卡片数据写好,即步骤5)。你希望成为箔纸的区域应该是实心,且没有其他区域被意外选中。两种常见调整:

  • 你想要箔纸的区域与不想要箔纸的区域共享相同颜色或亮度,例如金色文字位于带有金色花蕊的花卉之上。使用 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 或任何静态托管服务都可以原样接受该文件。或者直接发送文件本身;它离线也可以工作。
  • 大小约为1-2兆字节,几乎全是图片。

用一句话提一下你选择的设置(表面、箔纸、纸张、特效),以便他们可以要求修改。

实用信息

  • 手机照片会自动旋转正立,大图片会被缩小(使用Pillow)。透明区域变为白色。HEIC照片需要先转换为JPEG,除非Pillow可以读取。
  • 手写字体为Caveat,已嵌入页面。它覆盖拉丁字母、扩展拉丁字母和西里尔字母;其他文字(越南语、希腊语、中日韩文字)会回退到设备自带的书法字体。
  • 如果没有WebGL,页面仍会显示图片和留言,只是平面效果。
  • 页面默认采用浅色主题:卡片带有柔和阴影,放置在白色背景上。
  • 如果想要改变卡片的外观或行为,超出这些设置范围的功能,渲染器的源代码位于技能的GitHub仓库中(renderer/),重新构建后可以替换 assets/greeting-card.js。

相关技能