serenity-bottleneck-hunter

给定一个投资主题/趋势,复用交易者 Serenity(@aleabitoreddit)的"供应链瓶颈逆向映射"方法论,独立挖出被市场忽视的上游瓶颈股(而非分析他已喊过的标的)。当用户给出一个主题(如"AI 数据中心电力""人形机器人""HBM 内存")并想要候选标的+论证时使用。仅供研究教育,非投资建议。

Zur Installation springen

Repository: Mrjie7205/serenity-bottleneck-hunter
Letzte Quellaktivität: 6. Juli 2026 um 07:29
Erkannte Sprache von SKILL.md: Chinesisch
Sterne: 385
Forks: 70

Installationsoptionen

Standardmäßig ist der Prompt ausgewählt, der zuerst die Quelle prüft. Sie können zu einem direkten Befehl wechseln oder eine lokale Kopie herunterladen.

Mit Codex oder Claude installieren Kopieren Sie diesen Prompt, fügen Sie ihn in Codex, Claude oder einen anderen Assistant ein und lassen Sie die Skill-Seite prüfen und installieren.

Ein direkter Befehl überspringt den Prüf-Prompt. Prüfen Sie die Quelle, bevor Sie ihn ausführen.

npx skills add https://github.com/Mrjie7205/serenity-bottleneck-hunter --skill serenity-bottleneck-hunter

Der Befehl bleibt in einer Zeile. Scrollen Sie horizontal, um ihn vor dem Kopieren vollständig zu prüfen.

Sie bevorzugen eine lokale Kopie? Laden Sie die Dateien herunter, die SkillsMP derzeit vorliegen.

Quelldateien prüfen

Lesen Sie SKILL.md und alle von SkillsMP angezeigten Begleitdateien, bevor Sie sich für eine Installation entscheiden.

SKILL.md

Quellanweisungen · Schreibgeschützte Vorschau

Zurück zur Suche Zurück zur Installation

SKILL.md

Quellanweisungen · Schreibgeschützte Vorschau

name	serenity-bottleneck-hunter
description	给定一个投资主题/趋势,复用交易者 Serenity(@aleabitoreddit)的"供应链瓶颈逆向映射"方法论,独立挖出被市场忽视的上游瓶颈股(而非分析他已喊过的标的)。当用户给出一个主题(如"AI 数据中心电力""人形机器人""HBM 内存")并想要候选标的+论证时使用。仅供研究教育,非投资建议。

Serenity Bottleneck Hunter

把一个投资主题转成一份被忽视的上游瓶颈候选股名单 + 论证 + 目标价/时间框架。核心不是抄 Serenity 的票,而是复用他的逻辑去选新股。

📓 每条纪律是怎么用一次真实翻车换来的,见 reference/lessons.md。本文件只讲"做什么";完整事故复盘在那边,用 〔… → lessons.md#锚点〕 指过去。

何时用

用户给出一个主题/趋势,想要"沿这个方向能买什么"。
用户给一个上游环节/材料,想找对应的瓶颈公司。
❌ 不要用于:已知标的的纯财务分析、抄作业式"他买了啥"。

核心理念

逆向拆解供应链,在机构与分析师发现之前,埋伏那个无人察觉的上游瓶颈,用催化剂兑现。 alpha 来自"早于机构发现主题",不是抄到最低点。

工作流(7 步)

Step 1 · 确认资本开支确定性 这个主题的钱为什么"一定"会花?规模、周期多长?需求确定性 > 个股故事性。先归类:Bottleneck(瓶颈)/ Disruption(颠覆)/ Evolution(演进)?(本 skill 主攻 Bottleneck)

标明需求来源:政府/国防(节奏慢、看订单与预算周期)还是商业(超大规模厂商 capex、节奏快)?二者估值锚与择时节奏不同,Step 6/7 据此调整。

Step 2 · 逆向拆链 + 广扫纪律(5 层产业链 + 跨主题 root + 可选第 6 层独有 IP) 列出 5 层 从下游到上游:下游对照 → 中游系统 → 中游器件 → 上游设备 → 上游材料/代工。跳过人人都盯的下游龙头。

必做"广扫供应商":除最上游材料层外,单独再搜一轮该主题的子系统/器件/卖铲子供应商,否则漏 ④ 原型标的。〔教训:商业航天漏 Redwire → lessons.md#redwire〕
广扫颗粒度:覆盖 5 层,每层至少 2-3 个标的。广扫不到位 ≠ 板块没机会 —— 停手前先问"是真没机会,还是没扫够"。〔教训:800VDC 6 只→15 只才挖出 STM → lessons.md#breadth-stm〕
跨主题 root 节点:ARM / CDNS / SNPS 放在 chain-viz 上方独立的"跨主题 root"小卡片,显示一次,不画进每个主题的产业链层(三家是所有芯片设计驱动主题共用的根)。〔教训:7 份报告 IP/EDA 层 100% 重复 → lessons.md#ip-eda-root〕
```
<div class="cross-theme-root">
  <span class="label">跨主题 root(芯片设计驱动主题共用)</span>
  ARM ⭐⭐ + CDNS ⭐⭐ + SNPS ⭐⭐
</div>
```
其 ⭐⭐ 状态来自 tracking/cross_theme_index_snapshot.csv,不每个主题重画。
可选第 6 层 · 主题独有 IP/EDA 玩家(仅当主题真有独立玩家才画):
- 自动驾驶 L4 → 真有独立 IP:MBLY(Mobileye 授权给 BMW/Audi/Geely)— 必须画
- 个人 AI PC → ARM 在 PC 是真单源(Apple M + Qualcomm Snapdragon X + AMD AI300)— 保留画在产业链顶层 + 标本主题真单源
- AI Agent / 物理 AI / AMR → 无独立 IP 玩家 → 不画第 6 层,root section 提一次即可
- MLCC / 800VDC / 商业航天 → 不依赖芯片设计,完全跳过 IP/EDA
- 凑数禁令:没有真独立玩家的主题不强制画第 6 层 —— IP/EDA 是 optional 不是 mandatory。
A 穷尽性 · 已知玩家全集:每个主题开扫前先列已知玩家全集(全球+全市场,涵盖上市/私有/被并购),逐一显式标记 covered / private(跳过+原因)/ acquired(标合并实体)/ delisted / untracked(EODHD/yfinance 无数据)。不允许"默认遗漏",不允许"我扫了 5 家就够了"。写在报告底部"已知玩家全集 audit"块。〔示例:L4 LiDAR 全集枚举 → lessons.md#player-census〕
A+ ETF audit(强制工具化兜底):A 项"凭记忆列全集"不够,会漏主仓玩家。 每个新主题开 forward_picks 扫描前,必跑 python scripts/theme_etf_coverage.py --etfs <ETF1>,<ETF2>,... --theme "<主题名>" → 拉主题 ETF top 25 持仓、与 forward_picks diff、输出 tracking/_etf_audit_<theme>.json。对每只 new candidate 人工判定产业链层 + 原型 + 是否纳入;top 25 持仓 100% 必 audit(主仓占权重 >70%,小权重 me-too 可跳)。〔教训:Dogfood #10 漏 PANW/CRWD 等 34 只、covered 率 50% → lessons.md#etf-audit〕
- 主题 ETF 映射:
  - AI Agent / SaaS / Software → IGV + WCLD + AIQ
  - 网络安全 → CIBR + BUG + HACK
  - 半导体 → SOXX + SMH + PSI
  - AI 算力/GPU → AIQ + BOTZ
  - 网络/算力基础设施 → WCLD + CLOU + SKYY
  - 物理 AI 机器人 → BOTZ + ROBO + IRBO
  - 自动驾驶 → DRIV + IDRV
  - 电网/能源 → GRID + XLU + URNM
  - 清洁能源/电气化 → ICLN + LIT + KARS
  - 国防/航天 → ITA + XAR + UFO
  - 5G / 通信 → FIVG + NXTG
  - 数据中心 / 算力 → DTCR + CLOU + SRVR
