docs(futu): 按股价/期权数据依赖给模块分类

[HRLoveFun]

目的

回应对 futu 探索文档的追问："既然期权数据换成 futu、股价仍走 yfinance，按这个边界给模块做划分是否有帮助、哪些模块两种数据都用、futu 期权数据能否顺带给一点股价信息（如最新价）满足这些模块？"

用 grep 校验过实际调用点，不是猜测。无代码改动，无新增 ADR。

结论（新增 §3.6，充实 §3.3/§4.1，TL;DR 加两行）

分类	模块	说明
纯股价	Market Review / Statistical / Assessment / Regime / Simulation	完全不碰 fetch_option_chain，futu 接入零影响
纯期权	Option Chain / Payoff Ratio / candidate 矩阵 / IV 系列图表	spot 是 fetch_option_chain() 内部顺带解析、塞进同一份快照的，不是第二数据源
两者都用（仅 2 处）	① services/options/chain.py 的 Vol Premium 区块；② services/options/builder.py::_vol_context	同一种模式：HV 百分位（需要 ~250 个交易日历史收盘价）对比当前期权 IV——ADR 0004"用 HV 百分位替代 IV rank"的落地点

关键点：这两处的历史价格调用和期权链调用本就是两次独立函数调用，只在最后合并成两个派生标量（HV 百分位数字、IV 百分比数字），不共享底层数据。给期权侧换 futu，完全不需要碰这两处的历史价格那条腿——DataService.get_cleaned_daily/build_data_context 照常走 yfinance。

futu 解析 spot 时顺带对标的代码做的 subscribe+get_stock_quote，返回的是当日完整快照（最新价+今日开高低+昨收+成交量），比"仅最新价"丰富，但终究是快照不是序列——替代不了 HV 计算需要的历史数据，这两个模块的股价腿无论如何都得继续走 yfinance。文档里也标注了一条要主动避免的坑：不要为了"省一次调用"把这两处的历史价格改成复用期权链快照里的现价，那会把 252 天历史悄悄换成 1 天数据，HV 数字会算错。

检查

• python scripts/doc_guard.py — clean
• ruff format --check — clean（这次改动没有触发上次那个 markdown 里 python 代码块的格式问题）
• 无代码改动，无测试影响

🤖 Generated with Claude Code