3AI Trade EA - 安装使用说明

一、安装前准备

请确认您的电脑满足以下条件：

操作系统 Windows 10 或 Windows 11（64位）
不支持 Windows 7/8 及 macOS
如使用 VPS/云服务器，建议 Windows Server 2016/2019/2022

硬件配置

CPU	2核起步，4核更好
内存	4GB起步，8GB更稳
磁盘	40GB以上
带宽	3M~5M够用

MT5 终端已安装 MetaTrader 5 终端，并已登录交易账号
如未安装，请前往 metaquotes.net 下载

AI模型 API Key 从以下 8 个主流 AI 模型中选择 3 个并获取 API Key（EA 默认使用 Kimi + DeepSeek + 豆包）：
· Kimi — kimi.moonshot.cn
· DeepSeek — platform.deepseek.com
· Qwen 通义千问 — dashscope.aliyun.com
· 豆包 — ark.cn-beijing.volces.com
· 智谱 GLM — open.bigmodel.cn
· Gemini — aistudio.google.com
· ChatGPT — platform.openai.com
· Grok — x.ai
模型地位平等，无固定权重、无一票否决权，采用“主导+跟随双确认 + 分歧保护”机制。可在控制台 AI 配置页自由替换任意模型。

酷酷说授权码购买后在 member.kukushuo.com 获取授权码（格式：KUKU-3AI-XXXXXXXX）
并绑定您的 MT5 交易账号

网络连接首次启动必须联网验证
验证成功后断网可继续运行24小时

系统组件首次运行 start.bat 会自动安装 VC++ 运行库

收到文件 start.bat — 启动器（双击此文件运行，非 exe）
3AITradeController.exe — 本地AI控制器（放任意目录）
VC_redist.x64.exe — VC++ 运行库（首次自动安装）
3AI Trade EA.mq5 — EA源码文件（需放入MT5目录）
*.mqh / CustomIndicators/ — EA依赖的头文件和自定义指标
注意：.mq5 是源码文件，需要MT5编译后才能用（MT5会自动编译）

⚠ 二、杀毒软件处理（非常重要！）

🔴 为什么需要处理杀毒软件？

3AITradeController.exe 是用 Python 编写、通过 Nuitka 编译打包的独立可执行文件。由于内嵌了 Python 运行时和网络通信功能， 部分杀毒软件会误报为病毒或木马（Nuitka 编译的 exe 常见误报，文件本身完全安全）。
如果不提前处理，杀毒软件可能会：

❌ 直接删除 exe 文件，导致无法运行
❌ 运行中途被拦截终止，EA 断连
❌ 静默隔离，表面正常但控制器无法启动

✅ 方案A：添加信任（推荐）

保留杀毒软件，将 3AITradeController.exe 添加到信任白名单中：

💻 Windows Defender（系统自带）

步骤1：打开「设置」→「更新和安全」→「Windows 安全中心」→「病毒和威胁防护」
步骤2：「病毒和威胁防护设置」→「管理设置」
步骤3：滚动到底部「排除项」→「添加或删除排除项」
步骤4：「添加排除项」→「文件」→ 浏览找到 3AITradeController.exe → 确认添加
步骤5：同样添加排除「文件夹」→ 选择 exe 所在的整个目录

💻 360 安全卫士 / 360 杀毒

步骤1：打开 360 安全卫士 → 左下角「设置」
步骤2：进入「安全防护中心」→「信任与阻止」
步骤3：「添加信任文件」→ 浏览找到 3AITradeController.exe → 添加
步骤4：运行后如 360 弹窗，选择「允许此程序运行」并勾选「不再提示」

💻 火绒安全

步骤1：打开火绒安全 → 右上角「设置」（齿轮图标）
步骤2：进入「信任区」→「添加文件」
步骤3：浏览找到 3AITradeController.exe → 添加到信任区
步骤4：「防护中心」→「文件实时监控」→ 确认信任区文件不会被拦截

