下面是针对你当前这份 《棒棒金_TV技术分析面板_AI智能版 V3.9.6》 的完整介绍与详细使用说明。以下内容以你提供的 V3.9.6 源码实际功能、参数和当前实现为基础整理，不另外虚构尚未实现的功能。

一、EA简介

棒棒金_TV技术分析面板_AI智能版 V3.9.6 是一个以 TradingView 风格为设计思路的 MT5 综合行情分析 EA。

当前版本主要由以下几个部分组成：


MT5实时行情
     │
     ├── 技术指标分析
     │     ├── EMA
     │     ├── RSI
     │     ├── MACD
     │     └── ADX
     │
     ├── 综合评分
     │
     ├── 多周期分析
     │
     ├── SMC结构
     │     ├── Swing
     │     ├── HH / HL / LH / LL
     │     ├── BOS
     │     ├── CHoCH
     │     └── Order Block
     │
     ├── Fibonacci黄金分割
     │
     ├── 支撑阻力
     │
     ├── 普通AI分析
     │
     └── AI视觉分析
           ├── 多周期纯K线截图
           ├── 隐藏订单
           ├── 隐藏历史成交
           ├── 多图一次发送
           └── 自动重试


EA启动后由定时器按照 `刷新秒数` 更新技术数据、结构数据、AI数据和面板，而不是依靠 `OnTick()` 中直接执行全部计算。当前默认刷新周期为 3 秒。

---

二、安装方法

将：

《棒棒金_TV技术分析面板_AI智能版V3.9.6_默认配置按指定参数版.mq5》

放入：


MT5
└─ MQL5
   └─ Experts
      └─ 棒棒金_TV技术分析面板_AI智能版V3.9.6_默认配置按指定参数版.mq5


然后打开 MetaEditor。

找到 EA 后点击：

编译

编译成功以后，在 MT5：


导航器
→ EA交易
→ 棒棒金
→ 棒棒金_TV技术分析面板_AI智能版V3.9.6...


拖到需要分析的品种图表。

---

三、首次加载必须做的设置

1. 允许 WebRequest

由于普通AI和AI视觉都需要通过 `WebRequest()` 调用接口，所以必须允许：
https://dgcai.vip


操作：


MT5
→ 工具
→ 选项
→ 专家顾问
→ 勾选“允许WebRequest”
→ 添加https://dgcai.vip


源码在发生 `4014` 时也会明确提示 MT5 的 WebRequest 权限问题。

2. 填写 API_Key

参数：


API_Key=


这里填写你的 API 密钥。

当前代码不会把完整接口地址作为普通参数直接用于请求，而是在运行时恢复接口地址；参数界面显示的是：


API密钥注册充值地址https://dgcai.vip


---

四、基础设置

当前默认：

| 参数   |  默认值 | 作用         |
| ---- | ---: | ---------- |
| 开启指标 | true | 启用整个技术分析系统 |
| 分析周期 |   M5 | 主技术分析周期    |
| 自动刷新 | true | 定时刷新       |
| 刷新秒数 |    3 | 每3秒更新一次    |

这些设置是整个系统的基础。

分析周期的重要性

目前：


分析周期 = M5


意味着主技术指标以及很多结构分析都以 M5 为主要计算周期。

也就是说：


EMA
RSI
MACD
ADX
SMC
Swing
Fibonacci
部分价格结构


主要围绕 `分析周期` 进行计算。

因此：

你现在使用M5作为主周期，适合观察比较细的短中线结构。

---

五、技术指标设置

当前默认：


EMA快速周期 = 20
EMA慢速周期 = 50
EMA趋势周期 = 200

RSI周期 = 14

MACD快线 = 12
MACD慢线 = 26
MACD信号 = 9

ADX周期 = 14


这些参数直接用于创建 MT5 指标句柄。

EMA

系统使用：


EMA20
EMA50
EMA200


通常面板可以据此判断：


EMA20 > EMA50


短周期趋势偏强。

而：


EMA50 > EMA200


