VibeFox ZigZag MT5 — ヘルプ
VibeFox ZigZag — ブレイクアウトと反転のエントリーポイントを備えたスイングピボット
VibeFox ZigZag は MetaTrader 5 向けのリアルタイムなスイング構造インジケーターです。重要な高値と安値を結ぶ古典的な ZigZag ラインを描き、エントリーシグナルが発生した瞬間を価格チャート上に直接マークし、すべての操作を一つのモダンでインタラクティブなパネルにまとめます。チャートを見て天井や底を目で探す代わりに、相場の構造とエントリーポイントが形成されるその瞬間に確認できます。
インジケーターの仕組み
ZigZag は小さな価格ノイズを除去し、意味のある転換点だけ — スイング高値（ピーク）とスイング安値（トラフ）— を残します。そして連続するピボットを直線で結び、トレンドの明快な骨格を作り出します。この描画は3つの古典的なパラメータで制御されます。
Depth は2つのピボット間の最小バー数を設定し、小さな揺れを無視して十分に長く続く動きにのみ反応させます。Deviation は新しいピボットを記録するために必要な反転の最小サイズ（ポイント）で、浅い押し戻しを除外します。Backstep は同種の2つの極値間の最小バー数で、2つのピーク（または2つのトラフ）が近すぎる位置に並ぶのを防ぎます。これらを組み合わせることで、速く詳細なジグザグから、主要なスイングだけを示す遅いものまで、ラインを調整できます。
ZigZag ラインは価格チャート上にトレンドラインオブジェクトとして直接描かれ、インジケーター本体はコントロールパネルが配置される独自のサブウィンドウに存在します。Bars 設定は処理する履歴の量を制限します — 0 に設定すると利用可能なすべてのバーをスキャンし、より小さい値にすると重いチャートでの再描画が速くなります。
エントリーポイント
VibeFox ZigZag の主な価値は自動エントリーポイントにあります。インジケーターが条件を自ら追跡し、価格チャート上に明確なマーカーを配置します。それぞれ独自のトグルを持つ、2つの独立したシグナルタイプが利用できます。
エントリー — Pivot reversal
最初のシグナルは確定したすべての ZigZag ピボットで発火します。ラインがトラフ（スイング安値）を形成すると、バーの下に BUY マーカーが配置されます — 下落の動きが終わり、価格が上向きに転じます。ラインがピーク（スイング高値）を形成すると、バーの上に SELL マーカーが現れます — 上昇の動きが終わり、価格が下向きに転じます。これは反転シグナルです。スイング構造そのものの転換点を捉えます。
エントリー — Pivot breakout
2番目のシグナルは、価格が直近の反対側ピボットのレベルを超えて終値を付けたときに発火します。直近のピークを上抜けて終値を付けると BUY マーカーが配置されます — 構造が上方向にブレイクしています。直近のトラフを下抜けて終値を付けると SELL マーカーが配置されます — 構造が下方向にブレイクしています。これはモメンタム／継続シグナルです。転換点ではなく、相場が新しい方向を確認したときに反応します。
買いと売りのマーカーは Buy Color と Sell Color の設定で別々に色付けされるため、方向が一目で読み取れます。Marker セレクターはグリフを単純なクロス（+）、塗りつぶし三角形、または尾付きの矢印に切り替え、Size コントロールはマーカーをピクセル単位（6〜40）でスケールし、あらゆるチャート密度に合わせます。
完全なビジュアル制御
ZigZag ラインの色は ZigZag Line Color で、太さは ZigZag Line Width で1〜5ピクセルに設定します。ラインと両方のエントリーマーカーは、それぞれカラーピッカーのポップアップで透明度設定（0〜100%）をサポートしているため、チャートの背景に柔らかく溶け込ませることができます。価格チャート上のマーカーはサイズと色を独立して設定でき、どんな背景でもエントリーがはっきりと際立ちます。
チャート上のインタラクティブパネル
インターフェース全体は、素早いマウス操作のために作られたなめらかなキャンバスベースのパネルです。ZigZag パラメータは整然とした行にまとめられ、エントリーブロックは独自のゴールド色の ENTRY 見出しで区切られているため、シグナル設定とライン設定が混ざることはありません。パネルのヘッダーには操作アイコンが配置されています。
Power — インジケーターをチャートから取り外すことなく、エントリーマーカーの描画をオン・オフします。
Settings (gear) — 設定セクションを開閉します。
Updown (arrows) — パネルをサブウィンドウとメインチャートの間で移動します。
Close (cross) — インジケーターを閉じます。
Resizable — 右下の角をドラッグしてパネルをスケールします。
Collapsible — ヘッダーをダブルクリックするとパネルがコンパクトなストリップに折りたたまれます。
Mouse wheel — 任意の数値フィールドにカーソルを合わせてホイールをスクロールすると、キーボードを開かずに値を変更できます。
設定とパーソナライズ
Settings ボタンはパネルをワークスペースに合わせるセクションを開きます。ライト、ダーク、または自動の Theme、調整可能なパネル幅、ヘッダーサイズ、行の高さ、フォントサイズ。追加の工夫として、Hide Footer で下部バーを隠し、Mini Header で折りたたみ時にヘッダーを縮小し、外側をクリックすると自動的にパネルを折りたためます。ほぼすべてのパラメータはパネル上でライブに変化します — Inputs タブの入力フィールドは開始値を設定するだけです。各コピーに固有の Instance を与えることで、1つのチャート上で複数の独立したコピーを実行し、異なる ZigZag 設定を並べて比較することもできます。
エントリー通知
シグナルを待ちながらチャートを見張り続ける必要はありません。各エントリーは、パネル上で個別に有効化できる複数の通知チャンネルを通じて送信できます。
Alert — ターミナル内のポップアップメッセージ。
Push — お使いのスマートフォンの MetaTrader アプリへのモバイル通知。
Email — ターミナルのメール設定を通じて送信される手紙。
Telegram — アラートテキストとチャートのスクリーンショットを、お使いの Telegram チャットに直接送信。
必要なチャンネルだけを有効にすれば、作業しているシンボルと時間軸に新しいエントリーが現れた瞬間に通知を受け取れます。
ビジュアル履歴（HTML レポート）
Html チャンネルを有効にすると、すべてのエントリーシグナルが、発火した瞬間のチャートのスクリーンショットとともに HTML レポートに保存されます。レポートはターミナルの Files フォルダ内、VibeFox_ZigZag ディレクトリ（MQL5/Files/VibeFox_ZigZag/result.html）に保存され、任意のブラウザで開けます — インジケーターが見つけたすべてのエントリーのビジュアルログが得られます。ワンクリックのゴミ箱ボタンで、やり直したいときにいつでもレポートとそのスクリーンショットを消去できます。
Telegram アラート
シグナルはお使いの Telegram チャットに直接配信することもできます — アラートテキストと、検出された瞬間のチャートのスクリーンショットを一緒に。Telegram チャンネルをオンにして、入力欄にボットトークンとチャット ID を入力してください。
配信は HTML レポートに乗って行われます。新しいシグナルはレポートに書き込まれ、ブラウザで開かれたレポートが自動的にそれをあなたの Telegram チャットに転送します。このため、Telegram を有効にすると自動的に Html レポートがオンのまま保たれ、2つのチャンネルが連携して動作します。
組み込みの多言語ヘルプ
完全なヘルプページがパネルに組み込まれており、複数の言語で利用できるため、すべての操作がそれを使う場所で説明されます。
パラメータ（Inputs タブ）
ほとんどの設定はパネル上（Settings ボタン）でライブに変更することもできます — 入力パラメータは起動時の初期値を設定するだけです。
ZigZag
Depth — 2つのピボット間の最小バー数（2..100）。デフォルト：12。
Deviation — 新しいピボットを記録するために必要な反転の最小サイズ（ポイント）。デフォルト：5。
Backstep — 2つの極値間の最小バー数。デフォルト：3。
Bars of history to process — ZigZag を計算する過去のバー数、0 = 利用可能なすべて。デフォルト：500。
ZigZag Line Color — 価格チャート上の ZigZag ラインの色。デフォルト：DodgerBlue。
ZigZag Line Transparency — ラインの透明度（パーセント）、0〜100。デフォルト：0。
ZigZag Line Width — ラインの太さ（ピクセル）、1..5。デフォルト：2。
Entry Points
Pivot Reversals — 確定した ZigZag ピボットでのマーカーを有効にします（トラフ = BUY、ピーク = SELL）。デフォルト：オン。
Pivot Breakout — 価格が直近の反対側ピボットを超えて終値を付けたときのマーカーを有効にします。デフォルト：オン。
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_ZigZag/result.html に保存します。デフォルト：オフ。
Telegram — HTML レポートを介して、チャートのスクリーンショット付きのシグナルを Telegram チャットに転送します。デフォルト：オフ。
Telegram - bot token — 配信に使用する Telegram ボットのトークン。デフォルト：空。
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。