# 蓝精灵AI智能交易系统 v3.21 完整介绍

---

## 一、系统概述

**蓝精灵AI智能交易系统**（英文名：AIV，全称 AI Vision）是一款专为 MetaTrader 5 设计的全功能智能交易机器人（EA）。它融合了**传统技术指标**与**前沿多模态AI视觉分析**，能够自动扫描市场、识别交易机会并执行交易，适用于**外汇、黄金、指数**等品种的自动化交易。

本系统以**单文件构建**（无需外部库或DLL），代码完全透明，内置完整引擎，开箱即用。同时提供**纯指标模式**（无需API）和**AI混合模式**（结合AI视觉与指标过滤），满足从保守到激进的各类交易需求。

---

## 二、核心特性

### 1. 双交易模式，灵活适配

- **纯指标模式（MODE_INDICATORS_ONLY）**  
  仅使用内置的**ADX趋势强度**和**鳄鱼线（Alligator）**进行入场判断，无需任何外部API调用。运行稳定，零成本，适合追求低延迟、低风险的交易者。

- **AI混合模式（MODE_AI_HYBRID）**  
  在指标预过滤的基础上，自动截取**三个时间框架**的图表（入场、确认、背景），发送给多个先进AI模型进行视觉分析，获得方向、置信度及动态止损/止盈价格。AI决策与指标信号共振时才下单，显著提升胜率。

### 2. 多供应商AI支持

系统原生支持以下AI供应商（只需填入API密钥）：

- **Anthropic Claude**（claude-sonnet-4-20250514）
- **OpenAI GPT**（gpt-4o）
- **Google Gemini**（gemini-2.0-flash）
- **DeepSeek**（deepseek-chat）
- **xAI Grok**（grok-2-vision）

系统可自动识别API密钥格式，也可手动指定供应商。所有请求均通过安全的 HTTPS 进行，只需在 MT5 的 WebRequest 白名单中添加对应域名。

### 3. 自适应截图堆栈（时间框架智能匹配）

系统根据您选择的**入场时间框架**（如 M15）自动生成三张图表截图：

| 层级 | 用途 | 示例（入场TF=M15） |
|------|------|-------------------|
| 图表1（入场） | 精确入场时机 | M15 |
| 图表2（确认） | 中期结构确认 | H1 |
| 图表3（背景） | 大趋势背景 | H4 |

AI提示会明确告知模型每个图表对应的实际时间框架名称，确保模型正确理解多周期信息。

### 4. 双账户模式：标准经纪商 + 自营公司/资助账户

- **标准经纪商模式**：内置资金过滤器，可设置**盈利目标**和**亏损限制**，达到条件后停止交易并平仓。
- **自营公司/已资助模式**：提供专业的回撤管理，支持：
  - 每日回撤上限（% 或 固定金额）
  - 总回撤上限（追踪或不追踪高水位线）
  - 每日盈利目标
  - 挑战整体目标
  - 风险单位可选百分比或金额

### 5. 全面的风险控制体系

- **多种风险模式**：固定手数、余额百分比、净值百分比、固定金额风险、可用保证金百分比。
- **马丁格尔（可选）**：支持亏损后手数乘数或步进递增，可设置最大层级和每日重置。
- **止损/止盈灵活配置**：
  - AI动态决定（AI_DECIDES）
  - 固定点数或点值（FIXED_PIPS / FIXED_POINTS）
  - AI决定止损 + 固定风险报酬比（AI_SL_RR）
- **追踪止损**：固定距离、基于ATR、保本+加点三种模式。
- **部分平仓**：可在不同风险报酬比位置平仓部分头寸（TP1, TP2）。

### 6. 多重市场过滤器

- **时间过滤器**：可设定每日交易时间窗口，支持经纪商时间或GMT偏移时间。
- **日期过滤器**：可选择周一至周五是否交易，并支持周五收盘自动平仓。
- **新闻过滤器**：自动读取MT5内置日历，在重点新闻（高/中影响）前后暂停交易，避免剧烈波动。
- **点差过滤器**：当点差超过设定值时禁止开仓。

### 7. 可视化专业面板

系统自带一个实时更新的信息面板，显示：

- 账户余额、净值、可用保证金、日内盈亏
- 当前买卖价、点差
- AI供应商、模型名、调用次数、状态、最新决策及置信度
- 当前持仓（方向、手数、止损/止盈、浮动盈亏）
- 今日交易统计（胜/负次数）
- 风险模式、下笔手数、马丁格尔层级
- 自营公司回撤进度条（每日/总回撤）
- 当前时间（含时区）、下条新闻事件、下次扫描倒计时

