# Price Structure Suite 指标开发说明_1
Price Structure Suite 指标开发说明
1. 项目背景
Price Structure Suite 旨在把主观交易中常见的“结构—形态—量能—多周期—风险”分析流程，收敛到一份 MT4 指标中。指标只依赖行情价格与 Tick 量，不引入外部库，便于快速部署与调试。
2. 设计目标
- 结构化输出：自动标记 swing 高低点，给出结构偏向（趋势、震荡）。
- 形态识别：检测常见反转与延续形态，帮助交易者快速定位潜在机会。
- 环境过滤：用 Tick 量与多周期方向判断是否存在动量共振，减少噪音信号。
- 风险提示：根据 ATR 与账户资金估算建议仓位，为交易决策提供风险参考。
- 易扩展：模块化函数设计，便于替换或新增识别逻辑。
3. 模块结构
| 模块 | 说明 | 主要函数 |
|---|---|---|
| 价格结构 | 通过摆动点维护最近的 HH/HL、LH/LL，绘制箭头并计算结构偏向 | IsSwingHigh, IsSwingLow, RegisterSwing, DetermineStructureBias |
| 形态识别 | 检查双顶/双底、头肩、三角形等形态，并在图表上绘制文本标记 | EvaluatePatterns 及 Detect* 系列 |
| 量能过滤 | 计算 Tick 量均值，识别放量柱，辅助判断突破/假突破 | SimpleAverageVolume, VolumeBoostBuffer |
| 多周期共振 | 读取高一级周期 EMA 方向，叠加到结构偏向 | HigherTimeframeBias |
| 风险面板 | 计算 ATR、每笔风险金额、建议手数，并通过 Comment 输出 |
UpdateRiskDashboard, PipValue |
各模块相互独立，通过 OnCalculate 中的顺序调用串联，实现从数据采集到信号过滤、风险提示的完整链路。
4. 数据流概览
OnCalculate逐根向左扫描，检测 swing 高低点。- 新增的摆动点写入循环队列，并触发
EvaluatePatterns。 - 同步计算结构偏向 (
DetermineStructureBias) 与多周期偏向 (HigherTimeframeBias)。 SimpleAverageVolume比较当前 Tick 量是否放大，将结果写入VolumeBoostBuffer。- 每次刷新后调用
UpdateRiskDashboard，输出风险信息。
5. 输入参数
SwingDepth：摆动点判定深度，值越大越抗噪，信号越少。MaxLookbackBars：单次刷新处理的最大历史条数，控制性能。VolumeLookback/VolumeFactor：量能均值窗口与放量倍数阈值。HigherTF/HigherMAPeriod：多周期 EMA 的周期与长度。AtrPeriod/RiskPercent/AccountValueOverride：风险计算相关配置。PatternTolerancePips：形态点位允许的偏差，适配不同品种波动。LabelOffsetPips：图形标注相对价格的偏移量。Enable*开关：可单独启用/关闭各类形态识别。
6. 核心实现细节
6.1 摆动点与结构偏向
IsSwingHigh/Low使用对称窗口判断极值。RegisterSwing维护长度为MAX_SWINGS的循环数组。DetermineStructureBias根据最近两对高低点判断趋势方向：HH+HL 视为上升，LL+LH 为下降，其余视为震荡。
6.2 形态识别流水线
EvaluatePatterns在每次新摆动点出现时运行。- 双顶/双底通过高度差容忍度与中间相反摆动验证。
- 头肩形态需满足左右肩高度近似、颈线水平以及头部高(低)于肩。
- 三角形识别判定高点趋同/低点抬高（或相反）以区分上升/下降。
RenderPattern使用文本对象标注名称，避免重复信号通过最近索引缓存。
6.3 Tick 量过滤
SimpleAverageVolume对最近VolumeLookback根 Tick 量求平均。- 若当前 Tick 量 > 均值 ×
VolumeFactor且结构偏向非零，则在直方图缓冲区绘制放量柱。
6.4 多周期与风险
HigherTimeframeBias利用iBarShift对齐时间戳，获取高周期 EMA，返回方向（+1/-1/0）。UpdateRiskDashboard由 ATR 推导每手风险，结合账户权益计算建议手数，并在图表左上角输出。
7. 使用建议
- 验证：在策略测试器里用回放模式观察结构、形态与量能提示是否符合盘感；必要时调高
SwingDepth抑制噪音。 - 参数调优：不同品种/周期波动差异大，建议按 ATR 调整
PatternTolerancePips与VolumeFactor。 - 复盘：将
Comment输出与历史记录搭配截图，记录真实表现，为后续改进提供依据。 - 与 EA 集成：如需自动化，可将结构偏向、形态信号写入全局变量或文件，再由 EA 读取执行。
8. 扩展方向
- 增加更多形态（如谐波、1-2-3 反转）或价格行为判定（针形线、内包线过滤）。
- 引入结构破坏告警（例如趋势线、前高低突破）并推送通知。
- 扩展至 MT5，利用真实成交量与订单薄数据增强量能模块。
- 构建回测统计框架，输出信号胜率、均值回撤等量化指标。
9. 文件信息
- 指标源码：
PriceStructureSuite.mq4 - 本开发文档：
开发文档.md
两份文件位于 c:\Users\PCPCPCP\Documents\JG，可直接在 MetaEditor 与 Markdown 编辑器中查看或修改。