用途：这是一个自包含的美股金融数据与量化分析工具包，所有数据源免费且无需 API Key，脚本以 JSON 输出到标准输出，便于解析。
主要能力：
- 股票数据（scripts/stock_data.py）：获取公司信息、估值/盈利/杠杆/成长等财务指标、OHLCV 历史行情、三大财务报表及多股筛选。
- SEC EDGAR（scripts/sec_edgar.py）：内部交易（Form 4）、公司文件（如 10-K）、CIK 查询。
- 财务计算（scripts/financial_calc.py）：DuPont 分解、Altman Z-Score、Beneish M-Score、Piotroski F-Score、盈余质量、营运资本与 CCC 分析。
- 组合分析（scripts/portfolio_analytics.py）：集中度、相关性聚类、VaR/CVaR、压力测试、健康评分。
- 因子筛选（scripts/factor_screener.py）：价值、动量、质量、低波动、规模、成长多因子评分。
- 宏观数据（scripts/macro_data.py）：利率与收益率曲线、通胀、GDP、就业、商业周期判断。
使用方式：先一次性安装依赖 pip install -r requirements.txt，然后在技能根目录运行 scripts/ 下脚本，如 python scripts/stock_data.py AAPL、python scripts/sec_edgar.py insider AAPL、python scripts/financial_calc.py AAPL --all、python scripts/portfolio_analytics.py --holdings "AAPL:30,MSFT:25,GOOGL:20,AMZN:15,META:10"、python scripts/factor_screener.py --sp500-sample --top 10、python scripts/macro_data.py --dashboard。可选编辑 config/data_sources.yaml 调整限速或为付费数据源添加 API Key。
适用场景：美股个股基本面与技术面分析、内部交易与文件核查、财务质量评分、投资组合风险与压力测试、多因子选股及美国宏观跟踪。
限制：数据来自 Yahoo Finance、SEC EDGAR、FRED，均为公开免费源，可能有延迟或精度限制；需 Python 环境及依赖；实际交易与投资决策仍需自行核实。