用途:将远程网页或本地 HTML 页面渲染为高清 PNG 截图,默认输出完整长页面,适合网页存档、视觉检查与分享。
主要能力:支持全页与仅视口截图;可设置视口宽高、设备像素比(--scale,默认 4)、导航完成条件(--wait-until load|domcontentloaded|networkidle|commit)、额外等待时间(--wait,默认 5000 毫秒)与导航超时(--timeout,默认 45000 毫秒);可模拟深浅色偏好(--color-scheme dark|light);--visible 可显示 Chromium 窗口便于排查渲染问题。
使用方式:命令需在本 skill 根目录执行,成功时 stdout 仅输出截图绝对路径。示例:python3 scripts/capture.py https://example.com /tmp/example.png;本地开发服务可加 --width 1440 --height 900 --scale 2 --wait 2000;本地 HTML 需用绝对 file:/// 路径;仅截首屏加 --no-full-page;等待 SPA 网络稳定用 --wait-until networkidle。url 省略时默认 http://localhost:2020/,output 省略时默认当前目录 screenshot.png。
适用场景:远程网页与本地开发服务截图、本地构建产物 HTML 截图、动态页面与 SPA 截图、深浅色主题预览。
限制与注意:输出为 PNG,未存在的输出父目录会自动创建;不修改网页源码,也不上传页面内容。缺少 Playwright 需执行 python3 -m pip install playwright,Chromium 缺失需执行 python3 -m playwright install chromium。页面超时可提高 --timeout 或改用 domcontentloaded;异步内容缺失可增大 --wait;图片过大可降低 --scale 或加 --no-full-page。用户未给路径时建议输出到临时目录,完成后反馈绝对 PNG 路径,不要粘贴二进制内容。