article-to-wechat-cover

name	article-to-wechat-cover
description	从飞书文档或本地 Markdown 提炼文章主题与风格，调用 OpenRouter 的 Nano Banana / Gemini Flash Image 生成 2.35:1 的微信公众号封面图，并可选上传为微信封面素材。
version	0.1.0
author	Hermes Agent
license	MIT
metadata	{"hermes":{"tags":["wechat","cover","feishu","lark","markdown","nano-banana","openrouter","image-generation"]}}

Article to WeChat Cover

当用户想要：

• 为一篇飞书文档生成微信公众号封面图
• 为一篇本地 Markdown 文章自动生成公众号头图
• 让封面图主题跟随文章内容自动变化
• 复用 Nano Banana / OpenRouter 图片生成链路做公众号封面
• 在用户确认最终 prompt 后，把生成图片自动插入飞书文档最顶部作为 Hero 图

就用这个 skill。

目标

这个 skill 会做三件事：

1. 读取文章内容（飞书文档 URL / token，或本地 Markdown）
2. 用 OpenRouter 文本模型提炼：
   • 文章核心主题
   • 文章视觉风格
   • 适合公众号封面的构图与主视觉
3. 先输出最终版生图 prompt 给用户确认
4. 只有确认后，才用 OpenRouter 图片模型（Nano Banana / Gemini Flash Image）生成 2.35:1 微信公众号封面图

默认要求：

• 宽高比固定 2.35:1
• 画面体现文章核心主题
• 风格由文章内容语气、领域、表达风格共同决定
• 默认不渲染多余文字，避免把公众号封面做成低质海报

新增封面方法：汤底 + 佐料 + 文章巧思

这次吸收小小东 X 文章里的封面方法：封面生成不要每篇都从零发散，而是固定一套“汤底”，再从可复用“佐料库”里选一种风格，最后只根据标题/主题改一两个关键元素。

固定汤底

核心规则：

• 先理解文章为什么值得被看见。
• 把复杂信息收束成一个清晰、有力、耐看的推荐理由。
• 手机端 3 秒可读。
• 信息少而准，留白有呼吸感。
• 主视觉来自文章/对象本身的气质，不做泛化 AI 科技图。

内置 10 组佐料

当前脚本内置：

• 建筑图纸美学
• 科技莫兰迪
• 力量编辑感
• 东方文人
• 电影片头
• 园艺手账
• 治愈线条
• 产品手册
• 艺术展览
• 综艺预告

文本模型会先从这 10 组中选 1 组，输出：

• selected_recipe_id
• selected_recipe_reason
• recipe_adaptations：只允许 1-3 个文章专属改动
• cover_message：封面 3 秒内要传达的一句话

Prompt 分层

生成链路现在分三层：

1. analysis brief：理解文章。
2. review_spec：给人审的结构化封面方案，包含汤底、佐料、巧思。
3. execution_spec：真正喂给图片模型的瘦身 JSON，只保留会影响画面的字段。

这样能避免把流程说明、内部字段、解释文字一股脑塞给图片模型。少点废话，图更稳。

输入来源

支持两种：

1) 飞书文档

python3 scripts/run.py from-feishu-doc \
  --doc 'https://xxx.feishu.cn/docx/xxx' \
  --final-prompt-output /tmp/wechat-cover-prompt.txt

2) 本地 Markdown

python3 scripts/run.py from-markdown \
  --input ./article.md \
  --final-prompt-output /tmp/wechat-cover-prompt.txt

输出

成功后会输出：

• 本地封面图路径（仅在已确认并真正生图后）
• 主题分析 JSON 路径（可选）
• 图片 JSON spec 路径（可选）
• 最终版生图 prompt（可打印，也可写入文件）
• 可选 feishu_url
• 可选 thumb_media_id

必须先确认最终 prompt

这个 skill 现在默认采用两阶段流程：

阶段 1：先生成最终版生图 prompt，给用户确认

推荐：

python3 scripts/run.py from-feishu-doc \
  --doc 'https://g1mu6da08l.feishu.cn/docx/xxxx' \
  --final-prompt-output /tmp/wechat-cover-prompt.txt

或：

python3 scripts/run.py from-markdown \
  --input ./article.md \
  --final-prompt-output /tmp/wechat-cover-prompt.txt

这一步会：

• 先分析文章主题与风格
• 生成最终版生图 prompt
• 在终端打印 prompt 预览
• 可选写入 --final-prompt-output
• 不会真的调用图片模型生图

如果命令输出里看到：

generation_skipped=pending_user_confirmation

说明流程正常停在“待确认”阶段。

阶段 2：确认后，再真正生图

只有在用户确认最终 prompt 没问题后，才重新执行并加上：

--confirm-generate

例如：

python3 scripts/run.py from-feishu-doc \
  --doc 'https://g1mu6da08l.feishu.cn/docx/xxxx' \
  --final-prompt-output /tmp/wechat-cover-prompt.txt \
  --output ./wechat-cover.jpg \
  --confirm-generate

