热点动量分析报告 (hot-momentum-report)

用途

基于近期市场热点、板块龙头及市场公开数据，计算个股四维动量评分，自动生成热点板块与个股排名的分析报告（HTML 可视化 + JSON 数据）。零本地行情依赖——只需读取最新的市场公开数据快照，即可在任意环境复现完整分析。

何时使用

• 想查看当日/最新一期热点动量排名与板块龙头分布。
• 触发的自然语言：「热点动量」「生成热点报告」「看热点分析」「热点动量报告」。

前置依赖

• Python 3（标准库即可，无需安装额外行情/量化包）。
• 可访问的市场公开数据源地址（默认内置，也可用环境变量 HOMEWORK_BASE 指向你自己的数据源）。

数据来源

• 数据范围：近期市场热点与板块龙头，结合市场公开数据综合得出。
• 报告端读取 3 个预置的数据快照：
  1. 核心股票池（market, code, name）
  2. 概念板块当日涨幅 + 名称 + 成分股
  3. 个股四维评分快照
• 数据源地址可通过环境变量 HOMEWORK_BASE 配置，默认使用内置公开数据源。
• 若数据源未更新或网络不可达，脚本会明确报错提示，便于及时发现数据问题。

用法

python scripts/run_report.py [工作目录]

• 工作目录默认当前目录，报告产物（HTML + JSON）落在该目录。
• 热点覆盖数可通过环境变量 HOT_TOPN 调整（默认 20，即纳入统计的 Top 热点板块数量）。

输出产物

| 文件 | 内容 | |------|------| | user_hot_momentum.html | 可视化报告：Top10 热点板块芯片 + 个股四维评分排名表 + 综合评分徽章（红涨绿跌） | | user_hot_momentum.json | 同口径的机器可读数据，含热点板块、命中统计与完整排名 |

评分与展示逻辑

• 四维评分权重：5日30% + 10日30% + 20日25% + 60日15%，综合分 0–100。
• 热点板块按涨幅降序取 Top N，与核心股票池取交集，得到「站在热点上的个股」。
• 综合分分级徽章：≥70 烈火 / ≥60 金 / ≥50 琥珀 / ≥40 铜 / 其余 钢。
• 板块成分股异常（如单板块挂入数千只）自动跳过交集，避免报告被单一板块带偏。

注意事项

• 报告完全依赖上游数据快照；若读取失败或数据陈旧，脚本会主动提示，请先确认数据源已更新。
• 红涨绿跌遵循 A 股惯例；报告仅供参考，不构成投资建议。