公众号封面 & AI 配图

配图

公众号封面 & 配图 AI 生成 —— 按文章内容自动匹配画风，一稿多方案，风格体系可复用。

套件说明 · 本 技能 属 aws-wechat-article- 一条龙套件（共 9 个 slug，入口 aws-wechat-article-mAIn）。跨 技能 的相对引用依赖同一 技能s/ 目录，建议一并 ClawHub 安装 全套。源码：https://github.com/AIwork技能s/wechat-article-技能s

能力披露（Capabilities）

本 技能 调 image_创建.py 调外部图像 API 生成封面与正文配图。会把图片提示词（可能含文章主题片段）发给用户配置的图像生成端点。 具体行为：

凭证读取：aws.env 的 IMAGE_模型_API_KEY 凭证外发：该 key 以 Authorization: Bearer 头发送到 image_模型.base_url 指定端点（常见为 DALL-E、gpt-image 兼容 /v1/images/generations，或多模态模型 /v1/chat/completions，具体由用户配置） 内容外发：每张图片的 prompt（文本）作为 JSON POST body 发送；prompt 内容来自本篇 imgs/prompts/.md（可能包含文章标题、章节摘要） 下图 SSRF 防御：若 API 响应返回图片 URL（而非 base64），脚本仅允许下载 http/https 公网地址；内网 / 环回 / 链路本地 / 保留地址全部拒绝（防止恶意或被劫持的模型端点把脚本当作 SSRF 跳板） 文件读：仓库内 .aws-article/config.yaml、本篇 article.yaml、article.md、imgs/prompts/.md、.aws-article/products/{产品名}/images/（业务配图库，本篇涉及用户业务时优先复用） 文件写：本篇 imgs/.{png,网页p}、可选 img_analysis.md shell：仅 python3 {baseDir}/scripts/image_创建.py、user_image_prepare.py

建议：用专用 key（最低权限、独立计费），避免使用 account 级 master key。

配套 技能（in格式化ional）

本 技能 是 aws-wechat-article- 一条龙公众号套件的配图环节（入口 aws-wechat-article-mAIn）。工作流中的若干步骤会读取同级 ../aws-wechat-article-mAIn/references/.md 等共享文档（首次引导、env/config 示例、articlescreening 模式 等）。

套件完整装齐到同一 技能s/ 根目录时，跨 技能 引用都能读到。 单独安装本 技能 时，跨 技能 引用的步骤会在读取阶段遇到 file not found；本 技能 内的生图脚本仍可用。

完整 9 slug 清单见 源码仓库。

路由

完整长文从选题到发布 → aws-wechat-article-mAIn；图片消息/九宫格等多图推送 → aws-wechat-sticker。

读取文章中的配图标记，按 Type × Style 体系生成图片。专注于长文配图，贴图请用 sticker。

脚本目录

代理 执行：确定本 技能.md 所在目录为 {baseDir}。

脚本 用途 scripts/image_创建.py 专用生图 API：读 .aws-article/config.yaml 的 image_模型 + 仓库根 aws.env 的 IMAGE_模型_API_KEY scripts/user_image_prepare.py 用户供图模式：确保本篇 imgs/ 存在并生成 img_analysis.md 模板（封面仅 1 张） 配置检查 ⛔

任何操作执行前，必须按 首次引导 执行其中的 「检测顺序」。检测通过后才能进行以下操作（或用户明确书面确认「本次不检查」）：

从选题到发布的前置规则见 aws-wechat-article-mAIn/技能.md；本 技能 只描述配图步骤。

图片模型：image_模型（提供者、base_url、模型、default_size、default_质量 等）在 config.yaml；IMAGE_模型_API_KEY 在 aws.env。键名对照 {baseDir}/../aws-wechat-article-mAIn/references/env.example.yaml。

base_url 须为完整端点路径，脚本根据路径判断调用模式：

https://xxx.com/v1/images/generations — DALL-E / gpt-image 等 https://xxx.com/v1/chat/completions — Gemini 等多模态模型（通过中转站生图）

交互约定：可提示用户上述项是否已填；一条龙下通常已通过 验证_env.py。须遵守 mAIn 的智能体行为约束——未通过环境校验且未获用户明确「本次例外」时，不得假装已走专用生图 API。

