Always respond in 中文，

先阅读知识库，并按照 Readme.md 来查看文件路径以及参考品文档和参考代码来协助用户完成项目

MetaFusion 开发文档

一 本地知识库导航

1 文档

Reference\docs\Metahuman解析.pdf Reference\docs\SuperRiggingEditor使用文档.pdf Reference\DNA_Calibration\docs\dna_api.md Reference\DNA_Calibration\docs\dna_viewer_api_build_meshes.md Reference\DNA_Calibration\docs\dna_viewer_api_build_rig.md Reference\DNA_Calibration\docs\dna_viewer_API.md Reference\DNA_Calibration\docs\dna_viewer_maya.md Reference\DNA_Calibration\docs\dna_viewer.md Reference\DNA_Calibration\docs\dna.md Reference\DNA_Calibration\docs\dnacalib_api.md Reference\DNA_Calibration\docs\dnacalib.md Reference\DNA_Calibration\docs\faq.md Reference\DNA_Calibration\docs\repository_organization.md DNA_Calibration在线文档: https://epicgames.github.io/MetaHuman-DNA-Calibration

2 代码参考

Reference\DNA_Calibration Reference\MSLiveLink Reference\SuperRiggingEditor Reference\Utils

3 UI参考图片

Reference\UI

二 项目描述

1 目标

做一个Maya的Metahuman自定义的插件，语言:基于Python，Maya版本:2022, 2023, 2024, 2025

项目描述

• 本项目是一个Maya插件，主要功能是提供与MetaHuman相同拓扑的模型或者自定义的3d模型以来完成自定义绑定，编辑DNA，校准骨骼位置，保存DNA，载入DNA，导出fbx，保存DNA文件, 编辑BlendShape,等功能。

2 主要功能

• 提供与MetaHuman相同拓扑的模型或者自定义的3d模型以来完成自定义绑定，编辑DNA，校准骨骼位置，保存DNA，载入DNA，导出fbx，保存DNA文件, 编辑BlendShape,等功能。

3 注意Reference路径不参与参见功能实现，只作为参考。Reference只作为参考，可以从中拷贝必要的文件到当前项目中

4 代码规范

• 所有代码必须使用UTF-8编码
• 所有模块开头必须添加 ：

#!/usr/bin/env python
# -*- coding: utf-8 -*-

• 代码必须考虑兼容 Maya2022, Maya2023, Maya2024, Maya2025
• 代码必须考虑兼容 Python3.10, Python3.11, Python3.12
• 所有模型引用关系自动更新修正
• UI样式必须统一的一个样式文件来实现
• 所有UI必须使用Qt来实现
• 所有Pyside代码必须使用 widget, layout, connection 的结构来实现
• 文件夹结构尽量以目前的代码结构来触发实现，各个模块各功能给要条理清晰
• 使用config.py文件来统一实现配置文件
• 使用style.qss文件来实现UI样式
• 功能函数放在utils文件夹中

5 文件基本结构 （参考）, 以""结尾的行为文件夹

• 参考MetaFusion 文件基本结构

MetaFusion 文件基本结构

