V4.80 EA 详细介绍与使用说明

MT5需要添加https://dgcai.vip/到白名单，密钥注册与充值也需要通过此网站进行https://dgcai.vip/
本EA为交易辅助也可以自动交易请仔细阅读使用说明进行手工设置。

一、软件定位与验证边界

本工具运行于MetaTrader 5，集成本地技术评分、多周期分析、SMC结构、黄金分割、支撑阻力、AI文本分析、裸K视觉分析以及可选交易执行。评分不是胜率，AI结论不是收益保证。

本文依据V4.80源码与参数整理。此前仅完成静态检查，未进行MetaEditor原生编译、MT5截图、经济日历、网络或订单实测。必须先在目标终端编译并通过模拟账户验收。


二、安装与第一次启动

1. 在MT5选择文件→打开数据文件夹，把源码放到MQL5/Experts目录。

2. 用MetaEditor打开源码，按F7编译。出现错误时先解决编译错误，不要加载旧EX5假定新源码已生效。

3. 在导航器刷新EA列表，将编译成功的EA拖到目标品种图表。

4. 在输入参数窗口点击重置，再填写必要设置。旧模板和set参数可能覆盖源码默认值。

5. 只做分析时无需打开真实交易权限；需要交易时允许终端Algo Trading与EA交易权限，并检查账户许可。

6. 配置自己的API密钥、服务商可用模型及服务商要求的WebRequest白名单域名。注册地址不是可以任意替换的交易接口；现有接口配置仍受源码校验约束。

7. 等待历史及指标同步。窄窗口自动使用标签布局，顶部AI按钮可切换到AI报告页。

8. 模拟账户先测纯分析，再测单笔交易，最后测批量、新闻风控和反转管理。

源码保留密钥占位符。曾在会话中公开的密钥应撤销更换，不要分享带密钥的参数截图、set文件或源码。


三、当前关键默认设置

主分析周期M5；正常刷新3秒；同步重试2秒；多周期M5/M15/M30/H1/H4。EMA20/50/200，RSI14，MACD12/26/9，ADX14。

主面板及AI面板显示开启，深色主题，字体Microsoft YaHei，正文/标题/按钮默认9号。主面板500×820，AI面板780×820，实际尺寸受图表空间约束。

文本与视觉自动分析默认关闭，启动后立即分析关闭。模型默认gemini-3.8-flash，但服务商是否实际支持该名称及图片输入需要自行验证。请求超时35000毫秒，失败重试3次。

主分析自动交易关闭，但主分析反转平仓和反转撤单默认开启：即使不开新仓，也可能管理已有同品种、主分析Magic订单，使用前务必核对。

支撑阻力计算开启，水平线显示关闭；三类交易参考虚线开启。新闻提醒开启，新闻停单、新闻自动平仓、新闻撤单均关闭。

AI单层手数0.01，挂单数量1，间隔5.00报价单位；AI Magic44001，主分析Magic44002；最大滑点55 points，最大点差355 points；报价最大有效10秒，AI计划最大有效15分钟。


四、本地主分析与参数分组

基础设置：开启指标是初始化总开关，关闭会拒绝初始化；分析周期决定主评分使用的周期，不必等于当前图表周期。设为当前周期时才跟随图表。

同步延时：加载及新K线同步时延时周期秒数/60，最少2秒、最多10秒。指标未就绪每2秒重试；延时结束不代表数据一定就绪，仍检查历史及缓冲。

技术指标：EMA观察趋势层级，RSI与MACD观察动量，ADX观察趋势强度。大周期参数需要更多历史。MACD慢线必须大于快线。

综合评分：趋势/动量/结构/位置默认35/25/20/20。分数体现模型方向与强弱，不是命中率或保证。闭合K线评分默认开启，降低未收盘信号变化。

多周期：五个周期独立读取，反映方向一致和冲突。图表切换不等于后台分析周期全部随之改变。

