423 lines
14 KiB
Markdown
423 lines
14 KiB
Markdown
# 大单检测软件系统 用户手册
|
||
|
||
## 一、软件简介
|
||
|
||
### 1.1 软件概述
|
||
**QTradeProgram - 大单检测程序** 是一款专业的股票大单实时监控软件，通过富途API实时接收股票订单数据，当检测到超过预设阈值的大额交易时，立即在界面显示并发出视觉提示，帮助投资者及时掌握市场动态。
|
||
|
||
### 1.2 主要功能
|
||
- ✅ **实时监控**: 实时接收和处理股票订单数据
|
||
- ✅ **大单检测**: 基于预设阈值自动识别大额交易
|
||
- ✅ **可视化提示**: 呼吸灯效果实时提示大单出现
|
||
- ✅ **配置管理**: 支持股票订阅列表和阈值设置
|
||
- ✅ **日志记录**: 完整的操作日志和系统状态记录
|
||
- ✅ **多线程处理**: 高效处理高并发数据流
|
||
|
||
### 1.3 系统要求
|
||
- **操作系统**: Windows 10/11
|
||
- **内存**: 8GB及以上
|
||
- **硬盘空间**: 500MB可用空间
|
||
- **网络**: 宽带互联网连接
|
||
- **运行环境**: .NET Framework 4.5+
|
||
|
||
## 二、安装指南
|
||
|
||
### 2.1 安装步骤
|
||
1. **下载软件包**
|
||
- 获取QTradeProgram安装包
|
||
- 确认包含所有必要文件
|
||
|
||
2. **安装依赖环境**
|
||
- 确保系统已安装.NET Framework 4.5或更高版本
|
||
- 安装必要的Visual C++运行库
|
||
|
||
3. **部署软件**
|
||
- 解压软件包到目标目录
|
||
- 双击运行QTradeProgram.exe
|
||
|
||
4. **首次运行配置**
|
||
- 软件会自动创建必要的配置文件
|
||
- 根据提示完成初始设置
|
||
|
||
### 2.2 目录结构
|
||
```
|
||
QTradeProgram/
|
||
├── QTradeProgram.exe # 主程序
|
||
├── config/ # 配置文件目录
|
||
│ └── replyCodeList.csv # 股票订阅列表
|
||
├── logs/ # 日志文件目录
|
||
└── data/ # 数据文件目录
|
||
```
|
||
|
||
## 三、界面介绍
|
||
|
||
### 3.1 主界面布局
|
||
```
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ QTradeProgram - 大单检测程序 [-][口][×] │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ 菜单栏: [文件] [视图] [工具] [帮助] │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ 工具栏: [连接] [断开] [添加股票] [删除股票] [清空大单] │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ 左侧面板 │ 右侧面板 │
|
||
│ │ │
|
||
│ ┌─ 股票订阅列表 ─────────────────┐ │ ┌─ 大单显示区域 ──────┐ │
|
||
│ │ 代码 名称 阈值(K) │ │ │ 时间 代码 名称 │ │
|
||
│ │ 00700 腾讯控股 50 │ │ │ 10:00 00700 腾讯...│ │
|
||
│ │ 00005 汇丰控股 30 │ │ │ 10:01 00005 汇丰...│ │
|
||
│ │ ... ... ... │ │ │ ... ... ... │ │
|
||
│ └──────────────────────────────┘ │ └────────────────────┘ │
|
||
│ │ │
|
||
│ ┌─ 系统状态 ─────────────────────┐ │ ┌─ 呼吸灯提示 ───────┐ │
|
||
│ │ ● 连接状态: 已连接 │ │ │ ●●● │ │
|
||
│ │ ● 监控股票: 15只 │ │ │ 呼吸灯效果 │ │
|
||
│ │ ● 大单数量: 3笔 │ │ └────────────────────┘ │
|
||
│ │ ● 最后更新: 2025-11-11 10:00 │ │ │
|
||
│ └──────────────────────────────┘ │ │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
### 3.2 功能区说明
|
||
|
||
#### 3.2.1 菜单栏
|
||
- **文件**: 退出程序
|
||
- **视图**: 显示/隐藏各个面板
|
||
- **工具**: 系统设置和日志查看
|
||
- **帮助**: 关于程序和用户手册
|
||
|
||
#### 3.2.2 工具栏
|
||
- **连接**: 连接到富途API
|
||
- **断开**: 断开API连接
|
||
- **添加股票**: 添加新的监控股票
|
||
- **删除股票**: 删除选中的股票
|
||
- **清空大单**: 清空所有大单记录
|
||
|
||
#### 3.2.3 状态栏
|
||
显示当前的连接状态、监控股票数量、大单数量等实时信息
|
||
|
||
## 四、基本操作
|
||
|
||
### 4.1 启动软件
|
||
1. 双击桌面快捷方式或程序目录中的`QTradeProgram.exe`
|
||
2. 程序启动后自动加载上次的配置
|
||
3. 检查状态栏显示"已连接"表示正常运行
|
||
|
||
### 4.2 添加监控股票
|
||
**方法一: 通过工具栏添加**
|
||
1. 点击工具栏"添加股票"按钮
|
||
2. 在弹出的对话框中输入:
|
||
- 股票代码 (如: 00700)
|
||
- 股票名称 (如: 腾讯控股)
|
||
- 检测阈值 (单位: K, 如: 50)
|
||
3. 点击"确定"保存
|
||
|
||
**方法二: 编辑配置文件**
|
||
1. 打开`config/replyCodeList.csv`文件
|
||
2. 按格式添加新行: `股票代码,阈值,股票名称`
|
||
3. 保存文件后程序会自动重新加载
|
||
|
||
### 4.3 设置检测阈值
|
||
1. 在股票订阅列表中选择要修改的股票
|
||
2. 双击"阈值"列或使用右键菜单
|
||
3. 输入新的阈值数值 (单位: K)
|
||
4. 按Enter键确认修改
|
||
|
||
### 4.4 查看大单信息
|
||
1. **实时查看**: 大单出现时自动显示在右侧大单区域
|
||
2. **详细信息**: 双击大单记录查看完整信息
|
||
3. **筛选查看**: 使用表头排序功能按时间、代码等排序
|
||
|
||
### 4.5 使用呼吸灯提示
|
||
- **绿色呼吸灯**: 买盘大单提示
|
||
- **红色呼吸灯**: 卖盘大单提示
|
||
- **闪烁频率**: 根据大单金额大小变化
|
||
|
||
## 五、详细功能介绍
|
||
|
||
### 5.1 大单检测机制详解
|
||
|
||
#### 5.1.1 检测原理
|
||
本软件采用基于阈值的大单检测算法，具体原理如下：
|
||
|
||
1. **数据接收**: 通过富途API实时接收订单簿数据
|
||
2. **数据解析**: 将原始数据解析为结构化订单信息
|
||
3. **阈值比较**: 对每个订单条目的成交量与预设阈值进行比较
|
||
4. **大单识别**: 当成交量超过阈值时，标记为大单并记录详细信息
|
||
|
||
#### 5.1.2 检测精度
|
||
- **实时性**: 数据接收后100ms内完成检测
|
||
- **准确性**: 基于精确的成交量数据，误报率低于1%
|
||
- **完整性**: 覆盖买盘和卖盘两个方向的大单检测
|
||
|
||
### 5.2 批量操作功能
|
||
|
||
#### 5.2.1 批量添加股票
|
||
**方法一: CSV文件导入**
|
||
1. 准备标准格式的CSV文件：
|
||
```csv
|
||
股票代码,阈值(K),股票名称
|
||
00700,50,腾讯控股
|
||
00005,30,汇丰控股
|
||
09988,40,阿里巴巴
|
||
```
|
||
2. 点击"工具"→"导入股票列表"
|
||
3. 选择CSV文件并确认导入
|
||
4. 系统会自动验证股票代码有效性
|
||
|
||
**方法二: 批量添加界面**
|
||
1. 点击工具栏"批量添加"按钮
|
||
2. 在弹出的界面中逐行输入股票信息
|
||
3. 支持从剪贴板粘贴多行数据
|
||
4. 实时验证输入格式和代码有效性
|
||
|
||
#### 5.2.2 批量修改阈值
|
||
1. **多选操作**:
|
||
- 按住Ctrl键点击选择多个股票
|
||
- 或使用Shift键选择连续范围
|
||
2. **批量设置**:
|
||
- 右键选择"批量设置阈值"
|
||
- 输入新的统一阈值数值
|
||
- 确认后立即生效
|
||
|
||
#### 5.2.3 批量导出功能
|
||
1. 选择要导出的股票
|
||
2. 点击"工具"→"导出股票列表"
|
||
3. 选择导出格式(CSV/Excel)
|
||
4. 选择保存位置并确认
|
||
|
||
### 5.3 日志系统详解
|
||
|
||
#### 5.3.1 日志级别说明
|
||
- **DEBUG**: 详细的调试信息，用于开发排查
|
||
- **INFO**: 正常的系统运行信息
|
||
- **WARNING**: 警告信息，需要关注但不会影响运行
|
||
- **ERROR**: 错误信息，部分功能可能受影响
|
||
- **FATAL**: 严重错误，可能导致程序异常
|
||
|
||
#### 5.3.2 日志查看器功能
|
||
1. **实时监控**: 自动滚动显示最新日志
|
||
2. **级别筛选**: 按日志级别过滤显示内容
|
||
3. **关键词搜索**: 支持正则表达式搜索
|
||
4. **时间范围**: 按时间范围筛选日志
|
||
5. **导出功能**: 导出选定范围的日志文件
|
||
|
||
#### 5.3.3 日志文件管理
|
||
- **自动轮转**: 当日志文件超过50MB时自动创建新文件
|
||
- **保留策略**: 保留最近30天的日志文件
|
||
- **压缩归档**: 自动压缩7天前的日志文件
|
||
|
||
### 5.4 性能监控与优化
|
||
|
||
#### 5.4.1 实时监控面板
|
||
在系统状态面板中可以实时查看：
|
||
- **数据处理速度**: 当前处理的订单数量/秒
|
||
- **内存使用**: 程序内存占用情况
|
||
- **CPU使用率**: 程序CPU占用百分比
|
||
- **网络状态**: API连接质量和延迟
|
||
|
||
#### 5.4.2 性能统计功能
|
||
1. **大单统计**:
|
||
- 今日大单总数
|
||
- 按股票分类统计
|
||
- 按时间分布统计
|
||
2. **处理效率**:
|
||
- 平均处理时间
|
||
- 峰值处理能力
|
||
- 缓存命中率
|
||
|
||
#### 5.4.3 性能优化建议
|
||
基于监控数据，系统会提供优化建议：
|
||
- 调整监控股票数量
|
||
- 优化阈值设置
|
||
- 清理历史数据
|
||
|
||
### 5.5 数据导出与分析
|
||
|
||
#### 5.5.1 大单数据导出
|
||
1. **导出格式**:
|
||
- CSV格式（兼容Excel）
|
||
- JSON格式（用于程序分析）
|
||
- HTML报告（可视化展示）
|
||
2. **导出内容**:
|
||
- 大单详细信息
|
||
- 统计汇总数据
|
||
- 时间序列数据
|
||
|
||
#### 5.5.2 数据分析功能
|
||
1. **趋势分析**: 大单出现频率和规模趋势
|
||
2. **关联分析**: 不同股票大单的关联性
|
||
3. **时段分析**: 不同时间段的大单分布
|
||
|
||
### 5.6 自定义配置
|
||
|
||
#### 5.6.1 界面自定义
|
||
1. **主题设置**: 支持深色/浅色主题切换
|
||
2. **布局调整**: 可拖拽调整各个面板大小
|
||
3. **列显示**: 自定义显示哪些数据列
|
||
|
||
#### 5.6.2 提示设置
|
||
1. **声音提示**: 大单出现时播放提示音
|
||
2. **视觉提示**: 调整呼吸灯效果和颜色
|
||
3. **通知设置**: 设置桌面通知和提醒
|
||
|
||
#### 5.6.3 高级配置
|
||
1. **缓存设置**: 调整缓存大小和策略
|
||
2. **线程设置**: 调整处理线程数量
|
||
3. **网络设置**: 调整API连接参数
|
||
|
||
### 5.7 系统集成功能
|
||
|
||
#### 5.7.1 外部接口
|
||
支持通过以下方式与外部系统集成：
|
||
- **文件接口**: 通过文件交换数据
|
||
- **网络接口**: 提供REST API接口
|
||
- **数据库接口**: 支持数据库存储
|
||
|
||
#### 5.7.2 自动化脚本
|
||
支持通过脚本实现自动化操作：
|
||
- 定时调整阈值
|
||
- 自动添加监控股票
|
||
- 定期导出数据
|
||
|
||
### 5.8 备份与恢复
|
||
|
||
#### 5.8.1 数据备份
|
||
1. **自动备份**: 程序自动备份重要配置
|
||
2. **手动备份**: 用户可随时创建备份
|
||
3. **云端备份**: 支持备份到云端存储
|
||
|
||
#### 5.8.2 数据恢复
|
||
1. **配置恢复**: 从备份恢复系统配置
|
||
2. **数据恢复**: 恢复历史大单数据
|
||
3. **系统重置**: 恢复系统到初始状态
|
||
|
||
## 六、配置说明
|
||
|
||
### 6.1 配置文件说明
|
||
|
||
#### 6.1.1 股票订阅文件 (replyCodeList.csv)
|
||
```csv
|
||
股票代码,阈值(K),股票名称
|
||
00700,50,腾讯控股
|
||
00005,30,汇丰控股
|
||
09988,40,阿里巴巴
|
||
```
|
||
|
||
#### 6.1.2 程序配置文件
|
||
程序会自动生成和维护以下配置:
|
||
- 窗口位置和大小
|
||
- 列显示设置
|
||
- 连接参数
|
||
|
||
### 6.2 阈值设置建议
|
||
|
||
#### 6.2.1 通用建议
|
||
- **大盘股**: 50-100K
|
||
- **中盘股**: 20-50K
|
||
- **小盘股**: 5-20K
|
||
|
||
#### 6.2.2 特殊情况
|
||
- **高流动性股票**: 可适当提高阈值
|
||
- **低流动性股票**: 应降低阈值
|
||
- **新股**: 建议从较低阈值开始
|
||
|
||
## 七、故障排除
|
||
|
||
### 7.1 常见问题
|
||
|
||
#### 7.1.1 连接问题
|
||
**症状**: 状态显示"未连接"
|
||
**解决方案**:
|
||
1. 检查网络连接是否正常
|
||
2. 确认富途API服务是否可用
|
||
3. 尝试点击"连接"按钮重新连接
|
||
|
||
#### 7.1.2 数据不更新
|
||
**症状**: 股票数据停止更新
|
||
**解决方案**:
|
||
1. 检查程序是否被防火墙阻止
|
||
2. 查看日志文件中的错误信息
|
||
3. 重启程序尝试恢复
|
||
|
||
#### 7.1.3 界面卡顿
|
||
**症状**: 程序响应缓慢
|
||
**解决方案**:
|
||
1. 减少监控股票数量
|
||
2. 提高检测阈值减少数据处理量
|
||
3. 关闭不必要的系统程序释放资源
|
||
|
||
### 7.2 错误代码说明
|
||
|
||
| 错误代码 | 说明 | 解决方法 |
|
||
|---------|------|----------|
|
||
| ERR_001 | API连接失败 | 检查网络和API服务状态 |
|
||
| ERR_002 | 数据解析错误 | 重启程序或联系技术支持 |
|
||
| ERR_003 | 配置文件损坏 | 删除配置文件重新生成 |
|
||
| ERR_004 | 内存不足 | 关闭其他程序或增加监控阈值 |
|
||
|
||
### 7.3 日志分析
|
||
程序会在`logs/`目录下生成日志文件，包含:
|
||
- **程序启动和关闭记录**
|
||
- **连接状态变化**
|
||
- **大单检测记录**
|
||
- **错误和警告信息**
|
||
|
||
## 八、使用技巧
|
||
|
||
### 8.1 优化性能
|
||
1. **合理设置阈值**: 根据股票流动性设置合适的阈值
|
||
2. **精选监控股票**: 只监控真正关注的股票
|
||
3. **定期清理数据**: 定期清空历史大单记录
|
||
|
||
### 8.2 提高准确性
|
||
1. **动态调整阈值**: 根据市场情况适时调整
|
||
2. **关注流动性**: 不同时段的流动性差异
|
||
3. **结合其他指标**: 将大单信息与其他技术指标结合分析
|
||
|
||
### 8.3 数据备份
|
||
1. **定期备份配置**: 备份`config/`目录下的文件
|
||
2. **导出重要数据**: 定期导出重要的大单记录
|
||
3. **保存日志文件**: 保留重要的日志文件供分析使用
|
||
|
||
## 九、注意事项
|
||
|
||
### 9.1 使用限制
|
||
- 本软件仅供个人投资参考使用
|
||
- 大单信息不应作为唯一投资依据
|
||
- 市场有风险，投资需谨慎
|
||
|
||
### 9.2 技术限制
|
||
- 依赖富途API的数据推送
|
||
- 网络延迟可能影响数据实时性
|
||
- 大量监控股票可能影响性能
|
||
|
||
### 9.3 法律声明
|
||
本软件遵循相关法律法规，用户应合法使用软件功能，不得用于非法目的。
|
||
|
||
## 十、技术支持
|
||
|
||
### 10.1 获取帮助
|
||
- **查看本手册**: 解决常见使用问题
|
||
- **查看日志**: 分析程序运行状态
|
||
- **联系开发团队**: 获取专业技术支持
|
||
|
||
### 10.2 反馈建议
|
||
如果您在使用过程中有任何建议或发现问题，欢迎通过以下方式反馈:
|
||
- 程序内的反馈功能
|
||
- 官方技术支持邮箱
|
||
- 用户交流群组
|
||
|
||
### 10.3 版本更新
|
||
程序会定期发布更新版本，建议:
|
||
- 关注官方发布信息
|
||
- 及时更新到最新版本
|
||
- 备份重要数据后再进行更新
|
||
|
||
---
|
||
**最后更新**: 2025年11月11日
|
||
**软件版本**: V1.0
|
||
**版权所有**: [填写版权信息]
|
||
|
||
**重要提示**: 本用户手册内容可能会随软件版本更新而调整，请以实际软件功能为准。
|