VibeFox Average True Range

VibeFox ATR — 波动率、突变与入场点

VibeFox ATR 是一款用于 MetaTrader 5 的实时平均真实波幅指标。它在独立子窗口中绘制 ATR 线及其平滑基准线，在波动率突然向上突破的那一刻直接在价格图表上做出标记，并将所有控件集中到一个现代化的交互式面板中。你不再需要凭肉眼判断市场的摆动幅度，而是能准确看到当前波动率、它的平均水平以及突变形成的那一刻。

ATR 衡量什么

Welles Wilder 的 ATR 回答了一个重要的问题：价格波动的幅度有多大。它衡量的是波动的大小，而不是方向——高 ATR 意味着大幅、剧烈摆动的蜡烛，低 ATR 意味着安静、狭窄的市场。该指标绘制两条线。ATR 是逐根 K 线的当前波动率。ATR Avg 是 ATR 自身的移动平均，也就是它在所选周期内的平均基准水平。

对比这两条线是该指标的核心。当 ATR 线运行在其 Avg 之上时，市场的摆动比平常更剧烈；当 ATR 跌破 Avg 时，波动正在平息。由于 ATR 没有固定的上限，子窗口会根据品种的数值自动缩放，因此两条线始终保持在画面之内。

突变阈值

“普通”波动率与真正突变之间的界线由 Spike Mult 参数设定。它是一个乘数：当 ATR 超过 Avg 乘以 Mult 时，记录为一次突变。在 1.5 时，ATR 只需高出其平均水平 50% 即可；调高乘数以只对最剧烈的波动爆发做出反应，或调低它以捕捉更温和的幅度扩张。

入场点

VibeFox ATR 的核心价值在于其自动入场点：指标自行跟踪突变条件，并在触发的那一刻直接在价格图表上放置清晰的箭头标记。

Entry — 波动率突变

该信号在波动率突变时触发：当 ATR 超过 Avg * Mult 时。标记的方向由突变所在的那根 K 线决定：如果该 K 线收阳，则放置 BUY 标记；如果该 K 线收阴，则放置 SELL 标记。这将波动率突变直接与它所发生的那段走势的方向联系起来，因此你看到的不仅是“市场加速了”，而是“市场向上加速”或“向下加速”。

这是该指标中唯一、独立完整的入场条件——没有额外的逻辑层。面板上的 Entry 开关可完全开启或关闭对这些信号的搜索。

买入和卖出标记分别用 Buy Marker 和 Sell Marker 着色，因此方向一目了然，而 Marker Size 控件可将箭头从 1 到 5 缩放，以适应任何图表密度。

完整的视觉控制

子窗口中的两条线都可按你的喜好定制。ATR Line 和 Avg Line 的颜色分别设定，每条线都有自己的透明度滑块——你可以让基准线淡入浅色背景中，让主波动率线以饱和的颜色突出显示。Line Width 控件以像素为单位设定 ATR 线的粗细，因此无论在密集的日内图表还是稀疏的较高周期上，图像都清晰可读。

交互式图表面板

整个界面是一个基于画布的流畅面板，专为快速鼠标控制而打造。所有参数都排列成整齐的三列行，入场区块由其专属的金色 ENTRY 标题分隔开来，使信号设置不会与线条设置混淆。面板标题栏中放置着控制图标。

Power — 在不从图表移除指标的情况下，开启和关闭线条与信号的绘制。

Settings (gear) — 打开和关闭设置面板。

Updown (arrows) — 在独立子窗口与主图表之间移动面板。

Close (cross) — 关闭指标。

Resizable — 拖动右下角以缩放面板。

Collapsible — 双击 Header 将面板折叠成紧凑的条状。

Mouse wheel — 将鼠标悬停在任意 Number 字段上并滚动滚轮，无需打开键盘即可更改数值。

设置与个性化

Settings 按钮打开一个区块，可将面板贴合到你的工作区：浅色、深色或自动的 Theme，可调的面板宽度、Header size、Row height 和 Font size。额外的细节让你可以用 Hide Footer 隐藏底部栏，用 Mini Header 在折叠时缩小标题盖，并在点击面板外部时自动折叠面板。几乎每个参数都可以直接在面板上实时更改——Inputs 选项卡上的输入字段只设定起始值。你还可以通过为每个副本指定唯一的 Instance，在一张图表上运行多个独立副本，并排观察使用不同周期和突变阈值的 ATR。