则更多体现中长期趋势背景。

RSI

默认：


RSI14


用于动量/强弱判断。

MACD

默认：


12 / 26 / 9


用于动量方向及交叉情况。

ADX

默认：


ADX14


代码当前的ADX评分逻辑中：


ADX >= 25


对应较高的趋势强度评分，否则给较低的趋势强度评分。

---

六、综合评分系统

默认设置：


开启综合评分 = true

趋势权重 = 35
动量权重 = 25
结构权重 = 20
位置权重 = 20


源码中实际综合评分会形成一个总分，然后按照：


≥ 60       强烈买入
20～59.9   买入
-19.9～19.9 震荡
-20～-59.9  卖出
≤ -60      强烈卖出


的方式输出方向文字。

一个重要的源码现状

需要特别说明：V3.9.6当前的 `BBJ_TotalScore()` 实际计算公式主要使用了 EMA、MACD、RSI、ADX 的评分与“趋势权重/动量权重”。

当前这个函数里并没有把：


结构权重 = 20
位置权重 = 20


直接作为独立数学项加入公式。

所以参数界面虽然已经保留了：


结构权重
位置权重


但按照目前源码，它们并不是四个完全独立的加权评分项。

这属于当前版本的实现现状，使用时不要把这四个参数理解成已经完全独立生效的四因子评分模型。

---

七、多周期分析

当前默认配置：


周期1 = M1
周期2 = M5
周期3 = M15
周期4 = H1
周期5 = H4


这对应你刚刚指定的：


1
5
15
16385
16388


其中：


16385 = H1
16388 = H4


当前源码把这些周期分别进行EMA20与EMA50比较，并产生每个周期的方向状态。

核心逻辑是：


EMA20 > EMA50
      ↓
该周期偏强

EMA20 < EMA50
      ↓
该周期偏弱


所以它更适合作为：

多周期方向一致性过滤器。

---

八、SMC智能结构

当前默认：


开启SMC = true
Swing检测长度 = 3
Swing历史范围 = 300

显示BOS = true
显示CHoCH = true
显示订单块 = true




1. Swing结构

系统会在主分析周期中寻找：


Swing High
Swing Low


并按照时间顺序保存。

默认：


Swing检测长度 = 3


表示左右各比较3根K线。

---

2. HH / HL / LH / LL

系统会取最近两个：


Swing High
Swing Low


然后判断：


最新高点 > 前高
→ HH

最新高点 < 前高
→ LH

最新低点 > 前低
→ HL

最新低点 < 前低
→ LL


例如：


HH + HL


意味着当前结构更倾向于多头结构。

而：


LH + LL


更倾向于空头结构。

源码当前就是按照最近两个高点和最近两个低点比较来生成结构。

---

3. BOS

BOS 使用：

最近确认的结构高点/低点

而不是简单寻找整个历史最高点。

并且使用：


已经收盘的K线


进行突破判断。

例如：


收盘价 > 最近Swing High


得到：


↑ 多头BOS突破


反之：


收盘价 < 最近Swing Low


得到：


↓ 空头BOS突破




---

4. CHoCH

CHoCH是在结构方向基础上进一步判断反向突破。

例如原来：


HH + HL


属于偏多结构。

后来出现：


↓ 空头BOS突破


则可能形成：


多转空 CHoCH


反过来：


LH + LL


之后发生：


↑ 多头BOS突破


则可能形成：


空转多 CHoCH




---

5. Order Block

当前代码的订单块识别逻辑主要寻找：


前一根较小实体K线
+
下一根实体明显放大


然后根据后续K线方向识别：


多头订单块


或：


空头订单块




它属于当前版本的结构化辅助判断，不应当理解成完整的机构订单流模型。

---

九、Fibonacci黄金分割

默认：


开启黄金分割 = true
自动寻找高低点 = true
Fibonacci计算K线 = 300
显示黄金区域 = true


系统自动在指定数量K线内寻找：


最高点
最低点


然后计算：


23.6%
38.2%
50%
61.8%
78.6%




