mcpField
E
export-stl

export-stl

github.com/iancanderson设计与 UI13037 次安装38 周前更新
代码仓库

关于 export-stl

export-stl 是一项将 OpenSCAD 文件导出为 STL 的技能，面向准备 3D 打印模型的用户。导出时会检查常见几何问题；发现问题仍会完成导出并给出修复提示。

主要功能

  1. 01将 OpenSCAD 导出为 STL
  2. 02支持二进制和 ASCII 格式
  3. 03检查非流形几何
  4. 04检查自相交与退化面
  5. 05报告三角形数量及修复建议

适用场景

  1. 01将预览确认后的模型导出用于 3D 打印
  2. 02为切片前检查网格可打印性
  3. 03排查模型中的几何缺陷

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/iancanderson/openscad-agent --skill export-stl

安装后在 Claude Code 中输入/export-stl确认已加载。

附带文件scripts/export-stl.sh

详细介绍

导出 STL 技能

将 OpenSCAD 文件转换为 STL 格式，用于 3D 打印，并自动验证几何形状。

使用时机

在以下情况下使用此技能：

  1. 设计已完成迭代，并且在 PNG 预览中看起来正确
  2. 准备好导出用于 3D 打印

用法

.claude/skills/export-stl/scripts/export-stl.sh <input.scad> [options]
选项
  • --output <path> - 自定义输出路径（默认：<input>.stl）
  • --binary - 导出二进制 STL（文件较小，默认）
  • --ascii - 导出 ASCII STL（便于阅读）

几何验证

导出期间，脚本会检查常见的可打印性问题：

  • 非流形几何 - 网格存在孔洞，或有边被 2 个以上的面共用
  • 自相交几何 - 模型的部分区域不正确地重叠
  • 退化面 - 可能导致切片器出现问题的零面积三角形

如果检测到问题，导出仍会完成，但会显示警告，并提供修复指导。

示例

phone_stand_003.scad 在预览中效果良好后：

.claude/skills/export-stl/scripts/export-stl.sh phone_stand_003.scad

输出：

--- Geometry Validation ---
STATUS: PASSED - No geometry issues detected
- Mesh appears manifold (watertight)
- No self-intersections found
- Ready for slicing

工作流集成

/openscad → /preview-scad → /export-stl
                              ↓
                     Geometry validation
                              ↓
                     Ready for slicer

修复常见问题

如果验证报告了问题：

  • 非流形：确保所有形状都是闭合实体，避免在 3D 上下文中使用 2D 形状
  • 自相交：使用 union() 正确合并重叠的形状
  • 退化面：检查是否存在过薄的特征；对于曲线，增大 $fn

备注

  • 推荐使用二进制 STL（文件较小，处理速度更快）
  • 导出会执行完整渲染，因此复杂模型可能需要一些时间
  • 会报告三角形数量，以便估算切片复杂度

评论

支持 Markdown