Files
QTradeProgram/用户手册.md
2026-02-25 23:01:42 +08:00

14 KiB
Raw Blame History

大单检测软件系统 用户手册

一、软件简介

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文件
股票代码,阈值(K),股票名称
00700,50,腾讯控股
00005,30,汇丰控股
09988,40,阿里巴巴
  1. 点击"工具"→"导入股票列表"
  2. 选择CSV文件并确认导入
  3. 系统会自动验证股票代码有效性

方法二: 批量添加界面

  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)

股票代码,阈值(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
版权所有: [填写版权信息]

重要提示: 本用户手册内容可能会随软件版本更新而调整,请以实际软件功能为准。