dfam-check

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

DfAM Check

DfAM检查

Provenance: maintained in earthtojake/text-to-cad. Use the installed local skill files as the runtime source of truth; the repository link is only for provenance and release review.

Use this skill to produce conservative, evidence-backed DfAM reports for mesh files before slicing or printing. It measures geometry facts locally and compares them against per-process design limits; it never slices, uploads, or starts print jobs.

来源：维护于earthtojake/text-to-cad。以本地安装的技能文件作为运行时的权威来源；仓库链接仅用于溯源和版本审核。

使用此技能可在切片或打印前为网格文件生成保守且有证据支持的DfAM报告。它会在本地测量几何数据，并与各工艺的设计限值进行对比；不会进行切片、上传或启动打印作业。

Geometry Inspection

几何检测

Use

scripts/dfam_tool.py

in the active project Python environment for all geometry facts (requires

trimesh

numpy

rtree

). The tool is fact-only: it reports measurements and never emits pass/fail or readiness statuses. Comparisons and verdicts belong to this workflow. Do not estimate wall thickness, overhang angles, or support volume by eye or from renders when the tool can measure them.

bash

python scripts/dfam_tool.py measure part.stl --angle-limit 45
python scripts/dfam_tool.py orientations part.stl --angle-limit 45

Set

--angle-limit

to the target process's self-supporting angle from

references/process-limits.md

before measuring, and re-run when the target process changes: the aggregate support-area facts are binned against it.

STEP/STP input is boundary-representation CAD, not a mesh. When the

$cad

skill is installed, export an STL sidecar with it first, then measure the STL here. Report that remediation instead of attempting raw STEP parsing.

在当前项目的Python环境中使用

scripts/dfam_tool.py

获取所有几何数据（需依赖

trimesh

、

numpy

、

rtree

）。该工具仅输出事实数据：它会报告测量结果，但不会给出通过/失败或就绪状态。对比和判定属于本工作流程的范畴。当工具可进行测量时，请勿通过目测或渲染图估算壁厚、悬垂角度或支撑体积。

bash

python scripts/dfam_tool.py measure part.stl --angle-limit 45
python scripts/dfam_tool.py orientations part.stl --angle-limit 45

测量前，请根据

references/process-limits.md

中目标工艺的自支撑角度设置

--angle-limit

参数；当目标工艺变更时，请重新运行该命令：总支撑面积数据会基于此参数进行分组统计。

STEP/STP格式的输入是边界表示法CAD文件，而非网格文件。当

$cad

技能已安装时，请先使用它导出STL副文件，再在此处测量该STL文件。请告知用户此处理方式，而非尝试直接解析STEP文件。

Workflow

工作流程

Collect print intent: target process, material, layer height, and any machine or material datasheet the user can provide. If the process is unknown, measure once with the default 45° limit, then present findings per candidate process rather than guessing a single verdict.
Read
```
references/process-limits.md
```
and select the limit column for the target process. A user-provided machine/material datasheet overrides the defaults; cite whichever source is used for every comparison.
Run
```
measure
```
on the exact upload file. Do not inspect only a generator script, source CAD model, or console summary of the file.
Run
```
orientations
```
when the process requires supports and the measured support area is nonzero. Report any candidate that materially reduces support area, with its build-height tradeoff.
Compare each measured fact to the cited limit and report findings with restrained status labels:
- ```
✅ pass
```
  : the measured fact satisfies the cited limit.
- ```
❌ fail
```
  : a measured fact directly violates the cited limit.
- ```
❓ need more info
```
  : missing process context, unmeasured geometry, sampling too sparse to trust, or tool limitations.
Order findings by severity: watertightness first (blocks slicing for every process), then wall thickness, then overhangs/supports, then orientation and cost signals.

收集打印需求：目标工艺、材料、层厚，以及用户能提供的任何机器或材料数据表。若工艺未知，请先使用默认的45°限值进行测量，然后针对各候选工艺呈现结果，而非猜测单一判定。
查阅
```
references/process-limits.md
```
，选择目标工艺对应的限值列。用户提供的机器/材料数据表优先级高于默认值；每次对比都需注明所使用的来源。
对上传的原始文件运行
```
measure
```
命令。请勿仅检查生成器脚本、源CAD模型或文件的控制台摘要。
当工艺需要支撑且测量得到的支撑面积不为零时，运行
```
orientations
```
命令。报告所有能显著减少支撑面积的候选方向，以及对应的打印高度权衡。
将每个测量数据与引用的限值进行对比，并使用严谨的状态标签报告结果：
- ```
✅ 通过
```
  ：测量数据符合引用的限值。
