用途:构建并维护美股每日 20% 异动事件研究,把大幅波动个股转为结构化研究记录,分类催化剂与图表背景,更新前瞻结果,汇总重复模式,用于研究、模型库和形态熟悉度训练。不生成买卖信号、不下单、不输出券商执行指令。
主要能力:扫描 +20%/-20% 异动;回填历史异动并研究后续走势;识别延续、反转、衰竭或主题集群模式;建立爆发赢家、重大失败和低质量假突破的模型库;为下游策略研究提供边缘线索。
使用方式:需 Python 3.9+,实时扫描需 FMP API key,或通过 --prices-json 使用离线 OHLCV JSON;可选结构化新闻/催化剂 JSON;建议使用 market-regime-daily 的市场状态产物。工作流分五步:scan 扫描、enrich 富集分类、update-outcomes 更新 1/3/5/10/20 日前瞻结果、summarize 汇总队列、backfill 历史回填。命令示例:python3 skills/stockbee-20pct-study/scripts/run_20pct_study.py scan --fmp-universe --max-symbols 300 --as-of 2026-06-28 --lookback-days 5 --min-abs-return-pct 20 --min-price 5 --min-dollar-volume 20000000 --include-down-movers --state-file state/stockbee/20pct_study_events.jsonl --output-dir reports/。离线可用 --prices-json data/us_daily_ohlcv.json 替代 --fmp-universe。
输出:事件 JSON、每日报告 MD、富集事件 JSON、结果更新 JSON/MD、队列汇总 JSON/MD、边缘线索 YAML,以及持久化模型库 state/stockbee/20pct_study_events.jsonl。
限制:富集为尽力而为,无新闻记录时保留为仅价格的 NO_CLEAR_NEWS 记录;回填默认标记 CURRENT_UNIVERSE_BACKFILL_SURVIVORSHIP_BIAS,仅当 OHLCV 含退市股和历史全市场覆盖时才加 --survivorship-complete;rule_candidates 与边缘线索仅作研究提示,改交易规则前需代表性图表复核、样本量阈值和样本外验证。具体收费、平台支持等资料暂未提供。