将军柱形态（云端版）
我是你的将军柱形态助手，帮你从当日公开数据中，直观看到将军柱（买点第三绝）的形态标的。
> 将军柱 ＝ 底部（或长期横盘末端）出现的第一个涨停板，是主力的标杆，也是多方反攻的号角。
本工具：
- 不读本地通达信、不连行情服务器、不装任何第三方包
- 直接消费当日公开数据，生成将军柱形态报告
零依赖、零本地环境要求，适合在云端快速操作查看结果。
数据说明
数据范围：A股将军柱（买点第三绝）当日形态标的列表，基于当日公开数据得出。
数据地址可通过环境变量 HOMEBASE 或 HOMEWORK_BASE 配置，默认使用内置公开地址。
若数据未更新或网络不可达，脚本会明确报错提示。
判定口径（v3）
| # | 判定 | 落地参数 |
|---|---|---|
| ① | 底部首个涨停 | 当日涨停（主板 10% / 创业科创 20%，按板块制度）且之前 120 个交易日一次涨停都没有 |
| ② | 位置（满足其一） | 底部反转型：距 250 日高点回撤 ≥25%；整理突破型：近 60 日振幅 ≤25% |
| ③ | 量比(20日) ≤3 | 将军柱当日成交量 ÷ 前 20 日平均成交量 |
为什么量比要小？ 缩量涨停 = 抛压枯竭、筹码锁定，比放量涨停更强；放量涨停常是跟风抢筹、主力借机出货。
实测（近年全市场样本，第 20 个交易日收益中位数）：量比 ≤1.5 → +4.12%（正收益 61.3%）；2~3 → +0.14%；>8 → -5.35%（29.0%）。
★精选 ＝ 量比 ≤2.0 且 距 250 日高回撤 ≤-35%（两项都在信号日当天可算，无需未来数据）。
展示内容
- 顶部统计卡 6 张：命中买点 / ★精选(低量比+深回撤) / 近5日新信号 / 有回踩低吸窗口 / 未破位(至今) / 平均量比
- 将军柱形态列表（最近 30 个交易日）：
- 代码 / 名称 / 将军柱日 / 距今天数（≤5 日红标＝新鲜信号，≥20 日淡显＝已过最佳跟踪期）
- 当日涨幅 / 当日大盘（该日指数涨跌幅，仅供参考，不参与筛选）
- 量比(20日) / 距250日高 / 牛熊分型（底部反转 / 整理突破）
- 回踩MA5（首次回踩 5 日线的交易日，括注节奏档：急脾气 1-2日 / 常规 3-5日 / 从容 6-10日 / 磨人 11日+）
- 破位（第 N 日跌破将军柱最低价＝形态作废）/ 精选 / 成交额(亿)
怎么用
1. 不必追高，等回踩均线低吸 —— 首次回踩 MA5 中位只需 3 天、MA10 要 6 天、MA20 要 10 天。
2. 回踩节奏：主力越「磨」，后面涨得越猛 —— 回踩 MA5 第 1-2 日启动 → 20 日最高涨幅中位 +6.9%；第 3-5 日 → +12.7%；第 6-10 日 → +48.0%。
（「急脾气 1-2 日」档统计上最弱，但它要等第 2 日才能确认，等待成本会吃掉优势，故只作风险提示、不作筛选条件。）
3. 何时认错 —— 收盘跌破将军柱最低价 = 主力成本区失守 = 形态作废，认错换股。
20 日内跌破组第 20 日收益中位 -9.75%、正收益仅 14%；守住组 +3.46%、正收益 63%。破位集中在第 1-5 日，越早破位越要果断。
更新频率
- 数据每日 17 点之后自动更新，展示当日盘后最新结果。
执行流程
- 拉取当日公开数据
- 按列渲染将军柱形态表格
- 生成暗色主题 HTML 报告（涨红跌绿）
用法
直接说：「将军柱形态」、「查看将军柱」、「将军柱选股」、「第三绝形态」 或 「底部首个涨停」
或由命令行运行：
python scripts/run_student.py [工作目录]
注意事项
- 数据时效性取决于更新频率：每日 17 点之后自动更新
- 若拉取失败，检查网络连接或数据是否已更新
- 涨红跌绿遵循 A 股惯例；报告仅供参考，不构成投资建议
