# 自动刷新功能说明

## 功能概述

在缠论分析系统中新增了自动刷新功能，允许用户设置定时自动刷新数据，实时监控市场变化。

## 功能特性

### 1. 自动刷新控制
- **启用/禁用开关**: 通过勾选框控制自动刷新的开启和关闭
- **智能状态管理**: 启用时激活相关控件，禁用时自动禁用下拉菜单

### 2. 刷新间隔设置
支持以下刷新间隔选项：
- 5秒
- 10秒  
- 15秒 (默认)
- 30秒
- 1分钟
- 5分钟

### 3. 实时状态显示
- **刷新状态**: 显示当前自动刷新的启用状态和间隔设置
- **下次刷新时间**: 显示预计下次刷新的时间
- **更新时间**: 在统计信息中显示最后更新的时间
- **更新方式**: 区分手动刷新和自动刷新

## 界面布局

新增的自动刷新控制面板位于原有控制面板下方，包含：

```
┌─ 自动刷新控制行 ─────────────────────────────────────┐
│ [自动刷新:]     [刷新间隔:]     [刷新状态:]   [下次刷新:] │
│ ☐ 启用自动刷新   [15秒 ▼]      未启用        --        │
└──────────────────────────────────────────────────────┘
```

启用自动刷新后：
```
┌─ 自动刷新控制行 ─────────────────────────────────────┐
│ [自动刷新:]     [刷新间隔:]          [刷新状态:]   [下次刷新:] │
│ ☑ 启用自动刷新   [15秒 ▼]      已启用-每15秒刷新  14:30:45   │
└──────────────────────────────────────────────────────┘
```

## 使用方法

### 1. 启用自动刷新
1. 勾选"启用自动刷新"复选框
2. 刷新状态会显示为"已启用 - 每X秒刷新"
3. 刷新间隔下拉菜单变为可用状态

### 2. 设置刷新间隔
1. 确保自动刷新已启用
2. 在"刷新间隔"下拉菜单中选择所需的时间间隔
3. 状态文字会立即更新显示新的间隔

### 3. 开始自动刷新
1. 首次需要点击"获取数据并分析"按钮获取初始数据
2. 之后系统会根据设定的间隔自动刷新数据
3. 自动刷新时会保持所有其他设置参数不变

### 4. 监控刷新状态
- 查看"下次刷新时间"了解预计刷新时间
- 在统计信息中查看"最后更新"时间
- "更新方式"会显示是"自动刷新"还是"手动刷新"

## 技术实现

### 1. 组件结构
- `dcc.Checklist`: 自动刷新开关
- `dcc.Dropdown`: 刷新间隔选择
- `dcc.Interval`: 定时器组件
- `dcc.Store`: 存储自动刷新设置
- `html.Div`: 状态显示组件

### 2. 回调函数
- `control_auto_refresh`: 控制自动刷新功能的启用/禁用
- `update_next_refresh_time`: 更新下次刷新时间显示
- `analyze_data_with_auto_refresh`: 处理自动刷新触发的数据分析

### 3. 状态管理
- 自动刷新设置存储在 `auto-refresh-settings` Store中
- 定时器组件的enabled状态根据设置动态切换
- 刷新间隔实时更新定时器的interval属性

## 测试验证

### 手动测试步骤
1. 访问 http://localhost:8051
2. 查看自动刷新控制面板是否正常显示
3. 测试启用/禁用自动刷新功能
4. 测试不同刷新间隔的设置
5. 验证自动刷新是否按设定间隔工作
6. 检查状态显示是否准确更新

### 预期行为
- 初始状态：未启用，下拉菜单禁用
- 启用后：状态更新，下拉菜单可用
- 更改间隔：状态文字立即更新
- 自动刷新：数据按间隔自动更新
- 保持设置：其他参数在自动刷新时不变

## 注意事项

1. **首次使用**: 启用自动刷新后需要先手动获取一次数据
2. **网络连接**: 自动刷新依赖网络连接，连接异常时可能失败
3. **性能影响**: 短间隔刷新可能增加服务器负载
4. **浏览器要求**: 需要JavaScript支持，建议使用现代浏览器
5. **数据一致性**: 自动刷新会保持所有分析参数设置不变

## 故障排除

### 自动刷新不工作
- 检查是否已勾选"启用自动刷新"
- 确认已先进行过一次手动数据获取
- 查看浏览器控制台是否有错误信息

### 状态显示异常
- 刷新页面重新加载组件
- 检查网络连接是否正常
- 确认后端服务是否正常运行

### 刷新间隔不准确
- 网络延迟可能影响实际刷新间隔
- 数据处理时间会额外增加总耗时
- 建议设置不小于5秒的刷新间隔