| name | article-cover-design |
| description | 微信公众号封面图（公众号头图）专用设计——硬编码官方比例 900×383（2.35:1），中心安全区构图保证转发卡 1:1 主体完整，受控文字策略（按真实场景决定是否带短文字），从文章核心隐喻推导视觉概念，生成后 vision 6 维评分卡把关。用户提到「封面」「公众号封面」「头图」「cover」「封面设计」「封面图」时，或 article 流水线到达封面生成步骤时使用。 |
| user-invocable | false |
公众号封面图设计（效果与用途保障方法论）
跳过条件（图片开关：封面关）
公众号文章的封面可由用户在创建任务/计划时关闭。当结构化运行控制 article_image_mode 为 content_only 或 text_only 时，整个本 skill 跳过：
- 不调
generate_image、不生成 $DIR/cover.png、不写 cover-prompt.md、不取 media_id/wechat_url。
- 节奏规划
visual-rhythm-plan.md 的 hero slot image_url=null。
- 发布草稿（
article-publishing skill）不带 thumb_media_id——即使有正文配图也不复用作封面。
- 两关（纯文字）时，在
final-review.md 记录「未生成封面，公众号后台可能不显示封面/需手动设置」。
无上述禁令（默认/封面开）→ 正常执行下文全流程。
本 skill 是公众号文章封面（thumb_media_id）的唯一权威设计入口，也是全篇内容配图的风格锚点（产物 $DIR/cover.png 供后续内容图 ref_image_path 继承）。它不是「随便生成一张横图」，而是一套多层方法论，确保封面达成：订阅号列表抓眼球（CTR）、转发卡主体完整、微信零裁剪、一眼传达主题、品牌调性统一。
核心规格（写死，不可改）
| 项 | 值 | 说明 |
|---|
| 大图比例 | 2.35:1 = 900×383px | 订阅号列表、文章详情页展示 |
| 转发卡 | 1:1（微信自动从封面中心裁切） | 群发通知、转发/分享卡片 |
| 文字 | 受控文字策略（按场景决定是否带 2-8 个字短标题/关键词；禁止乱码/水印/logo） | 标题利益点强、教程/清单/杂志风可带短文字；普通真实场景/氛围图默认无字 |
| 生成比 | size="21:9"（≈2.333:1，Volcengine 支持的最近比） | 服务端强制中心裁剪到精确 900×383 |
关键：服务端 generate_image 对 platform=article && image_type="cover" 会把成品精确裁剪到 900×383 并做像素断言。因此你只负责「出一张宽银幕横图 + 主体居中 + 按受控文字策略决定是否带短文字」，最终比例由服务端兜底，微信绝不会再裁剪（告别「一张需要手动裁剪的纯图」）。
用途 ↔ 规则 ↔ 验证（方法论的纲）
| 封面用途 | 设计规则（硬性） | 验证方法 |
|---|
| 微信零裁剪、列表/详情完整 | 精确 900×383 | 服务端像素断言（不可绕过） |
| 转发卡 1:1 主体完整 | 主体置于居中 1:1 安全区（≈383×383），避开底部 20% | 评分卡 safe_zone_centered |
| 避免低质文字干扰 | 按受控文字策略：需要时只放短文字；不需要时无字；始终禁止乱码/水印/logo/密集排版 | 评分卡 text_policy_ok + hard_no_watermark_logo（硬维度） |
| 缩略图 0.5 秒抓眼球（CTR） | 主体大、高对比、强焦点 | 评分卡 subject_thumbnail_readability |
| 一眼传达主题 | 视觉概念 = 文章核心论点/最强隐喻的具象化 | 评分卡 content_metaphor_relevance + required_entities |
| 品牌调性统一 | 视觉风格 = get_project_profile 的 visual_style（配置优先） | 评分卡 style_consistency |
| 视觉质感达标 | 摄影级/绘画级；禁 3D 合成/卡通/纯色底/对称 PPT | 评分卡 composition_quality |
受控文字策略
封面不再一律纯图，也不能无脑加字。先判断真实场景与用户需求，再决定是否在图上生成文字：
- 应考虑带短文字：最终标题利益点很强、系列栏目需要识别、教程/清单/方法论需要关键词、杂志编辑风封面、用户 prompt 或项目视觉风格明确要求图中文字。
- 默认无字：真实场景摄影、氛围意象、人物/物件特写、自然/生活方式画面，以及模型不稳定时。
- 文字约束：仅 2-8 个中文字或 1 个短标签；必须大而清晰，位于安全区内，避开底部 20%；禁止乱码、伪文字、水印、logo、密集排版、长段落。
- prompt 要求：带字时明确写出需要出现的精确文字；无字时写明
NO text, NO watermark, NO logo。
- vision 校验：必须检查文字是否短、清晰、准确、无乱码；文字失败时优先改为无字封面或重试。
第一步：推导视觉概念（杜绝通用素材）
封面必须从文章内容推导，不是随机图：
- 读
$DIR/04-article-final.md，提取核心论点与最强视觉隐喻（文章已有的比喻/意象/案例/场景）。
- 取视觉锚点
$VISUAL_STYLE：
get_project_profile 的 visual_style 非空 → 以它为权威锚点，三维分析只做细化（配色/情绪/构图），不得偏离。- 为空 → 按账号定位 + 内容主题 + 受众三维分析兜底（方向见下方「三维方向参考」）。
- 绝不从 writer YAML 推视觉（writer 只管文字；切断 dan-koe→维多利亚版画 bug）。
- 合成封面概念：
{VISUAL_STYLE} × {COLOR_PALETTE} × {内容隐喻具象} × {宽银幕叙事构图 + 主体居中安全区}。
- 提炼
required_entities（封面必须出现的具体物体，vision 校验依据）。
第二步：构建封面 prompt
A cinematic 2.35:1 wide banner for a WeChat article cover. {VISUAL_STYLE}.
{COLOR_PALETTE}. {CONCRETE_METAPHOR_FROM_ARTICLE — 具象化的核心隐喻}.
{MOOD_TONE}. Main subject centered within the middle safe zone (works for both
the 2.35:1 hero and the 1:1 forward-card crop), large and high-contrast for
thumbnail readability, generous negative space, avoid the bottom 20% (WeChat
overlays the article title there). Photographic quality, {TEXT_POLICY: exact short Chinese text when needed, otherwise NO text}, NO watermark,
NO logo.
构建要点：
- 主体居中安全区：主体落在画面中央 ≈383px 宽区域，确保转发卡 1:1 裁切后仍完整。
- 避开底部 20%：微信会在底部叠加标题，关键元素不放底部。
- 缩略图可读：主体要大、对比强，列表里缩成 ≈200px 仍能一眼识别。
- 文字策略：先按「受控文字策略」判断；需要文字时写出精确短文字，不需要文字时写死
NO text, NO watermark, NO logo。
第三步：构建 vision 6 维评分卡（生成前就绪）
服务端 verify_with_vision=true 时要求 verification_prompt 非空。封面用专用评分卡（对应上方映射表）：
这是文章《$ARTICLE_TITLE》的公众号封面（将用于订阅号列表 2.35:1 + 转发卡 1:1）。
文章核心论点：$CORE_THESIS；核心隐喻：$METAPHOR；账号视觉风格锚点：$VISUAL_STYLE。
请按 JSON 评分（软维度 high/medium/low；hard_* 为硬性布尔）：
{
"subject_thumbnail_readability": "...", // 主体大且高对比，缩成 200px 列表缩略图能否 0.5s 抓住？
"safe_zone_centered": "...", // 主体是否落在居中 1:1 安全区？转发卡裁切后是否完整？
"content_metaphor_relevance": "...", // 与文章核心论点/隐喻的语义相关度
"style_consistency": "...", // 是否与账号视觉风格锚点一致
"composition_quality": "...", // 摄影级质感，无合成/卡通/纯色底/对称 PPT
"text_policy_ok": true/false, // 文字策略是否正确：需要文字时短且清晰；不需要时无字；无乱码/伪文字
"hard_no_watermark_logo": true/false, // 硬性：无水印/logo/密集排版
"hard_aspect_ok": true/false, // 硬性：宽银幕横版（非竖图/方图错比）
"missing_or_forbidden": "...", // 缺失实体或违禁元素（文字水印等）
"overall_pass": true/false, // text_policy_ok=true、所有 hard_* 为 true 且 4 个软维度≥medium 才 true
"sharper_prompt_hint": "..." // 不通过时的锐化建议
}
第四步：生成（生成与上传原子化）
generate_image(
project_id=$PROJECT_ID,
prompt=<第二步的封面 prompt>,
image_type="cover",
output_path="$DIR/cover.png",
task_id=$TASK_ID,
size="21:9",
verify_with_vision=true,
verification_prompt=<第三步的评分卡>,
upload_to_cdn=true
)
size="21:9" 是生成提示比；服务端按 platform=article + image_type=cover 把成品精确裁到 900×383（你无需管最终比例）。upload_to_cdn=true：vision 校验通过才上传，同一调用内完成「生成→裁剪→校验→上传」，直接返回 media_id（发布草稿的 thumb）+ wechat_url；校验未通过则不上传（不浪费微信素材位）。- 返回
upload_error（生成成功但上传失败）→ 用 upload_image(file_path="$DIR/cover.png") 单独重传，无需重新生成。
第五步：迭代闭环
读 generate_image 返回的 verification 对象（服务端归一化字段 passed/score/missing_entities/notes/raw）：
passed=true → 通过，进入第六步。passed=false → 按 notes / sharper_prompt_hint 锐化 prompt 重试，最多 3 次（共 3 次尝试）。锐化策略：
- 在 prompt 开头加
MAIN SUBJECT: <具体物体>，强化主体权重；
- 把隐喻改得更具体（材质/颜色/方位/数量）；
- 收紧「主体居中安全区 + 避开底部 20%」；
- 按受控文字策略修正：文字乱码/过密则改为无字或缩短为精确短词；始终强化
NO watermark, NO logo。
- 3 次仍不过 → 暂停并请求用户协助，不得用未通过 vision 的封面发布。
第六步：落盘审计（cover-prompt.md，硬性）
封面构建完成后，原子写入 $DIR/cover-prompt.md（先写 $DIR/.cover-prompt.md.tmp → fsync → rename 覆盖），完整记录封面决策，便于复盘与风格漂移排查。内容必须含：
- 比例：公众号 2.35:1（900×383px 标准；服务端强制裁剪）。
- 账号视觉风格来源：
$VISUAL_STYLE / $COLOR_PALETTE / $MOOD + 三维分析依据（账号定位/内容主题/受众），或配置锚点来源（visual_style_source）。
- 文章核心隐喻：封面要表达的最强视觉隐喻。
required_entities：封面必须出现的具体物体列表。- 最终 prompt：实际传给
generate_image 的完整 prompt。
- vision 6 维评分卡：评分 prompt + 结果（passed/score/各维度/missing_or_forbidden）。
产出：$DIR/cover.png、media_id、$COVER_CDN_URL、$DIR/cover-prompt.md。
注意：封面仅用于 thumb_media_id，不得复用为正文内容图。正文每张图的 wechat_url 必须各自独立生成上 CDN——服务端 publish_draft 会硬拦截「正文 ≥2 图但唯一 URL==1」的草稿。
三维方向参考（仅 visual_style 为空时兜底）
| 账号领域 | 视觉方向 | 典型色彩 |
|---|
| 中医/养生/健康 | 自然摄影、有机元素 | 大地色、柔绿、金色 |
| 文化/历史/艺术 | 传统美学、水墨韵味 | 墨黑、暖棕、青瓷 |
| 科普/科技/教育 | 干净现代、概念化 | 蓝、青、白 |
| 生活/美食/旅行 | 温暖生活方式摄影 | 橙、奶油、橄榄 |
| 育儿/家庭 | 温暖自然、柔和色调 | 柔粉、暖米、鼠尾草 |
| 金融/商业 | 专业简洁设计 | 藏蓝、金、白 |
