[AI 3D 生成流程]
输入（图像/文本）
    ↓
AI 生成模型
    ↓
┌─────────────────┐
│   视觉就绪      │ ✅ 大部分工具都能做到
│  (Visual Ready) │
└─────────────────┘
    ↓ ⚠️ 断层
┌─────────────────┐
│   物理就绪      │ ❌ 极少工具能做到
│(Physics Ready)  │
└─────────────────┘
    ↓
实际应用（游戏/VR/AR）
      ↑
   "最后一公里"

[能力雷达图]
        视觉质量
           │
           ⭐⭐⭐⭐⭐
           │
  几何 ─────┼───── 材质
  ⭐⭐⭐⭐   │   ⭐⭐⭐⭐
           │
  拓扑 ─────┼───── 结构
  ⭐⭐⭐     │   ⭐⭐
           │
  碰撞 ─────┴───── 重心
  ⭐☆☆☆☆     ⭐☆☆☆☆

[视觉 vs 物理 对比]
模型：一个精美的宝箱

视觉视角：
┌─────────────┐
│  ▓▓▓▓▓▓▓▓▓ │  ← 精美的金属纹理
│ ▓  宝箱   ▓ │  ← 复杂的雕刻细节
│  ▓▓▓▓▓▓▓▓▓ │
└─────────────┘
"看起来太棒了！"

物理视角：
┌─────────────┐
│  ? ? ? ? ?  │  ← 内部结构未知
│ ? ? ? ? ? ? │  ← 碰撞体缺失
│  ? ? ? ? ?  │  ← 重心未计算
└─────────────┘
"如何与它交互？"

[代价链]
AI 工具忽略物理
    ↓
开发者花时间修复
    ↓
抵消了 AI 的时间节省
    ↓
项目效率下降
    ↓
用户满意度降低

[结构问题示例]
椅子模型
    │
    ├─ 细长的椅腿（直径 1cm）
    │   └─ 问题：无法支撑人体重量
    │
    ├─ 精细的靠背雕刻
    │   └─ 问题：脆弱连接，容易折断
    │
    └─ 复杂的扶手设计
        └─ 问题：重心不稳，容易侧翻

// 在 Unity 中手工添加结构支撑
public class AddStructuralSupport : MonoBehaviour
{
    void AddInvisibleSupports()
    {
        // 方法 1：添加不可见的支撑碰撞体
        GameObject support = new GameObject("Support");
        support.transform.parent = transform;
        support.transform.localPosition = new Vector3(0, 0.25f, 0);

        BoxCollider supportCollider = support.AddComponent<BoxCollider>();
        supportCollider.size = new Vector3(0.5f, 0.5f, 0.5f);

        // 问题：这是"作弊"，不是真正的结构修复
    }
}

[碰撞体问题案例]
AI 生成的门模型

视觉：精美的中世纪木门
    ├─ 精美的雕刻
    ├─ 金属门把手
    └─ 铰链细节

物理：
    ❌ 无碰撞体
    结果：角色直接穿门而过

    或：
    ⚠️ 门框有碰撞体，但门板没有
    结果：角色能走到门框处，但无法"打开"门

[重心错误示例]
AI 生成的花瓶模型

正确的重心（在瓶身底部中心）：
      ●───┐
     ╱     │
    │  🏺  │
     ╲     │
      └────┘
       ↑
      重心 ✓
    （稳定，不容易倾倒）

AI 生成的重心（在几何中心）：
      ●───┐
     ╱  ↑  │
    │ 🏺 │ │
     ╲  │  │
      └─┴──┘
       ↑
      重心 ✗
    （不稳定，容易倾倒）

// 手工调整重心位置
public class AdjustCenterOfMass : MonoBehaviour
{
    void Start()
    {
        Rigidbody rb = GetComponent<Rigidbody>();

        // 方法 1：使用实验法
        // 通过反复测试找到稳定的重心位置
        rb.centerOfMass = new Vector3(0, 0.1f, 0); // 需要多次尝试

        // 方法 2：使用近似计算
        // 假设均匀密度，使用包围盒中心
        // 问题：对于不规则物体或空心物体不准确
    }
}

[非流形边示例]
正常的边（流形）：
    │
    A
   ╱ ╲
  B   C
   ╲ ╱
    D
（连接两个面：ABC 和 ACD）

非流形的边：
    │
    A
   ╱│╲
  B │ C
   ╱│╲
    D
（连接三个面：ABC、ACD、ABD）
    ↑
 物理引擎无法正确处理

[世界中的 3D 模型]
3D 模型
    ├─ 视觉表现（别人看到的）
    │   ├─ 几何形状
    │   ├─ 纹理材质
    │   └─ 渲染效果
    │
    └─ 物理属性（交互的基础）  ← Marble 专注于此
        ├─ 结构完整性
        ├─ 碰撞边界
        ├─ 重心位置
        └─ 物理行为

有结构完整性：
    ├─ 不会无缘无故坍塌
    ├─ 能够承受合理的物理应力
    ├─ 细长部分足够稳固
    └─ 复杂结构自支撑

