VibeFox Gartley
- 指标
- 版本: 1.0
- 激活: 5
VibeFox Gartley — 带 Fibonacci 验证入场点的 XABCD 谐波形态
VibeFox Gartley 是一款用于 MetaTrader 5 的实时谐波形态指标。它扫描价格的摆动结构，找出经典的 Gartley XABCD 形态，用 Fibonacci 比率对其进行验证，并在形态完成时直接在价格图表上标出入场点。每个控件都汇集到一个现代化的交互式面板中，因此您无需手动测量各段，而是在谐波形态和交易思路形成的那一刻就看到它们。
指标如何工作
该指标分三个阶段工作：首先构建市场的摆动骨架，然后在该骨架中搜索有效的 Gartley 形态，最后在完成点 D 处放置 Buy 或 Sell 标记。
1. 摆动枢轴（ZigZag）
内置的 ZigZag 引擎过滤掉细微的价格噪声，只保留有意义的转折点——摆动高点（波峰）和摆动低点（波谷）。由三个经典参数控制它。Depth 设置两个枢轴之间的最小柱数，从而忽略小幅波动。Deviation 是注册一个新枢轴所需的最小反转幅度，用于过滤浅幅回调。Backstep 是同类型两个极值之间的最小柱数。它们共同作用，将摆动检测从快速、细致调整为缓慢、仅显示主要摆动。Bars 设置限制处理多少历史数据——0 扫描所有可用柱，较小的值可在繁重的图表上更快重绘。
2. Gartley 形态（XABCD）
指标从交替摆动枢轴链中扫描每个连续的五点序列 X-A-B-C-D，并检查各段是否符合 Gartley 的 Fibonacci 比例。验收区间保持得足够宽，以便真实图表上的形态能够通过验证，同时仍然类似于真正的 Gartley：
AB/XA 在 0.382 和 0.886 之间（理想值 0.618）；BC/AB 在 0.236 和 0.950 之间；CD/BC 在 1.0 和 3.618 之间（C 到 D 的延伸）；AD/XA 在 0.5 和 1.0 之间（理想值 0.786），并有严格规则：点 D 不得超过点 X。只有当全部四个比率都落在各自的区间内时，形态才被接受、连同其连接线绘制在图表上，并转化为一个入场。
3. 在点 D 入场
每个经过验证的形态恰好产生一个入场，放置在其完成点 D——谐波结构完成、价格预期从 D 区反转的那一刻。
入场点
VibeFox Gartley 的主要价值在于其自动入场点：指标会自行验证形态，并在价格图表上直接放置清晰的标记。提供两种独立的形态方向，每种都有各自的开关。
看涨 Gartley — 在点 D BUY
看涨 Gartley 是序列 X(低点) A(高点) B(低点) C(高点) D(低点)，其中 D 是位于 X 之上的摆动低点。当其通过验证时，在点 D 放置一个 BUY 标记——指向 D 的下跌段已完成，价格预期转涨。
看跌 Gartley — 在点 D SELL
看跌 Gartley 是镜像序列 X(高点) A(低点) B(高点) C(低点) D(高点)，其中 D 是位于 X 之下的摆动高点。当其通过验证时，在点 D 放置一个 SELL 标记——指向 D 的上涨段已完成，价格预期转跌。
买入和卖出标记分别用 Buy Color 和 Sell Color 设置着色，因此方向一目了然。Marker 选择器可在简单的十字（+）、实心三角形或带尾箭头之间切换字形，而 Size 控件以像素（6 到 40）缩放标记，以适应任何图表密度。
完整的视觉控制
形态线的颜色用 Pattern Line Color 设置，粗细用 Pattern Line Width 设置为 1 到 5 像素。形态线和两个入场标记都在取色器弹窗中支持透明度设置（0-100%），因此您可以将它们柔和地融入图表背景。价格图表上的标记的大小和颜色是独立的，因此入场点在任何背景下都清晰突出。
图表上的交互式面板
整个界面是一个流畅的基于画布的面板，专为快速鼠标操作而构建。摆动参数被整齐地汇集成行，入场区块用其自己的金色 ENTRY 标题分隔开，因此信号设置不会与形态设置混淆。面板标题栏放置着控制图标。
Power — 在不从图表移除指标的情况下，打开和关闭入场标记的绘制。
Settings (齿轮) — 打开和关闭设置区块。
Updown (箭头) — 在其子窗口和主图表之间移动面板。
Close (十字) — 关闭指标。
Resizable — 拖动右下角以缩放面板。
Collapsible — 双击标题栏可将面板折叠为紧凑的条带。
Mouse wheel — 将光标悬停在任何数字字段上并滚动滚轮即可更改数值，无需打开键盘。
设置与个性化
Settings 按钮打开一个区块，可将面板适配到您的工作区：浅色、深色或自动 Theme、可调的面板宽度、标题大小、行高和字体大小。额外的细节让您可以通过 Hide Footer 隐藏底部栏，用 Mini Header 在折叠时缩小标题，以及在点击面板外部时自动折叠面板。几乎每个参数都可在面板上实时更改——Inputs 选项卡上的输入字段仅设置起始值。您还可以在一张图表上运行多个独立副本，为每个副本指定唯一的 Instance，以并排比较不同的摆动设置。
入场通知
您无需坐着盯着图表等待形态。每个入场都可以通过多个通知渠道发送，这些渠道在面板上独立启用。
Alert — 终端内的弹出消息。
Push — 推送到您手机上 MetaTrader 应用的移动通知。
Email — 通过终端邮件设置发送的邮件。
Telegram — 警报文本连同图表截图，直接发送到您的 Telegram 聊天。
仅启用您需要的渠道，当您正在使用的品种和时间周期上有新的 Gartley 完成时，您就会立即收到通知。
可视化历史（HTML 报告）
启用 Html 渠道后，每个入场信号都会连同触发时的图表截图一起保存到 HTML 报告中。报告存储在终端的 Files 文件夹中的 VibeFox_Gartley 目录下（MQL5/Files/VibeFox_Gartley/result.html），可在任何浏览器中打开——您将获得指标找到的所有形态的可视化日志。一键垃圾桶按钮可在您想要重新开始时随时清除报告及其截图。
Telegram 警报
信号也可以直接发送到您的 Telegram 聊天——警报文本连同检测时刻的图表截图。开启 Telegram 渠道，并在输入参数中输入您的机器人令牌和聊天 id。
传送依托于 HTML 报告：每个新信号都写入报告，而在浏览器中打开的报告会自行将其转发到您的 Telegram 聊天。因此，启用 Telegram 会自动保持 Html 报告开启，两个渠道协同工作。
内置多语言帮助
面板内置了完整的帮助页面，提供多种语言版本，因此每个控件都在您使用它的位置得到解释。
参数（Inputs 选项卡）
大多数设置也可以在面板上实时更改（Settings 按钮）——输入参数仅设置启动时的初始值。
Gartley (swings)
Swing Depth — 两个枢轴之间的最小柱数（2..100）。默认值：12。
Swing Deviation — 注册一个新枢轴所需的最小反转幅度（以点数计）。默认值：5。
Swing Backstep — 两个极值之间的最小柱数。默认值：3。
Bars of history to process — 向后扫描多少根柱来寻找摆动，0 = 所有可用。默认值：500。
Pattern Line Color — 价格图表上 Gartley 形态线的颜色。默认值：DodgerBlue。
Line Transparency — 形态线透明度（百分比），0-100。默认值：0。
Pattern Line Width — 线条粗细（像素），1..5。默认值：1。
Entry Points
Bullish Gartley (BUY at D) — 启用看涨形态及其在点 D 的 BUY 标记。默认值：开启。
Bearish Gartley (SELL at D) — 启用看跌形态及其在点 D 的 SELL 标记。默认值：开启。
Marker Font Size — 入场标记的大小（像素），6..40。默认值：12。
Entry Marker — 标记字形：Cross (+)、Triangle 或 Arrow。默认值：Arrow。
Buy Color — BUY 标记的颜色。默认值：LimeGreen。
Buy Transparency — 买入标记透明度（百分比），0-100。默认值：0。
Sell Color — SELL 标记的颜色。默认值：Red。
Sell Transparency — 卖出标记透明度（百分比），0-100。默认值：0。
Notifications
Push Notification — 启用推送到 MetaTrader 移动应用的警报。默认值：关闭。
Alert Popup — 启用终端内的弹出警报。默认值：关闭。
Email — 通过终端邮件设置启用邮件警报。默认值：关闭。
Html Report — 将每个信号连同图表截图保存到 Files/VibeFox_Gartley/result.html。默认值：关闭。
Telegram — 通过 HTML 报告将带图表截图的信号转发到 Telegram 聊天。默认值：关闭。
Telegram - bot token — 用于传送的 Telegram 机器人令牌。默认值：空。
Telegram - chat id — 目标 Telegram 聊天标识符。默认值：空。
Panel / Settings
Panel width, px — 图表上面板的宽度（像素），300..800。默认值：800。
Header size — 面板标题栏的高度，1..6。默认值：1。
Theme — 面板的配色主题：Light、Dark 或 Auto。默认值：Auto。
Row height (px) — 每个参数行的高度（像素）。默认值：34。
Font size — 面板内使用的字体大小。默认值：8。
Hide Footer — 隐藏面板的底部栏。默认值：关闭。
Mini Header on collapse — 面板折叠时显示紧凑的标题条。默认值：关闭。
Close on click outside — 在面板外部点击时自动折叠面板。默认值：关闭。
Instance — 同一图表上每个指标副本的唯一编号，允许并排运行多个实例。默认值：1。
Panel Start Window — 设置面板的初始位置：主图表或子窗口。默认值：Subwindow。
