heron-strategy

HERON v1.0.0 是 Senpi 的入门级 ETH 趋势跟随策略（Onboarding tier），仅交易 ETH，支持做多或做空。当 ETH 处于 4 小时趋势中，且 Senpi 智能资金（Smart-Money）排行榜方向与该趋势一致时，Heron 会开立一个单一信念仓位，并交由 DSL 棘轮机制管理。

用途

Heron 是 Senpi 新用户的默认首笔交易策略，设计目标是降低入门门槛：

单一资产：只交易 ETH，无需调整多资产白名单，无需过滤 XYZ 资产池，也无需解读资金费率机制。
单一问题：ETH 是否处于趋势中？Heron 通过 4 小时 K 线结构判断（更高的低点 = 看涨，更低的高点 = 看跌）。
单一方向门控：智能资金是否同意？Heron 拉取 Senpi 排行榜集中度，要求顶级交易者持仓方向与趋势一致后才触发。
单一退出机制：DSL。第一阶段最大亏损 20% 底线 + 第二阶段宽幅棘轮阶梯。所有时间类退出均禁用，让盈利趋势充分发展。

主要能力

当两个门控均通过且评分超过底线时，Heron 对每个合格设置发出一个信号。每天最多 2 次入场，每资产 4 小时冷却。

关键规则：

规则 1：生产者入场，DSL 退出，生产者从不平仓。生产者没有 close_position 调用点，所有退出均通过 DSL 第一阶段最大亏损 / 第二阶段棘轮回撤完成。

规则 2：智能资金方向门控是硬性的，不是软性的。如果 leaderboard_get_markets 返回 NEUTRAL 或返回与 4 小时趋势相反的方向，生产者输出 WAITING，不产生合格设置，也不执行任何操作，没有覆盖机制。

规则 3：生产者通过 push_signal() 发出信号，由运行时开仓。运行时的 LLM 门控 heron_entry 动作接收信号，按 schema 校验，并通过 FEE_OPTIMIZED_LIMIT 开仓，ensure_execution_as_taker: false（入场使用 ALO 耐心等待）。退出订单使用 ensure_execution_as_taker: true，确保平仓总能执行。

规则 4：竞态窗口去重是强制性的。生产者在每次成功 push_signal() 后写入 state/recent-signals.json，并在构建论点之前检查缓存。240 秒 TTL 覆盖 push_signal 返回 OK 与仓位出现在下一 tick clearinghouseState 之间的间隙。

规则 5：入门默认值不要激进调整。默认配置为 minScore: 5（满分约 9）、smTiltMinPct: 60、smStrongTiltPct: 70、25% 保证金 / 5 倍杠杆、每天 2 次入场、4 小时冷却。这些参数面向学习平台的新用户，而非激进提取 alpha。不要提高 minScore（会使策略缺乏信号），不要将杠杆提高到 5 倍以上（操作者资金风险）。

评分方式

方向门控（全部必需）：4 小时趋势 ≠ NEUTRAL（更高的低点 ≥ 60% 看涨，或更低的高点 ≥ 60% 看跌）；智能资金方向与 4 小时趋势一致；智能资金倾斜 ≥ smTiltMinPct（默认 60%）。

评分组件（最高约 9 分）：4 小时趋势与方向一致 +3；1 小时趋势确认 4 小时 +2；智能资金对齐（门控确认）+2；智能资金强烈倾斜（≥ smStrongTiltPct）+1；成交量上升（回看差值 >10%）+1。底线 minScore: 5。典型入场 5-7 分，强设置 7-8 分，Apex（罕见）9 分。

DSL 预设（Bison 模式宽幅）

第一阶段：max_loss_pct 20%，retrace_threshold 8%，consecutive_breaches 1。

时间类退出：hard_timeout 禁用，weak_peak_cut 禁用，dead_weight_cut 禁用。

第二阶段棘轮阶梯：T0 +10% / 锁定 0；T1 +20% / 锁定 25%；T2 +30% / 锁定 40%；T3 +50% / 锁定 60%；T4 +75% / 锁定 75%；T5 +100% / 锁定 85%（apex）。T0 锁定 0% 是关键变化——上涨 10% 的行情可以完全回撤而不锁定，给真实趋势发展空间。

风险护栏（runtime.yaml risk.guard_rails）

max_entries_per_day: 2（入门：少而强）；per_asset_cooldown_minutes: 240（ETH 尝试间隔 4 小时）；daily_loss_limit_pct: 15（限制糟糕的一天）；max_consecutive_losses: 3（连亏后暂停）；cooldown_minutes（亏损后）: 60（止损后冷却）；drawdown_halt_pct: 25（灾难性底线熔断）；drawdown_reset_on_day_rollover: false（午夜不重置）。

硬编码常量（不可配置）：ASSET: "ETH"（Heron/Hummingbird 是分别使用 ETH/HYPE 的独立技能）；MAX_LEVERAGE: 5；RECENT_SIGNAL_TTL_SEC: 240。

使用方式

用户对话中的 Claude 会话必须不得调用：create_position、close_position、edit_position、ratchet_stop_add、ratchet_stop_edit、ratchet_stop_delete、cancel_order、strategy_close、strategy_close_positions。这些工具保留给生产者守护进程（入场路径）和 DSL 棘轮引擎（退出路径）。用户对话会话为只读。

该策略使用单资产趋势跟随（Kodiak 家族）扫描器模式，并增加了智能资金方向门控。主要 MCP 调用：market_get_asset_data（ETH K 线）、leaderboard_get_markets（智能资金方向）。操作者安装请参阅 README.md 中的全新安装与环境变量设置。

适用场景

适合刚接触 Senpi、希望从单一资产、单一策略开始学习平台的新用户。适合希望以较低杠杆（5 倍）和较少交易频率（每天最多 2 次）进行 ETH 趋势跟随的场景。

限制

仅交易 ETH；仅支持 4 小时趋势结构判断；智能资金方向门控为硬性，无覆盖；每天最多 2 次入场；每资产 4 小时冷却；杠杆上限 5 倍；时间类退出全部禁用；用户对话会话为只读，不能调用仓位管理工具。

版本与许可

技能介绍