mcpField
I
image-to-3d-pipeline

image-to-3d-pipeline

github.com/guia-matthieu创意与媒体150312 次安装4 周前更新
代码仓库

关于 image-to-3d-pipeline

image-to-3d-pipeline 是一项指导将 2D 图像转为 3D 模型并准备导出的技能,面向网页、游戏和营销资产制作。它涵盖工具选择、网格清理、Mixamo 角色绑定及 GLB/FBX 导出流程。

主要功能

  1. 01根据用途选择 3D 生成工具
  2. 02规划从源图到模型的转换流程
  3. 03提供网格与纹理优化检查项
  4. 04指导使用 Mixamo 为角色绑定
  5. 05按目标平台准备 GLB 或 FBX 导出

适用场景

  1. 01将角色设计转为带动画的 3D 角色
  2. 02把品牌吉祥物制作成网页 3D 资产
  3. 03从产品照片制作可旋转的 3D 展示
  4. 04为 Three.js 或 Unity 准备模型

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/guia-matthieu/clawfu-skills --skill image-to-3d-pipeline

安装后在 Claude Code 中输入/image-to-3d-pipeline确认已加载。

详细介绍

图像转 3D 流程

使用 Dilum Sanjaya 工作流(Hunyuan3D + Mixamo),在不到 30 分钟内将 2D 图像转换为可用于网页或游戏的动画 3D 模型。

何时使用此技能

  • 为网站创建 3D 角色 - 吉祥物、头像、交互式插画
  • 制作游戏资产原型 - 角色设计、道具、环境
  • 制作 3D 营销内容 - 旋转展示的产品、动画角色
  • 转换现有插画 - Logo、吉祥物、角色设计 → 3D
  • 快速测试创意 - 用 30 分钟而非数天制作 3D 原型

方法论基础

来源:Dilum Sanjaya (@DilumSanjaya) - 游戏角色流程(2025-2026)

核心原则:“2D 图像就是你的蓝图。Hunyuan3D 生成网格,Mixamo 自动添加骨架。只需 30 分钟,你就能获得可用于 Three.js 或 Unity 的动画角色。”

为何重要:传统上,从 2D 概念图到带骨架的 3D 模型需要数天建模工作。此工作流将时间缩短至不到一小时,同时产出的资产质量足以用于生产。

Claude 负责什么,你来决定什么

Claude 负责你来决定
组织视频工作流最终创意方向
提出镜头构图建议设备选择
创建分镜模板品牌美学
生成脚本框架最终审批
确定技术要求预算分配

此技能的功能

  1. 指导选择 3D 工具 - 根据使用场景选择 Hunyuan3D、Tripo 或 Meshy
  2. 构建完整工作流 - 从源图像到导出模型
  3. 优化生成的网格 - 减少多边形、修正纹理
  4. 自动化绑定 - 为角色配置 Mixamo
  5. 准备导出 - 根据目标平台选择 GLB/FBX 格式

使用方法

将角色设计转换为动画 3D 角色
J'ai cette image de personnage [joindre image]. Aide-moi à la convertir en modèle 3D animé avec le skill image-to-3d-pipeline.
创建旋转展示的 3D 产品
Je veux créer un modèle 3D de mon produit [description] à partir de photos. Guide-moi avec le pipeline image-to-3d.
制作品牌吉祥物原型
Voici le design de notre mascotte [image]. Je veux la transformer en 3D pour notre site web avec des animations idle.

说明

帮助将 2D 图像转换为 3D 时,请遵循以下流程:

第 1 步:评估源图像
## Analyse de l'Image Source

**Type d'image:**
[ ] Character design / Personnage
[ ] Objet / Produit
[ ] Illustration / Logo
[ ] Photo réelle

**Qualité pour conversion 3D:**
[ ] ✅ Vue frontale claire
[ ] ✅ Fond simple ou transparent
[ ] ✅ Couleurs/textures distinctes
[ ] ✅ Proportions cohérentes
[ ] ⚠️ Détails complexes (peut perdre en conversion)

**Complexité estimée:**
[ ] Simple - Forme géométrique basique
[ ] Moyenne - Personnage ou objet organique
[ ] Complexe - Détails fins, accessoires multiples

