Communitygithub.com

dnlgalleguillos/gauge-modeling

在Blender中使用bmesh对硬表面和道具网格进行建模,并通过指标验证:N边形、孔洞、翻转法线、重复和松散几何体、UV密度。附带倒角零件库、门控和安全修复脚本。在构建或审查任何网格时使用。

gauge-modeling 是什么?

这是一个专门用于Blender中硬表面和道具网格建模与验证的技能。它利用bmesh和数据API,无需任何UI上下文即可工作,并支持对评估后的网格进行门控检查,确保修饰器和几何节点也被纳入计算。该技能提供了一套构建函数(如rounded_box、cylinder、bolt_head、cut_holes),可生成带真实倒角的网格,并支持通过JSON规范文件构建完整的道具。门控系统会对网格进行全面的健康检查,包括松散顶点、零面积面、重复顶点、非流形边、倒转体积、N边形、三角形、封闭性、UV和纹素密度等项目。配套的修复脚本(fix_mesh.py)提供干运行模式,仅在明确指定apply=true时才实际修改网格。该技能适用于Claude Code、Cursor、Codex等AI编程代理,通过调用Blender命令行执行Python脚本的方式运行,帮助开发者在构建或审核任何网格时确保网格质量。其核心设计强调真实世界尺寸优先、倒角为最小尺寸1-4%、倒角后平滑处理、布尔运算后三角化导出,以及修改后立即门控并多角度审视。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/dnlgalleguillos/blender-gauge/tree/HEAD/skills/gauge-modeling

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Gauge建模

使用bmesh/数据API构建(无需UI上下文),然后门控评估后的网格,使修饰器和几何节点也被计入。

构建

scripts/kit.py(从它旁边的脚本导入):

函数生成内容
rounded_box(name, size, bevel, segments, loc, rot, collection)在网格中带有真实倒角的盒子,按角度平滑
cylinder(name, radius, depth, segments, bevel, ...)带有倒角端盖的圆柱体
bolt_head(name, radius, height, sides, bevel, ...)六角(或圆形)螺栓头
cut_holes(target, [(u, v, r), ...])在最小轴向上打圆孔(布尔运算后烘焙)
bake_modifiers(ob)应用整个修改器栈,无需bpy.ops
assign(ob, material)单个材质槽

构建函数会替换同名对象,因此脚本可以重复运行。scripts/build_prop.py 从 JSON 部件列表(或演示板条箱)构建整个道具到自己的集合中,并对其进行门控:

run_blender_script path=skills/gauge-modeling/scripts/build_prop.py args={"name": "crate", "spec": "parts.json"}

门控

scripts/mesh_gate.py -> 门控 mesh-health。

检查项失败条件典型修复方法
loose_verts, zero_area_faces, duplicate_verts任意fix_mesh.py
non_manifold_edges边被3个或更多面共享重建该区域
inverted_volume闭合网格体积为负fix_mesh.py (normals)
ngons超过 max_ngons(可选)fix_mesh.py 配合 triangulate_ngons,或重新四边化
triangles超过 max_tris(可选)减面,减少倒角分段
closed_meshesrequire_closed 且存在孔洞填充
has_uv, texel_density_cvrequire_uv / 给定限制展开UV,均衡岛屿缩放

fix_mesh.py 是干运行,直到 apply=true;它从不触及选择范围外共享的网格数据。

规则

  • 先确定真实世界尺寸(米),再倒角:倒角是最小尺寸的1-4%。没有倒角的硬边无法捕捉光线。
  • 先倒角再平滑;按角度(35度)平滑,而不是使用面标志。
  • 布尔运算在切割面上留下N边形:用于静帧没问题,导出到引擎前需三角化。
  • 保持部件为单独的命名对象直到最后;仅导出时合并。
  • 每次修改后:门控,然后在粘土着色下从多角度观察以评判造型。

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

相关技能