- ```
❌ 失败
```
  ：测量数据直接违反引用的限值。
- ```
❓ 需要更多信息
```
  ：缺少工艺上下文、未测量的几何数据、采样过于稀疏不可信，或存在工具限制。
按严重程度排序结果：首先是水密性（会阻止所有工艺的切片），其次是壁厚，然后是悬垂/支撑，最后是打印方向和成本信号。

Comparison

对比规则

Compare only trustworthy pairs of evidence.

Cite the limit source (process-limits table row, or the user's datasheet field) and the measured fact (JSON field path) for every finding.
Treat
```
p05_mm
```
below the wall-thickness limit as a violation even when
```
min_mm
```
alone could be a sampling outlier; report both values.
On an assembly,
```
wall_thickness
```
reports
```
body_count
```
and a
```
per_body
```
breakdown. Attribute a violation to the body it belongs to; a thin figure pooled across bodies is not a finding against the part as a whole.
Do not apply support-angle findings to powder processes (SLS, MJF); the relevant powder-process check is trapped-volume powder escape, which this tool does not yet measure — report that as
```
❓ need more info
```
when enclosed cavities are likely.
Do not silently rescale geometry.
```
scale.units_suspect
```
is measured from the bounding-box diagonal: when it is
```
true
```
, the source is probably in meters or inches, every down-facing face reads as resting on the plate, and overhang and support figures of 0.0 mean nothing. Report a unit/scale finding and ask the user to confirm units before comparing anything against a material limit.
Support-volume ratios are coarse upper bounds; report them as cost signals, not hard failures, unless the user has set an explicit budget.

仅对比可靠的证据对。

每个结果都需注明限值来源（工艺限值表中的行，或用户数据表中的字段）和测量数据（JSON字段路径）。
即使
```
min_mm
```
可能是采样异常值，若
```
p05_mm
```
低于壁厚限值，也视为违规；需同时报告这两个数值。
对于装配体，
```
wall_thickness
```
会报告
```
body_count
```
和
```
per_body
```
细分数据。将违规归因于对应的部件；跨部件汇总的薄型数据不能作为整个零件的违规依据。
请勿将支撑角度结果应用于粉末工艺（SLS、MJF）；粉末工艺的相关检查是封闭腔体的粉末逃逸性，本工具目前无法测量此指标——当可能存在封闭腔体时，请将其报告为
```
❓ 需要更多信息
```
。
请勿静默缩放几何模型。
```
scale.units_suspect
```
是根据包围盒对角线测量得出的：当该值为
```
true
```
时，源文件单位可能是米或英寸，所有朝下的面都会被识别为贴合打印平台，悬垂和支撑数值为0.0将毫无意义。请报告单位/缩放问题，并要求用户确认单位后再与材料限值进行任何对比。
支撑体积比是粗略的上限值；请将其作为成本信号报告，而非硬性失败指标，除非用户设置了明确的预算。

Redesign Handoff

重新设计交接

For every

❌ fail

, include a concrete, plain-language redesign instruction with target numbers (for example "thicken the wall at [12.4, 3.0, 8.1] from 0.6 mm to ≥1.2 mm" or "chamfer the overhang at [23.3, 10.0, 52.0] to ≥45°"). When the

$cad

skill is installed, offer to apply the redesign instructions with it and re-measure the regenerated geometry here, repeating until no

❌ fail

findings remain. When

$cad-viewer

is installed, hand the measured file path(s) to it so the user can inspect the findings visually.

对于每个

❌ 失败

结果，请包含具体、通俗易懂的重新设计说明及目标数值（例如“将[12.4, 3.0, 8.1]处的壁厚从0.6 mm加厚至≥1.2 mm”或“将[23.3, 10.0, 52.0]处的悬垂倒角至≥45°”）。当

$cad

技能已安装时，可主动提出使用该技能应用重新设计说明，并在此处重新测量生成的几何模型，重复此过程直至无

❌ 失败

结果。当

$cad-viewer

技能已安装时，请将测量文件路径交付给它，以便用户直观检查结果。