M3 SignalModule · 金K入场
⬡ claude-sonnet-4-6 · 2026-05-20
算法概述
注册名
golden_candle所属插槽M3 SignalModule
状态stable
核心思路在趋势回调至关键位区域时，寻找一根「金K」作为入场信号。金K是一根实体占比高、方向与趋势一致的K线，出现在关键位区间内或触碰区间后反转，代表趋势延续意图的第一根确认K线。
入场逻辑金K收盘后在下一根 K 线开盘价附近入场（不追涨，等回确认）
依赖上游需要 M1 输出的
direction 和 M2 输出的 key_levels检测逻辑
前置过滤
仅在 M1 的
stage == "pullback" 时检测金K（价格回调到关键位才有意义）。若 stage 为 impulse 或 consolidation，当前 K 线不满足前置条件，返回 None。位置验证
检查最新一根已收盘 K 线的 Low（多头信号）或 High（空头信号）是否触碰了某个关键位的
zone_low ~ zone_high 区间。触碰但未有效跌破（多头：收盘价仍高于 zone_low）才算有效触碰。金K形态验证
满足以下全部条件：
- 实体比例：实体（|close - open|）占 K 线总幅度（high - low）的比例 ≥
min_body_ratio - 方向一致：多头信号时为阳线（close > open），空头信号时为阴线
- 上影线（多头）或下影线（空头）短：影线占比 ≤
max_shadow_ratio - K 线幅度：总幅度（high - low）不小于
min_candle_atr_multiplier × ATR，排除假突破的小 K 线
入场价格计算
entry_price_hint = 金K收盘价（多头）或收盘价（空头）。PlanModule 可在此基础上调整（如设置限价单略高于收盘价）。参数配置
| 参数名 | 类型 | 默认值 | 说明 |
|---|---|---|---|
min_body_ratio | float | 0.6 | 实体占K线幅度的最小比例 |
max_shadow_ratio | float | 0.2 | 入场方向反向的影线最大占比 |
min_candle_atr_multiplier | float | 0.8 | K线幅度最小为 ATR 的此倍数 |
atr_period | int | 14 | ATR 计算周期 |
require_pullback_stage | bool | True | 是否要求 M1 stage 为 pullback 才检测（建议保持 True） |
输出规格
| 字段 | 本算法的输出值说明 |
|---|---|
signal_type | 固定为 "golden_candle" |
direction | 与 M1 的 direction 一致（"long" / "short"） |
entry_candle_time | 金K收盘时间戳 |
entry_price_hint | 金K收盘价（PlanModule 参考值） |
key_level_ref | 触发此金K信号的关键位（KeyLevel 对象） |
confidence | 当前版本置为 None |
短路条件
前置 stage 不满足
若 M1
stage ≠ "pullback"，直接返回 None，不扫描 K 线。无有效金K
当前 K 线不满足形态条件，或当前 K 线未触碰任何关键位区间，返回
None。接口对齐
本算法实现 SignalModule ABC，输入输出类型参见 module_interface_spec.html。