用途
本技能以「银矿股价格 ÷ 白银价格」的相对比率衡量矿业股板块相对于金属本体的估值区间（偏贵/偏便宜），并用历史分位数与类比区间推导「底部/顶部」信号与情境推演。
主要能力
- 数据整合：取得矿业股代理与白银价格序列。
- 比率计算：计算相对比率并可选择平滑。
- 分位数判断：判断当前比率在历史中的位置。
- 类比事件：识别历史底部区间的事件。
- 前瞻验证：统计底部事件后白银的 1/2/3 年表现。
- 情境推演：计算矿业股需涨多少 / 白银需跌多少才回到顶部。
- 输出：当前状态、历史类比、情境推演、风险提示。
- 可视化：生成比率走势图，标记当前位置与分位数区间。
方法论
比率定义为 ratio_t = miner_price_t / metal_price_t。比率高表示矿业股相对白银偏贵，可能过度乐观、杠杆溢价高；比率低表示矿业股相对白银偏便宜，可能被低估，或反映成本/股权稀释风险。
历史分位数区间标签：≤20% 为 bottom（底部），20-40% 为 low（偏低），40-60% 为 neutral（中性），60-80% 为 high（偏高），≥80% 为 top（顶部）。底部区间不等於白银必涨，也可能是矿业股因成本/稀释被合理定价。
当出现「比率低 + 白银高」的组合，此背离意味著矿业股可能有追赶空间（均值回归逻辑），或矿业股正确反映了结构性问题（成本、稀释、地缘风险），需结合基本面交叉验证，而非盲目视为买入信号。
情境推演目标：若比率要回到历史顶部（或中位），需要什么条件？假设当前比率=1.14，目标比率（顶部门槛）=2.45，情境A（白银不变）矿需涨 target_ratio/current_ratio = 2.15x（需涨115%）；情境B（矿业股不变）白银需跌 current_ratio/target_ratio = 0.46（需跌54%）。此为极端情境的量化参考，非预测。
频率选择：长周期信号建议使用周频（1wk）或月频（1mo）；平滑视窗可选 4 周或 3 个月移动平均降低杂讯；类比事件间隔需 ≥ min_separation_days（如 180 天）。本 skill 使用 yfinance 取得 ETF/期货数据，预设周频对齐。
使用方式
最快的方式：执行预设情境分析
cd skills/analyze-silver-miner-metal-ratio pip install pandas numpy yfinance matplotlib # 首次使用 python scripts/ratio_analyzer.py --quick
生成可视化图表（基本版）：
python scripts/ratio_plotter.py --quick --output-dir ../../output
生成完整版图表（含底部事件、前瞻报酬统计）：
python scripts/ratio_plotter.py --comprehensive --start-date 2010-01-01 --output-dir ../../output
完整情境分析：
python scripts/ratio_analyzer.py
--miner-proxy SIL
--metal-proxy SI=F
--start-date 2008-01-01
--freq 1wk
--smoothing-window 4
--bottom-quantile 0.20
--top-quantile 0.80
--output result.json
核心功能入口：快速分析（使用预设参数 SIL / SI=F 计算当前比率状态）、完整分析（自定义参数进行情境分析）、可视化图表、历史验证、情境推演、方法论学习。
输入参数
核心参数：miner_proxy（预设 SIL，银矿股代表）、metal_proxy（预设 SI=F，白银价格代表）、start_date（预设 10 年前）、end_date（预设 today）、freq（预设 1wk，可选 1d/1wk/1mo）。
进阶参数：smoothing_window（预设 4）、bottom_quantile（预设 0.20）、top_quantile（预设 0.80）、min_separation_days（预设 180）、forward_horizons（预设 [52, 104, 156] 周，对应 1/2/3 年）、scenario_target（预设 return_to_top，可选 return_to_median）。
输出结构
输出包含 skill、inputs、current（ratio、ratio_percentile、zone、bottom_threshold、top_threshold）、history_analogs（bottom_event_dates、forward_metal_returns）、scenarios（target、target_ratio、miner_multiplier_if_metal_flat、metal_multiplier_if_miner_flat、metal_drop_pct_if_miner_flat）、summary、notes。notes 提示：比率信号衡量的是相对估值，不是单边价格保证；矿业股与金属可能同涨，但矿业股也可能因成本上升、地缘/政策风险、增发稀释而落后；建议搭配矿业股获利率（成本曲线）、白银实质利率/美元、投机部位（COT）、ETF 流量等做交叉验证。
适用场景
- 判断银矿股板块相对白银的估值水位
- 识别历史底部区间事件并统计后续白银表现
- 推演比率回到顶部或中位所需条件
- 生成比率走势可视化图表
限制
底部区间不等於白银必涨，可能是矿业股因成本/稀释被合理定价。情境推演仅为极端情境的量化参考，非预测。比率信号衡量的是相对估值，不是单边价格保证。矿业股与金属可能同涨，但矿业股也可能因成本上升、地缘/政策风险、增发稀释而落后。建议搭配矿业股获利率、白银实质利率/美元、投机部位、ETF 流量等做交叉验证。