面板可**拖动、最小化**，并支持**紧急平仓快捷键**（默认为键盘 `X`）。

### 8. 完全可自定义的参数

所有关键参数（指标周期、颜色、字体、面板尺寸、API超时、截图尺寸等）均通过输入参数开放，用户无需修改源码即可优化适应不同品种和策略风格。

---

## 三、安装与配置

### 3.1 环境要求

- MetaTrader 5 版本 2000+ 以上
- Windows 操作系统
- 如需使用AI模式，需具备对应供应商的API密钥

### 3.2 安装步骤

1. 将本EA文件（.mq5 或 .ex5）放入 MT5 的 `MQL5\Experts\` 目录。
2. 打开 MT5，在导航器中找到 EA，拖拽到图表上。
3. 在弹出窗口中设置输入参数（见下文）。
4. **重要**：若使用AI模式，必须在 **工具 → 选项 → 智能交易系统** 中勾选“允许WebRequest”，并将以下域名加入白名单：
   - `https://api.anthropic.com`
   - `https://api.openai.com`
   - `https://generativelanguage.googleapis.com`
   - `https://api.deepseek.com`
   - `https://api.x.ai`
5. 启用自动交易（“智能交易系统”按钮为绿色）。

### 3.3 关键参数速览

| 参数组 | 关键参数 | 说明 |
|--------|---------|------|
| 交易模式 | `InpTradingMode` | 选择“纯指标”或“AI混合” |
| AI设置 | `InpAPIKey`<br>`InpProviderOverride`<br>`InpMinConfidence` | API密钥（AI模式必需）<br>供应商（auto/anthropic/openai等）<br>最低置信度（默认70%） |
| 账户模式 | `InpAccountType` | 标准/自营公司/已资助 |
| 风险设置 | `InpRiskMode`<br>`InpFixedLot`<br>`InpRiskPercent` | 风险模式、固定手数、风险百分比 |
| 止损/止盈 | `InpSLTPMode`<br>`InpFixedSL_Pips`<br>`InpRiskReward` | 止损/止盈模式、固定值、风险报酬比 |
| 时间框架 | `TF` | 入场时间框架（M1/M5/M15/H1/H4/D1等） |
| 新闻过滤 | `InpUseNewsFilter`<br>`InpNewsMinutesBefore/After` | 启用新闻过滤、前后暂停分钟数 |
| 追踪止损 | `InpUseTrailingStop`<br>`InpTrailMode` | 启用追踪止损、追踪模式 |

完整参数列表请参考源码中的 `input` 区块。

---

## 四、工作原理（核心逻辑）

### 4.1 入场流程

1. **定时扫描**：每隔 `InpScanIntervalSec` 秒执行一次扫描（AI模式下受此限制，纯指标模式不受限制，但也会在每次Tick检查）。
2. **预过滤**：计算当前时间框架的 **ADX** 和 **鳄鱼线** 指标。若 ADX 大于阈值且三线排列与ADX方向一致，则产生初步方向信号（看涨或看跌）。
3. **模式分支**：
   - **纯指标模式**：直接基于预过滤信号计算手数、止损/止盈并开仓。
   - **AI混合模式**：仅在预过滤有方向时，才调用AI API，发送三张截图进行视觉分析。若AI返回的方向与预过滤一致，且置信度 ≥ `InpMinConfidence`，则进入下一步。
4. **风险计算**：根据选择的 `InpRiskMode` 和止损距离，计算开仓手数。若启用马丁格尔，则按乘数或步进调整。
5. **开仓执行**：使用计算出的止损/止盈价格和手数，发送市价单（Buy/Sell）。

### 4.2 持仓管理

- **追踪止损**：每Tick检查是否满足移动条件，并调整止损。
- **部分平仓**：当浮动盈亏达到预设的风险报酬比时，平掉部分仓位。
- **止损/止盈**：始终跟随订单设置，可动态调整（如保本追踪）。

### 4.3 风险控制与停止条件

- **每日/总回撤限制**（自营公司模式）：每日亏损或总回撤超限时，EA停止开新仓并平掉所有持仓。
- **资金过滤器**（标准模式）：净值达到盈利目标或亏损限制时，停止交易。
- **新闻/时间/日期/点差过滤器**：任意条件不满足时，暂停开仓（但持仓管理仍继续）。
- **星期五收盘**：若启用，则在指定时间平仓所有头寸。

