用途：检测并排序跨行业市场主题，识别看涨与看跌主题，评估主题生命周期成熟度（早期/中期/后期/衰竭），并给出置信度评分，用于理解市场叙事变化与主题轮动。
主要能力：采用三维评分模型——主题热度（0-100，方向中性）、生命周期成熟度、置信度（低/中/高）。支持跨行业主题检测（基于 FINVIZ 行业数据）、方向感知评分、ETF 扩散度评分、与 uptrend-dashboard 集成，并通过 WebSearch 对头部主题做叙事确认。
使用方式：需 Python 3.7+ 及 requests、beautifulsoup4、lxml，安装命令为 pip install requests beautifulsoup4 lxml。可选配置 FINVIZ_API_KEY（推荐）与 FMP_API_KEY。运行主脚本：python3 skills/theme-detector/scripts/theme_detector.py --output-dir reports/，可加 --finviz-api-key、--fmp-api-key、--max-themes、--max-stocks-per-theme、--finviz-mode public 等参数。脚本生成 JSON 与 Markdown 报告，随后对热度前五的主题执行 WebSearch 确认叙事强度，再结合 references 目录下的主题定义、ETF 目录、方法论与行业代码文档进行分析并输出最终报告。
适用场景：查询当前热门市场主题、冷热行业、看涨/看跌叙事、主题投资机会、拥挤交易或晚期周期主题、新兴与衰竭主题等。不适用于个股分析、单一行业深度图表分析、组合再平衡或股息收益投资。
限制：存在幸存者偏差；公共模式数据延迟约 15 分钟且每行业约 20 只股票；主题边界依赖主行业分类；ETF 目录为静态；叙事评分为主观；FINVIZ Elite 模式约 2-3 分钟，公共模式约 5-8 分钟。分析仅供教育参考，不构成投资建议。