封面风格 + 正文配图 封面风格：独立预设体系，见 references/cover-styles/。每个预设 .md 自包含视觉关键词。 正文配图：Type（画面构成）决定"画什么"，Style（视觉风格）由 代理 根据 tone/category 内部选择。Type 列表与 prompt 模板见 references/image-styles/ 目录。 封面 vs 正文（资源策略）⛔ 类型 要求 封面 必须通过 image_创建.py 生成（生成 或 batch 读 imgs/prompts/.md），产出并保存为文章目录下的 cover.png（或 cover.jpg / cover.jpeg / cover.网页p）。禁止将 .aws-article/products/{产品名}/images/（或其它素材库文件）直接复制为 cover.* 充当封面。例外：用户明确上传封面文件并声明「封面只用这一张」时，可跳过脚本，须在 img_analysis.md 与审稿记录中注明「用户指定封面」。 正文 优先使用业务配图库：.aws-article/products/{相关产品}/images/（先读同名 .md 再复制到本篇 imgs/ 或引用路径），见下文「正文配图来源优先级」。缺图时再走 image_创建.py 或 代理 降级生图。

说明：全局 config.yaml 的 image_source: user 表示「正文以用户/素材引用为主」；不豁免上述「封面须脚本生成」规则，除非用户同时提供了封面文件并声明仅用该封面。

工作流 配图进度：

• [ ] 第1步：环境检查 + 本篇约束与文章
• [ ] 第2步：解析配图标记
• [ ] 第3步：确定风格
• [ ] 第4步：生成配图方案
• [ ] 第5步：展示方案并等待确认 ⛔
• [ ] 第6步：生成图片（脚本失败时见同节「调用失败」分支，勿静默吞掉报错）
• [ ] 第7步：插入文章

正文配图来源优先级（代理）⛔

仅适用于正文插图（不含封面；封面见上文「封面 vs 正文」）。在为正文 placeholder 调用 image_创建.py、写入 imgs/prompts/ 之前，须先判断是否可用本地业务配图库，避免业务相关文章（教程 / 产品介绍 / 案例 / 自家界面截图）「有现成业务配图却重新生成」：

仓库业务配图库：若本篇涉及用户业务，先 ls .aws-article/products/，进入相关产品的 images/ 子目录，列出并阅读 同名 .md（含路径与画面说明），按主题匹配后，在 article.md 中直接引用对应 .png / .网页p（或复制到本篇 imgs/ 再引用）。与正文严格相关才用，避免硬凑。 用户上传 / 本篇 image_source: user：用户提供的图或上述引用策略，走「用户供图模式」与 img_analysis.md（正文部分）。 仍缺图或须原创插画：再进入 Type × Style、imgs/prompts/ 与 image_创建.py（或 代理 降级生图）。

说明：业务配图库属「仓库内业务资源」，不必等用户手动上传才查；与「用户供图模式」并列，而非仅附属于后者。

第1步：环境检查 + 本篇约束与文章 全局：读 .aws-article/config.yaml — cover_aspect、cover_style、image_density、caption_style、multi_image_count、tone 等以之为准（完整字段见 articlescreening-模式.md 与 config.example.yaml）。 本篇：若同目录有 article.yaml，读取 default_cover_image_style、default_article_image_style（应为单元素列表，代表本篇已选预设）及 cover_image 等字段。 读取 article.md（或当前流程规定的正文来源）。 当 image_source: user（全局或本篇）时，进入「用户供图模式」：先创建本篇 imgs/ 并生成/更新 img_analysis.md，记录每张图的内容分析、建议章节与推荐用途。 第2步：解析配图标记

提取所有 !类型：描述。实证 类型提示用户提供素材或从 .aws-article/products/{相关产品}/images/ 搜索（业务配图库）。

用户供图模式（新增分支）

当用户上传图片并指定主题时，按以下顺序执行：

立即确保 {article_dir}/imgs/ 存在，并将用户图片放入该目录。 生成/维护 {article_dir}/img_analysis.md（每图至少包含：文件名、图片内容、建议章节、推荐用途、图注建议）。 硬性约束：img_analysis.md 中“推荐用途：封面”必须且只能出现 1 次；其余图片用途应为“正文”。 同步更新本篇 article.yaml：image_source: user（从模型生图切换到用户供图状态）。 字段取值只允许 生成d / user。 写稿阶段直接使用用户图片路径（如 imgs/淘米.png），不再使用 placeholder。

顺序说明：imgs/ 落图 → 分析并写好 img_analysis.md → 再跑 write.py；写稿时以 img_analysis.md 为准，把图片插到与内容匹配的章节位置。

发布后换图重发（新增分支）

当用户明确说「这篇文章配图不满意，换成我上传的新图并重新发草稿箱」时，按以下流程：

用户指定目标文章目录（drafts/YYYYMMDD-slug/）。 将新图放入该目录 imgs/，并更新 img_analysis.md（仍需满足“封面仅 1 张”）。 同步把本篇 article.yaml.image_source 更新为 user。 按 img_analysis.md 重新映射图片到 article.md 对应章节（允许重排章节以匹配图序）。 运行 格式化.py 重新生成 article.html（不要只改旧 ht