# blender-character-workflow

Adopt this skill: https://proskills.md/skills/other/icesixgod-awesome-astra-blender-characters-skills-blender-character-workflow

Page: https://proskills.md/skills/other/icesixgod-awesome-astra-blender-characters-skills-blender-character-workflow
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: skills/blender-character-workflow/SKILL.md
size: 8820
upstream: https://github.com/icesixgod/awesome-astra-blender-characters/blob/master/skills/blender-character-workflow/SKILL.md

```text
---
name: blender-character-workflow
description: 根据人物设定图在 Blender 制作或修复可编辑角色，组织参考配准、脸部与头发塑形、多视图验收，以及按需扩展全身和绑定。适用于二次元人物还原、完整脸部制作和角色工程交付；不用于单纯生成二维人像或无关的 Blender 场景。
license: MIT
---

# Blender 人物制作工作流

以用户选定参考和用途为目标，交付实际可打开的工程及能够说明相似度和可用性的渲染证据。原型、静态角色、动画角色是不同完成范围。不能从脚本运行成功推断造型还原成功。

局部改善、文件重开和几何一致性检查不等于用户认可整体相似度。用户要求精细复刻时，只有主要识别特征的草模仍是中间结果；原图纹理带来的质感改善也不能证明隐藏结构正确。不要保证“完美复原”。

## 开始工作

- 读取项目说明，检查原图、已批准参考、现有模型、贴图、脚本和实际 Blender 版本。先查看图像内容，不能只凭文件名或对话中的文字描述建模。
- 对话引用不含图片时，尝试读取原对话和已知项目资源。仍无法取得目标图时，请用户补发；不要自行换一个人物继续。
- 从请求判断范围。只修脸部时保留无关身体和头发；完整人物才进入全身阶段。用途不明确而影响拓扑、绑定或交付格式时，询问这一项，同时推进不依赖回答的资源检查。合理假定的范围要标明；未答复不等于用户确认删减原图可见部件。
- 后续反馈持续更新当前范围和待修项。“头部和头发”不自动包含脖子；用户明确不要的部件应移除。保留用户纠正过的脸型等约束，修好一项后继续处理其余已要求的问题。
- 默认在新版本中工作，保留用户手工修改。新参考若换了角色，建立独立版本链，不沿用旧人物特征。
- 仅记录操作、复盘或更新技能时，不重新生成、修改或切换 Blender 工程；将项目路径、参数与历史证据留在项目文档，将可复用判断写入技能。

## 建模第一步：生成九视图参考

根据原图开始新角色建模时，先生成并检查 9 张独立参考图，再进入参考配准和几何制作。已有同一角色、同一版本且检查合格的九视图时直接复用，缺图只补缺项；局部修模不重复生成整套参考。用户明确调整视图范围时遵从用户要求。仅更新技能或文档不触发图像生成。

- 水平每隔 45° 一张：正面 0°、左前 45°、左侧 90°、左后 135°、背面 180°、右后 225°、右侧 270°、右前 315°；另加正上方顶视图，共 9 张。默认不生成正下方图片。
- 左右以角色自身为准：左侧鼻尖朝画面右，右侧鼻尖朝画面左。顶视相机从正上方向下看，角色前方朝画面下；不能用低头正面图代替顶视。
- 先读取 imagegen 技能并查看原图，使用内置图像生成工具，每个视角单独调用。所有视角共同引用同一原图和人物特征约束，保持脸型、五官、发型、颜色、表情及当前制作范围；只做头部和头发时不添加脖子或身体。
- 统一白底、方形画幅、完整轮廓和留白；水平视图要求相同尺度、相机高度和正交投影。逐张检查实际方向、裁切与人物特征，再横向比较轮廓、关键点和发束结构；明显错误的视图先修正，不能只按文件名验收。
- 原图保留为主基准，侧后方和顶部的隐藏结构标明为设计补全。生成图未经几何标定，存在冲突时以原图为准并记录需要建模统一的部分，不能当成严格一致的三维投影。
- 将 9 张独立图片、原图、视角名称、提示词及来源保存到项目内独立版本目录，提供可逐张查看的索引。完成参考检查后继续建模，不因生成参考图完成而结束建模任务。

## 制作和验收

开始制作时读取 [制作与验收流程](references/production-workflow.md)，按当前阶段使用对应内容，不必执行所有阶段。
使用生成脚本、批量变形、自动取景或修改现有工程时，再读取 [Blender 执行与版本可靠性](references/blender-reliability.md)，其中也包括参数中线与周期接缝检查。
用户强调原图质感、丝滑发质、UV 对齐、光照、肤色灰白或腮红，或处理局部 UV、发片透明边缘时，读取 [静态插画质感与遮挡诊断](references/static-illustration-finish.md)，按需使用肤色灰白诊断、图片纹理 UV 验收、细丝发质与冠部长发衔接的方法。
精修眼神时使用该文的“眼面、虹膜与镜片”分层诊断；发根和后脑接口先隔离支撑面、内层与细丝。原生曲线检查、着色模式输入及实时视口异常的处理见执行可靠性文档。
连续修发质时，按该文的“发质修正闭环”先定位责任曲面与纹理，再决定修改；保留可用基线，并区分已采用、已否定和待验证的试验。
刘海出现规则缺口、鬓发混入肤色，或顶视出现中心破洞和放射拉伸时，重点检查该文中的边界采样、面内 UV 插值和极点结构。

1. 先完成上方九视图生成与检查，再记录参考来源、可见信息、补绘内容和未知区域；检查多视图是否互相矛盾。
2. 配准参考和相机，保存单位、坐标轴、画幅、裁切、投影方式和关键点；不明视角按近似参考处理。
3. 优先复用适合角色风格、来源允许使用且实际可编辑的头部模板。先做低细节脸型与五官体积，观察正面、侧面和斜侧面，再增加密度。
4. 做完整脸部时覆盖眼球/眼面、眼睑与眼角、眉睫、鼻部、唇缝与口周、下巴和耳部；颈部衔接仅在包含脖子时制作，口腔、牙齿、视线、闭眼和表情随用途决定。
5. 在投入完整发型与材质前，先用隐藏头发的正、侧、斜侧灰模检查脸部粗形，特别检查下巴底部收口与侧面深度。原图投射和烘焙阴影不能代替几何检查。
6. 按用户范围扩展身体、服装、配饰和绑定。脸部未达标时，不用增加全身细节掩盖核心问题；若用户明确优先全身，遵从其顺序并说明脸部状态。
7. 局部关键视图复核后，再从明确保存的同一版本工程输出交付多视图，分别报告视觉相似度、网格/资源有效性和用途可用性。注明 UV 和穿插检查的对象、方法及未覆盖部分，只报告实际执行的检查。

如果一轮修形没有改善主要问题，定位是参考冲突、相机、模板结构还是修改方式的问题；更换必要的方法后再迭代。不要不断增加细分或微调参数却不比较实际渲染。没有可靠输入或工具能力不足时，说明具体缺口，保留可复用成果，不伪造完成状态。

## 工具选择

- 批量构建、参数修改、渲染、打包与检查可使用 Blender Python/CLI；交互观察、雕刻和最终打开检查可使用可用的 UI 工具或结构化接口。
- 先检查连接能力。MCP 未连接不代表 Blender 不可用；若本地 CLI 可用，可直接继续。不要把某台机器的安装路径或某次版本写成通用依赖。
- 需要补绘设定图或生成纹理时，使用当前可用的图像生成能力，并读取相应技能。保留来源和提示词，标明新增设计；补图不能当作隐藏几何的测量证据。
- 本技能不附带图像生成服务或 `imagegen` 技能。新角色缺少九视图且环境没有相应能力时，说明具体缺口并请求补齐参考或调整视图范围；可继续资源检查，不伪造已完成的参考。已有合格参考或仅局部修模时，继续不依赖图像生成的工作。
- UI 粘贴超时后先查看输入是否已经出现，再决定重试，避免重复执行。将界面状态、CLI 退出码、输出存在与实际内容分别确认。

## 交付与清理

制作交付包含当前 `.blend`、实际渲染对比、必要检查结果及简短说明。打包后重新打开最终文件，确认贴图、相机、可编辑对象和修改器状态。只对已验证用途作承诺；没有测试动画就不称为可动画角色。

用户要求清理时停止相关写入任务，枚举当前授权项目的工程和备份，优先移入废纸篓并保留恢复清单，验证残留及当前打开场景。明确清理原生 `.blend`/数字备份还是整个生成目录；范围明确的请求直接执行，不重复确认。不要将清理一个项目扩大为删除其他项目、原始参考、软件或资源包。同步文档中已经失效的工程路径。
```

