Holo Card Studio：一句话生成会随视角流光溢彩的 3D 全息闪卡

项目地址：https://github.com/EverettFish/holo-card-studio　协议：未声明　Stars：1,598　更新：2026-09-12

一、产品深度介绍

（一）它是什么

Holo Card Studio 的官方定位非常直白：一个 Codex Skill，对 Codex 说一句话，就能收获一张会随视角流光溢彩的 3D 全息闪卡。它不满足于只给你一张静态图——成品是一张能在浏览器里拖着转、翻到背面、拉滑块看它闪的互动卡片，外加一个可以随便改的 Blender 工程。README 里有一句很有画面感的描述：小时候在文具店门口舍不得买的那种闪卡，现在你想印谁就印谁。

它的工作对象不是单一模型，而是一整套流水线：先画图（四层），再搭 Blender 场景，最后组装成 Three.js 网页本地跑起来，交付时把网页链接、card.blend 与渲染图一起递给你。你只负责想，剩下的它来。

（二）核心能力一览

• 四层分层合成：主体、背景、线稿、文字分开绘制，空间里靠视差「撑开」。
• 可编辑 Blender 工程：card.blend 是真正可改的工程，共享节点组用中文命名（缩放、深度、视差效果），镭射、星光、线稿发光都是独立可调的材质节点。
• 互动 Three.js 网页：本地页面支持拖拽旋转、翻面、滑块调流光，并做了移动端响应式。
• 两种路线：holographic 单图全息镭射卡，以及新增的 lenticular 双图光栅卡、翻转卡、双形态卡。
• 零 Blender 安装负担：流水线自动拉取官方便携版 Blender，校验 SHA-256，项目自带、互不干扰。

二、主要功能特点与应用场景

README 列举了六类典型用法，本质上都是「把任意主体变成一张带收藏感的闪卡」：

• 给自家毛孩子发一张传说级卡：上传猫主子照片，加一句「传说稀有度、金色边框、名字叫布丁」，主体保留本猫神态，背景线稿全新绘制。
• 给独立游戏做角色卡牌：一个角色一句描述，批量出一整套战士、法师、盗贼、Boss；每张卡自带 card-config.json，稀有度、编号、属性文字都在里面。
• 团队周年纪念 / 新人入职卡：头像当主体、部门色当背景、Slogan 当文字层，每人一张链接，大家在浏览器里翻一下午。
• 情人节 / 生日 / 纪念日：复古胶片风、粉金配色、背面写一句话，对方在手机上转着看、翻到背面看到那句话。
• 演讲 / 发布会的彩蛋物料：讲到最后一页丢一个链接「扫码看会闪的那种」，响应式网页手机横竖屏都能玩。
• 设计师的材质实验场：card.blend 是真正的教材，打开就能研究全息卡是怎么「闪」起来的。

三、如何安装与使用

Holo Card Studio 是一个 Codex Skill，安装方式就是把目录放进 Codex 的 skills 目录：

~/.codex/skills/holo-card-studio/

运行环境需要 Python 3 + Pillow，以及 Node.js + npm。Blender 不用自己装——流水线会自动把官方便携版放到项目的 tools/ 目录并校验 SHA-256；已有 Blender 时会优先复用，也可用 –blender 指定可执行文件。全息路线适配新旧两版合成节点，macOS 可用 Metal，偏好保存在项目的 tools/blender-config/。

准备好素材与配置后，直接运行流水线：

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

不写 –mode 时读取配置里的 mode，配置也没有时默认 holographic。–skip-render 可跳过静态渲染，–skip-npm 可跳过网页依赖安装。

真正用起来是在 Codex 里说人话，例如「用 holo-card-studio 给我做一张水墨风的锦鲤闪卡，文字用书法体，编号 No.001」，或上传参考图「照这张图做一张闪卡，保留人物和构图，背景换成星空」。Codex 会先把卡片规格和推断细节说给你听，然后开工：画图 → 生成文字层 → 写配置 → 跑流水线 → 起本地服务 → 真正打开页面测拖拽、翻面、滑块和手机布局 → 交付。