├── assets\
│   ├── dna\                          DNA文件路径
│   ├── img\                          DNA图标路径
│   ├── maya\                         Maya资源文件路径
│   ├── MH.2\                         MetaHuman 2.0文件路径
│   ├── MH.4\                         MetaHuman 4.0文件路径
├── icons\                            插件图标路径
├── plugins\
│   └── Linux\
│   │   ├── 2022\
│   │   ├── 2023\
│   │   ├── 2024\
│   │   ├── 2025\
│   │   ├── pydna\
│   │   │   ├── python3\
│   │   │   ├── python311\
│   │   │   ├── python397\
│   │   │   ├── python3108\
│   └── Windows\
│   │   ├── 2022\
│   │   ├── 2023\
│   │   ├── 2024\
│   │   ├── 2025\
│   │   ├── pydna\
│   │   │   ├── python3\
│   │   │   ├── python311\
│   │   │   ├── python397\
│   │   │   ├── python3108\
├── Reference\                       参考模块（不引用，仅供参考）
│   ├── DNA_Calibration              参考模块：DNA_Calibration
│   ├── MSLiveLink                   参考模块：MSLiveLink
│   ├── SuperRiggingEditor           参考模块：SuperRiggingEditor
├── scripts\
│   ├── builder\
│   │   ├── maya\
│   │   │   ├── __init__.py
│   │   │   ├── mesh.py
│   │   │   ├── skin_weights.py
│   │   │   ├── util.py
│   │   ├── __init__.py
│   │   ├── builder.py
│   │   ├── config.py
│   │   ├── joint.py
│   │   ├── mesh.py
│   │   ├── rig_builder.py
│   ├── dnacalib\
│   │   ├── CMakeModulesExtra\
│   │   ├── DNACalib\
│   │   ├── PyDNA\
│   │   ├── PyDNACalib\
│   │   ├── SPyUS\
│   │   ├── CMakeLists.txt
│   ├── dnalib\
│   │   ├── __init__.py
│   │   ├── behavior.py
│   │   ├── definition.py
│   │   ├── descriptor.py
│   │   ├── dnalib.py
│   │   ├── geometry.py
│   │   ├── layer.py
│   ├── ui\
│   │   ├── __init__.py
│   │   ├── style.qss                   UI样式文件
│   │   ├── menu.py                     UI菜单UI文件
│   │   ├── toolshelf.py                UI工具架UI文件
│   │   ├── meshes.py                   UI模型UI文件
│   │   ├── rigging.py                  UI绑定UI文件
│   │   ├── behaviour.py                UI行为UI文件
│   │   ├── definition.py               UI定义UI文件
│   ├── utils\                          功能模块路径
│   │   ├── __init__.py
│   │   ├── ...                         
│   ├── MetaFusion.py                   插件主文件
│   ├── config.py                       配置文件                   
├── Install.mel                         拖入maya安装文件
├── Install.py                          安装执行文件
├── CleanPycache.bat                    清除pycache文件（不修改）
├── README.md                           开发文档

6 UI界面风格

• 扁平化设计风格，
• 要有高级感和科幻未来感
• 圆角设计
• 中文要清晰大气
• 英文要简洁明了
• 颜色要统一
• 字体要统一
• 字体大小要统一
• 按钮要统一
• 输入框要统一
• 标签要统一

7 UI界面

UI参考图片： Reference\UI\01_Menu_File.jpg Reference\UI\02_Menu_Edit.jpg Reference\UI\03_Menu_Tools.jpg Reference\UI\04_Language.jpg Reference\UI\05_Menu_Help.jpg Reference\UI\06_Tool_Shelf.jpg Reference\UI\07_Meshes_LOD0.jpg Reference\UI\08_Meshes_LOD1.jpg Reference\UI\09_Meshes_LOD2.jpg Reference\UI\10_Meshes_LOD3.jpg Reference\UI\11_Meshes_LOD4.jpg Reference\UI\12_Meshes_LOD5.jpg Reference\UI\13_Meshes_LOD6.jpg Reference\UI\14_Meshes_LOD7.jpg Reference\UI\15_Rigging.jpg Reference\UI\16_Behaviour.jpg Reference\UI\17_Definitions.jpg

MetaFusion UI 结构

一、菜单栏

1. 文件菜单 (File)

• 打开 DNA | icons\open.png
• 保存 DNA | icons\save.png
• 加载当前项目 DNA | icons\open.png
• 修改混合目标名称 | icons\rename.png
• 重置混合目标名称 | icons\resetname.png
• 导出 FBX | icons\export.png
• 退出 | icons\exit.png

2. 编辑菜单 (Edit)

