3d模型预览器开源项目

Simple 3D Viewer 是一个面向开发、美术和测试的本地 3D 模型查看器，核心目标是快速确认模型文件是否能加载、是否显示正常，以及动画、形态键、材质变体和自定义字段是否按预期随文件交付。它不依赖后台服务，不需要账号，也不会把模型上传到外部平台，适合在交付前、联调前或问题复现时做一次轻量检查。
1. 支持拖拽加载和文件选择，常用格式包括 `DRC`、`GLB`、`GLTF`、`OBJ`、`PLY`、`STL`、`USD`、`USDZ`
2. 默认渲染引擎是 Three.js，适合日常检查普通模型资产。模型加载后，左侧面板会显示文件名、格式、面数、顶点数、网格数量、材质数量和包围尺寸，用来快速判断模型规模和性能压力。画布顶部会显示 FPS、帧时间和 GPU 渲染时间，方便判断当前模型在本机上的渲染负载。
3. Three.js 视图提供轨道、演示、舞台三种模式，支持轴向、网格、方向仪、性能统计和自动旋转开关。灯光预设包含无光照、三点布光、正面光、轮廓光和顶光，方便暴露模型结构、法线、材质和尺寸问题。需要重新查看完整模型时，可以一键重新对焦；需要切换文件时，可以清空当前模型后继续拖入新文件。
4. 除了 Three.js，应用还保留 Cesium 渲染入口，主要用于地球和卫星场景预览。切换到 Cesium 后，可以使用固定位置或 TLE 轨道根数放置模型，调整时间倍率，聚焦或跟踪卫星，显示轨道线，并可设置卫星姿态垂直于地面。这个模式更适合验证卫星模型在地球坐标和轨道场景中的展示效果。
5. Simple 3D Viewer 的定位是“快速打开、快速检查、快速定位问题”，不是建模软件、材质编辑器或资产管理系统。复杂编辑、批量资产治理和最终渲染仍应交给专业 DCC、引擎或资产平台完成；这里更适合作为模型进入后续流程前的第一道本地检查工具。