核心用法
Puppeteer 技能将 Node.js 的 Puppeteer 库封装为可直接调用的自动化环境，支持无头或有界面的 Chromium 浏览器控制。典型场景包括：
- 网页抓取：导航、等待元素、提取结构化数据
- 端到端测试：模拟用户点击、表单填写、断言页面状态
- 截图与 PDF：整页、元素级截图或导出 PDF 报告
- 自动化工作流：定时任务、批量数据处理
所有脚本存放于 ~/puppeteer/scripts/，输出定向至 ~/puppeteer/output/，通过 memory.md 维护执行状态。
显著优点
1. 浏览器级控制：基于 DevTools Protocol，可拦截网络请求、注入脚本、管理 cookies，比 HTTP 客户端（如 axios）更能处理动态渲染页面。
2. 确定性等待策略：内置 waitForSelector、waitForNavigation 等机制，显著降低 flaky test 概率（文档强调 90% 的点击失败源于未等待）。
3. 现代 Chromium 支持：持续跟进浏览器新特性，如 headless: 'new' 模式绕过部分反爬检测。
4. 本地数据闭环：明确承诺不向外传输抓取数据，敏感信息（登录态、用户数据）完全驻留本地目录。
潜在缺点与局限性
- 资源消耗：每个浏览器实例占用 100-300MB 内存，高并发场景需进程池管理。
- 反爬对抗：部分站点检测
navigator.webdriver或 headless 特征，需额外配置（user-agent、viewport、stealth 插件）才能绕过。 - Shadow DOM 限制：原生选择器无法穿透封闭 shadow root，需借助
evaluateHandle或扩展库，增加代码复杂度。 - Node.js 依赖：要求系统预装 Node 运行时，Windows/macOS/Linux 兼容性需验证本地环境。
适合人群
- 前端开发者：需要跨浏览器一致性测试或可视化回归测试。
- 数据工程师：从 JavaScript 渲染的 SPA（单页应用）提取数据。
- DevOps/QA：构建 CI/CD 中的自动化验收测试流水线。
- 安全研究者：分析页面行为、生成证据截图或审计 DOM 结构。
常规风险
| 风险类别 | 说明 | 缓解建议 |
|---------|------|---------|
| 资源泄漏 | 未关闭浏览器进程导致内存/端口耗尽 | 强制使用 try/finally 包裹 `browser.close()` |
| 访问违规 | 高频请求触发目标站点封禁 | 配置随机延迟（1-3s）、遵守 robots.txt |
| 敏感数据暴露 | 本地截图/PDF 包含隐私信息 | 输出目录设置权限限制，及时清理 |
| 供应链攻击 | 依赖的 Puppeteer 或 Chromium 被篡改 | 锁定版本号，使用 lockfile 校验 |
评估结论
该技能为浏览器自动化领域的工业标准工具封装，功能边界清晰，安全模型以本地隔离为核心。适合具备 Node.js 基础的开发者，在合规前提下可显著提升 Web 自动化任务的可靠性与可维护性。