用途:bambu-cli 用于配置、监控和控制 BambuLab 打印机,通过 MQTT/FTPS/摄像头通信,提供精确命令与安全默认值。
主要能力:状态快照与周期监控(status、watch);打印控制(print start/pause/resume/stop);文件列表、上传、下载、删除;摄像头快照;运动与温度、风扇、灯光控制;gcode 发送;校准;AMS 映射与跳过对象;doctor 连通性排查。
使用方式:先配置 profile,例如 bambu-cli config set --printer <name> --ip <ip> --serial <serial> --access-code-file <path> --default。常用命令包括 bambu-cli status、bambu-cli watch --interval 5、bambu-cli print start <file.3mf|file.gcode> --plate 1、bambu-cli camera snapshot --out snapshot.jpg。可用环境变量 BAMBU_PROFILE、BAMBU_IP、BAMBU_SERIAL、BAMBU_ACCESS_CODE_FILE、BAMBU_TIMEOUT、BAMBU_NO_CAMERA、BAMBU_MQTT_PORT、BAMBU_FTP_PORT、BAMBU_CAMERA_PORT。配置优先级为 flags > env > 项目配置 > 用户配置,用户配置位于 ~/.config/bambu/config.json,项目配置为 ./.bambu.json。输出可选 human、--json、--plain。
限制与安全:避免在 flags 中直接写访问码,应使用 --access-code-file 或 --access-code-stdin;破坏性操作(停止打印、删除文件、发送 gcode、校准、重启)需确认,仅在用户明确同意时使用 --force/--confirm;支持时可用 --dry-run 预览。--no-upload 仅用于文件已存在于打印机时,且不可与 .gcode 输入同用。默认端口为 MQTT 8883、FTPS 990、摄像头 6000。完整命令与 flag 参考见 references/commands.md。