AnsysLink/USAGE_GUIDE.md

# CAE网格生成助手 - 使用指南

## 快速开始

### 方法1：快速启动（推荐）
```bash
python start.py
```

### 方法2：演示启动器
```bash
python scripts/demo_launcher.py
```

### 方法3：应用启动脚本
```bash
python scripts/run_app.py
```

### 方法4：开发模式
```bash
python app.py
```

## 系统要求

### 基本要求
- Python 3.8+
- 4GB+ RAM
- 1GB+ 可用磁盘空间

### 依赖包
```bash
pip install -r requirements.txt
```

### 可选组件
- ANSYS Mechanical 2023R1+ (用于真实网格生成)
- PyMechanical (ANSYS Python接口)

## 功能概览

### 1. 文件上传
- 支持格式：.step, .stp
- 最大文件大小：100MB
- 自动文件验证

### 2. 网格生成
- 自动几何识别
- 智能网格控制
- 实时进度监控

### 3. 质量检查
- 网格质量评估
- 详细质量报告
- 改进建议

### 4. 结果导出
- 网格文件下载
- 质量报告导出
- 可视化图像

## 详细使用步骤

### 步骤1：启动系统
1. 确保Python环境正确配置
2. 安装所需依赖包
3. 运行启动脚本
4. 在浏览器中访问 http://localhost:5000

### 步骤2：上传STEP文件
1. 点击上传区域或拖拽文件
2. 选择涡扇叶片STEP文件
3. 等待文件验证完成
4. 确认文件信息正确

### 步骤3：开始网格生成
1. 点击"开始生成"按钮
2. 观察处理进度和日志
3. 等待网格生成完成

### 步骤4：查看结果
1. 查看网格统计信息
2. 分析质量评估报告
3. 查看可视化结果
4. 下载所需文件

## 配置选项

### 环境变量
```bash
# Flask配置
export FLASK_ENV=development
export FLASK_DEBUG=1

# ANSYS配置
export ANSYS_VERSION=231
export ANSYS_ROOT="C:\Program Files\ANSYS Inc\v241"
```

### 配置文件
编辑 `config.py` 文件修改系统配置：
- 文件上传限制
- ANSYS设置
- 网格参数

## 故障排除

### 常见问题

#### 1. 依赖包安装失败
```bash
# 升级pip
python -m pip install --upgrade pip

# 使用国内镜像
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple/
```

#### 2. ANSYS连接失败
- 检查ANSYS是否正确安装
- 确认PyMechanical模块可用
- 检查许可证状态
- 尝试演示模式

#### 3. 文件上传失败
- 确认文件格式正确
- 检查文件大小限制
- 验证文件完整性

#### 4. 网格生成失败
- 检查几何文件质量
- 查看错误日志
- 尝试简单几何

### 日志查看
```bash
# 应用日志
tail -f app.log

# 错误日志
tail -f error.log
```

## 性能优化

### 系统优化
1. 确保足够的内存（推荐8GB+）
2. 使用SSD存储提高I/O性能
3. 关闭不必要的后台程序

### 文件优化
1. 使用高质量的STEP文件
2. 避免过于复杂的几何
3. 预处理几何文件

### 网格优化
1. 合理设置网格密度
2. 使用局部细化
3. 平衡质量和计算效率

## API接口

### 文件上传
```http
POST /api/upload
Content-Type: multipart/form-data
```

### 开始网格生成
```http
POST /api/mesh/generate
Content-Type: application/json
```

### 查询状态
```http
GET /api/mesh/status
```

### 获取结果
```http
GET /api/mesh/result
```

## 开发指南

### 项目结构
```
cae-mesh-generator/
├── app.py              # Flask应用入口
├── config.py           # 配置文件
├── requirements.txt    # 依赖列表
├── backend/           # 后端代码
├── templates/         # HTML模板
├── static/           # 静态资源
└── test/             # 测试文件
```

### 开发环境设置
```bash
# 创建虚拟环境
python -m venv venv

# 激活虚拟环境
# Windows
venv\Scripts\activate
# Linux/Mac
source venv/bin/activate

# 安装依赖
pip install -r requirements.txt

# 启动开发服务器
python app.py
```

### 测试
```bash
# 运行测试套件
python test_suite.py

# 运行集成测试
python test_integration.py
```

## 部署指南

### 开发部署
```bash
python run_app.py
```

### 生产部署
```bash
# 使用Gunicorn
pip install gunicorn
gunicorn -w 4 -b 0.0.0.0:5000 app:create_app()

# 使用uWSGI
pip install uwsgi
uwsgi --http :5000 --wsgi-file app.py --callable create_app()
```

### Docker部署
```dockerfile
FROM python:3.9
WORKDIR /app
COPY requirements.txt .
RUN pip install -r requirements.txt
COPY . .
EXPOSE 5000
CMD ["python", "run_app.py"]
```

## 安全注意事项

1. **文件上传安全**
   - 验证文件类型和大小
   - 扫描恶意内容
   - 隔离上传文件

2. **数据保护**
   - 定期清理临时文件
   - 保护敏感配置信息
   - 使用HTTPS传输

3. **访问控制**
   - 限制API访问频率
   - 实施用户认证
   - 记录操作日志

## 许可证

本项目采用MIT许可证。详见LICENSE文件。

## 支持与反馈

- 问题报告：创建GitHub Issue
- 功能建议：提交Pull Request
- 技术支持：查看文档或联系开发团队

---

**祝您使用愉快！**