# neg-3darchives

**Repository Path**: zxyys/neg-3darchives

## Basic Information

- **Project Name**: neg-3darchives
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-27
- **Last Updated**: 2026-04-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 国家能源集团 3D 数字档案馆（演示版）

基于 Vue3 + Vite + Three.js 的 3D 数字档案馆展示项目（第一里程碑）。

## 技术栈

- Vue 3
- Vite
- Three.js
- Element Plus
- Pinia

## 运行方式

```bash
npm install
npm run dev
```

## 模型文件说明

- 通过 `public/models/folders.json` 配置要批量加载的模型子文件夹。
- 每个子文件夹按同名约定放模型文件，例如：`1L/1L.glb`、`1L/1L.fbx` 或 `1L/1L.obj + 1L.mtl`。
- 贴图统一放在 `public/models/textures`。
- 加载优先级：`glb` -> `fbx` -> `obj+mtl/obj` -> 立方体兜底。

## 当前项目结构

```text
neg-3darchives/
├─ public/
│  ├─ favicon.svg
│  ├─ icons.svg
│  └─ models/
│     ├─ 1L/
│     │  ├─ 1L.mtl
│     │  └─ 1L.obj
│     ├─ 2L/
│     │  ├─ 2L.mtl
│     │  └─ 2L.obj
│     ├─ 3L/
│     │  ├─ 3L.mtl
│     │  └─ 3L.obj
│     ├─ 4L/
│     │  ├─ 4L.mtl
│     │  └─ 4L.obj
│     ├─ 5L/
│     │  ├─ 5L.mtl
│     │  └─ 5L.obj
│     ├─ 6L/
│     │  ├─ 6L.mtl
│     │  └─ 6L.obj
│     ├─ WD/
│     │  ├─ WD.mtl
│     │  └─ WD.obj
│     ├─ textures/
│     │  ├─ men-50.jpg
│     │  ├─ mzb000001.jpg
│     │  ├─ M_3D66_SU_1577764301552_001.jpg
│     │  ├─ Polished_Concrete_Old.jpg
│     │  └─ QX112BT048.jpg
│     ├─ .gitkeep
│     └─ folders.json
├─ src/
│  ├─ assets/
│  │  └─ hero.png
│  ├─ components/
│  │  └─ ThreeViewer.vue
│  ├─ App.vue
│  ├─ main.js
│  └─ style.css
├─ index.html
├─ package.json
├─ vite.config.js
└─ README.md
```