# 🚀 5分钟快速上手指南

本指南帮助您快速配置并运行自动控制原理AI+数智平台。

## ⚡ 快速开始（3 步完成）

### 步骤 1：安装依赖

```bash
pip install gradio numpy control matplotlib aiohttp
```

### 步骤 2：配置 API

编辑 `app.py` 第 24 行，填入您的 DeepSeek API 密钥：

```python
API_KEY = "sk-your-api-key-here"  # 替换为您的密钥
```

**获取密钥**：访问 https://platform.deepseek.com/api_keys

### 步骤 3：运行应用

```bash
python app.py
```

浏览器会自动打开 http://localhost:7860

---

## 🎯 第一次使用

### 试试时域分析

1. 在"时域分析"标签页
2. 输入传递函数：
   - 分子：`1`
   - 分母：`1,2,1`
3. 点击"开始分析"
4. 观察阶跃响应曲线和性能指标

### 试试 AI 问答

1. 切换到"智能问答"标签页
2. 输入问题：`什么是 PID 控制器？`
3. 点击"发送"
4. AI 会实时回复并渲染数学公式

---

## 💡 常用传递函数示例

### 一阶系统
```
分子: 1
分母: 1,1
G(s) = 1/(s+1)
```

### 二阶欠阻尼系统
```
分子: 4
分母: 1,2,4
G(s) = 4/(s²+2s+4)
阻尼比 ζ = 0.5，超调量约 16%
```

### 三阶系统
```
分子: 1
分母: 1,6,11,6
G(s) = 1/[(s+1)(s+2)(s+3)]
```

---

## 🔧 故障排查

### 问题 1：模块导入错误

```
ModuleNotFoundError: No module named 'gradio'
```

**解决**：重新安装依赖
```bash
pip install -r requirements.txt
```

### 问题 2：API 密钥错误

```
❌ 错误：API_KEY 未配置
```

**解决**：确认 `app.py` 第 24 行已填入有效密钥

### 问题 3：中文乱码

**解决**：确保终端支持 UTF-8 编码
```powershell
# Windows PowerShell
chcp 65001
```

---

## 📚 下一步

- 阅读完整 [README.md](README.md)
- 查看 [API 配置详细说明](API_CONFIG.md)
- 探索四大功能模块
- 调整系统增益观察变化

---

**需要帮助？** 查看 [常见问题](API_CONFIG.md#常见问题) 或提交 Issue。

祝学习愉快！🎓