Next AI Draw.io
draw.io diagrams your AI agent draws on a live browser canvas that you can also edit by hand
Video cover & thumbnail skill for Claude Code & Codex. 帮你用视频画面做小红书和 B 站封面。
제작자가 쓴 원문
제작자라면 이 코드를 README에 붙여 넣으세요. 배지는 이 페이지로 연결됩니다.
[](https://mcp.popnx.com/en/skills/oil-oil-oil-cover)같은 작업에서 AI를 서비스에 연결하는 MCP
draw.io diagrams your AI agent draws on a live browser canvas that you can also edit by hand
Create, inspect, validate, and save editable 3D building scenes with Pascal's MCP server.
Verified React chart generation: select, validate, repair, render, and inspect charts through MCP.
같은 종류의 작업, Skill 목록과 같은 순서
| 이 항목 oil-cover | impeccable | diagram-design | frontend-slides | guizang-ppt-skill | |
|---|---|---|---|---|---|
| 제작자 | oil-oil | pbakaus | cathrynlavery | zarazhangrui | op7418 |
| Skill 수 | 1 | 1 | 1 | 1 | 1 |
| GitHub 별 | 303 | 113,536 | 68,713 | 32,639 | 30,137 |
| 마지막 코드 변경 | 2026년 11월 16일 | 2026년 11월 20일 | 2026년 11월 19일 | 2026년 6월 24일 | 2026년 10월 30일 |
| 라이선스 | – | Apache-2.0 | MIT | MIT | AGPL-3.0 |
oil-oil의 Skill(지시 묶음) 1개, AI가 읽고 그대로 일해요 · MCP server가 아니에요
MCP = 손
AI를 외부 서비스나 데이터에 연결합니다(예: Notion 읽기, 청구서 만들기). 프로그램이나 서버가 실행 중이어야 합니다.
Skill = 안내서
작업 방법을 AI에게 가르치는 텍스트 파일. 어떤 서비스에도 연결되지 않습니다.
겹치는 경우도 있습니다. 도구를 부르는 스크립트가 있는 Skill도, 지식만 보내는 MCP도 있습니다. 하려는 작업을 기준으로 고르세요.
CodexCursor
제작자 README와 repo 폴더 기준
GitHub 계정 oil-oil(개인), 만든 지 7년
★ 303개, 아직 사용자가 적습니다 · 코드 마지막 수정 2026년 11월 16일
컴퓨터에서 실행할 수 있는 스크립트가 22개 있습니다: scripts/credential-ui/public/app.js, scripts/credential-ui/public/favicon.svg, scripts/credential-ui/public/index.html, scripts/credential-ui/public/style.css 그리고 파일 18개 더
인터넷에 접속하는 스크립트: scripts/credential-ui/tests/profile.test.ts, scripts/credential-ui/tests/native-smoke.ts, scripts/credential-ui/web/app.ts, scripts/credential-ui/public/app.js
hook이나 컴퓨터 설정을 쓰는 동작을 찾지 못했습니다
저장소 commit dde9572의 파일을 자동으로 검사했습니다(읽기만 했고 아무것도 실행하지 않았습니다). 안전을 보증하는 것은 아니니, 직접 읽어 보고 판단하세요
먼저: 어떤 AI를 쓰시나요
쓰는 앱을 고르면 그 앱의 설치 방법만 보여 드립니다
이 Skill은 라이선스가 명시되어 있지 않기 때문에 저희 사이트에서 ZIP을 배포하지 않습니다. GitHub에서 내려받아 폴더를 직접 정리하거나, 위의 "AI가 대신 설치하기"를 사용하면 더 쉽습니다
압축을 풀고 oil-cover 폴더만 다시 ZIP으로 압축하세요. ZIP의 맨 위에 SKILL.md가 들어 있는 oil-cover 폴더가 있어야 하며, 파일을 그냥 흩어 놓으면 안 됩니다
+Create skillUpload a skill파일 oil-cover.zip 선택
SettingsCapabilitiesCode execution and file creation
Turn on Code execution and file creation first (newer menus: Create and edit files) · personal plans: Settings → Capabilities · Team/Enterprise: an admin turns it on under Organization settings → Plugins & skills · every plan, including Free
Upload once; it works in claude.ai and Claude Desktop, and in recent Claude Code signed in with a Claude account (not with an API key)
Cowork and cloud sessions use the skills turned on in your claude.ai account, not ~/.claude/skills on your computer (Claude Desktop scheduled tasks run locally and still load it)
Checked against official docs 2026년 11월 12일 · Source: support.claude.com, support.claude.com, code.claude.com
이 문장을 복사해 Claude Code 채팅에 붙여 넣으세요
프로젝트 하나에만 설치하려면 그 프로젝트 폴더에서 열려 있는 채팅에 붙여 넣으세요 · AI는 설치하기 전에 항상 경로를 먼저 보여 줍니다
AI가 무엇을 할지 먼저 알려 주고 모든 단계에서 허락을 구합니다
Claude Code를 다시 열고 /oil-cover를 입력하거나 관련 작업을 요청하면 Claude가 알아서 써요
Checked against official docs 2026년 11월 12일 · Source: code.claude.com
Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.
이미 설치했나요? 먼저 확인 · 터미널을 열고 이 명령을 입력한 뒤 Enter
node -vMac: ⌘ + Space를 누르고 Terminal 입력 후 Enter
Windows: 시작 메뉴를 열고 Windows PowerShell 입력 후 "열기"
아직 설치하지 않았다면: 공식 다운로드 페이지에서 LTS 버전과 클릭형 설치 파일을 고르세요: Mac은 .pkg · Windows는 .msi. 더블클릭 후 끝까지 진행하면 됩니다. curl 명령은 필요 없습니다
설치가 끝나면 터미널을 닫았다가 다시 열고 같은 명령을 실행하세요. 버전 번호가 나와야 합니다: node -v
한 번 설치하면 Node.js가 필요한 모든 도구에서 쓸 수 있습니다
명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요
제작자 README에서 가져온 명령으로, 제작자 코드를 내려받아 실행해요
Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요
repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요
명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요
ChatGPT 데스크톱 앱에는 Codex가 들어 있고, Codex는 ~/.agents/skills 폴더에서 Skill을 읽습니다
ChatGPT 데스크톱 앱에서 Codex를 열고 이 문장을 채팅에 붙여 넣으세요
AI는 설치하기 전에 항상 경로를 먼저 보여 줍니다
AI가 무엇을 할지 먼저 알려 주고 모든 단계에서 허락을 구합니다
oil-cover 폴더를 ~/.agents/skills/oil-cover에 넣으세요
~는 홈 폴더($HOME)입니다
Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.
Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요
repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요
명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요
Checked against official docs 2026년 11월 15일 · Source: learn.chatgpt.com
직접 설치한 Skill은 쓸 수 없고, 디렉터리의 플러그인에 들어 있는 Skill만 쓸 수 있습니다
이 Skill을 ChatGPT에서 쓰려면 위 방법대로 ChatGPT 데스크톱 앱을 쓰세요
Checked against official docs 2026년 11월 15일 · Source: learn.chatgpt.com
이 문장을 복사해 Codex 채팅에 붙여 넣으세요 · ChatGPT 데스크톱 앱 안의 Codex, Codex CLI, IDE 확장 프로그램에서 모두 쓸 수 있습니다
프로젝트 하나에만 설치하려면 그 프로젝트 폴더에서 열려 있는 채팅에 붙여 넣으세요 · AI는 설치하기 전에 항상 경로를 먼저 보여 줍니다
AI가 무엇을 할지 먼저 알려 주고 모든 단계에서 허락을 구합니다
Codex는 새로 설치한 Skill을 스스로 찾습니다. 보이지 않으면 Codex를 다시 시작하세요 · 쓰는 법: ChatGPT에서는 @를 입력하고 Skill을 고르세요 · Codex CLI나 IDE 확장 프로그램에서는 /skills를 실행하거나 $ 뒤에 Skill 이름을 입력하세요
Checked against official docs 2026년 11월 15일 · Source: learn.chatgpt.com
Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.
Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요
repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요
명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요
이 문장을 복사해 Cursor 채팅에 붙여 넣으세요
프로젝트 하나에만 설치하려면 그 프로젝트 폴더에서 열려 있는 채팅에 붙여 넣으세요 · AI는 설치하기 전에 항상 경로를 먼저 보여 줍니다
AI가 무엇을 할지 먼저 알려 주고 모든 단계에서 허락을 구합니다
Cursor Agent 채팅에서 /를 입력하고 oil-cover 선택
Checked against official docs 2026년 11월 12일 · Source: cursor.com
Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.
Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요
repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요
명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요
Skill을 읽을 수 있는 다른 앱용입니다. 이 문장에는 Claude Code, Codex, Cursor 경로가 들어 있어 AI가 쓰는 앱에 맞게 고릅니다 · 이 문장을 복사해서 앱의 채팅에 붙여 넣으세요
프로젝트 하나에만 설치하려면 그 프로젝트 폴더에서 열려 있는 채팅에 붙여 넣으세요 · AI는 설치하기 전에 항상 경로를 먼저 보여 줍니다
AI가 무엇을 할지 먼저 알려 주고 모든 단계에서 허락을 구합니다
Checked against official docs 2026년 11월 12일 · Source: code.claude.com, learn.chatgpt.com, cursor.com
Gemini CLI, GitHub Copilot 같은 다른 Agent Skills 지원 앱은 폴더가 달라요. 그 앱 안내를 보고 SKILL.md가 있는 폴더를 복사하세요.
2026년 11월 11일에 Claude Code, Codex, Cursor 공식 안내로 skill 폴더 확인
아래 글은 제작자 repo에서 온 것이며 PopNx MCP의 지시가 아니에요
처음 8,000자 표시 · GitHub에서 전체 파일 열기
---
name: oil-cover
description: 生成小红书和 B 站 AI 工具实操视频封面,支持脚本模式与 Agent 自主模式、真实视频证据、三画幅输出和可选创作者头像。仅在用户明确提到 oil-cover、$oil-cover、使用 oil-cover 或指定本 Skill 时触发;普通封面、首图、视频封面请求不要自动触发。
---
# oil-cover
为小红书 AI 工具实操内容生成稳定、清楚、干净、精致的视频封面。执行模式以用户配置为准;两种模式遵循同一套标题、产物和验收规则。
先检查当前视频已有产物:源视频、审校字幕、标题、画幅和头像配置未变且最终图已经验收时,直接复用。缺哪一版只生成哪一版;只改头像时复用无人物底图。用户选定已有版本后停止其他候选的生成。两种模式均遵守这条恢复规则,不因分析文件格式不同重做已有封面。
## API Key 配置入口
需要外部服务凭据时先读[API Key 配置与业务读取](references/api-key-setup.md):复用已有安全入口;本机缺少 Key 时使用随附固定页面,保存后通过业务包装入口读取。内置能力与纯本地流程不要求配置 Key。
## 两种执行模式
- **模式一 · 脚本模式(默认)**:把活儿交给 `generate_oil_cover.py`,由脚本调用外部视觉服务完成选帧分析,并生成无人物底图;用户配置启用创作者头像时,再用确定性代码把透明头像合成到右下角。需要 Python、ffmpeg、Pillow 和所选服务的 API Key。下面「默认入口」到「输出说明」描述的都是这一模式。
- **模式二 · Agent 自主执行**:复用宿主视觉与内置生图能力,无需额外服务 Key,由执行的 Agent 自己读 SOP 完成选帧、分析和生图;用户配置启用头像时,再调用项目脚本的头像合成函数。完整流程见 `references/agent-native-flow.md`。
## 安装位置与用户配置
不要假设用户名、Skill 安装目录、视频库、脚本、素材镜像或密钥位置。
- `SKILL_DIR`:当前这份 `SKILL.md` 所在目录。
- 用户配置:`${OIL_COVER_CONFIG:-$HOME/.oil-cover/config.json}`。它属于本机用户,不进入 Skill 仓库。
- Skill 内脚本:`$SKILL_DIR/scripts/generate_oil_cover.py`。若安装包没有脚本,读取配置里的 `script_path`;两者都不存在时说明安装不完整,不要猜个人目录。
- Skill 内资产:`$SKILL_DIR/assets/`。额外素材镜像仅从配置 `product_asset_mirror` 读取。
- API key:优先使用 `ZENMUX_API_KEY`;备用文件仅从 `api_key_file` 配置或 `--api-key-file` 读取。不要把 key 或个人绝对路径写进 Skill 仓库。
支持的用户配置:
```json
{
"mode": "agent-native",
"creator_name": "optional creator name",
"script_path": "/optional/path/to/generate_oil_cover.py",
"video_library_root": "/optional/path/to/video-library",
"product_asset_mirror": "/optional/path/to/shared-product-assets",
"api_key_file": "/optional/path/to/zenmux-key",
"creator_portrait": {
"enabled": false,
"path": "/optional/path/to/portrait.png"
}
}
```
路径允许使用 `~`,读取后必须展开。没有配置 `video_library_root` 时,所有持久产物默认跟随输入视频。配置后,同一视频的持久资源统一放进 `<video_library_root>/<视频标题>/`;从导出暂存目录开始处理时,先无覆盖地归位源视频,再生成字幕、封面和 sidecar。
### 选哪个模式(设一次,以后不问)
每次触发 oil-cover 时按这个顺序决定:
1. 先读用户配置的 `mode` 字段。
2. 已设为 `script` 或 `agent-native` → **直接按该模式执行,不再询问**。
3. 未设置(第一次)→ 问用户一次默认想用哪种模式,说明这是一次性设置;拿到答案后更新用户配置,再按选择执行。保留文件里的其他配置键,不要整份覆盖:
```bash
mkdir -p "$(dirname "${OIL_COVER_CONFIG:-$HOME/.oil-cover/config.json}")"
# 合并写入 {"mode":"agent-native"},或设为 "script"
```
4. 用户随时可说「切换 / 改成 X 模式」覆盖默认(重写该文件),或在单次任务里临时指定某模式而**不**改默认偏好。
**前提与回退**:模式二要求执行 Agent 具备多模态视觉 + 支持参考图的生图工具,通过当前宿主实际提供的工具判断,不根据宿主品牌推断。若 `mode=agent-native` 但当前环境跑不了生图这一步,说明情况并给两条路——使用具备所需能力的宿主,或在已授权的服务范围内临时使用脚本模式——不要静默失败,也不要擅自改掉用户的默认偏好。
走模式二时,先完整读 `references/agent-native-flow.md` 和 `references/cover-rules.md`,按 SOP 执行,**忽略下面所有针对脚本的参数与说明**。
## 修改已有风格
用户反馈字号、留白或局部排版时,默认只调整对应问题,保留原有字体气质、配色体系、透视、装饰和主体表达。先保留可回退的图片与提示词,再做最小修改;未明确要求更换风格时,不全面重写视觉规范。
## 封面标题提炼(执行者职责)
封面主标题由执行本 skill 的 Agent 在跑脚本**之前**自己提炼,不交给脚本里的分析模型做,避免它理解错内容:
- 用户已经指定封面标题,或要求“封面也用文件名”时,直接锁定原文,只做视觉断行;只有未指定时才按下述方法提炼。视频文件名、封面标题、发布标题分别记录,不能互相覆盖。平台发布标题的长度限制不用于缩短封面标题。
- 视频标题只是主题输入,封面主标题不必和它一模一样。要突出这条视频最有分量的重点:结论、评价、对比、数字。
- **字数与品牌名解耦(防字号缩水)**:Agent 自拟主标题时,默认提炼为 **`2 行 × 3–5 字`(最佳 `4+4` 字,两行用空格分隔,如 `"AI 写前端 风格统一"`、`"后台设计 更有质感"`、`"一眼看懂 代码改动"`)**。不要把长英文品牌名或工具名(如 `Claude Code`、`GitHub Copilot`、`Screen Studio`)硬塞进主标题行内凑成 7–8 个字符导致整块标题字号被迫缩小;长品牌名应拆为标题上方的独立品牌小标(small product mark / eyebrow lockup),把主标题空间留给两行超大字(短词如 `AI` 除外)。
- 有字幕或文稿时(`.srt`/`.ass`/`.txt`,或视频旁的同名字幕文件)先通读一遍再提炼。`.ass`/`.srt` 先抽成纯文本(去掉时间轴和样式标记)。优先借用视频里的原话强词(例如口播里的「目前最强」「指哪打哪」这类明确判断),忠于内容,不夸大、不编造评价。
- 没有字幕、文稿或用户补充时,才退回视频标题本身做克制的精简。
- 提炼结果通过 `--title` 传给脚本;抽好的纯文本字幕通过 `--subtitle` 传入,供分析模型选帧、写副标题和点缀使用。分析模型会把 `--title` 当作已定稿的封面主标题,只做断行和排版,不再改写。
- **独立理解检查**:封面脱离文件名、正文和此前对话时,也要让第一次看到的人马上知道主题。主标题优先写清“对象 + 具体任务或结果”;不要单独用依赖上下文的反转短语(如“不只 X”)、泛化形容词或悬念句代替主题。若使用这类表达,副标题必须同时点明具体对象和结果。生成后只看封面做一次理解检查;仍说不清视频讲什么,就改写标题并重新生成、检查全部画幅。
## 默认入口
将实际存在的生成脚本绝对路径记为 `OIL_COVER_SCRIPT`。默认运行以下命令;有字幕时额外添加 `--subtitle "<实际纯文本字幕路径>"`,没有字幕时省略该参数:
```bash
node "$SKILL_DIR/scripts/credential-ui/src/profile.ts" run default -- python3 "$OIL_COVER_SCRIPT" \
--video "<视频路径>" \
--title "<提炼后的封面主标题>" \
--topic "<补充背景>"
```
如果用户提供的是截图或已选关键帧:
```bash
node "$SKILL_DIR/scripts/credential-ui/src/profile.ts" run default -- python3 "$OIL_COVER_SCRIPT" \
--image "<截图或关键帧路径>" \
--logo "<可选 Logo 路径>" \
--title "<标题或主题>" \
--topic "<补充背景>"
```
默认不传 `--aspect` 时,脚本会并行生成小红书 `3:4` 竖屏版、通用/B 站首页主封面 `4:3` 横屏版和 `16:9` 横屏版。只重跑或按需生成部分画幅时使用 `--aspect both`(`3:4` + `4:3`)、`--aspect 3x4`、`--aspect 4x3`、`--aspect 16x9` 或逗号组合(如 `3x4,4x3`、`4x3,16x9`)。
## 进阶参数
- `--subtitle <脚本/字幕/转录文件>`:把上下文喂给 Gemini,帮助判断主题、标题措辞和证据选择。有完整文稿时优先加上。
- `--logo <Logo 路径>`:可多次传入多个产品 Logo 作为参考资产。
- 自动 Logo 匹配只把 `--title` 和 `--topic` 当作主产品依据。只要其中任一存在,就不再扫描字幕寻找 Logo,避免把口播里的次要产品错当成主产品。
- 主产品没有可信 Logo 资产时保持无外置 Logo,不拿字幕中的其他品牌代替,也不让生图模型发明近似标识;此时用准确产品名和真实界面建立识别。
- 如果标题、字幕、视频画面或截图能明确判断主产品有 Logo,但 `references/product-assets.md` 暂时没有对应资产,先联网寻找官方或可信来源的透明 PNG,归档到 `$SKILL_DIR/assets/product-logos/`;配置了 `product_asset_mirror` 时再同步到镜像目录。通过 `--logo` 传给脚本,高频复用的产品同步补充到 `product-assets.md` 和脚本的自动匹配表。
- 取帧策略是「本地预筛」:脚本用 ffmpeg 低分辨率扫描整段视频,对每帧算清晰度(拉普拉斯方差)、亮度、内容度,硬过滤掉黑屏/纯白/纯色/loading/模糊帧,再按时间分桶取每段最清晰的一帧,产出若干**真实高清候选**交给分析模型按语义挑最佳帧。全程不调模型选帧、不上传整段视频。这是唯一的自动取帧路径,没有旧的「视频选帧」/均匀盲采兜底——预筛若失败会直接报错,不会静默降级。
- `--frame-count <N>`:本地预筛产出多少个候选帧供分析模型挑选,默认 8。候选越多模型选择越好,但分析请求越大。
- `--scan-fps <N>`:本地预筛扫描的采样帧率,默认 0=自动(≤5 分钟视频用 2fps,更长用 1fps)。想抓更细的瞬间可调高。
- `--candidate-seconds 1,8,24.5`:手动指定取帧时间点,跳过本地预筛。已经知道哪几秒是关键画面时用。
- `--aspect all|both|3x4|4x3|16x9|组合`:默认 `all` 并行生成三版;`both`(或 `3x4,4x3`)只生成 `3:4` 和 `4:3`;单独生成或重跑时传入指定画幅或逗号组合(如 `4x3,16x9`)。
- `--cover-state-file <状态文件路径>`:可选,每完成或失败一个画幅立即原子写入 JSON 状态(含 `generated` 与最终路径),供并行发布编排实时追踪各画幅进度。
- `--bilibili-size <尺寸>`:B 站个人空间 `16:9` 伴随版的 API 尺寸,默认 `1280x720`;B 站个人空间槽使用此 `16:9` 文件独立上传。
- 副标题默认放开。如需禁用副标题、让外层只剩主标题,传 `--no-allow-subtitle`。
- 创作者头像由本地代码在生图后合成,不作为 Gemini 或 `gpt-image-2.5-flare` 的参考图上传。是否启用及素材路径来自用户配置;公开 Skill 默认关闭。默认布局参数为:3:4 宽约 55%、顶部约 58%、向右越界约 6%;4:3 宽约 38%、顶部约 40%、向右越界约 3%;16:9 宽约 32%、顶部约 40%、右侧内收约 2%。
- 用户明确要求无人物封面时传 `--no-default-creator-portrait`。配置启用头像时默认保留;未配置时保持无人物。
排查与验证:
- `--dry-run`:不调任何 API,只准备本地文件和 prompt,用于核对路径、规则文件和素材是否就位。
- `--skip-generate`:只跑 Gemini 分析和写 prompt,不调用图片 API。用来看 Gemini 选了哪一帧、标题怎么断行、prompt 写成什么样。
- `--generation-only`:用 `/images/generations` 而非 `/images/edits`,屏幕帧和 Logo 参考图不上传给图片 API;头像启用时始终只在本地合成。
## 脚本职责
- 脚本路径:优先 `$SKILL_DIR/scripts/generate_oil_cover.py`,否则使用用户配置 `script_path`
- 默认分析模型:`google/gemini-3.8-flash`
- 默认生图模型:`openai/gpt-image-2.5-flare`
- 默认规则文件:`references/cover-rules.md`
- 默认输出位置:视频(或图片)所在目录。最终封面命名 `<视频名>_3x4.png`、`<视频名>_4x3.png`、`<视频名>_16x9.png`,直接落在影片旁边方便查找;分析、prompt、原始响应等中间产物收进 `<视频名>.oil-cover/` 子目录。传 `--output-root` 可改到别处。
脚本负责用 ffmpeg 本地扫描+评分预筛出若干高清候选帧(默认策略,无需调模型),把候选交给视觉模型分析、由模型按语义选出最佳封面帧并生成封面方案和提示词、保存 sidecar、并行调用所选图片服务、生成无人物底图。用户配置启用头像时,再用 Pillow 把透明头像按画幅参数合成到右下角;头像不会进入 视觉或图片 API 的参考图列表。底图保存在 `<视频名>.oil-cover/<画幅>.generated-base.png`,合成记录保存在 `portrait_composite.json`,最终封面写到影片目录。本地预筛的打分明细写在 `<视频名>.oil-cover/frame_selection_local.json`。
## 何时读取参考文件
- 走模式二(Agent 自主执行)时,先完整读 `references/agent-native-flow.md`(流程 SOP)和 `references/cover-rules.md`(视觉规范)。
- 日常生成封面时(模式一),不需要手动读取完整视觉规范;脚本会把 `references/cover-rules.md` 传给 Gemini。
- 修改视觉规则、排查提示词遗漏、评审模型输出质量或调整脚本 guard 时,读取 `references/cover-rules.md`。
- 判断产品 Logo 或产品资产时,读取 `references/product-assets.md`。
- 新增产品 Logo、排查资产缺失或判断可信来源时,读取 `references/product-assets.md` 并按里面的补充规则执行。
- 如果用户要求复刻特定冲击型科技封面风格,读取 `references/impact-tech-cover-style.md`。
## 不可违反
- 生图模型必须一次性生成完整无人物底图,包括真实屏幕证据、标题、产品标识、点缀和风格化效果。
- 头像按配置直接合成,不要求预留避让空间,也不以头像遮挡为验收或返工条件。
- 本地后处理只允许执行一项:配置启用头像时,把配置的透明头像按固定参数 alpha 合成到右下角。不要本地贴字、贴 Logo、拼其他图片、重排、裁切改版或视觉修补。
- 源截图、重建 UI 和生图底图不保留人物、人脸、头像、摄像头气泡和真人画中画;配置启用头像时,最终封面只允许出现这一张代码合成的头像,否则最终封面保持无人物。
- 绝对不要把历史案例或上一次任务里的产品名、模型名、关键词、品牌色和点缀带入当前封面。所有外层文字和点缀都必须来自当前视频、当前标题、当前字幕、当前截图或当前用户补充信息。
- 外置产品 Logo 必须对应当前主标题或用户显式传入的参考资产;字幕里的次要品牌不能替代主产品,没有匹配资产时不放外置 Logo。
- 默认同时交付 `3:4`、`4:3` 和 `16:9` 三版;上游流程明确指定所需画幅集合(如未选 YouTube 时传 `--aspect both`)或单独重跑时,只生成指定画幅。
- 锁定标题的断行必须逐字拼回用户原题,不能在英文标识或版本号内部断开。写入生图 prompt 前统一替换完整标题指令,包括模型的逐行描述,只保留一套标题与断行;副标题和构图指令独立保留。重新应用 guard 后结果必须不变。
- 每次生图前保存 `.prompt.md` sideca질문하고, 팁을 나누고, 안 되는 점을 알려 주세요. "도움이 됨"이 많은 순서예요.