介绍
# Bambu CLI
## 概述 使用 bambu-cli 通过 MQTT/FTPS/摄像头 配置、监控和控制 BambuLab 打印机，生成精确的命令并提供安全的默认设置。
## 默认设置与安全 - 确认目标打印机（配置文件或 IP/序列号）并解析优先级：标志位 > 环境变量 > 项目配置 > 用户配置。 - 避免在标志位中使用访问码；仅使用 `--access-code-file` 或 `--access-code-stdin`。 - 对破坏性操作（停止打印、删除文件、发送 gcode、校准、重启）要求确认；仅当用户明确同意时才使用 `--force`/`--confirm`。 - 支持时提供 `--dry-run` 以预览操作。 - 选择输出格式：默认为 human（人类可读），`--json` 用于结构化输出，`--plain` 用于 key=value 输出。
## 快速开始 - 配置配置文件：`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 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 <file>` 处理 `.3mf` 或 `.gcode` 文件。 - 使用 `--plate <n|path>` 选择 3mf 内的热床编号或 gcode 路径。 - 仅当打印机上已存在该文件时才使用 `--no-upload`；请勿将其与 `.gcode` 输入配合使用。 - 控制 AMS：`--no-ams`、`--ams-mapping "0,1"`、`--skip-objects "1,3"`。 - 如果需要，使用 `--flow-calibration=false` 禁用流量校准。
### 文件与摄像头 - 使用 `files list [--dir <path>]`、`files upload <local> [--as <remote>]`。 - 使用 `files download <remote> --out <path|->`；使用 `--force` 允许将二进制数据写入 TTY。 - 仅在确认的情况下使用 `files delete <remote>`。 - 使用 `camera snapshot --out <path|->`；使用 `--force` 允许将输出重定向到 TTY。
### 运动、温度、风扇、灯光 - 使用 `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`。
### Gcode 与校准 - 使用 `gcode send <line...>` 或 `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` 以获取完整的命令和标志位参考。