环境配置
只需完成三个步骤，就可以开始第一次建模。
01
下载并解压 Skill
从 网站左上角开源链接 下载。根目录应包含 SKILL.md、README.md、references/ 和 scripts/。
02
在 Codex 中加载
推荐放入项目级 .agents/skills/ornamentforge/ 并开启新会话；或者直接打开文件夹，明确告诉 Codex 读取 SKILL.md。打开文件夹不等于已自动注册 Skill。
03
复制下面的环境配置提示词
Codex 检查 Python、Blender 与依赖，并在独立目录中创建工作空间。只有检查结果为 READY 才开始建模。
环境配置提示词 · 可直接发送 Codex
要求 Python 3.11+、Blender 4.2–5.x（项目验证过 5.1.2）。需要联网安装或修改系统配置时，应先由你确认。
输入方式与提示词
选择一种输入方式，填上想做的纹饰、工艺和材质，生成可直接复制的模板。
推荐：先上传清晰纹饰图，尽可能保留原始构图、比例、线条和颜色。
生成后，可以继续用自然语言调整到满意。
参考图模式 · 已填写选项
发送这段提示词前，记得同时上传纹饰参考图。
可选纹饰风格与工艺范围
以下是可以写进提示词的设计方向，不代表每一项都有独立内置预设或已逐项实测。
纹饰题材词库 · 全部展开
花卉卷草牡丹、荷花、莲花、菊花、梅花、兰草、山茶、宝相花、缠枝莲、折枝花、卷草
花鸟昆虫凤凰牡丹、喜鹊登梅、仙鹤、孔雀、蝴蝶恋花、蜻蜓点水、鸳鸯、蜂蝶
瑞兽神话龙纹、双龙戏珠、龙凤呈祥、麒麟、瑞狮、游鱼
云水山石祥云、如意云、流云、海水江崖、水波、山石、云气、浪纹
几何边饰回纹、云雷纹、菱格、龟背、锦地、连续几何纹、环形边带
工艺和材质：哪些是 Skill 真实能力？
工艺：阴刻、浅浮雕、彩绘，以及按任务组合的彩绘加几何。阴刻/浮雕须有真实几何起伏，彩绘颜色可用贴图或顶点色。
内置版本化材质预设：QINGBAI_GLAZE、YINGQING_GLAZE。白底金边、青花、粉彩、描金、敦煌配色属于可指定的自定义视觉目标，需要 Blender 实测验收。
内置版本化材质预设：QINGBAI_GLAZE、YINGQING_GLAZE。白底金边、青花、粉彩、描金、敦煌配色属于可指定的自定义视觉目标，需要 Blender 实测验收。
当前支持的器型范围
平面、圆柱、圆锥、简单旋转体花瓶，以及有合格现有 UV 的简单模型；盘/浅碗走独立的已有映射流程。暂不把任意自由曲面、球面、通用自动 UV 展开列为已支持。部分任务可能因形变或线条拓扑质量返回 HOLD。
案例复现
三个参考图案例，分别练习青釉刻花、金线彩绘和分层浮雕。先完成并验收静态模型，再制作展示视频。
案例 A｜寿带梅花 · 青釉刻花
建模案例提示词
目标图是你提供的青釉效果参考；检查刻槽几何、鸟的朝向、花枝布局，不把纸面印刷字带到盘上。
模型完成后：展示视频
可选下一步这一步直接读取已验收的 Blender 源文件，不重新建模。
竖屏 9:16 · Blender 相机与渲染
纹饰参考图
网友图集 · 按图片标题分类
没有找到匹配的纹饰，请尝试其他名称或编号。
资料库
常见问题
建模失败时先排查原因，再进行 WorkBuddy 对照测试。
第一次使用常见问题
发送提示词却没真正调用 Skill？
确认项目目录 .agents/skills/ornamentforge/SKILL.md 存在，重新开启会话使用 $ornamentforge；临时使用时明确提供 SKILL.md 路径。打开目录不等于自动安装成功。
找不到 Python 依赖或 Blender？
先确认解释器、虚拟环境和 Blender 可执行路径，按 Skill scripts/requirements.txt 配置。未经确认不要改系统 PATH 或覆盖全局 Python。
有彩绘，却没有真正的三维刻花？
打开 Blender 检查网格、Shape Key、实际顶点位移及刻槽；临时关闭颜色贴图，真实几何仍应能观察到。彩绘颜色可以用贴图，阴刻/浮雕不能只有贴图。
为什么返回 HOLD 或 NOT_SUPPORTED？
可能是线稿不完整、区域粘连、曲面映射失真、工具缺失或器型超出范围。纯文字模式没有真实图像生成工具时应返回 AI_IMAGE_TOOL_UNAVAILABLE / HOLD，不能拿程序化纹样假冒 AI 生成。
WorkBuddy 也能完整调用吗？
还需要实测：能阅读 SKILL.md、执行 Python、调用 Blender 并生成可编辑 .blend 是不同的验收点。使用同一参考图、同一提示词逐项记录结果。
WorkBuddy 对照测试
以实测为准使用独立目录，避免覆盖 Codex 的结果。
WorkBuddy 兼容性测试提示词
作品完成后重点看：原图对应、真实几何、.blend 可编辑、材质静帧和质量检查记录。