SMC：Swing长度3、历史300用于摆动结构；BOS为结构突破，CHoCH为结构变化，订单块显示潜在结构区域。结构模型不代表真实机构订单。

黄金分割：默认自动高低点，检测300根。Fibo锚点模式0/1/2由源码控制，选择前需结合实际报告核对，不把缺失锚点当作有效信号。

支撑阻力：检测300根，每侧最多5个；关闭显示只隐藏线条，不关闭计算。ATR容差模式默认开启，容差为ATR×0.25；该模式开启时不直接使用固定价格合并范围50。

共振：28项指标含均线、斜率、SAR、一目、ADX、MACD、RSI、随机、CCI、WPR、动量、ROC、DeMarker、AO、AC、TRIX、RVI、多空力量、布林带、唐奇安、肯特纳、ATR、OBV、MFI、Force、AD、CMF、VWAP。

共振至少4个有效指标、最低覆盖0.60；趋势/动量/通道/量能权重各1，参与综合评分融合30%。ATR是非方向过滤，不是额外买卖票。相近指标不构成互相独立证据。

每项Use是开关，Period是周期，Weight是权重；复合指标还使用额外慢线、信号、偏差或倍数。部分合成指标使用EA计算而非平台独立指标。启用项仍需参数及数据有效。

分析诊断：日志级别1、ATR14、提醒冷却300秒；CSV导出默认关闭。导出数据仅分析用途，不是交易凭证。


五、界面与图层

顶部隐藏/显示控制面板可见性；主分析和AI切换页面；A+/A-调节正文字号；展开为当前页全宽；上一页/下一页浏览报告。

面板不是操作系统独立窗口，而是当前图表对象。窗口不足时主分析与AI合并为标签显示，不表示AI功能缺失。页容量按实际字体与可用空间计算，旧每页行数参数不保证固定显示行数。

V4.80显示面板时设置图表非前景，并把非面板的价格坐标对象放到背景。隐藏或卸载恢复保存的层级，不删除用户对象。

其他EA的固定像素标签、按钮、编辑框和位图标签没有强制改层；MT5工具栏、独立窗口和指标子窗口也不受本面板控制。因此不能承诺覆盖任何插件的所有界面。


六、文本AI操作

1. 启用AI分析，配置正确接口、密钥、白名单及模型。

2. 点击手工分析，等待数据同步、队列、网络请求和重试状态。

3. 点击文本AI结果查看对应报告，检查完成时间、价位校验和交易状态。

4. 如果需要定期分析，通过自动分析按钮开启；自动分析本身不等于自动开单。

指标数据模式0自动读取后台有效启用指标；模式1不附加共振数据，但仍可能提供基础快照。多周期联合分析用于比较已收盘数据，不得将主周期指标当作所有周期证据。

AI请求队列容量4、数据等待60秒、交易授权等待180秒、最大响应200000字符。同步WebRequest会阻塞EA事件处理，取消无法立即中断已经发送的同步请求。


七、裸K视觉AI操作

点击AI视觉分析，EA在临时图表生成1200×800裸K截图并发送给支持图片的模型。多周期截图默认开启，仅使用实际成功截图。

视觉三项指标选择是旧兼容参数，在当前固定裸K模式下不加载指标。后台共振指标可能作为独立结构化数据附加，不意味着它们画在截图中。

默认自动视觉关闭，间隔5分钟，失败冷却60秒，图表等待超时12秒。截图可能短暂切换焦点，完成后恢复EA图表。

截图失败时查看图表宽高、周期和数据报错；终端渲染不可用、历史不足、最小化或模型无图片权限均可能失败。不得把没有截图的请求当作成功视觉分析。


八、AI交易计划格式

报告末尾需唯一[交易价位JSON]标记，其后是仅包含side、entry、stop_loss、take_profit的JSON对象。

示例仅演示格式，不是推荐交易：{"side":"buy","entry":100.0,"stop_loss":99.0,"take_profit":102.0}。

