杯柄形态预警 v1

要解决的问题

股票技术分析里，杯柄形态通常依赖人工看图，且容易出现“先知道结果再画形态”的未来函数问题。cup-handle-alert-v1 把 CANSLIM 的 Cup and Handle 规则落到日线前复权数据上，目标是每天自动筛出两类可跟踪信号：D 点确认和放量突破，用于实盘观察池而不是事后复盘。

技能如何工作

• 输入 data/L1_price/daily_qfq.parquet 的 L1 前复权日线，以及 data/L0_raw/stock_info.parquet 的股票信息。
• 用平滑与极值识别定位 KABCD 各点，再判断杯体深度、柄部天数、C 点恢复度和突破量比。
• 全市场扫描时，控制台输出今日新增预警，并写入 cup_handle_daily_alerts.csv。
• 单只股票分析时，在 alerts_html/ 生成可交互 HTML 图，便于查看形态结构。
• 输出字段包括 alert_type、breakout_price、breakout_vol_ratio、cup_depth_pct、handle_depth_pct、recovery_pct 和 K_price~D_price。
• 关键阈值如杯深 10%~40%、柄部 5~25 天、突破量比 >=1.3、突破杯沿 1% 以上，都是可解释的过滤条件。

适用边界

该技能面向日线形态筛选，不等同于成交执行系统；突破信号仍需结合流动性、交易成本和个股事件判断。数据缺失、停牌或前复权口径变化时，结果可能不完整。参数偏保守，若用于高频盘中信号或分钟级交易，需要另行扩展数据粒度和触发逻辑。