快捷下单面板V1.2 使用说明书

适用程序：`快捷下单面板V1.2.ex5`  
说明书版本：V1.2  
更新日期：2026年7月14日

> **重要提示**：本EA是人工交易辅助工具，不是自动判断行情、自动寻找入场信号的交易策略。任何下单、平仓、减仓和撤单均可能造成真实资金损失。首次使用前请在模拟账户或最小手数环境完整测试，并确认品种的最小手数、手数步进、点值、Tick大小、止损距离及挂单规则。

## 1. EA用途

快捷下单面板V1.2用于MT5对冲账户，主要提供以下功能：

- 固定手数的市价买入和市价卖出。
- 买入限价、卖出限价、买入停损和卖出停损挂单。
- 为面板订单和符合条件的手动订单设置或补充止损。
- 按ATR、固定点数或确认摆动点计算保护止损。
- 一键推保本、推ATR止损、推摆动止损。
- 一键平仓、一键撤销挂单。
- 按当前图表品种的总持仓比例减仓。
- 按品种和方向显示持仓篮子汇总。

本EA只管理以下两类订单：

1. 手动订单，即 `Magic=0`。
2. 本面板订单，即默认 `Magic=26071401`。

其他EA使用不同Magic建立的订单不会被本面板管理。

## 2. 重要安全边界

### 2.1 默认锁定

EA每次加载后均处于“交易已锁定”状态，自动保护默认关闭。必须主动点击“交易已锁定”，使按钮变为“交易已解锁”，交易按钮才会执行。

重新锁定后，自动保护会同时关闭。

### 2.2 只支持对冲账户

EA需要逐票管理持仓，因此只支持MT5对冲账户。若账户是净持仓账户，EA会进入只读状态，不能下单或修改订单。

### 2.3 单活动面板

同一MT5终端内，同一账户和同一面板Magic只允许一个活动面板实例。重复加载的面板会进入只读状态，防止多个图表同时管理同一批订单。

### 2.4 管理范围

“范围：当前品种／所有品种”影响以下操作：

- 自动保护无止损订单。
- 推保本、推ATR止损、推摆动止损。
- 一键平仓。
- 一键撤销挂单。
- 持仓篮子显示。

以下操作始终只针对EA所在的当前图表品种：

- 市价单和四类挂单的新建。
- 按总仓比例减仓。

> **特别注意**：“所有品种”范围可能管理账户中所有符合条件的手动订单。执行一键平仓、撤单或自动保护前，务必再次确认范围按钮。

## 3. 安装方法

1. 在MT5中点击“文件 → 打开数据文件夹”。
2. 打开 `MQL5\Experts` 文件夹。
3. 将 `快捷下单面板V1.2.ex5` 复制到该文件夹。
4. 返回MT5，在“导航器 → EA交易”中点击刷新；若未出现，可重新启动MT5。
5. 打开需要交易的品种和周期图表，将EA拖到图表上。
6. 在EA属性中检查中文参数，并勾选“允许算法交易”。
7. 确认MT5工具栏“算法交易”已启用。
8. 面板出现后，先保持锁定状态核对品种、周期、手数、止损方式和管理范围。

源码文件 `.mq5` 不是运行所必需；正常分享和使用只需要 `.ex5` 与本说明书。

## 4. 首次使用检查

建议按以下顺序在模拟账户测试：

1. 使用 `0.01` 手或该品种允许的最小手数。
2. 检查当前图表品种和周期是否正确。
3. 保持“范围：当前品种”。
4. 选择止损方式，核对默认参数。
5. 解锁后测试一笔限价挂单，再测试撤单。
6. 测试一笔停损挂单，核对入场价、止损和到期时间。
7. 测试一笔市价单，核对初始止损。
8. 测试推保本和推止损，确认止损只会收紧。
9. 使用可拆分的总手数测试25%或50%减仓。
10. 最后测试一键平仓，并检查MT5“专家”和“日志”记录。

## 5. 面板区域说明

### 5.1 顶部控制区

| 控件 | 作用 |
|---|---|
| 交易已锁定／交易已解锁 | 总交易开关。解锁后按钮为单击执行。 |
| 自动保护：关／开 | 扫描符合条件且没有止损的持仓和挂单，并按当前止损方式补止损。 |
| 范围：当前品种／所有品种 | 切换批量管理和篮子显示范围。 |
| 状态行 | 显示止损方式、管理对象、只读原因和执行结果。文字过长时可查看对象提示或“专家”日志。 |

### 5.2 快捷下单区