---

黄金区域

当前重点使用：


50%
61.8%


形成：


黄金回调区域 50%-61.8%


当当前价格进入该区域时，面板会给出相应价格区域判断。

这部分对于你现在的：


M5主周期
M1/M5/M15/H1/H4多周期


可以用来判断回调位置。

---

十、支撑阻力

默认：


开启支撑阻力 = true
检测K线 = 300
最大显示数量 = 5
价格合并范围 = 50


系统主要结合：


Swing High
Swing Low
Daily Pivot


生成支撑/压力等级。

代码还会计算：


Pivot
R1
R2
S1
S2


并把它们加入价格等级体系。

因此面板中看到的支撑压力，并不只来自一种算法。

---

十一、普通AI分析

这是与 AI视觉完全不同的一套功能。

当前默认：


开启AI分析 = true
自动分析默认开启 = false
AI分析K线周期 = M5
AI多周期联合分析 = true
启动后立即分析 = false




也就是说：

EA启动之后

普通AI：


允许使用


但是：


自动分析


默认关闭。

所以不会因为加载EA就不断自动调用普通AI。

---

手工分析

点击AI面板上的：


手工分析


之后会重新计算：


技术指标
SMC
价格区域
JSON数据


然后针对最近一根已经收盘的 AI分析周期K线发起AI请求。

---

十二、多周期AI联合分析

当前：


AI多周期联合分析 = true


AI并不是只看M5。

它会同时读取：


M1
M5
M15
H1
H4


然后让AI分析：


低周期方向
高周期方向
周期一致性
周期冲突
趋势延续
回调
震荡
潜在反转


最终形成统一总结。

源码提示词明确要求AI不要把五个周期分成五个互不相关的答案，而是做统一多周期判断。

---

十三、AI分析自动触发机制

普通AI的自动触发不是简单：


每3秒调用一次


而是：


刷新定时器
      ↓
检测 AI分析K线周期
      ↓
发现新的已收盘K线
      ↓
才调用一次AI


你的当前设置：


AI分析K线周期 = M5


因此理论运行逻辑是：


M5 K线收盘
     ↓
检测到新的已收盘K线
     ↓
普通AI自动分析


但是因为：


自动分析默认开启=false


启动后默认不会自动执行。

---

十四、AI请求自动重试

当前默认：


AI请求失败重试次数 = 3
AI请求重试间隔秒 = 2


因此如果遇到类似：


AI HTTP错误=1003


程序会自动尝试：


第一次
↓
失败
↓ 2秒
第二次
↓
失败
↓ 2秒
第三次
↓
失败
↓ 2秒
第四次最终尝试


代码当前是“首次请求 + 最多3次重试”。

它重点针对：


1003
408
429
500～599
部分WebRequest临时错误
200/204但返回空内容


进行重试。

---

十五、AI视觉分析

这是 V3.9.6 的一个重点功能。

当前默认：


开启AI视觉 = true
截图宽度 = 1200
截图高度 = 800
AI视觉间隔分钟 = 5
AI视觉自动分析默认开启 = false
AI视觉使用多周期截图 = true
AI视觉失败重试冷却秒 = 60




注意这里有两个完全不同的开关：


开启AI视觉


和：


AI视觉自动分析默认开启


现在的默认状态是：


AI视觉功能：开
AI视觉自动运行：关


因此：

手工点击可以使用视觉AI，但不会自动定时截图。

---

十六、AI视觉按钮

AI面板顶部目前有四个按钮：


┌──────────┬────────────┬────────────┬────────────┐
│ 手工分析 │ AI视觉分析 │ 视觉自动：关│ AI自动：关  │
└──────────┴────────────┴────────────┴────────────┘


源码明确创建了这四个按钮。

---

十七、手工AI视觉分析怎么用

直接点击：

AI视觉分析

程序会：