要点:

  • 正面视图效果更好
  • 透明或白色背景可简化处理
  • 四肢清晰分明的角色更容易绑定

第 2 步:选择转换工具
工具优势最适合局限性
Hunyuan3D纹理质量更好、开源角色、细节丰富的物体有时需要清理
Tripo AI用户体验简单、自动绑定快速原型可控性较低
Meshy擅长风格化效果卡通/低多边形资产纹理不够逼真
Rodin Gen-1速度快、拓扑适合游戏游戏资产保真度较低
CSM多视图一致性复杂物体速度较慢

按使用场景推荐:

  • 网页角色 → Hunyuan3D + Mixamo
  • 快速原型 → Tripo AI
  • 风格化游戏资产 → Meshy 或 Rodin
  • 逼真产品 → Hunyuan3D + 后期处理

第 3 步:转换流程
## Pipeline Standard (Hunyuan3D)

### A. Préparation de l'image
1. Supprimer le fond (remove.bg ou outil intégré)
2. Recadrer serré sur le sujet
3. Résolution recommandée: 1024x1024 minimum
4. Sauvegarder en PNG (préserver transparence)

### B. Génération 3D
1. Uploader sur Hunyuan3D (hunyuan3d.tencent.com)
2. Sélectionner mode: "Image to 3D"
3. Paramètres recommandés:
   - Quality: High
   - Texture: Enable
   - Multi-view: Enable (si disponible)
4. Générer et télécharger (GLB ou OBJ)

### C. Validation du mesh
- Ouvrir dans Blender ou viewer en ligne
- Vérifier: topology, textures, scale
- Identifier problèmes: trous, textures manquantes

第 4 步:优化和清理
## Checklist Optimisation

### Mesh
[ ] Poly count acceptable (< 50k pour web, < 100k pour jeu)
[ ] Pas de faces inversées
[ ] Pas de vertices orphelins
[ ] Mesh manifold (étanche)

### Textures
[ ] UV map correcte
[ ] Résolution appropriée (1024x1024 ou 2048x2048)
[ ] Pas de stretching visible
[ ] Couleurs fidèles à l'original

### Scale
[ ] Proportions correctes
[ ] Orientation (Y-up ou Z-up selon destination)
[ ] Centré sur origin

清理工具:

  • Blender(免费)- Decimate 修改器、纹理绘制
  • Meshlab(免费)- 自动修复
  • gltf-transform(CLI)- 优化适用于网页的 GLB

第 5 步:使用 Mixamo 绑定(仅适用于角色)
## Workflow Mixamo

1. Exporter le mesh en FBX (sans textures embarquées)
2. Uploader sur mixamo.com
3. Positionner les markers:
   - Chin
   - Wrists
   - Elbows
   - Knees
   - Groin
4. Sélectionner "Auto-Rig"
5. Choisir animations:
   - Idle (standing, breathing)
   - Walk
   - Run
   - Autres selon besoin
6. Télécharger en FBX avec skin

推荐的网页动画:

  • Idle - 基础动画
  • Walking - 用于移动
  • Waving - 互动
  • Talking - 适用于配音场景

步骤 6:导出与集成
目标平台格式备注
Three.js / WebGLB推荐格式,内嵌纹理
UnityFBX原生导入,配置材质
UnrealFBX需要重新绑定骨架
React Three FiberGLB使用 gltfjsx 创建组件
# Optimisation GLB pour web (gltf-transform)
npx @gltf-transform/cli optimize input.glb output.glb --compress draco

目标大小:

  • 3D 主视觉(首屏可见内容):< 2MB
  • 次要资产:< 500KB
  • 动画角色:< 5MB

示例

示例 1:游戏角色 - 角色选择界面

输入:角色概念图(卡通风格)

流程:

  1. Nano Banana → 生成风格一致的角色设定图
  2. Hunyuan3D → 转换为 3D 网格
  3. Blender → 快速清理(5 分钟)
  4. Mixamo → 自动绑定骨架 + 待机/选择动画
  5. Three.js → 集成悬停旋转效果