| 输入或按钮 | 说明 |
|---|---|
| 手数 | 固定下单手数。必须符合券商最小手数、最大手数和手数步进。 |
| 限价价格 | 仅供买入限价和卖出限价使用。停损突破单不读取此输入。 |
| 止盈点 | 以MT5“点”为单位；输入0表示不设置止盈。 |
| 市价买入／市价卖出 | 按当前报价发送市价单，并附带当前止损方式计算出的止损。 |
| 买入限价／卖出限价 | 按“限价价格”发送挂单，并附带止损、可选止盈和到期时间。 |
| 买入停损／卖出停损 | 按上一根已收盘K线自动计算突破挂单价格。 |

### 5.3 止损与推进区

| 控件 | 说明 |
|---|---|
| 方式：ATR | 使用已收盘ATR计算止损，默认M15、14周期、1.0倍。 |
| 方式：固定 | 使用固定点数距离，默认1000点。 |
| 方式：摆动 | 使用最近已确认的摆动低点或摆动高点，并增加外侧缓冲。 |
| 推保本 | 将持仓止损推进到开仓价加／减保本缓冲。只有价格和最小止损距离允许时才会修改。 |
| 推ATR止损 | 按当前已收盘ATR重新计算持仓止损。 |
| 推摆动止损 | 按最近已确认摆动点重新计算持仓止损。 |

所有“推”操作只收紧风险，不会把已有止损放宽。若现有止损已经更优，EA会跳过该持仓。

### 5.4 平仓、减仓与撤单区

| 控件 | 说明 |
|---|---|
| 一键平仓 | 平掉当前管理范围内所有符合条件的持仓。 |
| 一键撤销挂单 | 撤销当前管理范围内所有符合条件的四类挂单。 |
| 25%／50%／75% | 按当前图表品种总持仓的相应比例减仓。 |
| 自定义比例 | 输入大于0且小于100的比例，再点击“按总仓比例减仓”。 |

面板下方的篮子信息仅用于汇总显示，按“品种＋多空方向”显示笔数、总手数、加权均价和浮动盈亏，不提供单篮子减仓按钮。

## 6. 下单规则

### 6.1 固定手数

EA当前只支持固定手数下单，不按账户资金或止损距离自动计算风险手数。输入手数必须精确符合当前品种的手数步进；不符合时EA会拒绝下单，不会自动改成另一个手数。

### 6.2 市价单

- 买单按Ask成交参考价计算，卖单按Bid成交参考价计算。
- 默认允许成交偏差为20点。
- 报价超过默认10秒未更新时，EA拒绝下单或管理操作。
- 每笔市价单必须先成功计算有效止损，否则不会发送订单。

### 6.3 限价单

- 买入限价必须低于当前Ask以及券商要求的最小挂单距离。
- 卖出限价必须高于当前Bid以及券商要求的最小挂单距离。
- 必须在“限价价格”输入框填入有效价格。
- 挂单会附带当前止损方式、可选止盈和指定到期时间。

### 6.4 停损突破单

停损突破单使用当前图表周期的上一根已收盘K线：

- **买入停损价** = 上一根已收盘K线最高价 + 1 Tick + 当前点差。
- **卖出停损价** = 上一根已收盘K线最低价 - 1 Tick。

这里的设计目的是要求价格至少突破上一根已收盘K线，并留出最小Tick确认。买入侧额外计入当前点差，以便把图表上的Bid前高换算到Ask触发区域。

默认点差上限为50点。若当前点差超过上限，EA拒绝发送停损突破单。参数设为0可取消该上限，但不建议在流动性异常时这样做。

若自动计算出的突破价已经被市场越过，或不满足券商最小挂单距离，EA会拒绝订单，不会追价。

### 6.5 挂单有效K线数

四类面板挂单默认有效2根当前图表周期K线：

- 下单时正在形成的K线算第1根。
- 下一根K线算第2根。
- 第3根K线开始时挂单到期。

例如，在M5图表当前K线中途发送挂单，剩余有效时间会少于完整10分钟，因为当前正在形成的M5 K线已经计入第1根。成功发送后，面板状态会显示准确到期时间。

若券商不支持指定挂单到期时间，EA会拒绝挂单，不会静默改成永久有效。

## 7. 三种止损方式

### 7.1 ATR止损

默认参数为M15、ATR 14周期、1.0倍。EA读取指定ATR周期上一根已收盘K线的ATR值：

- 多单止损 = 参考价格 - ATR倍数 × ATR。
- 空单止损 = 参考价格 + ATR倍数 × ATR。

