================================================================================
                        交易助手EA 使用说明 (v1.1)
================================================================================

【1. 核心功能概览】
-------------------------------------------------------------------------------
① 价格触发自动开仓（预设价格挂单）
② 智能仓位管理（固定模式 / 亏损加仓算法模式）
③ 自动止盈止损设置与维护
④ 平仓后交易冷却控制
⑤ ZigZag指标极值点分析（辅助判断趋势方向）


【2. ZigZag指标分析功能】← ★★★ 重点说明 ★★★
-------------------------------------------------------------------------------
【功能位置】面板左上角"★相邻极值点涨跌分析★"区域

【数据来源】自动调用图表中的ZigZag指标（需提前安装）

【显示内容】逐行显示最近10个极值点的详细数据：
            格式示例：极值0：1.12345  上涨：0.00250  (0.22%)
            含义说明：
            - "极值0"：距离当前最近的一个极值点
            - "极值1"：往前推一个极值点  ...  极值9：最远的极值点
            - "上涨/下跌"：相邻两个极值点的价格差方向
            - "0.00250"：具体的价格差值
            - "(0.22%)"：涨跌幅占前一个极值点的百分比

【颜色标识】红色文字 = 当前段为上涨趋势
            绿色文字 = 当前段为下跌趋势

【实战应用】如何利用这个功能判断趋势：
  ① 观察颜色连续性：
     - 连续出现多个红色 → 处于上升趋势中
     - 连续出现多个绿色 → 处于下跌趋势中
     - 红绿交替频繁 → 处于震荡行情，不宜追单

  ② 观察涨跌幅变化：
     - 涨幅逐渐缩小 → 上涨动能减弱，可能即将回调
     - 跌幅逐渐缩小 → 下跌动能减弱，可能即将反弹
     - 突然出现大幅波动 → 行情加速，可顺势跟进

  ③ 识别支撑阻力：
     - 多个极值点价格接近 → 形成强支撑/阻力位
     - 突破最近极值点 → 趋势可能延续或反转

【注意】ZigZag指标为滞后指标，反映的是已发生的价格转折，
        建议结合K线形态和其他指标综合判断。


【3. 面板各区域详细说明】
-------------------------------------------------------------------------------
┌─────────────────────────────────────────────────┐
│  ★相邻极值点涨跌分析★        ← ZigZag分析区  │
│  极值0：1.12345  上涨：0.00250 (0.22%)        │
│  极值1：1.12095  下跌：0.00120 (0.11%)        │
│  ...（共显示10个极值点）                       │
├─────────────────────────────────────────────────┤
│  多单输入框1：[    ]  空单输入框5：[    ]      │  ← 价格触发区
│  多单输入框2：[    ]  空单输入框6：[    ]      │     （输入目标价格）
│  多单输入框3：[    ]  空单输入框7：[    ]      │
│  多单输入框4：[    ]  空单输入框8：[    ]      │
├─────────────────────────────────────────────────┤
│  止损点：500  盈亏比：3：1  下次手数：0.01     │  ← 状态信息区
│  允许最大亏损次数：8  当前次数：0              │
│  间隔时间：剩余3分钟                           │
├─────────────────────────────────────────────────┤
│  [现价多单]  [现价空单]  [关闭]                │  ← 操作按钮区
├─────────────────────────────────────────────────┤
│  点击访问天机跟单官网：https://...             │  ← 顶部导航
└─────────────────────────────────────────────────┘


【4. 关键输入参数详解】
-------------------------------------------------------------------------------
【交易控制类】
下单模式       : 固定模式=始终用固定手数；算法模式=根据亏损动态加仓。
下单量         : 基础手数（固定模式用此值，算法模式为计算基数）。
算法次数       : 每N次亏损为一轮加仓周期（例：2表示每2次亏损为一轮）。
算法倍数       : 一轮结束后手数放大倍数（例：2表示手数×2）。
最大连损       : 最大连续亏损容忍次数，达到后重置手数计算。

【风控参数类】
止损点         : 开仓后的止损点数（以品种点数为单位）。
盈亏比         : 止盈点数是止损点数的倍数（例：3表示止盈=止损×3）。
止盈滑点       : 判断历史订单是否止盈的容差（点）。
输入框浮动点   : 触发挂单的价格容差（±点数），防止因点差错过进场。
滑点           : 市价单成交允许的最大滑点（点）。

