3DCellForge 新手入门教程：一次掌握 AI 3D 生成、模型检查与演示全流程

【免费下载链接】3DCellForgeAI-powered interactive 3D model generation, inspection, and presentation studio.项目地址: https://gitcode.com/gh_mirrors/3d/3DCellForge

3DCellForge（3D Model Studio）是一款 AI 驱动的交互式 3D 模型工作台，帮你把一张参考图片或一个 GLB 文件，变成可旋转、可检查、可演示的 3D 模型。本文面向新手，带你完整走通AI 3D 生成 → 模型检查 → Demo 演示的全流程，不用背命令、不用读源码，照着做就能上手。

🧭 先认识它：3DCellForge 能做什么

3DCellForge 的核心定位是一站式「3D 模型检查与演示工作台」：

🚀 快速启动：3 步跑起 3DCellForge

第 1 步：获取项目代码

git clone https://gitcode.com/gh_mirrors/3d/3DCellForge cd 3DCellForge

第 2 步：安装依赖

npm install

第 3 步：启动前端

npm run dev

打开终端里显示的 Vite 地址，即可看到三栏工作台：

• 左侧 Model Library：当前激活的模型 + 历史资产
• 中间 WebGL 舞台：交互式 3D 查看区
• 右侧 Asset Source：选择生成方式或导入.glb/.gltf

💡 不想配置 API？仓库在public/generated-models/下内置了缓存好的示例 GLB，打开就能直接体验交互和演示功能。

🎨 AI 3D 生成：从一张图片到可交互模型

想要真实生成 3D 模型，需要先启用后端：

1. 复制示例配置：cp .env.example .env.local
2. 在 .env.local 中填入你的 API Key（如TRIPO_API_KEY、FAL_API_KEY）
3. 一个终端跑后端：npm run dev:api，再跑前端：npm run dev

各生成模式说明（源码位于 server/providers/）：

在右侧Asset Source面板选好模式后点击Add Image / GLB上传参考图，任务会出现在左侧Generation Queue中，完成后模型自动加载到中央舞台。

生成的 GLB 会缓存到本地，后续打开不再消耗 API 额度；模型记录写入 IndexedDB，刷新页面后依然保留。

🔍 模型检查：质量评分 + 部件细节

生成或导入模型后，建议先看主舞台上的质量评分卡片——它会统计文件大小、三角面数、贴图数量和演示可用性（实现见 src/lib/modelQuality.js）。分数偏低通常意味着源图或生成结果还不适合演示。

接着可以：

• 拖拽旋转 / 滚轮缩放：360° 观察模型轮廓与材质
• 点击部件 Inspect：打开详情抽屉，查看推断的类别、来源、材质重点和标签
• Compare 对比：两个模型并排比较形态与材质差异

项目内置了多套教学示例资产（植物细胞、神经元、上皮组织等），其资料定义在 src/domain/cellData.js，新手可以拿它们练手，感受完整的检查流程。

🎬 Demo 演示模式：截图与录屏一步到位

顶部导航点击Demo，即可进入纯展示模式：

• 自动隐藏左右工具栏，画面更干净
• 根据模型类型切换运镜：车走低机位推进、飞机走飞行掠过、有机标本走工作室环绕（运镜逻辑在 src/viewer/CellViewer.jsx）
• 支持截图保存、GLB 导出，适合录屏做展示素材

配合 docs/demo/3DCellForge-demo-2026-05-10.mp4 演示视频，你可以对照学习标准演示节奏。

📁 关键文件导览

❓ 常见问题

没有 API Key 能用吗？可以。用 JS Depth 模式或导入本地 GLB，配合内置的缓存演示模型，整个检查与演示流程都能体验。

API Key 安全吗？密钥只放在服务端.env.local（已被 git 忽略），不会暴露到前端代码包中。

想验证改动是否正常？运行npm run lint、npm run build、npm run test，再用npm run test:visual做界面截图回归。

至此，从安装启动到 AI 生成、模型检查、演示导出的完整链路你已经全部掌握。打开 README.zh-CN.md 深入细节，开始你的第一个 3D 模型项目吧！

【免费下载链接】3DCellForgeAI-powered interactive 3D model generation, inspection, and presentation studio.项目地址: https://gitcode.com/gh_mirrors/3d/3DCellForge