盘中放量上涨阳线扫描器

要解决什么问题

盘中想找「量放出来了、价格也在涨、K 线还是阳线」的 A 股，手工翻行情软件既慢又难统一口径。Break Watch 把这三条规则做成可重复执行的扫描：在交易时段用实时行情跑一遍全市场或自选池，把命中标的整理成结构化 JSON，方便 Agent 做表格展示或后续复盘。

技能如何工作

底层通过 pytdx 连接通达信行情服务器拉取 tick/分钟级数据。放量不是只看当日总量，而是两套指标并行：

• 历史同进度量比：按当日已走完的交易进度（trading_progress），与过去 N 天（默认 20 天）同一进度下的成交量对比，得到 volume_ratio。
• 盘中新增量突增：相对上一轮扫描窗口的新增量倍数（interval_spike_ratio）；首轮没有前一轮对比时该字段为 null，此时仅依赖历史量比。

命中需同时满足：当前价高于开盘价（收阳线）、涨幅不低于阈值（默认 1%）、上述放量条件均达阈值（默认量比与突增均为 2.0）。核心入口是 scripts/scan_breakout.py，参数可指定 --mode all|watchlist、涨幅/量比阈值、输出 json|files|both 等；进度走 stderr，结果 JSON 走 stdout，便于 json.loads() 解析。

适用边界与注意

• 非交易时段若强制扫描，通达信往往返回上一交易日收盘态，is_trading_hours 为 false，勿当作盘中实时信号。
• 默认剔除科创板（688/689）与北交所，保留创业板（300/301）；A 股涨跌色惯例为涨红跌绿。
• 输出仅供行情整理与复盘参考，不构成投资建议。