PDF 报告

从结构化 JSON 数据生成干净的 A4 PDF。

环境配置

安装系统依赖（WeasyPrint 需要以下依赖）：

bash

Ubuntu/Debian

创建虚拟环境并安装 Python 依赖（一次性操作）：

bash
python3 -m venv ~/.openclaw/workspace/.venv_pdf
~/.openclaw/workspace/.venv_pdf/bin/pip install weasyprint jinja2

快速开始

bash
~/.openclaw/workspace/.venvpdf/bin/python skills/pdf-report/scripts/renderpdf.py \
--input exports/report-data.json \
--output exports/pdfs/report.pdf

输入参数

• - --input 工作区内 JSON 文件的路径
• --output 工作区内 PDF 输出文件的路径
• 可选：--template-file 工作区内自定义 Jinja2 模板路径
• 可选：--html-out 输出渲染后的 HTML 用于调试

预期的 JSON 结构

json
{
title: 月度报告,
subtitle: 按区域汇总,
generated_at: 2026-03-23 10:00,
summary: [关键点 1, 关键点 2],
sections: [
{
title: 按类别销售情况,
lead: 全国概览,
items: [观察结果 1, 观察结果 2],
table: {
headers: [类别, 金额, 占比],
rows: [[电子产品, 12 450, 45%]]
},
charts: [
{
title: 按类别分布,
src: exports/charts/category.png,
caption: 数据来源：销售数据库
}
],
note: 数据截至 2025年12月31日
}
],
footer: 公司名称 — 部门
}

注意事项

• - 所有文件路径（CLI 参数和 JSON 中的 charts[].src）必须位于工作区内。工作区外的路径将被拒绝。
• 缺失的图表图片会向 stderr 输出警告，但不会阻止 PDF 生成。
• 当某个部分需要图表图片时，先使用 chart-mpl 生成，然后在 charts[].src 中引用这些图片路径。
• 输出目录会自动创建。
• 默认模板：skills/pdf-report/templates/report.html
• 专用虚拟环境：~/.openclaw/workspace/.venv_pdf/（包含 weasyprint 和 jinja2）
• 页面自动编号（右下角：1 / 3）。

自定义模板

使用 --template-file 提供您自己的 Jinja2 HTML 模板。请注意，自定义模板中的相对资源路径（图片、CSS）是从工作区根目录解析的，而不是模板所在目录。对于任何引用的资源，请使用工作区根目录的相对路径。