SuperAPI AI 工具集

make-pdf

办公与效率

查看项目

更新于 10-16 08:11

技能介绍

用途:把 Markdown 或 HTML 文件通过 Nutrient DWS Build API 转成成品 PDF。相比本地 chromium --print-to-pdf 或 Pandoc,其差异在输出阶段:同一次调用可生成带标签的无障碍 PDF/UA 或归档 PDF/A,并可加盖对角文字水印。

主要能力:Markdown 输入用 CommonMark+GFM 解析(支持表格、删除线、任务列表),套用模板并内联主题 CSS 后上传单个自包含 HTML;HTML 输入原样上传。支持 --accessible(PDF/UA)、--pdfa(配合 --pdfa-level,取值 pdfa-1a/1b/2a/2b/2u/3a/3u,默认 pdfa-2b)、--watermark、--template memo、--theme dark、--title/--subtitle/--author/--date 等元数据,以及 --html-only 离线预览、--output-html 输出中间 HTML。

使用方式:先导出密钥 export NUTRIENT_API_KEY="nutr_sk_..."(NUTRIENT_DWS_API_KEY 可作后备,--html-only 与冒烟测试不需要)。生成命令:uv run scripts/make-pdf.py --input report.md --out report.pdf。批量:--input 指向目录并必须指定 --out <dir>,转换目录内 .md/.markdown/.html/.htm(非递归,最多 4 并发)。--accessible 与 --pdfa 互斥。

验证:带合规标志时构建后自动校验(--no-verify 可关闭),退出码 3 表示已生成但验证失败。结构检查通过 scripts/verify-pdf.py 完成;若 PATH 中有 veraPDF 则执行完整一致性审计。该脚本也可独立校验任意 PDF。

限制:DWS 用无头 Chromium 渲染,position: running()、counter(page)、target-counter() 等 CSS Paged Media 特性不会渲染,无法承诺页码目录或页眉页脚。外部图片需 DWS 侧联网获取,本地引用图片在 v1 不会上传,需以 data: URI 内嵌。批量模式不覆盖已有输出。生成、签名/脱敏/合并、修复旧 PDF 分属不同技能。