【交易限制类】
平仓后间隔N分钟 : 平仓后N分钟内禁止开仓（0=无限制）。
魔术号         : EA订单唯一标识，避免误操作其他订单。
定位X/Y坐标    : 面板在图表上的起始位置微调。


【5. 算法模式 - 手数计算详解】
-------------------------------------------------------------------------------
公式：手数 = (算法倍数 ^ ((n-1) / 算法次数)) × 下单量

【示例】下单量=0.01，算法次数=2，算法倍数=2
第1次开仓（n=1）：0.01 × 2^(0/2) = 0.01手
第2次开仓（n=2）：0.01 × 2^(1/2) = 0.01手  ← 亏损后，同一轮内不变
第3次开仓（n=3）：0.01 × 2^(2/2) = 0.02手  ← 进入下一轮，手数翻倍
第4次开仓（n=4）：0.01 × 2^(3/2) = 0.02手
第5次开仓（n=5）：0.01 × 2^(4/2) = 0.04手  ← 再翻倍
以此类推...

【特别注意】
- 手数会按平台最小交易量（VOLUME_MIN）和步长（VOLUME_STEP）自动规整。
- 连续亏损次数达到"最大连损"后，n值取模重置，避免手数无限放大。


【6. 数据持久化（自动保存/读取）】
-------------------------------------------------------------------------------
【存储路径】MQL5\Files\交易助手\[品种名称].txt
【存储内容】面板8个输入框的价格数据（以逗号分隔）
【自动保存】EA卸载或图表关闭时自动保存当前输入框数据
【自动读取】EA启动时自动加载上次保存的数据到输入框
【首次运行】若文件不存在，EA自动创建并写入默认占位数据


【7. 操作流程示例】
-------------------------------------------------------------------------------
【场景1：挂单交易】
① 加载EA到图表 → ② 设置好止损点、盈亏比等参数
③ 观察ZigZag分析区判断当前趋势（红色多/绿色空）
④ 在对应方向的输入框填入目标进场价格
⑤ 等待价格触及 → EA自动开仓 → 自动设置止盈止损
⑥ 平仓后自动进入冷却计时（如设置了间隔时间）

【场景2：手动即时交易】
① 观察ZigZag分析区判断趋势方向
② 点击【现价多单】或【现价空单】按钮
③ EA立即以市价开仓 → 自动设置止盈止损


【8. 重要注意事项】
-------------------------------------------------------------------------------
① ZigZag指标依赖：确保以下路径之一存在ZigZag指标文件：
   - MQL5\Indicators\ZigZag.ex5
   - MQL5\Indicators\Examples\ZigZag.ex5
   若无此指标，ZigZag分析区将无数据显示，但不影响交易功能。

② 风险控制建议：
   - 算法模式有加仓风险，建议设置合理的"最大连损"值
   - 建议开启"平仓后间隔N分钟"功能，避免连续亏损时冲动交易
   - 根据账户资金规模合理设置"止损点"和"下单量"

③ 订单识别：
   - EA只识别"魔术号"匹配的订单，不会影响手动单或其他EA的订单

④ 多品种使用：
   - 每个品种需单独加载EA，数据文件独立保存（如EURUSD.txt、GBPUSD.txt）

⑤ 面板位置：
   - 可通过输入参数"定位X坐标"和"定位Y坐标"调整面板位置
   - 默认左上角为(0,0)


【9. 常见问题排查】
-------------------------------------------------------------------------------
Q1：ZigZag分析区无数据显示？
A1：检查ZigZag指标是否安装，或尝试将ZigZag指标手动添加到图表。

Q2：价格触及输入框价格但未开仓？
A2：检查是否有持仓（EA不允许多单同时存在）、是否在冷却期内、
    输入框浮动点是否设置过小（点差可能导致无法触发）。

Q3：算法模式手数计算与预期不符？
A3：检查"算法次数"和"算法倍数"设置，手数会按平台步长自动规整。

Q4：数据文件位置在哪？
A4：在MT5安装目录的 MQL5\Files\交易助手\ 文件夹中。

================================================================================
                               祝您交易顺利！
================================================================================