✅ 如何确认处理成功？

双击运行 start.bat，如果：
✅ 弹出登录窗口 → 处理成功，继续下一步
❌ 文件消失或被删除 → 杀毒软件仍在拦截，重新检查信任设置
❌ 弹出"已保护您的电脑"蓝色窗口 → 点击「更多信息」→「仍要运行」

三、运行本地AI控制器

步骤1：将收到的整个文件夹解压到任意目录（如 D:\3AITrade\ 或任意盘根目录）

步骤2：双击运行 start.bat（推荐方式）

步骤3：首次运行时，start.bat 会自动检测并安装所需的系统运行库（VC++ Redistributable），请点击「是」允许安装

步骤4：如果弹出 Windows SmartScreen 蓝色窗口，点击「更多信息」→「仍要运行」

弹出登录窗口后，继续下一步。

💡 为什么要用 start.bat？
start.bat 会自动检测您的电脑是否缺少 VC++ 运行库（精简版 Windows 系统通常缺少此组件），如果缺少则自动安装，避免直接运行 exe 时报"缺少 dll"等错误。运行库只需安装一次，之后可直接双击 3AITradeController.exe。

⚠ 注意：.mq5 和 .mqh 文件（EA程序）不需要和 .exe 放在一起，它们需要放到 MT5 的 MQL5\Experts\ 目录，具体操作见第七部分。

四、授权码登录

⚠️ 重要：先绑定MT5账号
启动 EA 之前，请先登录 member.kukushuo.com →「我的授权」→ 点击授权码 →「绑定MT5」→ 输入您的 MT5 交易账号。
EA 启动时不会自动绑定，必须先在网站完成绑定才能通过验证。

步骤1：确保 MT5 终端已启动并登录您的交易账号（系统会自动检测 MT5 账号）

步骤2：确认已在 member.kukushuo.com 绑定了该 MT5 账号

步骤3：在登录窗口输入授权码（格式：KUKU-3AI-XXXXXXXX）

步骤4：如需修改服务器端口（默认18888），在「服务器端口」字段输入新端口号

步骤5：点击「联网验证」按钮

验证通过后，自动进入状态控制台，服务器在后台启动。

✅ 自动登录：首次登录成功后，授权码和账号信息会自动保存。下次启动 3AITradeController.exe 时，如检测到已保存的授权码且 MT5 账号未变更，将自动完成登录，无需重复输入。

五、获取AI模型 API Key

3AI Trade EA 使用3个AI模型独立分析、协同决策，但模型池远不止 3 个。系统预置了 8 个主流 AI 模型，您可在控制台自由挑选任意 3 个组成交易决策委员会。默认组合为 Kimi + DeepSeek + 豆包。

所有参与投票的模型地位平等，无固定权重、无一票否决权。决策规则为：任意 AI 成为主导方（置信度≥主导阈值）后，需至少一个同向 AI 跟随（置信度≥跟随阈值）；若第三个 AI 强烈反向（置信度≥分歧保护阈值），则触发分歧保护，最终信号为 HOLD。

您只需为实际启用的模型申请 API Key，未启用的模型无需注册。

💡 默认推荐组合：Kimi + DeepSeek + 豆包。如需使用默认组合，请分别获取这 3 个平台的 API Key。若某个平台无法注册，可在控制台换成 GLM、Qwen、Gemini、ChatGPT 或 Grok 中的任意一个。

🔮 Kimi

平台：kimi.moonshot.cn
模型：moonshot-v1-128k
默认启用：是

🌐 DeepSeek

平台：platform.deepseek.com
模型：deepseek-chat
默认启用：是

🥔 豆包

平台：ark.cn-beijing.volces.com
模型：doubao-seed-2-0-mini
默认启用：是

🌿 Qwen 通义千问

平台：dashscope.aliyun.com
模型：qwen-max
默认启用：否（可手动启用）

🧠 智谱 GLM