入场通知

你无需坐着盯着图表等待突变。每个入场信号都可以通过多个通知渠道发送，这些渠道可直接在面板的 NOTIFY ENTRIES 组中独立开启。

Alert — 终端内部的弹出消息。

Push — 发送到你手机上 MetaTrader 应用的移动通知。

Email — 通过终端的邮件设置发送的信件。

Telegram — 将提醒文字连同图表截图一起直接发送到你的 Telegram 聊天。

只开启你需要的渠道，当你正在使用的品种和周期上出现新的入场时，你便会立即收到提醒。

可视化历史 (HTML report)

启用 Html 渠道后，每个入场信号都会连同触发时刻的图表截图一起保存到一份 HTML 报告中。该报告保存在终端的 Files 文件夹中的 VibeFox_ATR 目录内（result.html 文件），并可在任意浏览器中打开——它是指标发现的每一次波动率突变的可视化日志。当你想要重新开始时，垃圾桶按钮可一键清除报告及其截图。

Telegram 提醒

信号也可以直接发送到您的 Telegram 聊天——每次检测到信号时发送提醒文本和图表截图。启用 Telegram 频道并在参数中输入您的机器人令牌和 chat id。

发送通过在浏览器中打开的 HTML 报告完成：每个新信号被写入报告，浏览器自动将其转发到您的 Telegram 聊天。因此，启用 Telegram 会自动保持 Html 报告开启，两个频道协同工作。

内置多语言帮助

面板内置了一个完整的帮助页面，提供 10 languages，因此每个控件都会在你使用它的地方得到说明。

参数 (Inputs tab)

大多数设置也可以直接在面板上实时更改（Settings 按钮）——输入参数仅设定启动时的起始值。

ATR

ATR Period — 以 K 线根数计的 ATR 平均周期。Default: 14.

Avg Period — ATR 移动平均（波动率基准线）的周期。Default: 20.

Spike Mult (1.0-5.0) — 突变乘数：ATR 高于 Avg * Mult 即视为一次波动率突变。Default: 1.5.

ATR Line Color — ATR 线（当前波动率）的颜色。Default: DodgerBlue.

ATR Line Transparency (0-100) — ATR 线的透明度，0 = 不透明，100 = 不可见。Default: 0.

ATR Avg Color — Avg 基准线（平均波动率水平）的颜色。Default: Orange.

ATR Avg Transparency (0-100) — Avg 线的透明度，0 = 不透明。Default: 0.

ATR Line Width (1-5) — 以像素为单位的 ATR 线粗细。Default: 2.

Entry Points

Entry = Volatility Spike (ATR > Avg * Mult) — 开启波动率突变信号；K 线方向决定 BUY（阳线）或 SELL（阴线）。Default: on.

Marker Size (1-5) — 图表上信号箭头的大小。Default: 2.

Buy Marker Color — BUY 信号箭头的颜色。Default: LimeGreen.

Buy Marker Transparency (0-100) — 买入标记的透明度，0 = 不透明。Default: 0.

Sell Marker Color — SELL 信号箭头的颜色。Default: Red.

Sell Marker Transparency (0-100) — 卖出标记的透明度，0 = 不透明。Default: 0.

Notifications

Push Notification — 发送到移动 MetaTrader 终端的推送通知。Default: off.

Alert Popup — 终端内部的 Alert 弹窗。Default: off.

Email — 通过终端的邮件设置发送的信件。Default: off.

Html Report — 将每个信号连同截图保存到 HTML 报告中（Files 文件夹，VibeFox_ATR 目录，result.html 文件），可在任意浏览器中打开。Default: off.

Telegram — 将每个信号（提醒文本和图表截图）通过在浏览器中打开的 Html 报告发送到您的 Telegram 聊天。Default: off.

Telegram bot token — 您的 Telegram 机器人令牌，用于发送消息。

Telegram chat id — 接收信号的 Telegram 聊天 id。

Panel / Settings

Panel width, px — 以像素计的面板宽度，范围 300..800。Default: 800.

Header size — 标题大小，1..6。Default: 1.

Theme — 颜色主题：Auto（跟随图表）、Dark 或 Light。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 — 面板启动时打开的位置：Subwindow 或 Chart。Default: Subwindow.