SuperAPI AI 工具集

stl-to-scad

通用与其它

查看项目

更新于 10-16 06:16

技能介绍

用途:将 STL 网格转换为可读、参数化的 OpenSCAD(.scad)代码,渲染出与原模型一致的实体,并输出记录还原精度的报告文件。

默认验收指标:包围盒与特征尺寸误差在 ±0.1 mm 以内;双向表面偏差最大 ≤ 0.25 mm;体积 IoU ≥ 0.99;最多迭代 8 次。保持 STL 原有坐标系、朝向和单位,除非用户要求,否则不重新居中、旋转或缩放。

配套脚本(基于 uv 运行,无需项目配置):analyze_stl.py 报告网格健康度、包围盒、平面层级、镜像对称与截面带,并分类圆、矩形、圆角矩形、多边形等轮廓;compare.py 渲染候选 .scad 并与参考比对,给出各项 PASS/FAIL、缺失/多余材料位置、偏差热点并生成差异 PNG;repair_stl.py 修复非水密参考网格;extract_region.py 为指定盒状区域输出 polyhedron() 模块(需用户批准)。

工作流程:预检确认 STL 存在及 openscad/uv 可用;分析网格并按需修复;先写特征树,按基体、添加特征、移除特征的顺序规划,优先使用基本体与二维挤出等可读构件;编写迭代候选后运行 compare.py,查看差异图并按最大误差优先改进,避免臆测数值,回退退步迭代,必要时重新规划;达到 8 次上限或在满足特定门槛后询问用户是否接受最优结果;最后清理代码、写出 <name>.scad 与 <name>.report.md 并删除临时目录。

适用场景:逆向重建参数化 CAD 模型、需可编辑 OpenSCAD 源码以复现零件几何的场合。限制:完全无平面的有机网格难以用干净 CSG 匹配,需逐区域处理或停止;文字/logo 等装饰标记可省略但需记录;修复后网格作为参考需满足包围盒差为 0 且表面位移不超过偏差目标的 10%。若工具缺失需先安装;并发多实体时各建独立模块。其余细节(如具体平台支持)暂未提供。