用途:当用户需要创建、生成或导出 PDF 文档时,该技能为代理提供文档生成相关的代码模式与实现指导,支持从 Markdown、HTML、JSON、模板等多种来源生成 PDF,并涉及格式化、样式与批处理。
范围:该技能仅提供 PDF 生成的代码模式与实现指引,说明工具选型、打印用 CSS 与文档结构,并给出常见文档类型的参考示例;它不执行代码、不直接生成文件、不发起网络请求,也不访问用户工作目录之外的文件,所有代码示例均为供用户自行实现的参考模式。
工具选型建议:Markdown 推荐 pandoc(原生支持、目录、模板);HTML/CSS 推荐 weasyprint(CSS 支持最佳,无需 LaTeX);数据/JSON 推荐 reportlab(编程式、控制精确);简单文本推荐 fpdf2(轻量快速)。默认推荐:多数基于 HTML 的文档使用 weasyprint。
核心规则:先结构后样式,使用语义化标签而非纯样式 div;显式处理分页,如 page-break-before、page-break-inside、page-break-after 等;始终设置元数据(标题、作者);使用面向打印的 CSS,包括 @media print 与 @page 的尺寸和页边距设置;生成后校验输出,检查文件大小是否为 0、页数与字体渲染是否正确。
常见陷阱:缺少字体会回退到默认字体;使用绝对图片路径会导致图片缺失;未设置页面尺寸会造成布局不可预测;大图片会使文件过大。对应修复为使用网络安全字体、相对路径、设置 @page size 及预先压缩图片。
安全与隐私:属于参考型技能,仅提供模式与指导。所有 PDF 生成在用户本机进行,数据不外发;不执行代码、不生成文件、不发起网络请求、不访问系统文件。
其他:快速参考涉及 tools.md(工具选型)、templates.md(文档类型)、advanced.md(高级操作)。收费、价格与平台支持等事实暂未提供。