Community影像github.com

社群分享圖片與圖示產生器

為 Next.js App Router 網站建立 1200×630 的 Open Graph 圖片(使用 next/og ImageResponse)、Twitter/X 卡片標籤、favicon、應用程式圖示與 Apple touch icon,以及每篇文章的獨立 OG 圖片,並透過驗證腳本檢查。當使用者提到 OG 圖片、社群預覽、連結預覽、分享卡片、Twitter 卡片、favicon 或應用程式圖示,或網站連結在 X、LinkedIn、Slack、Discord 或 WhatsApp 上沒有顯示圖片時使用。

社群分享圖片與圖示產生器 是什麼?

這個技能讓 AI 助理能夠自動為基於 Next.js App Router 的網站建立並驗證所有必要的社群分享圖片與圖示。它涵蓋了全站與每頁的 Open Graph 圖片(1200×630)、Twitter 卡片(summary_large_image)、favicon、應用程式圖示(512x512)以及 Apple touch icon(180x180),並確保圖片在社群平台上正確顯示。技能會優先檢查專案結構,包括 `app/` 資料夾中的既有圖片、根佈局的 `metadataBase` 設定(若缺少則會建議新增),以及 `next.config.*` 中的靜態匯出設定。它支援在 `opengraph-image.tsx` 中使用 `ImageResponse` 搭配自訂字型與品牌元素,並能為動態路由區段(如部落格文章)產生獨立的 per-page OG 圖片。最後,技能透過一個無相依性的驗證腳本 (`check-og.mjs`) 執行完整檢查,確認所有圖片標籤的絕對 URL、HTTP 狀態、檔案大小、尺寸(1200×630)以及 `og:image:alt` 和 `twitter:card` 標籤是否正確。這個技能對於確保網站連結在社群平台上的呈現效果至關重要,能有效提升品牌專業度與點擊率。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/nandot12/nextjs-launch-skills/tree/main/skills/launch-social-images

Installed? Explore more 影像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

社群分享圖片與圖示

當使用者在 X、LinkedIn、Slack、Discord 或 WhatsApp 貼上網站連結時,應該出現一張包含可讀標題的大圖。瀏覽器與手機應顯示清晰的圖示。

1. 檢查

  • App 資料夾(src/app/ 或 app/),現有的 favicon.ico、icon.*、apple-icon.*、opengraph-image.*、twitter-image.*。
  • 根佈局中的 metadataBase。缺少時,og:image 網址會是相對路徑,社群平台會忽略它們。 如果缺少此設定,請新增(參見 launch-seo 技能,或設定 metadataBase: new URL("https://your-domain.com"))。
  • next.config.*:output: "export"?
  • 品牌資訊:名稱、標語、主色、標誌(偏好 SVG)。從 globals.css 重複使用 token。
  • 閱讀對應版本的官方文件:
    • node_modules/next/dist/docs/01-app/03-api-reference/03-file-conventions/01-metadata/opengraph-image.md
    • node_modules/next/dist/docs/01-app/03-api-reference/03-file-conventions/01-metadata/app-icons.md
    • node_modules/next/dist/docs/01-app/03-api-reference/04-functions/image-response.md

2. Open Graph 圖片(全站)

將 assets/opengraph-image.tsx 複製到 app/opengraph-image.tsx,並編輯品牌數值。它匯出 alt、size(1200×630)和 contentType,並使用來自 next/og 的 ImageResponse 繪製圖片。

分享圖片的設計規則:

  • 標題字數 3–8 個字,至少 64 px,高對比。在 300 px 寬的縮圖上必須可讀。
  • 將重要內容保持在中央 1000×500 區域內;部分平台會裁切邊緣。
  • 在角落放置品牌標記 + 網域名稱,讓人知道連結去向。
  • 僅使用 Flexbox:ImageResponse 支援 CSS 的子集(display: flex,無 grid)。每個包含多個子元素的元素需要 display: "flex"。
  • 字型:預設字型可直接使用。若要使用自訂字型,請載入 .ttf/.otf/.woff 檔案(非 .woff2),使用 readFile 並在 fonts 選項中傳遞,如文件所示。
  • 大小限制:Open Graph 為 8 MB,Twitter 為 5 MB。產生的 PNG 通常小於 100 KB。

