SuperAPI AI 工具集

pr-screenshots

设计与创作

查看项目

更新于 10-15 21:52

技能介绍

用途:当 PR 改动了可见内容时使用,例如布局、样式、CSS、图表、仪表盘、数据可视化、UI 组件、表单、弹窗、错误信息、CLI 输出或日志格式。核心做法是把截图直接放进 PR 描述正文,不要用 <details> 折叠,评审者更可能看到无需点击的图片。

主要能力与写法:每个改动用一组前后对比图,配一两句简短说明,让图片承担主要沟通。多个视觉改动时用标题分组,每组各配 before/after 图。截图用原生 1x 分辨率,不要用 PIL 缩放以免产生伪影;图片过大时用 HTML 控制显示尺寸,如 <img src="url" width="600" alt="description">。前后对比必须使用相同视口宽度与裁剪范围,否则比较无意义。

上传方式:Azure DevOps 通过 REST API 以 PR 附件形式上传,需先取令牌,再用 HttpClient 以 POST 提交,API 版本为 7.1-preview.1,描述中引用完整 URL。注意使用 {org}.visualstudio.com 而非 dev.azure.com/{org},用 POST 而非 PUT,同一文件名不能重复上传,需换新名,且不要用 Invoke-RestMethod 以免损坏二进制数据,也不要把图片提交到分支。GitHub 目前为进行中状态,拖拽上传依赖浏览器 Cookie,尚无干净的公开 API;临时方案是提交到 pr-assets 孤儿分支并用 blob URL 引用。

限制:GitHub 图片上传需要变通方案;Azure DevOps 附件文件名不可复用;超过 10MB 的图片在某些平台可能无法内联渲染。改动前应先截取 before 状态,否则事后重建既慢又易错;差异不明显时可配合 image-annotations 技能添加标注。