市价单以入场参考价计算；挂单以挂单入场价计算；推ATR时以当前可平仓参考价计算。

### 7.2 固定点数止损

默认距离为1000点：

- 多单止损位于参考价格下方。
- 空单止损位于参考价格上方。

“点”是MT5品种属性中的最小报价点值，不一定等于传统外汇语境中的“pip”，也不等于1美元。不同券商的黄金报价位数可能不同，使用前必须查看品种规格。

### 7.3 确认摆动点止损

默认使用M15周期、左1根／右1根确认规则，最大回看300根K线，外侧缓冲10点：

- 多单使用最近已确认摆动低点，再向下增加缓冲。
- 空单使用最近已确认摆动高点，再向上增加缓冲。

摆动点必须等待右侧K线收盘确认，不使用尚未确认的未来数据。若数据不足或回看范围内没有确认摆动点，EA会跳过或拒绝操作。

### 7.4 券商最小距离

所有止损和挂单价格都会检查券商的最小止损距离、冻结距离以及Tick大小。不满足条件时，EA拒绝操作并在面板或“专家”日志中说明原因。

## 8. 自动保护无止损订单

开启步骤：

1. 先解锁交易。
2. 选择管理范围。
3. 选择ATR、固定或摆动止损方式。
4. 点击“自动保护：关”，使其变为“自动保护：开”。

开启后，EA约每秒扫描一次以下对象：

- 当前范围内 `Magic=0` 的手动持仓和四类手动挂单。
- 当前范围内 `Magic=26071401` 的本面板持仓和四类挂单。
- 只处理当前没有止损的订单；已有止损不会被自动保护覆盖。

如果止损无法计算、报价陈旧或不满足券商规则，该订单会被跳过，详细原因写入MT5“专家”日志。发生交易权限问题时，自动保护会停止。

> **终端在线要求**：自动补止损依赖EA运行。MT5关闭、网络中断、EA被移除或算法交易关闭期间，EA无法给新出现的无止损订单补保护。已经成功提交到券商服务器的止损不依赖面板持续在线。

## 9. 推保本与推止损

### 9.1 推保本

默认保本缓冲为0点，即止损推进到开仓价。若设置正数缓冲：

- 多单止损 = 开仓价 + 缓冲点数。
- 空单止损 = 开仓价 - 缓冲点数。

只有当新止损满足当前市场价格、券商最小距离并且比旧止损更优时才会修改。尚未形成足够浮盈的持仓通常会被跳过。

### 9.2 推ATR或摆动止损

按钮会对管理范围内所有符合条件的持仓逐票计算并修改。操作只针对持仓，不修改已有挂单；止损只收紧、不放宽。

## 10. 比例减仓规则

比例减仓固定使用当前图表品种，不受“当前品种／所有品种”范围按钮影响。

执行逻辑如下：

1. 汇总当前图表品种中所有符合条件的多单和空单手数。
2. 按选择的百分比计算目标减仓手数。
3. 按品种手数步进四舍五入到最近可执行手数。
4. 按开仓价距离当前可平仓价格由近到远排序。
5. 从距离最新价最近的持仓开始减，直到尽量完成目标手数。

例如，当前品种符合条件的总仓为0.08手，点击50%，目标减仓为0.04手。EA可能完整平掉若干小持仓，也可能对某一持仓部分平仓。

以下情况会拒绝或无法完全执行：

- 四舍五入后的目标低于品种最小手数。
- 四舍五入后会把全部持仓平掉。
- 部分平仓后剩余手数低于券商最小手数。
- 成交只得到部分执行、报价异常或券商拒绝。

比例减仓是对多空合计总仓计算，不是分别对多单篮子和空单篮子各减一次。

## 11. 一键平仓与撤单

### 11.1 一键平仓

一键平仓会逐票平掉当前管理范围内所有符合条件的持仓。若中途某一笔失败，EA会停止后续操作，并显示已经完成和剩余笔数，避免把未确认的结果误报为全部成功。

### 11.2 一键撤销挂单

一键撤单会删除当前管理范围内符合条件的买入限价、卖出限价、买入停损和卖出停损挂单。它可能同时撤销 `Magic=0` 的手动挂单，请在点击前确认管理范围。

## 12. 默认参数表