- 报告 audit section 必列:① ETF 清单 ② ETF top 持仓全集数 ③ covered/private/跳过原因逐一分类 ④ ETF coverage %。< 80% 必须诚实标"穷尽性纪律未达标"。
- 注:A 股无 stockanalysis ETF 持仓数据 → 改用申万行业指数成分 + 人工列已知玩家全集。
A++ ticker 双向验证(强制):广扫前用 EODHD search 反查"代码 → 公司名"双向验证——A 项穷尽 + A+ ETF audit 都不防"错标"(标对公司名但 ticker 指向另一家)。每只候选必验:
```
curl "https://eodhd.com/api/search/<COMPANY_NAME>?api_token=$KEY&fmt=json"
curl "https://eodhd.com/api/search/<TICKER>?api_token=$KEY&fmt=json"
```
→ 两次返回的 Name 必须一致。禁止凭记忆写 ticker,哪怕"我很确定"也必须 search。A 股尤其踩坑:6(沪市)/ 0(深市)/ 3(创业板)/ 688(科创板)/ 002(中小板)代码段交叉,同 5 位数字可能是不同公司。工具:scripts/ticker_truth.py(ground-truth 库)+ scripts/verify_tickers.py(git pre-commit hook 自动拦截)。验证通过才写入 scan*.py。 〔教训:绿的谐波/信质电机/ASEKY/EHGO 共 4 个真错位 → lessons.md#ticker-verify〕
公司状态检查(写判定前必查):每只候选(含链路图非候选节点)搜一次当前状态——收购/被收购/私有化/IPO 上市/退市/破产重组(搜 <公司名> acquisition/IPO/merger)。收购中的标的 🔴 剔除(被收购反向验证选股方向、记进报告当佐证)。"私有/不可投"是状态性断言,LLM 的"某某私有"先验是训练快照、极易过期,必须当场搜证,状态写进 company_desc 带日期的 status 字段。〔教训:SkyWater 被 IonQ 收购 + SpaceX IPO 当天报告还标"私有" → lessons.md#company-status〕
私有公司诚实跳过:每个主题都有"真单源但私有/子部门"的标的。禁止为凑标的硬塞不纯/不可投的公司;在报告里显式列"已识别但跳过的瓶颈 + 原因"(本身就是高密度信号)。例:物理 AI 六维力传感器(坤维/字节灵犀/宇立全私)、鼎智科技(北交所 EODHD 不支持)→ 跳过。坦诚标"无干净纯 play"比硬凑更有价值。
主题边界声明:跑大类主题(物理 AI / AI 算力 / 能源转型)时,报告顶部必须界定本期边界 —— 大类下常有 3+ 个供应链差异显著的子领域,显式说"本期聚焦 X,其他子领域作为独立专题分批跑"。命名:<大类>_<子领域>_完整分析报告.html。〔教训:物理 AI v1 默认=人形 → lessons.md#theme-scope〕

Step 3 · 对每层套「9 大瓶颈原型」(详见 reference/supply-chain-and-archetypes.md Part D): ①上游材料/衬底垄断 ②单一来源卡脖子 ③产能售罄/已锁定=去风险 ④进每个设计的BOM/普适 ⑤估值对标套利 ⑥测试/设备瓶颈 ⑦冷门/前机构 ⑧巨头依赖护城河 ⑨宏观二阶/错杀。命中原型越多的环节,越是猎区。

Step 4 · 产出候选(偏上游、冷门、小市值) 每个环节挑 1-3 家最纯正的公司。优先:小市值、卖方覆盖少、散户没听过(原型⑦)。用 EODHD search 校验代码与上市地(含海外,见 A++ 纪律)。

别只押"最上游材料咽喉(①②)":也纳入"普适器件/卖铲子(④)"——两档都列,避免选股偏科。
最纯的瓶颈常在海外/OTC(如 5N Plus 在 TSX、Umicore 在布鲁塞尔)→ 主动去海外交易所找,注明流动性/准入限制。
若瓶颈落在私有公司或大公司的一个部门 → 必须给"暴露路径":买含该业务的母公司(说明稀释/纯度),或如实标"无干净纯 play、跳过"。不硬凑不纯标的充数。
跨主题节点检查(强制):产出候选后立即跑 python tracking/cross_theme_scan.py,与历史 forward_picks.csv 对照:
- 同 symbol 跨 ≥2 主题 = ⭐;≥3 = ⭐⭐(罕见,真"非线性定价权")。
- 档位过滤防巨头摊薄误标:中游系统/下游对照/反面参照不计入;中游卖铲子必须有 ④ 普适才计入。
- ⭐ 节点在 Step 5"前机构"闸门自动加分(多个 capex cycle 同时驱动 = 产能压力叠加、即使有机构覆盖仍可能 mispriced)。
- eodhd_symbol 规范:美股一律带 .US 后缀,否则脚本无法匹配同一只。〔首测案例 AEHR 跨双主题 → lessons.md#cross-theme-aehr〕

Step 5 · 三道闸门逐一检验

🔒 真瓶颈:产能受限/有定价权/短期无法绕过("别人能 1-2 年内绕过吗?")
👁️ 前机构:卖方研报少、机构持仓低、市值小;⭐ 跨主题节点自动加分
💰 便宜+已去风险:估值压抑 + 产能/订单锁定或现金充足

Step 6 · 入场时机(见下方两套模式,别搞错)

Step 7 · 出报告(单文件 HTML,用下方输出模板 + reference/report_template.html,含目标价+时间框架+反向研究+证伪条件+风险+免责)→ 交付前必过 scripts/verify_report.py 契约校验(见下方"交付契约")

入场时机:两套模式(经价格回测校准,勿混用)

模式	适用	触发
A 主题瓶颈长线(本 skill 默认)	主题里的上游瓶颈股	主题刚点燃 + 早期上行/突破 + 仍前机构就进,主动放弃抄底。等回调=踏空。
B 波段超跌反弹	成熟大票的非实质性错杀	买恐慌回调(增发/稀释类实质利空则回避)

