╔══════════════════════════════════════════════════════════════╗
║ AI US500 PRO ║
║ 混合趋势 / 均值回归 cBot ║
║ 多AI • 多时间框架 ║
╚══════════════════════════════════════════════════════════════╝
🧠 **AI US500 PRO** 是专为 S&P 500 指数（US500）设计的专业 cTrader cBot。它结合了多时间框架技术分析和人工智能，在执行每笔交易前进行过滤。
该机器人在**3个同时运行的时间框架**（H4 → H1 → M15）上操作，自动检测市场状态（趋势或震荡），并应用最合适的策略：市场有方向时采用趋势跟踪，市场横盘时采用均值回归。每个生成的信号都可以通过您选择的**13个支持的AI提供商**的模型实时验证。
运行时使用 `AccessRights.None` — 无需特殊权限，使用 cTrader 原生 HTTP API。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📐 **策略架构**
机器人遵循级联决策流程：
```
H4 (EMA 200) → 确定长期方向偏好（看涨 / 看跌 / 中性）
↓
H1 (EMA 50 + RSI 14) → 确认方向并评估超买超卖
↓
M15 (EMA 21/50 + 随机指标 + 布林带 + ADX + ATR) → 生成入场信号
↓
AI (Claude / GPT / Gemini / ...) → 以置信度评分过滤信号
↓
执行 → 计算交易量，动态止损/止盈，移动止损
```
⚡ **状态检测（ADX）**
— ADX ≥ 阈值 → 趋势市场 → 采用趋势跟踪策略
— ADX < 阈值 → 震荡市场 → 采用均值回归策略
切换完全自动，逐根K线执行。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📊 **趋势跟踪策略**
多头入场条件：
✅ H4：价格高于 EMA 200（看涨偏好）
✅ H1：价格高于 EMA 50 + RSI > 50
✅ M15：EMA 21 上穿 EMA 50（看涨交叉）
✅ M15：随机指标 K 线上穿 D 线，且 K < 65（未超买）
空头入场条件：对称且相反。
📊 **均值回归策略**
多头入场条件：
✅ ADX 低于阈值（震荡市场）
✅ M15：价格触及或突破下轨布林带
✅ M15：随机指标 K < 20（超卖）
✅ H1：RSI < 35（看跌超买）
空头入场条件：对称且相反。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🤖 **AI 集成 — 13 个提供商**
当机器人生成有效技术信号时，执行前会向 AI 发送包含以下内容的完整数据包：
— 所有多时间框架指标
— 最近 N 根 M15 K线（OHLCV）
— 建议方向和当前策略
— 风险参数（止损/止盈点数，风险回报比）
— 账户状态和持仓情况
AI 返回：
— **置信度评分**（0-100%）
— **决策**（执行 / 不执行）
— **关键因素**（2-3 个主要因素）
— **风险警告**（主要识别风险）
如果置信度低于最低阈值，交易将被**阻止**。
每笔交易关闭后，AI 还会提供**交易后分析**，包括评估、评级和经验教训。
**支持的提供商：**
```
1. Anthropic (Claude) — claude-sonnet-4
2. OpenAI (ChatGPT) — gpt-4o
3. Google (Gemini) — gemini-2.0-flash
4. Mistral — mistral-large-latest
5. Groq — llama-3.3-70b-versatile
6. Perplexity — sonar-pro
7. Cohere — command-r-plus
8. xAI (Grok) — grok-2
9. DeepSeek — deepseek-chat
10. Together AI — Llama-3.3-70B-Instruct-Turbo
11. Fireworks AI — llama-v3p3-70b-instruct
12. OpenRouter — anthropic/claude-sonnet-4
13. Ollama (本地，免费) — llama3.1
```
每个提供商都有预配置的默认 URL 和模型。您可以覆盖模型和 URL 以获得最大灵活性。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔧 **参数 — 完整指南**
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
💰 **1. 风险管理**
▸ **风险模式** — `PercentRisk` / `FixedLot`
选择基于百分比的仓位大小或固定手数。在 PercentRisk 模式下，机器人根据止损距离和可用资金自动计算交易量。默认：`PercentRisk`
▸ **每笔交易风险 %** — 0.1% 到 5.0%
每笔交易风险占账户余额的百分比。交易量计算确保止损触发时损失正好等于该百分比。默认：`1.0%`
▸ **固定交易量（手数）** — 0.01 及以上
固定手数，仅在风险模式设为 FixedLot 时使用。默认：`0.1`
▸ **最大持仓数** — 1 到 10
机器人可同时持有的最大仓位数。达到限制时不再开新仓。默认：`3`
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📈 **2. H4 趋势偏好**
▸ **H4 EMA 周期** — 50 及以上
应用于 H4 时间框架的 EMA 周期。决定长期方向偏好。价格高于 EMA = 看涨，低于 = 看跌。基于 ATR 的缓冲区防止价格过于接近均线时产生假信号。默认：`200`
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔍 **3. H1 确认**
▸ **H1 EMA 周期** — 10 及以上
H1 时间框架的 EMA 周期。价格必须位于该 EMA 的正确一侧以确认入场。默认：`50`
▸ **H1 RSI 周期** — 5 及以上
H1 时间框架的相对强弱指数周期。用于趋势确认（多头 RSI > 50，空头 < 50）及均值回归中过度延伸过滤（RSI < 35 或 > 65）。默认：`14`
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🎯 **4. M15 入场**
▸ **快速 EMA 周期** — 5 及以上
入场时间框架（M15）上的快速 EMA。与慢速 EMA 的交叉生成趋势跟踪信号。默认：`21`
▸ **慢速 EMA 周期** — 10 及以上
慢速 EMA。快速/慢速 EMA 交叉是趋势策略的主要触发器。默认：`50`
▸ **随机指标 K / D / 减速** — 随机振荡器周期
用作动量确认。在趋势策略中过滤非极端区域的入场；在均值回归中识别超买/超卖区域。默认：`K=14, D=3, Slowing=3`
▸ **布林带周期** — 10 及以上
布林带周期。在均值回归中，触及上轨/下轨是入场触发条件。默认：`20`
▸ **布林带标准差** — 1.0 及以上
带宽标准差。数值越高，带宽越宽，信号越少但更可靠。默认：`2.0`
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🌡️ **5. 状态检测（ADX）**
▸ **ADX 周期** — 7 及以上
方向运动系统周期。衡量趋势强度，不考虑方向。默认：`14`
▸ **ADX 趋势阈值** — 15 到 40
区分趋势市场和震荡市场的阈值。ADX 高于此值表示趋势跟踪激活；低于则激活均值回归。默认：`25`
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🛡️ **6. 止损 / 止盈（基于 ATR）**
所有止损和止盈均为动态，按当前 ATR 的倍数计算。这意味着它们会自动适应波动性：平静市场中止损紧密，波动市场中止损较宽。
▸ **ATR 周期** — 5 及以上
平均真实波幅周期。衡量近期波动性，是止损、止盈、保本和移动止损计算的基础。默认：`14`
▸ **止损 x ATR** — 0.5 及以上
止损的 ATR 倍数。例如：ATR = 20 点，倍数 1.5，止损距离入场价 30 点。默认：`1.5`
▸ **止盈 x ATR（趋势）** — 1.0 及以上
趋势跟踪中止盈的 ATR 倍数。通常高于止损以获得有利的风险回报比。默认：`2.5`
▸ **止盈 x ATR（回归）** — 0.5 及以上
均值回归中止盈的 ATR 倍数。通常更保守，因为目标是回归均值。默认：`1.5`
▸ **最小止损（点数）** — 1 及以上
最小止损点数。如果 ATR 计算的止损低于此值，则使用最小值。防止极低波动时止损过紧。默认：`10`
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔄 **7. 移动止损**
针对持仓的主动管理系统，包含自动保本和基于 ATR 的移动止损。
▸ **启用移动止损** — 开/关
启用或禁用整个移动止损系统。关闭时，持仓保持固定止损/止盈直至平仓。默认：`开`
▸ **保本触发 x ATR** — 0.3 及以上
当未实现利润达到该 ATR 倍数时，止损移至入场价（加半点差覆盖成本）。交易变为无风险。默认：`1.0`
▸ **移动止损距离 x ATR** — 0.5 及以上
移动止损距离，基于当前价格的 ATR 倍数。止损随价格移动且不会回退。默认：`1.2`
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🕐 **8. 交易时段过滤**
根据时间过滤交易活动。US500 在盘前、常规交易时段和盘后表现差异显著。
▸ **启用时段过滤** — 开/关
启用或禁用时间过滤。默认：`开`
▸ **时段开始（CET小时）** — 0-23
交易窗口开始时间（中欧时间）。默认：`15`（美国交易时段开始）
▸ **时段结束（CET小时）** — 0-23
交易窗口结束时间。默认：`22`（美国交易时段结束）
机器人也支持跨午夜的时段（例如开始=22，结束=6）。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚙️ **9. 其他**
▸ **冷却时间（K线数）** — 0 及以上
两笔交易之间必须经过的最少 M15 K线数。防止快速信号时过度交易。默认：`3`（即45分钟）
▸ **显示仪表盘** — 开/关
显示或隐藏图表上的仪表盘，包含状态、偏好、指标、盈亏、AI 状态和实时统计。默认：`开`
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🤖 **10. AI 分析**
▸ **启用 AI 过滤** — 开/关
启用或禁用 AI 过滤。关闭时，机器人仅基于技术分析运行。默认：`关`
▸ **AI 提供商** — 13 个提供商中选择
选择使用的 AI 提供商。每个提供商都有预配置的 URL 和模型。默认：`Anthropic`
▸ **API 密钥** — 字符串
所选提供商的 API 密钥。除 Ollama（本地运行）外，所有提供商均需。使用 Ollama 时留空。
▸ **模型（空白=默认）** — 字符串
AI 模型覆盖。留空使用所选提供商默认模型。适用于测试特定模型（如 "gpt-4o-mini", "claude-haiku-4-5-20251001"）。
▸ **自定义 API URL（空白=默认）** — 字符串
API URL 覆盖。适用于 Ollama 自定义端口、企业代理或自定义端点。
▸ **最低置信度 (%)** — 30 到 95
批准交易的最低 AI 置信度阈值。若 AI 返回分数低于此值，即使所有技术信号有效，交易也会被阻止。默认：`65`
▸ **失败时允许交易** — 开/关
AI 失败时（超时、API 故障、响应格式错误）的行为。开 = 交易仍执行（失败开放）；关 = 交易阻止（失败关闭）。默认：`开`
▸ **交易后 AI 审核** — 开/关
启用后，每笔交易关闭后机器人将结果发送给 AI，AI 提供评估、评级（好/中立/差）和经验教训。所有内容记录到控制台。默认：`开`
▸ **发送给 AI 的价格 K线数** — 5 到 25
发送给 AI 进行分析的最近 M15 K线数量。K线越多，上下文越丰富，但消耗的令牌也越多。默认：`12`
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📋 **图表上的仪表盘**
仪表盘实时显示：
— 当前状态（趋势 / 震荡）
— H4 偏好（多头 / 空头 / 横盘）
— ADX、ATR、H1 RSI 数值
— 持仓数 / 最大持仓数
— 未实现盈亏、余额、净值
— 交易时段状态（激活 / 关闭）
— 总交易次数及胜率百分比
— AI 状态：提供商、最后决策、置信度
— AI 调用次数及被阻止交易数
颜色自动变化：🟢 盈亏为正时为绿色，🔴 负时为红色。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📌 **技术说明**
— 推荐时间框架：**M15**（机器人会警告使用其他时间框架）
— `AccessRights.None` — 无需特殊权限
— 使用 cTrader 原生 `Http.Send()` 进行 AI 调用
— 兼容 cTrader 4.2+ (.NET 6)
— 支持回测（无 AI）和实盘交易（有或无 AI）
— 机器人持仓以标签 `AiUS500Pro` 标识
— 不干扰手动持仓或其他机器人
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚠️ **免责声明**
此 cBot 仅供教育和信息用途。交易指数存在重大资本损失风险。过去的结果不保证未来收益。AI 集成提高了过滤效果，但不消除风险。使用实盘账户前务必在模拟账户测试。您对自己的交易决策负全责。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