| 参数 | 默认值 | 说明 |
|---|---:|---|
| 本面板订单魔术号 | 26071401 | 用于识别本面板订单。 |
| 默认固定下单手数 | 0.01 | 面板初始手数。 |
| 默认管理范围 | 当前品种 | 可在面板切换为所有品种。 |
| 市价成交允许偏差 | 20点 | 市价成交和平仓允许偏差。 |
| 报价最大陈旧时间 | 10秒 | 超时则拒绝交易操作。 |
| 突破挂单最大点差 | 50点 | 仅限制买／卖停损突破单；0为不限制。 |
| 挂单有效K线数 | 2根 | 使用当前图表周期。 |
| 界面缩放比例 | 100% | 可设置90%至140%。 |
| 默认止损方式 | ATR | 可在面板临时切换。 |
| ATR周期 | M15 | 读取已收盘ATR。 |
| ATR计算长度 | 14 | ATR周期参数。 |
| ATR倍数 | 1.0 | 必须大于0。 |
| 固定止损距离 | 1000点 | 固定模式使用。 |
| 摆动点周期 | M15 | 摆动模式使用。 |
| 摆动点左／右确认 | 1／1 | 需要右侧K线收盘确认。 |
| 摆动点最大回看 | 300根 | 查找最近确认摆动点。 |
| 摆动点外侧缓冲 | 10点 | 放在摆动高低点外侧。 |
| 默认止盈距离 | 0点 | 0表示不设置止盈。 |
| 保本外移缓冲 | 0点 | 0表示推到开仓价。 |
| 默认自定义减仓比例 | 50% | 自定义比例输入框初始值。 |

EA属性中的参数在加载时确定。修改参数后，MT5通常会重新初始化EA，因此交易锁会恢复为锁定，自动保护恢复为关闭。

## 13. 常见提示与处理方法

| 提示或现象 | 处理方法 |
|---|---|
| 交易总锁尚未解锁 | 点击顶部锁定按钮，确认变为“交易已解锁”。 |
| MT5工具栏的算法交易未启用 | 开启MT5顶部“算法交易”。 |
| EA属性中的算法交易权限未启用 | 重新打开EA属性，允许算法交易。 |
| 当前不是对冲账户 | 更换对冲账户；该面板不会在净持仓账户执行交易。 |
| 同一账户已有一个活动面板实例 | 保留一个活动面板，移除或关闭重复实例。 |
| 手数不符合品种步进 | 查看品种规格，输入允许的最小手数及步进倍数。 |
| 报价已陈旧 | 等待行情恢复，检查市场是否休市和网络连接。 |
| 当前点差超过上限 | 等待点差恢复；不要在开盘、数据时段或流动性异常时强行下单。 |
| 信号突破价已被越过；不追价 | 等待新的已收盘K线信号，不建议手工追价。 |
| 止损或挂单距离不足 | 调整价格或参数，等待市场拉开距离，并检查券商品种规格。 |
| 不支持指定挂单到期时间 | 当前券商或品种不支持该到期模式，面板不会发送永久挂单替代。 |
| 推止损修改0笔、跳过若干笔 | 通常表示现有止损更优、尚未形成保本空间、报价异常或摆动数据不足；查看“专家”日志。 |
| 减仓目标低于最小手数 | 增加总持仓或使用更高比例；EA不会强行改变目标。 |
| 减仓被拒绝：将平掉全部持仓 | 使用一键平仓，或选择更低的减仓比例。 |

## 14. 使用限制与风险提示

- 本EA不提供收益保证，也不构成投资建议。
- EA不会判断趋势、交易区间、信号质量或新闻风险；入场判断由使用者负责。
- 固定手数不等于固定风险。止损距离越大，同样手数的资金风险越高。
- 点差、滑点、跳空、流动性不足和服务器拒绝可能导致实际成交与预期不同。
- 一键操作在解锁后单击即执行，没有第二次确认窗口。
- “所有品种”范围和 `Magic=0` 管理能力较强，可能影响账户中其他手动交易。
- 参数默认值不一定适合所有券商、黄金品种、报价位数、账户规模或交易周期。
- 自动保护不能替代下单时直接附带止损，也不能替代交易者的风险控制。
- 分享给他人前，应让对方先阅读本说明书，并独立完成模拟账户测试。

## 15. 文件校验

本说明书对应的编译文件：`快捷下单面板V1.2.ex5`

SHA-256：

`51484A0B59F09EF7C31E22544EE4399C7B59F69370C1DF3276D884CBED35FC9F`

如果收到的EX5文件哈希不同，可能是文件版本不同或内容已经被修改，应重新确认来源。

---

**建议交付内容**：`快捷下单面板V1.2.ex5` + `快捷下单面板V1.2_使用说明书.docx`

