Add README of "Export as PDF"

ReportEngine/docs/PDF_EXPORT_QUICKSTART.md

@@ -0,0 +1,134 @@
+# PDF导出功能快速启动
+
+## 立即开始
+
+### 1. 启动系统
+
+```bash
+# 设置环境变量（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
+   - 自动下载文件
+
+## 快速测试
+
+想立即看到效果？运行测试脚本：
+
+```bash
+# 设置环境变量
+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 |
+
+## 查看优化日志
+
+想了解系统做了哪些优化？
+
+```bash
+# 查看最新的优化日志
+cat logs/pdf_layouts/layout_*.json
+
+# 或打开保存的配置文件
+cat test_layout_config.json
+```
+
+日志示例：
+```json
+{
+  "optimizations": [
+    "KPI数值过长(14字符)，字号从32调整为28",
+    "KPI卡片较多(10个)，每行列数从2调整为3",
+    "表格列数较多(8列)，缩小字号和内边距"
+  ]
+}
+```
+
+## 常见问题
+
+### Q: 为什么PDF生成需要几秒钟？
+A: 首次生成需要加载字体文件和分析文档，后续会更快。
+
+### Q: 可以禁用自动优化吗？
+A: 可以，在API中设置 `optimize=false`：
+```bash
+curl "http://localhost:5000/api/report/export/pdf/TASK_ID?optimize=false"
+```
+
+### Q: 如何自定义布局参数？
+A: 参考 [PDF_EXPORT_GUIDE.md](PDF_EXPORT_GUIDE.md) 中的"配置选项"章节。
+
+## 技术亮点
+
+✨ **智能布局分析**
+- 自动检测KPI数量、表格复杂度、文本长度
+- 根据内容特征动态调整参数
+
+✨ **无损质量**
+- 使用WeasyPrint专业PDF引擎
+- 完整保留CSS样式
+- 完美支持中文字体
+
+✨ **开箱即用**
+- 前端一键导出
+- 无需额外配置
+- 自动应用最佳实践
+
+## 下一步
+
+- 📖 阅读完整文档：[PDF_EXPORT_GUIDE.md](PDF_EXPORT_GUIDE.md)
+- 🧪 运行测试：`python test_pdf_optimized.py`
+- 🎨 自定义布局：修改配置参数
+- 🚀 集成到生产：通过API批量导出
+
+## 问题反馈
+
+遇到问题？
+1. 查看 [PDF_EXPORT_GUIDE.md](PDF_EXPORT_GUIDE.md) 的"故障排除"章节
+2. 检查 `logs/pdf_layouts/` 目录的优化日志
+3. 提交Issue到项目仓库
+
+---
+
+享受全新的PDF导出体验！ 🎉