========================================
MT4-MT5互跟互平 EA使用说明
========================================
版本：V3.06（MT4）/ V3.20（MT5）
更新日期：2026-04-28

========================================
一、EA文件说明
========================================

MT4-MT5互跟互平.ex4  →  MT4平台使用（喊单+跟单二合一）
MT4-MT5互跟互平.ex5  →  MT5平台使用（喊单+跟单二合一）

两个EA可以跨平台互跟：
- MT4喊单 → MT5跟单
- MT5喊单 → MT4跟单
- MT4喊单 → MT4跟单
- MT5喊单 → MT5跟单

========================================
二、模式选择
========================================

参数：EA工作模式
  喊单模式 = 作为信号源，发送信号
  跟单模式 = 读取信号，复制订单到本账号

注意：
- 喊单账号挂喊单模式
- 跟单账号挂跟单模式
- 同一图表只能挂一个EA

========================================
三、喊单模式参数说明
========================================

参数名                  说明
------------------------------------------------------------
__商品名称只取前6字符   true  = 品种名只写前6位（如XAUUSD）
                        false = 写完整品种名（如XAUUSDm）
                        建议：true（兼容性更好）

========================================
四、跟单模式参数说明
========================================

【账号设置】
参数名                  说明
------------------------------------------------------------
__喊单账号              填写喊单账号数字
                        填0 = 自动识别有效喊单账号（推荐）
显示账号选择按钮        true = 图表上显示账号切换按钮
按钮位置                左上角 / 右上角 / 左下角 / 右下角
按钮X坐标               按钮距边缘的水平像素距离
按钮Y坐标               按钮距边缘的垂直像素距离

【跟单开关】
参数名                  说明
------------------------------------------------------------
跟单现价单开关          true = 跟随市价买卖单
跟单挂单开关            true = 跟随限价/止损挂单
跟单平仓开关            true = 跟随喊单平仓
跟单止损止盈开关        true = 同步喊单的止损止盈价格
双向同步平仓开关        true = 跟单手动平仓后，喊单也同步平仓

【手数设置】
参数名                  说明
------------------------------------------------------------
喊单手数类型            同比例手数 = 按比例复制喊单手数
                        用自定义手数 = 使用固定手数
单量比例                同比例时的倍数（1=等比例，2=双倍）
固定手数                自定义手数时的手数值（如0.01）

【品种设置】
参数名                  说明
------------------------------------------------------------
__商品名称后缀          跟单平台的品种后缀
                        例：喊单是XAUUSD，跟单平台是XAUUSDm
                        则填写：m
品种映射                品种名称转换规则
                        格式：原始品种|目标品种
                        例：XAUUSD|GOLD_
                        多组映射用|分隔：XAUUSD|GOLD_|EURUSD|EURUSDm
反向跟单                true = 喊单买，跟单卖（反向操作）

【其他设置】
参数名                  说明
------------------------------------------------------------
魔术编号                订单识别码，多个跟单EA需设置不同值
自定义注释              跟单订单的备注内容（为空则不加注释）
补单间隔秒数            检查漏单的时间间隔（秒）
补单延迟秒数            补单前的等待时间（秒）
同步挂单价格开关        true = 实时同步喊单挂单的价格变化（MT5版）
启用日志输出            true = 在日志窗口输出详细信息（调试用）

========================================
五、账号选择按钮使用
========================================

跟单模式下，图表上会显示一个账号选择按钮：

【收起状态】
┌──────────────────┐
│ ▼ 账号: 38016863 │  ← 点击展开账号列表
└──────────────────┘

【展开状态】
┌──────────────────┐
│ ▼ 账号: 38016863 │  ← 点击收起
├──────────────────┤
│ ● 38016863       │  ← 当前账号（绿色）
├──────────────────┤
│ ○ 07197          │  ← 可选账号（蓝色）
├──────────────────┤
│ ○ 4555           │  ← 可选账号（蓝色）
└──────────────────┘

按钮颜色说明：
  绿色 = 已连接到有效喊单账号
  橙色 = 未选择账号
  灰色 = 无可用账号（喊单EA未运行）

