article-cover-design

name	article-cover-design
description	微信公众号封面图（公众号头图）专用设计——硬编码官方比例 900×383（2.35:1），中心安全区构图保证转发卡 1:1 主体完整，受控文字策略（按真实场景决定是否带短文字），从文章核心隐喻推导视觉概念，生成后 vision 6 维评分卡把关。用户提到「封面」「公众号封面」「头图」「cover」「封面设计」「封面图」时，或 article 流水线到达封面生成步骤时使用。

公众号封面图设计（效果与用途保障方法论）

跳过条件（图片开关：封面关）

公众号文章的封面可由用户在创建任务/计划时关闭。当结构化运行控制 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 校验：必须检查文字是否短、清晰、准确、无乱码；文字失败时优先改为无字封面或重试。

第一步：推导视觉概念（杜绝通用素材）

封面必须从文章内容推导，不是随机图：

1. 读 $DIR/04-article-final.md，提取核心论点与最强视觉隐喻（文章已有的比喻/意象/案例/场景）。
2. 取视觉锚点 $VISUAL_STYLE：
   • get_project_profile 的 visual_style 非空 → 以它为权威锚点，三维分析只做细化（配色/情绪/构图），不得偏离。
   • 为空 → 按账号定位 + 内容主题 + 受众三维分析兜底（方向见下方「三维方向参考」）。
   • 绝不从 writer YAML 推视觉（writer 只管文字；切断 dan-koe→维多利亚版画 bug）。
3. 合成封面概念：{VISUAL_STYLE} × {COLOR_PALETTE} × {内容隐喻具象} × {宽银幕叙事构图 + 主体居中安全区}。
4. 提炼 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 为空时兜底）

账号领域	视觉方向	典型色彩
中医/养生/健康	自然摄影、有机元素	大地色、柔绿、金色
文化/历史/艺术	传统美学、水墨韵味	墨黑、暖棕、青瓷
科普/科技/教育	干净现代、概念化	蓝、青、白
生活/美食/旅行	温暖生活方式摄影	橙、奶油、橄榄
育儿/家庭	温暖自然、柔和色调	柔粉、暖米、鼠尾草
金融/商业	专业简洁设计	藏蓝、金、白