企业官网建设流程全解析

text-to-cad新打印机接入指南：5步完成Bambu A1 Mini本地打印配置

【免费下载链接】text-to-cadA library of agent skills for CAD, CAE and CAM项目地址: https://gitcode.com/GitHub_Trending/tex/text-to-cad

如果你刚入手 Bambu A1 Mini，想用 text-to-cad 把它接入本地打印工作流，这篇文章带你 5 步完成配置。text-to-cad 是一个面向 CAD、CAE、CAM 的 Agent 技能库，其中 Bambu Labs 技能 专门负责把校验通过的.gcode通过局域网 FTPS/MQTT 安全地交给 Bambu 打印机本地打印。整个过程默认"干跑"（dry-run），真正触发动作需要显式加参数，新手也能放心操作。

这套方案适合谁？

• 想把 A1 Mini 纳入 AI Agent 自动化流程（建模 → 切片 → 打印一条龙）的用户
• 希望在局域网内完成打印交接、不依赖云端的玩家
• 第一次配置新打印机、想按步骤安全上手的初学者

💡 核心原则：默认干跑，显式执行。任何上传、启动打印的操作，都必须加上--execute等确认参数，避免误触打印机。

开始前的准备工作

第1步：生成并校验 .gcode 文件

打印交接的前提是一份"干净"的普通.gcode。text-to-cad 的 G-code 技能会调用真实的切片器（OrcaSlicer / PrusaSlicer / CuraEngine）完成切片：

python scripts/gcode_tool.py discover # 发现本机可用的切片器 python scripts/gcode_tool.py slice ... --dry-run # 先干跑，确认命令无误 python scripts/gcode_tool.py validate ... # 校验生成的 G-code

如果本机没有切片器，安装 OrcaSlicer 即可（macOS 可用brew install --cask orcaslicer），不要把"缺切片器"当成阻塞。切片器的后端细节可查阅 slicer-backends.md。

✅本步完成标志：手里有一份校验通过的.gcode，随时可以交给打印机。

第2步：在打印机触摸屏上获取 IP 和访问码

A1 Mini 的触摸屏步骤（来自 new-printer-onboarding.md）：

1. 打开设置→网络 / WLAN
2. 连接与电脑相同的可信局域网
3. 开启"仅 LAN"（Enable LAN Only）
4. 开启"开发者模式"（Enable Developer Mode）—— 这两项是本地启动的硬性前提，缺一项都可能失败
5. 记录屏幕上显示的IPv4 地址
6. 记录LAN 访问码（若全为 0，可关闭再打开"仅 LAN"重新生成）
7. 修改上述网络设置后，重启打印机

📌 注意：打印机的序列号不需要手动填写，后续命令会自动从打印机的 TLS 证书中读取并缓存。

第3步：用 config set 写入打印机配置

把 IP 和访问码写入工作区根目录的bambu-printers.json（本地配置文件，建议加入 Git 忽略），避免每次命令都重复粘贴访问码：

python scripts/bambu_lan_print.py config set \ --printer a1-mini \ --host 192.168.1.34 \ --access-code 12345678 \ --model a1-mini \ --fetch-serial

配置后的 JSON 结构一目了然：

{ "printers": { "a1-mini": { "host": "192.168.1.34", "access_code": "12345678", "model": "a1-mini" } } }

第4步：运行 status 验证连通性

配置完成后，先读一次打印机状态，确认局域网通信正常：

python scripts/bambu_lan_print.py status \ --printer a1-mini \ --push-all \ --wait-seconds 10

用大白话检查结果：能否连通？打印机处于 空闲/打印中/报错 哪种状态？SD 卡/存储是否可用？有没有print_error或 HMS 错误码？

常见故障与处理：

• 连不上→ 核对 IP、确认同网段、确认打印机未休眠
• MQTT 状态失败但证书读取成功→ 优先确认开发者模式已开启，然后重启打印机再试
• 访问码被拒绝或全零→ 在打印机上刷新访问码，重跑config set --fetch-serial
• 出现旧的 FAILED 报错→ 先解决物理原因，重启后用clear-error --execute清理

第5步：干跑 → 上传 → 启动打印

A1 Mini 经过验证的本地启动路径是--handoff template-project（用一份已知可用的同款打印机.gcode.3mf模板打包），推荐按"首次实跑顺序"逐步推进：

1. 先不带--execute跑一遍send，检查干跑计划（JSON 载荷）
2. --action upload --execute只上传不启动，确认上传成功
3. 再干跑一次--action upload-start计划
4. 确认无误后，真正启动打印：

python scripts/bambu_lan_print.py send \ --printer a1-mini \ --gcode /tmp/job.gcode \ --handoff template-project \ --template-project /path/to/same-printer-template.gcode.3mf \ --action upload-start \ --execute \ --confirm-start-print

⚠️ 启动前做一遍物理检查（详见 real-printer-checklist.md）：打印板已安装且干净、耗材已装载且匹配、喷嘴/热床类型正确、操作员在旁观察首层。

常见问题速查

更多协议层细节（FTPS 990 端口、MQTT 8883 端口、主题结构）可参考 local-lan-protocol.md。

小结

• 第1步：用 G-code 技能 切片并校验，产出干净的.gcode
• 第2步：触摸屏开启"仅 LAN + 开发者模式"，记下 IP 和访问码，重启打印机
• 第3步：config set --fetch-serial一次性写入本地配置
• 第4步：status --push-all验证连通与健康状态
• 第5步：干跑 → 只上传 → 加--execute --confirm-start-print启动

配置完成只代表局域网连通且状态正常；每次正式打印仍建议走一遍干跑计划和物理检查清单。祝打印顺利！🎉

【免费下载链接】text-to-cadA library of agent skills for CAD, CAE and CAM项目地址: https://gitcode.com/GitHub_Trending/tex/text-to-cad