TvT.js
目录
主题颜色

介绍

不止是三维框架，更是一条可交付的 AI 协同工作流

TvT.js 是 ICEGL 开源的 Web 3D 工程生态，面向数字孪生、工业可视化、在线三维编辑器与插件化项目交付。它以 Three.js、Vue 3、TresJS 和 Fes.js 为技术底座，将案例、组件、编辑器、插件市场与多端集成组织在同一套工程约定中。

现在，AI 已经进入 TvT.js 从需求到交付的多个环节：

  • 需求先成为约束：框架基线、插件契约和场景变更通过 OpenSpec、需求提案与任务文档沉淀，帮助开发者与 AI 在同一上下文中协作；
  • 图像可以成为模型：混元 3D 实践支持本地部署，从图片生成三维模型，并将结果继续导入 TvT.js 场景；
  • 场景与插件可以持续演进：插件结构、路由、资源、依赖和编辑器导出链路都有明确约定，AI 生成的代码不再是难以维护的一次性 Demo；
  • 成果可以继续交付：场景配置可复现，插件源码可导出，组件可独立发布，也可继续进入 TvT.js 基座二次开发。

换句话说，TvT.js 连接的不只是“模型生成”和“场景展示”，而是：

需求描述 → Spec 约束 → AI 协同实现 → 场景验证 → 插件或源码交付

了解 AI 协同与 Spec 工作流

WARNING

TvT.js 已于 2025 年 10 月中旬全面升级依赖，涉及 Vue 3、Tres V5、Fes V4、Cientos V4 以及 Three.js（r17x → r18x），全面拥抱 ES Module，并为 WebGPU 等新能力做好衔接。

您现在看到的是 V5 文档。旧版请查看 V4 文档open in new window；从 V4 升级时，请参考 V5 升级说明open in new window。

<script setup lang="ts">
import { TresCanvas } from '@tresjs/core'
import { Text3D, OrbitControls, MeshGlassMaterial } from '@tresjs/cientos'
import { withBase } from '@vuepress/client'
</script>
<template>
	<TresCanvas clearColor="#202022">
		<TresPerspectiveCamera :position="[0, 0.5, 5]" />
		<OrbitControls :auto-rotate="true" />
		<TresAmbientLight />
		<Suspense>
			<Text3D text="让vue写可视化更简单" :font="withBase('font/FZTHS.json')" center>
				<MeshGlassMaterial />
			</Text3D>
		</Suspense>
		<TresMesh :position="[0, 0, -1]">
			<TresPlaneGeometry :args="[5, 2]" />
			<TresMeshBasicMaterial color="#1f86e6" />
		</TresMesh>
		<TresPointLight :args="[0xffffff, 10, 0, 10]" :position="[0, 0, -1]" />
		<TresGridHelper :position="[0, -1, 0]" />
	</TresCanvas>
</template>

TIP

我们持续打磨 3D 项目中的每一块积木：

  • 用开源组件、案例和编辑器降低数字孪生的生产门槛；
  • 用 Spec、插件约定与社区共创降低三维项目的开发和维护成本；
  • 让 AI 参与需求分析、代码实现和内容生产，同时让结果保持可审查、可复用、可交付。

四大开源技术底座

从框架到生态

TvT.js 不把所有能力堆进一个仓库，而是通过稳定契约连接不同生产环节：

生态能力解决的问题可交付结果
插件与案例中心复用三维效果、业务模块和完整应用可安装、可打包的插件
区域场景与 GIS 编辑器低门槛搭建园区、厂区、地图等场景场景配置或插件源码
动态组件服务独立发布自研或第三方组件可在线加载、调参和二次开发的组件
图生 3D从图片快速获得三维资产可下载并导入场景的模型
OpenSpec 与 AI 技能让需求、架构规则和变更边界可被人和 AI 共同理解可追踪、可审查的工程变更

🏕 在线演示：opensource.icegl.cnopen in new window

INFO

TvT.js 关注的不只是“做出一个三维页面”，而是让项目从需求、资产、场景到源码交付都有可延续的工程路径。

本页目录