# 新能源汽车工程专业模型库

汽车工程作为学院范围，本轮优先新能源汽车及相关储能、车网互动与氢能。当前共9个方向、56个场景：保留12个已有独立场景，44个可运行基础版，共7,186个独立对象。本次在首批50个场景基础上新增6个场景、1,804个独立对象。具体范围以随包目录为准。

你选择的交付路线是：先按系统批量铺全可运行基础模型，再逐批精修到极细。总览卡片明确区分“可运行基础版”“已有独立总成”和“极细版”。基础版不是电影制作级资产或工程计算软件。

## 打开与使用

本机当前预览入口为 [新能源工程巨幕首页](http://127.0.0.1:8766/automotive/index.html)。首页将武汉理工大学矢量标识融入顶部版式，以可交互的三维整车底盘作为主展台；“专业模型库”进入完整目录 `models.html`。完整包解压后，使用包根目录的启动脚本或运行 `python3 start.py`，启动器会选择可用本机端口并打开首页；便携包不固定使用8766，请以启动窗口显示的网址为准。服务只监听本机，运行时不需要连接互联网。保持启动终端开启；关闭终端后服务停止。

批量基础版采用共享查看器与独立GLB文件，因此要通过本地服务打开，不能直接双击HTML文件。原有独立总成页面继续保留自包含形式。电脑需要支持WebGL的浏览器；源码重建才需要Node.js依赖。

1. 首页可选择整车、电池、电驱、热管理和充电系统聚焦，点击“进入拆装”打开对应工作台。九个专业方向可进入已筛选的模型目录；“巨幕模式”用于大屏展示，“暂停光效”可停止展示动效。具体操作见《巨幕首页说明》。
2. 在专业模型库中，按左侧专业方向筛选，搜索名称、课程或模块；可按完成层级筛选、按零件数或名称排序。星标可收藏常用模型，“继续上次探索”返回最近打开的模型。筛选保存在网址中，从工作台返回时会恢复。
3. 进入模型后，拖动旋转、滚轮缩放；从目录或三维视图选择零件。
4. “取出零件”“单独查看”“隐藏零件”“零件复位”操作当前对象。F 或“聚焦零件”将镜头对准选择；“撤销”/“撤销拆装”或 Ctrl/⌘ Z 撤销最近的零件操作，Esc 退出摄影棚或单件模式，再次按下取消选择。“恢复全部”恢复装配、视角和参数。
5. “内部结构”隐藏预设外壳；“爆炸拆解”按模块展开。基础版不提供任意平面剖切。
6. 调整输入，点击“启动演示”。“本版范围”说明实际已实现的计算；学科目录中的目标仿真描述是后续精修路线，二者不要混读。
7. “摄影棚”放大画面并环绕观察，“保存画面”导出PNG。

## 模型与仿真范围

基础版使用参数化几何：相同系统共用设计规则，不同场景根据能源支路、齿数组合、结构布置或工艺变体生成。每个已登记零件有独立编号和拆卸方向；一个整体翅片组、轮胎、皮带或壳体上的表面细节不另计为独立零件。

这些结构不是原厂CAD，没有经过制造尺寸、装配公差、强度或量产性能验收。当前材料是实时PBR表现。电气安全、制造、试验等课程中的基础仿真以场景内“本版范围”为准，不代表完整感知规划控制、碰撞求解、化学安全、工艺仿真或实物硬件在环能力。

原有电驱、热泵、制动、EPS等独立工作台保留其各自更详细的模型、运行操作和范围说明。底盘复用的1,940个总成对象在专业库总数中只计算一次。

本次新增光储充、V2G/V2H、液冷储能柜、PEM电解制氢、加氢站和轴向磁通电机，可通过[本批六场景目录](models.html?q=新能源拓展)打开。输入、读数与计算边界见[新能源拓展六场景说明](新能源拓展六场景说明.md)。V2H目前只有家庭接口结构示意；光伏面积和电池容量是总系统等效教学参数，不从代表性网格、板块或电池盒数量反推。六个新场景均为可拆教学基础版，尚未通过电影级视觉最终验收。

## 批量生成与精修

`source/course-models-a.mjs` 和 `course-models-b.mjs` 是16类参数化模板；`学科模型目录.json` 是课程、结构变体和参数清单。`generate-course.mjs` 批量生成独立模型与零件元数据，`build-course-pages.cjs` 构建共享查看器、总览数据和巨幕展示脚本。`source/catalog-page.js` 管理目录检索、收藏和返回状态，`source/showcase-page.js` 管理首页交互，`source/showcase-scene.js` 构建三维主展台，`assets` 保存首页几何和品牌资源。

本批专用结构位于 `source/course-models-stations.mjs` 和 `source/course-models-hydrogen-axial.mjs`；六场景计算位于 `source/energy-expansion-simulation.mjs`，由原仿真入口按模型ID委托。旋转慢放只改变画面相位，不改变秒、kW、kWh或质量积分。

在source目录执行 `npm install`，随后执行 `npm run build`。指定模型重建可执行 `node generate-course.mjs .. --models=traction_inverter,dc_fast_charger`，然后执行 `node build-course-pages.cjs`。新增模板需要先实现对应结构与计算，再登记到目录；更改目录名称不会自动产生新的结构。

源码依赖Three.js 0.180.0与esbuild 0.25.0。MIT许可随包保留。独立总成库另外提供自己的建模源码；便携重建时应保持automotive和library两个文件夹的相对位置。

精修按系统推进：补充真实零件层级与连接约束，增加局部结构、材料和工况，检查后提升完成层级。数据接口和OEM尺寸需要对应设备资料后另行接入。

## 检查记录

最终数量、GLB校验、编号与目录一致性、数值端点检查，以及实际浏览器抽查范围保存于reports目录。自动文件检查覆盖批量模型，浏览器以代表性结构抽查；没有将未进行的逐场景人工视觉验收记为完成。

本批已生成[模型与资产检查](reports/energy-expansion-assets.json)和[仿真守恒与回归检查](reports/energy-expansion-simulation-check.json)。这两份报告分别记录资产有效性与数值计算结果，不代表六场景逐项浏览器视觉验收或电影级最终验收。