用途：以15分钟K线扫描全球外汇市场，运行严格的锁定前向Smart-Money-Concept（SMC）分阶段状态机，在后期阶段触发提醒；由加密引擎演进而来，策略相同，针对外汇速度与机制做优化。
主要能力：扫描流动性筛选后的品种，包括外汇主要与交叉货币对、金属（XAU/USD、XAG/USD）、能源（WTI、Brent、NatGas）及指数（NAS100、S&P500、US30、DAX、FTSE100、Nikkei225、DXY），定义于assets/instruments.py。数据经yfinance取自Yahoo Finance，为真实15分钟OHLC，无需API密钥。策略阶段：Stage 0 FVG/脉冲背景→Stage 1首次流动性锁定+BoS收盘→Stage 2流动性扫荡（收盘穿越）→Stage 3 FVG交互→Stage 4反向确认即验证入场；锁定前向，各阶段只搜索一次并锁定，不会静默回退。外汇细化：风险模型含点/手（默认微型0.01）/杠杆（默认500，仅保证金）/所需保证金/美元风险回报，点差感知；Stage 3与离场可盘中触发，结构阶段（1/2）保持收盘确认；Stage 3/4无TTL；市场时钟、新闻雷达按安全/谨慎/禁交易分级。
使用方式：复制.env.example为.env并设置TELEGRAM_BOT_TOKEN与TELEGRAM_CHAT_ID（可选LEVERAGE/LOT_SIZE）；本地运行bash assets/run_one_shot.sh；Docker运行docker build -t fvg-forex assets/ && docker run -p 7860:7860 --env-file .env fvg-forex。端点包括/（面板）、/health、/api/state、/api/market、/api/news、/api/chart.png?symbol=EUR/USD。无Telegram凭据时界面仍运行，仅跳过提醒并记录日志。
限制：所有参数为带生产安全默认值的环境变量，详见assets/VARIABLES_AND_SECRETS_GUIDE.txt；结构阶段基于最后一根已收盘蜡烛，Stage-3触达与SL/TP/BE在INTRABAR_*开启时使用形成中蜡烛；Cron/每周时间均为UTC，面板按浏览器时区显示时间与倒计时；yfinance需访问Yahoo，新闻雷达需访问ForexFactory，二者均无需密钥，不可达时引擎优雅降级；点值为经纪商近似默认值，可用FVG_PIPVAL_<PAIR>覆盖。修改app.py前请阅读assets/AGENT.md。