第一课《寻龙诀》· 伏龙掘金池选股工具
> 路径占位符：<SKILL_DIR> = 本技能安装目录
> （Windows：%USERPROFILE%\.workbuddy\skills\zhaoyun-lesson1-xunlongjue；macOS/Linux：~/.workbuddy/skills/zhaoyun-lesson1-xunlongjue）
> <输出目录> = 你希望看板生成到哪儿（建议绝对路径）。
> 脚本版本 v2.1.0（对应 scripts/xunlongjue.py 头部版本号，改脚本时同步改这里）。
> 技能包版本 v2.1.1（= 脚本 v2.1.0 + 文档修正：补「自动化命令外层单引号」的 exit 127 坑与 core 池口径澄清）。
>
> v2.1.0 版面：参考「可转债债券池」深色看板重构 —— 左侧固定档位导航侧栏 + 深色头部横幅（标题/徽章/数据日期/北京时间实时时钟/刷新与展开收起按钮）+ 8 张指标卡行（核心池红色高亮）+ 白色分区卡片。
> 改版面时的关键约定：build_html 里 CSS 和 JS 存在普通字符串 _css/_js（不是 f-string，花括号不双写），只有 body 是 f-string；CSS 里的 GAUGEPC/MOODC 是运行时 .replace() 的占位符。别把 CSS 并回 f-string，否则满屏 {{}} 极易出错。K 线 SVG（kline_svg）仍是浅色底设计，只能放在白色面板里。
触发后立即执行（直接跑出看板，不要只讲方法）
PY="python3" # 或本机 Python 绝对路径；脚本纯标准库，Python 3.8+ 即可
S="<SKILL_DIR>/scripts/xunlongjue.py"
OUT="<输出目录>" # 必须是 Windows 绝对路径
"$PY" "$S" --out "$OUT" --json
输出：<OUT>/伏龙掘金池_<YYYYMMDD>.html（单文件、离线可开）+ 同名 .json（JSON 已剔除 K 线字段）。
参数：--out 目录、--days N（回溯涨停池天数，默认5）、--json（导出指标JSON）。
跑完用 present_files 把 HTML 交给用户，并在回复里给出：情绪温度、热点板块TOP5、核心池名单。
看板的单票详情（点击展开）
每只入围股是一个 <details>，点击卡片即展开，内含：
1. 结论条 —— 一句话定性（真龙候选 / 接近 / 暂不具备）+ 达标项数与未达项数
2. 近 60 日 K 线走势图 —— Python 端生成的 SVG（蜡烛 + MA5 + MA20 + 量柱 + 橙色圆点标涨停日），涨红跌绿
3. 五步逐项诊断 —— 7 个维度（找热点/定高度/查换手/筛市值/看记忆/涨停基因/底部起爆）逐条对照课件标准，标「达标/待确认/未达」并给点评
4. 风险提示 —— 换手极端、连板过高、位置偏高、市值过大、量比异动等
5. 下一步观察 —— 按连板高度衔接后续课程（二板→第三课等三板确认+第五课竞价；三板以上→第二课辨震仓+第四课看筹码峰）
实现要点：K 线在 build_pool 里只对「今日涨停且通过硬门槛」的股保留最后 60 根（控制 HTML 体积，58 只股约 900KB）；详情文案由 analyze_detail(r) 生成，K 线图由 kline_svg(k, code, name) 生成。不要在 HTML 模板里重复造 f-string，改样式改 CSS 段即可。
课件方法论（第一课9.21.pptx 提取）
定位：只做底部起爆的短线龙头。课件明确排除超跌反弹（"超跌反弹=解套自救、断板下跌；底部起爆=合力打造新龙头"）。
寻找 · 五步（找·定·查·筛·看）
| 步 | 课件口径 | 脚本量化 |
|---|---|---|
| 找热点 | 龙头诞生于热点板块 | 按今日涨停池 hybk 聚合，板块涨停≥3只满分 |
| 定高度 | 三板定龙头，三板是分水岭 | lbc>=3 满分25；2板16；首板8 |
| 查换手 | 10%-30%；太低主力控盘过高散户进不去，太高资金分歧 | 10-30% 满分20；<5% 或 >30% 直接淘汰（课件反例：31.32%→次日跌停） |
| 筛市值 | 启动日流通市值 ＜100亿；20-50亿是"黄金市值"；不做＜20亿（退市风险） | 20-50亿满分15；<20亿淘汰 |
| 看记忆 | 龙头有记忆，以前是大哥现在还是大哥 | 近一年涨停≥8次且最高连板≥3 → 满分10 |
判断 · 涨停基因：股性评分≥50 且 近一年涨停≥5次（课件原话"最好>50、最好>5次"）。
大盘情绪温度：课件用涨跌家数量化（2024.9.30 涨5336/跌8/涨停678/跌停0 →100度；2025.4.7 涨24/跌5284/跌停2801 →25度）。
脚本按这两个锚点反解出线性公式 temp = 24.7 + 75.5 × 上涨家数/(涨+跌+平)，优先用真实全市场涨跌家数；
两个广度源都挂了才退化成涨停/跌停家数估算 20 + 80×涨停/(涨停+跌停+1)（此时需在回复中说明是估算）。
打分与分层（脚本已实现）
- 五步打分 100 分：找热点20 + 定高度25 + 查换手20 + 筛市值15 + 看记忆10 + 涨停基因10，再按「底部起爆」做 ±8 修正（距年线高点回调≥50% 加6；<15% 高位接力扣8）。
- 硬门槛（不合格直接淘汰）：市值 20-300亿、换手 5%-30%、非一字板、近一年涨停≥3次、股性≥35分。
- 核心池（最严，重点跟踪）：今日涨停 + 板块涨停≥2只 + 连板≥2 + 换手10-30% + 市值20-100亿 + 年涨停≥5次 + 股性≥50分。
- 断板观察区：近5日涨停但今日未封板的，单列不进买入池（课件：断板属超跌反弹，不做）。
- 分档：真龙≥80 / 潜力70-79 / 观察60-69 / 备选<60。
附带工具：提取其它课件文字
"$PY" "<SKILL_DIR>/scripts/extract_ppt.py" "<你的课件.pptx>"
用 python-pptx 递归遍历（必须处理 group 形状 shape_type==6，否则漏掉关键页），输出每页文字与表格。
第二课/第四课尚未做成技能时，可先用它提取课件再补指标。
数据源（已验证可用，勿改）
> 脚本 v2.0.0。所有接口均走自建 https 连接 + curl 兜底，market_breadth() 内部已做自动降级，不要改回单一数据源。
| 源 | 状态 | 说明 |
|---|---|---|
涨停池 push2ex.eastmoney.com/getTopicZTPool |
✅ | 直接给 lbc连板数、hs换手、ltsz流通市值、hybk行业、zttj涨停统计。支持历史日期，可回溯多日建候选池 |
跌停池 push2ex.eastmoney.com/getTopicDTPool |
✅ | 同路径同参数风格 |
指数 push2.eastmoney.com/api/qt/ulist.np/get |
✅ | secids=1.000001,0.399001,0.399006 |
K线 money.finance.sina.com.cn/.../CN_MarketData.getKLineData |
✅ | 前复权，datalen≤1000，volume 单位股 |
全市场涨跌家数（首选） push2.eastmoney.com/api/qt/clist/get |
⚠️ 时通时断 | 本环境常被拦截；拿不到就自动降级到新浪 |
全市场涨跌家数（兜底） vip.stock.finance.sina.com.cn/...Market_Center.getHQNodeData |
✅ | node=hs_a，每页500条、并发8线程拉24页 ≈ 全市场5400+只。GBK 编码，必须转码 |
问财 OpenAPI（可选增强） openapi.iwencai.com/v1/query2data |
✅ 需 Key | 环境变量 IWENCAI_API_KEY（已写入 ~/.bash_profile）。提供涨停原因/题材标签与「几天几板」「开板次数」，热点聚类质量明显优于东财 hybk。没 Key 也能跑，只是题材列退化成行业 |
涨跌幅自适应：主板10% / 创业板300·301、科创板688·689 20% / 北交所4·8·920开头 30% / ST 5%，判定取 limit×0.97 留舍入余量（课件第133页）。
已踩过的坑（改动时勿回退）
json.loads可能返回None（新浪对无效代码返回字面量null），必须先isinstance(raw, list)判空，否则并发里抛TypeError: 'NoneType' is not iterable中断整个 run。- 涨停池
date要按日历日往前试：周末/节假日无数据，脚本往前试 12 天取第一个有数据的日子当"今日"。 - 涨跌停阈值自适应：创业板300/301、科创板688/689 为 20%，ST 为 5%，主板 10%；判定取
limit×0.97留舍入余量。 --out必须用 Windows 绝对路径：Git Bash 的/tmp与C:\tmp不是同一处。- 并发 10 线程拉 250 根 K 线，278 只约 20-30 秒；调太高会被新浪限流返回 null。
- 写脚本用 Write 工具，不要用含中文的 heredoc（可能被截断乱码）。
股性评分说明（必须向用户讲清）
同花顺官方股性评分无公开接口，脚本用本地近似算法：
min(40, 涨停次数×6.5) + min(18, 最大连板×5) + min(15, 日均振幅×3.5) + min(12, 阳线占比×12)
已按课件示例校准：0次涨停≈10分、6次涨停≈68分（课件截图：股性10分/涨停0次；股性69分/涨停6次）。
回复用户时必须说明这是近似值，建议用同花顺个股诊断复核。
每日自动更新（可选）
用 automation_update 建一个 recurring 任务即可，rrule：
FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR;BYHOUR=15;BYMINUTE=30（周一至周五 15:30，收盘后跑数据最稳）。
任务命令模板：
bash -lc 'source ~/.bash_profile 2>/dev/null; python3 "<SKILL_DIR>/scripts/xunlongjue.py" --out "<输出目录>" --json'
> 必须用 bash -lc（或先 source ~/.bash_profile）：同花顺问财的 IWENCAI_API_KEY 通常写在
> ~/.bash_profile，裸 bash 环境读不到，题材标签会整列缺失。纯 Python 标准库运行，无 pip 依赖。
>
> ⚠️ 血泪坑：传给 bash -lc 的命令串外层必须单引号。
> 写成 bash -lc "...; PY=python3; \"$PY\" ..." 时，外层 shell 会先把 $PY 展开
> （定时任务会话里该变量未定义 → 展开成空字符串），bash 收到的是空命令 →
> bash: line 1: : command not found → 退出码 127，每次定时执行第一步必挂。
> 若确实需要中间变量，只能定义在单引号内部。
>
> 非交易日无需特殊处理：脚本自动往前取最近一个有数据的交易日，不会报错；但回复要写明实际数据日期。
关联
- 第二课《震龙躯》洗盘判定 →
zhaoyun-lesson2-zhenlongqu/zhaoyun-course-stock-analysis - 第三课《点龙睛》连板主升 →
zhaoyun-lesson3-dianlongjing、zhushenglang-juejinchi-zhiyue - 第五课《定龙时》分时狙击 →
zhaoyun-lesson5-dinglongshi - 第一课选出票后，可用第二/三课脚本对单票做深度判定。
