核心用法
bambu-cli 是一款面向 BambuLab 系列 3D 打印机的专业命令行管理工具，通过 MQTT 协议实现实时监控，配合 FTPS 完成文件传输，并支持摄像头快照功能。主要使用场景涵盖：
- 配置管理：通过
config set建立打印机档案，支持多配置文件切换，环境变量与项目级配置优先覆盖 - 状态监控：
status单次查询或watch持续轮询，输出格式可选 human/json/plain 适配不同下游处理 - 打印控制：完整生命周期管理——start/pause/resume/stop，支持 .3mf/.gcode 双格式，内置 AMS 映射与跳过大对象功能
- 高级操作：G-code 直接注入、温度/风扇/灯光调节、自动校准流程、运动控制（Z 轴升降）
- 故障诊断：
doctor命令检测 MQTT/FTPS/摄像头三端口连通性
显著优点
1. 协议原生：直接对接 BambuLab 私有 MQTT 实现，响应延迟低，状态同步实时
2. 安全设计优先：强制要求确认的高危操作（停止打印、删除文件、G-code 发送、设备重启），支持 --dry-run 预演
3. 凭证管理规范：禁止命令行明文传 access code，强制使用文件或 stdin 方式，降低历史记录泄露风险
4. 脚本友好：结构化输出（--json/--plain）、完整环境变量覆盖、配置文件分层加载，适合 CI/CD 集成
5. AMS 深度集成：支持料盘映射、流量校准开关、大对象跳过，覆盖复杂多色打印场景
潜在缺点与局限性
- 硬件绑定：仅支持 BambuLab 品牌设备，无法通用于其他厂商打印机
- 网络依赖：必须处于同一局域网或具备 MQTT 端口可达性，无云端代理能力
- G-code 风险：
gcode send可执行任意机器指令，虽需确认但误操作仍可能导致热端碰撞或设备损坏 - 摄像头局限：仅支持快照（snapshot），无实时视频流功能；6000 端口可能因防火墙被阻断
- 配置复杂度：多层级配置优先级（flags > env > project > user）对新手不够直观
适合人群
- 拥有 BambuLab X1/X1C/P1P/P1S/A1/A1 mini 等机型的进阶用户
- 需要批量管理多台打印机的工作坊或小型工作室
- 追求自动化工作流、希望集成到 Home Assistant/Nagios 等监控体系的极客用户
- 熟悉命令行操作、理解 MQTT/FTPS 基础概念的技术人员
常规风险
| 风险类别 | 具体表现 | 缓解措施 |
|---------|---------|---------|
| 凭证泄露 | access code 写入 shell 历史或日志 | 强制使用 `--access-code-file`，审计配置文件权限 |
| 误操作破坏 | gcode send 发送危险指令、stop 中断长时间打印 | 双重确认机制，生产环境启用 `--dry-run` |
| 网络暴露 | MQTT 8883/FTPS 990 端口对外开放 | 限制打印机仅内网可达，启用 VLAN 隔离 |
| 固件兼容性 | 新版固件可能变更 MQTT topic 结构 | 关注版本更新日志，升级前在 staging 环境验证 |
| 热端烫伤/火灾 | 远程温控失效导致过热 | 保持打印机固件自动保护功能开启，避免禁用热失控保护 |