Files
zhutoutoutousan 605faf5310 Prepare source-only public release for develop.
Add cluster audit pipeline, united EA updates, brochure generators, and publication hygiene (gitignore, MT5 path desensitization, pre-upload scan). Remove tracked reports, models, and binary artifacts from the repo.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-02 15:03:43 +02:00

286 lines
8.5 KiB
Python

"""
Launch MT5 Strategy Tester for SimpleEMA (native backtest / genetic optimize).
Requires MT5 running and logged in. Compiles main.mq5 into your terminal data folder,
then runs terminal64.exe /config:... (same flow as cluster united_mt5_runner).
Examples:
python run_mt5_tester.py backtest
python run_mt5_tester.py backtest --visual
python run_mt5_tester.py optimize
python run_mt5_tester.py backtest --symbol EURUSD --from 2023.01.01 --to 2026.01.01
"""
from __future__ import annotations
import argparse
import re
import shutil
import subprocess
import time
from pathlib import Path
import MetaTrader5 as mt5
LAB = Path(__file__).resolve().parent
EA_SRC = LAB / "main.mq5"
DEFAULT_SET = LAB / "SimpleEMA_EURUSD.set"
OPT_SET = LAB / "SimpleEMA_Genetic_Optimization.set"
LABELS = {
"profit_factor": ("Profit Factor", "盈利因子"),
"net_profit": ("Total Net Profit", "总净盈利"),
"total_trades": ("Total Trades", "交易总计"),
"sharpe": ("Sharpe Ratio", "夏普比率"),
"equity_dd": ("Equity Drawdown Maximal", "最大回撤"),
}
def read_text(path: Path) -> str:
text = path.read_text(encoding="utf-16", errors="ignore")
if not text.strip():
text = path.read_text(encoding="utf-8", errors="ignore")
return text
def grab_metric(text: str, key: str) -> str | None:
for label in LABELS[key]:
for pat in (
rf">{re.escape(label)}</td>\s*<td[^>]*>(?:<b>)?([^<]+)",
rf">{re.escape(label)}:</td>\s*<td[^>]*>(?:<b>)?([^<]+)",
):
m = re.search(pat, text, re.I)
if m:
return m.group(1).strip()
return None
def parse_report(data: Path, report: str) -> dict:
for path in sorted(data.glob(f"**/{report}*.htm*"), key=lambda p: p.stat().st_mtime, reverse=True):
text = read_text(path)
pf = grab_metric(text, "profit_factor")
profit = grab_metric(text, "net_profit")
trades = grab_metric(text, "total_trades")
sharpe = grab_metric(text, "sharpe")
dd = grab_metric(text, "equity_dd")
if pf or profit or trades:
return {
"profit_factor": float(pf) if pf else None,
"net_profit": _num(profit),
"total_trades": int(float(trades)) if trades and trades[0].isdigit() else None,
"sharpe": float(sharpe) if sharpe else None,
"max_drawdown": dd,
"report": str(path),
"ready": True,
}
for ext in (".htm", ".html"):
p = data / f"{report}{ext}"
if p.exists():
text = read_text(p)
pf = grab_metric(text, "profit_factor")
if pf:
return {"ready": True, "report": str(p), "profit_factor": float(pf)}
return {"ready": False}
def _num(s: str | None) -> float | None:
if not s:
return None
s = s.replace(" ", "").replace(",", "")
if s.endswith("%"):
return float(s[:-1])
return float(s)
def mt5_context() -> dict:
if not mt5.initialize():
raise RuntimeError(f"MT5 init failed: {mt5.last_error()}")
info = mt5.terminal_info()
acc = mt5.account_info()
ctx = {
"data": Path(info.data_path),
"mt5_path": Path(info.path),
"login": acc.login if acc else 0,
"server": acc.server if acc else "",
}
mt5.shutdown()
return ctx
def deploy_ea(data: Path, mt5_path: Path) -> Path:
dst_dir = data / "MQL5" / "Experts" / "lab" / "SimpleEMA"
dst_dir.mkdir(parents=True, exist_ok=True)
dst = dst_dir / "main.mq5"
shutil.copy2(EA_SRC, dst)
log = dst_dir / "compile.log"
subprocess.run(
[str(mt5_path / "metaeditor64.exe"), f"/compile:{dst}", f"/log:{log}"],
timeout=180,
capture_output=True,
)
time.sleep(3)
ex5 = dst_dir / "main.ex5"
if not ex5.exists():
tail = log.read_text(encoding="utf-8", errors="ignore")[-2000:] if log.exists() else ""
raise RuntimeError(f"Compile failed — open MetaEditor and check:\n{dst}\n{tail}")
pub = data / "MQL5" / "Experts" / "SimpleEMA.ex5"
shutil.copy2(ex5, pub)
return pub
def copy_set_to_tester(data: Path, set_path: Path, set_name: str) -> Path:
profiles = data / "MQL5" / "Profiles" / "Tester"
profiles.mkdir(parents=True, exist_ok=True)
dst = profiles / set_name
shutil.copy2(set_path, dst)
return dst
def build_ini(
*,
set_name: str,
report: str,
login: int,
server: str,
symbol: str,
period: str,
from_date: str,
to_date: str,
deposit: float,
leverage: int,
optimization: int,
visual: bool,
) -> str:
return f"""[Common]
Login={login}
Server={server}
[Tester]
Expert=SimpleEMA.ex5
ExpertParameters={set_name}
Symbol={symbol}
Period={period}
Optimization={optimization}
Model=1
Dates=1
FromDate={from_date}
ToDate={to_date}
ForwardMode=0
Deposit={deposit}
Currency=USD
Leverage={leverage}
ExecutionMode=0
Report={report}
ReplaceReport=1
ShutdownTerminal=1
Visual={1 if visual else 0}
"""
def run_tester(
ctx: dict,
*,
mode: str,
set_path: Path,
set_name: str,
report: str,
symbol: str,
period: str,
from_date: str,
to_date: str,
deposit: float,
leverage: int,
visual: bool,
timeout_sec: int = 3600,
) -> dict:
data: Path = ctx["data"]
mt5_path: Path = ctx["mt5_path"]
deploy_ea(data, mt5_path)
copy_set_to_tester(data, set_path, set_name)
optimization = 2 if mode == "optimize" else 0
ini_body = build_ini(
set_name=set_name,
report=report,
login=ctx["login"],
server=ctx["server"],
symbol=symbol,
period=period,
from_date=from_date,
to_date=to_date,
deposit=deposit,
leverage=leverage,
optimization=optimization,
visual=visual,
)
ini = data / f"{report}.ini"
ini.write_text(ini_body, encoding="utf-8")
for ext in (".htm", ".html"):
p = data / f"{report}{ext}"
if p.exists():
p.unlink(missing_ok=True)
subprocess.run(["taskkill", "/IM", "terminal64.exe", "/F"], capture_output=True)
subprocess.run(["taskkill", "/IM", "metatester64.exe", "/F"], capture_output=True)
time.sleep(4)
print(f"Starting MT5 Strategy Tester ({mode}) …")
print(f" EA: SimpleEMA.ex5 Symbol: {symbol} Period: {period}")
print(f" Range: {from_date}{to_date} Visual: {visual}")
t0 = time.time()
subprocess.run([str(mt5_path / "terminal64.exe"), f"/config:{ini}"], timeout=timeout_sec)
metrics = parse_report(data, report)
metrics["elapsed_sec"] = round(time.time() - t0, 1)
metrics["mode"] = mode
return metrics
def parse_args() -> argparse.Namespace:
p = argparse.ArgumentParser(description="SimpleEMA MT5 Strategy Tester launcher")
p.add_argument("mode", choices=["backtest", "optimize"], help="backtest or genetic optimize")
p.add_argument("--symbol", default="EURUSD")
p.add_argument("--period", default="H1", choices=["M15", "M30", "H1", "H4"])
p.add_argument("--from", dest="from_date", default="2023.01.01")
p.add_argument("--to", dest="to_date", default="2026.01.01")
p.add_argument("--deposit", type=float, default=10000)
p.add_argument("--leverage", type=int, default=100)
p.add_argument("--visual", action="store_true", help="Visual mode (watch bars tick by tick)")
p.add_argument("--set", dest="set_file", default="", help="Custom .set path")
return p.parse_args()
def main() -> None:
args = parse_args()
ctx = mt5_context()
set_path = Path(args.set_file) if args.set_file else (OPT_SET if args.mode == "optimize" else DEFAULT_SET)
set_name = set_path.name
report = f"SimpleEMA_{args.symbol}_{args.mode}"
metrics = run_tester(
ctx,
mode=args.mode,
set_path=set_path,
set_name=set_name,
report=report,
symbol=args.symbol,
period=args.period,
from_date=args.from_date,
to_date=args.to_date,
deposit=args.deposit,
leverage=args.leverage,
visual=args.visual,
)
if metrics.get("ready"):
print("\n=== MT5 Report ===")
for k in ("net_profit", "profit_factor", "total_trades", "sharpe", "max_drawdown", "elapsed_sec"):
if k in metrics and metrics[k] is not None:
print(f" {k}: {metrics[k]}")
print(f" report: {metrics.get('report')}")
print("\nOpen the HTML report in MT5 → Results tab for per-deal review (逐单复盘).")
else:
print("Report not found — check MT5 Tester journal for errors.")
if __name__ == "__main__":
main()