122 lines
2.0 KiB
Markdown
122 lines
2.0 KiB
Markdown
|
# 🚀 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。
|
|||
|
|
|
|||
|
|
祝学习愉快！🎓
|