回测依据(11 只光子学标的):首 call 多在前 6 月区间 86%-237% 高位入场,之后 2-6 个月中位 ~+277%。→ 早于主题、容忍不抄底才是 alpha 来源(注:此为逻辑自洽校准,非业绩,见"验证状态")。

判定二轴(2026-06-21 核心修正):水位 ≠ 判定。 高水位(rng 高、贴顶)不再自动 = 🟡——单看水位是「均值回归」伪装成「动量」,会系统性把热门板块的真龙头判成"别追"、错过最大涨幅(闪迪式 melt-up)。判定必须叠加第二轴:这波涨基本面跟不跟得上——price.py 的 valuation() 出 forward P/E / PEG / 盈利&营收增速,扫描算 RS-rank(同主题内 3 月动量排名),Step 1 出周期 runway(早/中/晚)。render_report 标尺自动显示第二轴 + 给 hint:

	基本面跟得上(forward P/E 压缩 / PEG≤2 / 盈利增速≥涨幅 / RS 领头 / 周期早)	跟不上(纯重估 / forward P/E 扩张 / 周期晚 / RS 落后)
高水位(贴顶)	🟢 贵但对——动量龙头,Mode A 持有/可加,别 fade	🔴 真贴顶——再涨是博傻,回避
低水位	🟢 经典埋伏(Mode A 早 / Mode B 超跌)	🔴 落后有原因,排除

A股 forward/PEG 常缺(yfinance 估计覆盖薄)→ 退化用"盈利/营收增速 vs 涨幅"+ RS;标尺显示"—"即数据缺、不强判。limit:顶 vs 续涨本质难判,二轴只 tilt 概率、不根治,新规则对不对靠 L1 向前跟踪校准。〔教训:水位标尺均值回归伪装动量、系统性反龙头 → lessons.md#water-level-2axis〕

价格纪律(硬规则):

强制用 scripts/price.py 拉真实价格(provider 自动回退:EODHD(EODHD_API_KEY)→ yfinance),输出 6 月区间位置、距高点、近 1/3 月动量、stage 标签。严禁 WebSearch 抓价格、严禁凭印象猜 early/extended——猜测 = 流程错误。海外股若 yfinance 拿不到,让用户提供 EODHD key 或换可解析代码重跑,不降级为定性。
批量拉价必须走 price.py 接口:python -c "from scripts.price import analyze; print(analyze('6324.T'))" 或脚本里 from scripts.price import fetch_history。禁止 inline Invoke-RestMethod 调 EODHD(绕过 yfinance fallback)。〔教训:物理 AI v1 漏 4 只日股 → lessons.md#price-interface〕
报告所有数字 100% 来自 price.py 输出,禁止手填/猜数:批量 scan 脚本输出必含全 9 字段(last / range_pos_6mo_pct / pct_off_6mo_high / ret_1m_pct / ret_3m_pct / above_sma50 / stage + high/low_6mo)+ 保留完整 log;写入 forward_picks 前逐字段 verify。〔教训:手填 9 个 off% 全错(HSAI -89% 真 -35.6%)→ lessons.md#hand-filled〕

输出模板(HTML)

交付物 = 一个自包含 HTML 文件(单文件、样式内联,仅 Google Fonts 可外链),写到 reports/<主题>_分析报告.html。骨架与配色复用 reference/report_template.html。生成后 Start-Process <file>.html(Win)/ open(mac)打开。

生成方式(硬规则):报告必须用 scripts/render_report.py 渲染——agent 只写一个薄「主题 SPEC」(纯数据:候选 / §A§B / 产业链节点+依赖边 / 文字;示例 tracking/_gen_mlcc_report.py),引擎负责:克隆最近一份合格报告的完整外壳(CSS + reveal/术语/chain-draw 脚本)、拉 scan 价(零手填)、渲染真 chain-viz(.cnode+.edge-list 喂 layoutChain 自动绘制判瓶颈)、水位标尺三价、§A 红队 + §B 证伪、写 forward_picks。严禁绕过引擎手搓 HTML / 画静态简版 chain-viz——引擎是唯一路,产出过 verify_report by construction。因预算/复杂度砍任何既定标准,当场说明、不把缩水版当完整品交。〔教训:契约≠保真,把"过自己造的闸"当"做好了" → lessons.md#chain-viz-fidelity〕

report_template.html 已内置的模板特征(生成时必用):① 本次行动点——头条位最多 2 张行动卡(设什么警报 / 什么条件做什么),无视排序置顶,读者 10 秒拿到本次唯一要做的事;② 水位标尺——动量用贴顶/高位/中位/低位/贴底 + 距高点% + 1m/3m 的人话化标尺,且标尺两端标 6 个月最低/最高价、游标上方标现价(6 月低/高/现价三价,币种按交易所后缀);③ 产业链双规则瓶颈判定——漏斗型(入度≥2 出度≤1,金边)+ 枢纽型(入度≥2 出度≥2,多对多最难绕开,酒红边);④ 判定史——同标的历史判定(旧价→今价 ±%、对错复盘),体现框架连续性与诚实度;⑤ §A 红队 + §B 证伪——每候选折叠红队、🟢 带证伪(本次 Tier-1 新增,见上)。

交付契约(`scripts/verify_report.py`,交付前必过)

报告写完、宣布完成之前必跑一次,把"漏交付/漏状态/漏入库"挡在交付前:

EODHD_API_KEY=… python scripts/verify_report.py reports/<主题>_分析报告.html

它查契约(不查思路):区块齐全(chain-viz / leaderboard / 行动点 / 三道闸 / 免责)· 每候选有 §A、🟢 有 §B · 标尺三价齐 · ticker 过 ground-truth · 现价/6月低/高逐字段对账 scan JSON(防手填/过期)· 状态断言带日期(过期 30 天提醒)· 每判定入轨 forward_picks 且 🟢 的 invalidation 非空 · 无占位符残留 · <details> 开合平衡。有【拦】先修再交付,只剩【警】方可交付。

报告必含区块(对应 7 步,所有项 hard rule 不允许跳过):