## File: README.md
upstream: https://github.com/icesixgod/awesome-astra-blender-characters/blob/master/README.md

````text
# awesome-astra-blender-characters

**从人物参考图到可编辑 Blender 角色的 AI Agent 工作流。**

中文 · [English](README.en.md)

本仓库提供可安装的 `blender-character-workflow` 技能，组织九视图参考、脸部与头发制作、局部修模、多视图验收和工程交付，重点是二次元人物与静态插画风格。技能不固定模型版本。

发布内容是技能指令和制作参考文档。仓库暂未提供人物模型、示例渲染、训练权重或一键三维重建程序；安装与检查脚本只服务于技能分发。

## 能力与流程

| 阶段 | 内容 |
| --- | --- |
| 输入检查 | 查看原图和已有工程，确认范围、用途与必须保留的特征，标明范围假定 |
| 九视图参考 | 新角色默认生成水平八方向与正上方共九张独立参考，检查方向、尺度与特征 |
| 配准与脸部 | 统一相机与关键点，先用正、侧、斜侧灰模检查脸型、下巴收口与深度，再完善五官 |
| 头发与材质 | 主发束与原生细丝、发根覆盖、冠部长发衔接、局部 UV、透明边缘与高光 |
| 局部修复 | 保留用户修改，分层定位肤色灰白、虹膜取样、镜片影响、缺口、穿插与 UV 拉伸 |
| 验收交付 | 固定相机对照，分别报告外形、工程和用途检查，注明 UV 与穿插检查范围，打包并重开最终 `.blend` |