平台：open.bigmodel.cn
模型：glm-4-flash
默认启用：否（可手动启用）

♊ Gemini

平台：aistudio.google.com / ai.google.dev
模型：gemini-1.5-flash
默认启用：否（可手动启用）

💬 ChatGPT

平台：platform.openai.com
模型：gpt-4o-mini
默认启用：否（可手动启用）

🚀 Grok

平台：x.ai
模型：grok-2-latest
默认启用：否（可手动启用）

⚠ 重要提醒：API Key 在控制台的「AI模型配置」页填入，由控制器直接调用对应 AI。API 调用费用由各 AI 平台独立收取，与本产品无关。每次分析约消耗 0.001-0.015 元/模型（3 个模型合计约 0.003-0.045 元），建议先充值少量金额测试。

六、MT5 WebRequest 白名单设置

步骤1：打开 MT5 终端 → 菜单栏「工具」→「选项」

步骤2：切换到「EA 交易」标签页

步骤3：勾选「允许 WebRequest」

步骤4：在白名单列表中添加：http://127.0.0.1:18888

步骤5：点击「确定」保存

⚠ 必须设置！如果不添加白名单，EA 无法向本地控制器发送数据，日志中会反复出现 WebRequest failed 错误。如果修改了控制器端口，白名单中的 URL 也要同步更新。端口是 18888，不是 5577。

七、加载 EA 到图表

步骤1：复制 EA 文件到 MT5 目录

在 MT5 中按 Ctrl+Shift+D 打开数据文件夹
导航到 MQL5\Experts\ 目录
将 3AI Trade EA.mq5 和所有 *.mqh 文件复制进去
将 CustomIndicators\ 中的所有 *.mq5 复制到 MQL5\Indicators\ 目录

步骤2：编译 EA（MT5自动完成）

回到 MT5 终端 → 打开「导航器」面板 → 找到「EA 交易」
如果看不到 3AI Trade EA，右键「刷新」
MT5 会自动编译 .mq5 源码文件生成 .ex5 文件（首次编译可能需要几秒）

步骤3：打开图表并拖入 EA

打开 XAUUSD 图表（建议 H1 周期，EA会根据参数自行分析多个周期）
从导航器中拖拽「3AI Trade EA」到图表上，弹出参数设置窗口

步骤4：填写关键参数

参数	填写内容	说明
服务器地址	`http://127.0.0.1:18888`	本地控制器地址，默认已填好
授权码	KUKU-3AI-XXXXXXXX	您的酷酷说授权码
魔术号	2026001	默认即可，如运行多个EA需区别
周期设置	H4 + H1 + M15	建议保持默认（4倍递进关系）
指标1-5	EMA交叉 + ADX + MACD + 布林带 + RSI	默认5个核心趋势指标
固定开仓手数	0.01（新手）/ 0.1（标准）	根据资金和风险承受能力调整
其他参数	保持默认	新手建议先跑默认参数，熟悉后再调整

确认勾选「允许实时自动交易」→ 点击「确定」
图表右上角出现 EA 名称和 🟢 绿色笑脸图标，表示 EA 已启动

八、验证通信是否正常

EA 加载后，请检查以下3个位置确认通信正常：

✅ 检查1：MT5 日志（专家标签）

MT5 终端底部 → 切换到「专家」标签页
正常日志：[AI分析] 开始分析... H4 M15 H1
正常日志：[信号] BUY XAUUSD 信心度=0.82 或 HOLD

✅ 检查2：本地控制器控制台

3AITradeController.exe 窗口的「实时日志」区域
应显示：[服务器] 收到分析请求
应显示当前启用的3个AI模型的独立分析结果和最终投票结果
「分析次数」和「信号次数」应递增

✅ 检查3：图表右上角 EA 图标

🟢 绿色笑脸 = EA 正常运行，自动交易已启用
🔴 红色哭脸 = 自动交易被禁用，点击图表右上角图标切换

🎉 安装完成！