① 更新技术指标
② 更新SMC
③ 更新价格区域
④ 获取需要截图的周期
⑤ 创建临时纯K线图
⑥ 截取各周期
⑦ 隐藏交易相关内容
⑧ 读取PNG
⑨ 转Base64
⑩ 一次提交多张图片
⑪ AI进行视觉分析
⑫ 删除临时截图
⑬ 关闭临时图表
⑭ 将结果放进AI报告


手工视觉按钮调用时，会使用：

mql5
BBJ_SendVisionAI(true)


也就是说手工执行不受视觉自动开关限制。

---

十八、AI视觉截图到底截什么

当前不是直接截主图。

这是非常重要的一点。

程序会建立专门用于视觉分析的临时K线图，并通过不同周期切换来生成图片。

因此：


主图上的AI面板
技术分析面板
按钮
SMC文字
其他UI


不会进入视觉图片。

同时已经专门隐藏：


历史交易
当前持仓
止损止盈
挂单
交易价位


截图完成后临时图表直接关闭。

所以视觉AI看到的是：

干净的行情K线。

---

十九、多周期视觉分析

当前：


AI视觉使用多周期截图=true


会根据：


周期1
周期2
周期3
周期4
周期5


生成图片。

你现在的默认周期：


M1
M5
M15
H1
H4


程序会自动去重。

例如你设置：


M1
M5
M5
H1
H4


实际上只会发送：


M1
M5
H1
H4


不会重复截图。

---

二十、视觉AI的分析方式

视觉提示词要求模型：


优先阅读纯K线图片
        ↓
逐个识别不同周期
        ↓
比较周期之间的关系
        ↓
分析趋势
        ↓
分析突破
        ↓
分析回调
        ↓
分析结构
        ↓
寻找关键价格
        ↓
分析风险
        ↓
结合MT5结构化数据
        ↓
形成统一结论


输出包括：


[视觉行情结论]

[各周期视觉对比]

[图表结构]

[关键价位]

[风险提示]

[视觉与数据综合判断]




---

二十一、视觉AI失败时怎么处理

目前已经有两层保护。

第一层：请求重试

例如：


1003


会按照：


AI请求失败重试次数=3
AI请求重试间隔秒=2


进行重试。

而且：

重试不会重新截图。

程序会直接重复发送已经准备好的同一批多周期图片。

这样可以避免你之前遇到：


不断截图
不断创建临时图表
日志刷屏


的问题。

第二层：失败冷却

默认：


AI视觉失败重试冷却秒=60


如果最终仍然失败：


至少60秒


自动模式不会再次启动新的截图任务。

---

二十二、视觉自动分析

如果以后需要打开：

点击：


视觉自动：关


变成：


视觉自动：开


程序才开始自动运行。

当前默认间隔：


5分钟


并且开启时会重新计时，不会因为刚刚点开按钮就立刻连续截图。

---

二十三、普通AI自动分析与视觉AI自动分析是分开的

这是 V3.9.6 很重要的设计。

普通AI


AI自动：开/关


控制普通文本AI。

AI视觉


视觉自动：开/关


控制视觉AI。

所以可以组合成：

| 普通AI | 视觉AI | 结果      |
| ---- | ---- | ------- |
| 关    | 关    | 两种都不自动  |
| 开    | 关    | 只自动文本AI |
| 关    | 开    | 只自动视觉AI |
| 开    | 开    | 两种都自动   |

而手工：


手工分析
AI视觉分析


仍然可以单独执行。

---

二十四、AI模型设置

当前默认：


AI模型 = gemini-3.8-flash
AI视觉模型 = gemini-3.8-flash


源码允许视觉模型独立指定，如果：


AI视觉模型


留空，则视觉分析会使用：


AI模型


当前你已经把两个模型都指定为：


gemini-3.8-flash


但实际能否通过你的 `dgcai.vip` 接口使用图片输入，取决于该接口后台实际提供的模型能力。

所以出现：


AI视觉HTTP错误
模型不支持图片
多模态格式不支持


时，应优先检查 API 服务端的实际模型支持情况。

---

二十五、AI报告显示

AI结果不会简单塞在一小块文本里。

当前采用：


