股票热点动量（VIP版）

概述

A股热点板块量化排名引擎。需配置「访问密钥」方可生成与读取报告：数据经付费鉴权网关（key 校验）取回，学员端不直接持有任何存储凭证。无密钥或密钥失效时，脚本会明确报错退出，不取数、不出报告。

⚠️ 运行方式

• 默认（付费门禁）：python scripts/run_student.py —— 零本地依赖、不读本地行情数据，

经鉴权网关取数。须在本目录放置 key.txt（或 config.json 的 key 字段、环境变量 STRATEGY_KEY）。

• 密钥由课程助教签发，向助教获取后写入上述位置即可使用。

触发条件

用户说出以下任意关键词时触发：

• 「热点动量」
• 「热点分析」
• 「股票热点」
• 「板块动量」
• 「帮我分析下热点」
• 「看看今天什么板块热」

运行前提（极简）

1. 能联网访问鉴权网关（默认 https://auth.focuskp.xyz）
2. 已安装 Python 3（标准库即可，无需 pip 装任何包）
3. 已配置访问密钥（三选一）：
   • 本目录 key.txt，内容为一行密钥
   • 本目录 config.json，含 "key": "evt-xxxx"
   • 环境变量 STRATEGY_KEY=evt-xxxx
4. 可选环境变量：
   • STRATEGY_GATEWAY：覆盖网关地址（默认 auth.focuskp.xyz）
   • HOT_TOPN：热点板块取前 N 个做交集（默认 20）

执行方式（零配置，仅依赖密钥）

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

脚本自动完成：

1. 校验访问密钥（无密钥/失效 → 退出并提示）
2. 经鉴权网关取回 3 个 JSON（股票池 / 板块涨幅+成分股 / 个股四维评分）
3. 板块按当日涨幅降序取 TopN 热点
4. 热点板块 ∩ 股票池（用 boards 成分股比对，纯集合运算）
5. 复用云端四维评分（stocks.json 已算好，零外网复现）
6. 生成 user_hot_momentum.json + user_hot_momentum.html 报告

取数的 3 个对象（网关私有存储，学员端不直接访问）

四维评分体系（references/scoring.md）

总分徽章：≥70🔥烈焰 / ≥60🥇黄金 / ≥50🟠琥珀 / ≥40🥉青铜 / <40⚙️钢铁

数据源架构（付费门禁版）

发布端（本地盘后）→ 鉴权网关私有存储（3 JSON）
        ↑ 学员端 run_student.py 经密钥校验后由网关取回（标准库 urllib，零本地依赖）
学员端：校验密钥 → 板块排序 → 热点∩股票池 → 四维评分 → 分析报告

注意事项

• 中国股市惯例：红色=涨，绿色=跌
• 报告数据时效取决于当日发布时间（建议每日 16:00 后跑）
• 密钥失效（过期/作废）时，本地缓存的报告产物会被自动清空，需续费后重新生成
• 不构成任何投资建议，仅供学习参考
• 概念板块成分股偶发异常（个别板块成分股数量异常膨胀，如某板块挂入数千只）：服务端与学员端均已加 >2000 自动过滤——异常板块保留真实涨幅(name+chg)但清空/跳过成分股交集，不会被带偏成单一板块。