OG 图片
三种图片,共同完成一个任务:让用户在链接上停下来,并在一瞥之间理解这个应用。 每一张都是应用的真实截图,配以大号标题,背景使用品牌色或明亮的壁纸。UI 才是主角。除了边框,一切都不是画出来的。
输出文件位于用户仓库的 launch-assets/og/ 目录:
| 文件 | 尺寸 | 用途 |
|---|---|---|
og.png | 1200×630 | 首页的链接预览。 |
og-<id>.png | 1200×630 | 可选:网站每个页面一张,设计相同,标题来自对应页面。 |
ph/01-<id>.png … 06 | 1270×760 | Product Hunt 画廊,4 到 6 张幻灯片。幻灯片 1 为主视觉。 |
x-header.png | 1500×500 | X 头图,头像和手机裁剪区域保持清晰。 |
meta.html | 要粘贴到 <head> 中的 <meta> 标签。 |
尺寸和安全区域等详细信息,请参考 references/sizes.md。
何时使用
- 发布时需要分享图片、Product Hunt 画廊或 X 头图。
- 网站当前的
og:image只是一个纯色背景上的 logo,或者根本就没有。 - 发布新版本改变了 UI,因此需要从新的截图中重新渲染预览。
截图采用 Mac 风格横向窗口或悬浮岛;这些卡片不支持竖屏手机界面。 不适用于:App Store 截图(那是另一个技能,尺寸不同),或任何需要应用本身没有的 UI 的场景。此技能从不绘制 UI。
设置(一次性)
需要 Node 20 或更高版本。Playwright 安装到此技能文件夹中,而不是用户的仓库:
npm install --prefix <skill-folder> [email protected] && npx --prefix <skill-folder> playwright install chromium
如果缺少依赖,render.mjs 会打印提示信息并以状态码 2 退出。
步骤 0. 品牌信息
读取用户仓库中的 launch-assets/brand.json。如果存在,直接使用。如果缺失,从仓库中检测各个字段并写入文件。仅就你无法找到的信息,在一条消息中询问用户。
{
"appName": "Halo", "oneLiner": "The Dynamic Island for Mac", "platform": "macos",
"colors": { "bg": "#f5f5f7", "ink": "#1d1d1f", "accent": "#0071e3" },
"fonts": { "family": "-apple-system, 'SF Pro Display', sans-serif", "file": null, "google": null },
"iconPath": "site/assets/icon.png",
"screenshotDirs": ["launch-assets/captures"],
"siteUrl": "https://example.com"
}
appName、oneLiner:从 README 的标题和第一行、网站的<title>和<h1>、Info.plist中获取。colors:从网站的 CSS 变量、素材目录的AccentColor、SwiftColor定义中获取。取浅色模式的值。写入十六进制表示(#0d7f76);先转换rgb()、oklch()和hsl()。任何渲染器无法读取的颜色都视为灰色。fonts.family(CSS 字体堆叠)、fonts.file(仓库自带的字体文件,相对于仓库根目录的路径,即launch-assets的上一级目录,或者null)、fonts.google(例如Geist:wght@400;600,或者null)。仅当仓库自带字体文件时才使用品牌字体;否则使用系统堆叠或 Google 字体。切勿将专有字体复制到用户仓库中。iconPath:应用图标,一个方形 PNG(最佳为 1024 像素),相对于仓库根目录。在网站资源、素材目录的AppIcon、favicon 文件夹中查找。必需的:图标和名称出现在每张图片上。siteUrl:meta.html中图片 URL 的指向。可选;没有它,标签将包含占位符。
步骤
-
截图。 重复使用已有的内容:
launch-assets/captures/、screenshotDirs,或之前的launch-assets/store-screenshots/shots.json。仅当没有符合下面规则的截图时才拍摄新的。首先寻找应用自身捕获截图的方式: 快照、演示模式或示例数据标志(在源代码、README 和Package.swift中搜索rg -i "demo|snapshot|screenshot|marketing";例如MyApp --snapshot <dir>或MYAPP_DEMO=1)。在运行之前阅读标志的说明。切勿运行任何扫描、清理或写入真实用户数据的操作,也切勿启动第二个会保留实时状态的应用副本。 如果某个标志可能执行此类操作,立即停止并询问。否则,在 Mac 上,将应用置于前台并显示所需状态,然后运行:swift <skill-folder>/scripts/capture-window.swift "MyApp" capture.png(捕获应用最大的屏幕上窗口,无阴影,Retina 像素;它会跳过刘海或菜单栏应用的面板,因为这些位于更高的窗口层,并会做出提示)。iOS:xcrun simctl status_bar booted override --time 9:41 --batteryState charged --batteryLevel 100,然后xcrun simctl io booted screenshot capture.png,最后xcrun simctl status_bar booted clear。每张截图必须遵守以下规则:
- 真实的 UI,处于焦点。 活动窗口:彩色信号灯、亮起的侧边栏。灰色、暗淡的窗口视为不合格。
- 稳定状态。 没有正在滚动的计数器、没有加载动画、没有半渲染的元素。
- 中立的演示数据。 没有个人姓名、真实文件、项目或账户名称,没有其他公司的产品名称(除非应用自己的网站提到了该集成)。使用演示模式,绝不要使用真实内容的截图。
- 浅色模式(如果应用支持深色模式)。深色截图仅用于纯深色模式的应用。
- 2x 像素。 卡片中截图的放大倍数最多为自身像素的 1.15 倍(超过此值渲染失败),因此链接预览需要窗口宽度约 1400 像素,画廊幻灯片需要约 2000 像素。
- 真实内容。 没有空白的占位区域,没有 lorem ipsum,标题所涉及的部分没有截断的文本。
- 小尺寸下可读。 链接预览中截图的显示宽度约为 600 像素。选择在该尺寸下主要元素可见的截图(如一个大数字、一个清晰的列表),而不是密集的设置面板。裁剪到关键区域。
- 若使用 SwiftUI
ImageRenderer捕获(例如刘海应用的悬浮岛),其边角闪光处会带有不透明的黄色占位符:设置"clean": true。若悬浮岛浮在卡片上,添加"square": true,将其边角闪光处向卡片边缘拉直为方形。使用crop裁剪掉任何空白的刘海行。
当每张截图都通过规则检查后完成。读取每个文件的尺寸(
sips -g pixelWidth -g pixelHeight)并检查其内容。 -
撰写文字。
- 链接标题: 应用的一句话介绍或页面自身的标题,使用网站的原话:不超过 9 个单词,采用句子大小写,不加句号、破折号或
!。这是卡片上唯一的较大文字,因此更短的文字可以更大。 - 页面: 如果仓库有包含多个页面的网站,运行
node <skill-folder>/scripts/pages.mjs <site-folder>。它会打印每个页面的<title>和<h1>。选择值得为其制作独立预览的页面(如指南、定价页、主要功能页);跳过会提到其他公司产品名称的页面。使用<h1>或两者中较短的一个,去掉网站名称后缀和类似“(2026)”的标签,保持不超过 9 个单词。切勿改写。 - 幻灯片: 如果
launch-assets/store-screenshots/shots.json存在,"ph": { "fromShots": "../store-screenshots/shots.json" }会复用其标题、副标题、截图和裁剪(前 6 张截图,"limit"可更改此数量)。否则撰写 4 到 6 张幻灯片:幻灯片 1 说明应用是什么,以后的每张幻灯片叙述一个优势并可以独立理解。标题不超过 6 个单词,可选的副标题为一句短句。 - X 头图标题: 应用的一句话介绍。不超过 6 个单词。
- 替代文本: 一句话说明图片显示的内容。默认格式为
<应用名>: <标题>. <副标题>;当截图有值得说明的内容时,在链接上编写alt属性。
文案使用网站自己的用语。 每一行文字都取自网站或 README 并被缩短;每一个数字、名称和声明都在网站上。在保留每一行之前,使用
rg与网站文案进行核对。 - 链接标题: 应用的一句话介绍或页面自身的标题,使用网站的原话:不超过 9 个单词,采用句子大小写,不加句号、破折号或
-
编写
launch-assets/og/og.json。{ "brand": "../brand.json", "out": ".", "wallpaper": "auto", "link": { "title": "为开发者打造的 Mac 清理工具", "capture": "../captures/overview.png", "alt": "Shedi,一款为开发者打造的 Mac 清理工具:发现 43.84 GB 可清理空间,已分类为安全清理和需检查项" }, "pages": [ { "id": "xcode-deriveddata", "title": "清除 Xcode DerivedData", "capture": "../captures/xcode.png" } ], "ph": { "fromShots": "../store-screenshots/shots.json" }, "x": { "title": "为开发者打造的 Mac 清理工具", "capture": "../captures/overview.png" } }省略
pages、ph或x则跳过相应类型的图片。路径相对于og.json。页面继承link的所有设置(截图、裁剪、布局),并覆盖其指定的属性。link、某个页面、幻灯片或x的可选属性:capture(或captures,最多 3 个,堆叠显示)、crop({ x, y, w, h },范围为截图去除透明边距后的 0 到 1;crops用于多张截图)、clean、square、radius、width(截图宽度占卡片宽度的比例)、shadow: false、minCoverage。layout:链接卡片为side(标题在左,窗口从右下角升起)或below(标题居中,宽截图位于下方)。默认情况下,截图宽高比大于 2:1 时使用below,否则使用side。幻灯片为fit(显示完整截图,不裁剪)、bleed(底部边缘被裁剪,适用于窗口)或pair(堆叠 2 或 3 张截图)。对于没有设置layout、且只有一张普通窗口截图(无clean)的幻灯片,使用bleed;其他情况使用fit。minCoverage:UI 覆盖度的最低要求(链接 0.3,幻灯片 0.4,头图 0.12)。如果截图宽度占卡片宽度的 80% 以上,则无需此条件(细长的悬浮岛或条状元素无法变得更高)。不要为了掩盖小截图而降低此下限:应放大显示、裁剪或选择其他截图。- 在
fromShots的幻灯片中,添加"slides": [{ "id": "<截图 id>", ... }]以覆盖某一张幻灯片的选项。
背景,一次性应用于所有图片:
"wallpaper": "auto"会选择色调最接近品牌强调色(蓝色和青色、绿色、暖色、粉色)的捆绑图片,并打印选择结果及原因。向用户告知选择结果和原因,以及他们可以更改此设置("wallpaper": "snow",或指向他们自己明亮的、平静的图片的路径,宽度至少 2400 像素)。灰色强调色,或与所有图片色调相差超过 50 度的强调色,则使用品牌纯色背景(在品牌背景色上混合少量强调色)。省略此键则使用纯色背景。此技能捆绑了五张图片。 -
渲染。
node <skill-folder>/scripts/render.mjs launch-assets/og/og.json每张 PNG 输出一行:
ok或FAIL、尺寸、文件大小、实际用于绘制标题的字体、文字与其背后像素的对比度、标题的大小和 cap 高度、UI 覆盖度以及截图和壁纸的放大倍数。--only link|pages|ph|x仅渲染一种类型(其他参数失败)。同时写入meta.html。检查失败的情况包括:尺寸不正确、含有 Alpha 通道、文件超过 5 MB、文字对比度低于 4.5:1(不用遮罩层;选择更浅的壁纸或更深的文字颜色)、标题的 cap 高度低于最小值(链接 40 px,幻灯片 38 px,头图 36 px,以便在 600 像素宽的预览中仍然可读)或超过可容纳的行数、包含过长或含破折号(“ - ”或“--”)或
!的文案、截图放大超过 1.15 倍或壁纸放大超过 1.2 倍、UI 覆盖度低于下限(除非截图宽度占卡片宽度的 80% 以上,以截图的内容像素而非边框衡量,因此纯黑或纯白区域不计入)、任何部分超出 X 安全区域或位于头像区域内,以及字体回退:fonts.family中第一个命名字体系列必须是实际绘制标题的字体("Inter, sans-serif"但无字体文件时实际将使用 SF Pro:FAIL)。以-apple-system或system-ui开头的堆叠表示使用系统字体,仅在回退到如 Helvetica 或 Arial 等其他字体时才判定为失败。修正og.json中的每一个FAIL并重新渲染。 -
QA 检查。必需,且针对文件而非配置进行。
- 尺寸和 Alpha 通道:
sips -g pixelWidth -g pixelHeight -g hasAlpha <每个文件>。尺寸必须严格符合 sizes.md 中的规定,hasAlpha: no。 - 查看: 使用“读取”工具以原尺寸打开每张 PNG。然后运行
node <skill-folder>/scripts/preview.mjs launch-assets/og,并打开_preview-600.png和_preview-300.png(每张图片分别以 600 和 300 像素宽度显示,类似信息流中的展示效果),然后删除这两个文件。对每张图片检查:- 标题在 300 像素宽度下可读,没有内容被裁剪或单独出现在第二行。
- 输出行中的字体是你指定的字体。
- 截图清晰,显示了标题所针对的要点,没有截断的文字和个人数据。
- 名称:没有竞争对手或其他公司的名称或 logo,除非网站提到了该集成;没有个人姓名。
- 文字:每一行都是网站自己的措辞,经过缩短;每一个数字都来自网站。
- X 头图:左下角(x 小于 420,y 大于 300)为个人资料照片保持空白;内容位于中间区域,远离顶部和底部各 70 像素的区域。对照 sizes.md 进行检查,如果可能,在真实个人资料页上查看。
- 系列:所有幻灯片看起来属于同一系列;没有两张表达相同要点。
- 修改并重新渲染,然后再次查看该文件。
- 只有在此之后才报告:文件列表、
sips输出结果以及任何你无法验证的内容。告知用户将 PNG 复制到网站,将meta.html粘贴到<head>中,并在每个平台的调试器中刷新缓存的预览。
- 尺寸和 Alpha 通道:
外观规则
- 优先浅色。 使用明亮的壁纸或品牌纯色背景,深色文字放在其上。不要使用深色背景配霓虹色。
- 无发光,无光晕。 深度效果仅为 1 像素边框和低透明度的中性黑色阴影。
- 每张图片一个任务。 一个标题,一张截图(或一组对比图),最多一行副标题。
- 大号字体。 标题是在缩略图中能够存活下来的元素。短文案才能让标题足够大。
- 仅使用真实截图。 UI 绝不通过绘画、重绘或生成的方式制作。