做 B站/YouTube/抖音视频封面时，用…

需要为真人出镜视频制作强对比、大主体的高点击封面，并一次重排 16:9/4:3/3:4 时使用。

适用场景

解决思路

1. 安装依赖：pip install "rembg[cpu]" onnxruntime。
2. 安装 Playwright 浏览器：python3 -m playwright install chromium。
3. 读输入：获取用户口语需求和一张真人照片；照片最好有环境感，环境会保留进封面。
4. 想清楚标题：砍到 8–16 字，断 2–3 行，确定哪个词做黄色块。
5. 想清楚 kicker：根据主题生成左上小标签。
6. 想清楚 person_side：判断人物在原图的左还是右。
7. 抠图：运行 python3 src/cutout.py <照片> input/person-cut.png。
8. 抠图时必须输出整幅、不裁外框，这样顶层人物能和底层原图精确对齐。
9. 写 brief.json：参考 examples/codex/brief.json；photo=原图，person_image=抠图，两者必须是同一张。
10. 渲染：运行 python3 src/render.py <brief.json> output/，生成 3 张高清 PNG。
11. 视觉自检：看输出图，对照 references/brand-system.md 的「合格/不合格」清单。
12. 如果关键词被人物挡到读不出、背景压太暗或太亮，就调 focus 或字号重渲。
13. 交付输出图，并简述取舍。
14. 核心 pop-out 三层不能破：底层=人物的原始照片，压暗+降饱和，保留房间/桌面等环境以保真实感。
15. 中层=大标题，关键词用黄色实色块，压在暗化原图上。
16. 顶层=把人物从原图抠出来，全亮、原位精确叠回去；人物从自己的场景里跳出来，可盖住一点文字但关键词照样可读。
17. 用 CSS 重排成 16:9 / 4:3 / 3:4，重排不是裁切。
18. 与 yuyile-social-card-skill 分工：那个做小红书图文/信息图/杂志风，克制、编辑感；这个做视频缩略图，强对比、大主体、高冲击；两套美学不要混。
19. 品牌铁律：pop-out 三层不能破：暗化原图(留环境) → 文字 → 全亮抠图人物(原位对齐)。
20. 人物全亮跳出、第一主体；标题第二。
21. 关键词用黄色实色块，作为招牌记忆点。
22. 人物可盖住部分文字，但关键词必须仍可读。
23. 字体：拉丁用 Archivo Black，中文用 PingFang(系统最重)；要更狠就放 Heavy 中文字体到 assets/fonts/ 并接 @font-face。
24. 背景压暗适度，别压死——环境要看得见才有真实感。
25. 品牌签名：左下角只放「@鱼亦乐」文字，无 logo。
26. 三比例各自重排，不是裁切。
27. 禁止绿色大字。
28. 来源宽高比自动适配：横图(≥1.2)做 3:4 时自动切「上方标题带 + 下方照片带」，竖图全铺。
29. 建议 16:9 用横图、3:4 优先用竖图拍。
30. 三套模板通过 brief 里的 template 字段切换，互不混用。
31. popout（默认）：深色海报风；标题处理=大白字 + 黄色实色块关键词，人物全亮跳出；适合大多数视频，强冲击。
32. ui：深色命令面板风；标题处理=做成“在 AI 工具里输入的查询” `✦ … ⌘↵` + 结果行；适合工具 / AI / 自动化类。
33. paper：浅色胶片编辑风；标题处理=褪色(近黑白)照片 + 胶片颗粒 + 半调网点(中性不发黄)；关键词用 iOS 文本选中（黄底 + 蓝手柄）+ iOS 右键菜单紧贴选区上方；适合观点 / 故事 / 高级感选题。
34. popout/ui 是深色 pop-out（暗化原图 + 全亮人物）；paper 是浅色（褪色照片 + 胶片颗粒/半调网点，人物褪色不跳出）。
35. 三套都带 @鱼亦乐 签名，但视觉语言不同，不要在一张图里混用。
36. ui：用 results 字段给结果行，缺省用 subtitle。
37. paper：用 menu 字段给 iOS 右键菜单浮层（字符串列表，可省）；关键词 [方括号] 自动渲染成 iOS 选中高亮。
38. brief.json 字段 template：popout(默认) / ui / paper。
39. brief.json 字段 name：输出文件名前缀。
40. brief.json 字段 kicker：左上小标签（如 CODEX · SKILL），可省。
41. brief.json 字段 title：标题；用反斜杠 n 换行，[方括号] 包关键词=黄色实色块。
42. brief.json 字段 subtitle：副标题，可省。
43. brief.json 字段 photo：原图路径（底层背景，保留环境）。
44. brief.json 字段 person_image：抠图路径（顶层人物，须与 photo 同源、整幅）。
45. brief.json 字段 person_side：right(默认) / left。
46. brief.json 字段 focus：取景焦点 object-position，可省（默认按竖图调好）；可传字符串统一或按比例对象，例如 16x9 对应 50% 30%。
47. brief.json 字段 brand_name：默认 @鱼亦乐（纯文字，无 logo）。
48. brief.json 字段 person_grade：mono=黑白人物；省略=全彩。
49. brief.json 字段 results：（仅 ui）命令面板结果行，列表，每项 {icon,label,sel}；缺省用 subtitle。
50. brief.json 字段 menu：（仅 paper）iOS 右键菜单浮层，字符串列表，可省。
51. brief.json 字段 component：（仅 popout）可选钩子组件（终端/GitHub），见 references/components.md；默认不放更干净。
52. brief.json 字段 ratios：默认 ["16x9","4x3","3x4"]。
53. 文件 references/brand-system.md：核心，pop-out 美学规则、配色、标题、验收清单；每次开工前读。
54. 文件 references/components.md：可选钩子组件规格。
55. 文件 assets/template-popout.html：深色海报风模板（默认）。
56. 文件 assets/template-ui.html：深色命令面板风模板。
57. 文件 assets/template-paper.html：浅色纸质编辑风模板（iOS 选中高亮）。
58. 文件 src/cutout.py：rembg 抠图（整幅输出）。
59. 文件 src/render.py：三层合成 + Playwright 精确截 3 张。
60. 文件 examples/codex/brief.json：输入示例。

适用边界 · 注意事项

• 小红书图文/信息图/杂志风封面，应改用 yuyile-social-card-skill。
• 翻页 PPT 或纯 AI 绘图，不适用本视频封面流程。
• 不要在一张图里混用 popout/ui/paper 三套模板视觉语言，也不要使用绿色大字。