马一丁
135 lines
3.1 KiB
Markdown
135 lines
3.1 KiB
Markdown
# 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导出体验！ 🎉
|