增加龙虎榜批量分析功能，修复一些小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,212 @@
+# 实时监测定时自动启动/关闭功能说明
+
+## 功能概述
+
+实时监测板块新增了定时自动启动和关闭功能，可以在交易日的交易时间自动启动监测服务，在收盘后自动停止，无需手动干预。
+
+## 主要功能
+
+### 1. 智能交易时间识别
+- **自动识别交易日**: 系统会自动判断当前是否为交易日（默认为周一至周五）
+- **交易时间检测**: 实时检测当前是否在交易时间段内
+- **多市场支持**: 支持中国A股、美股、港股三个市场的交易时间
+
+### 2. 自动启动/停止
+- **定时启动**: 在开盘时间自动启动监测服务
+- **定时停止**: 在收盘时间自动停止监测服务（可选）
+- **智能检测**: 每分钟自动检测交易状态，实时调整监测状态
+
+### 3. 灵活配置
+- **市场选择**: 可选择 CN（中国A股）、US（美股）、HK（港股）
+- **交易日设置**: 自定义交易日（默认周一至周五）
+- **提前启动**: 可设置在开盘前提前启动（0-30分钟）
+- **延后停止**: 可设置在收盘后延后停止（0-30分钟）
+- **自动停止开关**: 可选择收盘后是否自动停止
+
+## 默认交易时间
+
+### 中国A股 (CN)
+- **上午**: 09:30 - 11:30
+- **下午**: 13:00 - 15:00
+- **交易日**: 周一至周五
+
+### 美股 (US)
+- **交易时间**: 21:30 - 04:00（北京时间）
+- **交易日**: 周一至周五
+
+### 港股 (HK)
+- **上午**: 09:30 - 12:00
+- **下午**: 13:00 - 16:00
+- **交易日**: 周一至周五
+
+## 使用方法
+
+### 1. 启用定时调度
+
+1. 进入 **股票监测管理** 页面
+2. 在监测服务状态下方找到 **⏰ 定时自动启动/关闭** 区域
+3. 点击展开 **⚙️ 定时调度设置**
+4. 勾选 **启用定时调度** 复选框
+
+### 2. 配置市场和时间
+
+**市场选择区域：**
+- 选择您要监测的市场（CN/US/HK）
+- 查看对应市场的交易时间
+- 自定义交易日（如需要）
+
+**调度参数区域：**
+- **启用定时调度**: 总开关
+- **收盘后自动停止**: 是否在交易时间结束后自动停止
+- **提前启动**: 在开盘前多少分钟启动（默认5分钟）
+- **延后停止**: 在收盘后多少分钟停止（默认5分钟）
+
+### 3. 保存并启动
+
+1. 配置完成后点击 **💾 保存设置**
+2. 点击 **▶️ 启动调度器** 按钮
+3. 系统将开始自动调度
+
+### 4. 状态监控
+
+在定时调度区域顶部可以看到实时状态：
+- **定时已启用/未启用**: 定时调度功能的启用状态
+- **调度器运行中/未运行**: 调度器的运行状态
+- **交易日/非交易日**: 当前日期是否为交易日
+- **交易时间内/下次交易时间**: 当前是否在交易时间，以及下次交易时间
+
+## 工作原理
+
+### 智能检测机制
+调度器每分钟执行一次检测：
+1. 检查当前是否为交易日
+2. 检查当前是否在交易时间内
+3. 如果在交易时间且监测服务未运行，则自动启动
+4. 如果不在交易时间且监测服务正在运行且启用了自动停止，则自动停止
+
+### 配置文件
+- 调度配置保存在 `monitor_schedule_config.json` 文件中
+- 支持手动编辑配置文件（不推荐）
+- 配置更改后需重启调度器生效
+
+## 配置文件示例
+
+```json
+{
+  "enabled": true,
+  "market": "CN",
+  "trading_hours": {
+    "CN": [
+      {"start": "09:30", "end": "11:30"},
+      {"start": "13:00", "end": "15:00"}
+    ],
+    "US": [
+      {"start": "21:30", "end": "04:00"}
+    ],
+    "HK": [
+      {"start": "09:30", "end": "12:00"},
+      {"start": "13:00", "end": "16:00"}
+    ]
+  },
+  "trading_days": [1, 2, 3, 4, 5],
+  "auto_stop": true,
+  "pre_market_minutes": 5,
+  "post_market_minutes": 5
+}
+```
+
+## 注意事项
+
+### 1. 独立运行
+- 定时调度器独立于手动启动/停止按钮
+- 即使调度器在运行，仍可手动控制监测服务
+- 手动操作不会影响调度器的自动检测
+
+### 2. 节假日处理
+- 当前版本仅支持按周几判断交易日
+- 不会自动识别法定节假日
+- 遇到节假日需要手动停止调度器或监测服务
+
+### 3. 性能影响
+- 调度器每分钟检测一次，资源消耗极低
+- 不会影响监测服务的正常运行
+- 建议在服务器或长期运行的电脑上使用
+
+### 4. 跨天交易
+- 支持跨天的交易时间（如美股）
+- 时间判断会自动处理跨天情况
+
+## 使用场景
+
+### 场景1: 上班族自动监测
+- 设置为中国A股市场
+- 启用定时调度
+- 工作日交易时间自动监测，下班后自动停止
+
+### 场景2: 24小时服务器运行
+- 根据关注的市场设置交易时间
+- 启用自动停止，节省服务器资源
+- 仅在交易时间运行监测
+
+### 场景3: 多市场混合监测
+- 如果监测多个市场的股票，选择主要市场
+- 或不启用自动停止，手动控制
+- 根据需要切换市场设置
+
+## 故障排查
+
+### 调度器无法启动
+1. 检查是否已启用定时调度
+2. 查看控制台是否有错误信息
+3. 尝试重启应用
+
+### 没有自动启动监测
+1. 确认调度器正在运行
+2. 检查当前是否为交易日和交易时间
+3. 查看配置是否正确保存
+
+### 配置无法保存
+1. 检查文件写入权限
+2. 查看是否有文件锁定
+3. 尝试手动删除配置文件重新生成
+
+## 技术说明
+
+### 核心文件
+- `monitor_scheduler.py`: 调度器核心模块
+- `monitor_service.py`: 监测服务（已集成调度器）
+- `monitor_manager.py`: UI管理界面（包含调度设置）
+- `monitor_schedule_config.json`: 配置文件（自动生成）
+
+### 依赖库
+- `schedule`: Python定时任务库
+- `threading`: 多线程支持
+
+### 扩展性
+代码设计支持以下扩展：
+- 添加更多市场
+- 自定义交易时间
+- 接入节假日API
+- 邮件/通知提醒
+
+## 更新日志
+
+### v1.0.0 (2024-10-16)
+- ✅ 初始版本发布
+- ✅ 支持中国A股、美股、港股三个市场
+- ✅ 实现交易日和交易时间自动判断
+- ✅ 支持自动启动和停止
+- ✅ 提供完整的UI配置界面
+- ✅ 智能检测机制，每分钟自动调整
+
+## 反馈与支持
+
+如有问题或建议，请：
+1. 检查本文档的故障排查部分
+2. 查看控制台输出的错误信息
+3. 提交问题反馈
+
+---
+
+**祝您使用愉快！** 🎉
+