3D Guard - 3D模型审计技能

概述

本技能用于系统化地审计3D模型文件，确保其在使用前符合版权、内容安全、技术规格等要求。支持常见3D模型格式（STL、OBJ、3MF等），并可通过多模态视觉模型和文本分析进行综合检查。

快速开始

基本审计流程：

1. 文件完整性检查 → 2. 元数据快速分析 → 3. 尺寸验证 → 4. 深度检查（如需要） → 5. 生成审计报告

优化策略：优先元数据分析

• 元数据（Title、Description、Author等）通常能快速判断合规性
• 如果元数据明确显示不合规 → 直接得出结论，无需进一步分析
• 如果元数据模糊不清或可疑 → 才进行图像分析等深度检查
• 这样可以大幅提高审计效率，减少不必要的API调用

核心审计任务

1. 文件完整性检查

目标： 验证3D模型文件的完整性和格式有效性

检查项：

• 文件是否能正常解析（不损坏、不截断）
• 文件格式符合标准（STL二进制/ASCII、OBJ、3MF等）
• 几何数据完整性（顶点、面片、法线等）
• 纹理和材质文件是否存在（如OBJ文件引用的纹理）

工具：

• 使用 scripts/validate_3d_model.py 进行自动验证
• 手动检查文件头部和结构

常见问题：

• 文件损坏或截断 → 需要重新下载或修复
• 缺少关联文件（纹理、材质） → 需要获取完整文件包
• 格式不规范 → 可能需要转换或修复

2. 尺寸验证

目标： 确保模型尺寸适合目标3D打印机

检查流程：

1. 解析模型边界框（bounding box）
2. 计算X、Y、Z三个维度的最大尺寸
3. 与目标打印机规格对比

常见打印机规格参考：

超出范围处理：

• 稍微超出（\x3C10%）→ 可考虑缩放或分割
• 严重超出（>50%）→ 需要大尺寸打印机或完全重新设计
• 可旋转打印 → 检查长边是否能放入构建平台

3. 版权侵权检测

目标： 识别模型是否包含可能侵犯版权的内容

检测范围：

• 知名IP角色： 迪士尼、漫威、星球大战、任天堂、宝可梦等
• 潮玩品牌IP： POP MART（泡泡玛特）- Molly、Dimoo、Skullpanda、Labubu等
• 品牌标志： Nike、Adidas、Apple、Tesla等知名品牌
• 受保护的设计： 商业产品、艺术作品、游戏道具等

检测方法（优先级从高到低）：

第一优先级：元数据快速分析 ⚡️

# 检查模型元数据中的文本信息
# Title、Description、Author、License等字段

检查内容：

• Title字段： 是否直接包含IP名称（如"米老鼠"、"马里奥"）
• Description字段： 是否明确描述版权内容
• License字段： 是否有明确的授权声明
• Author信息： 是否为原创作者

判断规则：

• ✅ 元数据明确显示IP侵权 → 直接判定高风险，无需进一步分析
• ❓ 元数据模糊或可疑 → 进行第二级检查
• ✅ 元数据显示原创 → 进入风险等级评估
• 🔴 元数据不完整 → 如果Title、Description、License三项全部为空，直接判定为不合规

合规性验证（重要）：

必须满足的条件：
✅ Title字段不为空
✅ Description字段不为空  
✅ License字段不为空

如果不满足以上条件：
🔴 直接判定为“元数据不完整-不合规”
停止进一步分析，拒绝使用

第二优先级：文件名和路径分析 🔍

• 文件名是否包含版权名称（如 "mario", "mickey", "marvel", "molly", "dimoo", "popmart"）
• 文件路径是否暗示版权内容（如包含IP名称的文件夹）
• 是否包含潮玩品牌关键词（"molly", "labubu", "skullpanda", "pucky", "popmart"）

第三优先级：文档和描述检查 📄

• 模型是否附带说明文档
• 是否有授权声明或CC许可证信息
• 描述中是否引用版权内容

第四优先级：视觉分析（多模态模型） 🖼️ （仅在需要时）

# 对模型渲染图或截图进行视觉分析
# 仅在元数据模糊不清时使用

使用场景：

• 元数据过于通用（如"卡通角色"、"有趣的设计"）
• 元数据与文件名不一致
• 需要验证元数据的真实性
• 可疑的原创声明

重点关注的视觉特征：

• 特定的角色造型和标志性特征
• 品牌logo、标志、字体
• 商业产品的独特设计元素

潮玩品牌识别特征（以POP MART为例）：

• Q版比例： 头大身小，3:1到4:1的比例
• 眼睛设计： 特别大的眼睛（通常占面部1/2-1/3）
• 色彩风格： 梦幻、马卡龙、糖果色系
• 细节特征： 特定的发型、服装花纹、配饰
• 盲盒造型： 标志性的站立姿势，可爱表情

风险等级评估：