局部修模直接进入相关阶段；仅整理文档不生成图片或修改工程。范围假定须说明，用户未答复不能视为同意删减原图可见部件。每轮修改先比较问题视角及相邻视角的实际渲染，未改善时重新定位原因；稳定后再从明确保存的同一版本输出交付多视图。

[静态插画质感与遮挡诊断](skills/blender-character-workflow/references/static-illustration-finish.md) 包含图片纹理 UV 验收、保留腮红的肤色调整、眼面／虹膜／镜片分层检查，以及支撑面、内层与细丝的隔离诊断。[执行可靠性](skills/blender-character-workflow/references/blender-reliability.md) 补充原生曲线与着色模式输入检查、局部修改的状态保留和实时视口异常恢复。

全身、服装、绑定、动画和打印有按需扩展指导，当前公开包尚未提供这些用途的端到端验证案例。

## 环境与依赖

| 组件 | 何时需要 |
| --- | --- |
| 支持技能、图片查看及本地工具调用的 Agent 环境 | 执行工作流；提供 Codex 界面元数据 |
| 本地 Blender 与内置 Python／CLI | 建模、渲染和工程检查；先检测实际版本，仓库没有已验证的跨版本兼容矩阵 |
| 图像生成工具及 `imagegen` 技能 | 生成九视图或补纹理时；由宿主提供，本仓库不包含 |
| UI 自动化或 Blender MCP | 可选；CLI 可用时不要求 MCP |
| 外部 Python 3.10+ | 使用安装与维护脚本时；手动复制技能不需要 |
| PyYAML | 仅维护检查需要，见 `requirements-dev.txt` |

没有图像生成能力时，可提供已经检查合格的九视图，或明确调整本次视图范围。安装技能不会自动安装 Blender、图像模型或第三方创作软件。

## 安装

下载或克隆本仓库后，在仓库根目录运行：

```bash
python3 scripts/install.py
```

