RhineLabUI是什么?用Three.js复刻《明日方舟》莱茵生命终端的完整三维档案界面
RhineLabUI是什么?用Three.js复刻《明日方舟》莱茵生命终端的完整三维档案界面
RhineLabUI 是一个基于 TypeScript + Three.js + Vite 构建的网页三维档案界面项目,它把《明日方舟》特别映像「莱茵生命:访问」中的莱茵生命终端完整复刻成了可操作的 3D 界面:从白底开场、五列循环档案阵列,到档案抽取、玻璃同步解密,再到 360° 独立模型查看器,全流程实时渲染、免费开源,无需 API Key,也不需要后端服务。
莱茵生命终端 3D 界面:RhineLabUI 能做什么
这个项目的核心目标很明确:把视频里"看得到"的终端,做成"玩得动"的界面。它主要参考原 PV 5–40 秒的视觉与动效,并扩展出可操作的交互功能:
- 🎬 白底开场:逐字输入、圆环绕行、连续 Logo 笔画绘制、身份验证与欢迎转场,可重播也可跳过;
- 📁 循环档案阵列:五类、每类 8 份共 40 份档案,上下翻阅、左右切列均首尾循环,选中档案会竖直升起并转向详情构图;
- 🔓 模型与正文同步解密:对角解密线合拢、盖板自上而下由磨砂变清晰,右侧文档的遮挡条同步退开;
- 🧊 360° 独立查看器:环绕旋转、平滑缩放平移,支持「清晰/磨砂」玻璃切换,以及六组部件的拆解与一键重组;
- 🔍 检索、收藏与导出:按编号、标题、英文名、科室、人物与分类筛选,收藏保存在当前浏览器,档案可导出为 UTF-8 文本;
- 🔊 声音与画质设置:三轨循环配乐、玻璃碰触音与系统电子音可独立开关调音量;画质提供性能、原始、高、极高四档预设。
RhineLabUI 本地部署:三步启动莱茵生命终端
运行环境要求 Node.js 22.12 或更高版本,以及支持 WebGL 2 的现代桌面浏览器。
1️⃣ 获取项目
git clone https://gitcode.com/gh_mirrors/rh/RhineLabUI
cd RhineLabUI
2️⃣ 安装依赖并启动
npm ci
npm run dev
打开终端显示的地址(通常为 http://127.0.0.1:5173/)即可。Windows 用户也可以直接双击 启动终端.cmd,首次运行会自动安装依赖并打开浏览器。
3️⃣ 构建生产版本(可选)
npm run build
npm run preview
生产文件输出到 dist/,交给任意静态 HTTP 服务托管即可。另外项目支持 PWA 安装到主屏幕,安装与离线说明见 docs/PWA.md。
操作指南:像操作员一样使用档案终端
开场中按 Enter 或点击 ENTER SYSTEM 即可跳过进入阵列。之后核心操作如下:
| 操作 | 效果 |
|---|---|
← / → |
切换档案类别(五列首尾循环) |
↑ / ↓ |
翻阅同类档案 |
Enter 或 ACCESS FILE |
读取当前档案 |
/ 或 ARCHIVE INDEX |
打开检索面板 |
SAVE ARCHIVE |
收藏当前档案 |
EXPORT |
下载档案文本 |
Esc |
关闭弹窗 / 返回阵列 |
选中档案后,竖直升起、镜头推近,随后进入解密流程:玻璃与正文同步揭示,可以阅读概述、研究记录与访问日志。
360° 模型查看器:拆解、重组与磨砂玻璃
在详情页点击「360° 查看文档模型」进入独立场景。模型由紧固件、透明盖板、折射环组、光学核心、信息基板、背板与框架六组部件构成,点「拆解档案」沿厚度轴分层展开,「一键重组」连续收回;中途反向操作还会保留当前的运动位置与速度。玻璃状态可在「清晰/磨砂」之间随时切换,且不会重置视角和拆解位置。
检索与设置:RhineLabUI 的实用扩展功能
检索支持编号、标题、英文名、科室、相关人物与分类筛选,例如搜索「莱茵」:
设置页提供亮暗配色、音效与音乐的独立开关和独立音量、减少动态效果、画质预设、全屏与重新播放开场:
Three.js 实现亮点:源码结构与 Blender 工程
如果你想研究这类 3D 网页界面是怎么做出来的,RhineLabUI 的代码组织非常清晰,核心模块如下:
- 页面状态、档案阅读、检索与快捷键:src/main.ts
- 开场界面与逐帧时间轴:src/boot.ts、src/boot-motion.ts
- Three.js 场景、循环阵列、抽取与归位:src/scene.ts、src/archive-loop.ts
- 独立模型查看器与拆解动画:src/model-viewer.ts
- 模型解密轨迹与正文同步揭示:src/decryption.ts、src/document-decryption.ts
- 交互音效与三轨配乐:src/audio.ts、public/audio/
- 画质预设与渲染管线:src/render-quality.ts、src/quality-renderer.ts
- 视觉、相机、材质与运动约束基准:DESIGN.md
- 分阶段行为检查脚本:scripts/,对照验证记录在 verification/
三维模型本身是通过 Blender MCP 制作的,art/ 目录保留了完整的 Blender 源工程与生成脚本,例如基础模型工程 art/rhine-archive.blend 和可拆解模型 art/archive-assembly.blend,运行所需的 GLB 模型在 public/assets/。普通运行不需要安装 Blender。
档案内容:40 份可编辑的档案数据
全部档案数据集中存放在 content/archives.json,页面显示与文本下载共用同一份数据;档案类型与阵列位置映射见 src/data.ts,逐份导出的文本在 public/archives/。修改内容只需编辑 JSON,字段与操作步骤见 content/README.md:
npm run export:archives # 修改数据后重新生成 public/archives/ 中的文本
npm run check:content # 检查数据规则与导出一致性
每份档案包含设定参考链接,公开世界观资料出处记录在 reference/LORE-SOURCES.md。
许可与第三方资源说明
- RhineLabUI 的作者创作内容(代码、建模脚本、文档、Blender 工程、GLB 模型与原创配乐)统一采用 MIT License,详见 LICENSE;
- 字体使用小米官方 MiSans(许可见 public/fonts/MiSans-license.pdf),编号滚动使用 Rolling Number(public/licenses/rolling-number.txt);
- 《明日方舟》相关名称、标志、设定与原 PV 的权利归各自权利人所有,本项目为非官方复刻,不代原作者授权。
写在最后
RhineLabUI 是一个很适合学习"影视动效如何转化为实时 3D 网页"的开源项目:它用 TypeScript + Three.js 实现了逐帧校准的开场、循环阵列、同步解密与可拆解模型,并且把开发对照工具、验证脚本和 Blender 源工程全部公开。克隆下来跑 npm run dev,就能亲手把莱茵生命终端开起来。









