xhs-cover-skill

小红书封面生成器 - Codex Skill

在 Codex 中直接生成或修改小红书封面。推荐安装到 Codex，这样可以优先调用 Codex 的 GPT Image 2 / 图片生成能力；Gemini 命令行脚本保留为备用方案。

官网：xhscover.vivi.wiki（可在线预览所有风格效果图）

---

效果预览

支持 18 种预设风格，覆盖职场、居家、综艺、文艺等各类场景：

在 Codex 中选择风格后，Skill 会自动完成上图中所有配置步骤，直接输出封面图片。 完整风格效果图可在 xhscover.vivi.wiki 预览。

---

前置要求

• Codex（推荐，可直接调用 Codex 的 GPT Image 2 / 图片生成能力）
• Node.js 18+（仅 Gemini CLI 备用方案和命令行脚本需要，macOS / Linux / Windows 均支持）

---

安装

Codex（推荐）：

git clone https://github.com/Vivixiao980/xhs-cover-skill ~/.codex/skills/xhs-cover-skill
cd ~/.codex/skills/xhs-cover-skill && npm install

重启 Codex 后，Skill 自动生效。在 Codex 中使用时，默认优先走 Codex 自带的图片生成/编辑能力，不需要先配置 Gemini API。

如果只使用 Codex 主流程，npm install 可以跳过；安装依赖是为了启用 Gemini CLI 备用方案和直接命令行脚本。

Claude Code / Gemini CLI 备用方案：

git clone https://github.com/Vivixiao980/xhs-cover-skill ~/.claude/skills/xhs-cover
cd ~/.claude/skills/xhs-cover && npm install

重启 Claude Code 后，Skill 自动生效。没有 Codex 图片生成能力时，会回落到 Gemini API 命令行流程。

OpenClaw：

git clone https://github.com/Vivixiao980/xhs-cover-skill ~/.openclaw/skills/xhs-cover
cd ~/.openclaw/skills/xhs-cover && npm install

然后在 OpenClaw 配置中添加 API Key（可替代 Onboarding 流程）：

# ~/.openclaw/config.yaml
skills:
  entries:
    xhs-cover:
      env:
        XHS_COVER_API_KEY: "你的 API Key"
        XHS_COVER_BASE_URL: "https://generativelanguage.googleapis.com/v1beta/openai"
        XHS_COVER_MODEL: "gemini-2.0-flash-exp-image-generation"

或者使用安装脚本（自动检测平台）：

curl -fsSL https://raw.githubusercontent.com/Vivixiao980/xhs-cover-skill/main/install.sh | bash

---

使用方法

在 Codex 中输入任意触发词即可：

生成封面
小红书封面
制作封面
xhs封面
修改封面

安装在 Codex 中时，Skill 会优先使用 Codex 图片生成/编辑能力。只有在明确使用 Gemini CLI 备用方案，或当前环境没有可用图片生成能力时，才需要完成下面的 API 配置。

---

API 配置（Gemini CLI 备用方案）

Codex 推荐流程不需要单独配置 Gemini API。以下配置仅用于命令行脚本或 Gemini CLI 备用方案。

方案 A：Google AI Studio

1. 访问 aistudio.google.com/apikey 创建 API Key
2. 在 Skill Onboarding 中选择「Google AI Studio」，粘贴 Key 即可

关于免费：Google AI Studio 有免费层级（无需绑卡），但图片生成功能是否在免费额度内会随 Google 的策略调整，建议在 ai.google.dev/gemini-api/docs/pricing 确认最新情况。需要科学上网。

关于模型名称：Gemini 图片生成模型的 API 名称会随版本迭代变化，请在 ai.google.dev/gemini-api/docs/models 确认当前支持图片输出的模型名。

方案 B：第三方 API 代理

支持任意兼容 OpenAI 格式的代理服务（无需科学上网，按量付费）。按需自行选择服务商，配置时提供 Base URL、API Key 和模型名称即可。

配置文件保存在 ~/.config/xhs-cover/config.json：

{
  "apiType": "third-party",
  "apiKey": "your-api-key",
  "baseUrl": "https://your-provider.com",
  "model": "gemini-3-pro-image-preview",
  "outputDir": "~/Desktop/XHS封面",
  "defaultAspectRatio": "3:4"
}

---

命令行直接使用

也可以绕过 Skill，直接调用脚本：

node ~/.codex/skills/xhs-cover-skill/scripts/generate.mjs \
  --image "/path/to/photo.jpg" \
  --style "hand-drawn-border" \
  --title "你的封面大标题" \
  --subtitle "副标题（可选）" \
  --aspect-ratio "3:4" \
  --count 1

支持的参数：

参数	说明	默认值
--image	人物照片路径（必填）	-
--style	风格ID（必填，见下方列表）	-
--title	主标题（必填）	-
--subtitle	副标题	空
--extra	额外要求	空
--count	生成数量（最多5）	1
--aspect-ratio	比例：3:4 / 1:1 / 9:16 / 4:3	3:4
--output-dir	保存目录	~/Desktop/XHS封面
--api-key	API Key	读配置文件
--base-url	API Base URL	读配置文件
--api-endpoint	完整端点URL（Google适用）	读配置文件
--model	模型名称	读配置文件
--rotate	手动旋转：90/180/270	自动EXIF
--no-auto-orient	跳过EXIF自动旋转	false
--test	只测试API连通性	false

---

风格列表

---

注意事项

• 图片会自动读取 EXIF 方向信息并旋转（手机拍摄的竖版照片无需手动处理）
• 图片超过 4MB 会自动压缩
• 建议每次生成间隔 8 秒以上，避免 API 连接问题
• 生成耗时约 30-60 秒

---

贡献指南

欢迎提交 PR！以下几类贡献特别受欢迎：

新增风格

在 styles/ 目录下新建一个 JSON 文件（如 styles/my-style.json）：

{
  "name": "风格中文名",
  "prompt": "详细的中文设计提示词..."
}

参考现有风格格式，确保包含【布局要求】【文字样式】【核心特效】【禁止事项】【氛围】几个区块。同时附上一张效果参考图放到 assets/styles/ 目录。

改进现有提示词

如果你发现某个风格生成效果不好（比如文字乱码、构图不对），欢迎直接修改对应的 prompt 并附上改进前后的对比截图。

其他贡献

• 增加新的图片处理功能（如自动抠图、滤镜）
• 支持更多 API 提供商
• 改进 Onboarding 流程
• 修复 Bug

提交 PR 前请简单描述改动内容，如有效果图更好！

---

License

MIT — 作者：Vivi