核心用法
Bambu Studio AI 是一套面向 Bambu Lab 3D打印机的完整自动化工作流工具，覆盖从模型获取到打印监控的全流程。其核心工作流为：信息收集 → 模型搜索/AI生成 → 分析修复 → 预览确认 → Bambu Studio 打开 → 用户切片确认 → 打印 → 监控。
主要功能模块：
- 模型获取：支持联网搜索（MakerWorld/Printables等）或AI文本/图像生成（Meshy/Tripo/Printpal等5家服务商）
- 智能分析：
analyze.py执行11项检查，包括壁厚、悬空、方向优化、自动修复等，输出可打印性评分 - 多色处理：
colorize.py将纹理GLB转换为顶点色OBJ，支持最多8色AMS配置，提供色彩量化与Bambu filament匹配 - 预览渲染：
preview.py生成旋转GIF或Blender HQ渲染，强制要求发送给用户确认 - 打印控制：LAN模式（MQTT本地控制，推荐）或Cloud模式，支持状态查询、启停、调速、灯光、AMS管理等
- 实时监控：MQTT订阅获取进度、温度、异常检测，自动拍照推送，支持故障自动暂停
关键约束（强制合规）：
- 必须询问"搜索还是生成"，默认优先搜索
- AI生成必须确认尺寸（如"80mm高"）
- 所有模型必须经过 analyze → preview → 用户确认 三步
- 禁止自动打印，必须等待用户明确"looks good"/"print it"
- 多色OBJ必须通过 File → New Project → Import 方式导入BS
显著优点
1. 全机型覆盖：支持A1 Mini至H2D全部9款Bambu Lab打印机，含最新H2系列
2. 双模式灵活：LAN模式（本地MQTT，功能完整）与Cloud模式（远程有限支持）可选
3. AI生成深度集成：5家3D生成服务商可选，自动prompt增强与尺寸限制
4. 多色工作流成熟：从纹理提取到AMS色图映射的完整pipeline，含可调参数（平滑度、岛屿过滤、颜色合并策略）
5. 安全设计突出：零预置凭证、.secrets.json chmod 600保护、90天token缓存、全gitignore隔离、显式用户确认每一步
6. 监控能力完整：RTSP摄像头快照、异常检测（堵料/翘边/ spaghetti）、自动暂停
潜在缺点与局限性
1. 平台限制：Bambu Studio集成（打开应用、通知）仅限macOS，Linux/Windows需手动运行Python脚本
2. 依赖较重：需Python3 + 12个pip包 + 可选Blender/OrcaSlicer，首次设置门槛较高
3. 多色导入不稳定：BS对顶点色OBJ的识别存在兼容性问题，可能需要多次尝试或手动修复
4. 自动打印风险：Developer Mode会断开BS/Handy连接，且AI生成模型可能有隐性几何错误
5. AI生成质量波动：不同服务商输出差异大，部分生成结果可能有非流形几何（报告68+"bodies"实为拓扑问题）
6. 网络依赖：3D生成、模型搜索、Cloud模式均需外部API，无离线AI生成能力
适合人群
- Bambu Lab打印机用户（尤其X1C/A1/H2D等多色机型）
- 希望简化工作流的设计师/创客：从"想打什么"到"开始打印"的自动化需求
- AI生成3D尝鲜者：想快速将概念转为可打印模型
- 多色打印爱好者：AMS配置复杂，需自动化色彩映射
- 技术型用户：能接受Python环境配置、理解MQTT/LAN模式差异
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 凭证泄露 | Bambu账户密码、LAN访问码、3D API密钥 | .secrets.json 600权限，gitignore隔离，无日志打印 |
| 误操作打印 | AI模型可能有隐形缺陷导致打印失败 | 强制preview+BS确认，禁止auto-print无确认 |
| 网络中间人 | MQTT/Cloud API通信 | 标准TLS，云模式需验证码，本地模式限同网络 |
| 3D服务商风险 | 外部API密钥泄露、服务中断 | 用户自选服务商，密钥本地存储，无代理转发 |
| 开发者模式风险 | 开启后BS/Handy完全断开，无远程监控 | 明确告知用户，模式选择持久化到config.json |
| 模型版权 | 搜索下载模型的授权归属 | 用户自行确认，工具仅提供搜索接口 |