快捷下单面板V1.2 使用说明书

适用程序：`快捷下单面板V1.2.ex5`  
说明书版本：V1.2  
更新日期：2026年7月14日

> **重要提示**：本EA是人工交易辅助工具，不是自动判断行情、自动寻找入场信号的交易策略。任何下单、平仓、减仓和撤单均可能造成真实资金损失。首次使用前请在模拟账户或最小手数环境完整测试，并确认品种的最小手数、手数步进、点值、Tick大小、止损距离及挂单规则。

## 1. EA用途

快捷下单面板V1.2用于MT5对冲账户，主要提供以下功能：

- 固定手数的市价买入和市价卖出。
- 买入限价、卖出限价、买入停损和卖出停损挂单。
- 为面板订单和符合条件的手动订单设置或补充止损。
- 按ATR、固定点数或确认摆动点计算保护止损。
- 一键推保本、推ATR止损、推摆动止损。
- 一键平仓、一键撤销挂单。
- 按当前图表品种的总持仓比例减仓。
- 按品种和方向显示持仓篮子汇总。

本EA只管理以下两类订单：

1. 手动订单，即 `Magic=0`。
2. 本面板订单，即默认 `Magic=26071401`。

其他EA使用不同Magic建立的订单不会被本面板管理。

## 2. 重要安全边界

### 2.1 默认锁定

EA每次加载后均处于“交易已锁定”状态，自动保护默认关闭。必须主动点击“交易已锁定”，使按钮变为“交易已解锁”，交易按钮才会执行。

重新锁定后，自动保护会同时关闭。

### 2.2 只支持对冲账户

EA需要逐票管理持仓，因此只支持MT5对冲账户。若账户是净持仓账户，EA会进入只读状态，不能下单或修改订单。

### 2.3 单活动面板

同一MT5终端内，同一账户和同一面板Magic只允许一个活动面板实例。重复加载的面板会进入只读状态，防止多个图表同时管理同一批订单。

### 2.4 管理范围

“范围：当前品种／所有品种”影响以下操作：

- 自动保护无止损订单。
- 推保本、推ATR止损、推摆动止损。
- 一键平仓。
- 一键撤销挂单。
- 持仓篮子显示。

以下操作始终只针对EA所在的当前图表品种：

- 市价单和四类挂单的新建。
- 按总仓比例减仓。

> **特别注意**：“所有品种”范围可能管理账户中所有符合条件的手动订单。执行一键平仓、撤单或自动保护前，务必再次确认范围按钮。

## 3. 安装方法

1. 在MT5中点击“文件 → 打开数据文件夹”。
2. 打开 `MQL5\Experts` 文件夹。
3. 将 `快捷下单面板V1.2.ex5` 复制到该文件夹。
4. 返回MT5，在“导航器 → EA交易”中点击刷新；若未出现，可重新启动MT5。
5. 打开需要交易的品种和周期图表，将EA拖到图表上。
6. 在EA属性中检查中文参数，并勾选“允许算法交易”。
7. 确认MT5工具栏“算法交易”已启用。
8. 面板出现后，先保持锁定状态核对品种、周期、手数、止损方式和管理范围。

源码文件 `.mq5` 不是运行所必需；正常分享和使用只需要 `.ex5` 与本说明书。

## 4. 首次使用检查

建议按以下顺序在模拟账户测试：

1. 使用 `0.01` 手或该品种允许的最小手数。
2. 检查当前图表品种和周期是否正确。
3. 保持“范围：当前品种”。
4. 选择止损方式，核对默认参数。
5. 解锁后测试一笔限价挂单，再测试撤单。
6. 测试一笔停损挂单，核对入场价、止损和到期时间。
7. 测试一笔市价单，核对初始止损。
8. 测试推保本和推止损，确认止损只会收紧。
9. 使用可拆分的总手数测试25%或50%减仓。
10. 最后测试一键平仓，并检查MT5“专家”和“日志”记录。

## 5. 面板区域说明

### 5.1 顶部控制区

| 控件 | 作用 |
|---|---|
| 交易已锁定／交易已解锁 | 总交易开关。解锁后按钮为单击执行。 |
| 自动保护：关／开 | 扫描符合条件且没有止损的持仓和挂单，并按当前止损方式补止损。 |
| 范围：当前品种／所有品种 | 切换批量管理和篮子显示范围。 |
| 状态行 | 显示止损方式、管理对象、只读原因和执行结果。文字过长时可查看对象提示或“专家”日志。 |

### 5.2 快捷下单区

