From e907c0d58c990cca07612d0ed55249c227b8a3ab Mon Sep 17 00:00:00 2001 From: oficcejo Date: Wed, 15 Oct 2025 09:39:58 +0800 Subject: [PATCH] =?UTF-8?q?readme=E6=99=BA=E7=AD=96=E6=9B=B4=E6=96=B0?= =?UTF-8?q?=E8=AF=B4=E6=98=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 288 +++++++++++++++++++++++++++++++++++++++++++++++++----- 1 file changed, 266 insertions(+), 22 deletions(-) diff --git a/README.md b/README.md index a384d45..a2d09bc 100644 --- a/README.md +++ b/README.md @@ -9,7 +9,30 @@ 01 02 -## ✨1015 更新说明（最新） +## ✨1015 更新说明 + +### 🎯 智策板块分析系统 ⭐️ +- **多AI智能体协同**：四位专业分析师团队协同工作 + - 🌐 宏观策略师：分析经济政策、新闻事件 + - 📊 板块诊断师：分析板块走势、估值、轮动 + - 💰 资金流向分析师：跟踪主力资金、北向资金 + - 📈 市场情绪解码员：量化市场情绪、识别热点 +- **三维度预测体系**： + - 板块多空预测：看多/看空板块推荐（含信心度） + - 板块轮动预测：强势/潜力/衰退板块判断 + - 板块热度排行：最热/升温/降温板块TOP榜 +- **定时分析功能** ⭐️： + - 每日自动运行分析，无需手动触发 + - 支持邮件+Webhook双通道推送 + - 灵活设置运行时间（盘前/盘后/晚间） + - 手动触发和状态监控 +- **数据来源**：AKShare免费数据（行情、资金、新闻） +- **AI模型**：DeepSeek Chat / Reasoner双模型 +- **报告导出**：支持PDF格式完整报告 +- **使用场景**：盘前策略、板块轮动、风险规避 + +智策板块分析界面 + ### 🔔 新增Webhook通知功能 ⭐️ - **多平台支持**：支持钉钉、飞书群机器人推送通知 - **全面集成**：实时监测、智策定时分析均支持Webhook推送 @@ -97,6 +120,31 @@ 6. 🎯 操作建议和风险提示 7. 📄 PDF报告导出 +### 🎯 智策板块分析（全新功能）⭐️ +- **四位AI智能体团队**： + - 🌐 宏观策略师：分析国际国内新闻、宏观经济、政策导向 + - 📊 板块诊断师：深入分析板块走势、估值水平、轮动特征 + - 💰 资金流向分析师：跟踪主力资金、北向资金的板块流向 + - 📈 市场情绪解码员：量化市场情绪、识别热点和恐慌信号 +- **三维预测体系**： + - **板块多空预测**：推荐看多/看空板块（5-8个看多，3-5个看空） + - **板块轮动预测**：识别强势/潜力/衰退板块及轮动逻辑 + - **板块热度排行**：最热TOP5、升温TOP5、降温TOP3 +- **定时分析+自动推送** ⭐️： + - 设置每天固定时间自动运行（盘前8:00/盘后16:00/晚间21:00） + - 支持邮件+Webhook双通道推送核心策略 + - 手动触发和状态实时监控 +- **完整数据源**： + - 行业/概念板块实时行情 + - 主力资金多日流向（今日/3日/5日/10日） + - 北向资金历史趋势 + - 东方财富财经快讯（150条） +- **AI模型切换**： + - deepseek-chat：标准模型，速度快 + - deepseek-reasoner：推理增强，分析深度更高 +- **PDF报告导出**：完整分析报告，支持存档和分享 +- **使用场景**：盘前策略制定、板块轮动捕捉、风险规避决策 + ### 🔥 批量分析功能（新增）⭐️ - **批量输入支持**：一次性输入多只股票代码 - **两种分析模式**： @@ -308,7 +356,7 @@ cp .env.example .env # DeepSeek API配置（必需） DEEPSEEK_API_KEY=your_actual_deepseek_api_key_here -# 邮件通知配置（可选） +# 邮件通知配置（可选）- 用于实时监测和智策定时分析 EMAIL_ENABLED=false SMTP_SERVER=smtp.qq.com SMTP_PORT=587 @@ -316,7 +364,7 @@ EMAIL_FROM=your_email@qq.com EMAIL_PASSWORD=your_authorization_code EMAIL_TO=receiver@example.com -# Webhook通知配置（可选）⭐️ 新增 +# Webhook通知配置（可选）⭐️ 新增 - 用于实时监测和智策定时分析 WEBHOOK_ENABLED=false WEBHOOK_TYPE=dingtalk # 或 feishu WEBHOOK_URL=your_webhook_url_here @@ -425,6 +473,107 @@ streamlit run app.py - 批量分析时间较长，请耐心等待 - 可在历史记录中查看所有分析结果 +### 智策板块分析使用流程 ⭐️ 全新功能 +1. **进入智策板块** + - 点击侧边栏"🎯 智策板块"按钮 + +2. **选择AI模型** + - **deepseek-chat**：标准模型，速度快（2-3分钟） + - **deepseek-reasoner**：推理增强模型，分析深度更高（3-5分钟） + +3. **开始分析** + - 点击"🚀 开始智策分析"按钮 + - 系统自动执行： + - 获取市场数据（30秒） + - 四位AI智能体并行分析（1.5-2分钟） + - 综合研判（30秒） + - 生成预测报告 + +4. **查看分析结果** + 分析完成后，查看四个标签页： + + - **📋 核心预测**： + - 板块多空预测（看多/看空/中性） + - 板块轮动预测（强势/潜力/衰退） + - 板块热度排行（最热/升温/降温） + - 策略总结（观点、机会、风险、策略） + + - **🤖 智能体分析**： + - 宏观策略师报告 + - 板块诊断师报告 + - 资金流向分析师报告 + - 市场情绪解码员报告 + + - **📊 综合研判**： + - 团队综合讨论结果 + - 多维度分析整合 + + - **📈 数据可视化**： + - 板块多空信心度对比图 + - 板块热度分布图 + +5. **导出PDF报告** + - 点击"📥 生成PDF报告"按钮 + - 等待生成（3-5秒） + - 点击"💾 下载PDF"保存 + +6. **配置定时分析** ⭐️ + 展开"⏰ 定时分析设置"： + + **步骤1：配置邮件/Webhook** + - 方法A：在"⚙️ 环境配置" → "📢 通知配置"中设置 + - 方法B：编辑.env文件配置 + + **步骤2：设置运行时间** + - 选择每天运行时间（默认9:00） + - 建议时间： + - 盘前：8:00-8:30（制定当日策略） + - 盘后：16:00-17:00（总结当日行情） + - 晚间：21:00-22:00（深度研读分析） + + **步骤3：启动定时任务** + - 点击"▶️ 启动定时任务" + - 系统显示"✅ 定时任务已启动" + - 每天自动运行并推送结果 + + **步骤4：测试功能** + - 点击"🔄 立即运行一次"测试 + - 检查邮箱/钉钉/飞书是否收到报告 + + **步骤5：管理任务** + - 查看运行状态和上次运行时间 + - 需要时可点击"⏹️ 停止定时任务" + +7. **使用技巧** + - **最佳使用时间**：盘前8:30-9:30或盘后15:30-20:00 + - **关注信心度**：≥8分为高信心，可重点关注 + - **结合轮动**：重点关注"潜力接力板块"，最佳布局时机 + - **热度判断**：升温板块有机会，降温板块注意风险 + - **四维共振**：宏观、基本面、资金、情绪共振时信号更强 + +8. **通知内容示例** + + **邮件/Webhook推送内容**： + ``` + 智策板块分析报告 - 2024-01-15 09:00 + + 📊 板块多空 + 【看多】人工智能(8分)、新能源汽车(8分)、半导体(7分) + 【看空】地产开发(7分) + + 🔄 潜力接力板块 ⭐ 重点关注 + • 半导体：关注突破信号 + • 军工：情绪升温，把握机会 + + 🌡️ 热度TOP3 + 1. 人工智能 - 95分 + 2. 新能源汽车 - 92分 + 3. 半导体 - 88分 + + 💡 核心机会 + 重点关注人工智能、新能源汽车产业链... + ``` + ### 主力选股功能使用流程 ⭐️ 新增 1. **进入主力选股** - 点击侧边栏"🎯 主力选股"按钮 @@ -622,24 +771,35 @@ WEBHOOK_KEYWORD=股票 ``` AI股票分析系统 -├── app.py # Streamlit主界面 -├── stock_data.py # 股票数据获取模块 -├── deepseek_client.py # DeepSeek API客户端 -├── ai_agents.py # AI智能体分析模块 -├── monitor_manager.py # 监测管理界面 -├── monitor_service.py # 监测服务后台 -├── monitor_db.py # 监测数据库管理 -├── notification_service.py # 通知服务（邮件/界面） -├── miniqmt_interface.py # MiniQMT量化交易接口 ⭐️ -├── pdf_generator.py # PDF报告生成 -├── database.py # 分析记录数据库 -├── config.py # 配置文件 -├── requirements.txt # 依赖包列表 -├── run.py # 启动脚本 -├── Dockerfile # Docker镜像构建文件 🐳 -├── docker-compose.yml # Docker编排配置文件 🐳 -├── .dockerignore # Docker构建忽略文件 🐳 -└── DOCKER_DEPLOYMENT.md # Docker部署详细文档 🐳 +├── app.py # Streamlit主界面 +├── stock_data.py # 股票数据获取模块 +├── deepseek_client.py # DeepSeek API客户端 +├── ai_agents.py # AI智能体分析模块 +├── monitor_manager.py # 监测管理界面 +├── monitor_service.py # 监测服务后台 +├── monitor_db.py # 监测数据库管理 +├── notification_service.py # 通知服务（邮件/Webhook/界面）⭐️ +├── config_manager.py # 配置管理模块 ⭐️ +├── miniqmt_interface.py # MiniQMT量化交易接口 ⭐️ +├── sector_strategy_data.py # 智策数据采集模块 ⭐️ +├── sector_strategy_agents.py # 智策AI智能体团队 ⭐️ +├── sector_strategy_engine.py # 智策分析引擎 ⭐️ +├── sector_strategy_scheduler.py # 智策定时任务调度器 ⭐️ +├── sector_strategy_ui.py # 智策界面模块 ⭐️ +├── sector_strategy_pdf.py # 智策PDF报告生成 ⭐️ +├── main_force_selector.py # 主力选股数据获取 +├── main_force_analysis.py # 主力选股AI分析 +├── main_force_ui.py # 主力选股界面 +├── main_force_pdf_generator.py # 主力选股报告生成 +├── pdf_generator.py # PDF报告生成 +├── database.py # 分析记录数据库 +├── config.py # 配置文件 +├── requirements.txt # 依赖包列表 +├── run.py # 启动脚本 +├── Dockerfile # Docker镜像构建文件 🐳 +├── docker-compose.yml # Docker编排配置文件 🐳 +├── .dockerignore # Docker构建忽略文件 🐳 +└── DOCKER_DEPLOYMENT.md # Docker部署详细文档 🐳 ``` ### 核心模块说明 @@ -698,6 +858,50 @@ AI股票分析系统 - **通知历史管理**：完整记录和查询 - **配置测试功能**：一键测试邮件和Webhook +#### 🎯 智策板块分析模块 ⭐️ 全新功能 +**sector_strategy_data.py** +- AKShare数据采集和整合 +- 行业/概念板块行情数据 +- 主力资金流向数据（今日/3日/5日/10日） +- 北向资金历史趋势 +- 东方财富财经快讯（150条） +- 市场统计数据（涨跌家数、涨停跌停） + +**sector_strategy_agents.py** +- 四位AI智能体实现 +- 🌐 宏观策略师：政策和新闻分析 +- 📊 板块诊断师：板块走势和估值分析 +- 💰 资金流向分析师：资金流动分析 +- 📈 市场情绪解码员：情绪量化分析 + +**sector_strategy_engine.py** +- 多智能体协同引擎 +- 并行分析处理 +- 综合研判机制 +- 三维预测生成（多空/轮动/热度） + +**sector_strategy_scheduler.py** ⭐️ +- 定时任务调度（基于schedule库） +- 后台daemon线程运行 +- 手动触发分析 +- 状态监控和查询 +- 邮件+Webhook自动推送 +- 错误通知处理 + +**sector_strategy_ui.py** +- 智策板块主界面 +- AI模型选择 +- 分析进度显示 +- 四个结果标签页展示 +- 定时分析设置面板 +- PDF报告导出功能 + +**sector_strategy_pdf.py** +- PDF报告生成（基于ReportLab） +- 完整分析内容格式化 +- 中文字体支持 +- 专业排版设计 + #### 🎯 主力选股模块 ⭐️ 新增 **main_force_selector.py** - 问财数据获取（主力资金净流入） @@ -886,6 +1090,38 @@ DEFAULT_INTERVAL = "1d" # 默认数据间隔 - 查看终端日志了解详细错误信息 - **详细文档**：查看 `Webhook通知配置指南.md` 获取完整配置教程 +11. **智策板块分析问题** ⭐️ 全新功能 + - **数据获取失败**： + - 检查网络连接是否稳定 + - AKShare数据源可能暂时不可用，稍后重试 + - 查看终端日志确认具体错误信息 + - **AI分析超时或失败**： + - 检查DeepSeek API Key是否有效 + - 确认API余额充足 + - deepseek-reasoner模型较慢（3-5分钟），请耐心等待 + - 可切换到deepseek-chat模型（2-3分钟） + - **定时任务未运行**： + - 确认程序持续运行（本地部署不要关闭窗口） + - 检查定时任务状态是否显示"✅ 运行中" + - 验证系统时间是否正确 + - 点击"🔄 立即运行一次"测试 + - **邮件/Webhook未收到**： + - 检查通知配置是否完整（邮箱或Webhook） + - 使用"📧 测试邮件"或"📱 测试Webhook"验证 + - 查看垃圾邮件箱 + - 查看终端日志确认发送状态 + - **PDF生成失败**： + - 确认已安装reportlab库：`pip install reportlab` + - 检查系统是否有足够磁盘空间 + - 查看终端错误信息 + - **ModuleNotFoundError: schedule**： + - 安装依赖：`pip install schedule` + - 或：`.\venv\Scripts\pip.exe install schedule` + - **详细文档**： + - [智策板块使用指南.md](智策板块使用指南.md) + - [智策定时分析使用指南.md](智策定时分析使用指南.md) + - [智策功能总览.md](智策功能总览.md) + ### 日志调试 系统运行时会在控制台输出详细日志，可用于问题诊断。如遇到错误，请查看终端输出。 @@ -906,11 +1142,19 @@ docker logs -f agentsstock1 - [Webhook自定义关键词功能说明.md](Webhook自定义关键词功能说明.md) - 关键词配置指南 - [邮件配置指南.md](邮件配置指南.md) - 邮件通知配置 +**智策板块分析文档** ⭐️： +- [智策功能总览.md](智策功能总览.md) - 智策系统全景介绍 +- [智策板块使用指南.md](智策板块使用指南.md) - 完整使用教程 +- [智策板块快速开始.md](智策板块快速开始.md) - 5分钟快速上手 +- [智策定时分析使用指南.md](智策定时分析使用指南.md) - 定时分析详细指南 +- [智策定时分析功能完成说明.md](智策定时分析功能完成说明.md) - 功能详细说明 +- [智策定时分析部署清单.md](智策定时分析部署清单.md) - 部署步骤和故障排查 +- [智策定时分析更新日志.md](智策定时分析更新日志.md) - 版本历史 + **其他功能文档**： - [环境配置功能说明.md](环境配置功能说明.md) - 完整环境配置说明 - [环境配置快速指南.md](环境配置快速指南.md) - 快速配置参考 - [实时监测优化说明.md](实时监测优化说明.md) - 实时监测功能详解 -- [智策定时分析使用指南.md](智策定时分析使用指南.md) - 智策板块分析 - [主力选股使用指南.md](主力选股使用指南.md) - 主力选股功能 - [量化交易快速指南.md](量化交易快速指南.md) - MiniQMT集成指南 - [DOCKER_DEPLOYMENT.md](DOCKER_DEPLOYMENT.md) - Docker部署详细文档