capture-pr-visuals
capture-pr-visuals 是一个用于 PR(Pull Request)文档自动化的技能,能够自动抓取运行中应用的截图和 GIF 动图。它通过 Playwright(经 npx 调用)对开发服务器上的页面进行截图和录屏,并读取 chalk.json 中的开发服务器与路由信息;若 chalk.json 不存在,则回退到自动发现框架、端口的机制。该工具支持 React Router、Vue Router 及基于文件的路由,并针对 Electron 应用有专门处理方式(使用独立渲染端口和查询参数路由)。它还分析 PR 变更(git diff)以确定受影响的页面,确保开发服务器运行,安装 Chromium,清理旧截图,生成脚本并执行,随后借助 ffmpeg 将录制的视频转换为 GIF。最终截图递交到 .github/pr-screenshots/ 并提交到分支,同时输出可直接粘贴到 PR 正文的 Markdown 引用,并提示可通过 /create-pr 创建带嵌入式截图的 PR。整个过程中,脚本是临时性的,用后即删,不会修改 package.json 或安装永久依赖。适用于需要为前端改动提供视觉预览的开发流程。