SuperAPI AI 工具集

generate-release-screenshots

前端与建站

查看项目

更新于 10-16 02:39

技能介绍

用途:为 tfplan2md 仓库的发布说明和文档生成实际 PNG 截图,避免用 markdown 链接指向源文件或引用不存在的图片。

主要能力:通过仓库脚本生成聚焦的发布说明截图(scripts/generate-release-screenshots.sh,含重试与错误报告),或用 scripts/generate-screenshot.sh 做单张精细控制(明暗主题、DPI、裁剪)。可用 --plan 或 --markdown-file 作为输入,用 CSS 选择器或 --target-terraform-resource-id 定位要截取的内容;发布说明截图上限 580×400 像素,仅使用 -crop.png 或用 release wrapper 生成的单张图。

使用方式:生成前必须先安装 Playwright。先构建项目:dotnet build src/tools/Oocx.TfPlan2Md.ScreenshotGenerator/,再用 .NET 项目的脚本安装 Chromium:pwsh src/tools/Oocx.TfPlan2Md.ScreenshotGenerator/bin/Debug/net10.0/playwright.ps1 install chromium --with-deps。不要使用 npx playwright install,npm 版本与 .NET 包版本不一致会导致浏览器版本不匹配。生成报告时加 --details open 以展开资源详情。生成后须校验 PNG 存在于预期路径、视觉确认内容正确(非空白或报错),再添加 markdown 引用;发布说明中必须使用绝对 raw.githubusercontent.com URL(相对路径在 GitHub Release 页面会失效),并在引用前核对实际文件名。

限制与注意:若截图生成因超时或工具问题失败,不得继续发布或提交失效图片引用,应上报维护者。选择器需与实际视觉变更匹配,否则会截到无关内容。网站截图另有 website-visual-assets 技能,本技能未提供其细节。