AI駆動型 EA ポートフォリオ OS
利用マニュアル — AXISTRADE
ValkyrieはMT4/MT5上で稼働する複数のEA（Expert Advisor）をリアルタイムで監視し、AI（Claude, Gemini, DeepSeek等）による自動監査と、緊急時の自動停止（キルスイッチ）を提供するシステムです。
C:\Valkyrie\ に展開各EA（.mq4/.mq5ファイル）に約150行の連携コードをincludeする必要があります。
これはテンプレートとして提供されるため、コピペするだけです。
連携コードがやること:
| portfolio.json 書き込み | 30秒毎にEAの状態（マジックナンバー、通貨ペア、損益、DD、ポジション等）を共有フォルダに書き込み |
| ai_command.json 読み取り | Valkyrieからの停止/再開コマンドを読み取り、該当Magic#の場合に実行 |
MQLテンプレート概要:
EA側に連携コード（テンプレートMQL）が入っていれば、そのEAはportfolio.jsonに自動でMagic#を含めて書き込まれます。
Valkyrie側での手動EA登録は不要です。
| 項目 | 自動？ | 説明 |
|---|---|---|
| Magic# 検出 | ✅ 自動 | portfolio.jsonに自動記録 |
| 通貨ペア | ✅ 自動 | EA側から自動取得 |
| 損益・DD・PF等 | ✅ 自動 | 30秒毎にリアルタイム更新 |
| EA名 | 📝 手動（任意） | 「🏷 EA名管理」から登録。見やすさのためのオプション |
EA名の登録場所:
画面構成:
| ヘッダーバー | VALKYRIE ロゴ、システム状態、ハートビート、時計 |
| ティッカー (2段) | 上段: マーケットニュース / 下段: ホエールアラート |
| AI 5部門ボタン | Strategy / Antigravity / Review / Local / DeepSeek |
| 左カラム | ポートフォリオサマリー + AI監査結果 + Neural Bridgeログ |
| 右カラム | EA一覧テーブル（フィルタ・ソート・個別操作） |
| フッターバー | マニュアル / EA名管理 / MT4/MT5連携 / ライセンス猶予 |
EA一覧テーブルの列:
| 列 | 説明 | 色分け |
|---|---|---|
| 🔴🟡🟢 | リスクインジケーター | DD≧10%=赤, ≧5%=黄, <5%=緑 |
| Magic# | EA識別番号 | — |
| 通貨ペア | 取引対象 | シアン |
| 損益 | 未実現損益 | +緑 / -赤 |
| DD% | ドローダウン | 危険=赤, 警告=黄, 正常=緑 |
| EA名 | 登録済み名前 | 黄色（クリックで編集） |
| 操作 | 停止/再開ボタン | 停止=赤, 再開=緑 |
| ポートフォリオDD | ≧ 15-20% → 全EA停止（config.pyで変更可） |
| 日次損失上限 | ≧ 2-3% → 警告→全停止（KILL_DAILY_LOSS_PCT） |
| 週次損失上限 | ≧ 4-6% → 全停止（KILL_WEEKLY_LOSS_PCT） |
| 異常EA数 | DANGER状態が5EA以上で全停止 |
| MT接続障害 | 300秒以上無応答で全停止 |
| 手動リセット | KS発動後は手動でのみ解除可能（自動復帰なし） |
| 停止 | EA一覧の「停止」ボタンをクリック → ai_command.json に {"action":"stop", "magic_number":100001} を書き込み → EA側が読み取り → ポジション決済・注文停止 |
| 再開 | 停止中のEAの「再開」ボタンをクリック → 同様のフローで通常トレード再開 |
| AI推奨停止 | AI監査がリスク判定 → 自動で停止コマンド発行（DD≧10% かつ連敗≧5） |
各EAは6つの状態を持ち、条件に基づいて自動遷移します
| 状態 | 意味 | Tier優先順位 |
|---|---|---|
| RUNNING | 通常稼働 | — |
| WARNING | 注視中（稼働継続） | — |
| DANGER | 停止候補（AI推奨待ち） | Tier3→Tier2→Tier1の順に停止 |
| STOPPED | 全ポジション決済済み | — |
| COOLING | 冷却期間（24h経過観察） | Tier1→Tier2→Tier3の順に再開 |
| TEST | 縮小ロットで検証中 | 25%→50%→100%段階 |
停止判定（多因子複合スコア）:
| 要因 | 閾値 | スコア |
|---|---|---|
| 直近期待値マイナス | 直近50取引 | +2 |
| PF低下 | PF < 1.1 | +1 |
| 連敗 | ≧5回 | +2 |
| DD比率 | 現在DD / maxDD ≧ 70% | +2 |
| 勝率低下 | 10%以上低下 | +1 |
| 合計スコア ≧ 4 → 停止候補 | ≧4 | |
再開判定（停止より厳格）:
| 期待値 | 直近30取引でプラス（必須） |
| PF | > 1.2（必須） |
| DD回復 | 下降トレンド確認（必須） |
| マーケット適合 | ロジックと市場環境の一致 |
| 相関緩和 | 他EA との過度な相関がないこと |
| 段階的再開 | テストロット 25% → 50% → 100%（各段階10取引以上） |
相関管理:
| 注意 ≧ 0.70 | 同時稼働を監視。ログに記録。 |
| 制限 ≧ 0.85 | 同時稼働を制限。Tier3 EAを先に停止。ロット縮小提案。 |
| 緩和策 | 新規開始制限、ロット縮小、低Tier EA停止 |
通貨エクスポージャー上限:
| USD | ≤ 30% |
| JPY | ≤ 25% |
| EUR | ≤ 25% |
| GBP | ≤ 20% |
| Gold | ≤ 20% |
上限超過 → 新規開始制限、Tier3停止、ロット縮小提案
配分ロジック（リスク予算ベース）:
月間リスクプロファイル:
| プロファイル | 月間利益目標 | 最大DD |
|---|---|---|
| 低リスク | 1-3% | 5-10% |
| 標準（推奨） | 3-5% | 10-15% |
| 積極 | 5-8% | 15-25% |
評価優先順: DD制御 > PF > 期待値 > 相関 > 崩壊回避
| 機能 | Standard | Pro | Fund |
|---|---|---|---|
| EA監視・リスク分析 | ✅ | ✅ | ✅ |
| 停止候補表示 | ✅ | ✅ | ✅ |
| キルスイッチ | ✅ | ✅ | ✅ |
| 再開候補表示 | — | ✅ | ✅ |
| 相関管理 | — | ✅ | ✅ |
| 配分提案 | — | ✅ | ✅ |
| 自動停止/再開 | — | — | ✅ |
| 自動再配分 | — | — | ✅ |
| フルKS制御 | — | — | ✅ |
| 環境 | 対応 | 連携方式 |
|---|---|---|
| 同一PC | ✅ | C:\Valkyrie\shared フォルダ直接読み書き |
| VPS経由 | ✅ | ネットワークドライブ (SMB) or HTTP API |
| 複数MT4/MT5 | ✅ | 1つのValkyrieで統合管理 |
| 100+ EA | ✅ | Magic#が一意であれば台数制限なし |
条件: マジックナンバーが全EA間で一意であること
同一Magic#のEAが複数存在すると競合が発生します。EA毎にユニークな番号を設定してください。
月額課金が未確認となった場合、以下の段階的制限が適用されます。日数は管理者がconfig.pyで変更可能です。
重要保護ポイント:
Q: EA側にソースコード（連携コード）が入っていれば、管理画面でEA登録は不要？
A: はい、不要です。 連携コード入りのEAは portfolio.json に自動的にMagic#を含めて書き込みます。Valkyrie側はそれを自動検出するので、手動登録は不要です。EA名だけは任意で手動登録できます。
Q: マジックナンバーを入力するだけで対象EAは稼働開始・停止・再開するのか？
A: EA側に連携コードが入っている前提で、Yes。 Valkyrie GUIの停止/再開ボタンを押すと、ai_command.json にそのMagic#のコマンドが書かれ、EA側が読み取って実行します。ただしEA側に連携コード（テンプレートMQL）が組み込まれていなければ動きません。
Q: VPS上のMT4/MT5でも使えるか？
A: はい。 VPSとValkyrie間で shared フォルダを共有（SMBネットワークドライブ or HTTP API）すれば、VPS上のEAも管理可能。100EA以上、複数MT4/MT5ターミナルの統合管理に対応。
Q: 起動時にプログレスバーが15%で止まる
A: v2.1.15以降で修正済み。 VBSの自動修復機能がcustomtkinter等の不足パッケージを自動インストールします。もし停滞する場合は python_rt フォルダを削除して再実行してください。
Q: ライセンスが切れたらトレードはどうなるか？
A: 急に止まりません。 7日間の猶予期間があります（1→3→5→7日の段階的通知）。5日目まではEA監視を継続、キルスイッチは7日目まで動作します。課金復旧で即時全機能回復。