无结构完整性：
    ├─ 轻微触碰就解体
    ├─ 细长部分容易折断
    ├─ 复杂结构需要额外支撑
    └─ 无法用于物理模拟

有空间一致性：
    ├─ 任何视角下都稳定
    ├─ 旋转后不会变形
    ├─ 缩放后保持特征
    └─ 任何场景中表现一致

无空间一致性：
    ├─ 某些角度出现异常
    ├─ 旋转后形状扭曲
    ├─ 缩放后细节丢失
    └─ 不同场景表现不同

开箱即用：
    ├─ 下载后直接导入
    ├─ 无需手工调整碰撞体
    ├─ 无需计算重心
    ├─ 无需修复拓扑
    └─ 立即可用于游戏

非开箱即用：
    ├─ 需要手工添加碰撞体（30-60 分钟）
    ├─ 需要调整重心（10-20 分钟）
    ├─ 需要修复拓扑（15-30 分钟）
    └─ 需要测试和迭代（20-40 分钟）

[空间一致性引擎架构]
                    ┌─────────────────┐
                    │   输入模块       │
                    │ (图像/文本)      │
                    └────────┬─────────┘
                             │
                    ┌────────▼─────────┐
                    │  双引擎合成层     │
                    │ ┌─────┬─────────┐ │
                    │ │Trellis│Hunyuan│ │
                    │ └──┬───┴────┬───┘ │
                    │    └───┬────┘     │
                    └─────────┼─────────┘
                              │
              ┌───────────────┼───────────────┐
              │               │               │
    ┌─────────▼──────┐ ┌─────▼─────┐ ┌─────▼──────┐
    │  几何验证模块   │ │拓扑验证模块│ │物理验证模块│
    │ ├─ 边界对齐    │ │ ├─ 流形性  │ │ ├─ 质量分布│
    │ ├─ 缝隙检测    │ │ ├─ 封闭性  │ │ ├─ 重心计算│
    │ └─ 重叠检测    │ │ └─ 连通性  │ │ └─ 稳定性  │
    └───────┬────────┘ └─────┬─────┘ └─────┬─────┘
            │                 │               │
            └─────────────┬───┴───────────────┘
                          │
                ┌─────────▼─────────┐
                │   修正与优化层     │
                │ ├─ 自动修复        │
                │ ├─ 碰撞体生成      │
                │ └─ 物理属性设置    │
                └─────────┬─────────┘
                          │
                ┌─────────▼─────────┐
                │   质量评分模块     │
                │ └─ Marble 评分     │
                └─────────┬─────────┘
                          │
                ┌─────────▼─────────┐
                │   输出模块         │
                │ └─ GLB/GLTF 导出  │
                └───────────────────┘

[双引擎协同工作]
输入：宝箱图像
    │
    ├─────────────┬─────────────┐
    │             │             │
 Trellis        Hunyuan3D
(Adobe Research) (Tencent)
    │             │
    ├─ 结构专家   ├─ 纹理专家
    ├─ 拓扑优异   ├─ 细节丰富
    ├─ 稳定性好   ├─ 视觉逼真
    │             │
    └──────┬──────┘
           │
    [空间合成算法]
           │
    ┌──────▼──────┐
    │ 最终输出    │
    │ ├─ 结构稳固 │
    │ ├─ 纹理精美 │
    │ └─ 物理就绪 │
    └─────────────┘

[几何验证流程]
输入模型
    ↓
边界对齐验证
    ├─ 检测相邻面的高度差
    ├─ 识别不连续的边缘
    └─ 验证表面平滑度
    ↓
缝隙检测
    ├─ 识别微小的空隙
    ├─ 检测不必要的重叠
    └─ 计算最佳边界位置
    ↓
自相交检测
    ├─ 射线投射检测
    ├─ 面与面相交验证
    └─ 标记问题区域
    ↓
自动修复
    ├─ 填充缝隙
    ├─ 消除重叠
    └─ 分离相交面

[拓扑验证流程]
流形性检查
    ├─ 验证每条边连接两个面
    ├─ 检测非流形几何
    └─ 修复非流形结构
    ↓
封闭性验证
    ├─ 检测孔洞和裂缝
    ├─ 验证网格完整性
    └─ 填充必要开口
    ↓
连通性分析
    ├─ 检查孤立顶点
    ├─ 验证边连接
    └─ 清理无用元素

[物理验证流程]
体积与质量分析
    ├─ 计算模型体积
    ├─ 估算质量分布
    └─ 识别密度异常
    ↓
重心计算
    ├─ 离散化体积单元
    ├─ 计算质量贡献
    ├─ 确定加权平均位置
    └─ 针对特殊情况调整
    ↓
稳定性预测
    ├─ 分析重心位置
    ├─ 评估支撑底面积
    ├─ 预测倾倒风险
    └─ 生成稳定性报告

[Marble GLB 文件结构]
├── 渲染网格
│   ├── 顶点数据
│   ├── 三角面索引
│   └── 纹理坐标
├── 纹理贴图
│   ├── 颜色贴图
│   ├── 法线贴图
│   └── 粗糙度贴图
├── 碰撞体 ✅
│   ├── 优化的碰撞网格
│   └── 碰撞体元数据
├── 物理属性 ✅
│   ├── 重心位置
│   ├── 质量估算
│   └── 物理材质参数
└── Marble 评分 ✅
    └── 质量评分报告

