VibeFox Market Regime MT5 — 帮助
VibeFox Market Regime — 趋势、横盘和过渡的综合市场状态过滤器
VibeFox Market Regime 是 MetaTrader 5 的实时市场背景指标。它在每根K线上计算0到100的综合趋势质量评分，并将当前市场分类为四种状态之一：TREND、RANGE、VOLATILE 或 NEUTRAL。评分以彩色线条在独立子窗口中绘制；每次状态变化时，价格图表上会出现一个十字标记。该指标不产生买入或卖出信号——它回答一个前置问题：当前市场是什么类型的市场？
趋势质量评分衡量什么
评分是三个独立组件的加权组合，每个组件衡量市场结构的不同维度。它们共同生成一个数字，反映市场是有目的地运动、无方向地漂移，还是仅仅产生噪音。
ADX 组件 — 趋势强度
ADX（平均趋向指数）组件衡量当前方向性运动的强度，与方向无关。高ADX读数意味着价格在一个方向上持续运动；低ADX意味着市场没有方向。ADX Period 参数控制回溯期。Weight ADX 参数决定该组件相对于其他两个组件对最终评分的贡献比例。
ATR 组件 — 相对波动率
ATR（平均真实波幅）组件将当前波动率相对于其自身历史进行衡量——具体表现为近期ATR值的百分位数。高相对波动率通常伴随突破和强趋势；低相对波动率是压缩横盘市场的特征。ATR Period 参数控制回溯期。Weight ATR 参数设置其对综合评分的贡献。
ER 组件 — 运动纯粹性
ER（考夫曼效率比）组件衡量价格从A到B运动的直接程度——净位移与总路径长度之比。接近1的ER意味着价格几乎沿直线运动；接近0的ER意味着价格来回徘徊反复覆盖相同区域。这是趋势质量最纯粹的衡量指标。ER Period 参数控制回溯期。Weight ER 参数设置其贡献。
评分如何计算及状态如何分配
每个组件被归一化到0–100范围，然后使用加权平均值合并。三个权重——W_ADX、W_ATR 和 W_ER——默认各为1.0，给予组件相等的影响。提高某个权重会将综合评分向该市场结构维度倾斜。将权重设为零会完全移除该组件。
两个阈值将0–100刻度分成分类区间。当综合评分达到或超过 Trend Threshold（默认60）时，状态被分类为 TREND。当评分达到或低于 Range Threshold（默认40）时，状态为 RANGE。两个阈值之间的区间是过渡区：该区间的K线被分类为 VOLATILE（高ATR但低ER）或 NEUTRAL（温和读数）。阈值线直接在评分线上以虚线水平级别绘制。
评分线以四种不同颜色绘制，使状态一目了然：TREND 为绿色，RANGE 为灰色，VOLATILE 为橙色，NEUTRAL 为蓝色。
ALERT — 状态变化通知
状态变化标记
每当分类状态在已收盘K线上发生变化——例如从RANGE变为TREND——十字标记就会放置在该K线位置的价格图表上。标记颜色与新状态匹配：绿色十字表示市场刚进入TREND，灰色十字表示刚进入RANGE。标记代表过渡，而非入场点。
ALERT 组中的 Alert 开关控制标记绘制的开关。Alert开启时，可见图表历史中所有状态变化的历史标记都会被绘制；关闭时不显示标记。开关旁边的 Size 字段控制标记大小（1到5）。
VibeFox Market Regime 是一个过滤和背景层，而非方向性入场信号。从RANGE到TREND的状态变化并不意味着买入；它意味着市场已进入趋势跟踪策略更可能奏效的条件。将此信息与您的方向性系统结合使用，而非替代它。
视觉控制
评分线在独立子窗口中占据固定的0–100刻度。始终存在三条水平虚线级别：Trend Threshold处的 Trend 级别、Range Threshold处的 Range 级别，以及50处的中性 Mid 级别。线条颜色随状态变化逐根K线改变。当前状态名称和评分值在面板内以读数形式显示。
图表上的交互式面板
整个界面是一个基于画布的流畅面板，专为快速鼠标控制而设计。所有参数汇集在三列整洁的行中。面板标题栏包含控制图标。
Power — 在不从图表中移除指标的情况下开关评分线、标记和信号。
Settings (gear) — 打开和关闭设置部分。
Updown (arrows) — 在独立子窗口和主图表之间移动面板。
Close (cross) — 关闭指标。
Resizable — 拖动右下角以缩放面板。
Collapsible — 双击标题将面板折叠为紧凑条带。
Mouse wheel — 将光标悬停在任意数字字段上并滚动滚轮即可更改值，无需打开键盘。
设置与个性化
Settings 按钮打开一个部分，可将面板适配到您的工作空间：浅色、深色或自动 Theme，可调节的面板宽度、标题大小、行高和字体大小。额外选项允许通过 Hide Footer 隐藏底部栏，通过 Mini Header 在折叠时缩小标题，以及在点击面板外部时自动折叠。几乎每个参数都可直接在面板上实时更改。您还可以为每个副本赋予唯一的 Instance 编号，在同一图表上运行多个独立副本。
状态变化通知
您无需盯着图表等待状态过渡。每次变化都可通过面板上独立启用的多个通知渠道发送。
Alert — 终端内的弹出消息。
Push — 向手机上的MetaTrader应用推送移动通知。
Email — 通过终端邮件设置发送的电子邮件。
Telegram — 警报文字连同图表截图，直接发送到您的Telegram聊天。
只启用您需要的渠道，当市场在您所操作的品种和时间框架上从一种状态转换到另一种状态时，您将立即收到通知。
视觉历史 — Html 报告
启用 Html 渠道，每次状态变化通知都会连同触发时刻的图表截图保存到HTML报告中。报告存储在终端的Files文件夹中 VibeFox_MarketRegime 目录下，可在任何浏览器中打开。一键清除按钮可随时清除报告及其截图。
Telegram 警报
信号也可直接发送到您的 Telegram 聊天——检测时刻的图表截图连同警报文字。开启 Telegram 渠道，并在参数中输入您的机器人令牌和聊天ID。
传送依托于HTML报告：每个新信号写入报告，在浏览器中打开的报告会自动将其转发到您的Telegram聊天。因此，启用Telegram会自动保持 Html 报告开启，两个渠道协同工作。
内置多语言帮助
面板内置完整帮助页面，提供 10种语言，因此每个控件的说明都在您使用它的地方。
参数（Inputs 标签页）
大多数设置也可直接在面板上实时更改（Settings按钮）——输入参数仅设置启动时的初始值。
Score
ADX Period — ADX组件的回溯期，范围1..200。默认：14。
ATR Period — ATR相对波动率组件的回溯期，范围1..200。默认：14。
ER Period — 考夫曼效率比组件的回溯期，范围1..200。默认：10。
Weights / Thresholds
W_ADX (trend-strength weight) — ADX组件在综合评分中的相对权重，范围0.0..10.0。默认：1.0。
W_ATR (volatility weight) — ATR相对波动率组件的相对权重，范围0.0..10.0。默认：1.0。
W_ER (move-purity weight) — 考夫曼ER组件的相对权重，范围0.0..10.0。默认：1.0。
Trend Threshold (score>=) — 综合评分达到或超过该值时状态分类为TREND，范围0..100。默认：60。
Range Threshold (score<=) — 综合评分达到或低于该值时状态分类为RANGE，范围0..100。默认：40。
Entry Points
Regime Change signal — 在价格图表上启用状态变化十字标记。默认：关闭。
Marker Size (1-5) — 图表上状态变化标记的大小。默认：2。
Notifications
Push Notification — 向移动MetaTrader终端推送通知。默认：关闭。
Alert Popup — 终端内的Alert弹出窗口。默认：关闭。
Email — 通过终端邮件设置发送邮件。默认：关闭。
Html Report — 将每次状态变化连同截图保存到HTML报告（Files文件夹，VibeFox_MarketRegime目录），可在任何浏览器中打开。默认：关闭。
Telegram — 通过HTML报告将每个信号发送到您的Telegram聊天（警报文字加图表截图）。默认：关闭。
Telegram bot token — 用于发送消息的Telegram机器人令牌。
Telegram chat id — 接收信号的Telegram聊天ID。
Panel / Settings
Panel width, px (300..800) — 面板宽度（像素）。默认：800。
Header size (1..6) — 标题大小。默认：1。
Theme — 颜色主题：Auto（跟随图表）、Dark 或 Light。默认：Auto。
Row height (px) — 面板行高（像素）。默认：34。
Font size — 面板字体大小。默认：8。
Hide Footer — 隐藏面板底部栏。默认：关闭。
Mini Header on collapse — 面板折叠时显示迷你标题。默认：关闭。
Close on click outside — 点击面板外部时折叠面板。默认：关闭。
Instance (unique per copy: 1,2,3...) — 实例编号；允许在同一图表上运行多个独立副本。默认：1。
Panel Start Window — 启动时面板打开位置：Subwindow 或 Chart。默认：Subwindow。