--- name: bambu-x2d-slice version: 0.1.0 description: 使用本机 Bambu Studio 为 X2D 将独立 STL 切片并交付含 G-code 的 3mf,支持 PETG 主体与 PLA 支撑界面;用于排盘、材料映射、支撑和切片验证,不负责修改 CAD。 --- # X2D 切片交付 使用用户指定模型和材料。产出可打开的切片项目 `.3mf`,同时报告切片验证与实物验证的不同状态。生成文件不包含发送打印的授权。 ## 输入与环境 - 先读当前项目 HANDOFF,定位实际打印件。整机 STEP 可能含电子板包络,不直接作为打印件。用户说“单个零件”时按单件排查,不推断成整机一起打印。 - 确认机型、喷嘴直径、打印板、主料和界面料。保存的耗材预设不证明当前装料;颜色也不证明 AMS 槽位。沿用本会话已确认的选择,不重复询问。 - 使用已安装的 Bambu Studio 官方配置,记录版本。Mac 默认路径 `/Applications/BambuStudio.app/Contents/MacOS/BambuStudio`,配置在 `Contents/Resources/profiles/BBL/`。不存在时定位实际安装,不能换成近似机型。 - 保留用户未保存的 Studio 工程;CLI 使用独立临时目录和 `--datadir`。不读取或复制登录凭据、全量用户配置。 ## 生成 实际执行前读 [CLI 与双材料案例](references/x2d-cli.md)。递归解析选定官方配置的 `inherits` 和 `include`,先父配置再子配置覆盖;记录本轮覆盖参数。保留官方启停、换料 G-code。 检查各打印件方向、平面贴板与悬空支撑。以 STL 已验证方向为准时用 `--orient 0`,排盘可用 `--arrange 1`,切后再检查。不要为少支撑擅自改变几何。 双材料要明确主体、支撑树干、支撑界面分别用什么。界面零间距是具体材料配对的候选参数,不是通用值。喷嘴映射必须核对导出结果,不能只看输入配置。按当前喷嘴有效范围放置擦料塔。 ## 验证与交付 - 检查进程退出码及日志;崩溃、不可打印区域、缺层等失败不交付为已切片完成。不要修改机器边界或删除原厂 G-code 来掩盖报错。 - `.3mf` 是 ZIP:检查 CRC、项目机型/喷嘴/材料、预期零件数、实际板 G-code、层数、`outside`、支撑用量。仅有模型和配置的 3mf 不是已切片文件。 - 双料还查 `slice_info.config` 的 object/support 用料和实际 G-code。跟踪 `T0`/`T1`(可带参数)与 `; FEATURE:`,确认界面料未用于墙、填充或支撑树干;擦料塔可使用两种材料。未知工具选择语法要另行确认,不能把未识别当通过。 - **精密配合开窗/内槽做 G-code 坐标级禁支撑/禁裙边(Brim)核查。** 情形:打印件含电极开窗、沉板槽或卡扣滑槽,总耗材统计看不出支撑柱或 Brim 是否长进了配合窗内。规则:解压切片后 `.3mf` 的 `Metadata/plate_*.gcode`,按 `; FEATURE: Support*` 与 `; FEATURE: Skirt/Brim` 提取挤出线段 XY 坐标,与配合开窗包络求交断言侵入线段数为 `0`(配故意把窗口放进 Brim 区的反例)。证据:2026-11-14 量规片与外壳同盘切片直接扫 `plate_1.gcode` 确认配合窗内 `0` Support、`0` Brim(提交 `8c691c2c`)。置信:低(单次切片坐标验证,实物易拆度待打样确认)。 - 查看排盘预览;检查零件、支撑、擦料塔与两个喷嘴范围。模型缩略图通常不显示支撑,不能据此证明支撑路径正确。 - 输出带明确材料名称的 3mf、必要设置与验证记录。时间和重量标“估算”。机型元数据缺失、分析器日志、未实测条件要保留说明。 - 不宣称打印成功、易拆支撑或装配合格,直到有相应实物证据。保存项目内 evidence/HANDOFF,不修改 mstack。