---

## 五、性能与兼容性

- **多品种支持**：可在任意品种图表上运行（如 EURUSD, XAUUSD, GBPJPY 等），只需确保品种具有足够的市场深度和流动性。
- **低资源占用**：纯指标模式几乎无额外资源消耗；AI模式仅在扫描间隔时触发网络请求，不影响正常报价处理。
- **日志记录**：所有关键操作（开仓、平仓、错误、AI响应）均打印至“专家”日志，便于回溯和调试。
- **失败重试机制**：AI调用超时或失败时，不会开仓，保证资金安全。

---

## 六、常见问题（FAQ）

**Q1：为什么AI模式不开仓？**  
- 检查API密钥是否有效、余额是否充足；确保 WebRequest 白名单已添加对应域名；查看日志中AI返回的状态信息（如置信度不足、方向不一致等）。

**Q2：纯指标模式是否稳定？**  
- 是的。指标基于标准 MT5 内置指标（ADX 和 Alligator），无外部依赖，且预过滤策略保守，可长期稳定运行。

**Q3：自营公司模式如何配置？**  
- 首先选择账户类型为 `ACCOUNT_PROP_FIRM` 或 `ACCOUNT_FUNDED`，然后设置 `InpPropDailyLossLimit` 和 `InpPropMaxTotalDrawdown`（按百分比或金额）。建议开启 `InpPropUseTrailingDrawdown` 以使用高水位线追踪回撤。

**Q4：如何降低API调用成本？**  
- 提高 `InpScanIntervalSec`（例如设为 300 秒），并适当提高 `InpMinConfidence`（如 80），减少不必要的调用。

**Q5：能否同时运行多个品种？**  
- 可以。为每个品种分别挂载EA，并设置不同的 `InpMagicNumber` 即可。

---

## 七、免责声明

**蓝精灵AI智能交易系统** 是一款辅助交易工具，并不保证盈利。外汇和差价合约交易具有高风险，可能损失全部本金。请务必在充分理解风险的前提下使用，并在模拟账户中充分测试后再上线实盘。开发者不对因使用本软件导致的任何资金损失负责。

---

# 蓝精灵AI智能交易系统 v3.21 完整介绍

---

## 一、系统概述

**蓝精灵AI智能交易系统**（英文名：AIV，全称 AI Vision）是一款专为 MetaTrader 5 设计的全功能智能交易机器人（EA）。它融合了**传统技术指标**与**前沿多模态AI视觉分析**，能够自动扫描市场、识别交易机会并执行交易，适用于**外汇、黄金、指数**等品种的自动化交易。

本系统以**单文件构建**（无需外部库或DLL），代码完全透明，内置完整引擎，开箱即用。同时提供**纯指标模式**（无需API）和**AI混合模式**（结合AI视觉与指标过滤），满足从保守到激进的各类交易需求。

---

## 二、核心特性

### 1. 双交易模式，灵活适配

- **纯指标模式（MODE_INDICATORS_ONLY）**  
  仅使用内置的**ADX趋势强度**和**鳄鱼线（Alligator）**进行入场判断，无需任何外部API调用。运行稳定，零成本，适合追求低延迟、低风险的交易者。

- **AI混合模式（MODE_AI_HYBRID）**  
  在指标预过滤的基础上，自动截取**三个时间框架**的图表（入场、确认、背景），发送给多个先进AI模型进行视觉分析，获得方向、置信度及动态止损/止盈价格。AI决策与指标信号共振时才下单，显著提升胜率。

### 2. 多供应商AI支持

系统原生支持以下AI供应商（只需填入API密钥）：

- **Anthropic Claude**（claude-sonnet-4-20250514）
- **OpenAI GPT**（gpt-4o）
- **Google Gemini**（gemini-2.0-flash）
- **DeepSeek**（deepseek-chat）
- **xAI Grok**（grok-2-vision）

系统可自动识别API密钥格式，也可手动指定供应商。所有请求均通过安全的 HTTPS 进行，只需在 MT5 的 WebRequest 白名单中添加对应域名。

### 3. 自适应截图堆栈（时间框架智能匹配）

系统根据您选择的**入场时间框架**（如 M15）自动生成三张图表截图：

| 层级 | 用途 | 示例（入场TF=M15） |
|------|------|-------------------|
| 图表1（入场） | 精确入场时机 | M15 |
| 图表2（确认） | 中期结构确认 | H1 |
| 图表3（背景） | 大趋势背景 | H4 |

