美股AI全产业链实操看板

Overview

一键生成三份互相自洽的 HTML 产物：综合工作台、全产业链主线视图、月度期权策略计划。
数据以 FutuOpenD 实时行情为主源，宏观（VIX/美债）与期权 IV 走联网回退。
核心特征：全产业链图谱分 8 个 tier、每标的标「核心/观察」、给出相对买卖点建议、
风控闸口写死保护、单次快照驱动保证报告内判定一致。

本技能内置全量 AI 算力产业链标的池（覆盖电力、GPU/ASIC、网络光模块、存储、半导体设备、
云巨头、企业 AI 软件等全环节）。用户应基于自身交易策略对标的池做精简，并在
scripts/pool_config.json 中维护「核心/观察」标记与每月事件窗口、期权到期日、预备结构。

When to use

• 用户要「生成/重跑 美股看板 / 美股期权工作台 / AI 算力产业链图谱」。
• 用户要「本月美股期权策略 / 月度期权计划（含行权价、到期日、止损、单笔上限）」。
• 用户要「按 AI 全产业链（电力、GPU、网络、存储、设备、云巨头、企业AI）逐股分析」。
• 用户已装 FutuOpenD，希望用 OpenD 实时数据做美股/期权实操分析。

Quick Start

进入技能 scripts/ 目录（即工作目录），用 futu venv 运行：

python generate.py                                  # 当月全量（联网取宏观/IV）
python generate.py --month 2026-09                  # 指定月份
python generate.py --inject-vix 15.65 --inject-10y 4.649 --inject-30y 5.165  # 离线注入宏观

产物：workbench.html（综合）、mainline.html（主线）、plans/YYYY-MM_monthly_plan.html（月度计划）。
详细环境/排错见 references/setup.md，数据流与风控见 references/architecture.md。

Core Capabilities

1. 全产业链主线视图（mainline）

按 8 个 tier 逐股展开：现价、涨跌%、%MA20、MACD、KDJ_J、量比、5d%/20d%、RSI14、评级、备注。
- 代码带中文名（如 NVDA 英伟达）；每标的标「核心 / 观察」（来自 pool_config.json 的 POOL_ROLE，用户自行标记）。
- 「备注」列给相对合适的买卖点建议（由现价与 %MA20 反推 MA20 价位：回踩建仓 / 等站上确认 / 不抄底）。
- 红涨绿跌配色；评级由系统独立计算（站 MA20 + MACD 金叉=绿 等），不依赖外部意见。

2. 风控闸口（写死保护）

• 购权暂停闸口：QQQ 与 SMH 同时 收盘<MA20 且 MACD死叉 → 科技/半导体购权全池暂停（绿降级观察）；数据缺失保守按激活。
• 事件减仓闸口：FOMC/NVDA 财报等窗口前 1–2 日 → 减仓→事件周全平。
• P0 风控基线：IV Rank>70 禁开 / 单笔权利金≤5% / IV 飙升>15% 减仓50%。

3. 月度期权策略候选表（表格）

从绿/黄标派生，列：标的 / 角色 / 策略 / 方向 / 建议行权价 / 到期日 / 触发条件 / 止损 / 单笔上限。
红标与购权暂停链不列入；建议行权价为现价近似 ATM（取整 $5），实盘以报价 mid 复核。

4. 数据双向交叉验证（后台门禁）

cross_validate 校验「报价↔K线现价」「MACD/KDJ 状态自洽」，整体 PASS/WARN/FAIL；仅 FAIL 弹告警 banner。

5. 持仓跟踪（可选）

holdings.json 填入建仓价/止损价后，position_tracker.py 实时跟踪盈亏、距止损、事件驱动告警。

每月维护（核心/观察 标记 + 标的精简）

全产业链标的与「核心/观察」标记每月 1 日更新一次，只需编辑 scripts/pool_config.json
（无需改代码）：
- 精简标的：按自身策略保留/剔除 POOL 中各 tier 的标的。
- 标记核心/观察：在 POOL_ROLE 中把主线最优先标为「核心」，其余「观察」（缺省即观察）。
- 更新事件窗口 EVENT_WINDOW、期权到期日 OPTIONS_EXPIRY、预备结构 PREPARED_STRUCTURES。
步骤与字段说明见 references/pool_config.md。

Resources

• scripts/generate.py —— 统一入口（拉一份快照 → 生成三产物；支持 --month / --inject-* / --no-web）。
• scripts/data_hub.py —— 统一数据层（OpenD 主 + Web 兜底 + 技术指标）。
• scripts/workbench.py —— 分析引擎（四层框架 + 四态 + 风控闸口 + 选股池分类 + 交叉验证 + 配置加载）。
• scripts/ 其余：mainline_view.py、monthly_strategy.py、run_workbench.py、position_tracker.py。
• scripts/pool_config.json —— 每月更新的全产业链标的 / 核心观察 / 事件窗口 / 期权到期日 / 预备结构。
• references/setup.md —— 环境、依赖、运行命令、排错。
• references/architecture.md —— 分层、单次快照驱动、风控闸口、数据流。
• references/pool_config.md —— 每月更新标的与核心/观察的操作指南。