文字生成Blender卡片，为何卡在材质

一句话看懂 holo-card-studio

holo-card-studio 是一个把自然语言描述或上传参考图直接转成可编辑 Blender .blend 文件的工作流项目，截止 2026-09-13 已拿到 1466 star。它和普通文生图最大的区别是输出不是 PNG，而是带节点树、贴图槽、相机机位的完整 Blender 场景，用户拿到文件后还能继续手动调材质、改灯光、换构图。它火起来的关键节点是 v0.3 引入了 LLM-as-planner，把 Blender Python API 的调用序列拆成可校验的中间步骤，让生成失败时能精确回滚到某一步重试，而不是整张卡片重新跑。

问题 1：为什么生成的 .blend 文件打开后材质全黑

这是 r/ClaudeAI 上周被顶到最高的 issue，现象是模型看起来正常渲染，但切到 Material Preview 模式整个表面是黑色。根因不在 Blender，而在 holo-card-studio 默认走 Cycles 渲染器时，会把 Principled BSDF 的 Base Color 节点连接成 RGB 曲线而不是 Image Texture，导致采样器找不到图像数据。修复方式是脚本生成完毕后强制再跑一遍材质校验：

from blendify import SceneLoader

scene = SceneLoader("out/card_001.blend")
for mat in scene.materials:
    nodes = mat.node_tree.nodes
    bsdf = next(n for n in nodes if n.bl_idname == "ShaderNodeBsdfPrincipled")
    base_input = bsdf.inputs["Base Color"]
    if base_input.links and base_input.links[0].from_node.bl_idname == "ShaderNodeRGBCurve":
        tex = nodes.new("ShaderNodeTexImage")
        tex.image = mat.preview_render.image
        mat.node_tree.links.new(tex.outputs["Color"], base_input)
scene.save()

把这段塞进 holo-card-studio 的 postprocess.py 钩子里，下次生成就能直接打开就用。

问题 2：为什么上传参考图后卡片构图总是偏左

很多用户反馈参考图明明居中，生成的卡片却把主体挤到左三分之一。查 GitHub Issues #142 发现原因是 holo-card-studio 用 CLIP 抽 embedding 时只算了 224x224 的中心裁剪，而参考图如果是横版，主体很容易落在裁剪框外。临时解法是在 generate.py 启动前改 padding：

from holo_card.pipelines import ReferencePipeline

pipe = ReferencePipeline.from_pretrained("EverettFish/holo-card-studio")
pipe.feature_extractor.image_processor.do_center_crop = False
pipe.feature_extractor.image_processor.do_pad = True
pipe.feature_extractor.image_processor.pad_size = 336
card = pipe("a holographic greeting card with neon edges")
card.export_blend("out/card_002.blend")

关掉 center_crop、打开 padding 后，主体偏移问题基本消失。

问题 3：为什么切换到自定义字体后卡片乱码

官方默认用 Noto Sans CJK，但中文用户经常想换成思源宋体或站酷高端黑，替换 .ttf 文件后打开 .blend 看到的是方块。根因是 Blender 把字体路径硬编码进 TextCurve，而且路径是绝对路径。holo-card-studio 在 issue #178 里给出标准做法：先生成、再用脚本批量改相对路径。

Sources

本文基于 GitHub Trending 2026-09-13 榜单、r/ClaudeAI 关于 Blender 自动化的讨论串，以及 holo-card-studio 仓库 Issues #142 与 #178 整理。