1. 这是什么
VolPulse 是 MetaTrader 5 上的分时段成交量分布（Volume Profile）指标。它画出每个时段的成交量分布，标出关键价位（POC、价值区、VWAP、未回踩的 POC），并用一行字概括当前市场状态，同时把判断理由列出来。
它由两部分组成：
| 部分 | 类型 | 作用 | 必须装吗 |
|---|---|---|---|
| VolPulse Volume Profile | 指标 | 分布图、关键价位、状态面板、提醒（弹窗 / 声音 / MT5 手机推送） | 是 |
| VolPulse Telegram Bridge | EA（工具） | 把指标的提醒转发到你的 Telegram | 可选 |
两者都免费，都不会下单、改单或平仓。
2. 功能
时段分布图
- 每个时段一张成交量分布图（可显示 1–10 个时段，默认 3 个），始终画在图表可见范围内。
- POC（成交量最大的价位）、VAH / VAL（价值区上下沿，默认覆盖 70% 成交量）、时段 VWAP。
- 高 / 低成交量节点（HVN / LVN）的行会单独着色。
- 当前时段的 POC / VAH / VAL / VWAP 以发展中曲线显示，随 K 线逐根延伸。
未回踩 POC（Naked POC）
- 之前时段的 POC，价格还没回去碰过，就带着价格和日期标签一直显示（默认最多 20 个、回看 20 天）。价格一碰到就移除。
市场状态面板
- 一行结论：偏多 / 偏空 / 中性，附带强度（弱 / 中等 / 强）和得出结论的三条理由（见第 4 节）。
- 同时显示当前时段、价值区、POC、VWAP，以及最近的未回踩 POC 和它与现价的距离。
- 可折叠、可拖动（会记住位置），自动适配浅色 / 深色图表，高分屏下文字清晰。
提醒
- 市场状态变化；价格触及前一时段的 POC / VAH / VAL；价格触及未回踩 POC。
- 弹窗、声音、推送到 MT5 手机 App；装了 Bridge 还会推送到 Telegram。
- 刻意做得克制：同一价位要等价格离开 2 倍 ATR(M15) 后才会再次提醒，另有每个价位 5 分钟的冷却。用 22 天 XAUUSD 和 EURUSD 的 M1 数据回放测试，每张图每天大约 6 条提醒。
带止损和目标的入场箭头
- ▲ / ▼ 箭头标出前一日价值区边缘和 POC 附近可能的入场时机（见第 5 节）。
- 最新一个箭头画出止损（红虚线）和目标（绿虚线），并标出风险回报比。
- 三档过滤：全部 / 平衡 / 精选，图上一键切换。
黄金预设
- 在 XAUUSD / GOLD（包括带后缀的品种名）上自动使用更细的设置（120 行、更细的价格网格）。可以关闭，不会套用到白银或外汇上。
中英双语
- 面板和提醒文字支持中文和英文，默认跟随终端语言。
3. 分布图怎么算
- 数据：始终使用当前品种的 M1 K 线，与图表周期无关。图表周期请用 M1–H4；D1 及以上时，指标会提示你换成更小的周期。
- 成交量：默认用 tick 成交量（如果券商提供真实成交量，可以在参数里切换）。
- 每根 M1 K 线的成交量按它的最高到最低价，分摊到一个细价格网格上（默认步长 = ATR(D1) / 600，黄金预设为 / 800），再合并成显示的行。所以改行数不会影响 POC 和价值区的精度。
- 价值区：从 POC 开始向两侧扩展，直到覆盖设定比例的成交量（标准算法）。
- 时段：每个交易日一个，默认从服务器时间 00:00 开始（也可以按 UTC 或自定义起始小时）。周末数据会合并：周日的 K 线并入周一，周六的并入周五，不会出现很小的周末分布图。
- 已收盘的数据不重绘：已结束时段的分布会冻结；VWAP 和发展中曲线只用已收盘的 M1 K 线。已收盘 K 线上的数值以后不会再变。（某个时段移出显示范围后，它的线只是不再画出来。）
4. 市场状态怎么判断
VolPulse 不把规则藏起来。它在图表周期的已收盘 K 线上做三项检查：
| 检查 | 偏多 | 偏空 |
|---|---|---|
| 趋势 | EMA20 在 EMA50 上方 | EMA20 在 EMA50 下方 |
| VWAP | 收盘价在时段 VWAP 上方 | 收盘价在时段 VWAP 下方 |
| 价值区 | 收盘价在价值区中线上方 | 收盘价在价值区中线下方 |
- 三项都偏多 → 偏多；三项都偏空 → 偏空；其余情况 → 中性。
- VWAP 和价值区中线附近有一个小容差（ATR × 0.10），防止价格贴着价位时来回翻转。
- 强度看 ADX(14)：低于 18 = 弱，18–25 = 中等，25 及以上 = 强。
- 面板的理由一行用 ✓ / ✗ 列出每一项检查，你能看到状态为什么是现在这样。
它是用来看行情背景的过滤条件，不是买卖信号。它描述价格相对趋势、VWAP 和价值区的位置，不预测下一步走向。
5. 入场箭头：可能的入场时机
箭头标出的是可能值得考虑入场的时刻，不是建议，也不是预测。VolPulse 不给箭头标输赢，也不公布胜率：没有任何箭头规则每次都对，最终决定在你。
什么时候出箭头（只看已收盘 K 线，M15 及以上周期）：
| 形态 | 买入（卖出对称） |
|---|---|
| 价值区边缘拒绝 | 价格回落碰到前一日 VAL，收盘回到它上方 |
| 突破回踩 | 价格已经至少 2 次收在前一日 VAH 上方，回踩 VAH 后又收在上方 |
| POC 守住 | 价格回落碰到前一日 POC，收盘回到它上方（状态为偏空时不出） |
这根 K 线本身也要确认：收盘在 K 线区间的上部 55% 以内，实体至少 0.1 × ATR。
止损和目标（箭头出现时就定死）：
- 止损：放在价位外侧一点，即判断失效的位置（价位或 K 线极值再外 0.25 × ATR，离入场至少 0.5 × ATR）。
- 目标：交易方向上的下一个真实价位（前一日 POC / VAH / VAL、当天 VWAP），且距离至少等于止损距离；找不到时取 2 倍止损距离。
- 只有最新一个箭头画线；价格碰到止损或目标后线自动消失。鼠标停在任何箭头上可以看到它的入场、止损和目标。
全部 / 平衡 / 精选（面板下方按钮，每张图记住自己的档位）：
| 档位 | 显示 | 大约（黄金 M15） |
|---|---|---|
| 全部 | 每个形态 | 每天 3~4 个 |
| 平衡（默认） | 形态 + 下面 4 项至少满足 2 项 + 不在强趋势里逆势 + 目标是真实价位且风险回报比 ≥ 1.5 | 每天约 2 个 |
| 精选 | 4 项至少满足 3 项 + 风险回报比 ≥ 2 + 市场状态不与箭头相反 | 每天约 1 个 |
| 关闭 | 不显示 | — |
4 项：① EMA20/EMA50 趋势与箭头同向 ② 价格在 VWAP 的同侧（边缘拒绝看 VWAP 在前方 = 有空间）③ 入场价位附近还有别的关键价位 ④ 目标是真实价位且至少 2 倍止损距离。
档位越严图表越干净，但箭头不会因此更准。推荐周期：M15 和 H1。M15 以下不显示箭头：M1 / M5 上止损太小，计划没有意义。
箭头只在已收盘 K 线上计算，出现后不会移动或消失。新箭头会发提醒（弹窗 / 声音 / 推送 / Telegram），带入场、止损和目标。
6. 安装和第一次使用
- 从 Market 下载 VolPulse Volume Profile：https://www.mql5.com/zh/market/product/200141。
- 打开一张图（例如 XAUUSD M15），从「导航器 → Market」把指标拖到图上。
- 第一次加载要等几秒，MT5 可能需要下载 M1 历史数据。准备好之前，面板显示「加载历史中...」。
- 完成。默认参数不改就能用。
常用参数（其余保持默认即可）：
| 参数 | 默认 | 说明 |
|---|---|---|
| 显示的时段数 | 3 | 1–10 |
| 时段分界 / 起始小时 | 服务器时间 00:00 | 如果你的券商一天的开始时间很奇怪，可以改成 UTC |
| 每张分布图的行数 | 100 | 黄金预设用 120 |
| 价值区 % | 70 | |
| 状态变化 / POC / 价值区 / 未回踩 POC 提醒 | 开 | |
| 当天发展中价位也提醒 | 关 | 发展中价位整天都在变，开了会很吵 |
| MetaQuotes 推送 | 开 | 需要在「工具 → 选项 → 通知」里填 MetaQuotes ID |
| 颜色 | None（= 自动） | 自动选适合当前图表背景的颜色 |
| 在图上绘制 | 开 | 关掉则只计算（给读取 buffer 的 EA 用） |
| 显示入场信号 | 开 | 箭头 + 止损 / 目标 |
| 信号档位 | 平衡 | 也可以用图上按钮切换 |
| 画止损 / 目标线 | 开 | 只画最新一个还没碰到止损或目标的箭头 |
| 新信号提醒 | 开 |
7. Telegram 提醒（可选，免费）
VolPulse Telegram Bridge 把指标的提醒发到 Telegram。不需要账户信息、不需要登录、不需要 API 密钥。
设置（大约 2 分钟）：
- 从 Market 下载 VolPulse Telegram Bridge：https://www.mql5.com/zh/market/product/200146。
- 在 MT5 里打开「工具 → 选项 → EA 交易」，勾选「允许 WebRequest 访问下列 URL」，添加
https://volpulse.edgehone.com - 把 Bridge 挂到任意一张图上（品种不限）。
- Bridge 面板会显示 8 位配对码，例如 2480 2217 。
- 在 Telegram 打开 @VolPulseBot，发送 /start 2480 2217 （中间的空格加不加都行）。
- 机器人回复 绑定完成：MT5 ···1234，Bridge 面板显示已连接，指标面板的 Telegram 一行变绿。
需要知道的：
- 一个终端只需要一个 Bridge，它会负责这个终端里所有挂了 VolPulse 的图。如果你又挂了第二个，它会显示「待命」，第一个被移除后自动接手。
- 配对码 1 小时内有效，过期后会自动换新。
- 只有 MT5 在运行时才会发送提醒。断网时提醒先存在本地队列里，恢复后补发，不会丢、也不会重复。
- 为了防止刷屏，服务器对每个聊天最多每分钟发 5 条、每小时 30 条。超出的会合并，并在下一条消息里告诉你合并了几条。
机器人命令：
| 命令 | 作用 |
|---|---|
| /status | 已绑定的终端和最近的提醒 |
| /mute / /unmute | 暂停 / 恢复推送（静音期间提醒照常记录，只是不发） |
| /lang | 切换消息语言（中文 / English） |
| /unbind | 解绑终端（ /unbind 序号 或 /unbind all ；之后 Bridge 面板显示「已解绑」，并有按钮可以重新配对） |
| /help | 命令列表 |
服务器保存什么： 你的 Telegram 聊天 ID、消息里显示的终端名（默认是 MT5 ··· 加账号后 4 位，可以自己改）、以及 30 天内的提醒文字。服务器收不到你的账号、密码、余额、持仓或订单。
8. 给自己的 EA 用（buffer）
可以用 iCustom 读取指标数值（只要数值的话，把「在图上绘制」关掉）：
| Buffer | 数值 |
|---|---|
| 0 | 时段 VWAP |
| 1 | 发展中 POC |
| 2 | 发展中 VAH |
| 3 | 发展中 VAL |
数值写在已收盘的 K 线上，之后不会再变。空值表示这根 K 线没有数据。
9. 常见问题
| 现象 | 原因 / 解决 |
|---|---|
| 面板一直显示「加载历史中...」 | MT5 还在下载 M1 数据。把该品种的 M1 图打开一次，或者稍等。 |
| 提示「请用 H4 及以下周期」 | 图表在 D1 或更大周期上，换成 H4 或更小的周期。 |
| 周末「当天」没有东西 | 正常，新时段还没有 K 线。之前的时段和未回踩 POC 照常显示。 |
| 手机收不到推送 | 在「工具 → 选项 → 通知」里填 MetaQuotes ID 并启用通知。 |
| Bridge 提示把地址加入 WebRequest | 原样添加 https://volpulse.edgehone.com （结尾不要带 / ）。 |
| Bridge 提示「连不上服务器」 | 检查网络；Bridge 会自动重试。 |
| M1 / M5 上没有箭头 | 正常，请用 M15 及以上（推荐 M15 / H1）。 |
| 切换档位后箭头变了 | 按钮只改变显示哪些箭头，箭头本身不会变。 |
| Bridge 显示「待命」 | 这个终端的另一张图上已经有 Bridge 在运行，移除其中一个即可。 |
| Bridge 显示「已在 Telegram 解绑」 | 你发过 /unbind 。点面板上的「重新配对」按钮。 |
| 策略测试器 | 指标可以在测试器里运行（测试器里不弹提醒）。Bridge 在测试器里不做任何事，测试器里没有网络。 |
