用途:基于历史价格数据识别下跌趋势(峰到谷),统计回调持续时长的分布,并按行业与市值分层生成交互式可视化,用于均值回归或回调策略的持有期估算、止损超时设定以及跨市场板块的回调行为对比。
主要能力:使用滚动窗口识别局部峰谷;计算每段下跌的持续交易日数与跌幅;按行业和市值层级(Mega、Large、Mid、Small)分段;输出中位数、均值及P25、P50、P75、P90等分位数;生成JSON、Markdown与基于Plotly.js的交互式HTML直方图,支持行业与市值下拉筛选、分箱控制与分位数标记。
使用方式:需Python 3.9+、FMP API key(通过FMP_API_KEY环境变量或--api-key传入),依赖requests、pandas、numpy。先运行分析:python3 skills/downtrend-duration-analyzer/scripts/analyze_downtrends.py --sector "Technology" --lookback-years 5 --output-dir reports/;再生成可视化:python3 skills/downtrend-duration-analyzer/scripts/generate_histogram_html.py --input reports/downtrend_analysis_*.json --output-dir reports/。报告输出至reports/目录,含JSON、Markdown与HTML三种格式。
适用场景:查询某行业或市值层级的典型回调时长;了解历史回撤恢复时间;为均值回归或回调策略设定现实持有期;比较不同市场板块的回调行为;设置止损超时或持仓期限。
限制:需有效FMP API key与网络数据源,未提供则无法运行;结果依赖滚动窗口参数(如peak_window、trough_window、lookback_years)的设定;方法论细节见references/downtrend_methodology.md;其余未在资料中说明的限制暂未提供。