• 高风险： 明确是知名IP的复制品（如完整的任天堂角色）
• 中风险： 灵感来源于版权作品但有一定原创性
• 低风险： 通用设计、原创作品或明显在合理使用范围内

4. 政治敏感性分析

目标： 识别模型是否包含政治敏感、暴力或不当内容

检查类别：

• 政治人物、符号、标志
• 政治标语、口号
• 极端主义或仇恨相关符号
• 武器、军事装备（特别是现实主义武器）
• 不当、暴力或恐怖主题

检测方法（优先级从高到低）：

第一优先级：元数据快速分析 ⚡️

# 检查模型元数据中的文本信息
# Title、Description、Author、DesignRegion等字段

检查内容：

• Title字段： 是否直接包含政治人物名称
• Description字段： 是否明确描述政治相关内容
• DesignRegion/Author： 判断来源和背景

判断规则：

• ✅ 元数据明确显示政治敏感内容 → 直接判定高风险，无需进一步分析
• ❓ 元数据模糊不清 → 进行第二级检查
• ✅ 元数据显示非政治内容 → 进入风险评估

第二优先级：文件名和路径分析 🔍

• 文件名是否包含政治人物名称或敏感词
• 文件路径是否暗示敏感内容

第三优先级：视觉分析 🖼️ （仅在需要时）

# 对模型渲染图或截图进行视觉分析
# 仅在元数据模糊不清时使用

使用场景：

• 元数据过于通用（如"人物头像"、"雕像"）
• 元数据与文件名不一致
• 需要验证元数据的真实性

第四优先级：上下文评估 📊

• 结合模型用途判断合理性
• 考虑设计时间和背景
• 评估作者和来源可信度

合理例外：

• 教育用途的通用历史模型
• 艺术表达（需谨慎评估）
• 个人非政治用途

5. 审计报告生成

报告结构（优化版）：

# 3D模型审计报告

## 基本信息
- 模型文件：[文件名]
- 文件格式：[STL/OBJ/3MF]
- 文件大小：[大小]
- 审计时间：[时间戳]

## 审计结果

### 1. 文件完整性 ✅/❌
[结果详情]

### 2. 元数据分析 ⚡️ 快速检查

**首先验证元数据合规性：**
- **Title状态：** [存在/缺失]
- **Description状态：** [存在/缺失]
- **License状态：** [存在/缺失]
- **合规性：** [合规/不合规-元数据缺失]

**如果不合规（元数据缺失）：**
- **风险等级：** 🔴 高风险
- **结论：** 直接拒绝使用，无需进一步分析
- **理由：** 缺少必须的元数据字段
- **建议：** 要求模型提供者补充完整的元数据，或拒绝使用

**如果合规：继续分析**
- **Title：** [元数据内容]
- **Description：** [元数据内容]
- **License：** [许可证信息]
- **判断：** [明确/模糊/原创]

### 3. 尺寸验证 ✅/❌
- 模型尺寸：[X×Y×Z mm]
- 目标打印机：[打印机型号]
- 构建体积：[体积]
- 结论：[是否符合]

### 4. 元数据合规性检查 🔴
- **Title状态：** [存在/缺失]
- **Description状态：** [存在/缺失]
- **License状态：** [存在/缺失]
- **合规性：** [合规/不合规-元数据缺失]

**如果不合规（元数据缺失）：**
- **风险等级：** 🔴 高风险
- **理由：** 缺少必须的元数据（Title、Description、License）
- **建议：** 要求模型提供者补充完整的元数据，或拒绝使用

### 5. 版权检测 ⚠️
- 风险等级：[高/中/低]
- 检测到的内容：[具体描述]
- 检测依据：[元数据/视觉分析/两者结合]
- 建议：[使用建议]

### 6. 政治敏感性 ✅/⚠️
- 检测结果：[内容描述]
- 风险评估：[低/中/高]
- 检测依据：[元数据/视觉分析/两者结合]

## 总体建议
[综合建议和使用限制]

工作流程

完整审计流程

graph TD
    A[接收3D模型] --> B[文件完整性检查]
    B -->|文件有效| C[尺寸验证]
    B -->|文件损坏| D[报告问题并停止]
    C -->|尺寸合规| E[版权检测]
    C -->|尺寸超限| F[标记需缩放/分割]
    E --> G[政治敏感性分析]
    F --> G
    G --> H[生成审计报告]

条件决策树

何时需要进行完整审计？

• 准备公开发布3D模型
• 计划商业化使用模型
• 模型来源不明或不可信
• 组织内部有合规要求

何时可以简化审计？

• 自己创建的原创模型
• 已知可信来源的模型
• 个人非商业使用

使用场景示例

场景1：元数据不合规（新增）

用户："检查这个3D模型的合规性"
→ 运行元数据验证：validate_metadata.py
→ 发现：缺少Title、Description、License
→ 结论：元数据不合规，直接拒绝
→ 建议：要求补充元数据或拒绝使用
→ 无需进行后续的版权/政治敏感性分析

场景2：社区分享前的审计

