VibeFox Turtle Soup

VibeFox Turtle Soup — Linda Raschke 假突破反转，带入场点

VibeFox Turtle Soup 是一款用于 MetaTrader 5 的实时假突破指标。它实现了 Linda Raschke 经典的 "Turtle Soup" 形态：当价格扫过先前的摆动极值随后又反弹回越过该极值的瞬间，指标就会直接在价格图表上标出反转入场点，并画出被扫掉的价位。你不再需要盯着图表苦等突破陷阱，而是在失败突破完成的那一根 K 线上就能看到它以及入场点。所有控制项都集中在一个现代化的交互面板中。

指标工作原理

当市场刺穿一个明显的高点或低点——触发突破交易者和止损单——随后立即反转、收盘回到先前区间之内时，就形成了突破陷阱。Turtle Soup 把这种陷阱转化为信号。对于每一根 K 线，指标会计算前 N 根 K 线（Lookback 窗口）的最高高点和最低低点，然后检查当前 K 线是否扫过了该极值却未能在其之外站稳。

看涨（BUY）： K 线的低点刺穿到前 N 根 K 线低点之下，但 K 线收盘又回到该低点之上——这是一次假向下突破。看跌（SELL）： K 线的高点刺穿到前 N 根 K 线高点之上，但 K 线收盘又回到其下方——这是一次假向上突破。为了只保留有意义的扫荡，被突破的极值至少要有 Age 根 K 线那么久，这样一个刚形成、仍在成型的价位就不会触发该形态。当信号触发时，会在信号 K 线处用一条短水平线标出被扫掉的确切价位。

Bars 与 Lookback — 两个不同的设置

这两个数字容易混淆，所以值得说清楚。Lookback (N) 是用来构建每个先前极值的窗口大小——它定义了哪个高点或低点会被扫掉。Bars 是指标搜索信号的历史深度——它定义了搜索向回追溯多远（0 = 全部可用历史）。两者完全独立：增大 Lookback 会让每个极值更宽、扫荡更稀少；增大 Bars 只是显示更久远的历史信号。

入场点

指标自行跟踪假突破条件，并在价格图表上放置一个清晰的标记。提供两种独立的信号类型，各有自己的开关。

入场 — Long（假向下突破）

当价格扫到先前低点之下但收盘又回到其上方时，触发看涨 Turtle Soup。向下突破失败，卖方被套，BUY 标记被放置在信号 K 线处。被扫掉的低点就是市场拒绝的价位。

入场 — Short（假向上突破）

当价格扫到先前高点之上但收盘又回到其下方时，触发看跌 Turtle Soup。向上突破失败，买方被套，SELL 标记被放置在信号 K 线处。被扫掉的高点就是市场拒绝的价位。

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

完全的视觉控制

被扫价位线的颜色用 Swept-Level Line Color 设置，线宽用 Swept-Level Line Width 设置，范围 1 到 5 像素。价位线和两个入场标记都在颜色选择弹窗中支持透明度设置（0-100%），因此你可以让它们柔和地融入图表背景。价格图表上的标记尺寸和颜色独立设置，所以入场点在任何背景下都清晰醒目。

交互式图表面板

整个界面是一个基于画布的流畅面板，专为快速鼠标操控而打造。Turtle Soup 参数被整齐地排成一行行，入场区块用它自己的金色 ENTRY 标题单独分隔开，因此信号设置不会与价位设置混淆。面板顶栏放置着控制图标。

Power — 在不从图表移除指标的情况下，打开或关闭入场标记的绘制。

Settings（齿轮） — 打开和关闭设置区块。

Updown（箭头） — 在子窗口和主图表之间移动面板。

Close（十字） — 关闭指标。

可缩放 — 拖动右下角来缩放面板。

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

鼠标滚轮 — 把鼠标悬停在任意数值字段（Bars、Lookback、Age、Width、Size）上滚动滚轮，无需调出键盘即可改变数值。

设置与个性化

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

入场通知

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

Alert — 终端内的弹出消息。

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

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

Telegram — 提示文本连同图表截图，直接发送到你的 Telegram 聊天。

只启用你需要的渠道，当你正在使用的品种和周期上出现新入场时，你就会被立即通知。

可视化历史（HTML 报告）

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

Telegram 提醒

信号也可以直接送达你的 Telegram 聊天——提示文本连同检测时刻的图表截图。打开 Telegram 渠道，并在输入中填入你的 bot token 和 chat id。

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

内置多语言帮助

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

参数（Inputs 选项卡）

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

Turtle Soup

Lookback N — 用于定义将被扫掉的极值的先前 K 线数量（2..500）。默认值：20。

Min Age — 被扫掉的极值至少要有这么多根 K 线那么久（1..100）。默认值：3。

Bars of history to process — 向回搜索信号多少根 K 线，0 = 全部可用。与 Lookback 分开。默认值：500。

Swept-Level Line Color — 价格图表上短的被扫价位线的颜色。默认值：Silver。

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

Swept-Level Line Width — 价位线的线宽，像素，1..5。默认值：1。

Entry Points

Long (bullish false breakdown) — 当价格扫到先前低点之下并收盘回到其上方时，启用 BUY 标记。默认值：开。

Short (bearish false breakout) — 当价格扫到先前高点之上并收盘回到其下方时，启用 SELL 标记。默认值：开。

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。

Notifications

Push Notification — 启用到 MetaTrader 移动应用的推送提醒。默认值：关。

Alert Popup — 启用终端内的弹出提醒。默认值：关。

Email — 通过终端的邮件设置启用邮件提醒。默认值：关。

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

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

Telegram - bot token — 用于送达的 Telegram 机器人的 token。默认值：空。

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

Panel / Settings

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

Mini Header on collapse — 面板折叠时显示一条紧凑的顶栏条带。默认值：关。

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

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

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