| 输入或按钮 | 说明 |
|---|---|
| 手数 | 固定下单手数。必须符合券商最小手数、最大手数和手数步进。 |
| 限价价格 | 仅供买入限价和卖出限价使用。停损突破单不读取此输入。 |
| 止盈点 | 以MT5“点”为单位；输入0表示不设置止盈。 |
| 市价买入／市价卖出 | 按当前报价发送市价单，并附带当前止损方式计算出的止损。 |
| 买入限价／卖出限价 | 按“限价价格”发送挂单，并附带止损、可选止盈和到期时间。 |
| 买入停损／卖出停损 | 按上一根已收盘K线自动计算突破挂单价格。 |

### 5.3 止损与推进区

| 控件 | 说明 |
|---|---|
| 方式：ATR | 使用已收盘ATR计算止损，默认M15、14周期、1.0倍。 |
| 方式：固定 | 使用固定点数距离，默认1000点。 |
| 方式：摆动 | 使用最近已确认的摆动低点或摆动高点，并增加外侧缓冲。 |
| 推保本 | 将持仓止损推进到开仓价加／减保本缓冲。只有价格和最小止损距离允许时才会修改。 |
| 推ATR止损 | 按当前已收盘ATR重新计算持仓止损。 |
| 推摆动止损 | 按最近已确认摆动点重新计算持仓止损。 |

所有“推”操作只收紧风险，不会把已有止损放宽。若现有止损已经更优，EA会跳过该持仓。

### 5.4 平仓、减仓与撤单区

| 控件 | 说明 |
|---|---|
| 一键平仓 | 平掉当前管理范围内所有符合条件的持仓。 |
| 一键撤销挂单 | 撤销当前管理范围内所有符合条件的四类挂单。 |
| 25%／50%／75% | 按当前图表品种总持仓的相应比例减仓。 |
| 自定义比例 | 输入大于0且小于100的比例，再点击“按总仓比例减仓”。 |

面板下方的篮子信息仅用于汇总显示，按“品种＋多空方向”显示笔数、总手数、加权均价和浮动盈亏，不提供单篮子减仓按钮。

## 6. 下单规则

### 6.1 固定手数

EA当前只支持固定手数下单，不按账户资金或止损距离自动计算风险手数。输入手数必须精确符合当前品种的手数步进；不符合时EA会拒绝下单，不会自动改成另一个手数。

### 6.2 市价单

- 买单按Ask成交参考价计算，卖单按Bid成交参考价计算。
- 默认允许成交偏差为20点。
- 报价超过默认10秒未更新时，EA拒绝下单或管理操作。
- 每笔市价单必须先成功计算有效止损，否则不会发送订单。

### 6.3 限价单

- 买入限价必须低于当前Ask以及券商要求的最小挂单距离。
- 卖出限价必须高于当前Bid以及券商要求的最小挂单距离。
- 必须在“限价价格”输入框填入有效价格。
- 挂单会附带当前止损方式、可选止盈和指定到期时间。

### 6.4 停损突破单

停损突破单使用当前图表周期的上一根已收盘K线：

- **买入停损价** = 上一根已收盘K线最高价 + 1 Tick + 当前点差。
- **卖出停损价** = 上一根已收盘K线最低价 - 1 Tick。

这里的设计目的是要求价格至少突破上一根已收盘K线，并留出最小Tick确认。买入侧额外计入当前点差，以便把图表上的Bid前高换算到Ask触发区域。

默认点差上限为50点。若当前点差超过上限，EA拒绝发送停损突破单。参数设为0可取消该上限，但不建议在流动性异常时这样做。

若自动计算出的突破价已经被市场越过，或不满足券商最小挂单距离，EA会拒绝订单，不会追价。

### 6.5 挂单有效K线数

四类面板挂单默认有效2根当前图表周期K线：

- 下单时正在形成的K线算第1根。
- 下一根K线算第2根。
- 第3根K线开始时挂单到期。

例如，在M5图表当前K线中途发送挂单，剩余有效时间会少于完整10分钟，因为当前正在形成的M5 K线已经计入第1根。成功发送后，面板状态会显示准确到期时间。

若券商不支持指定挂单到期时间，EA会拒绝挂单，不会静默改成永久有效。

## 7. 三种止损方式

### 7.1 ATR止损

默认参数为M15、ATR 14周期、1.0倍。EA读取指定ATR周期上一根已收盘K线的ATR值：

- 多单止损 = 参考价格 - ATR倍数 × ATR。
- 空单止损 = 参考价格 + ATR倍数 × ATR。