buy要求止损<入场<止盈；sell要求止盈<入场<止损；价格为有限正数，不加引号或单位。wait必须三个价格null，不下单。

文本和视觉都提供Bid/Ask、步长、最小距离及可用ATR等上下文；但模型仍可能遗漏字段。EA显示缺少标记、重复标记、截断、缺字段、观望或方向不正确，不能强制绕过。

解析可兼容代码围栏、标记缩进及普通尾部说明，仍拒绝多个JSON计划、未知/重复字段、缺失/无效价格。


九、交易按钮与区别

手工分析、AI视觉分析：只分析，不因点击直接下单。

文本市价交易、文本按价挂单、视觉市价交易、视觉按价挂单：发起对应来源的新分析；成功且完整计划有效时延迟约2秒自动提交，不弹第二次确认。此时可以点击取消分析；K线变化或180秒授权超时则只保留报告。

文本强制市价/挂单、视觉强制市价/挂单：不重新分析，直接执行对应来源最近有效计划，没有二次确认。点击前先核对方向及账户，按钮是实际交易指令。

强制市价按当前报价平移计划，维持原止损/止盈距离；强制突破挂单按当前报价、报价步长及最小距离定位首层，再按后台间隔排列。

普通市场交易使用当前执行报价但保持原分析SL/TP，当前报价越过原SL/TP则拒绝；普通突破挂单首价用AI价位，BuyStop须高于Ask，SellStop须低于Bid，不满足不会改成Limit。

强制有10秒点击冷却及独立提交记录。普通与强制同计划可能各执行一次；同来源、同计划、同模式不可重复提交。结果不确定时也保留记录，应核对账户，不靠连续点击重发。

强制仍检查来源、有效期、方向、手数、权限、报价、点差、保证金、SLTP、交易商规则以及开启的新闻禁单。净额账户同品种已有仓位或活动订单会拒绝新交易以防合并影响旧仓位。



十、批量突破挂单

数量1～20，每层0.01手（可修改）。总计划手数=数量×每层手数，不是把总手数平均分配。

间隔5.00表示报价单位。黄金美元报价通常为5美元；不是5 points或5倍买卖点差。points参数则需要乘品种_Point理解。

假设首买挂单3000、数量3、间隔5，层价3000/3005/3010；首卖挂单3000则3000/2995/2990。此处仅说明排列，能否提交需满足实际Bid/Ask及品种规则。

每层SL/TP等距平移。多层间隔小于tick size会拒绝，防止不同层舍入到同一价格。

每层先校验，发送前再次OrderCheck。批次不是原子操作，中途失败会停止后续层，之前接受的挂单不会自动撤回。已接受不等于已成交，部分成交也需核对。


十一、主分析自动交易与反转管理

默认不开新仓。开启前核对闭合K线评分、模式、手数、Magic、阈值20、风险ATR×1.5、收益风险比2。

主分析按当前闭合K线有效综合评分生成方向和ATR风险计划。数据/分数不足或已占用仓位/订单时不贸然开新仓。

使用终端全局记录和比较交换按K线去重；首次建立记录预留启动K线，可能需要等待下一根。此记录不是跨终端幂等保证，用户删除记录和重装环境会影响行为。

反转管理默认两个开关开启，只管理主分析Magic44002及当前品种，不管理AI Magic44001或其他手工订单。即使自动交易关闭，已有主分析仓位仍可能被管理。

反转自动平仓仅对冲账户执行，净额账户无法可靠区分混合仓位归属。撤单和平仓请求可能受服务器限制，未保证全部成功。


十二、新闻提醒与新闻风险

数据源是MT5经济日历，不包括全部新闻文章或突发事件。按交易服务器时间处理，默认高重要性、提前15分钟提醒、按品种基础/盈利货币筛选，查询60秒。

自定义货币列表使用USD,EUR等逗号分隔货币代码，非空时覆盖品种货币筛选；空且关闭品种筛选时范围更广。黄金品种基础货币/盈利货币是否正确由交易商资料决定。

