封面合成 · Cover Composition
本模块负责封面的最终确定性合成,不负责生成新的 Logo,也不决定正文是否启用首屏。默认版式是“横版居中,方版底部居中”;父管线启用正文首屏时,额外合成 3:4 竖向版并将 Logo 放在底部安全区。
Triggers
Activate when
cover-direction已产出公众号分享封面的艺术底图,需要叠加发布主体 Logo 并输出双比例制品。- 用户要求复用艺术图片打底的既有封面风格,或指定横版与方版不同的 Logo 位置。
- Branding 管线启用分享封面制作或重构。
- The user asks to "center the Logo on the wide cover and place it at the bottom of the square cover".
Do not activate when
- 当前请求只需要正文首屏品牌图,不需要分享封面。
- 当前请求只做封面审计,不允许生成或合成新制品。
Composition contract
- 使用
cover-direction产出的艺术主图作为底图;先铺满2.35:1画布,再处理品牌层。 - 按
wechat_article_branding.cover_composition.background_dimming添加从约 38% 画面高度开始的底部渐变调暗,默认强度为0.45。 - 优先读取
publication.cover_logo,字段缺失时才回退到publication.logo;保留原始字形、比例、透明区域和颜色。若publication.cover_logo_variant为white,合成前必须验证可见 Logo 像素为低色差高亮度白色,不得回退为橙色。宽版 Logo 默认最大宽度为画布宽度的24%、最大高度为画布高度的45%,以画布几何中心定位。 - 从完成调暗、但尚未叠加 Logo 的宽版背景中心裁切
1:1。不要从已经带有居中 Logo 的宽版成品裁方图,否则方版会错误继承横版位置。 - 在方版背景上单独叠加同一官方 Logo,默认
position: bottom_center、最大宽度36%、最大高度15%、底部边距5%。用户显式指定方版位置或尺寸时,以当前请求为准。 - 两个比例都不要加左下角面板、圆角卡片、贴纸、胶囊底或额外品牌文字。
- 输出未叠加 Logo 的艺术底图、宽版合成图、方版合成图以及上传用 JPG;保留合成前后的本地文件便于回滚和比较。
- 父管线启用
opening_hero时,从同一艺术世界制作3:4竖向版,Logo 默认底部居中、最大宽度42%、底部边距8%。该文件仅作正文首屏,不替代分享封面上传件。 - 文件角色必须明确命名:
share-cover-wide-logo.*、share-cover-square-logo.*、opening-hero-vertical-logo.*。禁止上传名为background或未经 Logo 验收的艺术底图。
Deterministic compositor
python3 "$SKILL_DIR/scripts/compose_cover.py" \
--background ARTWORK \
--logo PUBLICATION_LOGO \
--logo-variant white \
--output-dir OUTPUT_DIR \
--opening-hero
脚本会输出 PNG、上传用 JPG 和 cover-composition.json。回执记录 Logo 源文件 SHA-256、变体、可见像素平均 RGB、各产物尺寸与 Logo 像素包围盒;如 Logo 缺失、没有可见 alpha/色彩像素、声明 white 但像素不是白色,或产物与无 Logo 背景一致,则立即失败。
Existing editor compatibility
如果当前环境可用旧的公众号封面裁切器,可以复用其底图铺满、渐变调暗和 Logo 覆盖能力,但需要支持双位置合成。横版定位为 ((画布宽度 - Logo 宽度) / 2, (画布高度 - Logo 高度) / 2);方版定位为 ((方版宽度 - Logo 宽度) / 2, 方版高度 - 底部边距 - Logo 高度)。裁切发生在方版 Logo 合成之前。
Validation
- 宽版 Logo 的几何中心与画布中心一致;方版 Logo 水平居中并位于底部安全区。
- 方版背景来自未叠 Logo 的宽版背景中心裁切,不得残留第二个居中 Logo。
- Logo 来自解析后的
publication.cover_logo或其明确回退publication.logo,没有被图像模型重画或变形。 - 存在
publication.cover_logo时,收据必须指向该文件而不是通用publication.logo;声明white时,Logo 可见像素必须通过白色验证。 - 宽版上传件与无 Logo 底图在记录的 Logo 包围盒内存在像素差异;收据中 Logo 源文件 SHA-256 与
publication.logo一致。 - 启用竖向首图时,产物为
3:4、Logo 位于底部安全区,且这张图不被误用为分享封面。 - 两个比例均只有一个主视觉焦点,且没有品牌面板遮挡艺术主体。
- 上传前先查看宽版和中心方形裁切;上传后检查平台 CDN 成品。
Runtime context (shared)
运行前读取本 Skill 包的 skill.yaml,由宿主提供 skill-runtime/v1 上下文。字段解析顺序为:当前请求、项目上下文、个人 Preferences、品牌 Profile、通用默认值。
- 只使用 Manifest 声明的字段;Profile 保存公开品牌事实,Preferences 保存个人工作偏好。
required: true字段缺失时,按 Manifest 的问题配置向用户提出一个聚焦问题;用户明确同意后再保存回答。- 报错提供可复制的
context_id、字段路径与来源,诊断内容避开秘密、完整私人路径和原始配置。