{
  "Marble": {
    "version": "1.0",
    "model_id": "marble_12345",
    "physics_ready": true,
    "collider": {
      "type": "mesh",
      "optimized": true,
      "convex": false
    },
    "rigidbody": {
      "mass": 1.0,
      "centerOfMass": [0.0, 0.5, 0.0],
      "useGravity": true
    },
    "marble_score": 87
  }
}

Marble 评分 = 结构完整性 × 30% + 几何一致性 × 30% + 物理就绪度 × 40%

其中：
结构完整性 = 拓扑质量 × 50% + 稳固性 × 50%
几何一致性 = 空间持久性 × 50% + 变换稳定性 × 50%
物理就绪度 = 碰撞体质量 × 40% + 重心准确性 × 30% + 物理参数 × 30%

[评分价值链]
高 Marble 评分
    ↓
开发者有信心使用
    ↓
减少测试和验证时间
    ↓
加快项目进度
    ↓
提高最终产品质量

[传统工具输出]
生成时间：2 分钟
输出文件：chest.obj

视觉评估：⭐⭐⭐⭐⭐
    └─ 精美的几何形状
    └─ 华丽的金属纹理
    └─ 复杂的雕刻细节

物理就绪评估：⭐☆☆☆☆
    ├─ 碰撞体：❌ 无
    ├─ 重心：❌ 未计算
    ├─ 拓扑：⚠️ 可能有缺陷
    └─ 结构：⚠️ 可能不稳定

后期处理需求：
    ├─ 添加碰撞体：30 分钟
    ├─ 计算重心：10 分钟
    ├─ 检查拓扑：15 分钟
    ├─ 测试稳定性：20 分钟
    └─ 总计：75 分钟

[Marble 输出]
生成时间：3 分钟
输出文件：chest_marble.glb

视觉评估：⭐⭐⭐⭐⭐
    └─ 精美的几何形状
    └─ 华丽的金属纹理
    └─ 复杂的雕刻细节

物理就绪评估：⭐⭐⭐⭐☆
    ├─ 碰撞体：✅ 自动生成优化碰撞体
    ├─ 重心：✅ 精确计算
    ├─ 拓扑：✅ 流形网格验证通过
    └─ 结构：✅ 稳定性预测良好

Marble 评分：87/100
    ├─ 结构完整性：85/100
    ├─ 几何一致性：90/100
    └─ 物理就绪度：86/100

后期处理需求：
    └─ 无需额外处理，直接导入使用

// Unity 导入传统 AI 生成的模型
GameObject chest = new GameObject("Chest");

// 1. 导入模型
// 需要手动拖入 OBJ 文件

// 2. 添加 Mesh Renderer（自动）
MeshRenderer renderer = chest.AddComponent<MeshRenderer>();
// 视觉效果：✅ 精美

// 3. 添加碰撞体（需要手工）
MeshCollider collider = chest.AddComponent<MeshCollider>();
collider.convex = true;
// 问题：可能过于复杂，性能差

// 4. 添加 Rigidbody
Rigidbody rb = chest.AddComponent<Rigidbody>();
rb.mass = 5f;
// 问题：重心未计算，宝箱可能倾倒

// 5. 测试
// 结果：宝箱在地板上翻滚，无法稳定放置

// 6. 修复（需要额外时间）
// - 调整重心
// - 优化碰撞体
// - 添加支撑结构

// Unity 导入 Marble 生成的模型
GameObject chest = new GameObject("Chest_Marble");

// 1. 导入模型（含物理属性）
// 拖入 Marble GLB 文件

// 2. 应用 Marble 预设（一键）
MarblePrefab.Apply(chest);

// 3. 自动配置完成
// - 碰撞体：✅ 优化过的 Mesh Collider
// - 重心：✅ 精确位置
// - 质量：✅ 合理估算

// 4. 测试
// 结果：宝箱稳定放置，物理表现自然

// 5. 无需修复

// Unreal 导入传统 AI 生成的模型
ATraditionalChest* Chest = GetWorld()->SpawnActor<ATraditionalChest>();

// 1. 导入模型
// 需要手动导入 FBX/OBJ

// 2. 创建碰撞体
UBoxComponent* Collider = CreateDefaultSubobject<UBoxComponent>(TEXT("Collider"));
// 问题：Box Collider 不够精确

// 3. 配置物理
UPrimitiveComponent* RootComponent = GetRootComponent();
RootComponent->SetEnableGravity(true);
// 问题：重心未设置

// 4. 测试
// 结果：物理表现不理想

// Unreal 导入 Marble 生成的模型
AMarbleChest* Chest = GetWorld()->SpawnActor<AMarbleChest>();

// 1. 导入模型（含物理属性）
// Marble GLB 文件自动识别

// 2. 应用 Marble 设置
// 碰撞体、重心、质量自动配置

// 3. 测试
// 结果：完美物理表现