默认复制到用户的 `~/.agents/skills/blender-character-workflow/`。同名目录已存在时，安装器停止并保留原内容；更新前自行备份和移走旧目录。安装器不会启动 Blender、联网或修改 Agent 配置。

安装器只复制 `scripts/install.py` 中 `PACKAGE_FILES` 明确列出的技能文件，排除缓存、本地配置和额外素材，并拒绝包含符号链接的源目录。全部文件先复制到临时目录，成功后再移至目标位置；失败会清理临时产物，允许修复后重试。

也可指定技能父目录，例如目标项目内的 `.agents/skills`，或宿主实际使用的其他技能目录：

```bash
python3 scripts/install.py --destination /path/to/your-project/.agents/skills
```

手动安装时，将整个 `skills/blender-character-workflow/` 文件夹复制到技能目录，保留其中的 `LICENSE` 和原文件夹名称。

Codex 的用户与项目技能路径及发现方式见 [OpenAI 官方技能文档](https://learn.chatgpt.com/docs/build-skills)。安装后若未显示，重新启动 Codex，并检查其他目录是否已有同名技能。

## 使用示例

在支持 `$` 技能引用的 Codex 界面中输入以下内容，并附上原图或实际工程路径：

```text
使用 $blender-character-workflow，按照这张参考图制作头部和头发，
不要脖子和身体，用于静态多角度展示。先完成九视图参考，再继续建模。
```

```text
使用 $blender-character-workflow，修复现有工程的刘海缺口和头顶 UV 拉伸。
保留当前脸型、眼睛和后发，在新版本中修改，并提供修改前后的固定视角对比。
```

```text
使用 $blender-character-workflow，检查这个 blend 的贴图依赖和多视图表现。
只做只读检查，分别说明外形、工程和用途方面实际检查了什么。
```

准备输入时说明主参考、制作范围、用途、必须保留的特征和输出格式。目标交付包括 `.blend`、来自同一版本的真实渲染、必要资源和简短检查说明。

## 使用边界

- 生成的侧后方和顶部属于设计补全；原图是主基准，生成图不是严格一致的三维投影。
- 灰模、工程重开和少量关键点误差分别提供有限证据，不能代表整体相似度获得认可。
- 原画局部 UV 可保留绘画光影；换光、动画和实时导出需独立检查。
- 图片全部使用 UV 不等于每根发丝都有独立绘制图集；零越界、零退化或有限穿插采样不代表无拉伸、笔刷可用或整个装配无穿模。报告须注明检查对象、方法及未覆盖部分。
- 静态展示通过不等于动画或打印可用，只承诺实际验证过的用途。

## 仓库结构

```text
skills/blender-character-workflow/
  SKILL.md                         技能入口
  LICENSE                          随技能分发的许可证
  agents/openai.yaml               Codex 界面元数据
  references/production-workflow.md
  references/blender-reliability.md
  references/static-illustration-finish.md
scripts/                           安装与仓库检查
tests/                             分发行为检查
docs/releasing.md                  GitHub 发布准备
```

详细流程从 [SKILL.md](skills/blender-character-workflow/SKILL.md) 进入。技能正文目前以中文维护，英文 README 提供安装、范围与使用说明。

## 参与维护

欢迎提交可复现的问题、流程改进和有明确授权的案例，见 [贡献指南](CONTRIBUTING.md)。维护检查：

```bash
python3 -m venv .venv
source .venv/bin/activate
python3 -m pip install -r requirements-dev.txt
python3 scripts/validate.py
python3 -m unittest discover -s tests
```

上面的激活命令适用于 POSIX Shell；Windows 可使用 `.venv\Scripts\Activate.ps1`。GitHub Actions 运行相同检查，并用 `scripts/check_whitespace.py` 检查 PR 或 push 的实际提交范围；首次推送和手动运行检查整个提交树。检查范围是分发结构和安装行为，不执行人物建模。

## 许可证与素材

指令、文档和辅助脚本采用 [MIT License](LICENSE)，许可证随技能一并分发。人物参考图、角色设计、贴图和外部模板的权利需单独确认；仓库许可证不替第三方素材授予使用权。

这是社区项目，与 OpenAI 或 Blender Foundation 无官方隶属关系。
````