================================================================================
                        交易助手EA 使用说明 (v1.1)
================================================================================

【1. 核心功能概览】
-------------------------------------------------------------------------------
① 价格触发自动开仓（预设价格挂单）
② 智能仓位管理（固定模式 / 亏损加仓算法模式）
③ 自动止盈止损设置与维护
④ 平仓后交易冷却控制
⑤ ZigZag指标极值点分析（辅助判断趋势方向）


【2. ZigZag指标分析功能】← ★★★ 重点说明 ★★★
-------------------------------------------------------------------------------
【功能位置】面板左上角"★相邻极值点涨跌分析★"区域

【数据来源】自动调用图表中的ZigZag指标（需提前安装）

【显示内容】逐行显示最近10个极值点的详细数据：
            格式示例：极值0：1.12345  上涨：0.00250  (0.22%)
            含义说明：
            - "极值0"：距离当前最近的一个极值点
            - "极值1"：往前推一个极值点  ...  极值9：最远的极值点
            - "上涨/下跌"：相邻两个极值点的价格差方向
            - "0.00250"：具体的价格差值
            - "(0.22%)"：涨跌幅占前一个极值点的百分比

【颜色标识】红色文字 = 当前段为上涨趋势
            绿色文字 = 当前段为下跌趋势

【实战应用】如何利用这个功能判断趋势：
  ① 观察颜色连续性：
     - 连续出现多个红色 → 处于上升趋势中
     - 连续出现多个绿色 → 处于下跌趋势中
     - 红绿交替频繁 → 处于震荡行情，不宜追单

  ② 观察涨跌幅变化：
     - 涨幅逐渐缩小 → 上涨动能减弱，可能即将回调
     - 跌幅逐渐缩小 → 下跌动能减弱，可能即将反弹
     - 突然出现大幅波动 → 行情加速，可顺势跟进

  ③ 识别支撑阻力：
     - 多个极值点价格接近 → 形成强支撑/阻力位
     - 突破最近极值点 → 趋势可能延续或反转

【注意】ZigZag指标为滞后指标，反映的是已发生的价格转折，
        建议结合K线形态和其他指标综合判断。


【3. 面板各区域详细说明】
-------------------------------------------------------------------------------
┌─────────────────────────────────────────────────┐
│  ★相邻极值点涨跌分析★        ← ZigZag分析区  │
│  极值0：1.12345  上涨：0.00250 (0.22%)        │
│  极值1：1.12095  下跌：0.00120 (0.11%)        │
│  ...（共显示10个极值点）                       │
├─────────────────────────────────────────────────┤
│  多单输入框1：[    ]  空单输入框5：[    ]      │  ← 价格触发区
│  多单输入框2：[    ]  空单输入框6：[    ]      │     （输入目标价格）
│  多单输入框3：[    ]  空单输入框7：[    ]      │
│  多单输入框4：[    ]  空单输入框8：[    ]      │
├─────────────────────────────────────────────────┤
│  止损点：500  盈亏比：3：1  下次手数：0.01     │  ← 状态信息区
│  允许最大亏损次数：8  当前次数：0              │
│  间隔时间：剩余3分钟                           │
├─────────────────────────────────────────────────┤
│  [现价多单]  [现价空单]  [关闭]                │  ← 操作按钮区
├─────────────────────────────────────────────────┤
│  点击访问天机跟单官网：https://...             │  ← 顶部导航
└─────────────────────────────────────────────────┘


【4. 关键输入参数详解】
-------------------------------------------------------------------------------
【交易控制类】
下单模式       : 固定模式=始终用固定手数；算法模式=根据亏损动态加仓。
下单量         : 基础手数（固定模式用此值，算法模式为计算基数）。
算法次数       : 每N次亏损为一轮加仓周期（例：2表示每2次亏损为一轮）。
算法倍数       : 一轮结束后手数放大倍数（例：2表示手数×2）。
最大连损       : 最大连续亏损容忍次数，达到后重置手数计算。

【风控参数类】
止损点         : 开仓后的止损点数（以品种点数为单位）。
盈亏比         : 止盈点数是止损点数的倍数（例：3表示止盈=止损×3）。
止盈滑点       : 判断历史订单是否止盈的容差（点）。
输入框浮动点   : 触发挂单的价格容差（±点数），防止因点差错过进场。
滑点           : 市价单成交允许的最大滑点（点）。

