mcpField
H
holo-card-studio

holo-card-studio

github.com/everettfish创意与媒体2.0k41 次安装5 周前更新
代码仓库

关于 holo-card-studio

holo-card-studio 是用于制作收藏卡项目的技能，提供全息烫箔和双图光栅两条制作流程，涵盖图像生成、素材准备、3D 渲染、网页查看器配置与验证。

主要功能

  1. 01全息烫箔与光栅制作流程
  2. 02栅格插画生成指导
  3. 03素材验证与流水线渲染
  4. 04Blender 场景与 GLB 导出
  5. 05查看器及交付验证

适用场景

  1. 01用单张角色图制作烫箔卡
  2. 02制作随视角切换的 A/B 角色卡
  3. 03准备卡片素材和网页预览
  4. 04检查卡片渲染与查看器行为

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/everettfish/holo-card-studio --skill holo-card-studio

安装后在 Claude Code 中输入/holo-card-studio确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

.gitignore
README.en.md
LICENSE
README.md
agents/
openai.yaml
assets/web-holographic/
index.html
package-lock.json
package.json
card-config.json
server.mjs
style.css
app.js
assets/web-lenticular/
index.html
card-config.json
package.json
app.js
server.mjs
style.css
assets/web-template/
card-config.json
package.json
package-lock.json
server.mjs
index.html
style.css
app.js
references/
art-direction.md
holographic-route.md
config.lenticular.example.json
gallery-distribution.md
scripts/
blender_compat.py

详细介绍

Holo Card Studio

创作一套完整的收藏卡牌项目。此技能提供两种制作路线，共用同一套美术方向和交付标准。

先选路线

准备素材前，必须且只能选择一条路线：

  • 全息箔是单角色插画的默认路线。它使用独立的 subject、background、lineart 和 text 图层，以及箔面和闪光效果。
  • 双图光栅适用于 光栅、翻转、双图、双形态 或 一念神魔。它使用 A 和 B 两张完整卡牌插画，并随观看角度改变整张卡牌。不要将一张图片拆成左右两半，也不要用 SVG 伪造两种状态。

如果用户提出一念神魔，自动选择光栅路线。

默认美术方向

生成插画前，先阅读 references/art-direction.md。除非用户提供其他风格，否则每张生成的卡牌都采用全彩日本浮世绘构图，搭配彩色水墨动漫线条：富有表现力、粗细变化的墨线轮廓、矿物颜料、清晰可见的笔触、动感十足的画面，以及协调统一的插画环境。

对于双状态卡牌，先生成 A，再使用图像生成工具将 A 编辑为 B。在编辑提示词中重复说明身份和构图方面的不变要求。保持相同的脸部结构、头发／毛发、服装标志性元素、比例、镜头、裁切、身体大小和主要轮廓。表情必须清楚传达状态：善良状态应显得平静、慈悲且坚定；邪恶状态应有专注的掠食者般眼神、更凌厉的眉形，以及克制的野性或残酷表情，同时不改变身份。

箔面和钻石闪光是呈现效果图层，不能替代插画。foil 和 particles 默认设为 1.0；保持面部清晰可辨，并保留墨线轮廓。

生成图像

使用内置图像生成工具制作栅格插画。不要要求用户在其他地方生成图像。需要最终插画时，不要使用 SVG 或程序生成的替代图。

无参考图生成：

  1. 根据角色简介和默认风格生成完整的 A 插画。
  2. 通过编辑 A 生成 B。锁定身份、取景和主要几何结构；更改表情、特定状态的服装细节、光线、氛围和动作效果。
  3. 将两张图保存为尺寸相同的纵向 PNG 文件。

基于参考图生成时，将参考图作为身份来源，并以 A 作为直接改编版本。然后将 A 编辑为 B。有关必需的提示词结构和对齐检查，请阅读 references/lenticular-route.md。

构建项目

在此技能目录之外创建一个由用户拥有的项目目录。复制对应的示例配置并准备素材。

全息素材：

assets/subject.png
assets/background.png
assets/lineart.png
assets/text.png
card-config.json

光栅素材：

assets/image_a.png
assets/image_b.png
assets/text.png
card-config.json

运行通用调度器：

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

如果 card-config.json 中包含 "mode"，可以省略 --mode。默认值为 holographic。

对于光栅项目，如果需要规范化处理或对齐报告，请在运行管线前执行 scripts/lenticular/prepare_pair.py。若缺少 text.png，管线会生成排版文字，并验证素材、构建 card.blend、渲染预览图、导出 web/assets/card.glb、复制对应的网页查看器，并安装其本地网页依赖，除非指定了 --skip-npm。

验证与交付

阅读 references/verification.md。至少验证以下内容：

  • Blender 场景包含实体卡片厚度和多个效果平面；
  • A 和 B 会替换整张插画正面，并且仍能让人辨认出是同一个角色；
  • 正视和倾斜渲染图呈现出清晰可读的状态变化；
  • 箔片、闪粉、线条辉光和柱状透镜纹理清晰可见，且不会让正面显得过曝；
  • 白色网页查看器能够加载 GLB，并支持指针／触控倾斜，且没有水平溢出。

交付源图、card.blend、渲染图、网页查看器和验证报告。生成的二进制文件应保留在项目中，切勿放入可复用的技能归档中。

参考资料

评论

支持 Markdown