用途:从数据生成专业 PDF/HTML 报告,包含图表、表格和叙述文本,适合业务报告、分析看板、状态更新和自动化报告流程。
主要能力:支持 PDF 与 HTML 输出;可添加文本、标题、项目符号、编号列表、表格、图表、图片、分隔线、标注框、引用等;图表类型包括柱状、折线、饼图、散点、面积、热力图;表格支持自动样式、条件格式(高亮最大/最小值、货币与百分比格式);支持模板、品牌(Logo、颜色、字体、页眉页脚、水印)、目录、页码、附录;数据可来自 CSV、DataFrame、dict。
使用方式:通过 Python 导入 ReportGenerator,例如 from scripts.report_gen import ReportGenerator;创建报告后调用 add_text、add_table、add_chart 等方法,最后 generate().save("report.pdf")。也可从模板创建:ReportGenerator.from_template("executive_summary"),再 set_data 并生成。支持 CLI:python report_gen.py --config report_config.json --output report.pdf,或 --template、--data、--csv、--title、--format 等参数。
适用场景:季度销售报告、营销分析看板、项目状态、执行摘要等。
限制:PDF 中图表为静态图片;复杂布局可能需要手动调整;大数据集可能影响性能;HTML 输出样式基础,无交互图表。依赖 reportlab>=4.0.0、Pillow>=10.0.0、pandas>=2.0.0、matplotlib>=3.7.0。