页眉 + 一句话结论:主题 | 资本开支确定性 | 类别 | 数据截止日 | 价格源 | 免责。
30 秒看懂这个主题(150-220 字大白话,hero 之后、Step 1 之前,class .thirty-sec)。
Step1 资本开支确定性:为什么钱一定花 + 需求来源。
核心发现 callout:最该被先看到的那句(瓶颈在哪层、有没有干净纯 play)。
⚠ Step2 逆向拆链(网状视图)— 强制必含:每个子主题供应链都不同,禁止以"前面画过类似的"为由跳过。.chain-viz 容器 + 5 层 .chain-layer(+ 可选第 6 层独有 IP),跨主题 root 卡片在上方。每层 .cnode[data-id=...](data-id = forward_picks 一致的 eodhd_symbol,美股带 .US);供货关系写 .edge-list(data-from/to/weight 三档),JS 画 SVG + 判瓶颈点。跨主题节点加 <span class="star-inline">⭐</span>。〔教训:L4/AMR 漏此区块 → lessons.md#chain-viz-required〕
候选 leaderboard(与 forward_picks 入库解耦):
- leaderboard 显示 top 15-20(按决策相关性:🟢 优先、⭐ 节点优先、stage 健康优先;超出折叠成"其他 N 只 → forward_picks.csv")。
- forward_picks 入库无上限:广扫到的 🟢🟡🔴 全入库,不允许"为视觉舒服而漏入库"。
- 上游咽喉(①②③) 与 中游卖铲子(④⑧) 分两档,按 stage 排序(early/basing-momentum 在前)。每只必含字段:
  - 代码+现价 · 档位/是什么 · 瓶颈逻辑(命中原型#) · 估值/增长 + 稀释红旗(亏损+ATM/增发+现金跑道短=标红) · 动量条(6 月区间位置 + 1m/3m,颜色=stage) · 三档判定 🟢/🟡/🔴 · 目标价/时间框架 · .why 块(20-40 字人话) · 风险。
  - 🟢/🟡 必含「反向研究」块(见下 Tier-1 §A) · 🟢 必含「证伪条件」块(见下 Tier-1 §B) · 🟡 必含重估触发条件。
Step5 三道闸门:🔒真瓶颈 / 👁️前机构 / 💰便宜去风险,逐关诚实打分(过/半过/不过)。
跨主题信号区块:当前主题命中的 ⭐ 节点(来自 cross_theme_index_snapshot.csv)。
已知玩家全集 audit 块:列全球+全市场已知玩家,显式标 covered/private/acquired/delisted/untracked。
落地结论 + 数据备注 + 免责页脚。
底部 glossary 折叠速查表(JS 自动从 <abbr> 抽取)。

Tier-1 §A · 反向研究 / 红队(🟢🟡 候选强制,缺失或敷衍 = 报告不合格)

每个 🟢/🟡 候选必带一段红队,不许写"风险:估值高"这种套话。四问 + 一句最大杀点:

反向研究 · 杀死这个候选的最短路径
① 为什么可能不是真瓶颈?   → 谁能绕过 / 替代方案进度
② 瓶颈为什么可能不变现?   → 收入纯度 X% / 下游议价能力 / 毛利能否扩
③ 市场是否已定价?         → 【强制引用 price.py 的 off-high / 1m / 3m 数字对账,不许空谈】
④ 有没有更优替代?         → 必须点名一个对比标的 XXX.XX(且过 price.py / ticker 验证)
最大杀点(一句):________ （必须区别于"估值高/竞争加剧"的通用风险）

牙齿:③ 必须引用我们已拉到的 9 字段数字(off/1m/3m 就在 scan JSON 里,逼对账);④ 必须点名一个真实存在、可验证的对比 ticker。

Tier-1 §B · 证伪条件(🟢 候选强制)

每个 🟢 必带 2-4 条具体可检验的"什么会证明我错了",至少一条是价格/stage 机器可读(供 score_tracker 自动监控):

证伪条件(满足任一即承认判断错):
· 价格/stage:跌破 ¥X(entry)且 1m 转负        ← 机器可检,写进 forward_picks 的 invalidation 列
· 基本面:下季度订单/backlog 未随主题增长
· 估值:涨到 PS > 行业 +1σ 但毛利未扩

牙齿 + 闭环接口:至少一条要能落成机器规则(stop 价 / stage 失效),写进 forward_picks.csv 的 invalidation 列;score_tracker 重拉价时自动检查"证伪触发没有"。没有证伪条件的 🟢 = 故事不是投资假设。

目标价/时间框架:给情景区间 + 时间框。⚠️ 基准率随主题而变,切勿套用光子学数字:高 beta 快速点燃(光子学 2-6 月 +150~~1000%)vs 慢周期政府驱动(航天/电网 1-3 年 +30~~150%)完全不同。按当前主题 beta 与催化剂节奏设定,显式标"情景非承诺、有幸存者偏差"。
三档判定:每只必标 🟢/🟡/🔴(详见 methodology.md §7)。
- 🟡 必填重估触发条件(价格点/财报指标/公司动作/政策事件)。
- 🔴 极度克制:只用于商业模式作假/欺诈/业务死亡/个人原则。严禁"历史事件式硬排除"——"曾经重组/增发过"是过期信息,"1m 涨太多"是 stage 问题(降 🟡 等回调)。例:$WOLF 重组后是 NewCo,业务逻辑可独立评估 → 🟡 观望 + trigger,不永久排除。
可读性纪律:语义化三档配色(🟢green/🟡amber/🔴red)、动量条让"谁已抛物线"一眼可见、清爽留白。
术语友好度:① 顶部"30 秒看懂"块;② 每个 🟢/🟡 候选加 .why 一行(20-40 字人话);③ 专业缩写首次出现用 <abbr title="中文解释">缩写</abbr>,来源 reference/glossary.md(120+ 条),新术语先 append 再用;④ 底部 <details class="glossary-section"> 折叠速查表,JS 自动从 <abbr> 抽取。

页脚必带:⚠️ 仅供研究教育,非投资建议;估值为网页研究近似值需复核;微盘/诉讼/海外标的风险极高。

数据来源与边界

价格/动量(择时):统一走 scripts/price.py,自动回退 ① EODHD(EODHD_API_KEY)→ ② yfinance → ③ 都失败=报错退出。Key 从环境变量读、不硬编码。WebSearch 仅用于公司基本面/定性研究,不用于抓价格。
EODHD 取不到:fundamentals(估值/增长/毛利率/市值)、screener、财报日历 → 用网页研究逐只补。
瓶颈/单源/产能/客户等定性判断:靠财报+行业资料+新闻研究。

参考文件

reference/lessons.md —— 翻车档案 / 纪律的由来(每条纪律对应一次真实事故,SKILL.md 用 〔… → lessons.md#锚点〕 指向)
reference/methodology.md —— 完整方法论(理念、筛选清单、两套择时、回避清单、风险)
reference/supply-chain-and-archetypes.md —— 元框架、产业链速查表、Part D 9 大瓶颈原型库、EODHD 数据映射
reference/report_template.html —— HTML 报告骨架 + 配色模板
scripts/render_report.py —— 报告统一渲染引擎(克隆合格报告外壳 + 数据驱动渲染真 chain-viz / 标尺三价 / §A§B / forward_picks;agent 只写薄主题 SPEC,示例 tracking/_gen_mlcc_report.py)
scripts/verify_report.py —— 交付契约 linter(报告生成后必跑;查区块齐全 / §A§B / 标尺三价 / 价格对账 scan / 入轨 forward_picks / 真 chain-viz / 揭示类脚本 / 占位符,有【拦】先修再交付)
reference/example_commercial_space.md —— worked example(商业航天),示范分析内容与颗粒度
reference/glossary.md —— 术语库(120+ 条,LLM 自动 enrich);报告 <abbr> 注释来源
reference/company_desc.md —— 公司业务描述库:只存 business(主营/产业链位置/技术/客户),严禁含 price/stage/估值等动态数据。格式 - **SYM.EX** [YYYY-MM-DD] = 业务描述,每条带 last_updated 时间戳。
- 拆分:🟢 business(本文件 + .cnode[data-desc=],带时间戳)/ 🔴 status(.cnode[data-status=],price/stage,每次重写带 [YYYY-MM-DD])。
- 90 天 freshness:用 data-desc 前查 last_updated,≤90 天直接复用,>90 天重新评估战略漂移(有变更新+bump,无变只 bump)。工具 tracking/check_desc_freshness.py。〔三次迭代史 → lessons.md#company-desc-evolution〕
reference/ticker_truth.csv + reference/TICKER_HYGIENE.md —— ticker ground-truth 库 + L1/L2/L3 防御文档
tracking/forward_picks.csv —— 向前(样本外)跟踪表(带 invalidation 证伪列)
tracking/score_tracker.py + tracking/theme_benchmark.csv —— Alpha 打分(🟢-vs-🔴 内部对照为主、vs 主题 ETF/大盘为辅)
tracking/cross_theme_scan.py + tracking/cross_theme_index_snapshot.csv —— 跨主题节点扫描(Step 4 末尾强制跑)+ 快照

验证状态(诚实说明)

逻辑自洽性(已做,非业绩回测):套到 Serenity 研究过的"AI 光子学"能重建其名单(AXTI/SIVE/LITE/TSEM/SOI/IQE/AEHR…);套到他没碰过的"AI 电力散热"能独立挖出 $CLF(GOES 电工钢独家)、$CC(浸没冷却液单源);"商业航天"挖出 $VNP/5N+($MTRN)。→ "拆链 + 原型"逻辑能指向真实瓶颈公司。
⚠️ 这不是业绩回测:此前"光子学首 call 后 +X%"存在选股循环论证(用已知赢家倒推)、幸存者偏差、峰值未来函数,不能当收益预期。
唯一可信的是向前(样本外)验证 + Alpha:对当下产出的候选,记录"建议日 + 当时价 + 事先定死的进出场/证伪规则",日后用 score_tracker 重拉价。关键纪律:量 Alpha = 标的收益 − 主题 ETF 同期收益(牛市里随便选上游小票也涨,raw return 看不出选股有没有 alpha);最硬的检验是 🟢 篮子 vs 🔴 篮子内部对照(同主题 beta 对消,差额 = 纯选股能力)。结论出来前,输出只当研究线索,不是业绩。每次出新候选都追加进 forward_picks.csv。

name	serenity-bottleneck-hunter
description	给定一个投资主题/趋势,复用交易者 Serenity(@aleabitoreddit)的"供应链瓶颈逆向映射"方法论,独立挖出被市场忽视的上游瓶颈股(而非分析他已喊过的标的)。当用户给出一个主题(如"AI 数据中心电力""人形机器人""HBM 内存")并想要候选标的+论证时使用。仅供研究教育,非投资建议。

Serenity Bottleneck Hunter

把一个投资主题转成一份被忽视的上游瓶颈候选股名单 + 论证 + 目标价/时间框架。核心不是抄 Serenity 的票,而是复用他的逻辑去选新股。

📓 每条纪律是怎么用一次真实翻车换来的,见 reference/lessons.md。本文件只讲"做什么";完整事故复盘在那边,用 〔… → lessons.md#锚点〕 指过去。

何时用

用户给出一个主题/趋势,想要"沿这个方向能买什么"。
用户给一个上游环节/材料,想找对应的瓶颈公司。
❌ 不要用于:已知标的的纯财务分析、抄作业式"他买了啥"。

核心理念

逆向拆解供应链,在机构与分析师发现之前,埋伏那个无人察觉的上游瓶颈,用催化剂兑现。 alpha 来自"早于机构发现主题",不是抄到最低点。

工作流(7 步)

标明需求来源:政府/国防(节奏慢、看订单与预算周期)还是商业(超大规模厂商 capex、节奏快)?二者估值锚与择时节奏不同,Step 6/7 据此调整。

必做"广扫供应商":除最上游材料层外,单独再搜一轮该主题的子系统/器件/卖铲子供应商,否则漏 ④ 原型标的。〔教训:商业航天漏 Redwire → lessons.md#redwire〕
广扫颗粒度:覆盖 5 层,每层至少 2-3 个标的。广扫不到位 ≠ 板块没机会 —— 停手前先问"是真没机会,还是没扫够"。〔教训:800VDC 6 只→15 只才挖出 STM → lessons.md#breadth-stm〕
跨主题 root 节点:ARM / CDNS / SNPS 放在 chain-viz 上方独立的"跨主题 root"小卡片,显示一次,不画进每个主题的产业链层(三家是所有芯片设计驱动主题共用的根)。〔教训:7 份报告 IP/EDA 层 100% 重复 → lessons.md#ip-eda-root〕
```
<div class="cross-theme-root">
  <span class="label">跨主题 root(芯片设计驱动主题共用)</span>
  ARM ⭐⭐ + CDNS ⭐⭐ + SNPS ⭐⭐
</div>
```
其 ⭐⭐ 状态来自 tracking/cross_theme_index_snapshot.csv,不每个主题重画。
可选第 6 层 · 主题独有 IP/EDA 玩家(仅当主题真有独立玩家才画):
- 自动驾驶 L4 → 真有独立 IP:MBLY(Mobileye 授权给 BMW/Audi/Geely)— 必须画
- 个人 AI PC → ARM 在 PC 是真单源(Apple M + Qualcomm Snapdragon X + AMD AI300)— 保留画在产业链顶层 + 标本主题真单源
- AI Agent / 物理 AI / AMR → 无独立 IP 玩家 → 不画第 6 层,root section 提一次即可
- MLCC / 800VDC / 商业航天 → 不依赖芯片设计,完全跳过 IP/EDA
- 凑数禁令:没有真独立玩家的主题不强制画第 6 层 —— IP/EDA 是 optional 不是 mandatory。
A 穷尽性 · 已知玩家全集:每个主题开扫前先列已知玩家全集(全球+全市场,涵盖上市/私有/被并购),逐一显式标记 covered / private(跳过+原因)/ acquired(标合并实体)/ delisted / untracked(EODHD/yfinance 无数据)。不允许"默认遗漏",不允许"我扫了 5 家就够了"。写在报告底部"已知玩家全集 audit"块。〔示例:L4 LiDAR 全集枚举 → lessons.md#player-census〕
A+ ETF audit(强制工具化兜底):A 项"凭记忆列全集"不够,会漏主仓玩家。 每个新主题开 forward_picks 扫描前,必跑 python scripts/theme_etf_coverage.py --etfs <ETF1>,<ETF2>,... --theme "<主题名>" → 拉主题 ETF top 25 持仓、与 forward_picks diff、输出 tracking/_etf_audit_<theme>.json。对每只 new candidate 人工判定产业链层 + 原型 + 是否纳入;top 25 持仓 100% 必 audit(主仓占权重 >70%,小权重 me-too 可跳)。〔教训:Dogfood #10 漏 PANW/CRWD 等 34 只、covered 率 50% → lessons.md#etf-audit〕
- 主题 ETF 映射:
  - AI Agent / SaaS / Software → IGV + WCLD + AIQ
  - 网络安全 → CIBR + BUG + HACK
  - 半导体 → SOXX + SMH + PSI
  - AI 算力/GPU → AIQ + BOTZ
  - 网络/算力基础设施 → WCLD + CLOU + SKYY
  - 物理 AI 机器人 → BOTZ + ROBO + IRBO
  - 自动驾驶 → DRIV + IDRV
  - 电网/能源 → GRID + XLU + URNM
  - 清洁能源/电气化 → ICLN + LIT + KARS
  - 国防/航天 → ITA + XAR + UFO
  - 5G / 通信 → FIVG + NXTG
  - 数据中心 / 算力 → DTCR + CLOU + SRVR
- 报告 audit section 必列:① ETF 清单 ② ETF top 持仓全集数 ③ covered/private/跳过原因逐一分类 ④ ETF coverage %。< 80% 必须诚实标"穷尽性纪律未达标"。
- 注:A 股无 stockanalysis ETF 持仓数据 → 改用申万行业指数成分 + 人工列已知玩家全集。
A++ ticker 双向验证(强制):广扫前用 EODHD search 反查"代码 → 公司名"双向验证——A 项穷尽 + A+ ETF audit 都不防"错标"(标对公司名但 ticker 指向另一家)。每只候选必验:
```
curl "https://eodhd.com/api/search/<COMPANY_NAME>?api_token=$KEY&fmt=json"
curl "https://eodhd.com/api/search/<TICKER>?api_token=$KEY&fmt=json"
```
→ 两次返回的 Name 必须一致。禁止凭记忆写 ticker,哪怕"我很确定"也必须 search。A 股尤其踩坑:6(沪市)/ 0(深市)/ 3(创业板)/ 688(科创板)/ 002(中小板)代码段交叉,同 5 位数字可能是不同公司。工具:scripts/ticker_truth.py(ground-truth 库)+ scripts/verify_tickers.py(git pre-commit hook 自动拦截)。验证通过才写入 scan*.py。 〔教训:绿的谐波/信质电机/ASEKY/EHGO 共 4 个真错位 → lessons.md#ticker-verify〕
公司状态检查(写判定前必查):每只候选(含链路图非候选节点)搜一次当前状态——收购/被收购/私有化/IPO 上市/退市/破产重组(搜 <公司名> acquisition/IPO/merger)。收购中的标的 🔴 剔除(被收购反向验证选股方向、记进报告当佐证)。"私有/不可投"是状态性断言,LLM 的"某某私有"先验是训练快照、极易过期,必须当场搜证,状态写进 company_desc 带日期的 status 字段。〔教训:SkyWater 被 IonQ 收购 + SpaceX IPO 当天报告还标"私有" → lessons.md#company-status〕
私有公司诚实跳过:每个主题都有"真单源但私有/子部门"的标的。禁止为凑标的硬塞不纯/不可投的公司;在报告里显式列"已识别但跳过的瓶颈 + 原因"(本身就是高密度信号)。例:物理 AI 六维力传感器(坤维/字节灵犀/宇立全私)、鼎智科技(北交所 EODHD 不支持)→ 跳过。坦诚标"无干净纯 play"比硬凑更有价值。
主题边界声明:跑大类主题(物理 AI / AI 算力 / 能源转型)时,报告顶部必须界定本期边界 —— 大类下常有 3+ 个供应链差异显著的子领域,显式说"本期聚焦 X,其他子领域作为独立专题分批跑"。命名:<大类>_<子领域>_完整分析报告.html。〔教训:物理 AI v1 默认=人形 → lessons.md#theme-scope〕

别只押"最上游材料咽喉(①②)":也纳入"普适器件/卖铲子(④)"——两档都列,避免选股偏科。
最纯的瓶颈常在海外/OTC(如 5N Plus 在 TSX、Umicore 在布鲁塞尔)→ 主动去海外交易所找,注明流动性/准入限制。
若瓶颈落在私有公司或大公司的一个部门 → 必须给"暴露路径":买含该业务的母公司(说明稀释/纯度),或如实标"无干净纯 play、跳过"。不硬凑不纯标的充数。
跨主题节点检查(强制):产出候选后立即跑 python tracking/cross_theme_scan.py,与历史 forward_picks.csv 对照:
- 同 symbol 跨 ≥2 主题 = ⭐;≥3 = ⭐⭐(罕见,真"非线性定价权")。
- 档位过滤防巨头摊薄误标:中游系统/下游对照/反面参照不计入;中游卖铲子必须有 ④ 普适才计入。
- ⭐ 节点在 Step 5"前机构"闸门自动加分(多个 capex cycle 同时驱动 = 产能压力叠加、即使有机构覆盖仍可能 mispriced)。
- eodhd_symbol 规范:美股一律带 .US 后缀,否则脚本无法匹配同一只。〔首测案例 AEHR 跨双主题 → lessons.md#cross-theme-aehr〕

Step 5 · 三道闸门逐一检验

🔒 真瓶颈:产能受限/有定价权/短期无法绕过("别人能 1-2 年内绕过吗?")
👁️ 前机构:卖方研报少、机构持仓低、市值小;⭐ 跨主题节点自动加分
💰 便宜+已去风险:估值压抑 + 产能/订单锁定或现金充足

Step 6 · 入场时机(见下方两套模式,别搞错)

入场时机:两套模式(经价格回测校准,勿混用)

模式	适用	触发
A 主题瓶颈长线(本 skill 默认)	主题里的上游瓶颈股	主题刚点燃 + 早期上行/突破 + 仍前机构就进,主动放弃抄底。等回调=踏空。
B 波段超跌反弹	成熟大票的非实质性错杀	买恐慌回调(增发/稀释类实质利空则回避)

	基本面跟得上(forward P/E 压缩 / PEG≤2 / 盈利增速≥涨幅 / RS 领头 / 周期早)	跟不上(纯重估 / forward P/E 扩张 / 周期晚 / RS 落后)
高水位(贴顶)	🟢 贵但对——动量龙头,Mode A 持有/可加,别 fade	🔴 真贴顶——再涨是博傻,回避
低水位	🟢 经典埋伏(Mode A 早 / Mode B 超跌)	🔴 落后有原因,排除

价格纪律(硬规则):

强制用 scripts/price.py 拉真实价格(provider 自动回退:EODHD(EODHD_API_KEY)→ yfinance),输出 6 月区间位置、距高点、近 1/3 月动量、stage 标签。严禁 WebSearch 抓价格、严禁凭印象猜 early/extended——猜测 = 流程错误。海外股若 yfinance 拿不到,让用户提供 EODHD key 或换可解析代码重跑,不降级为定性。
批量拉价必须走 price.py 接口:python -c "from scripts.price import analyze; print(analyze('6324.T'))" 或脚本里 from scripts.price import fetch_history。禁止 inline Invoke-RestMethod 调 EODHD(绕过 yfinance fallback)。〔教训:物理 AI v1 漏 4 只日股 → lessons.md#price-interface〕
报告所有数字 100% 来自 price.py 输出,禁止手填/猜数:批量 scan 脚本输出必含全 9 字段(last / range_pos_6mo_pct / pct_off_6mo_high / ret_1m_pct / ret_3m_pct / above_sma50 / stage + high/low_6mo)+ 保留完整 log;写入 forward_picks 前逐字段 verify。〔教训:手填 9 个 off% 全错(HSAI -89% 真 -35.6%)→ lessons.md#hand-filled〕

输出模板(HTML)

交付物 = 一个自包含 HTML 文件(单文件、样式内联,仅 Google Fonts 可外链),写到 reports/<主题>_分析报告.html。骨架与配色复用 reference/report_template.html。生成后 Start-Process <file>.html(Win)/ open(mac)打开。

生成方式(硬规则):报告必须用 scripts/render_report.py 渲染——agent 只写一个薄「主题 SPEC」(纯数据:候选 / §A§B / 产业链节点+依赖边 / 文字;示例 tracking/_gen_mlcc_report.py),引擎负责:克隆最近一份合格报告的完整外壳(CSS + reveal/术语/chain-draw 脚本)、拉 scan 价(零手填)、渲染真 chain-viz(.cnode+.edge-list 喂 layoutChain 自动绘制判瓶颈)、水位标尺三价、§A 红队 + §B 证伪、写 forward_picks。严禁绕过引擎手搓 HTML / 画静态简版 chain-viz——引擎是唯一路,产出过 verify_report by construction。因预算/复杂度砍任何既定标准,当场说明、不把缩水版当完整品交。〔教训:契约≠保真,把"过自己造的闸"当"做好了" → lessons.md#chain-viz-fidelity〕

report_template.html 已内置的模板特征(生成时必用):① 本次行动点——头条位最多 2 张行动卡(设什么警报 / 什么条件做什么),无视排序置顶,读者 10 秒拿到本次唯一要做的事;② 水位标尺——动量用贴顶/高位/中位/低位/贴底 + 距高点% + 1m/3m 的人话化标尺,且标尺两端标 6 个月最低/最高价、游标上方标现价(6 月低/高/现价三价,币种按交易所后缀);③ 产业链双规则瓶颈判定——漏斗型(入度≥2 出度≤1,金边)+ 枢纽型(入度≥2 出度≥2,多对多最难绕开,酒红边);④ 判定史——同标的历史判定(旧价→今价 ±%、对错复盘),体现框架连续性与诚实度;⑤ §A 红队 + §B 证伪——每候选折叠红队、🟢 带证伪(本次 Tier-1 新增,见上)。

交付契约(`scripts/verify_report.py`,交付前必过)

报告写完、宣布完成之前必跑一次,把"漏交付/漏状态/漏入库"挡在交付前:

EODHD_API_KEY=… python scripts/verify_report.py reports/<主题>_分析报告.html

报告必含区块(对应 7 步,所有项 hard rule 不允许跳过):

页眉 + 一句话结论:主题 | 资本开支确定性 | 类别 | 数据截止日 | 价格源 | 免责。
30 秒看懂这个主题(150-220 字大白话,hero 之后、Step 1 之前,class .thirty-sec)。
Step1 资本开支确定性:为什么钱一定花 + 需求来源。
核心发现 callout:最该被先看到的那句(瓶颈在哪层、有没有干净纯 play)。
⚠ Step2 逆向拆链(网状视图)— 强制必含:每个子主题供应链都不同,禁止以"前面画过类似的"为由跳过。.chain-viz 容器 + 5 层 .chain-layer(+ 可选第 6 层独有 IP),跨主题 root 卡片在上方。每层 .cnode[data-id=...](data-id = forward_picks 一致的 eodhd_symbol,美股带 .US);供货关系写 .edge-list(data-from/to/weight 三档),JS 画 SVG + 判瓶颈点。跨主题节点加 <span class="star-inline">⭐</span>。〔教训:L4/AMR 漏此区块 → lessons.md#chain-viz-required〕
候选 leaderboard(与 forward_picks 入库解耦):
- leaderboard 显示 top 15-20(按决策相关性:🟢 优先、⭐ 节点优先、stage 健康优先;超出折叠成"其他 N 只 → forward_picks.csv")。
- forward_picks 入库无上限:广扫到的 🟢🟡🔴 全入库,不允许"为视觉舒服而漏入库"。
- 上游咽喉(①②③) 与 中游卖铲子(④⑧) 分两档,按 stage 排序(early/basing-momentum 在前)。每只必含字段:
  - 代码+现价 · 档位/是什么 · 瓶颈逻辑(命中原型#) · 估值/增长 + 稀释红旗(亏损+ATM/增发+现金跑道短=标红) · 动量条(6 月区间位置 + 1m/3m,颜色=stage) · 三档判定 🟢/🟡/🔴 · 目标价/时间框架 · .why 块(20-40 字人话) · 风险。
  - 🟢/🟡 必含「反向研究」块(见下 Tier-1 §A) · 🟢 必含「证伪条件」块(见下 Tier-1 §B) · 🟡 必含重估触发条件。
Step5 三道闸门:🔒真瓶颈 / 👁️前机构 / 💰便宜去风险,逐关诚实打分(过/半过/不过)。
跨主题信号区块:当前主题命中的 ⭐ 节点(来自 cross_theme_index_snapshot.csv)。
已知玩家全集 audit 块:列全球+全市场已知玩家,显式标 covered/private/acquired/delisted/untracked。
落地结论 + 数据备注 + 免责页脚。
底部 glossary 折叠速查表(JS 自动从 <abbr> 抽取)。

Tier-1 §A · 反向研究 / 红队(🟢🟡 候选强制,缺失或敷衍 = 报告不合格)

每个 🟢/🟡 候选必带一段红队,不许写"风险:估值高"这种套话。四问 + 一句最大杀点:

反向研究 · 杀死这个候选的最短路径
① 为什么可能不是真瓶颈?   → 谁能绕过 / 替代方案进度
② 瓶颈为什么可能不变现?   → 收入纯度 X% / 下游议价能力 / 毛利能否扩
③ 市场是否已定价?         → 【强制引用 price.py 的 off-high / 1m / 3m 数字对账,不许空谈】
④ 有没有更优替代?         → 必须点名一个对比标的 XXX.XX(且过 price.py / ticker 验证)
最大杀点(一句):________ （必须区别于"估值高/竞争加剧"的通用风险）

牙齿:③ 必须引用我们已拉到的 9 字段数字(off/1m/3m 就在 scan JSON 里,逼对账);④ 必须点名一个真实存在、可验证的对比 ticker。

Tier-1 §B · 证伪条件(🟢 候选强制)

每个 🟢 必带 2-4 条具体可检验的"什么会证明我错了",至少一条是价格/stage 机器可读(供 score_tracker 自动监控):

证伪条件(满足任一即承认判断错):
· 价格/stage:跌破 ¥X(entry)且 1m 转负        ← 机器可检,写进 forward_picks 的 invalidation 列
· 基本面:下季度订单/backlog 未随主题增长
· 估值:涨到 PS > 行业 +1σ 但毛利未扩

目标价/时间框架:给情景区间 + 时间框。⚠️ 基准率随主题而变,切勿套用光子学数字:高 beta 快速点燃(光子学 2-6 月 +150~~1000%)vs 慢周期政府驱动(航天/电网 1-3 年 +30~~150%)完全不同。按当前主题 beta 与催化剂节奏设定,显式标"情景非承诺、有幸存者偏差"。
三档判定:每只必标 🟢/🟡/🔴(详见 methodology.md §7)。
- 🟡 必填重估触发条件(价格点/财报指标/公司动作/政策事件)。
- 🔴 极度克制:只用于商业模式作假/欺诈/业务死亡/个人原则。严禁"历史事件式硬排除"——"曾经重组/增发过"是过期信息,"1m 涨太多"是 stage 问题(降 🟡 等回调)。例:$WOLF 重组后是 NewCo,业务逻辑可独立评估 → 🟡 观望 + trigger,不永久排除。
可读性纪律:语义化三档配色(🟢green/🟡amber/🔴red)、动量条让"谁已抛物线"一眼可见、清爽留白。
术语友好度:① 顶部"30 秒看懂"块;② 每个 🟢/🟡 候选加 .why 一行(20-40 字人话);③ 专业缩写首次出现用 <abbr title="中文解释">缩写</abbr>,来源 reference/glossary.md(120+ 条),新术语先 append 再用;④ 底部 <details class="glossary-section"> 折叠速查表,JS 自动从 <abbr> 抽取。

页脚必带:⚠️ 仅供研究教育,非投资建议;估值为网页研究近似值需复核;微盘/诉讼/海外标的风险极高。

数据来源与边界

价格/动量(择时):统一走 scripts/price.py,自动回退 ① EODHD(EODHD_API_KEY)→ ② yfinance → ③ 都失败=报错退出。Key 从环境变量读、不硬编码。WebSearch 仅用于公司基本面/定性研究,不用于抓价格。
EODHD 取不到:fundamentals(估值/增长/毛利率/市值)、screener、财报日历 → 用网页研究逐只补。
瓶颈/单源/产能/客户等定性判断:靠财报+行业资料+新闻研究。

参考文件

reference/lessons.md —— 翻车档案 / 纪律的由来(每条纪律对应一次真实事故,SKILL.md 用 〔… → lessons.md#锚点〕 指向)
reference/methodology.md —— 完整方法论(理念、筛选清单、两套择时、回避清单、风险)
reference/supply-chain-and-archetypes.md —— 元框架、产业链速查表、Part D 9 大瓶颈原型库、EODHD 数据映射
reference/report_template.html —— HTML 报告骨架 + 配色模板
scripts/render_report.py —— 报告统一渲染引擎(克隆合格报告外壳 + 数据驱动渲染真 chain-viz / 标尺三价 / §A§B / forward_picks;agent 只写薄主题 SPEC,示例 tracking/_gen_mlcc_report.py)
scripts/verify_report.py —— 交付契约 linter(报告生成后必跑;查区块齐全 / §A§B / 标尺三价 / 价格对账 scan / 入轨 forward_picks / 真 chain-viz / 揭示类脚本 / 占位符,有【拦】先修再交付)
reference/example_commercial_space.md —— worked example(商业航天),示范分析内容与颗粒度
reference/glossary.md —— 术语库(120+ 条,LLM 自动 enrich);报告 <abbr> 注释来源
reference/company_desc.md —— 公司业务描述库:只存 business(主营/产业链位置/技术/客户),严禁含 price/stage/估值等动态数据。格式 - **SYM.EX** [YYYY-MM-DD] = 业务描述,每条带 last_updated 时间戳。
- 拆分:🟢 business(本文件 + .cnode[data-desc=],带时间戳)/ 🔴 status(.cnode[data-status=],price/stage,每次重写带 [YYYY-MM-DD])。
- 90 天 freshness:用 data-desc 前查 last_updated,≤90 天直接复用,>90 天重新评估战略漂移(有变更新+bump,无变只 bump)。工具 tracking/check_desc_freshness.py。〔三次迭代史 → lessons.md#company-desc-evolution〕
reference/ticker_truth.csv + reference/TICKER_HYGIENE.md —— ticker ground-truth 库 + L1/L2/L3 防御文档
tracking/forward_picks.csv —— 向前(样本外)跟踪表(带 invalidation 证伪列)
tracking/score_tracker.py + tracking/theme_benchmark.csv —— Alpha 打分(🟢-vs-🔴 内部对照为主、vs 主题 ETF/大盘为辅)
tracking/cross_theme_scan.py + tracking/cross_theme_index_snapshot.csv —— 跨主题节点扫描(Step 4 末尾强制跑)+ 快照

验证状态(诚实说明)

逻辑自洽性(已做,非业绩回测):套到 Serenity 研究过的"AI 光子学"能重建其名单(AXTI/SIVE/LITE/TSEM/SOI/IQE/AEHR…);套到他没碰过的"AI 电力散热"能独立挖出 $CLF(GOES 电工钢独家)、$CC(浸没冷却液单源);"商业航天"挖出 $VNP/5N+($MTRN)。→ "拆链 + 原型"逻辑能指向真实瓶颈公司。
⚠️ 这不是业绩回测:此前"光子学首 call 后 +X%"存在选股循环论证(用已知赢家倒推)、幸存者偏差、峰值未来函数,不能当收益预期。
唯一可信的是向前(样本外)验证 + Alpha:对当下产出的候选,记录"建议日 + 当时价 + 事先定死的进出场/证伪规则",日后用 score_tracker 重拉价。关键纪律:量 Alpha = 标的收益 − 主题 ETF 同期收益(牛市里随便选上游小票也涨,raw return 看不出选股有没有 alpha);最硬的检验是 🟢 篮子 vs 🔴 篮子内部对照(同主题 beta 对消,差额 = 纯选股能力)。结论出来前,输出只当研究线索,不是业绩。每次出新候选都追加进 forward_picks.csv。

serenity-bottleneck-hunter

Quellinformationen

Installationsoptionen

Quelldateien prüfen

Serenity Bottleneck Hunter

何时用

核心理念

工作流(7 步)

入场时机:两套模式(经价格回测校准,勿混用)

输出模板(HTML)

交付契约(scripts/verify_report.py,交付前必过)

Tier-1 §A · 反向研究 / 红队(🟢🟡 候选强制,缺失或敷衍 = 报告不合格)

Tier-1 §B · 证伪条件(🟢 候选强制)

数据来源与边界

参考文件

验证状态(诚实说明)

Serenity Bottleneck Hunter

何时用

核心理念

工作流(7 步)

入场时机:两套模式(经价格回测校准,勿混用)

输出模板(HTML)

交付契约(scripts/verify_report.py,交付前必过)

Tier-1 §A · 反向研究 / 红队(🟢🟡 候选强制,缺失或敷衍 = 报告不合格)

Tier-1 §B · 证伪条件(🟢 候选强制)

数据来源与边界

参考文件

验证状态(诚实说明)

交付契约(`scripts/verify_report.py`,交付前必过)

交付契约(`scripts/verify_report.py`,交付前必过)