VibeFox Market Phases
- 指标
- 版本: 1.0
- 激活: 5
VibeFox Market Phases — 带彩色阶段区与脉冲入场的市场周期分类器
VibeFox Market Phases 是一款用于 MetaTrader 5 的实时市场状态指标。它无需您自行猜测市场究竟是横盘、蓄势、突破还是趋势，而是将每一根 K 线归入四个阶段之一，并将其作为彩色背景区直接绘制在价格图表上。当市场进入全新的脉冲时，会在转换处放置清晰的 BUY 或 SELL 标记，所有控件都汇聚到一个现代化的交互面板中。
指标的工作原理
分类遵循 SL / Kenderov 方法论：市场并非随机运动，而是循环经历四个反复出现的阶段 — Range → Consolidation (Squeeze) → Activity (Breakout) → Trend，随后再回到新的 Range。每个阶段都需要不同的交易方式，因此了解当前阶段已是成功的一半。
为了在每根收盘 K 线上检测阶段，指标结合了两种经典引擎 — ATR（Average True Range，用于衡量波动率）与带 +DI / -DI 方向线的 ADX（用于衡量趋势强度与方向）。它还跟踪近期区间内 ATR 的滚动均值以及近期价格带（最高价 / 最低价），以发现突破。基于这些数据，它逐根 K 线判断市场处于哪个阶段，并将相邻 K 线归并为连续的彩色段。
Range（平衡 / 横盘）
ADX 低于 ADX Low 阈值，价格在一个区间内振荡。没有趋势 — 明智的做法是在区间边缘交易，而非突破。以 Range 颜色绘制。
Squeeze（盘整）
波动率收缩：当前 ATR 跌破其近期平均 ATR 的 Squeeze %。弹簧正在蓄力，一波行情正在酝酿 — 此时应准备突破，而非追逐平静的区间。以 Squeeze 颜色绘制。
Activity（突破）
ATR 从挤压中向上转折，价格突破近期价格带，ADX 升穿 ADX Low 水平。这是行情的诞生 — 市场正在苏醒并选定方向。以 Active 颜色绘制。
Trend（脉冲）
ADX 攀升至 ADX High 阈值之上并具有方向性：当 +DI 高于 -DI 时为 Trend Up（绿色）阶段，否则为 Trend Down（红色）阶段。这是趋势跟踪工具最有效的时段。Upper 与 Down 颜色分别绘制两个趋势方向。
入场点
VibeFox Market Phases 的核心价值在于：在市场确立全新脉冲的那一刻自动入场。指标会自行监视阶段转换，并在价格图表上放置清晰的标记。当阶段转入趋势时即触发入场：当阶段从 Squeeze、Activity 或 Range 切换为 Trend Up 时，放置 BUY 标记；当其切换为 Trend Down 时，出现 SELL 标记。这样可在脉冲起点处捕捉行情，而非中途追逐。
两个方向通过 Long（在上行脉冲处 BUY）与 Short（在下行脉冲处 SELL）独立切换。买入与卖出标记分别由 Buy 与 Sell 设置着色，因此方向一目了然。Marker 选择器可在简单的十字（+）、实心三角形或带尾箭头之间切换字形，而 Size 控件可按像素（6 到 40）缩放标记，以适应任何图表密度。通知按每根收盘 K 线发送一次。
全面的视觉控制
五种阶段颜色 — Range、Squeeze、Active、Upper（Trend Up）与 Down（Trend Down）— 每一种都有自己的取色器和独立的透明度（0-100%），因此区域可以柔和地融入图表背景，也可以醒目地显示。入场标记同样具有自己的透明度。阶段区作为对象绘制在价格图表（窗口 0）上，而指标本身则位于其自己的子窗口中，控制面板就设在那里。
图表上的交互面板
整个界面是一个基于画布的流畅面板，专为快速鼠标操作而打造。阶段参数与颜色色块被整理成整齐的行，入场区块则用其自己的金色 ENTRY 标题单独分隔出来，使信号设置不会与阶段设置混淆。面板标题栏中放置着控制图标。
Power — 在不移除指标的情况下开关入场标记的绘制；阶段区保持不变。
Settings (gear) — 打开和关闭设置区块。
Updown (arrows) — 在其子窗口与主图表之间移动面板。
Close (cross) — 关闭指标。
Resizable — 拖动右下角以缩放面板。
Collapsible — 双击标题栏可将面板折叠为紧凑的条带。
Mouse wheel — 将鼠标悬停在任意数值字段上并滚动滚轮即可更改数值，无需打开键盘。
设置与个性化
Settings 按钮会打开一个区块，可将面板适配到您的工作区：浅色、深色或自动的 Theme，可调的面板宽度、标题栏大小、行高与字体大小。额外的细节让您可以通过 Hide Footer 隐藏底部栏，通过 Mini Header 在折叠时缩小标题栏，并在点击面板外部时自动折叠面板。几乎每个参数都能在面板上实时更改 — Inputs 选项卡上的输入字段仅设定起始值。您还可以通过为每个副本赋予唯一的 Instance，在同一图表上运行多个独立副本，以便并排比较不同的阶段设置。
入场通知
您无需守在图表前等待新的脉冲。每次入场都可通过多个通知渠道发送，这些渠道可在面板上独立启用。
Alert — 终端内部的弹出消息。
Push — 发送到您手机上 MetaTrader 应用的移动通知。
Email — 通过终端的邮件设置发送的信件。
Telegram — 警报文本连同图表截图，直接发送到您的 Telegram 聊天。
只启用您需要的渠道，您就会在所用品种和时间周期上一出现新入场时立即收到通知。
可视化历史记录（HTML 报告）
启用 Html 渠道后，每个入场信号都会连同触发时刻的图表截图一起保存到 HTML 报告中。报告存储在终端的 Files 文件夹内的 VibeFox_Market_Phases 目录中（MQL5/Files/VibeFox_Market_Phases/result.html），可在任何浏览器中打开 — 您将获得指标找到的所有脉冲入场的可视化日志。一键垃圾桶按钮可随时清除报告及其截图，以便重新开始。
Telegram 警报
信号还可以直接发送到您的 Telegram 聊天 — 警报文本连同检测时刻的图表截图。开启 Telegram 渠道，并在输入中填入您的 bot token 和 chat id。
发送依托于 HTML 报告：每个新信号都会写入报告，而报告 — 在浏览器中打开后 — 会自行将其转发到您的 Telegram 聊天。因此，启用 Telegram 会自动保持 Html 报告开启，两个渠道协同工作。
内置多语言帮助
面板内置完整的帮助页面，提供多种语言版本，因此每个控件都在您使用之处得到解释。
参数（Inputs 选项卡）
大多数设置也可在面板上实时更改（Settings 按钮）— 输入参数仅在启动时设定初始值。
Market Phases
ATR Period — 用于衡量波动率的 ATR 周期（2..200）。Default: 14。
ADX Period — 用于衡量趋势强度的 ADX 周期（2..200）。Default: 14。
ADX Low — 低于此 ADX 水平时市场被视为 Range / 横盘（5..60）。Default: 20。
ADX High — 高于此 ADX 水平时市场被视为 Trend / 脉冲（10..80）。Default: 25。
Squeeze % — 挤压阈值：当 ATR 低于其均值的此百分比时，阶段为 Consolidation（30..99）。Default: 80。
Bars of history to process — 向前计算多少根 K 线的阶段，0 = 全部可用。Default: 500。
Range / Balance Color — Range 阶段的背景色。Default: 深蓝灰色。
Range Transparency — Range 区透明度，百分比，0-100。Default: 0。
Squeeze / Consolidation Color — Squeeze 阶段的背景色。Default: 深琥珀色。
Squeeze Transparency — Squeeze 区透明度，百分比，0-100。Default: 0。
Activity / Breakout Color — Activity 阶段的背景色。Default: 深青色。
Activity Transparency — Activity 区透明度，百分比，0-100。Default: 0。
Trend Up Color — Trend Up 阶段的背景色。Default: 深绿色。
Trend Up Transparency — Trend Up 区透明度，百分比，0-100。Default: 0。
Trend Down Color — Trend Down 阶段的背景色。Default: 深红色。
Trend Down Transparency — Trend Down 区透明度，百分比，0-100。Default: 0。
Entry Points
Long signals — 在转入 Trend-Up 脉冲时启用 BUY 标记。Default: on。
Short signals — 在转入 Trend-Down 脉冲时启用 SELL 标记。Default: on。
Marker Font Size — 入场标记的像素大小，6..40。Default: 12。
Entry Marker — 标记字形：Cross (+)、Triangle 或 Arrow。Default: Arrow。
Buy Color — BUY 标记的颜色。Default: LimeGreen。
Buy Transparency — 买入标记透明度，百分比，0-100。Default: 0。
Sell Color — SELL 标记的颜色。Default: Red。
Sell Transparency — 卖出标记透明度，百分比，0-100。Default: 0。
Notifications
Push Notification — 启用发送到 MetaTrader 移动应用的推送提醒。Default: off。
Alert Popup — 启用终端内部的弹出提醒。Default: off。
Email — 通过终端的邮件设置启用电子邮件提醒。Default: off。
Html Report — 将每个信号连同图表截图保存到 Files/VibeFox_Market_Phases/result.html。Default: off。
Telegram — 通过 HTML 报告将带图表截图的信号转发到 Telegram 聊天。Default: off。
Telegram - bot token — 用于发送的 Telegram bot 的令牌。Default: empty。
Telegram - chat id — 目标 Telegram 聊天标识符。Default: empty。
Panel / Settings
Panel width, px — 图表面板的宽度，以像素为单位，300..800。Default: 800。
Header size — 面板标题栏的高度，1..6。Default: 1。
Theme — 面板的颜色主题：Light、Dark 或 Auto。Default: Auto。
Row height (px) — 每个参数行的像素高度。Default: 34。
Font size — 面板内部使用的字体大小。Default: 8。
Hide Footer — 隐藏面板的底部栏。Default: off。
Mini Header on collapse — 在面板折叠时显示紧凑的标题栏条带。Default: off。
Close on click outside — 在点击面板外部时自动折叠面板。Default: off。
Instance — 同一图表上每个指标副本的唯一编号，允许并排运行多个实例。Default: 1。
Panel Start Window — 设定面板的初始位置：主图表或子窗口。Default: Subwindow。
