Bambu CLI

概述

使用 bambu-cli 通过 MQTT/FTPS/摄像头 来配置、监控和控制 BambuLab 打印机，生成精确的命令和安全的默认设置。

默认设置与安全性

• 确认目标打印机（配置文件或 IP/序列号）并确定优先级顺序：命令行标志 > 环境变量 > 项目配置 > 用户配置。
• 避免在命令行标志中输入访问码；请仅使用--access-code-file或--access-code-stdin。
• 对于破坏性操作（停止打印、删除文件、发送 G 代码、校准、重启）需要确认；仅当用户明确同意时才使用--force/--confirm。
• 在支持的情况下，提供--dry-run选项以预览操作。
• 选择输出格式：默认为人类可读格式，使用--json以获得结构化输出。用于键值对输出。快速开始

配置一个配置文件：

• bambu-cli config set --printer <名称> --ip <IP地址> --serial <序列号> --access-code-file <路径> --default状态：
• bambu-cli status监视：
• bambu-cli watch --interval 5开始打印：
• bambu-cli print start <文件.3mf|文件.gcode> --plate 1暂停/恢复/停止：
• bambu-cli print pause|resume|stop相机快照：
• bambu-cli camera snapshot --out snapshot.jpg任务指南

设置与配置

使用

• config set/list/get/remove来管理配置文件。在脚本中使用环境变量以避免使用标志：
• BAMBU_PROFILE,,BAMBU_IP,BAMBU_SERIAL,BAMBU_ACCESS_CODE_FILE,BAMBU_TIMEOUT,BAMBU_NO_CAMERA,BAMBU_MQTT_PORT,BAMBU_FTP_PORT,BAMBU_CAMERA_PORT.
• 注意配置文件位置：用户~/.config/bambu/config.json，项目./.bambu.json.

监控

• 使用status进行一次性快照查看；使用watch进行定期更新--interval,--refresh).
• 使用--json/--plain用于脚本编写。

打印

• 使用print start <文件>配合.3mf或.gcode文件。
• 使用--plate <n|路径>来选择3mf文件内的板号或gcode路径。
• 使用--no-upload仅当文件已存在于打印机上时；不要将其与.gcode输入文件一起使用。
• 控制AMS：--no-ams,--ams-mapping "0,1",--skip-objects "1,3".
• 如需，请使用--flow-calibration=false来禁用流量校准。

文件和相机

• 使用files list [--dir <路径>],files upload <本地路径> [--as <远程路径>].
• 使用files download <远程路径> --out <路径|->; 使用--force以允许将二进制数据写入TTY。
• 仅在确认后使用files delete <远程路径>.
• 使用camera snapshot --out <路径|->; 使用--force允许标准输出到TTY。

运动、温度、风扇、灯光

• 使用home,move z --height <0-256>.
• 使用temps get|set(--bed,--nozzle,--chamber; 至少需要一个)。
• 使用fans set配合--part/--aux/--chamber值0-255或0-1.
• 使用开灯|关灯|状态.

G代码和校准

• 使用gcode send <行内容...>或gcode send --stdin（需确认；--no-check可跳过验证）。
• 避免将--access-code-stdin与gcode send --stdin结合使用；请改用访问代码文件。
• 在需要时，使用calibrate并配合--no-bed-level、--no-motor-noise、--no-vibration参数。

故障排除

• 使用检查到MQTT/FTPS/摄像头端口的TCP连接；若摄像头端口无法访问，建议使用--no-camera假设默认端口：除非另有配置，MQTT为8883，FTPS为990，摄像头为6000。参考
• 阅读

references/commands.md

以获取完整的命令和标志参考。references/commands.mdfor the full command and flag reference.