holo-card-studio

🃏 Holo Card Studio：用 AI 一句话生成一张 3D 全息闪卡

场景切入：小时候在文具店橱窗前挪不开脚的那张卡

80 后、90 后们大概都有过这样的记忆——攥着几块钱零花钱，站在学校门口小卖部的玻璃柜台前，看着那些印着奥特曼、精灵宝可梦的闪卡在灯光下流转出彩虹光泽。那时候想集齐一套，得一包一包地买干脆面，还得祈祷运气够好。

如今，一个叫 Holo Card Studio 的开源项目把这件事彻底颠覆了：你只需要对 AI 说一句话，比如「给我做一张赛博朋克风格的机械猫闪卡，背景是霓虹雨夜，编号 No.007」，Codex 就会自动画图、搭 Blender 场景、渲染 Three.js 交互网页——你收获一张可以在浏览器里 360° 拖拽、翻面、拉动滑块看闪光的全息闪卡，外加一个可继续编辑的 Blender 工程文件。

这是收藏卡牌生产方式的范式转移，也是 AI Agent 在设计工作流中落地的真实案例。

---

技术拆解：一张卡是怎么"叠"出来的

Holo Card Studio 的核心思路是分层合成 + 视差重建。一张全息卡在技术上由四张独立图片构成：

• 主体层（subject.png）：角色或物体本体，放在最前面，往前"凸"
• 背景层（background.png）：放在最后面，往后"缩"
• 线稿层（lineart.png）：轮廓发光效果
• 文字层（text.png）：卡片名称、编号、稀有度等信息

这四层通过 Blender 的材质节点设置不同深度，再叠加镭射彩虹（相位随视角变化）、Voronoi 星光、金色边框等材质效果，最终渲染输出。

网页端用 Three.js 按同一套 UV 逻辑重建这套合成——所以交互预览和 Blender 渲染效果高度一致，不是割裂的 mock-up。

Blender 不用用户自己装。流水线脚本 ensure_blender.py 会自动从官网下载指定版本便携版，放到 tools/ 目录并校验 SHA-256，项目自带、互不干扰。

---

两条生产路线

项目支持两种卡片类型，通过 --mode holographic（默认）或 --mode lenticular 切换：

全息路线（holographic）：默认模式，适合单角色/单主题全息卡，输出四层结构 + 镭射 + 星光效果。

光栅路线（lenticular）：对应「双图」「翻转」「一念神魔」等需求，需要生成 A/B 两张完整画面，视角变化时整卡切换状态。A 图先生成，B 图通过 AI 编辑从 A 图变形而来，保持角色面部结构、构图和比例高度一致。

---

架构与技术栈

层级	技术
AI 生成层	OpenAI 图像生成 API（内置工具）
3D 渲染	Blender（Python 脚本驱动）
交互前端	Three.js（WebGL）
流水线编排	Python（run_pipeline.py）
本地服务	Node.js（Vite 预览）
技能封装	YAML 配置（Codex/OpenAI Agents 兼容）

整体是一个本地化 AI 工作站：Python 脚本负责 Blender 调用和文件生成，Node.js 负责网页预览，AI 负责内容生成，三者通过文件系统解耦。

---

上手体验：门槛与自由度

安装方式：把整个项目目录复制到 ~/.codex/skills/holo-card-studio/，在 Codex 中直接说「用 holo-card-studio 做一张……」即可触发全流程。

无需安装 Blender：项目自带便携版，按需下载，首次运行约 200MB。

最小运行命令：

python scripts/run_pipeline.py --project <project-dir> --mode holographic

会收到的东西：

• 本地预览网页（拖拽/翻转/滑块调材质）
• card.blend：完整的 Blender 工程，可继续编辑材质节点
• 四张分层图片：想换哪层换哪层
• card-config.json：卡面元数据（稀有度、编号、名称）
• 渲染图：直接分享

---

局限与现实约束

渲染效果与网页预览存在差异：网页着色基于 WebGL 实时计算，与 Blender 离线渲染的光照模型不同，颜色、辉光和背面装饰会有视觉差别。

Blender 学习曲线：虽然流水线封装了大部分操作，但如果用户需要深度定制材质节点（镭射条纹密度、星光分布、视差强度），仍然需要了解 Blender 基础操作。

无容器化支持：项目没有 Dockerfile 或 docker-compose，无法一键部署到服务器。需要在本地 macOS/Linux/Windows 环境运行。

依赖较重：Python 3 + Pillow + Node.js + npm + Blender，至少需要 2GB 内存和足够的磁盘空间。

---

行业意义：设计工作流正在被 AI Agent 改写

Holo Card Studio 真正有价值的地方不是"生成一张卡"，而是它代表了一种意图驱动的完整生产管线模式：用户给一个高层意图（prompt），Agent 自动在多个工具之间协调（画图 → Blender → Node.js → 浏览器验证），最终交付的不只是一个结果图，而是一套可继续编辑的资产。

这种模式正在向更多设计领域渗透：游戏原画、UI 设计、产品原型。它模糊了"使用工具"和"写提示词"之间的界限，让创意执行门槛大幅下降，同时保留了专业级别的定制空间。

---

项目地址：https://github.com/EverettFish/holo-card-studio | Stars: 1785 | License: Other (NOASSERTION)