AI提示会明确告知模型每个图表对应的实际时间框架名称，确保模型正确理解多周期信息。

### 4. 双账户模式：标准经纪商 + 自营公司/资助账户

- **标准经纪商模式**：内置资金过滤器，可设置**盈利目标**和**亏损限制**，达到条件后停止交易并平仓。
- **自营公司/已资助模式**：提供专业的回撤管理，支持：
  - 每日回撤上限（% 或 固定金额）
  - 总回撤上限（追踪或不追踪高水位线）
  - 每日盈利目标
  - 挑战整体目标
  - 风险单位可选百分比或金额

### 5. 全面的风险控制体系

- **多种风险模式**：固定手数、余额百分比、净值百分比、固定金额风险、可用保证金百分比。
- **马丁格尔（可选）**：支持亏损后手数乘数或步进递增，可设置最大层级和每日重置。
- **止损/止盈灵活配置**：
  - AI动态决定（AI_DECIDES）
  - 固定点数或点值（FIXED_PIPS / FIXED_POINTS）
  - AI决定止损 + 固定风险报酬比（AI_SL_RR）
- **追踪止损**：固定距离、基于ATR、保本+加点三种模式。
- **部分平仓**：可在不同风险报酬比位置平仓部分头寸（TP1, TP2）。

### 6. 多重市场过滤器

- **时间过滤器**：可设定每日交易时间窗口，支持经纪商时间或GMT偏移时间。
- **日期过滤器**：可选择周一至周五是否交易，并支持周五收盘自动平仓。
- **新闻过滤器**：自动读取MT5内置日历，在重点新闻（高/中影响）前后暂停交易，避免剧烈波动。
- **点差过滤器**：当点差超过设定值时禁止开仓。

### 7. 可视化专业面板

系统自带一个实时更新的信息面板，显示：

- 账户余额、净值、可用保证金、日内盈亏
- 当前买卖价、点差
- AI供应商、模型名、调用次数、状态、最新决策及置信度
- 当前持仓（方向、手数、止损/止盈、浮动盈亏）
- 今日交易统计（胜/负次数）
- 风险模式、下笔手数、马丁格尔层级
- 自营公司回撤进度条（每日/总回撤）
- 当前时间（含时区）、下条新闻事件、下次扫描倒计时

面板可**拖动、最小化**，并支持**紧急平仓快捷键**（默认为键盘 `X`）。

### 8. 完全可自定义的参数

所有关键参数（指标周期、颜色、字体、面板尺寸、API超时、截图尺寸等）均通过输入参数开放，用户无需修改源码即可优化适应不同品种和策略风格。

---

## 三、安装与配置

### 3.1 环境要求

- MetaTrader 5 版本 2000+ 以上
- Windows 操作系统
- 如需使用AI模式，需具备对应供应商的API密钥

### 3.2 安装步骤

1. 将本EA文件（.mq5 或 .ex5）放入 MT5 的 `MQL5\Experts\` 目录。
2. 打开 MT5，在导航器中找到 EA，拖拽到图表上。
3. 在弹出窗口中设置输入参数（见下文）。
4. **重要**：若使用AI模式，必须在 **工具 → 选项 → 智能交易系统** 中勾选“允许WebRequest”，并将以下域名加入白名单：
   - `https://api.anthropic.com`
   - `https://api.openai.com`
   - `https://generativelanguage.googleapis.com`
   - `https://api.deepseek.com`
   - `https://api.x.ai`
5. 启用自动交易（“智能交易系统”按钮为绿色）。

### 3.3 关键参数速览

| 参数组 | 关键参数 | 说明 |
|--------|---------|------|
| 交易模式 | `InpTradingMode` | 选择“纯指标”或“AI混合” |
| AI设置 | `InpAPIKey`<br>`InpProviderOverride`<br>`InpMinConfidence` | API密钥（AI模式必需）<br>供应商（auto/anthropic/openai等）<br>最低置信度（默认70%） |
| 账户模式 | `InpAccountType` | 标准/自营公司/已资助 |
| 风险设置 | `InpRiskMode`<br>`InpFixedLot`<br>`InpRiskPercent` | 风险模式、固定手数、风险百分比 |
| 止损/止盈 | `InpSLTPMode`<br>`InpFixedSL_Pips`<br>`InpRiskReward` | 止损/止盈模式、固定值、风险报酬比 |
| 时间框架 | `TF` | 入场时间框架（M1/M5/M15/H1/H4/D1等） |
| 新闻过滤 | `InpUseNewsFilter`<br>`InpNewsMinutesBefore/After` | 启用新闻过滤、前后暂停分钟数 |
| 追踪止损 | `InpUseTrailingStop`<br>`InpTrailMode` | 启用追踪止损、追踪模式 |

