谐波形态 XABCD 结构识别与 PRZ 交易实战Vibe-Trading 谐波信号引擎深度解析【免费下载链接】Vibe-TradingVibe-Trading: Your Personal Trading Agent项目地址: https://gitcode.com/GitHub_Trending/vi/Vibe-Trading本文是 Vibe-Trading个人交易 Agent中harmonic 技能的技术指南围绕谐波形态的 XABCD 五点结构展开从 Gartley、Bat、Butterfly、Crab 四大经典形态的 Fibonacci 比率定义到 PRZ潜在反转区的入场、止损与止盈规则再到仓库中SignalEngine信号引擎的双后端实现与实战调用方式。读完本文你将掌握谐波形态的完整识别标准、比率容差工程化方法以及如何在 Vibe-Trading 中将形态信号接入你的交易工作流。XABCD 形态识别原理五个点定义一段可交易的走势谐波形态Harmonic Patterns属于 Fibonacci 几何学派其核心思想是价格走势并非随机而是在特定位置存在可预测的拐点。这种可预测性来自价格在关键区间的回撤Retracement与扩展Extension比率——这些比率由 Fibonacci 数列演化而来0.382、0.5、0.618、0.786、0.886、1.27、1.618、2.618、3.618 等。任何谐波形态都由5 个关键点构成按时间顺序依次为X → A → B → C → D其中每两段走势之间存在精确的 Fibonacci 比率关系线段含义比率计算XA第一段主要趋势后续回撤与扩展的基准AB对 XA 的回撤B 点回撤AB / XABC对 AB 的回撤BC / ABCD对 BC 的扩展CD / BCAD最终价格延伸D 点回撤AD / XAD 点是整个形态的落点当价格运行到 D 点时形态宣告完成此处是潜在的反转区域。D 点的位置由前四段走势共同约束因而比单一的回撤位或扩展位具有更高的确定性。需要特别说明的是原文档 XABCD形态.md 给出的是各形态的理论标准比率如 AB 0.618 × XA而实际工程实现中这些比率都是以范围 容差的形式落地我们会在后文结合源码展开。四大经典谐波形态详解谐波形态家族中应用最广、信号质量最受认可的四大形态分别是 Gartley、Bat、Butterfly、Crab。它们共享 XABCD 五点骨架差异在于B 点回撤深度与D 点延伸程度不同由此形成各自独特的几何轮廓。Gartley 形态222 形态Gartley 形态因其发表于 1932 年的第 222 页而得名是最古老、最经典的谐波形态。其关键比率AB 0.618× XAB 点回撤约 61.8%BC 0.382–0.886 × ABCD 1.27–1.618 × BCD 0.786 × XA关键——D 点由 XA 的 78.6% 回撤位精确定位方向判定规则看涨 GartleyX 为低点、A 为高点价格经 B、C 两段整理后回落至 D 点位于 XA 中段下方D 点在底部完成反转看跌 GartleyX 为高点、A 为低点价格反弹至 D 点位于 XA 中段上方D 点在顶部完成反转。Gartley 形态的 D 点不超出 X 点范围属于收敛型形态适合在 D 点确认反转信号后入场。Bat 蝙蝠形态Bat 形态由 Carney 发现并推广与 Gartley 的核心区别在于B 点回撤更浅AB 0.382–0.5 × XAB 点仅回撤 38.2%–50%浅回撤BC 0.382–0.886 × ABCD 1.618–2.618 × BCCD 段延伸明显D 0.886 × XA关键——D 点深达 XA 的 88.6% 回撤由于 B 点回撤浅而 D 点回撤深Bat 形态整体呈现浅 B 深 D的拉伸结构。0.886 是极其接近 1.0 的深回撤位意味着 D 点往往出现在趋势的极深处反转概率与止损空间需要结合 PRZ 区域综合评估。Butterfly 蝴蝶形态Butterfly 是唯一 D 点超出 X 点的形态AB 0.786× XAB 点深回撤至 78.6%BC 0.382–0.886 × ABCD 1.618–2.618 × BCD 1.27 × XA超出 X 点——D 点延伸至 XA 的 127%彻底穿越 X 点的价格极值形态的命名源于其展开后的轮廓酷似蝴蝶。由于 D 点突破 X 点它属于扩展型形态价格在 D 点创出新高/新低后反转属于典型的风险区反转交易。Crab 螃蟹形态Crab 螃蟹形态是最极端的谐波形态具有最远的 D 点延伸AB 0.382–0.618 × XABC 0.382–0.886 × ABCD 2.24–3.618× BCCD 段暴力延伸D 1.618 × XA关键最远延伸——D 点为 XA 的 161.8% 扩展位Crab 形态要求 CD 段走出 2.24 至 3.618 倍的极端延伸D 点位于 1.618 扩展位是谐波家族中价格波动最剧烈、形态最难成立的形态一旦完整成立并反转往往对应一轮强劲的趋势逆转行情。四大形态速查表综合 SKILL.md 中的形态总览与 XABCD 参考文档四种形态的对照关系如下形态B 点回撤AB/XAD 点回撤AD/XAD 点相对 X 点特性Gartley0.6180.786未超出经典收敛形态Bat0.382–0.50.886未超出浅 B 深 DButterfly0.7861.27超出深 B 深 DCrab0.382–0.6181.618大幅超出最远延伸、最极端比率容差工程化源码中的形态定义理论比率是教科书标准但真实行情极少走出精确到小数点后三位的完美比率。Vibe-Trading 的谐波信号引擎将每个比率定义为区间 容差tol落在区间内的结构即视为该形态的候选。见 example_signal_engine.py 中的PATTERNS字典形态B 回撤区间D 回撤区间BC/ABCD/BCGartley0.55–0.680.72–0.840.382–0.8861.27–1.618Bat0.33–0.550.82–0.940.382–0.8861.618–2.618Butterfly0.72–0.841.20–1.380.382–0.8861.618–2.618Crab0.33–0.681.52–1.720.382–0.8862.24–3.618对比可见Gartley 的 B 点区间 0.55–0.68 以 0.618 为中心Bat 的 B 点区间 0.33–0.55 对应 0.382–0.5 的浅回撤D 点区间 0.82–0.94 对应 0.886Butterfly 的 B 点区间 0.72–0.84 对应 0.786D 点区间 1.20–1.38 以 1.27 为中心明确超出 1.0超出 X 点Crab 的 D 点区间 1.52–1.72 以 1.618 为中心是唯一 D 回撤区间整体高于 1.5 的形态。实际判定时_classify_pattern函数先计算b_retrace AB/XA、d_retrace AD/XA、bc_ratio BC/AB、cd_ratio CD/BC四个比率再依次与各形态的区间匹配主校验条件是B 回撤与 D 回撤两个核心比率命中即判为该形态。比率匹配的容差tol默认值为 0.12SignalEngine.__init__可通过构造参数调整——容差越大检出率越高但误报也随之增加。从形态到信号PRZ潜在反转区交易规则形态识别完成只是第一步真正的交易发生在PRZPotential Reversal Zone潜在反转区。PRZ 的定义见 PRZ交易.md 与 SKILL.mdPRZ 是多个 Fibonacci 水平汇聚的价格区域——D 点完成时所在的价格区带它是多个 Fibonacci 投影如 0.786/0.886/1.27/1.618 回撤与扩展位的交汇点多个独立比率同时指向同一价格区域意味着这里具有高概率反转属性。入场规则在 PRZ 区域等待价格反应出现反转 K 线形态如吞没、锤子、十字星等确认信号后再入场不要在 D 点未确认前提前入场——形态未完成前入场D 点可能继续延伸尤其在 Butterfly 与 Crab 这类扩展型形态中。止损规则看涨形态止损设在 D 点下方看跌形态止损设在 D 点上方止损距离通常为PRZ 区域宽度的 1–1.5 倍为价格在区域内正常波动预留缓冲。止盈规则三段式目标第一目标AD 腿的 0.382 回撤位第二目标AD 腿的 0.618 回撤位第三目标A 点完整回撤至形态起点。这样的止盈结构让单笔交易形成先保本、后趋势的递进式获利了结。注意事项谐波形态完成不代表必然反转——D 点是高概率区域而非确定性保证需要配合量能和 K 线形态确认信号引擎只给出形态结构结论最终入场需结合确认信号高级时间框架的形态更可靠日线以上级别的 XABCD 结构通常优于分钟级。工程实现双后端信号检测架构Vibe-Trading 的 harmonic 技能在工程上采用了优先第三方库、失败自动回退的双后端设计完整实现位于 example_signal_engine.py。后端一pyharmonics 库优先SignalEngine._check_pyharmonics()在初始化时尝试导入pyharmonics.technicals.OHLCTechnicals导入成功则标记use_pyharmonics True。_detect_patterns_pyharmonics通过OHLCTechnicals(df, is_stockis_stock)拟合形态从tech.bullish/tech.bearish矩阵中提取各形态的 D 点索引与价格。pyharmonics 是可选依赖需要显式安装扩展包pip install vibe-trading-ai[harmonic]才会生效见 SKILL.md 与 requirements.txt 中的注释。仓库的打包配置在 pyproject.toml 中定义了harmonic可选依赖组pyharmonics1.5.0测试 test_packaging_dependencies.py 也专门验证了pyharmonics 不是核心安装依赖、仅作为可选 extra 提供——这一设计保证了未安装该库的用户基线安装不受影响。后端二内置检测器回退当 pyharmonics 不可用未安装或调用抛异常时引擎回退到自研检测器流程为摆动点检测_find_swings使用滚动窗口法半窗口swing_window默认 10实际窗口为 2×10121 根 K 线识别摆动高/低点摆动点合并_merge_swings按时间排序并压缩连续同类型点高点取更高、低点取更低形成交替的高/低点序列五点组合枚举滑动窗口每次取 5 个连续摆动点作为 X-A-B-C-D 候选并校验 5 点必须高低交替比率分类_classify_pattern按上文 PATTERNS 区间规则判定形态名称方向判定X 点为摆动低点则形态为 bullish看涨X 点为摆动高点则为 bearish看跌。信号生成与信号约定SignalEngine.generate(data_map)接收{标的代码: OHLCV DataFrame}映射对每个标的逐一点位写入信号最终返回{标的代码: 信号 Series}。信号约定与 SKILL.md 一致1 做多long-1 做空short0 观望stand aside看涨形态在 D 点时刻置1看跌形态置-1。同时引擎内置了数据量下限保护当 K 线数量少于swing_window * 4时直接返回全 0 信号避免短样本上产生无意义的结构识别。实战使用完整调用示例example_signal_engine.py自带主入口可直接对 OKX 主流币种运行演示。运行逻辑为通过_fetch_okx拉取BTC-USDT、ETH-USDT、SOL-USDT的 1D K 线各 300 根来自 OKX 公开行情接口OHLCV 数据经过类型转换并设置 datetime 索引实例化SignalEngine(is_stockFalse)并打印当前实际使用的检测后端pyharmonics 或内置检测器调用engine.generate(data_map)生成全标的全周期信号序列输出各标的的做多/做空信号数量与最近信号日期并打印最近 5 个形态的形态名方向D 点时间详情。核心调用仅需三行from harmonic.example_signal_engine import SignalEngine # 或直接引用技能目录 engine SignalEngine(is_stockFalse) signals engine.generate(data_map) # signals[BTC-USDT].value_counts() - 1 / -1 / 0 分布SignalEngine的三个构造参数参数默认值说明is_stockFalse标的是否为股票影响 pyharmonics 的is_stock分析参数swing_window10摆动点检测半窗口仅内置检测器使用tol0.12Fibonacci 比率匹配容差仅内置检测器使用generate的输入 DataFrame 要求包含open/high/low/close列索引为 datetime对加密标的传入is_stockFalse对股票标的传入is_stockTrue。在 Agent 与 Swarm 中的集成harmonic 技能在 Vibe-Trading 中不止于独立脚本还以 Agent 技能Skill的形式接入多 Agent 协作。仓库的 Swarm 预设 technical_analysis_panel.yaml 中配置了harmonic_analyst分析师 Agent角色定位资深谐波形态分析师专门识别 Butterfly、Crab、Gartley、Shark、Bat、Three Drives 等形态用 Fibonacci 定位 PRZ 入场/离场点并评估风险回报比工作方式对指定标的与时间框架扫描谐波形态评估 PRZ 的可交易性tradeability使用load_skill(harmonic)加载技能输出契约与其他经典 TAK 线、Ichimoku、波浪、SMCAgent 并行分析后由信号聚合器对共识与共振进行评分谐波信号作为汇总评分的一部分参与权重调节。这一编排意味着谐波形态技能可以独立跑回测也可以在 Agent 盘中分析中被实时调用与其他技术分析流派共同形成多因子共识。此外agent/SKILL.md 将谐波形态列入技术分析能力矩阵说明该技能是 Vibe-Trading 内置的策略能力之一。局限性与使用建议结合参考文档与源码使用谐波信号引擎时有几点需要明确形态识别是必要条件而非充分条件引擎输出的只是结构上满足 Fibonacci 比率约束的候选反转是否成立还需量能、K 线确认与更高时间框架验证比率容差需要调优tol0.12是默认值不同市场加密、股票、外汇的噪声水平不同可通过回测调整容差与swing_window平衡检出率与误报率数据长度限制检测器依赖足够的摆动点数据量过少时引擎自动放弃检测返回全 0建议至少保留数百根 K 线D 点未确认前不交易尤其对 Butterfly、Crab 等 D 点超出 X 点的扩展型形态D 点区域可能进一步延伸严格等待确认信号可显著降低提前入场的风险。掌握 XABCD 的比率结构、理解 PRZ 的交易规则、并能熟练驱动SignalEngine生成信号你便可以在 Vibe-Trading 中把谐波形态从看图说话升级为可回测、可自动化、可被 Agent 调度执行的量化策略组件。【免费下载链接】Vibe-TradingVibe-Trading: Your Personal Trading Agent项目地址: https://gitcode.com/GitHub_Trending/vi/Vibe-Trading创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考