• 创建 RL4 节点 | icons\connect.png
• 删除 RL4 节点 | icons\disconnect.png
• 镜像左至右 | icons\mirrorL.png
• 镜像右至左 | icons\mirrorR.png
• 姿势由 A 型转 T 型 | icons\pose_A_To_T.png
• 姿势由 T 型转 A 型 | icons\pose_T_To_A.png
• 传输 LOD 贴图 | icons\locator.png
• 设置关节颜色 | icons\color.png
• 取消全部标记 | icons\unmark_all.png
• 重建所有目标 | icons\rebuildTargets.png
• 为所有表情设置关键帧 | icons\bakeAnimation.png
• 烘焙所有表情的关键帧 | icons\centerCurrentTime.png

3. 工具菜单 (Tools)

• 导出蒙皮 | icons\export_skin.png
• 导入蒙皮 | icons\import_skin.png
• 拷贝装皮 | icons\copy_skin.png
• RBF变形器 | icons\blendShape.png
• 快速绑定服装 | icons\clothing_weight.png
• 克隆混合变形 | icons\blendShape.png
• UV传递点序 | icons\repair_vertex_order.png
• 面部生成控制器 | icons\controller.png
• 提取52BS | icons\ARKit52.png
• 关节轴向修复 | icons\joint.png
• 生成身体控制器 | icons\create_body_ctrl.png
• 导入面部动画 | icons\import_face_anim.png
• 导入身体动画 | icons\import_body_anim.png

4. 语言菜单 (Language)

• 中文 | icons\chinese.png
• English | icons\english.png

5. 帮助菜单 (Help)

• 检查更新 | icons\update.png
• 帮助文档 | icons\help.png
• 关于 | icons\about.png

二、工具架 横向排列

• 保存 DNA | icons\save.png
• 加载当前项目 DNA | icons\open.png
• 分隔符 separator
• 创建RL4节点 | icons\connect.png
• 删除RL4节点 | icons\disconnect.png
• 分隔符 separator
• 导出 蒙皮 | icons\export_skin.png
• 导入 蒙皮 | icons\import_skin.png
• 复制 蒙皮 | icons\copy_skin.png
• 分隔符 separator
• 帮助文档 | icons\help.png
• 关于 | icons\about.png

三、主界面功能区

1. 模型视图 (Meshes)

####### LOD选项卡 (LOD0-LOD7)

每个LOD包含以下模型项：

• LOD0: ["*头部", "*牙齿", "*牙龈", "*左眼", "*右眼", "*虹膜", "*睫毛", "*眼睑", "*软骨", "*身体"]
• LOD1: ["头部", "牙齿", "牙龈", "左眼", "右眼", "虹膜", "睫毛", "眼睑", "软骨", "身体"]
• LOD2: ["头部", "牙齿", "牙龈", "左眼", "右眼", "虹膜", "睫毛", "眼睑", "身体"]
• LOD3: ["头部", "牙齿", "左眼", "右眼", "虹膜", "睫毛", "眼睑", "身体"]
• LOD4: ["头部", "牙齿", "左眼", "右眼", "虹膜"]
• LOD5: ["头部", "牙齿", "左眼", "右眼"]
• LOD6: ["头部", "牙齿", "左眼", "右眼"]
• LOD7: ["头部", "牙齿", "左眼", "右眼"]

####### 功能按钮 （是在LOD0-LOD7中的底部）

自动加载模型（icons\load_meshes.png）；标准化命名（icons\standardize_name.png）；自动分组（icons\auto_group.png）；

####### 工具栏功能

第一行：拓扑结构（下拉框,默认：MetaHuman）；选择LOD（下拉框，默认：LOD0，LOD1~LOD7）；创建LOD（icons\create_lod.png）；

第二行：模型分离（icons\separate.png）；生成面部配件（icons\face_accessory.png）；

第三行：修复法线（icons\fix_normal.png）；修复点序（icons\fix_vertex_order.png）；

第四行：修复接缝（icons\fix_seam.png）；

2. 绑定视图 (Rigging)

####### 预设

• DNA浏览器
• 图标缩放滑条; - 导入/导出设置按钮

