用途：作为面向 AI 智能体的可安装技能，运行一个生产级 FastAPI 服务，扫描全球外汇市场 15 分钟 K 线，执行严格锁定向前的 Smart-Money-Concept（SMC）分阶段状态机，并在后期阶段告警。它是 FVG-Delta 加密引擎的外汇版本，策略相同，针对外汇的速度与机制做了调整。
扫描范围：位于 assets/instruments.py 的经流动性筛选的品种池，包括外汇主要与次要货币对（EUR/USD、GBP/JPY、EUR/GBP 等）、金属（XAU/USD 黄金、XAG/USD 白银）、能源（WTI、Brent、NatGas）、指数（NAS100、S&P500、US30、DAX、FTSE100、Nikkei225、DXY）。数据经 yfinance 从 Yahoo Finance 获取真实 15 分钟 OHLC，无需 API 密钥。
策略：Stage 0 FVG/脉冲背景 → Stage 1 首次流动性锁定 + BoS 收盘 → Stage 2 流动性扫荡（收盘穿越）→ Stage 3 FVG 交互 → Stage 4 反向确认=验证入场。锁定向前：每次转换只搜索一次并锁定，阶段不会静默回退。
外汇调整：风险模型按 pips/手（默认微型 0.01）/杠杆（默认 500，仅保证金）/所需保证金/美元风险回报计算（盈亏=pips×pip 值×手数），考虑点差，替代加密的 ROI/自动杠杆模型。IB 内 Stage 3 与出场：FVG 触碰在形成中的 K 线登记；SL/TP/保本在 IB 内触发。结构性阶段（1/2）仍基于收盘。Stage 3/4 无 TTL，仅在真实触发时解决。另有市场时钟（开/关徽章、周末与假日、浏览器时区倒计时）和新闻雷达（ForexFactory 周报，分级 Safe/Caution/No-Trade，附短标签与倒计时，显示在仪表盘与 Telegram 告警中）。
运行方式：先复制 .env.example 为 .env 并设置 TELEGRAM_BOT_TOKEN 与 TELEGRAM_CHAT_ID，可选 LEVERAGE / LOT_SIZE；本地运行 bash assets/run_one_shot.sh；Docker/Hugging Face Spaces 运行 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 凭据时 UI 仍可运行，仅跳过告警并记录日志。
限制与注意：所有参数为环境变量且有生产安全默认值，参见 assets/VARIABLES_AND_SECRETS_GUIDE.txt；结构性阶段基于最后收盘 K 线（bars[-2]），Stage 3 触碰与 SL/TP/BE 在 INTRABAR_* 开启时使用形成中 K 线（bars[-1]）；cron/周度时间为 UTC，仪表盘按浏览器时区渲染；yfinance 需要访问 Yahoo，新闻雷达需要访问 ForexFactory，二者均无需密钥，数据源不可达时引擎会优雅降级；pip 值为经纪商近似默认值，可通过 FVG_PIPVAL_<PAIR> 覆盖；编辑 app.py 前应阅读 assets/AGENT.md。资料未提供价格、收费或效果保证。