源码系统概览
文章正文
Hunyuan3D-WorldClaw 是腾讯混元团队开源的「智能体驱动开放式 3D 世界生成（WorldClaw）」项目官方展示页前端源码。它把一个 3D 场景生成研究成果包装成一个精致的可交互展示站点，方便研究者与开发者快速了解模型能力、查看多视角渲染结果，并跳转原始论文与代码仓库。本项目定位为科研成果对外展示的站点模板，本身不包含模型训练或推理逻辑。
源码简介
本仓库是 WorldClaw 项目的官方项目页（project page）前端源码，而非训练或推理代码本身。整个站点基于 Vite 与 React 18 构建，内容以静态资源形式组织，包含大量场景渲染图与演示视频。源码提供了清晰的目录结构、组件化页面与一键部署配置，适合作为「科研结果展示页」的参考模板，也可以二次开发成自己的论文或产品落地页。项目采用 MIT 许可证，二次开发门槛低，社区可自由学习与改造。
适用场景
研究者需要对外展示 3D 生成成果与多视角渲染结果，团队需要快速搭建产品官网或论文落地页。前端开发者希望学习 Vite + React 静态站点的目录组织、组件拆分与主题切换实现。需要把视频、图片与说明文字组合成沉浸式展示页的各类内容型站点。
功能亮点
多布局场景展示：首页以网格与灯箱方式呈现十一组 3D 世界布局渲染结果。左侧导航栏：宽屏折叠为左侧导航轨道，窄屏保留顶部栏与汉堡菜单，不遮挡正文。视频灯箱预览：演示视频支持点击放大查看，默认不预加载以控制流量。明暗主题切换：提供主题切换组件，适配浅色与深色阅读环境。归属与致谢页：独立 attributions 页面集中列出素材与第三方授权信息。
技术架构与部署指南
| 维度 | 本套源码 | 同类通用方案 |
|---|---|---|
| 技术栈 | 前端：React 18 + TypeScript + Vite
后端：无独立后端，纯静态站点 数据库：无（静 |
依具体方案选型，需自行搭建与维护 |
| 部署方式 | 克隆仓库后执行 npm install 或 yarn 安装依赖； | 多托管于第三方平台或订阅云服务 |
| 功能侧重 | 多布局场景展示：首页以网格与灯箱方式呈现十一组 3D 世界布局渲染结果。 | 功能通用，定制深度有限 |
| 数据归属 | 数据自持，部署在自有服务器，不出站 | 数据通常留存于服务商侧 |
| 成本模式 | 获取后自主部署，无持续授权费用 | 通常按订阅或调用量计费 |
技术栈与运行环境
前端：React 18 + TypeScript + Vite
后端：无独立后端，纯静态站点
数据库：无（静态展示页）
运行环境：Node.js 18+ 用于本地构建，任意静态服务器托管
其他依赖：@phosphor-icons/react 图标库、@fontsource-variable 字体包、ESLint 代码规范
安装与部署提示
克隆仓库后执行 npm install 或 yarn 安装依赖；本地预览使用 npm run dev 启动 Vite 开发服务器。产出静态文件使用 npm run build，构建结果位于 dist 目录，可直接通过 GitHub Pages 或任意静态托管服务上线。仓库内置 .github/workflows/deploy-pages.yml，可对接 GitHub Pages 自动部署，无需额外后端资源。
截图与演示说明
站点首页以全屏标题与首屏演示视频开场，向下滚动进入场景展示区。场景缩略图条（filmstrip）以十一组布局缩略图收尾，点击可查看大图。左侧导航轨道在宽屏下显示各小节标签，悬停或聚焦即展开，交互流畅且不遮挡正文阅读。
常见问题
问：这个仓库包含模型权重或训练代码吗？
答：不包含。本仓库仅为前端展示页源码，模型权重与训练推理代码请前往对应的 WorldClaw 研究仓库获取。
问：能否直接用于商业产品官网？
答：代码采用 MIT 许可证，可自由二次开发；但站点内使用的演示视频、渲染图与第三方字体请自行确认授权范围后再使用。
安全风险提示
特别提示：本源码未检测安全风险文件，下载后请务必进行安全审计，删除恶意代码后再部署使用！
下载说明
源码仅供学习研究、测试部署和二次开发参考，商用前请自行确认授权、版权和安全风险。本站不对素材版权与第三方字体的商用合规性负责，使用前请逐一核实。
GitHub项目开源地址：https://github.com/Tencent-Hunyuan/Hunyuan3D-WorldClaw