经验规则：

• 不要在第一次分析出 prompt 后立刻自动生图
• 必须先把 final prompt 发给用户审阅
• 用户确认后，才允许 --confirm-generate

补充经验：

• 图片模型实际可能返回 image/jpeg，即使你手动把输出文件写成 .png
• 因此脚本应按返回的 mime_type 自动修正输出后缀，避免出现“JPEG 内容却使用 PNG 扩展名”的混淆
• 如果用户显式传入了一个不匹配的输出路径，CLI 最好打印一个 output_adjusted_from=... 提示，便于排查

统一入口命令

飞书文档 → 生成封面

python3 scripts/run.py from-feishu-doc \
  --doc 'https://g1mu6da08l.feishu.cn/docx/xxxx' \
  --output ./wechat-cover.png

本地 Markdown → 生成封面

python3 scripts/run.py from-markdown \
  --input ./article.md \
  --output ./wechat-cover.png

常用参数

• --output：输出图片路径
• --upload-feishu：生成后上传飞书云盘
• --upload-wechat-cover：直接上传成微信封面素材，返回 thumb_media_id
• --analysis-json：导出文章主题分析 JSON
• --dump-json-spec：导出最终图片 JSON 规格
• --final-prompt-output：导出最终版生图 prompt，便于发给用户确认
• --confirm-generate：只有用户确认最终 prompt 后，才允许真正生图
• --insert-into-feishu-doc-top：生成后把 Hero 图自动插到飞书文档正文最顶部
• --replace-existing-top-image / --no-replace-existing-top-image：插入 Hero 图时是否替换已有顶部图片
• --image-model：覆盖默认图片模型
• --text-model：覆盖默认文本模型
• --provider-order：OpenRouter provider 顺序，默认 Vertex AI
• --visual-style-hint：人工补充风格偏好
• --must-include：逗号分隔，指定必须出现的视觉元素
• --must-avoid：逗号分隔，指定必须避免的视觉元素
• --allow-text-overlay：允许封面内出现少量标题文字（默认关闭）

与飞书文档 → 微信草稿箱 skill 的关系

这个 skill 不直接替代 feishu-doc-to-wechat-draft，而是作为它的前置封面生成步骤。

推荐组合方式：

1. 先用本 skill 生成封面图
2. 若需要，直接 --upload-wechat-cover 拿到 thumb_media_id
3. 再把这个 thumb_media_id 交给 feishu-doc-to-wechat-draft

例如：

python3 scripts/run.py from-feishu-doc \
  --doc 'https://xxx.feishu.cn/docx/xxx' \
  --final-prompt-output /tmp/wechat-cover-prompt.txt

确认 prompt 没问题后，如果你想把生成图直接插回飞书文档最顶部：

python3 scripts/run.py from-feishu-doc \
  --doc 'https://xxx.feishu.cn/docx/xxx' \
  --final-prompt-output /tmp/wechat-cover-prompt.txt \
  --confirm-generate \
  --insert-into-feishu-doc-top

如果还要同时上传成微信封面素材：

python3 scripts/run.py from-feishu-doc \
  --doc 'https://xxx.feishu.cn/docx/xxx' \
  --final-prompt-output /tmp/wechat-cover-prompt.txt \
  --confirm-generate \
  --insert-into-feishu-doc-top \
  --upload-wechat-cover

然后把输出的 thumb_media_id 用于：

python3 ~/.hermes/skills/productivity/feishu-doc-to-wechat-draft/scripts/run.py publish-feishu-doc-default \
  --doc 'https://xxx.feishu.cn/docx/xxx' \
  --thumb-media-id 'MEDIA_ID'

设计原则

1. 主题来自文章，不靠人工硬写 prompt

脚本会先从标题、摘要、正文提炼主题与风格，再生成图片 prompt。

2. 公众号封面优先“像封面”，不是“像 PPT 截图”

默认避免：

• 杂乱文字
• UI 截图感
• 信息图堆砌
• 水印
• logo 拼贴

3. 优先横向头图构图

固定 2.35:1，适合公众号封面横幅视觉。

依赖

• OPENROUTER_API_KEY
• 可选：OPENROUTER_TEXT（默认 google/gemini-3.1-flash-lite-preview）
• 可选：OPENROUTER_IMAGE
• 如需读取飞书文档：已可用的 lark-cli
• 如需上传微信封面素材：
  • WECHAT_APP_ID
  • WECHAT_APP_SECRET

验证建议

先本地跑：

python3 scripts/run.py from-markdown --input ./article.md --analysis-json /tmp/analysis.json --dump-json-spec /tmp/spec.json

确认：

• analysis 是否抓住主题
• spec 是否保持 2.35:1
• 最终图片是否贴合文章主题

适用边界

适合：

• 技术文章
• 观点评论
• 方法论总结
• 产品/AI/效率类公众号文章

不适合直接拿来做：

• 强品牌商业广告 KV
• 多页海报
• 需要精确排版文字设计的活动主视觉

这类任务应额外提供人工 art direction。