# web3D **Repository Path**: kk357924266/web3D ## Basic Information - **Project Name**: web3D - **Description**: 随着3D Gaussian Splatting（3DGS）技术的快速发展，Web端3D渲染能力已达到前所未有的高度。World Labs于2026年4月开源的Spark 2.0，首次实现了在普通浏览器中流畅渲染亿级3DGS点云的能力。本方案旨在构建一个基于最新开源技术的3DGS技术官网，展示3DGS技术的强大能力，并提供手机拍照直接建模的创新功能。 - **Primary Language**: Unknown - **License**: GPL-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 2 - **Forks**: 0 - **Created**: 2026-04-18 - **Last Updated**: 2026-09-13 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Web3D 平台 - 3D 模型生成与管理平台 > [English](README.en.md) | 中文 ## 📋 项目简介 Web3D 是一个全栈 3D 模型生成与管理平台，集成多种 AI 3D 生成引擎，提供从模型生成、展示、管理到官网模板引擎的一站式解决方案。支持 **图生 3D 模型**、**3D 模型画廊展示**、**后台统一管控** 等核心功能。 --- ## 🎯 商业概览（价值主张） **一句话定位**：让「任何一张图片 → 一个可交互的 3D 模型 → 一个企业 3D 官网」全链路零代码落地。 ### 我们解决什么问题 | 痛点 | Web3D 方案 | |:---|:---| | 企业想上 3D 展示但不懂建模 | 图生 3D 一键生成，多引擎自动路由 | | 3D 模型格式混乱无法兼容 | 多格式互转 + 流式格式渐进加载，一次上传处处可用 | | 3D 官网开发成本高、周期长 | 官网模板引擎 + 导航菜单管理，后台拖拽配置即发布 | | C 端用户想要沉浸式浏览 | 自适应相机 + 多种环绕模式 + 全屏预览，打开即用 | ### 目标用户（B2B2C 双轮驱动） - **B 端**：电商平台（商品 3D 展示）、家居建材、汽车、文旅展馆、教育机构、3D 打印服务商 —— 需要「3D 内容生产 + 3D 官网搭建」的企业 - **C 端**：设计师、建模爱好者、3D 内容创作者 —— 需要「图生 3D + 在线编辑」的个人用户 ### 商业价值主张 - **降本**：图生 3D 替代人工建模，成本降低 90%+ - **增效**：一键流式导出 + 自动化流水线，交付周期从天级 → 分钟级 - **差异化**：原生支持 3DGS / SOG / SPZ 等下一代格式，超前于传统 3D 平台 - **可规模化**：零代码模板引擎让「每个企业都能有自己的 3D 官网」 > 📌 完整商业路线（C 端 / B 端分阶段规划）见文末「🚀 商业路线」章节。 --- ## 🎮 在线演示 ### 👉 [3D 模型展示](https://wlewer.github.io/web3D/showcase.html) **展示特性**： - ✅ 6 个精选模型，星空粒子背景 - ✅ 画布占满卡片，内嵌详情按钮 - ✅ 拖拽旋转，滚轮缩放 - ✅ 全屏预览模式 > 💡 **提示**: 部署后请将链接中的 `yourusername` 替换为您的 GitHub 用户名 --- ## ✨ 核心功能 ### 🎨 3D 渲染与展示 | 功能 | 说明 | |:---|:---| | **SPZ 渐进式渲染** | 支持 3D Gaussian Splatting SPZ 格式，边下载边渲染，首帧极速呈现 | | **自适应相机** | 根据模型包围盒自动选择最佳视角，扁平/盘状模型自动俯视，避免倒立 | | **多格式兼容** | 支持 glTF/GLB / SPZ / PLY / STL / OBJ / FBX 等多种 3D 格式 | | **智能居中引擎** | 自动计算模型包围盒，自适应相机距离，无需手动调参 | | **5 种环绕模式** | 自动环绕、手动拖拽、缩放、平移、预设视角切换 | | **产品标签系统** | 3D 场景内标签标注，后台可配置标签数量与内容 | ### 🤖 AI 3D 生成引擎 | 引擎 | 模式 | 状态 | 说明 | |:---|:---|:---|:---| | **腾讯混元 3D** | 云端 API（标准版/专业版/极速版） | ✅ 生产可用 | 国产高精度 3D 生成 | | **TRELLIS.2** | 云端 GPU 推理 | ✅ 生产可用 | Microsoft 结构化 3D 生成 | | **Gamba** | 云端 GPU 推理 | ✅ 生产可用 | 单图 → 3DGS 高质量重建 | | **阿里通义 3D** | 云端 API | ✅ 生产可用 | Alibaba 3D 生成，多版本支持 | | **TripoSR** | CPU 程序化生成 / GPU 推理 | ⚠️ CPU 降级可用 | Stability AI 快速 3D 重建 | | **ImageToSTL** | CPU 图片浮雕生成 | ✅ 可用 | 图片 → 3D 浮雕 STL | | **SF3D** | GPU 模式（Mock 就绪） | 🚧 待部署 | 高保真单图 3D 重建 | | **InstantMesh** | GPU 模式（Mock 就绪） | 🚧 待部署 | 多视图稀疏重建 | ### 🔄 模型格式转换 | 功能 | 说明 | |:---|:---| | **多格式互转** | GLB / GLTF / FBX / OBJ / PLY / STL / SPZ / SOG 等格式双向转换 | | **流式格式导出** | 将模型转换为 **meta.json + .webp** 流式格式，支持渐进式加载 | | **3DGS 压缩** | SPZ / SOG（Arcana 3D 压缩格式）、compressed.ply 高斯泼溅压缩 | | **自动化流水线** | 一键批量转换：源格式检测 → 中间处理 → 流式导出 → 导入模型库 | | **LOD 构建** | 自动构建多级细节模型（Level of Detail） | | **模型分析** | 自动分析顶点数、面数、文件大小等指标 | | **锚点排序** | 按着色贡献度排序高斯溅射点，优化渲染性能 | | **查看器设置生成** | 自动生成最优预览器配置，确保展示效果 | ### 🌊 流式格式（Streaming Format） | 特性 | 说明 | |:---|:---| | **渐进式加载** | 模型先低分辨率呈现，随数据下载逐级清晰，首帧极速展示 | | **文件结构** | `meta.json`（元数据 + 纹理清单）+ 多张 `.webp` 渐进纹理 | | **🎬 专属标识** | 管理后台全链路 `🎬 流式` 标签，显著区分本地生成流式模型 | | **自动入库** | 流式格式生成后一键导入模型库，自动批准，无需人工审核 | | **PlayCanvas 渲染** | 基于 SuperSplat 引擎的流式查看器，支持完整 3D 交互 | ### 🏗️ 官网模板引擎 | 功能 | 说明 | |:---|:---| | **页面模板系统** | 可视化编辑页面布局，支持全页/区块/组件三种模板类型 | | **Slot 插槽机制** | 每个模板内含多个插槽，可独立配置组件类型和参数 | | **导航菜单管理** | 树形菜单编辑，支持多级菜单、绑定模板、批量排序 | | **组件注册表** | 内置 9 个注册组件，支持动态加载和懒加载 | | **双模渲染** | 模板模式（动态渲染）与遗留组件模式（硬编码页面）无缝切换 | ### 🛠️ 后台管理系统 | 模块 | 功能 | |:---|:---| | **仪表盘** | 系统状态概览，统计数据 | | **模型管理** | 模型列表、上传、编辑、删除、审核、预览 | | **AI 专业生成** | 多引擎切换、参数调节、生成历史、双厂商配置体系（腾讯混元 / 阿里通义） | | **模型格式转换** | 多格式互转、流式格式导出、3DGS 压缩、LOD 构建、批量自动化 | | **模板管理** | 模板 CRUD、插槽管理、发布/归档 | | **导航菜单** | 菜单树编辑、模板绑定、排序、可见性控制 | | **系统设置** | 运行模式切换、Generator 服务端点配置、API 密钥管理、生成额度控制 | | **流式测试** | 流式格式播放测试、渐进式加载验证 | ### 🌐 前台页面 | 页面 | 说明 | |:---|:---| | **首页** | 3D 模型轮播展示，Hero 区域，功能入口 | | **模型画廊** | 模型卡片网格展示，分类筛选，搜索 | | **3D 车间** | 沉浸式 3D 场景展示 | | **模型上传** | 文件上传与 AI 3D 生成入口 | | **用户登录** | JWT 认证登录 | | **图书查看器/画廊** | 电子书阅读体验 | | **Spark 编辑器** | 3D 场景在线编辑 | --- ## 🏗️ 技术栈 ### 前端技术栈 | 层级 | 技术选型 | |:---|:---| | **框架** | React 18 + TypeScript 5 + Vite 5 | | **UI 组件** | Ant Design 5 + @ant-design/icons | | **3D 渲染** | Three.js (0.180) + threepipe + @react-three/fiber + @react-three/drei | | **3DGS 渲染** | PlayCanvas + SuperSplat + @playcanvas/splat-transform | | **后台框架** | Refine (4.x) + @refinedev/antd | | **状态管理** | Zustand 5 | | **动画引擎** | @tweenjs/tween.js | | **HTTP 请求** | Axios | | **路由** | react-router-dom v7 | | **数据获取** | @tanstack/react-query | | **国际化** | 内置中英文 i18n | ### 后端技术栈 | 层级 | 技术选型 | |:---|:---| | **Web 框架** | FastAPI (0.109) | | **ASGI 服务器** | Uvicorn (0.27) | | **ORM** | SQLAlchemy 2.0 (异步) | | **数据库** | SQLite (开发) / PostgreSQL (生产) | | **数据库迁移** | Alembic | | **认证** | JWT (python-jose) + bcrypt (passlib) | | **数据验证** | Pydantic 2 + pydantic-settings | | **云 SDK** | 腾讯云官方 SDK (tencentcloud-sdk-python) | | **日志** | Loguru | | **3D 处理** | Trimesh + numpy + Pillow + OpenCV | --- ## 📁 项目结构 ``` web3D/ ├── backend/ # Python 后端 │ ├── app/ │ │ ├── api/v1/ # API 路由 │ │ │ ├── auth.py # 认证接口 │ │ │ ├── users.py # 用户管理 │ │ │ ├── models.py # 3D 模型 CRUD + 导入 │ │ │ ├── model_convert.py # 模型格式转换 + 流式导出 │ │ │ ├── website.py # 官网模板系统 │ │ │ ├── generation.py # AI 3D 生成（多引擎） │ │ │ ├── templates.py # 渲染模板 │ │ │ ├── experimental.py # 实验性功能 │ │ │ ├── settings.py # 系统设置 + 端点配置 │ │ │ └── quota.py # 额度管理 │ │ ├── models/ # SQLAlchemy 模型 │ │ │ ├── model.py # Model3D（含流式格式字段） │ │ │ ├── convert_task.py # 转换任务模型 │ │ │ └── template.py # 模板模型 │ │ ├── schemas/ # Pydantic 数据模式 │ │ ├── services/ # 业务逻辑层 │ │ │ ├── generation/ # AI 生成服务 │ │ │ │ ├── hunyuan3d_service.py # 腾讯混元 3D │ │ │ │ ├── trellis2_service.py # TRELLIS.2 │ │ │ │ ├── gamba_service.py # Gamba │ │ │ │ ├── tongyi3d_cloud_service.py # 阿里通义 3D │ │ │ │ └── triposr_service.py # TripoSR │ │ │ └── model_convert/ # 格式转换服务 │ │ ├── core/ # 核心工具 │ │ │ └── security.py # JWT + 密码 │ │ ├── config.py # 双厂商配置管理 │ │ ├── database.py # 数据库连接 │ │ ├── dependencies.py # 依赖注入 │ │ └── main.py # 应用入口 │ ├── database/ # 数据库迁移 │ ├── uploads/ # 上传文件 │ ├── static/ # 静态页面 │ ├── .env # 环境配置 │ └── requirements.txt # Python 依赖 │ ├── services/ │ └── splat-convert-service/ # Node.js 高斯 Splat 格式转换微服务（独立服务，非后端） │ └── src/services/ │ └── splat-service.js # 3DGS PLY→SPZ/SOG/GLB/LOD 格式处理 │ ├── src/ │ ├── supersplat/ # SuperSplat 编辑器 (submodule) │ ├── supersplat-viewer/ # SuperSplat 查看器 (submodule) │ └── web-frontend/ # React 前端 │ ├── src/ │ │ ├── admin/ # 后台管理系统 │ │ │ ├── modules/ │ │ │ │ ├── dashboard/ # 仪表盘 │ │ │ │ ├── model/ # 模型管理（含预览弹窗） │ │ │ │ ├── professional/ # AI 专业生成页面 │ │ │ │ ├── settings/ # 系统设置 │ │ │ │ │ ├── SettingsPage # 运行模式配置 │ │ │ │ │ ├── EndpointSettingsPage # 生成端点配置 │ │ │ │ │ ├── ModelConvertPage # 模型格式转换 │ │ │ │ │ └── StreamingTestPage # 流式格式测试 │ │ │ │ ├── template/ # 模板管理 │ │ │ │ ├── auth/ # 登录 │ │ │ │ └── experimental/ # 实验功能 │ │ │ ├── components/ # 通用组件 │ │ │ ├── layout/ # 布局 │ │ │ └── core/ # 后台核心 │ │ ├── core/template/ # 模板引擎 │ │ │ ├── ComponentRegistry # 组件注册表 │ │ │ ├── TemplateRenderer # 模板渲染器 │ │ │ ├── TemplateProvider # 模板上下文 │ │ │ └── builtin/ # 内置组件 │ │ ├── components/3d/ # 3D 组件 │ │ │ ├── UniversalGaussianCardV2 # 高斯泼溅卡片（自适应相机） │ │ │ ├── UnifiedSplatPreview # 统一 3DGS 预览 │ │ │ ├── ModelLoader # 模型加载器 │ │ │ └── Base3DViewer # 基础 3D 查看器 │ │ ├── pages/ # 前台页面 │ │ │ ├── Home/ # 首页 │ │ │ ├── Gallery/ # 模型画廊 │ │ │ ├── Workshop3D/ # 3D 车间 │ │ │ ├── Upload/ # 模型上传 │ │ │ ├── Auth/ # 登录 │ │ │ ├── BookViewer/ # 图书查看器 │ │ │ ├── BookGallery/ # 图书画廊 │ │ │ ├── Editor/ # 3D 编辑器 │ │ │ └── SuperSplat/ # SuperSplat │ │ ├── types/ # TypeScript 类型 │ │ ├── i18n/ # 国际化 │ │ ├── stores/ # 状态管理 │ │ └── utils/ # 工具函数（API配置等） │ ├── vite.config.ts │ ├── tsconfig.json │ └── package.json │ ├── miniprogram/ # 微信小程序 ├── scripts/ # 脚本工具 ├── previews/ # 预览缩略图 ├── docs/ # 项目文档 └── artifacts/ # 构建产物 ``` --- ## 🚀 快速开始 ### 环境要求 - **Node.js** >= 18 - **Python** >= 3.11 - **npm** >= 9 ### 一键启动（推荐） ```bash # Windows start.bat # Mac/Linux ./start.sh ``` ### 手动启动 #### 1. 启动后端 ```bash cd backend # 创建虚拟环境（首次） python -m venv .venv # 或使用项目统一虚拟环境 # python -m venv ../../.venv312 # 激活虚拟环境 # Windows: .venv\Scripts\activate # Mac/Linux: source .venv/bin/activate # 安装依赖 pip install -r requirements.txt # 启动服务 python -m uvicorn app.main:app --host 0.0.0.0 --port 8000 ``` 后端服务默认运行在 **http://localhost:8000**，API 文档访问 **http://localhost:8000/docs** #### 2. 启动前端 ```bash cd src/web-frontend # 安装依赖（首次） npm install # 启动开发服务器 npm run dev # 启动后台管理（可选） npm run dev:admin ``` 前端开发服务器默认运行在 **http://localhost:5173** --- ## 🔧 配置说明 ### 环境变量（`backend/.env`） | 变量 | 默认值 | 说明 | |:---|:---|:---| | `HOST` | `0.0.0.0` | 后端监听地址 | | `PORT` | `8000` | 后端端口 | | `DEBUG` | `true` | 调试模式 | | `DATABASE_URL` | `sqlite+aiosqlite:///./web3d_test.db` | 数据库连接 | | `SECRET_KEY` | `your-secret-key` | JWT 签名密钥 | | `HUNYUAN3D_MODE` | `mock` | 混元 3D 模式（mock/cloud） | | `GENERATION_MODE` | `mock` | 生成模式（mock/cpu/gpu） | ### 生成模式切换 在 `backend/.env` 中配置： ```ini # Mock 模式（默认，无需 GPU，用于开发测试） GENERATION_MODE=mock HUNYUAN3D_MODE=mock # 云端模式（调用腾讯混元 3D API，需要 SecretId/SecretKey） GENERATION_MODE=mock HUNYUAN3D_MODE=cloud # VERSION_LIST=hy-3d-3.0,hy-3d-3.1,HY-3D-Express ``` --- ## 🎯 API 概览 ### 模型管理 | 端点 | 说明 | 认证 | |:---|:---|:---:| | `GET /api/v1/models` | 模型列表（分页） | 可选 | | `POST /api/v1/models` | 创建模型 | 需要 | | `PUT /api/v1/models/{id}` | 更新模型 | 需要 | | `DELETE /api/v1/models/{id}` | 删除模型 | 需要 | | `POST /api/v1/models/import` | 导入模型到模型库（支持流式格式） | 需要 | ### AI 3D 生成 | 端点 | 说明 | 认证 | |:---|:---|:---:| | `POST /api/v1/generate` | AI 3D 生成（多引擎） | 需要 | | `GET /api/v1/generate/tasks` | 生成任务列表 | 需要 | | `GET /api/v1/generate/history` | 生成历史记录 | 需要 | ### 模型格式转换 | 端点 | 说明 | 认证 | |:---|:---|:---:| | `POST /api/v1/model-convert/start` | 启动格式转换任务 | 需要 | | `GET /api/v1/model-convert/status/{task_id}` | 查询转换状态 | 需要 | | `GET /api/v1/model-convert/history` | 转换历史记录 | 需要 | | `POST /api/v1/model-convert/streaming` | 导出流式格式 | 需要 | | `POST /api/v1/model-convert/compress` | 3DGS 压缩 | 需要 | | `POST /api/v1/model-convert/build-lod` | 构建 LOD | 需要 | | `GET /api/v1/model-convert/formats` | 支持格式列表 | 否 | ### 模板 & 导航 | 端点 | 说明 | 认证 | |:---|:---|:---:| | `GET /api/v1/nav-menus/flat` | 导航菜单平铺列表 | 否 | | `GET /api/v1/nav-menus` | 导航菜单树形结构 | 可选 | | `GET /api/v1/website-templates` | 模板列表 | 可选 | | `GET /api/v1/website-templates/{id}` | 模板详情（含插槽） | 否 | | `POST /api/v1/website-templates` | 创建模板 | 需要 | | `PUT /api/v1/website-templates/{id}` | 更新模板 | 需要 | | `DELETE /api/v1/website-templates/{id}` | 删除模板 | 需要 | | `POST /api/v1/website-templates/{id}/publish` | 发布模板 | 需要 | | `GET /api/v1/website-templates/{id}/slots` | 模板插槽列表 | 否 | | `POST /api/v1/website-templates/{id}/slots` | 添加插槽 | 需要 | | `GET /api/v1/components` | 注册组件列表 | 否 | ### 用户 & 认证 | 端点 | 说明 | 认证 | |:---|:---|:---:| | `POST /api/v1/auth/login` | 用户登录 | 否 | | `POST /api/v1/auth/register` | 用户注册 | 否 | | `GET /api/v1/users` | 用户列表 | 需要 | | `GET /api/v1/users/me` | 当前用户信息 | 需要 | ### 系统 & 设置 | 端点 | 说明 | 认证 | |:---|:---|:---:| | `GET /health` | 健康检查 | 否 | | `GET /api/v1/settings` | 系统设置 | 需要 | | `PUT /api/v1/settings/endpoint` | 配置生成端点 | 需要 | | `PUT /api/v1/settings/mode` | 切换运行模式 | 需要 | | `GET /api/v1/quota` | 查询生成额度 | 需要 | --- ## 🏗️ 官网模板引擎架构 ``` 导航菜单管理（后台） │ ▼ NavMenu (树形结构) ├── template_id ────→ WebsiteTemplate（页面模板） │ ├── layout_config（区块结构定义） │ ├── theme_config（CSS 变量） │ └── slots[]（组件插槽） │ ├── slot_key（插槽标识） │ ├── component_type（组件类型） │ └── component_config（组件参数） │ └── page_component ──→ Legacy Page（传统硬编码页面） 前端渲染链路： TemplateProvider（加载模板数据） ↓ TemplateRenderer（解析 layout_config 区块结构） ↓ ComponentRegistry（按 component_type 查找注册组件） ↓ 内置组件 / 动态懒加载页面 ``` --- ## 🤝 社区与支持 我们暂时没有公开的 GitHub Discussions 社区，但仍欢迎你通过以下渠道获取帮助、反馈问题或了解项目最新进展。 ### 反馈问题 - 遇到 bug 或功能建议？请通过 [GitHub Issues](https://github.com/wlewer/web3D/issues) 提交，附上复现步骤和环境信息。 - 商务合作或私有化部署咨询，请通过企业微信小助手联系。 ### 联系我们 | 企业微信小助手 | 微信公众号 | |:---|:---| | 扫码添加小助手，加入技术交流群 | 扫码关注公众号，获取产品动态与教程 | | ![企业微信小助手](docs/mobile-ui-designs/企业微信.png) | ![微信公众号](docs/mobile-ui-designs/企业公众号.jpg) | > 💡 **提示**：企业微信小助手工作时间会定期处理入群申请，请备注“Web3D 技术交流”。 --- ## 📜 License MIT License --- ## 🚀 近期更新 ### 2026-07-29 — 镜头坐标可视化 + 后台模块精简 + 渲染升级 - **新增**：模型编辑界面（变换参数 Tab）新增「📷 镜头坐标」卡片，直接展示 Showcase 截图保存的相机数据；兼容 viewer26 球坐标格式 `{p, a, d, f, ap, at, cm}`（位置 / 球坐标角 α·β·γ / 距离 / fov / 模式 / 动画）与标准笛卡尔格式 `{position, target, zoom}` - **新增**：详情页 `parseCameraParams` 同步支持球坐标，自动反算注视点，镜头数据完整呈现 - **优化**：模型编辑 / 预览弹框 `metadataJson` 读写 bug 修复，相机恢复更精准 - **重构**：删除后台「用户管理」「租户管理」两个模块（含路由与侧边栏菜单），后台更聚焦核心功能 - **升级**：viewer26 升级至 PlayCanvas v1.28.0 + LOD 渐进式渲染支持，移除硬编码 Z-180，统一由数据库 `modelTransform` 控制模型方向 - **优化**：Showcase / 画廊 / 模型转换 / 引擎动态控制（后端 `render-defaults.engines`）等多处体验与稳定性提升 - **变更文件**：`ModelList.tsx`、`ModelDetail.tsx`、`AdminLayout.tsx`、`App.tsx`、`models.py` 等 108 个文件 ### 2026-07-19 — 流式格式 + 自适应相机 + 文档完善 - **新增**：模型格式转换全功能 — 多格式互转、流式格式导出（meta.json + .webp）、3DGS 压缩、LOD 构建、批量自动化 - **新增**：流式格式全链路支持 — 后端自动检测、`🎬 流式` 专属视觉标识、一键导入模型库、自动批准 - **新增**：SPZ/Splat 预览自适应相机 — 根据模型包围盒自动选择最佳视角，盘状模型自动俯视，彻底解决倒立/侧躺问题 - **优化**：数据库 schema 扩展，新增 `stream_url`、`metadata_json` 等流式格式字段 - **完善**：README.md 全面更新，补充 8 大功能模块、完整 API 分类文档、细化项目结构 - **变更文件**：`models.py`、`model_convert.py`、`ModelConvertPage.tsx`、`UniversalGaussianCardV2.tsx` 等 28 个文件 ### 2026-07-18 — 双引擎生成体系 + 动态配置 - **新增**：TRELLIS.2（Microsoft 结构化 3D 生成）和 Gamba（单图 → 3DGS 重建）云端推理后端 - **新增**：阿里通义 3D 云端 API 集成，双厂商（腾讯混元 / 阿里通义）生成配置体系 - **新增**：Aholo Viewer 完整集成，支持多视角 3DGS 浏览 - **新增**：动态 IP / 多后端配置体系，支持环境变量和 UI 界面双重配置 - **优化**：WebGPU 自动检测与引擎智能切换，Aholo 专用模式 20%（WebGPU 可用）/ PlayCanvas 降级 80% ### 2026-07-03 — 海报截图保存修复 (v5) - **修复**：viewer 端截图保存为 1x1 灰图的问题 — PlayCanvas `preserveDrawingBuffer` 导致的空白 canvas 已通过 `frameend` 同步截图 + `isSolidColorDataURL` 启发式检测彻底解决 - **新增**：纯色图自动重试机制（8次/1s），canvas 尺寸校验，详细 console.log 调试日志 - **新增**：`fix_orphan_thumbnails.py` 清理脚本，修复 13 条黑图/灰图死链记录 ### 2026-06-02 — 分页缓存修复 - **修复**：彻底移除 `loadedCache`，切换分页时卡片全新挂载无缓存污染 - **修复**：`finalSrc` useMemo 稳定 iframe 不重载 + camera restore 重试 8 次 --- ## 🚀 商业路线（B2B2C 分阶段） ### 阶段一：B 端工具化（0 → 1，当前） **目标**：把「图生 3D + 3D 官网」打磨成可交付的 B 端产品。 | 里程碑 | 说明 | |:---|:---| | 企业级模型库 | 私有模型库 + 审核流 + 权限控制 | | 3D 商品展示 | 电商 SKU 3D 化，替换传统图片 | | 3D 官网模板 | 预置行业模板（家具/汽车/珠宝/文旅），客户拖拽即上线 | | 交付闭环 | 模型生成 → 审核 → 部署 → 官网发布 全流程管理 | **商业验证**：3-5 家种子客户（电商 + 展馆），验证「3D 商品展示 + 官网」付费意愿。 ### 阶段二：C 端创作者经济（0 → N） **目标**：向 C 端开放「图生 3D + 在线编辑」，形成 UGC 内容生态。 | 里程碑 | 说明 | |:---|:---| | C 端自助服务 | 免费额度 + 订阅制（月/年），按生成次数计费 | | 3D 内容交易 | 用户生成的 3D 模型上架市场，平台抽佣 | | 社区沉淀 | 模型分享 + 收藏 + 二次创作，形成内容飞轮 | | 移动端 | 微信小程序 / App，图生 3D 随手可用 | **商业验证**：订阅转化率 + 模型交易 GMV + 社区 DAU。 ### 阶段三：平台化生态（规模化） **目标**：从「工具」升级为「3D 内容平台」。 | 里程碑 | 说明 | |:---|:---| | 开放 API / SDK | 第三方集成图生 3D 能力 | | 企业解决方案 | 行业定制（教育/医疗/工业数字孪生） | | AI 深化 | 文生 3D、3D 场景自动布置、AI 标注辅助 | | 国际化 | 多语言 + 多币种 + 海外云部署 | ### 商业模式概览 | 模式 | 对象 | 计费 | |:---|:---|:---| | SaaS 订阅 | B 端企业 | 按席位/模型数/存储 | | 生成额度包 | B/C 通用 | 按生成次数/格式导出 | | 模板/市场分成 | C 端创作者 | 上架抽佣 | | 私有化部署 | 大企业/政企 | 一次性 + 年维护 | --- *最后更新：2026-08-17*