微信公众号文章转 PDF

要解决什么问题

微信公众号文章在浏览器里阅读方便，但离线归档、打印或交给不支持微信环境的工具时，复制粘贴往往会丢图、乱版。公众号页面还叠着评论区、底部工具栏、二维码等干扰元素，直接用「打印为 PDF」也经常裁错区域或漏掉懒加载图片。

技能如何工作

本技能围绕捆绑脚本 scripts/wechat_to_pdf.py，用 Playwright 无头 Chromium 打开你提供的 mp.weixin.qq.com 链接，在页面内完成渲染后再导出 PDF。

典型流程可以概括为：

• 校验 URL：只接受 https://mp.weixin.qq.com/s/... 或带 __biz 的公众号文章地址，其它域名直接拒绝并说明原因。
• 依赖检查：执行前确认已安装 playwright；缺失时按技能说明安装，避免跑到一半才失败。
• 确定输出路径：可用 -o 指定文件或目录；未指定时按文章标题命名并写到当前工作目录。
• 页面侧处理：等待正文加载；滚动页面触发懒加载；处理微信常见的 data-src 懒加载；注入 CSS 隐藏评论、工具栏、二维码等非正文区域。
• 生成 PDF：按参数选择纸张（默认 A4）、页边距与背景色，写出文件后核对退出码为 0 并回报路径与大小。

命令行上，url 为必填；--format / -f、--timeout / -t 用于版式与加载超时（默认 60 秒）。

适用边界与注意点

• 仅适用于微信公众号文章页，个人聊天链接、外链或非 mp.weixin.qq.com 均不在支持范围。
• 网络超时或页面结构变更可能导致加载失败；可尝试增大 -t，若正文区域选择器失效，需对照 references/wechat-css-selectors.md 更新 DOM/CSS 策略。
• 图片异常时，技能已内置懒加载修复；若仍缺图，多半是页面结构变化或资源被拦截，需结合参考文档排查而非重复盲跑。