市价单以入场参考价计算；挂单以挂单入场价计算；推ATR时以当前可平仓参考价计算。

### 7.2 固定点数止损

默认距离为1000点：

- 多单止损位于参考价格下方。
- 空单止损位于参考价格上方。

“点”是MT5品种属性中的最小报价点值，不一定等于传统外汇语境中的“pip”，也不等于1美元。不同券商的黄金报价位数可能不同，使用前必须查看品种规格。

### 7.3 确认摆动点止损

默认使用M15周期、左1根／右1根确认规则，最大回看300根K线，外侧缓冲10点：

- 多单使用最近已确认摆动低点，再向下增加缓冲。
- 空单使用最近已确认摆动高点，再向上增加缓冲。

摆动点必须等待右侧K线收盘确认，不使用尚未确认的未来数据。若数据不足或回看范围内没有确认摆动点，EA会跳过或拒绝操作。

### 7.4 券商最小距离

所有止损和挂单价格都会检查券商的最小止损距离、冻结距离以及Tick大小。不满足条件时，EA拒绝操作并在面板或“专家”日志中说明原因。

## 8. 自动保护无止损订单

开启步骤：

1. 先解锁交易。
2. 选择管理范围。
3. 选择ATR、固定或摆动止损方式。
4. 点击“自动保护：关”，使其变为“自动保护：开”。

开启后，EA约每秒扫描一次以下对象：

- 当前范围内 `Magic=0` 的手动持仓和四类手动挂单。
- 当前范围内 `Magic=26071401` 的本面板持仓和四类挂单。
- 只处理当前没有止损的订单；已有止损不会被自动保护覆盖。

如果止损无法计算、报价陈旧或不满足券商规则，该订单会被跳过，详细原因写入MT5“专家”日志。发生交易权限问题时，自动保护会停止。

> **终端在线要求**：自动补止损依赖EA运行。MT5关闭、网络中断、EA被移除或算法交易关闭期间，EA无法给新出现的无止损订单补保护。已经成功提交到券商服务器的止损不依赖面板持续在线。

## 9. 推保本与推止损

### 9.1 推保本

默认保本缓冲为0点，即止损推进到开仓价。若设置正数缓冲：

- 多单止损 = 开仓价 + 缓冲点数。
- 空单止损 = 开仓价 - 缓冲点数。

只有当新止损满足当前市场价格、券商最小距离并且比旧止损更优时才会修改。尚未形成足够浮盈的持仓通常会被跳过。

### 9.2 推ATR或摆动止损

按钮会对管理范围内所有符合条件的持仓逐票计算并修改。操作只针对持仓，不修改已有挂单；止损只收紧、不放宽。

## 10. 比例减仓规则

比例减仓固定使用当前图表品种，不受“当前品种／所有品种”范围按钮影响。

执行逻辑如下：

1. 汇总当前图表品种中所有符合条件的多单和空单手数。
2. 按选择的百分比计算目标减仓手数。
3. 按品种手数步进四舍五入到最近可执行手数。
4. 按开仓价距离当前可平仓价格由近到远排序。
5. 从距离最新价最近的持仓开始减，直到尽量完成目标手数。

例如，当前品种符合条件的总仓为0.08手，点击50%，目标减仓为0.04手。EA可能完整平掉若干小持仓，也可能对某一持仓部分平仓。

以下情况会拒绝或无法完全执行：

- 四舍五入后的目标低于品种最小手数。
- 四舍五入后会把全部持仓平掉。
- 部分平仓后剩余手数低于券商最小手数。
- 成交只得到部分执行、报价异常或券商拒绝。

比例减仓是对多空合计总仓计算，不是分别对多单篮子和空单篮子各减一次。

## 11. 一键平仓与撤单

### 11.1 一键平仓

一键平仓会逐票平掉当前管理范围内所有符合条件的持仓。若中途某一笔失败，EA会停止后续操作，并显示已经完成和剩余笔数，避免把未确认的结果误报为全部成功。

### 11.2 一键撤销挂单

一键撤单会删除当前管理范围内符合条件的买入限价、卖出限价、买入停损和卖出停损挂单。它可能同时撤销 `Magic=0` 的手动挂单，请在点击前确认管理范围。

## 12. 默认参数表

