# 新能源工程课程知识库

首批选择《动力电池与电池管理》《新能源汽车电机与电驱动》，与门户 Porsche Taycan 的电池／电驱系统入口联动。

## 使用

- 启动原项目服务，打开 `/automotive/knowledge.html`。
- 选课程 → 阅读知识 → 进入三维拆解或仿真 → 点击“返回课程知识”。
- 两门课程均新增 `virtual-lab.html` 虚拟实验台。每门课程关联6项实验，其中共享整车能量流实验只计为一项引擎实验；全局共11项唯一实验。支持参数与故障切换、0.5～8倍模拟时间、实时曲线、正常/故障对照、CSV数据和JSON实验记录导出。3D复用精修GLB；轴向电机按明确旋转metadata以1/120慢放，其他场景用于结构观察。
- 虚拟实验记录保存在当前浏览器，最多保留最近18次；未接入成绩系统。公式校核只判断模拟记录的一致性，实验任务勾选是自主记录。
- 全局搜索覆盖两门课程的标题、正文、公式、关键词和实验；可用 URL 分享到具体章节。
- 自测提供答案解析；阅读进度仅保存在当前浏览器本地，无账号或后台同步。
- `index.json` 为站内结构化知识库；`courses/*.json` 是内容维护源文件；同名 Markdown 为可读导出。
- `courses/*-assignment-templates.md` 由课程 JSON 自动生成，供教师备课、审阅量规与离线留档。
- `knowledge-base.jsonl` 为知识章节、实训、自测与正式作业的独立检索条目，含课程 ID、模型 ID、数据包和来源。可导入后续检索系统；本版为本地关键词检索，尚未接入外部向量库或大模型问答。
- `datasets/` 提供可重复生成的示范课教学数据与校验清单；均为合成或代理数据，并明确记录来源和模型边界。
- JSON 中的本地 URL 以 `/automotive/knowledge.html` 为基准；Markdown 的站内链接以站点根目录为基准。

## 内容边界与维护

项目自编基础课程知识，依据公开官方资料和本项目源码组织，非武汉理工大学官方教学大纲。门户采用Porsche Taycan外观，内部结构与仿真为通用教学版本；不将参数归于保时捷原厂。

每门课程为8个基础章节、6项实训、8题自测和4个正式作业模板，建议16学时，不代表整学期课程覆盖。两门示范课均提供CLO、分层路径、交付物、评分量规、来源和模型边界；引用为公开官方背景资料或当前项目方程，课程文字为自编讲解。

修改 `courses/*.json` 后运行 `python3 source/build-knowledge.py` 生成索引和文档。模型按现有资产 ID 关联，页面直接复用既有预览，不复制 GLB、不重渲染。

本次知识库新增文件未写入之前已交付的全阶段压缩包；以当前项目目录为准。