你会收到：本地网页链接（拖、转、翻、拉滑块）、card.blend（在 Blender 里继续调）、assets/ 四层图（想换哪层换哪层，重跑流水线即可）、card-config.json（改名字、编号、稀有度）以及渲染图。

四、官方地址与获取方式

• GitHub 仓库：https://github.com/EverettFish/holo-card-studio
• 在线示例：https://card.waterq.us/
• 配套展厅项目：https://github.com/chenweilie/holo-card-gallery（私有仓库，需所有者授权）
• 打包分享：python scripts/package_skill.py 按白名单只打包文本文件，产出干净 ZIP，拿走就能用。

五、与同类方案对比

六、核心机制深度解析

一张闪卡由四层图叠在同一块画布上，再用视差在空间里撑开：从你的视线往下，依次是文字层（稳贴表面）、线稿层（发光轮廓）、主体层（往前凸）、背景层（往后缩）。再铺上镭射彩虹（相位跟着视角走，转到哪闪到哪）、Voronoi 星光与金色卡边。

浏览器端用 Three.js 按同一套 UV 公式重建这四层合成，呈现相同类型的视差与镭射；由于网页着色与 Blender 离线灯光不同，颜色、辉光和背面装饰会有差异——这也是为什么它既给网页也给 card.blend，让你在两条路上各取所需。

新增的 lenticular 路线则用两张完整卡面（A 图与 B 图）随观看角度切换整张画面——不是把一张图左右切。Blender 工程包含实体卡基、图像层、柱镜光栅、镭射膜、轮廓光、闪钻粒子等独立层，网页加载导出的 GLB，用同一套视角公式驱动整卡切换，并支持鼠标与触控倾斜。运行命令为：

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

七、实用技巧

• 视差强度：主体默认 scale 1.25、depth 0.4，背景 depth -0.25，想更「跳」就往上加。
• 镭射条纹：可调条纹密度、扭曲度、角度，以及粉、黄、蓝、白渐变。
• 线稿发光：强度与遮罩密度，从淡淡勾边到霓虹描边。
• 星光：Voronoi 尺度 + 动画噪声，从零星几颗到满天星。
• 多张卡展厅：把每张产物归档为独立目录，用清单生成器汇总成瀑布流展厅，每张卡保留永久 URL，主页按人物、风格、主题、稀有度自动筛选。
• Blender 界面语言：默认简体中文，存在项目本地配置，一句话可换。

八、最新更新动态

据仓库提交记录，近期动态集中在全息路线与双图光栅路线的成型：

• 2026-09-12：合并 holographic 管线修复（PR #5），恢复 dispatcher 与全息 Blender 兼容性。
• 2026-09-11：新增 Blender lenticular 卡工作流；修复 dispatcher 与全息 Blender 兼容性。
• 2026-09-09：新增 Blender 透镜（lenticular）卡工作流。

README 还专门用一节介绍新增的「双图光栅卡」：在原有单图全息镭射卡之外，支持光栅卡、翻转卡、双形态卡与一念神魔，使用 –mode lenticular 运行；光栅项目使用 assets/image_a.png、assets/image_b.png、assets/text.png 与 card-config.json。

九、常见问题 FAQ

十、总结

Holo Card Studio 把「一句话想法」到「会随视角流光的可收藏闪卡」之间的距离压到了最短：它用一套可本地运行的流水线，把画图、搭 Blender 场景、组装 Three.js 网页、浏览器验收串成闭环，并同时交付互动网页与可编辑 Blender 工程。对于想给毛孩子、角色、团队或活动做收藏卡的人，它是一个值得部署的有趣方案；对想研究全息卡材质机制的设计师，card.blend 本身就是最好的教材。

在撰写本文的过程中，我主要参考了 Holo Card Studio 的 GitHub 仓库 README.md、README.en.md 与目录结构（EverettFish/holo-card-studio）。文中数据以官方公开信息为准，可能随版本更新而变化。