| 参数 | 默认值 | 说明 |
|---|---:|---|
| 本面板订单魔术号 | 26071401 | 用于识别本面板订单。 |
| 默认固定下单手数 | 0.01 | 面板初始手数。 |
| 默认管理范围 | 当前品种 | 可在面板切换为所有品种。 |
| 市价成交允许偏差 | 20点 | 市价成交和平仓允许偏差。 |
| 报价最大陈旧时间 | 10秒 | 超时则拒绝交易操作。 |
| 突破挂单最大点差 | 50点 | 仅限制买／卖停损突破单；0为不限制。 |
| 挂单有效K线数 | 2根 | 使用当前图表周期。 |
| 界面缩放比例 | 100% | 可设置90%至140%。 |
| 默认止损方式 | ATR | 可在面板临时切换。 |
| ATR周期 | M15 | 读取已收盘ATR。 |
| ATR计算长度 | 14 | ATR周期参数。 |
| ATR倍数 | 1.0 | 必须大于0。 |
| 固定止损距离 | 1000点 | 固定模式使用。 |
| 摆动点周期 | M15 | 摆动模式使用。 |
| 摆动点左／右确认 | 1／1 | 需要右侧K线收盘确认。 |
| 摆动点最大回看 | 300根 | 查找最近确认摆动点。 |
| 摆动点外侧缓冲 | 10点 | 放在摆动高低点外侧。 |
| 默认止盈距离 | 0点 | 0表示不设置止盈。 |
| 保本外移缓冲 | 0点 | 0表示推到开仓价。 |
| 默认自定义减仓比例 | 50% | 自定义比例输入框初始值。 |

EA属性中的参数在加载时确定。修改参数后，MT5通常会重新初始化EA，因此交易锁会恢复为锁定，自动保护恢复为关闭。

## 13. 常见提示与处理方法

| 提示或现象 | 处理方法 |
|---|---|
| 交易总锁尚未解锁 | 点击顶部锁定按钮，确认变为“交易已解锁”。 |
| MT5工具栏的算法交易未启用 | 开启MT5顶部“算法交易”。 |
| EA属性中的算法交易权限未启用 | 重新打开EA属性，允许算法交易。 |
| 当前不是对冲账户 | 更换对冲账户；该面板不会在净持仓账户执行交易。 |
| 同一账户已有一个活动面板实例 | 保留一个活动面板，移除或关闭重复实例。 |
| 手数不符合品种步进 | 查看品种规格，输入允许的最小手数及步进倍数。 |
| 报价已陈旧 | 等待行情恢复，检查市场是否休市和网络连接。 |
| 当前点差超过上限 | 等待点差恢复；不要在开盘、数据时段或流动性异常时强行下单。 |
| 信号突破价已被越过；不追价 | 等待新的已收盘K线信号，不建议手工追价。 |
| 止损或挂单距离不足 | 调整价格或参数，等待市场拉开距离，并检查券商品种规格。 |
| 不支持指定挂单到期时间 | 当前券商或品种不支持该到期模式，面板不会发送永久挂单替代。 |
| 推止损修改0笔、跳过若干笔 | 通常表示现有止损更优、尚未形成保本空间、报价异常或摆动数据不足；查看“专家”日志。 |
| 减仓目标低于最小手数 | 增加总持仓或使用更高比例；EA不会强行改变目标。 |
| 减仓被拒绝：将平掉全部持仓 | 使用一键平仓，或选择更低的减仓比例。 |

## 14. 使用限制与风险提示

- 本EA不提供收益保证，也不构成投资建议。
- EA不会判断趋势、交易区间、信号质量或新闻风险；入场判断由使用者负责。
- 固定手数不等于固定风险。止损距离越大，同样手数的资金风险越高。
- 点差、滑点、跳空、流动性不足和服务器拒绝可能导致实际成交与预期不同。
- 一键操作在解锁后单击即执行，没有第二次确认窗口。
- “所有品种”范围和 `Magic=0` 管理能力较强，可能影响账户中其他手动交易。
- 参数默认值不一定适合所有券商、黄金品种、报价位数、账户规模或交易周期。
- 自动保护不能替代下单时直接附带止损，也不能替代交易者的风险控制。
- 分享给他人前，应让对方先阅读本说明书，并独立完成模拟账户测试。

## 15. 文件校验

本说明书对应的编译文件：`快捷下单面板V1.2.ex5`

SHA-256：

`51484A0B59F09EF7C31E22544EE4399C7B59F69370C1DF3276D884CBED35FC9F`

如果收到的EX5文件哈希不同，可能是文件版本不同或内容已经被修改，应重新确认来源。

---

**建议交付内容**：`快捷下单面板V1.2.ex5` + `快捷下单面板V1.2_使用说明书.docx`