# 环境配置功能说明

## 功能概述

新增了可视化的环境配置管理界面，用户可以通过UI界面配置系统的所有环境变量，无需手动编辑 `.env` 文件。

## 访问方式

在侧栏的"快捷导航"区域，点击 **⚙️ 环境配置** 按钮即可进入配置界面。

## 配置项说明

### 1. 基本配置（必需）

#### DeepSeek API配置
- **API密钥** (必填)
  - 描述：DeepSeek AI引擎的API密钥
  - 获取方式：访问 https://platform.deepseek.com
  - 注意：这是系统核心功能，必须配置才能使用AI分析

- **API地址** (可选)
  - 描述：DeepSeek API服务器地址
  - 默认值：`https://api.deepseek.com/v1`
  - 注意：一般无需修改

### 2. 数据源配置（可选）

#### Tushare数据接口
- **Token** (可选)
  - 描述：Tushare数据接口令牌
  - 获取方式：访问 https://tushare.pro
  - 作用：提供更丰富的A股财务数据
  - 注意：未配置时系统使用其他数据源

### 3. 量化交易配置（可选）

#### MiniQMT量化交易
- **启用开关**
  - 描述：是否启用MiniQMT量化交易功能
  - 默认：关闭

- **账户ID**
  - 描述：MiniQMT交易账户ID
  - 注意：仅在启用时需要配置

- **服务器地址**
  - 描述：MiniQMT服务器地址
  - 默认：`127.0.0.1`

- **服务器端口**
  - 描述：MiniQMT服务器端口
  - 默认：`58610`

- **⚠️ 警告**：量化交易涉及真实资金操作，请谨慎配置和使用！

### 4. 通知配置（可选）⭐新增

#### 📧 邮件通知
- **启用开关**
  - 描述：是否启用邮件通知功能
  - 默认：关闭
  - 适用：实时监测和智策定时分析

- **SMTP服务器地址**
  - 描述：邮件服务器地址
  - 示例：`smtp.qq.com`、`smtp.163.com`

- **SMTP端口**
  - 描述：邮件服务器端口
  - 默认：`587` (TLS) 或 `465` (SSL)

- **发件人邮箱**
  - 描述：发送通知的邮箱地址
  - 示例：`your-email@qq.com`

- **邮箱授权码**
  - 描述：SMTP服务授权码（不是登录密码）
  - 获取：邮箱设置 → SMTP服务 → 生成授权码

- **收件人邮箱**
  - 描述：接收通知的邮箱地址
  - 示例：`recipient@qq.com`

#### 📱 Webhook通知
- **启用开关**
  - 描述：是否启用Webhook通知功能
  - 默认：关闭
  - 适用：实时监测和智策定时分析

- **Webhook类型**
  - 描述：选择Webhook平台
  - 选项：钉钉 (`dingtalk`) 或 飞书 (`feishu`)

- **Webhook地址**
  - 描述：机器人Webhook URL
  - 钉钉示例：`https://oapi.dingtalk.com/robot/send?access_token=xxxxx`
  - 飞书示例：`https://open.feishu.cn/open-apis/bot/v2/hook/xxxxx`
  - 获取：群设置 → 群机器人 → 添加自定义机器人

**💡 提示**：
- 邮件和Webhook可以同时启用
- 配置后建议使用测试功能验证
- 详见《Webhook通知配置指南.md》

## 使用流程

1. **进入配置页面**
   - 点击侧栏的"⚙️ 环境配置"按钮

2. **修改配置**
   - 在相应标签页中填写或修改配置项
   - 必填项会有 `*` 标记
   - 密码类型的配置会以 `****` 显示

3. **保存配置**
   - 点击"💾 保存配置"按钮
   - 系统会验证配置的有效性
   - 验证通过后保存到 `.env` 文件

4. **生效配置**
   - 配置保存后会自动尝试重新加载
   - 建议重启应用以确保所有配置生效

## 功能特性

### ✅ 可视化配置
- 友好的UI界面
- 分类标签页组织
- 字段说明和帮助信息

### ✅ 安全性
- 密码字段自动隐藏
- API密钥部分隐藏显示
- 配置验证功能

### ✅ 便捷操作
- 实时配置预览
- 一键保存
- 一键重置
- 查看当前配置文件

### ✅ 智能提示
- 配置状态实时显示
- 获取API密钥的详细步骤
- 字段帮助信息

## 配置文件位置

配置保存在项目根目录的 `.env` 文件中：
```
D:\web\agentsstock1\.env
```

## 配置示例

```bash
# AI股票分析系统环境配置
# 由系统自动生成和管理

# ========== DeepSeek API配置 ==========
DEEPSEEK_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxx"
DEEPSEEK_BASE_URL="https://api.deepseek.com/v1"

# ========== Tushare数据接口（可选）==========
TUSHARE_TOKEN=""

# ========== MiniQMT量化交易配置（可选）==========
MINIQMT_ENABLED="false"
MINIQMT_ACCOUNT_ID=""
MINIQMT_HOST="127.0.0.1"
MINIQMT_PORT="58610"
```

## 注意事项

1. **API密钥安全**
   - 不要将 `.env` 文件提交到Git仓库
   - 不要分享你的API密钥给他人
   - 定期更换API密钥

2. **配置生效**
   - 修改配置后建议重启应用
   - 某些配置可能需要重新加载才能生效

3. **必填项**
   - DeepSeek API密钥是必填项
   - 其他配置项都是可选的

4. **量化交易**
   - 量化交易功能涉及真实资金
   - 使用前请充分测试
   - 谨慎配置交易参数

## 故障排查

### 问题1：保存配置失败

**解决方案**：
- 检查文件权限
- 确保项目目录可写
- 检查配置格式是否正确

### 问题2：配置不生效

**解决方案**：
- 重启应用
- 检查 `.env` 文件是否存在
- 查看控制台错误信息

### 问题3：API密钥验证失败

**解决方案**：
- 确认API密钥正确
- 检查API密钥是否过期
- 确认网络连接正常

## 技术实现

### 核心文件

1. **config_manager.py**
   - 配置管理器
   - 读取/保存 `.env` 文件
   - 配置验证

2. **app.py**
   - 配置界面
   - 用户交互
   - 状态管理

3. **config.py**
   - 加载环境变量
   - 提供配置访问接口

## 更新日期

2025年10月6日

## 作者

AI股票分析系统开发团队