专业级 BambuLab 打印机命令行控制工具，支持 MQTT/FTPS 全功能操作，需严格遵循安全确认流程
说明：
## 核心用法
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 环境验证 |
| 热端烫伤/火灾 | 远程温控失效导致过热 | 保持打印机固件自动保护功能开启，避免禁用热失控保护 |
会员专属
