feat: add case demo module and streamline Model assets

README.md

@@ -1,8 +1,8 @@
 # 🎛️ 自动控制原理AI+数智平台
 
-> 交互式控制系统分析与设计工具 | 时域·频域·根轨迹·AI问答
+> 交互式控制系统分析与设计工具 | 时域·频域·根轨迹·算例演示·AI问答
 
-一个基于 Gradio 构建的现代化自动控制原理学习平台，集成了系统分析工具和 AI 智能问答功能。
+一个基于 Gradio 构建的现代化自动控制原理学习平台，集成了系统分析工具、完整混动模型算例演示与 AI 智能问答功能。
 
 ## ✨ 核心功能
 
@@ -54,7 +54,14 @@
 - s 平面稳定性区域
 - 阻尼比等值线
 
-### 🤖 4. AI 智能问答 (Q&A)
+### 🧪 4. 算例演示 (Case Demo)
+
+- **完整混动模型**：调用 `Model/src/series_hybrid_sim.py` 进行系统级仿真
+- **参数化工况**：支持工况模板、仿真时长、步长、SOC、初始发动机功率与缩放系数
+- **图文结果**：输出三联图（转速响应/功率分配/电气状态）与关键数据表
+- **教学解读**：自动生成指标摘要（最大转速误差、SOC变化、平均功率与燃油流量）
+
+### 🤖 5. AI 智能问答 (Q&A)
 
 - **专业教学助手**：精通自动控制原理的 AI 教授
 - **流式响应**：实时显示 AI 回复过程
@@ -62,14 +69,13 @@
 - **上下文记忆**：支持多轮对话
 
 **支持的 API**：
-- DeepSeek API（推荐，国内网络友好）
-- Google Gemini API
+- DeepSeek API
 
 ## 🚀 快速开始
 
 ### 环境要求
 
-- Python 3.8+
+- Python 3.10+
 - pip 包管理器
 
 ### 安装步骤
@@ -84,20 +90,20 @@ cd AutoControl
 2. **安装依赖**
 
 ```bash
-pip install gradio numpy control matplotlib aiohttp
+pip install -r requirements.txt
 ```
 
 或使用 conda：
 
 ```bash
-conda create -n autocontrol python=3.9
+conda create -n autocontrol python=3.10
 conda activate autocontrol
-pip install gradio numpy control matplotlib aiohttp
+pip install -r requirements.txt
 ```
 
 3. **配置 API 密钥**
 
-编辑 `app.py` 文件开头的配置区域：
+编辑 `config.py` 文件中的配置区域：
 
 ```python
 # ==================== API 配置 ====================
@@ -240,27 +246,28 @@ AI 回复中的数学公式会自动渲染，支持以下格式：
 
 ## 📁 项目结构
 
-```
-AutoControl/
-├── app.py                 # 主应用程序
-├── README.md             # 项目文档
-├── API_CONFIG.md         # API 配置详细说明（可选）
-├── QUICK_START.md        # 快速入门指南（可选）
-└── requirements.txt      # 依赖列表（可选）
+```text
+AutoControlCourse/
+├── app.py                     # Gradio 入口与事件绑定
+├── ui_components.py           # 各标签页 UI 组件
+├── analysis_functions.py      # 时域/频域/根轨迹计算
+├── case_demo_functions.py     # 算例演示模块（调用 Model）
+├── chatbot.py                 # AI 问答
+├── user_stats.py              # 在线人数统计
+├── config.py                  # API 与运行配置
+├── Model/
+│   ├── src/                   # 混动模型核心代码
+│   └── data/                  # 运行所需模型权重与数据
+└── requirements.txt           # 依赖列表
 ```
 
 ## 🔧 高级配置
 
-### 切换到 Gemini API
+### 算例演示说明
 
-如果您想使用 Google Gemini API：
-
-```python
-API_KEY = "your-gemini-api-key"
-API_BASE_URL = "https://generativelanguage.googleapis.com/v1beta"
-API_MODEL = "gemini-1.5-flash"
-API_TYPE = "gemini"
-```
+- 仿真时长是模型时间，不等于程序实际等待时间
+- 电池功率符号定义：正值放电，负值充电
+- 若参数超限，程序会在安全范围内自动裁剪
 
 ### 自定义系统提示词
 
@@ -333,4 +340,4 @@ ax.grid(True, alpha=0.3, linestyle='--')
 
 **⭐ 如果这个项目对您有帮助，请给它一个 Star！**
 
-最后更新：2025年10月15日
+最后更新：2026年4月7日