从2D正交线框图PNG生成3D…

用户提供线框/正交视图/技术图纸PNG，想生成3D模型或.glb文件时，用Blender MCP驱动四阶段管线完成转换。

适用场景

解决思路

1. 前置检查：调用 mcp__blender__get_scene_info 确认 Blender MCP 可达；若报 '# 无法连接 Blender' 则让用户启动 Blender 并启用 BlenderMCP 插件（端口 9876）。
2. 前置检查：运行 python3 -c "import cv2, numpy, scipy" 2>&1 验证依赖；若失败则执行 pip install opencv-python numpy scipy Pillow。
3. 前置检查：确认用户提供至少一张 PNG，尺寸 ≥ 400×400 px，为黑底白线或白底黑线。
4. 决策 Q1 视图数量：单视图→仅做平面2D挤出并警告用户需假定深度；前+侧视图→完整3D重建（轮廓×深度剖面）；前+侧+后→用后视图做对称性校验。
5. 决策 Q2 细节级别：preview 用 RDP epsilon=4.0、约1–2k三角面、<1 MB；production（默认）用 epsilon=2.0、约5–8k三角面、2–4 MB；high 用 epsilon=1.0、约10–20k三角面，必要时用 Decimate 压到15 MB以下。
6. 决策 Q3 几何类型：wires（框架、铰链）用曲线 bevel_depth；surfaces（镜片、穹顶）用放样剖面或封盖；hybrid（默认，适合眼镜类）两者兼用。
7. 决策 Q4 真实尺度：用户给出尺寸（如眼镜宽140 mm）则采用；否则按线框长宽比推断并采用合理默认值（眼镜140 mm、头盔180 mm 等），不明显时与用户确认。
8. 当用户反馈模型与参考/贴图不符时，切换到 reference-locked modeling：先从贴图/线框数清可见设计部件数量并写入 stdout/notes，不要凭对称性推断径向或重复数量，以源清单中的视觉设计数量为准。
9. 以正视图为准：在与校验相同的正视正交相机中创建 image-empty/plane/reference 叠加层，先对齐比例、中心线和外接圆，再加深度。
10. 先在正视图 X/Z 平面描出或定义2D轮廓，再由这些轮廓构建网格表面，不要先放通用椭圆再贴图。
11. 锁定正投影：正视图轮廓匹配后再沿视图轴加深度；侧/后视图只用于细化厚度和堆叠，不得改变正视图轮廓。
12. 对需要匹配正视图的贴图使用 Project-from-View 风格 UV，使一个正面朝向的表面与对应贴图裁剪区域 1:1 映射。
13. 渲染叠加校验：将参考/线框置于模型后方或上方，并打印检查清单：预期数量、实际对象数、面位置、外轮廓边界、侧/后深度。
14. 若同一错误连续出现两次，查阅 references/best-practices.md 并添加一条简短持久笔记后再尝试。
15. 对重复母题对象，严格按源清单声明的主结构部件数量创建，按源可见位置或语义角色命名，导出前校验数量。
16. 阶段1：对每个视图运行 python3 ${CLAUDE_SKILL_DIR}/scripts/wireframe_analyzer.py <input.png> <output.json>，输出 JSON 含 metadata、contours、bezier_curves。
17. 阶段1调参：轮廓太少或锯齿→把 RDP epsilon 降到 1.0–1.5；噪点太多→升到 3.0–4.0；通过 --rdp-epsilon 传入。
18. 阶段1：用 Read 读取 JSON，不要把巨大 JSON 直接传给 Blender，先提取所需内容。
19. 阶段2：以小型自包含代码块构建代码（每次 execute_blender_code 调用获得全新 Python 命名空间，仅 bpy.data 持久），每次重新 import 所需模块。
20. 阶段2：用 bpy.data.curves.new 创建 Bezier 曲线，设置 dimensions='3D'、resolution_u=16、bevel_depth=0.001、use_fill_caps=True，用 spline.bezier_points.add 添加控制点并设 handle_left_type/right_type='ALIGNED'，通过 print 回传信号。
21. 阶段2：在生成的代码中做像素→世界坐标转换：norm_x = px_x / img_width；norm_y = 1.0 - (px_y / img_height)；x_world = (norm_x - 0.5) * world_width_mm / 1000.0；y_world = (norm_y - 0.5) * world_height_mm / 1000.0。
22. 阶段2：曲线转网格并清理：bpy.ops.object.convert(target='MESH')，进入 EDIT 模式执行 remove_doubles(threshold=0.0001) 和 normals_make_consistent(inside=False)，回 OBJECT 模式执行 shade_smooth()。
23. 阶段2：用 Principled BSDF 创建 PBR 材质（glTF 唯一能干净导出的着色器），设置 Base Color、Metallic、Roughness，并赋给对象。
24. 阶段2材质预设：MAT-frame-metal 用 (0.08,0.08,0.10)、metallic=1.0、roughness=0.25；MAT-lens-mirror 用 (0.05,0.08,0.15)、metallic=0.8、roughness=0.05、IOR=1.5；MAT-pad-silicone 用 (0.65,0.63,0.60)、metallic=0.0、roughness=0.7。
25. 阶段2：用 bpy.ops.export_scene.gltf 导出 GLB，参数 export_format='GLB'、export_materials='EXPORT'、export_uv=True、export_normals=True、export_animations=False、export_yup=True，并打印文件大小。
26. 阶段3校验：调用 get_scene_info 确认对象存在；对成对部件（左右镜片）调用 get_object_info 比较包围盒宽度，容差1 mm；检查三角面数是否超预算；确认文件 ≤ 15 MB（理想 ≤ 8 MB）。
27. 错误恢复：MCP 报代码执行错误→拆成更小代码块并据错误行定位；报无法连接 Blender→让用户启动 Blender 和插件；报超时→拆分 execute_blender_code 调用；变量跨调用未定义→重新 import 并用 bpy.data.objects['name'] 引用对象。
28. 错误恢复：分析器输出0个轮廓→用 --gaussian-kernel 7 --canny-t1 30 重跑；镜片不对称→警告用户，未经要求不要自动镜像；GLB 过大→加 DECIMATE 修改器 ratio 0.6–0.8 后重导出；网格有洞→把 curve_data.resolution_u 提到 24 或 32 后重转；GLB 缺材质→只用 Principled BSDF 重建材质。
29. GLB 超 15 MB 时用 Decimate：obj.modifiers.new(name='Decimate', type='DECIMATE')，设 mod.ratio=0.7、mod.use_collapse_degenerate=True，执行 bpy.ops.object.modifier_apply。
30. 完成后向用户报告：GLB 输出路径、文件大小（对比15 MB上限）、每部件三角面数（对比30000上限）、已分配材质槽、以及任何警告（不对称、已减面、使用了回退方案）。
31. 需要时按需加载参考：分析器输出异常时读 references/algorithms.md；需要非标准几何时读 references/blender-patterns.md；构建慢或拓扑差时读 references/best-practices.md。
32. 用户只说“转换这个线框”时默认：view_type=auto-detect、detail_level=production、geometry_type=hybrid、world_width_mm=auto；仅在多种解释都合理时才追问。
33. 明确范围边界：本技能只产出2D轮廓挤出成细曲线（Y方向扁平的线框表示），不产出填充表面、单视图真实3D深度、多视图体积重建、输入线中不存在的子特征或生产级材质。
34. 当用户要“完整的渲染贴图模型”时，规划技能链：wireframe-to-3d → blender-modeling（填充镜片、镜腿等）→ blender-materials → blender-lighting → blender-cameras → blender-rendering。

适用边界 · 注意事项

• 需要填充表面、真实3D深度、多视图体积重建或输入线中不存在的子特征时，本技能不适用，需链式调用其他技能。
• 需要生产级材质或完整渲染贴图成品时，本技能只产出占位材质，应配合 blender-materials 等技能。
• Blender MCP 插件未运行或缺少 opencv-python/numpy/scipy 依赖时无法执行。