VibeFox Pesavento

VibeFox Pesavento — 对摆动腿段进行 Fibonacci ratio 分析并提供入场点

VibeFox Pesavento 是一款用于 MetaTrader 5 的实时摆动结构指标，它将 Pesavento 的 Fibonacci ratio 方法应用于市场。它从价格构建一条 ZigZag，测量摆动结构的每一条腿段，为每条腿段标注其与上一条腿段的 ratio，突出显示落在关键 Fibonacci/Pesavento ratio 上的腿段，并直接在图表上标记入场信号。你无需手工测量回撤，而是在每一次行情形成的那一刻就看到它的比例以及反转水平 —— 这一切都汇集在一个现代化的交互式面板中。

指标的工作原理

首先，指标使用经典的 ZigZag 算法检测价格的重要转折点 —— 摆动高点（波峰）和摆动低点（波谷）。这一构建过程由三个参数控制。Depth 设定两个枢轴点之间的最小柱数，使结构忽略细小的波动，只对持续足够长时间的行情作出反应。Deviation 是登记一个新枢轴点所需的最小反转幅度 —— 它过滤掉浅幅回调。Backstep 是同一类型两个极值之间的最小柱数，防止两个波峰（或两个波谷）彼此过于靠近。它们共同将摆动检测从一个快速、细致的结构调校到一个只显示主要摆动的缓慢结构。

摆动腿段以线段对象的形式直接绘制在价格图表上，而指标本身则位于自己的子窗口中，控制面板就放在那里。Bars 设置限制处理多少历史数据 —— 设为 0 可扫描所有可用柱，或在繁重的图表上使用较小的值以加快重绘。

Pesavento ratio 分析

一旦确定了摆动枢轴点，指标就把结构拆分成腿段 —— 每条腿段连接两个相邻的枢轴点。对于每条腿段，它都会计算 Pesavento ratio：当前腿段的长度除以上一条腿段的长度。这个 ratio 描述了行情的比例 —— 价格相对于上一段摆动回撤或延伸了多远。带有 ratio（例如 0.618）的标签绘制在每条腿段的中点处，因此结构的几何形态一目了然。

ratio 落在关键 Fibonacci/Pesavento 数值上的腿段会用 High（Highlight）颜色突出显示。关键 ratio 为 0.382, 0.500, 0.618, 0.786, 1.000, 1.272, 1.618 和 2.618。当一条腿段的 ratio 与其中某个数值的距离在 Tolerance 范围之内时，就算作匹配 —— 容差是一个绝对数值，因此你可以让匹配变得严格或宽松。这些被突出显示的腿段正是 Pesavento 交易者所寻找的谐波行情：尊重 Fibonacci 网格的回撤与延伸。

入场点

VibeFox Pesavento 的主要价值在于它的自动入场点：每当一段摆动在关键反转 ratio 处完成时，就会在价格图表上放置一个清晰的标记。当一条腿段的 ratio 与上一条腿段的关键回撤数值 0.618 或 0.786 匹配时，该腿段被视为很可能反转 —— 在这一比例处，前一段行情通常已经耗尽。

当腿段在关键反转 ratio 处以一个确认的摆动低点结束时，会在该柱下方放置一个 BUY 标记 —— 下跌行情已回撤进入反转区域，价格正在转涨。当腿段在关键反转 ratio 处以一个确认的摆动高点结束时，会在该柱上方出现一个 SELL 标记 —— 上涨行情已经耗尽，价格正在转跌。这两个方向通过 Buy 和 Sell 开关独立切换。

买入和卖出标记分别用 Buy Color 和 Sell Color 设置着色，因此方向一眼即可读出。Marker 选择器可在普通十字（+）、实心三角形或带尾巴的箭头之间切换字形，而 Size 控件以像素（6 到 40）缩放标记，以适应任何图表密度。

完整的视觉控制

腿段线条颜色通过 Zigzag Line Color 设置，粗细通过 Line Width 在 1 到 5 像素之间设置。匹配关键 ratio 的腿段用 Key-ratio Highlight Color 着色。线条、突出显示以及两种入场标记在颜色选择器弹窗中各自支持透明度设置（0-100%），因此你可以把它们柔和地融入图表背景。价格图表上的标记的大小和颜色都可独立设置，使入场点在任何背景下都清晰醒目。

交互式图表面板

整个界面是一个基于画布的流畅面板，专为快速鼠标操作而构建。摆动参数与 ratio 参数被整齐地汇集成行，而入场区块则以其自己的金色 ENTRY 标题分隔开来，因此信号设置不会与线条设置混在一起。面板标题栏放置着各个控制图标。

Power —— 开启和关闭入场标记的绘制，而无需从图表中移除指标。

Settings (gear) —— 打开和关闭设置区块。

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

