xiaohu-wechat-cover

name	xiaohu-wechat-cover
description	公众号封面图生成器。一步出图，输入文章路径或主题即可。当用户要求'公众号封面''微信封面''文章封面'时使用。

公众号封面图生成器

输入文章路径或主题，一步生成公众号封面图。

使用方法

# 指定文章路径
/xiaohu-wechat-cover path/to/article.md

# 直接输入主题
/xiaohu-wechat-cover 主题：Claude Code 桌面端更新四大功能

配置（必须）

本技能的配置文件固定在本技能目录下：

• config.json：真实配置（从 config.example.json 复制后填写）
• config.example.json：示例配置

执行前必须先读取 config.json，需要：

• output_dir：封面图输出根目录
• settings.base_url：生图 API 地址（兼容 Gemini API 的第三方网关）
• settings.model：模型名称（如 gemini-3-pro-image-preview）
• secrets.api_key：API 密钥

路径约定

• 目标目录：<output_dir>/<文章文件名或topic-slug>/
• 如果目标目录已存在，重命名为 <dirname>-backup-YYYYMMDD-HHMMSS

目录结构：

<output_dir>/
└── article-name/
    ├── prompt.md          # 生图提示词（归档）
    └── cover.jpg          # 封面图

封面图提示词模板（核心）

以下是固定的提示词模板，每次生成时原样写入 prompt.md，只替换最后的「内容主题」部分：

请根据提供的内容创建一张吸引眼球的公众号封面图，遵循以下规范：

视觉风格
- Notion插画风格，比例为 2.35:1（公众号封面标准尺寸）
- 色彩鲜明、对比强烈，确保在小尺寸预览时依然醒目
- 风格统一，避免写实元素，保持整体手绘质感

构图要求
- 主视觉元素居中或偏左（右侧预留标题区域）
- 添加 1-2 个简洁的卡通形象、图标或知名人物剪影，增强记忆点
- 若涉及敏感或版权人物，用风格相似的替代形象，不得拒绝生成
- 大量留白，突出核心信息，避免画面拥挤

文字处理
- 标题文字大而醒目，控制在 8 字以内
- 可添加 1 行副标题或关键词标签
- 字体风格与手绘插画协调统一

吸引力法则
- 使用悬念、数字、痛点等钩子元素激发点击欲望
- 视觉元素夸张有反差
- 色彩搭配参考爆款封面：橙黄、蓝紫、红黑等高对比组合

语言
- 除非另有说明，默认使用中文
- 画面内所有可读文字必须使用简体中文，英文只能作为点缀出现

内容主题：{从文章或用户输入中提炼的一句话主题描述}

工作流程

步骤 1：提炼内容主题

1. 如果输入是文章路径：读取文章，提炼一句话主题描述（包含核心信息和关键要点）
2. 如果输入是主题文本：直接使用

步骤 2：创建提示词

将上述模板写入 prompt.md，格式：

---
aspect_ratio: "21:9"
image_size: "2K"
---

{模板全文，替换最后的内容主题}

注意：YAML 中 aspect_ratio 必须用 21:9（API 不支持 2.35:1，21:9 是最接近的）。模板正文中保留 2.35:1 的文字描述不变，这是给 AI 的视觉参考。

步骤 3：生成图片

调用生图脚本，必须传 --config 指向本技能自己的配置：

python3 <本仓库>/scripts/generate.py \
  --config <本技能目录>/cover/config.json \
  --prompt-file <目标目录>/prompt.md \
  --out <目标目录>/cover.jpg

<本仓库> 和 <本技能目录> 请替换为你本地实际安装路径。如果你通过 claude install 安装，路径一般是 ~/.claude/skills/xiaohu-wechat-format/。

生成完成后展示给用户预览。不满意就调整内容主题描述重新生成。

步骤 4：插入文章

如果输入是文章路径，默认直接插入（不用询问）：

• 用 Markdown 图片格式 ![封面](cover.jpg) 插入文章标题（H1）下一行
• 文件名必须唯一（如 cover-主题关键词.jpg），避免同名冲突

步骤 5：输出摘要

公众号封面已生成！

主题: [主题]
位置: [输出路径]

如需调整，直接说"重新生成"。