twitter-image 為選用:當缺少時,X 會使用 Open Graph 圖片。請確保根 metadata 設定 twitter: { card: "summary_large_image" }。

3. 每頁圖片(部落格文章、文件、產品頁面)

在動態路由區段內新增 opengraph-image.tsx,例如 app/blog/[slug]/opengraph-image.tsx。它接收 params(一個 Promise)並可以載入文章標題;從圖片檔案匯出 generateStaticParams,以便預先渲染每張圖片。保持相同的模板,讓所有分享看起來像同一個品牌。

這比看起來更重要:當某頁面在 metadata/generateMetadata 中設定自己的 openGraph 時,它會取代父層的 openGraph 物件,導致該頁面的根分享圖片消失。區段層級的 opengraph-image 檔案(或明確的 openGraph.images)可以解決此問題。

4. 圖示

檔案(在 app/ 中)尺寸用途
favicon.ico32×32(可為多重尺寸)瀏覽器分頁,應用程式根目錄必須
icon.png 或 icon.svg512×512 PNG 或 SVG現代瀏覽器,Android
apple-icon.png180×180iOS 主畫面

您也可以使用 ImageResponse 產生 icon.tsx / apple-icon.tsx — 參見 assets/icon.tsx。在上線前取代預設的 create-next-app favicon.ico;如果沒有可用的 .ico 工具,使用 32×32 的 icon.png 並移除舊的 favicon.ico 是可以接受的。

5. 靜態匯出注意事項

使用 output: "export"(在 Next.js 16.4 上測試):

  • 靜態匯出必須關閉 cacheComponents,並且每個產生的圖片檔案(opengraph-image.tsx、icon.tsx、apple-icon.tsx)需要 export const dynamic = "force-static";,否則建置會失敗。動態區段也需要 generateStaticParams。
  • 產生的圖片在匯出時沒有副檔名(out/opengraph-image),因此靜態主機在提供服務時沒有 Content-Type 標頭(已在 Cloudflare Pages 上驗證)。部分爬蟲會拒絕這種情況。全站圖片的最佳解決方案:開啟執行中網站的 /opengraph-image,儲存它,並提交為 app/opengraph-image.png(然後刪除 .tsx 檔案);它會以正確類型匯出為 opengraph-image.png。圖示也相同(app/icon.png、app/apple-icon.png)。對於每篇文章的圖片,請在主機的標頭檔案中(Cloudflare Pages/Netlify 上的 public/_headers)為這些路徑設定 Content-Type: image/png。

6. 驗證

  1. npm run build 必須通過。建置輸出會列出 opengraph-image 路由。

  2. 啟動網站(npm run start,或提供 out/ 資料夾)並執行檢查腳本(Node 18+,無相依套件)。<skill-dir> 是包含此 SKILL.md 的資料夾:

    node <skill-dir>/scripts/check-og.mjs http://localhost:3000/ http://localhost:3000/blog/some-post
    

    它會讀取頁面的 og:* 和 twitter:* 標籤,下載圖片,並檢查絕對 URL、HTTP 狀態、檔案大小、尺寸(1200×630)、og:image:alt 和 twitter:card。如果標籤中包含 localhost URL,則會回報,因為這表示 metadataBase 在正式環境中遺失或不正確。

  3. 在瀏覽器中開啟圖片 URL 並檢視。確保當瀏覽器視窗較窄時,文字仍然可讀。

  4. 部署後,告訴使用者使用各平台自己的工具進行測試(LinkedIn Post Inspector、Facebook Sharing Debugger)。這些工具也會重新整理快取的預覽。

報告

列出已建立的圖片和圖示檔案、檢查腳本的輸出,並提醒使用者平台會快取預覽:更改圖片後,請使用上述工具重新抓取。

相關技能