SuperAPI AI 工具集

html-to-pdf

前端与建站

查看项目

更新于 10-15 20:29

技能介绍

用途:把 HTML 网页或演示文稿转成 PDF。核心是先判断用户要视觉最高还原、文字可选中,还是正式打印文档,再选择对应策略;默认不直接执行,先给用户简短建议并等待选择,除非用户已明确指定。

主要能力: 策略1 CDP 屏幕截图级保真,走 Chrome 屏幕模式,适合翻页演示(slides-raster)或连续长页(long-raster),保留 canvas、WebGL、backdrop-filter、复杂背景等,但文字不可选、文件较大。 策略2 CDP screen-media 向量 PDF(screen-vector),文字通常可选中,视觉接近屏幕但不算截图级,复杂滤镜或横向 transform 型 slide 可能不稳。 策略3 print 向量连续长页(onepage_pdf.py),适合报告、文章、正式文档,文本可选、体积较小、分页稳定,但走 print media,不保证与屏幕一致。

用法:先读 HTML 判断页面类型,再按策略执行脚本。例如 slides-raster:python3 ~/.claude/skills/html-to-pdf/scripts/render_slides_cdp.py "{input.html}" -o "{output.pdf}" --strategy slides-raster --width 1280 --height 720 --dpr 2 --format png;screen-vector 用 --strategy screen-vector;print 长页用 python3 ~/.claude/skills/html-to-pdf/scripts/onepage_pdf.py "{input.html}" -o "{output.pdf}" --width 1280 --extra-css /tmp/onepage-fixes.css。常用参数含 --dpr、--format、--selector、--ready-expr、--tile-height、--bedrock、--crop、--virtual-time、--replace、--forbid。

限制与验证:转换后须用 pymupdf 检查页数、前几页尺寸与截图,确认无截断、空白、错位。print 策略需先检查响应式断点、backdrop-filter、vh/vw、滚动动画等差异。截图策略文字不可选是预期结果;向量策略视觉差异明显时可退回截图级。缺失信息:具体安装方式、运行环境要求、许可证细节暂未提供。