reports-engine

name	reports-engine
version	1.0.0
description	A股绩效归因与可视化报告引擎。支持三种报告类型：量化投资者生成包含净值曲线、绩效指标 TearSheet、月度收益热力图、申万行业归因、Brinson 分解、风格暴露分析的综合 HTML 报告；非量化投资者生成个股技术面深度分析（9 章节，含A股特色：资金面、龙虎榜）和基本面深度分析（10 章节，含A股特色：股东结构）独立报告；绩效复盘报告从实盘/模拟交易账本中提取成交记录，通过 FIFO round-trip 归组实现盈亏归因、执行质量分析和 A 股压力期表现分析。集成 TradingView 轻量级 K 线图（8 种可切换技术指标），支持 LLM 占位符注入。基于 QuantStats / Plotly / Matplotlib 输出交互式图表和结构化数据 JSON。
author	quant-team
license	MIT
tags	["quant-trading","A股","reports-engine","绩效","可视化","quantstats","plotly","个股分析","技术面","基本面","TradingView"]
dependencies	["quantstats","plotly>=5.15.0","matplotlib>=3.7.0","pandas>=2.0.0","numpy>=1.24.0","jinja2>=3.1.0"]
environment_variables	[{"name":"QUANT_WORK_DIR","description":"工作目录根路径","required":false,"default":"./workspace"},{"name":"REPORT_TITLE","description":"报告标题","required":false,"default":"A股量化策略绩效报告"},{"name":"BENCHMARK","description":"基准指数","required":false,"default":"000300.SH"},{"name":"INDUSTRY_STANDARD","description":"行业分类标准（sw=申万 / zz=中信）","required":false,"default":"sw"},{"name":"CHART_THEME","description":"图表主题（plotly_white / plotly_dark）","required":false,"default":"plotly_white"}]
language	python
python_version	3.9+
entry_point	engine.py
trigger_keywords	["报告","绩效","归因","可视化","热力图","净值曲线","TearSheet","行业归因","Brinson","风格暴露","技术面分析","基本面分析","个股分析","诊股报告","K线图","绩效归因","归因分析","复盘","实盘报告","盈亏分析","执行报告","交易复盘","绩效复盘","attribution"]

reports-engine

概述

reports-engine 是 A 股量化投研的绩效归因与可视化报告引擎，支持多种报告类型。所有报告均统一走自包含插件路径，插件 render.py 不依赖 engine.py 内部函数（包括 fallback_report 也已自包含，委托 technical_report / fundamental_report 两个插件渲染，不再回调 engine 内部函数）。

报告路由优先级（已收敛为纯插件匹配 + 兜底插件）

路由在 run() 内收敛为两分支，二者均经自包含插件路径生成报告：

• 分支 A（ENABLE_PLUGIN）：统一由 _run_plugin_auto 执行插件匹配（含多命中聚合、 自定义输出文件名、fallback 兜底）。
• 分支 B（无插件机制 / 异常兜底）：_run_builtin_fallback，直接运行兜底插件 fallback_report 生成默认个股技术/基本面报告（不再存在独立的「内置模板内核」HTML 组装路径；旧 _run_template_report 已删除，其 HTML 组装能力由插件渲染替代）。

attribution/portfolio/execution 三类报告统一由 report_intent 直接映射到对应插件， 经 _run_plugin_enhanced 完成产物校验 + 插件委托 + metadata 组装（不进入通用匹配）：

优先级	触发条件	报告类型	生成插件	回答的问题
1	report_intent ∈ {attribution/portfolio/execution}	绩效归因/组合优化/执行监控	attribution_report / portfolio_report / execution_report	盈亏/组合/执行质量
2	有 BACKTEST 产物	回测绩效报告	backtest_report（output_file: report.html）	策略理论上能赚钱吗？
3	显式 report_template ∈ {technical/fundamental/both}（无 BACKTEST）	模板化个股分析	technical_report / fundamental_report，both 多命中 → _run_plugin_many 联合生成双份	个股技术/基本面
4	其余插件 trigger 匹配（产物存在等）	因子分析等	factor_analysis_report 等	这只股票值得买吗？
5	无任何插件命中	默认个股分析兜底	fallback_report（fallback=true，委托 technical_report / fundamental_report 插件渲染）	个股技术/基本面
6	无插件机制 / 无兜底插件 / 匹配异常	默认个股分析兜底	_run_builtin_fallback 直接运行 fallback_report 插件（若兜底插件也缺失则返回失败，不再有独立内置模板内核兜底）	个股技术/基本面