完整AI报告
↓
自动拆行
↓
分页显示
↓
上一页 / 下一页


并且正文区域和底部分页按钮是独立区域。

因此长AI报告不会再覆盖：


上一页
下一页


面板顶部同时显示：


完整AI报告 第X/Y页




---

二十六、面板控制

当前支持：


隐藏面板
显示面板


隐藏后：


技术分析面板
+
AI独立面板


一起隐藏。

然后会留下一个：


显示面板


按钮。

再次点击即可恢复。

---

二十七、AI面板布局

你当前配置：


AI面板右边距 = 20
AI面板上边距 = 30
AI面板宽度 = 440
AI面板高度 = 520
AI面板自动高度 = true
AI面板最小高度 = 420
AI面板最大高度 = 760
AI报告每页行数 = 24
面板贴合间距 = 0


实际运行中：


主技术面板
      │
      └── AI智能多周期分析中心


AI面板会根据窗口实际宽度自动调整。

同时：


正文区域


不会侵入：


底部翻页区域


这是当前版本专门处理过的显示逻辑。

---

二十八、智能提醒

默认：


开启弹窗提醒 = true
开启声音提醒 = true
提醒声音 = alert.wav

开启评分变化提醒 = true
评分变化阈值 = 25


当综合评分与上一次记录相比变化达到设定阈值时，可以：


弹窗
+
声音


提醒。

---

二十九、推荐的一次完整使用流程

第一次使用建议按下面顺序：


① 加载EA
        ↓
② 检查分析周期=M5
        ↓
③ 检查M1/M5/M15/H1/H4多周期
        ↓
④ 设置API_Key
        ↓
⑤ MT5允许WebRequest
        ↓
⑥ 等待历史K线加载
        ↓
⑦ 查看技术分析面板
        ↓
⑧ 查看SMC
        ↓
⑨ 查看Fibonacci
        ↓
⑩ 查看支撑阻力
        ↓
⑪ 点击“手工分析”
        ↓
⑫ 查看文本AI
        ↓
⑬ 点击“AI视觉分析”
        ↓
⑭ 查看多周期纯K线视觉分析


日常运行时，可以只手工点击两个AI按钮，不开启自动分析。

---

三十、你当前这套默认配置最适合的使用方式

按照你现在设置：


主分析周期：M5

多周期：
M1
M5
M15
H1
H4

SMC：开启
Fibonacci：开启
支撑阻力：开启

普通AI：开启，但自动分析关闭

视觉AI：开启，但自动视觉关闭


比较清晰的工作模式是：


M1
↓
观察短线价格行为

M5
↓
主要执行分析周期

M15
↓
短中线方向确认

H1
↓
主要趋势背景

H4
↓
更高一级趋势环境


然后：


技术指标
+
SMC
+
Fibonacci
+
支撑阻力
+
多周期数据
+
AI文字分析
+
多周期纯K线视觉分析


组合成一个完整分析框架。

---

三十一、一个很重要的使用注意事项

当前 V3.9.6 的实际多周期计算周期已经是你设置的：


M1 / M5 / M15 / H1 / H4


但是源码中 `BBJ_UpdateMultiTimeframe()` 的周期名称显示数组仍存在旧版本的固定文字标签：


M5 / M15 / H1 / H4 / D1


也就是说：

实际参与计算的周期和部分旧版显示名称目前存在不一致。

因此你当前使用时：

> 以参数中的“周期1～周期5”以及AI视觉实际截图周期为准，不要仅依据某处旧版周期文字标签判断。

这是我从当前 V3.9.6 源码检查出来的一个显示层问题，不影响你当前指定的周期参数本身，但后续版本建议把这个标签系统也一起修正。

---

三十二、当前版本默认参数总表

