用途:在 Three.js 中从语义契约与明确坐标系生成程序化几何,把多边形操作视为设计模型、三角面输出视为最终编译步骤。适用于完整硬表面装配、人形机器人、轮廓挤出、参数曲线放样等场景。
主要能力:提供建模循环(定义单位、局部/世界坐标系、尺寸、边界、主轮廓、拓扑意图、壳厚、开口、材质槽、三角面带;声明接触、支撑、间隙、穿透、活动包络等关系;为每个可见形体选择挤出、内嵌、放样、旋转、扫掠、开口、实体化、细分、倒角或圆角等操作)。强调保留四边形与 n-gon、每个语义部件一个命名网格、按顺序应用修改器、清理与修复绕序、按部件设置平滑角后再输出三角面。
质量门与审计:包含多边形拓扑门、命名世界装配审计(共面重叠、缺陷、实体冲突)、语义检查(支撑、开口、壳厚采样、人体工学间隙、运动极值)、按材质槽合并后再次审计,并检查固定轮廓、隐藏面、接缝、交互视图、线框、法线与掠射光。
可移植工具包:assets/geometry-quality-kit/ 可放入 Three.js 项目,含 procedural-mesh.js(MeshData、多边形清理、绕序重建、轮廓、偏移、挤出、放样、旋转、扫掠、实体化、细分、倒角、开口、平滑角法线、材质槽构建与 Three.js 输出)、mesh-topology-audit.js、geometry-audit.js、geometry-contract.js、assembly.js、selftest.js。放置或适配后需运行 selftest.js。
参考与示例:references/geometry-craft-workflow.md、references/geometry-quality-gates.md、references/profile-sweeps-and-mesh-writers.md、references/complete-submarine-assembly.md、references/vehicle-loft-and-projector-contract.md、references/procedural-optimus-humanoid-assembly.md 等,以及雕塑画框、潜艇、F1 赛车、运动摩托、Optimus 人形、金融塔等模型示例。
限制与失败条件:可见尺度下同向共面三角面残留;松散顶点、退化面、开放实体、非流形边、分离组件、无效法线或内向闭合体积进入输出;无关实体相交或部件缺少声明的支撑/接触关系;暴露壳过薄或开口只是视觉叠加;可见图元保留锐边或无过渡连接;轮廓框架翻转、封盖共享平滑侧法线或 UV 密度随段数变化;在命名部件审计前合并材质;仅以三角面数作为复杂度证据;脚本通过但固定视图检查仍发现不合理建模;完整人形被简化为相交胶囊与盒子;镜像手或肢体保留内向绕序;未做足迹过滤就输出高频物体空间材质噪声。
路由边界:本技能负责可复用网格构建与几何质量;当表面身份为主时用 $threejs-procedural-materials,建筑语法用 $threejs-procedural-architecture,植被生长层级用 $threejs-procedural-vegetation。