####### 资产

• 项目路径: 输入框; 加载按钮
• 预设文件: 输入框; 加载按钮
• 数据分层: 下拉框（默认：行为（包括基础定义））; - 勾选框（勾选）：覆盖表情

####### 描述

• 名称：输入框（默认：Archetype）; - 变换单位：下拉框（默认：厘米）
• 原型：下拉框（默认：亚洲人）； - 旋转单位：下拉框（默认：角度）
• 性别：下拉框（默认：女性）； - 向上轴标：下拉框（默认：Z轴向上）
• 年龄：数值调节（默认：24）； - LOD计数：数值调节（默认：8）

####### 功能按钮

• 清空选项（icons\delete.png）； - 导入骨架（icons\HIKCharacterToolSkeleton.png）； - 创建骨架（icons\HIKcreateControlRig.png）；

3. 行为视图 (Behaviour)

####### Raw Control [000/000] （在行为视图的左侧）

• 搜索过滤
• BlendShape列表
• 恢复表情按钮；- 混合筛选按钮
• 全部按钮，2按钮，3按钮，4按钮，5按钮，6按钮
• 范围控制（0.010），滑块，勾选框（未勾选）, 文字"全部"
• 范围+按钮，范围-按钮

####### Related Blend Shapes [000/000] （在行为视图的右侧）

• 关联BlendShape列表
• 范围控制（0.000），滑块，勾选框（未勾选）, 文字"全部"
• 翻转目标 - 镜像目标 - 查找翻转目标
• 添加混合目标 - 删除混合目标 - 批量混合目标
• 重建混合目标 - 重建所有混合目标
• 范围控制（0.010），滑块，勾选框（未勾选）, 文字"全部"
• 范围+按钮，范围-按钮

####### 功能按钮

• 第一行 ：PSD - BSE - KEY - MIR - ARK - CTR
• 第二行 ：范围控制（0.000），滑块，"+"按钮, 勾选框（未勾选）, 文字"全部"
• 第三行 按钮：还原默认表情；查找选择表情；写入当前表情
• 第四行 按钮：控制面板查找；选择关联关节；写入镜像表情

4. 定义视图 (Definition)

####### LODs列表

• LOD 0-7
• Define Joint For LOD

####### Meshes [010/54]

• head_lod0_mesh (000)
• teeth_lod0_mesh (001)
• saliva_lod0_mesh (002)
• eyeLeft_lod0_mesh (003)
• eyeRight_lod0_mesh (004)
• eyeshell_lod0_mesh (005)
• eyelashes_lod0_mesh (006)
• eyeEdge_lod0_mesh (007)
• Create Geometry 按钮

####### Joints [840/870]

• FACIAL_C_NeckB Group: 001

• FACIAL_L_NeckB1 Group: 002

• FACIAL_R_NeckB1 Group: 003

• FACIAL_L_NeckB2 Group: 002

• FACIAL_R_NeckB2 Group: 003

• FACIAL_C12PV_NeckB1 Group: 001

####### Blend Shapes [782/782]

• brow_down_L 000

• brow_down_R 001

• brow_lateral_L 002

• brow_lateral_R 003

• brow_raiseIn_L 004

• brow_raiseIn_R 005

####### AnimatedMap [082/82]

• head_cm2_color.head_wm2.browsDown 000

• head_cm2_color.head_wm2.browsDown 001

• head_cm2_color.head_wm2.browsLate 002

• head_cm2_color.head_wm2.browsLate 003

• head_cm1_color.head_wm1.browsRais 004

• head_cm1_color.head_wm1.browsRais 005

####### 操作区域

• Write：
  • Write Neutral Pose Joint Position
  • Write Geometry
  • Write Skin Weights
  • Write Blend Shapes Targets
• Create：
  • Create Blend Shapes For Mesh
  • Bind Skin For Mesh
  • Unbind Skin For Mesh
• Tools：
  • New Neutral Joint Transform
  • Quickly Create Presets