打印前用 DfAM 限值检查网格可打印性：针对…

当需要判断 .stl、.obj、.ply、.3mf 零件是否可按 FDM、SLS、SLA/DLP、metal PBF、MJF 等工艺打印，或需要悬垂/壁厚/支撑分析和打印方向建议时使用。

适用场景

解决思路

1. 使用已安装的本地技能文件作为运行时真源；仓库链接仅用于溯源和发布审查。
2. 在切片或打印前，对网格文件生成保守、基于证据的 DfAM 报告：本地测量几何事实，并与各工艺设计限值比较；绝不切片、上传或启动打印任务。
3. 在活动项目 Python 环境中使用 `scripts/dfam_tool.py` 获取所有几何事实；先安装 `requirements.txt`，每次运行都需要它。
4. `scripts/dfam_tool.py` 只报告测量事实，不输出 pass/fail 或就绪状态；比较和结论属于本工作流。
5. 当工具能测量时，不要用肉眼或渲染图估算壁厚、悬垂角或支撑体积。
6. 运行 `python scripts/dfam_tool.py measure part.stl --angle-limit 45` 进行测量。
7. 运行 `python scripts/dfam_tool.py orientations part.stl --angle-limit 45` 获取打印方向候选。
8. 测量前，将 `--angle-limit` 设为 `references/process-limits.md` 中目标工艺的自支撑角度；目标工艺变化时重新运行，因为聚合支撑面积事实按该角度分箱。
9. 对 STEP/STP 输入，不要直接按网格解析：它是边界表示 CAD；当安装了 `$cad` 技能时，先用它导出 STL sidecar，再在此处测量 STL，并报告该修复建议。
10. 对 STEP 运行 `measure` 会以退出码 1 和 `{"error": "failed to load mesh: ..."}` 结束；这是错误输入信号，不是缺少依赖，不要为此安装额外网格加载器。
11. 若某个事实族无法计算，它会返回 `{"error": ...}` 代替该事实，而不影响报告中的其他测量；例如依赖集不完整时 `wall_thickness` 如此，几何体没有凸包时 `support_volume` 如此。
12. 这种报告是 PARTIAL：包含 `"partial": true`，在 `partial_sections` 中列出事实族，命令退出码为 **2**（0 表示完整报告，1 表示网格完全无法加载）。
13. 将每个此类无法计算的对象视为未测量事实（`❓ need more info`），绝不要当作零测量；在比较壁厚限值前重新安装 `requirements.txt`。
14. 收集打印意图：目标工艺、材料、层高，以及用户能提供的任何机器或材料数据表。
15. 如果工艺未知，先用默认 45° 限值测量一次，然后按候选工艺分别呈现发现，而不是猜测单一结论。
16. 阅读 `references/process-limits.md` 并为目标工艺选择限值列；用户提供的机器/材料数据表覆盖默认值；每次比较都引用所用来源。
17. 对精确的上传文件运行 `measure`；不要只检查生成器脚本、源 CAD 模型或文件的控制台摘要。
18. 当工艺需要支撑且测得的支撑面积非零时，运行 `orientations`；报告任何能显著减少支撑面积的候选，并说明其构建高度权衡。
19. 将每个测量事实与引用的限值比较，并用克制状态标签报告发现：`✅ pass` 表示测量事实满足引用限值；`❌ fail` 表示测量事实直接违反引用限值；`❓ need more info` 表示缺少工艺上下文、几何未测量、采样太稀疏而不可信或工具限制。
20. 按严重性排序发现：先水密性（对所有工艺都会阻断切片），再壁厚，再悬垂/支撑，再方向和成本信号。
21. 只比较可信的证据对。
22. 对每个发现，引用限值来源（`process-limits` 表行或用户数据表字段）和测量事实（JSON 字段路径）。
23. 当 `p05_mm` 低于壁厚限值时，即使单独的 `min_mm` 可能只是采样离群值，也将其视为违规；同时报告两个值。
24. 在装配体上，`wall_thickness` 报告 `body_count` 和 `per_body` 细分；将违规归因到所属 body；跨 body 汇总出的薄壁数值不能作为针对整体零件的发现。
25. 不要将支撑角度发现应用于粉末工艺（SLS、MJF）；粉末工艺相关检查是封闭体积粉末逃逸，本工具尚未测量；当很可能存在封闭空腔时，将其报告为 `❓ need more info`。
26. 不要静默重新缩放几何体；`scale.units_suspect` 从边界框对角线测量：当它为 `true` 时，源文件很可能以米或英寸为单位，每个朝下面都会被读作贴在平台上，悬垂和支撑数值 0.0 没有意义；报告单位/比例发现，并在与任何材料限值比较前要求用户确认单位。
27. 支撑体积比例是粗糙上限；除非用户设定了显式预算，否则将其报告为成本信号，而不是硬失败。
28. 对每个 `❌ fail`，包含具体、通俗的重设计说明和目标数值（例如“将 [12.4, 3.0, 8.1] 处的壁从 0.6 mm 加厚到 ≥1.2 mm”或“将 [23.3, 10.0, 52.0] 处的悬垂倒角到 ≥45°”）。
29. 当安装了 `$cad` 技能时，提议用它应用重设计说明，并在此处重新测量再生成的几何体，重复直到没有 `❌ fail` 发现。
30. 当安装了 `$cad-viewer` 时，将测量得到的文件路径交给它，以便用户可视化检查发现。

适用边界 · 注意事项

• 未安装 `requirements.txt`、缺少 `scripts/dfam_tool.py` 或没有已安装的本地技能文件时，不要依赖此流程；它也绝不用于切片、上传或启动打印任务。
• 对 SLS、MJF 等粉末工艺，不要套用支撑角度结论；封闭空腔的粉末逃逸检查工具尚未测量，应报告 `❓ need more info`。
• 当 `scale.units_suspect` 为 `true` 或输入仍是 STEP/STP 且未先导出 STL 时，不要直接与材料/工艺限值比较；先确认单位或导出 STL。