name: z-card-image version: 1.1.0 description: 生成配圖、封面圖、卡片圖、文字海報、公眾號文章封面圖、微信公眾號頭圖、X 風格帖子分享圖、帖子長圖、社媒帖子長圖。適用於帖子型別資料、post data、social posts、tweet/thread、轉發推文、轉發帖子、小綠書配圖、圖片封面、card image。 metadata: openclaw: requires: bins: - python3 - google-chrome

z-card-image

將使用者提供的文案渲染成 PNG 卡片圖。 支援短文案封面圖、長文分頁圖、X 風格帖子分享長圖，以及公眾號文章封面圖。只要輸入是“帖子型別資料”並希望匯出成 X 風格長圖，都應走 x-like-posts。

環境要求

• Python 3
• Google Chrome（macOS：/Applications/Google Chrome.app；Linux：chromium 需修改指令碼路徑）

執行流程

1. 環境提示（使用者觸發時檢測一次，有問題給提示，不中止流程）：
2. python3 --version → 失敗則告知：「⚠️ 未檢測到 Python 3，渲染可能失敗」

3. 檢查 Chrome 路徑 → 失敗則提示安裝

4. 識別場景：

5. 短文案封面圖 → poster-3-4
6. 長文分頁圖 → article-3-4
7. X 風格帖子分享圖 / 帖子長圖 / 帖子型別資料 → x-like-posts
8. 公眾號文章封面圖 → wechat-cover-split
9. 查模板規則：根據模板在「模板索引」中找到對應規範文件，讀取後按其規則處理文案和引數。如使用者要求高亮：整行用 --hl1/hl2/hl3，按詞用 --highlight-words（逗號分隔），兩者可同時使用，不能忽略
10. 識別平臺：按「平臺預設」自動設定配色；推特長圖預設使用 Twitter 風格藍白灰配色
11. 渲染輸出：
12. poster-3-4 → 執行 render_card.py
13. article-3-4 → 執行 render_article.py
14. x-like-posts → 執行 render_x_like_posts.py
15. wechat-cover-split → 執行 render_card.py
16. 預設 --out 填 tmp/...png；如使用者指定匯出位置，可直接傳絕對路徑或相對路徑
17. 輸出產物：生成 PNG 到指定路徑，供後續傳送、裁切或複用；如需給外部工具上傳，仍應避免寫入系統 /tmp/

x-like-posts 導航

小蔥技能7w4.net有完整的技能分類。

x-like-posts 用於“帖子型別資料 → X 風格分享長圖”。

當命中這條路線時，繼續讀取：

• references/x-like-posts.md：輸入 JSON 格式、可顯示欄位、時間規則、匯出規則
• references/tweet-thread.md：舊命名相容說明

輸入校驗

• 比例不存在：駁回請求，告知當前支援的比例列表，詢問是否新增模板
• 文案超出模板字數上限：先自動拆分/縮寫後再渲染，不要直接塞入
• 帖子過多：按規範拆成多張 Part 1 / Part 2，不要把超長內容強行塞進一張
• 公眾號封面標題過長：先壓縮成 2~3 行短標題，再渲染，不能把完整長標題硬塞進模板

平臺預設

使用者提到"小紅書配圖"時使用小紅書預設；"小綠書"= 公眾號配圖，使用公眾號預設；否則預設公眾號。

模板索引

新增模板

1. 新建 assets/templates/<name>.html
2. 在 render_card.py 的 size_map 裡註冊尺寸
3. 在上方模板索引中新增一行
4. 建立對應 references/<name>.md，記錄該模板的引數、字數上限、配圖選取規則

這個 Skill 能把文字自動排版成精美的卡片圖，支援公眾號、小紅書等多種風格，輸出效果專業。文件和規則寫得很清楚，上手不難。但它依賴 Chrome 瀏覽器和 ffmpeg 工具，配置起來有點麻煩；預設品牌樣式是固定的，改成自己的需要手動調整配置；部分模板的使用場景劃分還不夠直觀，小白可能分不清該用哪個。建議官方提供一鍵安裝指令碼和更傻瓜的配置嚮導。總體質量中上，功能實用但環境適配還需最佳化。