MetaFusion/Plan.md

Maya插件开发计划

1. 项目目标与功能梳理

• 支持MetaHuman同拓扑或自定义3D模型的绑定、DNA编辑、骨骼校准、DNA保存/加载、FBX导出、BlendShape编辑等。
• 兼容Maya 2022-2025，Python 3.10-3.12，UTF-8编码。
• UI采用Qt（参考scripts/Qt.py），样式统一在scripts/ui/style.qss。
• 参考Epic官方MetaHuman DNA Calibration工具及相关文档，吸收SuperRigging等插件的设计思路。

2. 主要模块划分

1. 配置与主控
   • config.py（配置文件）
   • scripts/Main.py（主入口）
   • scripts/ReloadModules.py（模块热重载）
2. UI层
   • scripts/ui/（所有UI模块，含主界面、子工具面板）
   • scripts/ui/Qt.py（Qt封装）
   • scripts/ui/style.qss（统一样式）
3. 功能实现
   • DNA文件处理（加载/保存/编辑）
   • 绑定与骨骼校准
   • BlendShape与控制器映射
   • FBX导出
   • 兼容MetaHuman DNA标准
4. 工具与通用模块
   • scripts/utils/（通用工具函数）

3. 阶段性开发计划

第一阶段：基础框架与UI

• 搭建插件基础结构，主入口、配置加载
• 主界面UI搭建（参考UI图与.qss风格）
• 完善主界面各功能区分栏（模型、绑定、调整、定义）
  • 优化 main_window.py，确保Tab加载各Panel，统一风格和注释
  • 完善 model_editor_panel.py（模型编辑面板）
  • 完善 dna_browser_panel.py（DNA浏览面板）
  • 创建 joint_calibration_panel.py（骨骼校准面板）
  • 创建 blendshape_edit_panel.py（混合变形编辑面板）
  • 完善 animation_system_panel.py（动画系统面板）

第二阶段：核心功能开发

• DNA文件读写与MetaHuman兼容
• 绑定流程实现（支持MetaHuman与自定义模型）
• 骨骼校准与自动分组
• BlendShape与控制器映射
• FBX导出与DNA文件导出

第三阶段：高级功能与优化

• 批量处理与自动化工具
• 多LOD支持与切换
• 配置与模板管理
• 插件性能与兼容性优化

第四阶段：文档与测试

• 全流程测试脚本
• 用户操作手册与开发文档完善
• 参考文档和代码持续同步

---

进度记录与后续安排

2025-04-30 更新

• 完成了基础框架与UI阶段的全部任务（第一阶段 100%）
• 优化了主窗口与各功能面板的UI结构，确保风格统一
• 创建了所有必要的面板类，包括：
  • ModelEditorPanel（模型编辑面板）
  • DNABrowserPanel（DNA浏览面板）
  • JointCalibrationPanel（骨骼校准面板）
  • BlendshapeEditPanel（混合变形编辑面板）
  • AnimationSystemPanel（动画系统面板）

下一步开发计划（第二阶段）

1. DNA文件读写与MetaHuman兼容

   • 实现DNA文件的读取、解析与保存功能
   • 确保与MetaHuman DNA标准兼容
   • 完善DNAManager类，提供DNA文件操作API

2. 绑定流程实现

   • 支持MetaHuman同拓扑模型的自动绑定
   • 支持自定义模型的绑定流程
   • 实现骨骼映射与权重传递

3. 骨骼校准与自动分组

   • 完善JointCalibrationPanel的功能实现
   • 实现骨骼自动分组算法
   • 支持骨骼位置、旋转的微调与校准

4. BlendShape与控制器映射

   • 完善BlendshapeEditPanel的功能实现
   • 实现BlendShape的创建、编辑与管理
   • 支持控制器与BlendShape的映射关系设置

5. FBX导出与DNA文件导出

   • 实现模型与骨骼的FBX导出
   • 支持DNA文件的导出与版本控制
   • 确保导出文件与MetaHuman兼容

• 每完成一个功能模块，及时更新开发计划文档与进度百分比。
• 代码变更后，自动检查代码规范、插件完整性，并给出下一步开发建议。

---

如需调整开发优先级或补充特定功能，请随时告知！