输出:带有 3 个动画的交互式 3D 角色 总耗时:约 45 分钟

基础 Three.js 代码:

import { useGLTF, useAnimations } from '@react-three/drei'

function Character({ url }) {
  const { scene, animations } = useGLTF(url)
  const { actions } = useAnimations(animations, scene)

  useEffect(() => {
    actions['idle']?.play()
  }, [])

  return <primitive object={scene} />
}

示例 2:落地页品牌吉祥物

输入:企业吉祥物 2D 插画

流程:

  1. 清理背景(remove.bg)
  2. Hunyuan3D → 生成带纹理的 3D 网格
  3. 无需骨骼绑定(静态)
  4. 导出优化后的 GLB
  5. Spline 或 Three.js → 简单 CSS/JS 动画(旋转、弹跳)

输出:主视觉区域中的旋转 3D 吉祥物 总耗时:约 20 分钟


示例 3:360° 电商产品展示

输入:4 张产品照片(正面、背面、侧面)

流程:

  1. CSM → 多视角重建(更适合物体)
  2. Blender 清理 → 简化几何体
  3. 烘焙高分辨率纹理
  4. 导出 GLB
  5. model-viewer → 响应式 3D 查看器

输出:支持缩放/旋转的交互式 3D 查看器 总耗时:约 1 小时

model-viewer 代码:

<model-viewer
  src="product.glb"
  ar
  auto-rotate
  camera-controls
  shadow-intensity="1"
></model-viewer>

检查清单与模板

转换前检查清单
## Image Source
[ ] Résolution suffisante (min 1024x1024)
[ ] Fond transparent ou uniforme
[ ] Sujet bien délimité
[ ] Style cohérent (pas de mix photo/illustration)

## Objectif
[ ] Destination claire (web/jeu/vidéo)
[ ] Poly budget défini
[ ] Animations nécessaires identifiées
[ ] Format d'export choisi
3D 需求简报模板
## Brief Conversion 2D → 3D

**Image source:** [joindre]
**Type:** [ ] Personnage [ ] Objet [ ] Logo [ ] Autre

**Destination finale:**
- Plateforme: _______________
- Interaction: [ ] Statique [ ] Rotation [ ] Animation complète
- Taille max: ___ MB

**Style souhaité:**
- [ ] Fidèle à l'original
- [ ] Stylisé/Low-poly
- [ ] Réaliste

**Animations (si personnage):**
- [ ] Idle
- [ ] Walk
- [ ] Autres: _______________

**Contraintes:**
- _______________

工具对比表

标准Hunyuan3DTripo AIMeshyRodinCSM
纹理质量⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐
速度⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐
易用性⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐
所需清理工作中等少少少中等
价格免费免费增值免费增值付费免费增值
最适合角色原型风格化内容游戏多视角

故障排查

问题可能原因解决方案
网格“爆炸”背景不透明上传前移除背景
缺少纹理导出时未内嵌纹理使用打包的纹理重新导出
骨骼绑定失败姿势不是 T 姿势在 Mixamo 之前于 Blender 中调整姿势
文件过大多边形过多使用 Decimate modifier
动画卡顿FPS 不兼容以 30fps 重新导出

技能范围

此技能的优势
  • 规划视频制作工作流
  • 创建故事板框架
  • 提供技术方案建议
  • 提供创意指导模板
此技能无法做到
  • 替代专业摄像
  • 直接编辑视频文件
  • 做出最终创意判断
  • 保证观众参与度

参考资料

工具
教程
  • Dilum Sanjaya:角色转 3D 工作流(X/Twitter)
  • Three.js Fundamentals:加载 3D 模型
  • React Three Fiber:useGLTF 文档
研究
  • docs/research-ai-design-workflows-2026-01.md - 深入研究,涵盖 75+ 个来源

相关技能

  • character-design-ai/ - 生成风格一致的角色图像(本技能的输入)
  • vibe-coding-design/ - 快速迭代方法
  • ai-ui-generation/ - 将 3D 集成到生成的界面中

技能版本:1.0 最后更新:2026-01-28 类别:ai-design

评论

支持 Markdown