如果以上3项检查全部正常，恭喜您，系统已成功运行！
EA 会按照设定的分析间隔自动触发3AI分析，当前启用的3个AI模型独立分析、协同决策，产生交易信号后自动执行。
您可以在控制器中调整自定义提示词，引导AI的分析风格。如何获取最佳配置？见「借助AI配置EA指南」。

九、常见问题

Q：双击 exe 后文件消失了？

杀毒软件删除了文件。请按本说明第二部分操作，先添加信任白名单，然后重新解压文件运行。

Q：EA 日志显示 "WebRequest failed"？

1. 确认 3AITradeController.exe 已运行且控制台显示「服务器运行中」
2. 确认 MT5 WebRequest 白名单已添加 http://127.0.0.1:18888
3. EA参数中服务器地址与白名单一致（端口18888不是5577）
4. 确认端口 18888 未被其他程序占用

Q：需要几个 AI API Key？

系统需要 3 个 AI 模型才能形成投票决策，但具体是哪 3 个由您在控制台自由选择。因此只需为实际启用的 3 个模型申请 API Key。默认启用 Kimi + DeepSeek + 豆包，如果某个平台无法注册，可在控制台换成其他模型。

Q：AI 分析一直返回 HOLD（不交易）？

3AI 决策体系中，如果未能形成“主导+跟随”双确认，或第三个 AI 触发分歧保护，就会返回 HOLD。如果长时间不交易：
1. 检查指标组合——是否开启了太多相互矛盾的指标（建议5-8个）
2. 看看控制台中当前启用的3个AI模型各自给的分数和理由
3. 参考「借助AI配置EA指南」优化提示词

Q：授权验证失败？

1. 确认已在 member.kukushuo.com 绑定了当前 MT5 账号
2. 检查授权码格式是否正确（KUKU-3AI-XXXXXXXX）
3. 检查网络连接（首次必须联网验证）
4. 确认授权未过期

Q：运行报错"缺少 api-ms-win-core-path-l1-1-0.dll"？

系统缺少 Visual C++ 运行库。使用 start.bat 启动（自动检测并安装），或手动双击 VC_redist.x64.exe 安装。

Q：API 费用大约多少？

每个 AI 模型每次分析约 0.001-0.015 元（取决于行情数据量和提示词长度），3 个模型合计约 0.003-0.045 元。
假设每5分钟分析一次，每天约288次，预估日费用 0.9-13 元。
各 AI 平台新用户通常都有免费额度，可先用免费额度体验。

Q：运行一段时间后 EA 突然不分析了？

1. 检查 3AITradeController.exe 是否还在运行
2. 检查控制台是否显示「授权失效」或「离线宽限到期」
3. 检查当前启用的 AI 平台 API 余额是否用完
4. 检查网络是否断开（超过24小时断网会停止服务）

Q：系统时间不准确会导致问题吗？

会。控制器需要通过 HTTPS 连接授权服务器和所启用的 AI 平台，如果系统时间偏差超过几分钟，SSL 证书验证会失败。
请确保系统时间与网络时间同步：右键任务栏时钟 - 调整日期/时间 - 打开「自动设置时间」。

Q：Windows 7 / 8 能用吗？

不支持。基于 Python 3.13 编译，仅支持 Windows 10 及以上系统。请升级到 Windows 10/11，或使用 Windows Server 2016/2019/2022 的 VPS。

Q：AI 有权重或一票否决权吗？

没有。所有参与投票的 AI 模型地位完全平等，无固定权重、无一票否决权。最终信号由“主导+跟随双确认 + 分歧保护”机制决定：任意 AI 成为主导方（置信度≥主导阈值）后，需至少一个同向 AI 跟随（置信度≥跟随阈值）才能开仓；若第三个 AI 强烈反向（置信度≥分歧保护阈值），则触发分歧保护，最终信号为 HOLD。三个阈值可在控制台“投票阈值”设置中调整。
这是风控机制——宁可错过，不可做错。