增加龙虎榜批量分析功能，修复一些小bug

2025-10-20 15:40:14 +08:00
parent 1bddf393e0
commit b7a8bb10b3
60 changed files with 3579 additions and 883 deletions
@@ -0,0 +1,379 @@
+# 智策定时分析使用指南
+
+## 📋 功能概述
+
+智策定时分析功能允许您设置每天固定时间自动运行板块策略分析，并将核心分析结果通过邮件发送到指定邮箱。
+
+## ⚙️ 配置要求
+
+### 1. 邮件配置（必需）
+
+在 `.env` 文件中添加以下配置：
+
+```bash
+# 邮件通知配置
+EMAIL_ENABLED=true
+SMTP_SERVER=smtp.example.com
+SMTP_PORT=587
+EMAIL_FROM=your-email@example.com
+EMAIL_PASSWORD=your-email-password
+EMAIL_TO=recipient@example.com
+```
+
+### 2. 配置说明
+
+| 配置项 | 说明 | 示例 |
+|--------|------|------|
+| EMAIL_ENABLED | 是否启用邮件（true/false） | true |
+| SMTP_SERVER | SMTP服务器地址 | smtp.qq.com |
+| SMTP_PORT | SMTP端口（通常587或465） | 587 |
+| EMAIL_FROM | 发件人邮箱 | your@qq.com |
+| EMAIL_PASSWORD | 邮箱密码或授权码 | xxxx xxxx xxxx |
+| EMAIL_TO | 收件人邮箱（可多个，逗号分隔） | email1@qq.com,email2@gmail.com |
+
+### 3. 常见邮箱SMTP配置
+
+#### QQ邮箱
+```bash
+SMTP_SERVER=smtp.qq.com
+SMTP_PORT=587
+EMAIL_FROM=your@qq.com
+EMAIL_PASSWORD=授权码（不是QQ密码）
+```
+
+**获取QQ邮箱授权码：**
+1. 登录QQ邮箱网页版
+2. 设置 → 账户
+3. 开启 "POP3/SMTP服务"
+4. 生成授权码
+
+#### 163邮箱
+```bash
+SMTP_SERVER=smtp.163.com
+SMTP_PORT=587
+EMAIL_FROM=your@163.com
+EMAIL_PASSWORD=授权码
+```
+
+#### Gmail
+```bash
+SMTP_SERVER=smtp.gmail.com
+SMTP_PORT=587
+EMAIL_FROM=your@gmail.com
+EMAIL_PASSWORD=应用专用密码
+```
+
+#### 企业邮箱
+根据企业邮箱提供商的SMTP配置填写
+
+## 🚀 使用步骤
+
+### 1. 配置邮件
+
+编辑项目根目录的 `.env` 文件，添加上述邮件配置。
+
+### 2. 进入智策板块
+
+在侧边栏点击 **"🎯 智策板块"** 按钮
+
+### 3. 展开定时设置
+
+点击 **"⏰ 定时分析设置"** 展开器
+
+### 4. 检查邮件配置
+
+查看底部的 **"📧 邮件配置检查"** 区域：
+- ✅ 所有配置项都显示绿色勾号 → 配置正确
+- ❌ 有红色叉号 → 需要补充配置
+
+### 5. 测试邮件
+
+点击 **"📧 测试邮件"** 按钮：
+- 系统会发送一封测试邮件
+- 检查收件箱是否收到
+- 如果收到，说明配置正确
+
+### 6. 设置定时时间
+
+使用时间选择器设置每天运行的时间：
+- 默认：09:00（上午9点）
+- 建议：盘前（8:00-9:00）或盘后（15:30-17:00）
+
+### 7. 启动定时任务
+
+点击 **"▶️ 启动"** 按钮：
+- 系统显示 "✅ 定时任务运行中"
+- 显示下次运行时间
+
+### 8. 等待自动运行
+
+系统会在每天指定时间自动：
+1. 获取最新市场数据
+2. 运行AI智能体分析
+3. 生成板块预测
+4. 发送邮件到指定邮箱
+
+### 9. 查看邮件报告
+
+邮件包含：
+- 📋 板块多空预测
+- 🔄 板块轮动预测
+- 🔥 板块热度排行
+- 📊 策略总结
+
+## 💡 功能按钮说明
+
+### ▶️ 启动
+- 功能：启动定时任务
+- 状态：定时任务未运行时可用
+- 效果：每天定时运行分析并发送邮件
+
+### ⏹️ 停止
+- 功能：停止定时任务
+- 状态：定时任务运行中时可用
+- 效果：取消定时分析
+
+### 🔄 立即运行
+- 功能：手动触发一次分析
+- 状态：随时可用
+- 效果：立即运行分析并发送邮件（不影响定时任务）
+
+### 📧 测试邮件
+- 功能：发送测试邮件
+- 状态：随时可用
+- 效果：验证邮件配置是否正确
+
+## 📧 邮件内容
+
+### 邮件主题
+```
+智策板块分析报告 - 2024-01-15 09:00:00
+```
+
+### 邮件正文结构
+
+```
+============================================================
+智策板块策略分析报告
+============================================================
+分析时间: 2024-01-15 09:00:00
+AI模型: DeepSeek Multi-Agent System
+
+============================================================
+一、板块多空预测
+============================================================
+
+【看多板块】
+
+1. 电子 (信心度: 8/10)
+   理由: 政策支持，资金持续流入
+   风险: 估值偏高，注意回调风险
+
+2. ...
+
+【看空板块】
+...
+
+============================================================
+二、板块轮动预测
+============================================================
+
+【当前强势板块】
+...
+
+【潜力接力板块】⭐ 重点关注
+...
+
+============================================================
+三、板块热度排行
+============================================================
+
+【最热板块 TOP5】
+1. 电子 - 热度: 95分 (升温)
+...
+
+============================================================
+四、策略总结
+============================================================
+
+【市场观点】
+...
+
+【核心机会】⭐
+...
+
+【主要风险】⚠️
+...
+
+【整体策略】
+...
+
+============================================================
+本报告由智策AI系统自动生成并发送
+仅供参考，不构成投资建议
+============================================================
+```
+
+## 🎯 使用场景
+
+### 场景1：盘前策略
+- **设置时间**: 08:00
+- **目的**: 盘前获取当日策略建议
+- **用途**: 制定当日交易计划
+
+### 场景2：盘后复盘
+- **设置时间**: 16:00
+- **目的**: 盘后总结当日行情
+- **用途**: 评估当日决策，调整策略
+
+### 场景3：晚间研究
+- **设置时间**: 21:00
+- **目的**: 晚间深度研究
+- **用途**: 详细阅读分析，准备次日
+
+## ⚠️ 注意事项
+
+### 1. 邮件配置
+- ✅ 使用邮箱授权码，不是登录密码
+- ✅ 确保SMTP服务已开启
+- ✅ 防火墙允许SMTP端口
+
+### 2. 运行时间
+- 建议避开交易繁忙时段（9:30-15:00）
+- 盘前盘后数据更稳定
+- 夜间运行可能获取不到当日数据
+
+### 3. 分析时长
+- 完整分析需要2-3分钟
+- 数据获取30秒
+- AI分析1.5-2分钟
+- 邮件发送5秒
+
+### 4. 数据时效
+- 数据来源：AKShare（东方财富）
+- 延迟：< 1分钟
+- 盘后数据最完整
+
+### 5. 网络要求
+- 需要稳定的网络连接
+- 能访问东方财富数据源
+- SMTP端口未被阻止
+
+## 🔧 故障排除
+
+### 问题1：邮件配置不完整
+**现象**: 配置检查显示红色叉号
+
+**解决**:
+1. 检查 `.env` 文件是否存在
+2. 确认所有配置项都已填写
+3. 重启应用使配置生效
+
+### 问题2：测试邮件发送失败
+**现象**: 点击测试邮件后提示失败
+
+**解决**:
+1. 确认邮箱密码是授权码而不是登录密码
+2. 检查SMTP服务器地址是否正确
+3. 确认SMTP服务已在邮箱中开启
+4. 检查防火墙是否阻止了SMTP端口
+
+### 问题3：定时任务未运行
+**现象**: 到了设定时间但没有收到邮件
+
+**解决**:
+1. 检查定时任务状态是否为"运行中"
+2. 查看系统日志是否有错误信息
+3. 确认系统时间是否正确
+4. 重启定时任务
+
+### 问题4：数据获取失败
+**现象**: 邮件中显示"数据获取失败"
+
+**解决**:
+1. 检查网络连接
+2. 稍后重试（可能是数据源繁忙）
+3. 避开交易高峰时段
+
+### 问题5：AI分析失败
+**现象**: 邮件中显示"AI分析失败"
+
+**解决**:
+1. 检查DeepSeek API配置
+2. 确认API额度充足
+3. 查看系统日志了解详细错误
+
+## 📊 日志查看
+
+### 控制台日志
+运行 `streamlit run app.py` 后，在控制台可以看到：
+
+```
+[智策定时] 定时任务已启动，每天 09:00 运行
+[智策定时] 后台线程已启动
+
+# 到达定时时间后
+============================================================
+[智策定时] 开始定时分析 - 2024-01-15 09:00:00
+============================================================
+[智策定时] [1/3] 获取市场数据...
+[智策定时] ✓ 数据获取成功
+[智策定时] [2/3] AI智能体分析中...
+[智策定时] ✓ 分析完成
+[智策定时] [3/3] 发送邮件通知...
+[智策定时] ✓ 邮件发送成功
+============================================================
+[智策定时] ✓ 定时分析完成！
+============================================================
+```
+
+## 🎓 最佳实践
+
+### 1. 时间设置
+- **盘前用户**: 08:00-08:30（获取前一日数据+当日预判）
+- **盘后用户**: 15:30-16:00（当日收盘数据）
+- **研究用户**: 20:00-21:00（晚间详细研究）
+
+### 2. 邮件管理
+- 创建文件夹"智策报告"
+- 设置邮件规则自动归档
+- 定期清理过期报告
+
+### 3. 报告使用
+- 重点关注"潜力接力板块"
+- 对比历史报告验证准确性
+- 结合自己的判断决策
+
+### 4. 配合使用
+- 定时分析：宏观趋势把握
+- 手动分析：重点板块深挖
+- PDF导出：长期存档对比
+
+## 🔄 更新说明
+
+### v1.0.0 (当前版本)
+- ✅ 基础定时任务功能
+- ✅ 邮件通知发送
+- ✅ 核心分析结果推送
+- ✅ 手动触发功能
+- ✅ 邮件配置检查
+
+### 计划功能
+- 🔲 多个定时任务（早中晚）
+- 🔲 邮件包含图表
+- 🔲 微信通知支持
+- 🔲 短信通知支持
+- 🔲 Webhook集成
+
+## 📞 技术支持
+
+如遇问题，请：
+1. 查看本指南的故障排除章节
+2. 检查系统日志获取详细错误
+3. 确认邮件配置正确性
+4. 测试网络连接稳定性
+
+---
+
+**智策定时分析** - 让AI每天为您工作！📊⏰
+