如何快速保证 3D 打印质量text-to-cad G-code 校验机制与 6 项自动检查详解【免费下载链接】text-to-cadA library of agent skills for CAD, CAE and CAM项目地址: https://gitcode.com/GitHub_Trending/tex/text-to-cad在 text-to-cad 这套面向 CAD/CAE/CAM 的智能体技能库中G-code 技能skills/gcode负责把 STL、OBJ 等 3D 网格模型切片成可直接打印的 FDM.gcode。而它的validate静态校验环节会执行6 项自动检查——空文件、移动命令、挤出动作、温度指令、XYZ 坐标边界和未知命令帮你把 3D 打印质量问题拦在切片环节而不是等打印失败后才发现。G-code 校验为什么重要打印失败往往源于切片环节一份看起来没问题的 G-code可能藏着打印失败的全部隐患空文件或半截文件切片器报错中断文件里根本没有打印数据缺少挤出动作打印机空跑一圈喷嘴一动但不出料浪费时间和耗材温度指令缺失冷喷嘴强行移动会堵头甚至烧掉步进电机坐标越界打印头撞床沿、撞 Z 轴顶部轻则停打重则撞机不认识的指令换不同品牌的固件时陌生指令可能导致行为不可预测。text-to-cad 的校验器正是针对这五类问题把人工逐行检查 G-code 的过程自动化了。一键运行 G-code 校验validate 命令完整流程整个工作流由 skills/gcode/scripts/gcode_tool.py 统一驱动切片前必须先完成前四步最后才进入校验发现切片后端python scripts/gcode_tool.py discover检查本机已安装的 OrcaSlicer、PrusaSlicer、CuraEngine推荐顺序见 references/slicer-backends.md检查输入网格inspect --input path/to/model.stl --json确认.stl、.obj、未切片的.3mf、.ply、.glb、.gltf可被切片Dry-run 预览slice ... --dry-run只打印将要执行的切片命令不实际运行——这是该技能先试跑、后执行的核心安全设计正式切片确认命令和配置无误后加--execute由真实切片器 CLI 生成.gcode静态校验python scripts/gcode_tool.py validate --gcode model.gcode --profile profile.json --json。注意校验需要一个包装配置文件wrapper profile JSON里面写明后端、原生切片器配置路径、机器运动边界和线材温度完整示例见 skills/gcode/SKILL.md 的 Profile Contract 一节。这份配置既用于切片也作为校验时判断什么算越界的依据。整个流程只生成本地文件不上传、不接触打印机。6 项自动检查逐项详解什么算错误什么只是警告校验逻辑全部实现在 gcode_tool.py 的validate_gcode_file函数中。它逐行解析 G-code把;后的注释剥掉统计命令并归入errors硬错误或warnings警告两个列表。最终ok: true当且仅当没有任何硬错误。检查一空文件检测——最基本的生死线整个 G-code 文件若没有任何有效内容全空或只有注释行直接报G-code file is empty。这能拦住建表失败、导出中断等产生的空壳文件避免打印机加载后空转。检查二移动命令检查——必须会动文件中至少要有G0/G1/G2/G3移动命令之一否则报No G0/G1/G2/G3 movement commands found。一份连移动都没有的打印程序说明切片根本没产出有效路径。检查三挤出动作检查——必须出料统计带E参数推进量的G1挤出移动。数量为 0 时校验失败打印机跑完全程却不挤出等于白跑。检查四温度指令检查——喷嘴和热床必须热起来必须出现喷嘴或热床升温指令M104/M109喷嘴、M140/M190热床任一即可。温度指令缺失意味着切片器可能没有正确写入起步序列直接上机会造成冷挤或堵头。检查五XYZ 坐标边界检查——绝不让打印头撞床这是 6 项检查里最有工程含量的一项。校验器会解析每条移动指令中的绝对 X/Y/Z 坐标与配置文件中定义的运动范围比较越界即报错如Line 123: X185.2 is outside X motion range 0.0..180.0 mm。三个值得注意的细节边界来自配置文件默认 X、Y 范围是0..bed_size_mmZ 是0..z_height_mm绝对/相对定位感知校验器以绝对定位G90为初始状态遇到G91切到相对定位后暂停边界检查回到G90后恢复。这避免了对相对位移块误报策略说明见 references/gcode-validation.md越界范围可显式放宽如果打印机的起步/收尾 G-code 故意在打印区外做擦拭、清料wiping/purge可以在配置里用machine.motion_bounds_mm给出显式范围——官方明确要求这个值来自真实打印机配置而不是用来消音未知指令SKILL.md。检查六未知命令警告——留痕但不擅改校验器内置约 30 个常见命令白名单G0–G4、G21、G28、G29、G90/G91/G92、M18–M221、M400、M900等清单见 gcode_tool.py。遇到白名单外的命令只记录警告并列出示例行号绝不删除或改写任何指令——警告是请你人工看一眼的信号尤其在把 G-code 交给不熟悉固件的打印机之前。如何读懂校验输出ok、errors 与 warnings 三级信号带--json运行时输出包含三类信息字段含义结果影响ok是否通过全部硬检查任何硬错误即为false命令以非 0 退出码结束errors硬错误明细如空文件、越界坐标必须解决后才能交付打印warnings警告如相对定位、未知命令不阻断但建议人工复核stats里还有行数、移动命令数、挤出移动数、温度指令数等统计方便快速判断文件有没有内容。官方文档特别提醒ok: true只表示通过了静态检查不代表这份 G-code 在真机上绝对安全gcode-validation.md。校验通过后仍建议人工复核这 5 件事打印机与配置文件是否匹配、线材和温度设置、起步/收尾 G-code、热床原点与坐标系、以及所有未知命令警告。总结text-to-cad 把打印前检查做成了自动化环节把 6 项检查放回整个工作流看text-to-cad 的 G-code 技能skills/gcode/SKILL.md体现了一致的设计取向先 dry-run 后执行——切片命令永远先预览再运行静态检查不越权——校验器明确不做挤出物理模拟、不模拟固件状态gcode-validation.md只做它能确定的检查警告不静默——未知命令只标记、不改写把判断权留给人边界数据来自真实配置——越界判断依据来自打印机配置文件不凭空假设。如果你想动手验证完整步骤就是discover找后端 →inspect查网格 →slice --dry-run预览 →slice --execute切片 →validate跑完 6 项自动检查。更多技能CAD 建模、Bambu Lab 打印交接等见项目根目录 README.md。【免费下载链接】text-to-cadA library of agent skills for CAD, CAE and CAM项目地址: https://gitcode.com/GitHub_Trending/tex/text-to-cad创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考