| 分类          | 当前默认                    |
| ----------- | ----------------------- |
| 主分析周期       | M5                      |
| 自动刷新        | 开                       |
| 刷新          | 3秒                      |
| EMA         | 20 / 50 / 200           |
| RSI         | 14                      |
| MACD        | 12 / 26 / 9             |
| ADX         | 14                      |
| 综合评分        | 开                       |
| 权重          | 35 / 25 / 20 / 20       |
| 多周期         | M1 / M5 / M15 / H1 / H4 |
| SMC         | 开                       |
| Swing       | 3                       |
| Swing历史     | 300                     |
| BOS         | 开                       |
| CHoCH       | 开                       |
| Order Block | 开                       |
| Fibonacci   | 开                       |
| 自动找高低点      | 开                       |
| Fibonacci范围 | 300                     |
| 支撑阻力        | 开                       |
| 检测范围        | 300                     |
| 最大数量        | 5                       |
| AI文本        | 开                       |
| 文本AI自动      | 关                   |
| AI触发周期      | M5                      |
| AI多周期       | 开                       |
| AI视觉        | 开                       |
| 视觉自动        | 关                   |
| 视觉间隔        | 5分钟                     |
| 视觉多周期截图     | 开                       |
| 截图          | 1200×800                |
| 普通/视觉重试     | 3次                      |
| 重试间隔        | 2秒                      |
| 视觉失败冷却      | 60秒                     |
| AI面板        | 开                       |
| 深色主题        | 开                       |

这些默认值均来自当前 V3.9.6 输入参数。

---

三十三、最常用的三个按钮

以后你实际操作的时候，可以把它简单理解成：

手工分析

→ 读取结构化行情数据
→ 调用文本AI
→ 输出文字分析报告。

AI视觉分析

→ 创建干净K线图
→ M1/M5/M15/H1/H4截图
→ 隐藏交易内容
→ 图片送给视觉AI
→ 输出视觉分析。

视觉自动 / AI自动

→ 分别控制两个自动分析系统，互不干扰。


如果作为正式使用版本，建议下一步优先把我上面指出的“多周期实际计算周期与旧版显示名称不一致”以及“综合评分中的结构权重/位置权重尚未直接进入现有评分公式”两个问题修正，这样参数界面和实际计算逻辑会完全一致。

V4.3 全面审核修订说明

已修复及完善

1. 基础评分以一次CopyRates读取同根K线的时间和close；技术计算完成后及总评分前检查bar一致，跨bar时拒绝本轮评分。实时行情报价仍为BID显示，评分采用K线close口径，适配Last驱动品种。实时模式不承诺所有指标在同一tick完成读取。
2. 共振每项检查rates[0].time与本轮目标bar；ROC/Donchian历史需求按p+1、CMF/VWAP按p设置，避免不必要的4p+10等待；非法period先校验再计算历史需求，避免整数溢出。
3. 融合百分比必须有限且在0到100之间；没有可用基础评分权重时显示无有效评分权重，不能把缺失评分误报有效中性。
4. 增加基础分就绪及实际融合状态。综合评分关闭、基础分无效、共振未就绪或融合比例0时，CSV/提示词不会错误标成已融合。
5. 同周期Momentum/ROC有效项和配置项同步去重，避免两项全有效却显示1/2。仍共享分值预算；其他指标仍可能相关。
6. 全部AI功能关闭时，不因AI端点验证失败阻止纯技术面板启动；无队列时不反复校验。开启AI时的启动、入队地址解析和发送前端点保护保留。
7. 最终失败或取消后，允许同bar手工重新排队；成功结果继续复用，自动失败任务继续去重。
8. 自动/手工AI首次发送前统一刷新技术、SMC、位置、综合评分和诊断，数据未就绪或准备payload期间跨bar则拒绝，避免发送过期快照。已准备payload的网络重试仍复用原请求内容。
9. 技术数据未就绪时仍更新JSON状态，自动AI受数据就绪门控保护。JSON新增analysis对象，包含valid、base_ready、bar、price、base_score、blended与status；原有字段保留。
10. 正常分析更新后显式ChartRedraw；版本和启动日志统一为V4.3。

棒棒金_TV技术分析面板_AI智能版V4.2_指标共振版.ex5截图

TV技术分析面板真牛。。。。。。。