VibeFox Range Filter MT5 — 帮助
VibeFox Range Filter —— 带入场信号的平滑范围过滤器叠加
VibeFox Range Filter 是一款用于 MetaTrader 5 的实时趋势跟随叠加指标。它直接在价格图表上绘制一条平滑的范围过滤器线，周围环绕着上下波段，并在每次过滤器突破形成的时刻用彩色箭头和入场信号标记它。你无需猜测趋势何时转变，而是看到过滤器线改变方向、入场箭头在同一根柱子上出现。
Range Filter 的工作原理
该指标回答一个问题：价格是否已果断越过过滤器线，还是仍被包含在范围之内？它分两步完成。
平滑范围
首先，指标用指数移动平均在 Sampling Period 根柱子上计算一个平滑的平均真实波幅，然后用 Range Multiplier 对其进行缩放。这得到一个单一数值——平滑范围——它会适应当前的波动性。较大的乘数会拓宽范围，产生更少但更强的信号；较小的乘数会收窄范围，反应更快。
过滤器线与波段
过滤器线通过棘轮机制锚定到价格上：只有当源价格上涨超过前一过滤器值之上一个平滑范围时它才上移，只有当价格下跌超过其下方一个平滑范围时它才下移。其间，线保持不动。这使它免受小幅波动和噪音的影响。当过滤器向上移动时，它以 Up Color 绘制；当它向下移动时，它切换为 Down Color。可选的 Bands 在过滤器线上方和下方各添加一个等于一个平滑范围的通道，使允许的波动区域一目了然。
入场点
过滤器突破
过滤器突破是主信号。它发生在过滤器线改变方向的第一根柱子上：从向下转为向上时，指标在柱子下方放置一个 BUY 箭头；从向上转为向下时，它在柱子上方放置一个 SELL 箭头。无论 Entry 开关如何，突破箭头都会在每次方向改变时出现。面板中的 Entry 开关用于开启或关闭单独的入场标记（用于通知的彩色实心点或箭头），因此你可以保留可视的突破箭头同时抑制通知标记，或将两者一起启用以进行完整的信号跟踪。
视觉外观
过滤器线的颜色在每次方向改变时自动在 Up Color 与 Down Color 之间切换，让你即时读出当前的趋势状态。Line Width 以像素设置过滤器线与波段线的粗细。Style 控件让你为线型在 Solid、Dash、Dot、DashDot 或 DashDotDot 之间选择。买入入场标记以 Buy Marker Color 着色，卖出标记以 Sell Marker Color 着色；Marker Size 可将它们从 1 到 5 进行缩放。
图表上的交互式面板
所有控件都集中在单一的 canvas 面板中，它位于图表上，既不占用单独的子窗口，也不堆满 Inputs 对话框。面板可放置在指标子窗口中，或一键移动到主图表上。
Power——开启或关闭绘制，而无需移除指标。
Settings (gear)——打开和关闭设置区块。
Subwindow/Chart (arrows)——在指标子窗口与主图表之间移动面板。
Close (cross)——从图表移除指标。
Resize——拖动右下角以缩放面板的宽度和高度。
Collapse——双击标题栏将面板折叠成紧凑的标题条；再次双击可恢复它。
Mouse wheel——将鼠标悬停在任意数字字段上并滚动滚轮，无需输入即可更改数值。
Right-click——右键单击某个选项卡或开关，可在适用之处翻转其状态。
设置与个性化
Settings 按钮打开一个区块，让你将面板贴合到你的工作空间。浅色、深色或自动 Theme 使面板适配图表背景。Panel Width 设置像素宽度；Header Size、Row Height 与 Font Size 调整比例。Hide Footer 移除底部状态栏；Mini Header 在折叠时显示紧凑的标题条；Close Outside 在点击面板外任意位置时自动折叠面板。Bars 参数限制计算和绘制多少根柱子的过滤器历史；Refresh 为不常跳动的图表设置以秒计的自动更新间隔。通过为每个副本指定唯一的 Instance 编号，在同一图表上运行多个独立副本。
入场通知
每个过滤器突破入场都可通过多个渠道发送，你可在面板上分别启用它们。
Alert——终端内的弹出消息。
Push——发送到你手机上 MetaTrader 应用的移动推送通知。
Email——通过终端邮件设置发送的信件。
Html——将信号连同图表截图保存到 HTML 报告。
Telegram——将提醒文本连同图表截图发送到你的 Telegram 聊天。
可视化历史 —— HTML report
启用 Html 渠道，每个入场信号都会连同其触发时刻的图表截图一起保存到 HTML report 中。报告位于终端的 Files 文件夹下 VibeFox_RangeFilter 目录中的 MQL5/Files/VibeFox_RangeFilter/result.html，可在任何浏览器中打开。面板上的一键回收站按钮可清空报告及其截图，让你随时重新开始。
Telegram Alerts
启用 Telegram 渠道，即可将每个信号作为提醒文本加图表截图直接发送到你的 Telegram 聊天。在 Inputs 选项卡中输入你的机器人令牌和聊天 ID。发送由在浏览器中打开的 HTML 报告处理——报告内嵌的 JavaScript 会将消息转发到 Telegram Bot API，无需任何终端 URL 白名单。因此，启用 Telegram 会自动保持 Html 渠道开启，两者协同工作。
内置多语言帮助
面板内置完整的帮助页面，提供 10 languages：英语、俄语、德语、法语、西班牙语、意大利语、葡萄牙语、中文、日语和韩语。打开 Settings 区块并单击语言按钮，即可直接在图表上显示帮助文本。
参数 —— Inputs 选项卡
大多数设置也可以直接在面板上实时更改。输入参数仅在启动时设置初始值。
Calc
Sampling Period——平滑范围的 EMA 周期，范围 1..1000。默认：100。
Range Multiplier——缩放平滑范围；越大 = 过滤器越宽、突破越少。默认：3.0。
Source——价格来源：Close 或 (High+Low)/2。默认：Close。
Visual
Up Color——趋势向上时的过滤器线颜色。默认：LimeGreen。
Up Transparency %——上涨颜色的透明度，0 = 不透明，100 = 不可见。默认：0。
Down Color——趋势向下时的过滤器线颜色。默认：Tomato。
Down Transparency %——下跌颜色的透明度。默认：0。
Line Width (1-10)——过滤器线与波段线的粗细（像素）。默认：2。
Show bands——在过滤器线周围绘制上下波段。默认：开启。
Range Break arrows——在每次过滤器突破时绘制方向箭头。默认：开启。
Entry Points
Entry on Range Break——在过滤器突破时启用入场标记和通知；向上突破 = BUY，向下突破 = SELL。默认：关闭。
Marker Size (1-5)——价格图表上入场标记的大小。默认：2。
Buy Marker Color——BUY 入场标记的颜色。默认：LimeGreen。
Sell Marker Color——SELL 入场标记的颜色。默认：Red。
Notifications
Push Notification——发送到 MetaTrader 移动应用的推送通知。默认：关闭。
Alert Popup——终端内的弹出 Alert 窗口。默认：关闭。
Email——通过终端邮件设置发送的电子邮件。默认：关闭。
Html——将每个信号连同图表截图保存到 MQL5/Files/VibeFox_RangeFilter/result.html。默认：关闭。
Telegram (send from result.html via JS)——通过 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。