chinese-blender-modeling-cnoctave

面向中文用户的 Blender 建模助手 Skill。让 AI 助手能够像专业建模师一样工作：先规划拓扑、再动手建模，优先输出可复现的 bpy 脚本，并自动做无头验证与拓扑健康检查。

姊妹项目：chinese-blender-modeling-cnoctave（中文小说创作）——本 skill 采用与其一致的分阶段流程结构。

特性

• 四类任务识别：写脚本 / 步骤指导 / 拓扑审查 / 模型优化，自动分流
• 版本兼容检测：脚本生成前确认 Blender 版本（bpy.app.version），规避 4.x 已移除 API（如 use_subsurf_uv）
• 脚本无头验证：blender --background --python 实跑验证，报错当场修复（最多3轮）
• 非破坏性优先：默认交付修改器栈方案（Mirror → Bevel → Subdivision → Solidify），不随意塌陷
• 拓扑健康检查：内置 topology_check.py 无头检测非流形 / 极点 / N-gon / 法线翻转 / 孤立顶点
• 输出双轨制：同一任务同时交付「可复制脚本」与「手动操作步骤（含快捷键）」
• 中断续写：项目状态落盘（状态.json），随时从断点继续

目录结构

chinese-blender-modeling-cnoctave/
├── SKILL.md                          # 主入口（frontmatter + 黄金法则 + 流程总览）
├── README.md
├── references/
│   ├── flows/                        # 阶段执行文档（Phase 0-7）
│   │   ├── phase0-initialization.md  # 初始化与任务识别
│   │   ├── phase1-requirements.md    # 需求收集（两轮问答）
│   │   ├── phase2-planning.md        # 建模方案规划（路线/拓扑/修改器栈）
│   │   ├── phase3-execution.md       # 执行（脚本生成/步骤指导）
│   │   ├── phase4-validation.md      # 自动校验与修复
│   │   ├── phase5-retopology.md      # （可选）重拓扑优化
│   │   ├── phase6-decimation.md      # （可选）减面优化
│   │   ├── phase7-uv-prep.md         # （可选）UV 展开与贴图准备
│   │   └── shared-infrastructure.md  # 共享机制（状态/需求/偏好/规范）
│   └── guides/                       # 知识库
│       ├── topology-guide.md         # 拓扑与布线（极点策略/开孔方案）
│       ├── modifiers-guide.md        # 修改器栈与参数速查
│       ├── bpy-scripting-guide.md    # bpy 脚本骨架与版本兼容写法
│       └── shortcuts-reference.md    # 快捷键与内置插件参考
└── scripts/
    ├── common_utils.py               # bpy 公共工具库（可 import 复用）
    └── topology_check.py             # 无头拓扑健康检查（可退出码判断）

核心流程

Phase 0 初始化（版本检测 + 任务识别 + 中断续写）
   ↓
Phase 1 需求收集（风格/用途/面数预算/对称/UV/交付方式）
   ↓
Phase 2 方案规划（建模路线 + 拓扑规划 + 修改器栈）→ 用户确认
   ↓
Phase 3 执行（生成脚本并无头验证 / 分步指导）   ← 无需用户确认
   ↓
Phase 4 校验（topology_check + API 兼容检查 + 修复≤3轮）
   ↓
Phase 5-7 可选增强（重拓扑 / 减面 / UV）

快速开始

1. 安装为 AI 助手 Skill

将本目录放入你的 AI 助手 skills 目录（如 AtomCode：~/.atomcode/skills/chinese-blender-modeling-cnoctave/），或按你的助手平台的 skill 规范配置 SKILL.md。

2. 使用示例

"帮我用 Blender 建一把科幻椅子，硬表面风格，X轴对称，最终 10 万面以内"

助手将按 Phase 0-4 依次执行，最终交付：

• 生成脚本.py（参数集中在顶部、中文注释、可直接运行）
• 无头验证通过的 输出/科幻椅子.blend
• 可选的手动操作步骤（含快捷键）

3. 脚本验证（可选，本机有 Blender 时）

# 验证生成的建模脚本
blender --background --python 生成脚本.py

# 检查模型拓扑健康度（退出码 0=通过，1=存在非流形等问题）
blender --background --python scripts/topology_check.py -- 输出/模型.blend 模型名

环境要求

• Blender 独立安装版或steam版
• Python

设计原则

1. 先拓扑后细节 — 布线决定细分、变形、UV 与性能
2. 脚本优先、可复现 — 能参数化就写成脚本
3. 非破坏性工作流 — 修改器优先，顺序必须说明
4. 验证不假设 — 不猜 API，实跑验证，版本分支保护

License

MIT