完整参数列表请参考源码中的 `input` 区块。

---

## 四、工作原理（核心逻辑）

### 4.1 入场流程

1. **定时扫描**：每隔 `InpScanIntervalSec` 秒执行一次扫描（AI模式下受此限制，纯指标模式不受限制，但也会在每次Tick检查）。
2. **预过滤**：计算当前时间框架的 **ADX** 和 **鳄鱼线** 指标。若 ADX 大于阈值且三线排列与ADX方向一致，则产生初步方向信号（看涨或看跌）。
3. **模式分支**：
   - **纯指标模式**：直接基于预过滤信号计算手数、止损/止盈并开仓。
   - **AI混合模式**：仅在预过滤有方向时，才调用AI API，发送三张截图进行视觉分析。若AI返回的方向与预过滤一致，且置信度 ≥ `InpMinConfidence`，则进入下一步。
4. **风险计算**：根据选择的 `InpRiskMode` 和止损距离，计算开仓手数。若启用马丁格尔，则按乘数或步进调整。
5. **开仓执行**：使用计算出的止损/止盈价格和手数，发送市价单（Buy/Sell）。

### 4.2 持仓管理

- **追踪止损**：每Tick检查是否满足移动条件，并调整止损。
- **部分平仓**：当浮动盈亏达到预设的风险报酬比时，平掉部分仓位。
- **止损/止盈**：始终跟随订单设置，可动态调整（如保本追踪）。

### 4.3 风险控制与停止条件

- **每日/总回撤限制**（自营公司模式）：每日亏损或总回撤超限时，EA停止开新仓并平掉所有持仓。
- **资金过滤器**（标准模式）：净值达到盈利目标或亏损限制时，停止交易。
- **新闻/时间/日期/点差过滤器**：任意条件不满足时，暂停开仓（但持仓管理仍继续）。
- **星期五收盘**：若启用，则在指定时间平仓所有头寸。

---

## 五、性能与兼容性

- **多品种支持**：可在任意品种图表上运行（如 EURUSD, XAUUSD, GBPJPY 等），只需确保品种具有足够的市场深度和流动性。
- **低资源占用**：纯指标模式几乎无额外资源消耗；AI模式仅在扫描间隔时触发网络请求，不影响正常报价处理。
- **日志记录**：所有关键操作（开仓、平仓、错误、AI响应）均打印至“专家”日志，便于回溯和调试。
- **失败重试机制**：AI调用超时或失败时，不会开仓，保证资金安全。

---

## 六、常见问题（FAQ）

**Q1：为什么AI模式不开仓？**  
- 检查API密钥是否有效、余额是否充足；确保 WebRequest 白名单已添加对应域名；查看日志中AI返回的状态信息（如置信度不足、方向不一致等）。

**Q2：纯指标模式是否稳定？**  
- 是的。指标基于标准 MT5 内置指标（ADX 和 Alligator），无外部依赖，且预过滤策略保守，可长期稳定运行。

**Q3：自营公司模式如何配置？**  
- 首先选择账户类型为 `ACCOUNT_PROP_FIRM` 或 `ACCOUNT_FUNDED`，然后设置 `InpPropDailyLossLimit` 和 `InpPropMaxTotalDrawdown`（按百分比或金额）。建议开启 `InpPropUseTrailingDrawdown` 以使用高水位线追踪回撤。

**Q4：如何降低API调用成本？**  
- 提高 `InpScanIntervalSec`（例如设为 300 秒），并适当提高 `InpMinConfidence`（如 80），减少不必要的调用。

**Q5：能否同时运行多个品种？**  
- 可以。为每个品种分别挂载EA，并设置不同的 `InpMagicNumber` 即可。

---

## 七、免责声明

**蓝精灵AI智能交易系统** 是一款辅助交易工具，并不保证盈利。外汇和差价合约交易具有高风险，可能损失全部本金。请务必在充分理解风险的前提下使用，并在模拟账户中充分测试后再上线实盘。开发者不对因使用本软件导致的任何资金损失负责。

---