新闻时段停止下单默认false，需要保护时开启。新闻前/后停止默认各15分钟，可分别0～1440。例如事件14:30，前20后10即14:10至14:40禁新单。

开启停单后，所有AI、强制和主分析新订单路径检查窗口。日历未知/连接异常/元数据不完整/回测无日历时保守拒绝新单，不会仅因未知而自动平仓。

新闻自动平仓与新闻撤销挂单默认false，两者独立于停单开关。可以仅撤单，也可以停单但保留已提交挂单；只开启停单不能阻止旧挂单在窗口内触发。

管理仅当前品种、两个Magic44001/44002，非整个账户所有订单。净额账户跳过自动平仓。每5秒最多一次管理尝试，发送过的ticket锁定避免不确定重试；部分成交/发送不确定可能留有仓位，需人工核对。

风险快照正常时最多30秒重新查询，窗口每次按当前时间重算。关闭声音/弹窗提醒不等于关闭风险检查，反之亦然。


十三、取消与清空

取消分析：停止排队/重试与待提交AI交易任务；无法立即打断同步网络/截图，不撤销已经提交的订单。

清空AI结果：清除文本/视觉报告、时间、页码、缓存、两类交易计划和参考线，关闭两类AI自动分析，停止未提交任务。

不会平仓、撤挂单、清本地主分析、删除支撑阻力或重置订单提交去重。清空后需要重新分析，不能靠清空重发旧订单


十四、推荐验收顺序

1. 重置参数，在模拟账户关闭自动交易、反转管理、新闻平仓撤单，仅检查面板和行情。

2. 测试周期切换、等待恢复、面板隐藏/显示及图层恢复。

3. 测试文本和视觉分别生成报告及有效价位，确认失败与观望不会下单。

4. 用最小合规手数测试普通单层和强制单层，确认SLTP、Magic、报价和retcode。

5. 测试多层挂单，检查总暴露、间隔、失败后的已接受订单。

6. 在可验证事件时间测试新闻禁单和受限平仓撤单；核对服务器时区。

7. 最后单独开启主分析自动交易，测试每K去重及反转管理。


十五、常见问题

加载即退出：确认编译的是本版本，查看Experts/Journal的初始化返回和退出reason，保留首次错误而非仅最后退出行。旧诊断字符串可能仍显示V4.76，不能只凭日志前缀认定加载版本，应核对文件与编译时间。

无AI界面：显示AI独立面板需开启；点击顶部AI或显示，扩大窗口。网络错误不会必然阻止本地界面，但参数或基础句柄失败会使EA初始化失败。

等待数据：需要历史、指标缓冲和完整分析模块就绪。保持联网、打开目标周期历史，等待自动重试；不要关闭安全校验去使用旧评分。

AI失败：检查白名单、服务商密钥、接口校验、模型权限、余额、35秒超时及网络。不要分享密钥排错。

视觉失败：检查临时图表、历史、窗口渲染与图片模型支持，提供宽高/周期完整错误。

没有有效价位：提供报告末尾JSON和价位校验文字。换新版本后要重新分析，旧报告不会自动补齐。

拒绝交易：查看交易状态、retcode、error、comment、订单号及账户实况。常见原因是观望、过期、重复、净额已有仓位、交易权限、点差、最小距离和新闻窗口。

遮挡仍存在：确认对象是否属于其他插件固定像素控件，截图并说明其来源。不能仅提高ZORDER解决绘制层问题。


十六、最后的使用边界

本软件不能保证盈利、AI准确性、服务器执行速度、新闻完整性或所有订单成交。需要稳定网络和交易商支持。

订单失败或状态不确定时先核对账户。不要快速连点强制按钮，也不要删除去重记录试图强行重发。

本说明是当前源码操作指南，不构成买卖建议。实际账户的风险预算、手数和是否启用自动化由使用者决定。

AI视觉分析准确率80%以上，任何问题与好的建议欢迎大家给我反馈！！！