用户："我刚设计了一个3D模型，想在社区分享，帮我检查一下"
→ 运行完整审计流程
→ 首先验证元数据合规性
→ 通过后检查版权和政治敏感性
→ 生成详细报告供用户参考

场景3：生产前的尺寸验证

用户："这个STL文件能用我的Ender 3打印吗？"
→ 简化审计：重点检查尺寸
→ 与220×220×250mm构建体积对比
→ 直接给出是否可打印的结论

场景4：版权风险评估

用户："这个模型看起来有点像任天堂的角色，能用吗？"
→ 优先检查元数据（Title、Description）
→ 如果元数据模糊 → 使用多模态模型分析视觉相似度
→ 提供风险等级和法律建议

场景5：元数据明确的情况

用户："检查这个模型的合规性"
→ 发现元数据 Title: "米老鼠米奇"
→ 结论：明确版权侵权，无需进一步分析
→ 直接给出风险评级和建议

场景6：元数据模糊的情况

用户："这个卡通模型有问题吗？"
→ 元数据 Title: "有趣的卡通角色"
→ 元数据不够明确，需要视觉分析
→ 使用多模态模型判断是否是知名IP
→ 综合评估风险

参考资源

scripts/

validate_metadata.py - 元数据合规性验证脚本 ⭐ 新增

• 验证3MF文件的元数据完整性
• 检查必须字段：Title、Description、License
• 提取所有可用的元数据字段

使用方法：

python3 scripts/validate_metadata.py /path/to/model.3mf

输出：

{
  "format": "3MF",
  "metadata": {
    "title": "模型名称",
    "description": "模型描述",
    "license": "许可证类型",
    "author": "作者"
  },
  "compliance": {
    "is_compliant": true/false,
    "required_fields": {
      "title": {"exists": true/false, "value": "..."},
      "description": {"exists": true/false, "value": "..."},
      "license": {"exists": true/false, "value": "..."}
    },
    "missing_fields": ["Title", "Description", "License"],
    "reason": "缺少必须的元数据字段"
  }
}

合规性规则：

• ✅ 合规： Title、Description、License三个字段全部存在且非空
• 🔴 不合规： 任意一个或多个字段缺失或为空

validate_3d_model.py - 3D模型验证脚本

• 自动验证文件完整性
• 解析模型尺寸
• 提取基本元数据（STL/OBJ）

使用方法：

python3 scripts/validate_3d_model.py /path/to/model.stl

输出：

{
  "valid": true,
  "format": "STL",
  "size": {"x": 150.5, "y": 120.3, "z": 80.2},
  "vertices": 12580,
  "faces": 25160
}

references/

printer-specs.md - 常见3D打印机规格参考

• 主流打印机构建体积
• 技术参数对比
• 适用场景说明

copyright-guidelines.md - 版权检查指南

• 主要IP列表和特征
• 检查要点和方法
• 合理使用原则

sensitive-content.md - 敏感内容识别参考

• 政治敏感内容分类
• 常见符号和标志
• 评估标准

注意事项

1. 法律免责声明： 本技能提供的审计仅供参考，不能替代专业法律意见
2. 元数据优先原则： 优先使用元数据进行快速判断，节省资源和时间
3. 误判可能性： AI检测可能存在误判，需要人工复核高风险项目
4. 模型隐私： 审计过程中不要泄露用户模型文件或敏感信息
5. 持续更新： 版权和敏感性标准会变化，需要定期更新参考数据

优化说明（重要）

为什么优先元数据分析？

• ✅ 速度快：文本分析比图像分析快得多
• ✅ 准确性高：作者在元数据中通常会诚实地标注内容
• ✅ 成本低：减少不必要的API调用和计算资源
• ✅ 效率高：对于明确违规的模型，可以立即得出结论

元数据合规性验证（新增）：

• 🔴 强制要求：3MF文件必须包含Title、Description、License三个字段
• 🚫 不合规即拒绝：缺少任意一个字段，直接判定为不合规
• ✅ 快速筛选：可以在第一时间淘汰不合格的模型
• ⚡ 提升效率：避免对不合格模型进行不必要的深度分析

什么时候跳过元数据检查？

• STL/OBJ格式（不支持内嵌元数据）
• 元数据字段缺失或损坏（已判定为不合规）
• 需要验证元数据的真实性（怀疑被修改）

元数据不可靠的情况：

• 恶意修改元数据来隐藏真实内容
• 下载的模型元数据被篡改
• 不完整的元数据（已判定为不合规）

最佳实践

1. 先元数据后深度检查： 优先使用元数据分析快速判断，只在必要时进行深度检查
2. 明确说明检测依据： 在报告中清楚说明是基于元数据还是视觉分析
3. 保留审计记录： 对重要模型保留审计报告和时间戳
4. 上下文很重要： 结合模型用途和场景评估风险
5. 透明沟通： 向用户清楚说明审计结果的不确定性
6. 效率优先： 当元数据已明确时，不要进行不必要的图像分析