Hongru
7edbda02f6
- 添加时域分析、频域分析、根轨迹分析功能 - 集成 AI 智能问答（DeepSeek/Gemini API） - 现代化 UI 设计，支持 LaTeX 公式渲染 - 完整的项目文档和配置文件
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。
|
||
|
||
祝学习愉快！🎓
|