名称： bambu-cli
描述： 使用 bambu-cli 操作和排查 BambuLab 打印机问题（状态/监控、打印开始/暂停/恢复/停止、文件、摄像头、G代码、AMS、校准、运动、风扇、灯光、配置、诊断）。当用户请求控制或监控 BambuLab 打印机、设置配置文件或访问码，或将任务转换为安全的 bambu-cli 命令（包含正确的标志、输出格式和确认步骤）时使用。

Bambu CLI

概述

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

默认值与安全性

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

快速开始

• 配置配置文件：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 文件内的 G 代码路径。
• 仅当文件已存在于打印机上时使用 --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 的 stdout。

运动、温度、风扇、灯光

• 使用 home、move z --height <0-256>。
• 使用 temps get|set（--bed、--nozzle、--chamber；至少需要一个）。
• 使用 fans set，--part/--aux/--chamber 值范围为 0-255 或 0-1。
• 使用 light on|off|status。

G 代码与校准

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

故障排除

• 使用 doctor 检查到 MQTT/FTPS/摄像头端口的 TCP 连接性；如果摄像头端口无法访问，建议使用 --no-camera。
• 除非已配置，否则假设默认端口：MQTT 8883、FTPS 990、摄像头 6000。

参考

完整命令和标志参考请阅读 references/commands.md。