用途：以公开金属价格与矿业成本指标计算黄金/白银矿业的毛利率代理值，并判断当前水位在历史区间中的位置。核心公式为 gross_margin_proxy = (metal_price - unit_cost) / metal_price，其中 metal_price 为现货价或近月期货价，unit_cost 可为 AISC、现金成本(C1)或全成本。该指标不等同会计报表毛利率，仅用于快速捕捉价格-成本关系的边际变化。
主要能力：抓取金属价格序列与矿业成本/产量数据；计算单公司与篮子聚合毛利率代理；计算历史分位数并标记 extreme_high/high/neutral/low/extreme_low 区间；拆解价格驱动与成本驱动；输出 JSON 或 Markdown 结果及后续研究建议。
使用方式：脚本位于 scripts/ 目录。首次使用可执行 pip install pandas numpy requests yfinance beautifulsoup4 lxml，然后运行 python scripts/margin_calculator.py --quick --metal gold 进行快速计算；完整分析可指定 --metal silver --miners CDE,HL,AG --start-date 2015-01-01 --frequency quarterly --cost-metric AISC --aggregation production_weighted --output result.json。
适用场景：矿业毛利率时序研究、历史分位判断、价格与成本驱动拆解、交易或研究信号生成。
限制：成本数据多为季度披露，需 forward-fill 或使用同季均价对齐；建议优先使用 AISC 以保证可比性；数据来源为 LBMA/COMEX 价格、公司 IR 简报/季报/新闻稿及产量数据；具体收费、平台与效果暂未提供。