【交易限制类】
平仓后间隔N分钟 : 平仓后N分钟内禁止开仓（0=无限制）。
魔术号         : EA订单唯一标识，避免误操作其他订单。
定位X/Y坐标    : 面板在图表上的起始位置微调。


【5. 算法模式 - 手数计算详解】
-------------------------------------------------------------------------------
公式：手数 = (算法倍数 ^ ((n-1) / 算法次数)) × 下单量

【示例】下单量=0.01，算法次数=2，算法倍数=2
第1次开仓（n=1）：0.01 × 2^(0/2) = 0.01手
第2次开仓（n=2）：0.01 × 2^(1/2) = 0.01手  ← 亏损后，同一轮内不变
第3次开仓（n=3）：0.01 × 2^(2/2) = 0.02手  ← 进入下一轮，手数翻倍
第4次开仓（n=4）：0.01 × 2^(3/2) = 0.02手
第5次开仓（n=5）：0.01 × 2^(4/2) = 0.04手  ← 再翻倍
以此类推...

【特别注意】
- 手数会按平台最小交易量（VOLUME_MIN）和步长（VOLUME_STEP）自动规整。
- 连续亏损次数达到"最大连损"后，n值取模重置，避免手数无限放大。


【6. 数据持久化（自动保存/读取）】
-------------------------------------------------------------------------------
【存储路径】MQL5\Files\交易助手\[品种名称].txt
【存储内容】面板8个输入框的价格数据（以逗号分隔）
【自动保存】EA卸载或图表关闭时自动保存当前输入框数据
【自动读取】EA启动时自动加载上次保存的数据到输入框
【首次运行】若文件不存在，EA自动创建并写入默认占位数据


【7. 操作流程示例】
-------------------------------------------------------------------------------
【场景1：挂单交易】
① 加载EA到图表 → ② 设置好止损点、盈亏比等参数
③ 观察ZigZag分析区判断当前趋势（红色多/绿色空）
④ 在对应方向的输入框填入目标进场价格
⑤ 等待价格触及 → EA自动开仓 → 自动设置止盈止损
⑥ 平仓后自动进入冷却计时（如设置了间隔时间）

【场景2：手动即时交易】
① 观察ZigZag分析区判断趋势方向
② 点击【现价多单】或【现价空单】按钮
③ EA立即以市价开仓 → 自动设置止盈止损


【8. 重要注意事项】
-------------------------------------------------------------------------------
① ZigZag指标依赖：确保以下路径之一存在ZigZag指标文件：
   - MQL5\Indicators\ZigZag.ex5
   - MQL5\Indicators\Examples\ZigZag.ex5
   若无此指标，ZigZag分析区将无数据显示，但不影响交易功能。

② 风险控制建议：
   - 算法模式有加仓风险，建议设置合理的"最大连损"值
   - 建议开启"平仓后间隔N分钟"功能，避免连续亏损时冲动交易
   - 根据账户资金规模合理设置"止损点"和"下单量"

③ 订单识别：
   - EA只识别"魔术号"匹配的订单，不会影响手动单或其他EA的订单

④ 多品种使用：
   - 每个品种需单独加载EA，数据文件独立保存（如EURUSD.txt、GBPUSD.txt）

⑤ 面板位置：
   - 可通过输入参数"定位X坐标"和"定位Y坐标"调整面板位置
   - 默认左上角为(0,0)


【9. 常见问题排查】
-------------------------------------------------------------------------------
Q1：ZigZag分析区无数据显示？
A1：检查ZigZag指标是否安装，或尝试将ZigZag指标手动添加到图表。

Q2：价格触及输入框价格但未开仓？
A2：检查是否有持仓（EA不允许多单同时存在）、是否在冷却期内、
    输入框浮动点是否设置过小（点差可能导致无法触发）。

Q3：算法模式手数计算与预期不符？
A3：检查"算法次数"和"算法倍数"设置，手数会按平台步长自动规整。

Q4：数据文件位置在哪？
A4：在MT5安装目录的 MQL5\Files\交易助手\ 文件夹中。

================================================================================
                               祝您交易顺利！
================================================================================