ray-cover

Ray Cover

把一篇定稿内容压成一张在信息流里一眼能认出的封面。Claude 负责读内容、写封面文案、选风格、编译每个平台的完整提示词、验收；生成默认走 OpenAI Images API（gpt-image-2.5-sunburst，约 40 秒、$0.07 一张），没有 key 或 --backend codex 时由 Codex CLI 调 Image 2。画面和中文由生图模型一次生成，不做无字底图再排字。

风格库来自 Adrian Punk 的 Punk Skill MIT 版（assets/punk/，来源和许可边界见 assets/punk/NOTICE.md）。之后的新版是付费商业授权，不拷进来。

$SK 指本 skill 目录。

视频封面（抖音、视频号、小红书的竖封面，以及 YouTube、视频号 / 抖音横屏视频的 16:9 横封面）走另一套：真人照片 + 大标题，见 video-cover.md。默认只出 3:4（xhs）、默认风格小Lin风A；9:16 只在 Ray 明确要时出；各比例的安全区见同一文件。

下面第 5–7 步的生成、验收、交付照常适用；以下几步换成 video-cover.md 里的规则：

• 第 2 步的文案换成 video-cover.md「文案」。小Lin风A 是超大关键词 + 一行中文 + 一行小英文；其他风格默认只有两行主标题。第 3–4 步的选风格和编译提示词也换成 video-cover.md 里的规则。只删改一行字时用 scripts/erase_text.py，不重新生成。

1. 读内容

读完整正文；有成稿包时同时读一句话判断、核心冲突和传播句；视频封面读这期的口播母稿（vault 的 40-发布/50-口播视频/）或 ray-explainer 项目的 script.json（title、central_judgment、publish），两处任一即可。判断还没定的内容先交回 ray-writer，不用封面替文章拍板。

2. 写封面文案

按 cover-copy.md 写三层：主标题（2–8 字）、副标题（补主标题没说的）、小字（一个硬事实或身份标签）。按内容类型换写法，三层之间不重复，不把文章标题拆开了事。

默认直接用最合适的一组出图，同时准备 1–2 组备选文案，交付时一起给 Ray。Ray 明确说「先给我看文案」时才停下来等确认。

3. 选风格

按 styles.md 挑一个风格。默认在 Anthropic Research、黑白灰先锋几何、纸面击凸压凹三个里按内容选；Ray 点名风格就用他点的；Ray 说「多出几个风格看看」就每个风格各出一版公众号尺寸。

4. 编译提示词

每个平台一份，存到 <封面目录>/prompts/<platform>.md（文章：wechat、x、x-article；视频：vertical、xhs、landscape）：

1. 读选定风格的 assets/punk/styles/<style-id>/META.md 和 STYLE.md，以及 assets/punk/punk-cover/references/cover-prompt-blueprint.md。
2. 按蓝图编译成一份完整的封面提示词：风格的材质、空间、标题处理、颜色和禁忌落到每个封面决定上，不把 STYLE.md 原文贴在后面。
3. 把 ip.md 的颜色和禁用约束写进「Color, Material, and Texture」「Negative Constraints」两节。
4. 写明目标比例和像素、安全区、逐字文案（见 platform-output.md）。
5. 提示词里不写作者名或「xx style」，只描述视觉机制；不贴文章原文。

5. 生成

封面目录默认是 <vault>/60-素材/10-图片/10-封面/<YYYY-MM-DD-主题>/（<vault> 来自用户给的路径或 .ray-obsidian.json；没有知识库时放用户指定的工作区）。

python3 $SK/scripts/gen_cover.py <封面目录> --platforms wechat,x,x-article

脚本对每个平台各出一张图（并行），生成 raw-<platform>.png，比例对就等比缩放成 <platform>-cover.png 和 420px 缩略图，写 manifest.json；比例不对报错，不裁不拉。

• 默认 --backend api（OPENAI_API_KEY 在环境变量或 ~/.zshenv 里就自动用）：OpenAI Images API，模型 gpt-image-2.5-sunburst，有 --ref 走 /v1/images/edits、没有走 /v1/images/generations，一张约 30–50 秒、约 $0.07。原生尺寸已实测 xhs 1200×1600；别的比例 API 不收时报错，那个平台改用 --backend codex。
• --backend codex：Codex CLI 调 Image 2，一张约 1–5 分钟。需要 codex 已登录且 image_generation 开启（codex features list）。

只出一个平台或换风格试一版：--platforms wechat。

6. 验收

用 Read 看每张成品和缩略图：

• 文案逐字对：缺字、错字、多字（模型自己加的标语或英文）。错字、多字改提示词重跑该平台；模型自加的短标签列给 Ray 判断。
• 颜色：只有黑白灰加一处墨绿，没有蓝紫、霓虹、别的色相。
• 主标题在 420px 缩略图上读得清；关键文字不贴边、不被裁。
• 风格是真的落在画面上，而不是普通封面加一点质感。

7. 交付

用 SendUserFile 发成品，回复里写：用的风格和一句话视觉隐喻、这组文案、1–2 组备选文案、验收发现的问题（模型自加的字、颜色偏差）。Ray 要调整时，分两种：

• 只改局部（去掉一个小东西、换背景、改一处颜色）：不重新生成，写 prompts/<p>-edit.md（「只做一处修改：……其余一切保持完全不变」），跑 gen_cover.py <封面目录> --platforms <p> --edit。脚本把旧的 raw / cover / thumb 自动留档成 -v1、-v2，拿现成的 raw-<p>.png 去改，构图和脸都不变（2026-10-16 宝可梦封面去领夹麦，一次成功）。
• 只换人物（换一张身份照，构图、文字、道具都不动）：gen_cover.py <封面目录> --platforms <p> --edit --ref <新照片>，定稿封面和新照片一起送进编辑接口，写法见 video-cover.md「换人物、保留构图」。
• 重新构图：先把那几个平台的旧文件（raw-<p>.png、<p>-cover.png、<p>-thumb.jpg、api-<p>.log / codex-<p>.log、manifest.json）改名加 -v1、-v2 留档、提示词另存 prompts/<p>-v1.md，再只改对应平台的提示词重跑；脚本会覆盖同名文件。

边界

• 不发布、不上传平台；进公众号草稿交 ray-wechat，进 X Articles 后台交 ray-x-article（用 5:2 成品）。
• 文章封面默认不画形象，Ray 要求时按 ip.md 的方式加；视频封面用 Ray 的真人照片（他已同意），用别人的照片先问。
• 正文配图、视频画面不归这个 skill。