PDF导出功能快速启动

立即开始

1. 启动系统

# 设置环境变量（macOS必需）
export DYLD_LIBRARY_PATH=/opt/homebrew/lib:$DYLD_LIBRARY_PATH

# 启动Flask应用
python app.py

2. 生成报告

1. 在浏览器中打开 http://localhost:5000
2. 启动 Insight、Media、Query Engine
3. 输入搜索主题，点击搜索
4. 切换到 Report Engine 标签
5. 点击"生成最终报告"

3. 导出PDF

报告生成完成后：

1. 点击"下载PDF"按钮
2. 系统自动：
   • 分析报告内容
   • 优化布局参数
   • 生成高质量PDF
   • 自动下载文件

快速测试

想立即看到效果？运行测试脚本：

# 设置环境变量
export DYLD_LIBRARY_PATH=/opt/homebrew/lib:$DYLD_LIBRARY_PATH

# 运行测试（生成示例PDF）
python test_pdf_optimized.py

# 查看结果
open test_pdf_optimized.pdf

测试会生成：

• ✅ 包含10个KPI卡片的报告
• ✅ 复杂的8列表格
• ✅ 多个图表和色块
• ✅ 自动优化的布局

优化效果对比

系统会自动：

问题	优化前	优化后
KPI数值溢出	⚠️ 字号固定32px，长数值溢出	✅ 自动缩小到28px或24px
KPI布局拥挤	⚠️ 固定2列，10个卡片显得拥挤	✅ 自动调整为3列
表格字体过大	⚠️ 8列表格字体过大	✅ 字号从13/12px缩小到11/10px
长文本难读	⚠️ 行高固定1.6	✅ 自动增加到1.8

查看优化日志

想了解系统做了哪些优化？

# 查看最新的优化日志
cat logs/pdf_layouts/layout_*.json

# 或打开保存的配置文件
cat test_layout_config.json

日志示例：

{
  "optimizations": [
    "KPI数值过长(14字符)，字号从32调整为28",
    "KPI卡片较多(10个)，每行列数从2调整为3",
    "表格列数较多(8列)，缩小字号和内边距"
  ]
}

常见问题

Q: 为什么PDF生成需要几秒钟？

A: 首次生成需要加载字体文件和分析文档，后续会更快。

Q: 可以禁用自动优化吗？

A: 可以，在API中设置 optimize=false：

curl "http://localhost:5000/api/report/export/pdf/TASK_ID?optimize=false"

Q: 如何自定义布局参数？

A: 参考 PDF_EXPORT_GUIDE.md 中的"配置选项"章节。

技术亮点

✨ 智能布局分析

• 自动检测KPI数量、表格复杂度、文本长度
• 根据内容特征动态调整参数

✨ 无损质量

• 使用WeasyPrint专业PDF引擎
• 完整保留CSS样式
• 完美支持中文字体

✨ 开箱即用

• 前端一键导出
• 无需额外配置
• 自动应用最佳实践

下一步

• 📖 阅读完整文档：PDF_EXPORT_GUIDE.md
• 🧪 运行测试：python test_pdf_optimized.py
• 🎨 自定义布局：修改配置参数
• 🚀 集成到生产：通过API批量导出

问题反馈

遇到问题？

1. 查看 PDF_EXPORT_GUIDE.md 的"故障排除"章节
2. 检查 logs/pdf_layouts/ 目录的优化日志
3. 提交Issue到项目仓库

---

享受全新的PDF导出体验！ 🎉