注意：
- 列表只显示信号正常的账号（数据在60秒内更新过）
- 每10秒自动刷新一次账号列表
- 喊单EA停止运行后，该账号会自动从列表中消失

========================================
六、双向同步平仓
========================================

开启"双向同步平仓开关=true"后：

方向1（正常跟单）：
  喊单账号平仓 → 跟单账号自动跟随平仓

方向2（反向同步）：
  跟单账号手动平仓 → 喊单账号也自动同步平仓

适用场景：
  跟单账号需要提前止盈或止损时，
  喊单账号也会同步执行相同的平仓操作。

========================================
七、图表状态提示说明
========================================

图表左上角会显示当前工作状态：

提示内容                        颜色    含义
------------------------------------------------------------
跟单已正常工作中...             蓝色    跟单正常运行
喊单已正常工作中...             蓝色    喊单正常运行
未连接上喊单账户                红色    找不到喊单信号
喊单账户未更新数据              红色   喊单信号超过5秒未更新
喊单发送数据不完整              红色   喊单信号格式错误
喊单ea版本错误                  红色    喊单EA版本不匹配

处理方法：
  红色提示 → 检查喊单EA是否正常运行
  蓝色提示 → 正常，无需操作

========================================
八、常见使用场景
========================================

【场景1：MT4喊单 → MT5跟单（跨平台）】
1. MT4账号：挂MT4-MT5互跟互平.ex4，设置喊单模式
2. MT5账号：挂MT4-MT5互跟互平.ex5，设置跟单模式
3. MT5跟单参数：__喊单账号=0（自动识别）
4. 如品种名不同，设置品种映射或后缀

【场景2：MT5喊单 → MT4跟单（跨平台）】
1. MT5账号：挂MT4-MT5互跟互平.ex5，设置喊单模式
2. MT4账号：挂MT4-MT5互跟互平.ex4，设置跟单模式
3. MT4跟单参数：__喊单账号=0（自动识别）

【场景3：一个喊单，多个跟单】
1. 喊单账号：挂一个EA，设置喊单模式
2. 跟单账号1：挂EA，魔术编号=1
3. 跟单账号2：挂EA，魔术编号=2
4. 跟单账号3：挂EA，魔术编号=3
注意：多个跟单EA的魔术编号必须不同

【场景4：品种名称不同的跨平台跟单】
例：喊单平台品种是XAUUSD，跟单平台品种是XAUUSDm
设置方法：
  __商品名称后缀 = m
  或
  品种映射 = XAUUSD|XAUUSDm

【场景5：手动平仓同步】
1. 开启双向同步平仓开关=true
2. 在跟单账号手动平仓某个订单
3. 喊单账号对应订单自动平仓

========================================
九、注意事项
========================================

1. 喊单EA和跟单EA必须同时运行，缺一不可

2. 两个EA必须在同一台电脑上运行
   （信号在本地通过MT4/MT5来共享）

3. 魔术编号不能设置为444或-444

4. 跟单EA挂在哪个图表不影响跟单效果
   （跟单不限制品种，会跟随喊单的所有品种）

5. 喊单EA的"__商品名称只取前6字符"建议设置为true
   这样跟单EA更容易匹配品种名称

6. 如果跟单账号的品种名称有后缀（如m、.），
   需要在跟单EA中设置"__商品名称后缀"

7. 账号选择按钮只在跟单模式下显示

8. 每次修改参数后，EA会自动重新初始化

========================================
十、日志查看方法
========================================

在MT4/MT5中查看EA运行日志：
  菜单 → 查看 → 工具箱 → 日志（MT4）
  菜单 → 查看 → 工具箱 → 专家（MT5）

关键日志标签说明：
  [初始化]    EA启动时的初始化信息
  [账号切换]  账号切换成功
  [自动切换]  自动切换到有效账号
  [开仓]      跟单开仓成功
  [跟单平仓]  跟随喊单平仓
  [外部平仓]  检测到跟单账号手动平仓
  [平仓日志]  双向同步平仓处理
  [补仓]      补单成功
  [强制同步]  发现遗留订单并处理

========================================