Close (cross) —— 关闭指标。

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

Collapsible —— 在标题栏上双击可将面板折叠成一个紧凑的条带。

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

设置与个性化

Settings 按钮会打开一个区块，在这里面板会贴合你的工作区：浅色、深色或自动的 Theme，可调节的面板宽度、标题大小、行高和字号。额外的细节让你可以通过 Hide Footer 隐藏底部栏，通过 Mini Header 在折叠时缩小标题栏，并在点击面板外部时自动折叠面板。几乎每个参数都会实时地在面板上生效 —— Inputs 选项卡上的输入字段只设定起始值。你也可以通过为每个副本赋予唯一的 Instance，在一张图表上运行多个独立的副本，以便并排比较不同的 Pesavento 设置。

入场通知

你不必坐着守着图表等待信号。每个入场都可以通过多个通知渠道发送，这些渠道可在面板上独立启用。

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

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

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

Telegram —— 警报文本连同一张图表截图，直接发送到你的 Telegram 聊天。

只启用你需要的渠道，当你正在使用的品种和时间周期上出现新的入场时，你就会在那一刻收到通知。

可视化历史（HTML 报告）

启用 Html 渠道，每个入场信号都会被保存到一份 HTML 报告中，连同信号触发那一刻的图表截图。报告存储在终端的 Files 文件夹中的 VibeFox_Pesavento 目录下（MQL5/Files/VibeFox_Pesavento/result.html），并可在任意浏览器中打开 —— 你将获得指标所发现的所有入场的可视化日志。一个一键回收站按钮可在你想要重新开始时随时清除报告及其截图。

Telegram 警报

信号也可以直接发送到你的 Telegram 聊天 —— 警报文本连同检测那一刻的图表截图。打开 Telegram 渠道，并在输入参数中填入你的 bot token 和 chat id。

投递依托于 HTML 报告：每个新信号都会写入报告，而该报告 —— 在浏览器中打开后 —— 会自行将其转发到你的 Telegram 聊天。因此，启用 Telegram 会自动保持 Html 报告开启，这两个渠道协同工作。

内置多语言帮助

面板内置了一个完整的帮助页面，提供多种语言，因此每个控件都会在你使用它的地方得到解释。

参数（Inputs 选项卡）

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

Pesavento（摆动）

Swing Depth —— 两个枢轴点之间的最小柱数（2..100）。默认值：12。

Swing Deviation —— 形成新枢轴点所需的最小反转幅度，以点为单位。默认值：5。

Swing Backstep —— 两个极值之间的最小柱数。默认值：3。

Max legs drawn/labeled —— 绘制和标注最近多少条腿段。默认值：12。

Bars of history to process —— 摆动计算回溯多远，0 = 所有可用。默认值：500。

Key-ratio tolerance —— 将腿段 ratio 与关键数值匹配的绝对容差。默认值：0.030。

Zigzag Line Color —— 价格图表上腿段线条的颜色。默认值：DodgerBlue。

Line Transparency —— 腿段线条透明度，以百分比计，0-100。默认值：0。

Key-ratio Highlight Color —— 匹配关键 ratio 的腿段的颜色。默认值：Gold。

Highlight Transparency —— 突出显示透明度，以百分比计，0-100。默认值：0。

Line Width —— 腿段线条的粗细，以像素计，1..5。默认值：1。

入场点

Buy signals (low @ key ratio) —— 在关键反转 ratio 处确认的低点枢轴上启用 BUY 标记。默认值：on。

Sell signals (high @ key ratio) —— 在关键反转 ratio 处确认的高点枢轴上启用 SELL 标记。默认值：on。

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。

通知

Push Notification —— 启用发送到 MetaTrader 移动应用的推送警报。默认值：off。

Alert Popup —— 启用终端内部的弹出警报。默认值：off。

Email —— 通过终端的邮件设置启用邮件警报。默认值：off。

Html Report —— 将每个信号连同图表截图保存到 Files/VibeFox_Pesavento/result.html。默认值：off。

Telegram —— 通过 HTML 报告将信号连同图表截图转发到 Telegram 聊天。默认值：off。

Telegram - bot token —— 用于投递的 Telegram bot 的 token。默认值：空。

Telegram - chat id —— 目标 Telegram 聊天标识符。默认值：空。

面板 / 设置

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 —— 隐藏面板的底部栏。默认值：off。

Mini Header on collapse —— 在面板折叠时显示一个紧凑的标题条。默认值：off。

Close on click outside —— 在点击面板外部时自动折叠面板。默认值：off。

Instance —— 同一图表上每个指标副本的唯一编号，允许并排运行多个实例。默认值：1。

Panel Start Window —— 设定面板的初始位置：主图表或子窗口。默认值：Subwindow。