核心功能
Bambu Studio AI 是一套面向 Bambu Lab 3D 打印机的全链路自动化工具集，实现从创意到成品的端到端工作流：
| 阶段 | 功能 |
|------|------|
| 信息收集 | 智能询问模型来源（搜索/生成）、尺寸、颜色、材料需求 |
| 模型获取 | 联网搜索（MakerWorld/Printables/Thingiverse/Thangs）或 AI 生成（Meshy/Tripo/Rodin 等 5 家服务商） |
| 智能处理 | 自动分析修复（11 项检测：壁厚、悬空、方向、流形等）、多色分割（≤8 色 AMS 优化）、高清预览渲染 |
| 切片确认 | 强制 Bambu Studio 可视化确认，用户自主切片检查 |
| 打印执行 | 手动/自动双模式，MQTT 直接控制或 BS 标准流程 |
| 实时监控 | 里程碑式进度推送（25%/50%/75%/完成）、异常检测自动暂停、实时摄像头快照 |
显著优点
- 严格合规设计：11 项强制检查点（MUST/NEVER/WAIT 规则），杜绝 AI 常见越权行为
- 多色智能处理：独创 HSV→CIELAB 色彩量化算法，自动匹配 Bambu 43 色耗材库
- 双模连接：LAN（推荐，本地 MQTT）与 Cloud 双支持，本地模式隐私优先
- 安全架构：零预置凭证、chmod 600 密钥存储、90 天令牌过期、X.509 签名命令
局限与风险
| 限制 | 说明 |
|------|------|
| 平台依赖 | Bambu Studio 集成、通知系统仅限 macOS；Linux/Windows 可运行核心脚本但缺失 GUI 工作流 |
| 自动打印门槛 | 需开启 Developer Mode，会导致 BS/Handy 完全断连云端 |
| AI 生成质量 | 3D 生成模型常有拓扑瑕疵，必须走 analyze→repair→preview 强制流程 |
| 硬件锁定 | 仅支持 Bambu Lab 9 款机型（A1 系列/P1 系列/X1 系列/H2 系列） |
适合人群
- 拥有 Bambu Lab 打印机、追求自动化效率的进阶用户
- 需要批量处理多色打印、希望减少手动切片调试时间的创作者
- 注重数据隐私、偏好本地 LAN 控制而非云服务的用户
常规风险
- 开发者模式风险：开启后丧失云端远程监控能力，需权衡便利与功能
- AI 模型可靠性：生成模型可能出现非流形几何、缺失面片，预览确认环节不可跳过
- 网络暴露：LAN 模式需打印机与运行设备同网，公网无防护
- 凭证管理：用户需妥善保管
.secrets.json（access code / 云密码 / 3D API key）