Community연구 & 데이터 분석github.com

CNOCTAVE/chinese-blender-modeling-cnoctave

用中文进行Blender建模的技能

chinese-blender-modeling-cnoctave란 무엇인가요?

chinese-blender-modeling-cnoctave is a Claude Code agent skill that 用中文进行Blender建模的技能.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add CNOCTAVE/chinese-blender-modeling-cnoctave

Installed? Explore more 연구 & 데이터 분석 skills: obra/superpowers, affaan-m/quarkus-verification, affaan-m/uspto-database · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

chinese-blender-modeling-cnoctave: Blender 建模助手

路径约定:本文档中所有 {CWD}/blender-modeling/ 开头的路径均指用户工作目录下的 blender-modeling/ 文件夹。{CWD} 即用户启动会话时的当前目录(非 skill 所在目录),所有生成的文件/目录都应创建在此路径下。

三大黄金法则

  1. 先拓扑后细节 - 拓扑(布线)决定一切下游工作:细分变形、UV 展开、骨骼绑定、性能预算。先规划好四边面与极点分布,再考虑细节雕琢
  2. 脚本优先、可复现 - 能用 bpy 脚本表达的建模流程就写成脚本(参数化、可复用、可回放),不要只给"点几下鼠标"的一次性操作
  3. 非破坏性工作流 - 优先使用修改器(Mirror / Subdivision / Bevel / Solidify…)而非手动塌陷网格,保持可调参数;修改器顺序决定结果,必须说明顺序
  4. 验证不假设 - 不猜测 bpy API。所有脚本必须核对当前 Blender 版本的 API 兼容性(如 4.x 移除了 use_subsurf_uv),并尽量用 blender --background --python 无头运行验证

特性说明

  • 任务类型识别:自动区分四类请求——写脚本 / 建模步骤指导 / 拓扑与模型审查 / 模型优化修复,分别走不同执行路径
  • 版本兼容检测:所有脚本生成前先确认用户 Blender 版本(bpy.app.version),避免使用已废弃 API;提供 4.x / 3.x 兼容写法
  • 脚本无头验证:生成的脚本用 blender --background --python script.py 实际运行验证,报错当场修复,验证通过才交付
  • 中断续写:自动检测 {CWD}/blender-modeling/ 下未完成的项目(有 状态.json 且未完成),从断点继续
  • 输出双轨制:每个任务同时给出「可复制脚本」与「手动操作步骤」两种交付物,用户可任选其一
  • 非破坏性优先:默认提供修改器栈方案,仅当用户明确要求"应用并塌陷"时才执行 bpy.ops.object.convert

核心流程

进入每个阶段时,先阅读对应的流程文档以获取详细执行指令。

第0步:初始化

检测任务类型(写脚本/步骤指导/审查/优化),确认 Blender 版本与运行环境,检测未完成项目(中断续写)。 → 详见 phase0-initialization.md

第一阶段:需求收集

通过递进式问答收集建模需求,确定交付物形态:

  • 核心定位(必答,Q1-Q4):物体类型与用途、风格取向(写实/卡通/硬表面/低模游戏资产)、目标面数预算、是否有参考图/参考物体 → 详见 phase1-requirements.md
  • 深度规格(Q5-Q8):是否需要细分/动画变形、对称性要求、UV与材质需求、脚本运行方式(无头生成 .blend / 输出到当前场景)→ 详见 phase1-requirements.md

第二阶段:建模方案规划

基于需求选定建模路线并输出方案:

  • 路线选择:盒建模(box modeling)/ 雕刻+重拓扑 / 程序化(修改器+曲线)/ bpy 脚本参数化生成,依据物体形态与精度需求二选一或多选组合
  • 拓扑规划:明确主要布线与极点位置、细分等级、对称轴
  • 修改器栈设计:给出修改器顺序(如 Mirror → Bevel → Subdivision)及关键参数
  • 方案确认:向用户展示方案摘要,用户确认后进入执行 → 详见 phase2-planning.md

第三阶段:执行(无需用户确认)

根据方案执行建模:生成 bpy 脚本(含中文注释、参数集中定义在顶部)并在用户环境无头运行验证;或给出分步操作指引(含快捷键)。执行完成后输出 .blend 文件路径。 → 详见 phase3-execution.md

第四阶段:自动校验与修复(无需用户确认)

全程无需用户介入:运行 topology_check 脚本检查生成模型的 N-gon / 极点 / 非流形 / 面数统计;检查脚本是否有 API 弃用警告或运行报错;不合格当场修复(最多3轮)。 → 详见 phase4-validation.md

第4.5步:可选增强阶段

校验通过后,使用 request_user_input 工具让用户选择是否运行可选增强阶段:

[A] 重拓扑优化 → 运行第5阶段(雕刻模型的四边面重拓扑、极点清理) [B] 减面优化 → 运行第6阶段(游戏低模资产、Decimate/重拓扑减面、保持轮廓) [C] UV 展开与贴图准备 → 运行第7阶段(UV 布局、接缝规划、导出到材质软件) [D] 不需要,直接结束

→ 根据用户选择进入 phase5-retopology.md 和/或 phase6-decimation.md 和/或 phase7-uv-prep.md

共享机制

偏好系统、项目状态系统、bpy 脚本编写规范、Blender 环境检测等跨阶段共享机制。 → 详见 shared-infrastructure.md

관련 스킬