[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-92326":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":14,"subscribersCount":14,"size":14,"stars1d":14,"stars7d":14,"stars30d":15,"stars90d":14,"forks30d":14,"starsTrendScore":14,"compositeScore":16,"rankGlobal":9,"rankLanguage":9,"license":17,"archived":18,"fork":18,"defaultBranch":19,"hasWiki":20,"hasPages":18,"topics":21,"createdAt":9,"pushedAt":9,"updatedAt":22,"readmeContent":23,"aiSummary":24,"trendingCount":14,"starSnapshotCount":14,"syncStatus":25,"lastSyncTime":26,"discoverSource":27},92326,"oil-cover","oil-oil\u002Foil-cover","oil-oil","为小红书 AI 工具实操内容生成稳定、干净、精致封面的 Claude \u002F Codex Skill（脚本模式 + Agent 自主执行）",null,"Python",54,6,51,0,3,42.84,"Other",false,"main",true,[],"2026-07-22 04:02:05","# oil-cover\n\n为小红书「AI 工具实操」内容生成稳定、清楚、干净、精致的视频封面的 Claude \u002F Codex Skill。\n\n方向是 **真实屏幕证据 + Apple-like 产品视觉 + 清晰标题 + 无人物干净构图**，一次性整图生成，不靠本地贴字拼图。\n\n> 作者：oil 欧呦（[@oil-oil](https:\u002F\u002Fgithub.com\u002Foil-oil)）\n\n## 封面示例\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"docs\u002Fshowcase\u002Fgallery.png\" width=\"860\">\n\u003C\u002Fp>\n\u003Cp align=\"center\">\n  \u003Cimg src=\"docs\u002Fshowcase\u002Fgallery-4x3.png\" width=\"640\">\n\u003C\u002Fp>\n\n## 特点\n\n- **视频选帧**：把整段视频压成小 clip 交给多模态模型看完全片、按内容挑出最适合做封面的一帧（带理由），比盲采等距帧准得多。\n- **完整视觉规范**：`references\u002Fcover-rules.md` 覆盖构图、背景层、字体标题、点缀、自动质检和提示词骨架。\n- **默认双画幅**：并行出 `3:4` 竖版和 `4:3` 横版。\n- **产品 Logo 自动匹配**：内置 Claude \u002F Codex \u002F Cursor \u002F Gemini \u002F GitHub 等常用 AI 产品 Logo。\n\n## 两种执行模式\n\n| | 脚本模式（默认） | Agent 自主执行 |\n| --- | --- | --- |\n| 怎么跑 | 跑 `scripts\u002Fgenerate_oil_cover.py` | 执行的 Agent 自己读 SOP 端到端完成 |\n| 选帧 \u002F 分析 | ZenMux 上的 Gemini | Agent 自身多模态视觉 |\n| 生图 | ZenMux `gpt-image-2` | Agent 自带图像生成工具（图生图） |\n| 依赖 | Python + ffmpeg + ZenMux key | 仅需带生图工具的 Agent（如 Codex 内置 `image_gen`） |\n| 适合 | 高保真、可复现 | 零外部依赖、零 key |\n\n模式偏好记在 `~\u002F.oil-cover\u002Fconfig.json`，设一次以后不再问。自主模式完整流程见 [`references\u002Fagent-native-flow.md`](references\u002Fagent-native-flow.md)。\n\n## 安装\n\n把本仓库克隆到 Claude Code 或 Codex 的 skills 目录：\n\n```bash\n# Claude Code\ngit clone https:\u002F\u002Fgithub.com\u002Foil-oil\u002Foil-cover.git ~\u002F.claude\u002Fskills\u002Foil-cover\n\n# 或 Codex\ngit clone https:\u002F\u002Fgithub.com\u002Foil-oil\u002Foil-cover.git ~\u002F.codex\u002Fskills\u002Foil-cover\n```\n\n脚本按 `OIL_COVER_SKILL_DIR` → `~\u002F.claude\u002Fskills\u002Foil-cover` → `~\u002F.codex\u002Fskills\u002Foil-cover` 的顺序自动定位规则文件和 Logo 资产，装到上面任一位置即开箱可用，无需配置环境变量。\n\n## 用法（脚本模式）\n\n```bash\npython3 ~\u002F.claude\u002Fskills\u002Foil-cover\u002Fscripts\u002Fgenerate_oil_cover.py \\\n  --video \"\u003C视频路径>\" \\\n  --title \"\u003C标题或主题>\" \\\n  --topic \"\u003C补充背景>\"\n```\n\n截图 \u002F 关键帧输入：\n\n```bash\npython3 ~\u002F.claude\u002Fskills\u002Foil-cover\u002Fscripts\u002Fgenerate_oil_cover.py \\\n  --image \"\u003C截图路径>\" \\\n  --logo \"\u003C可选 Logo 路径>\" \\\n  --title \"\u003C标题>\"\n```\n\n默认并行出 `3:4` + `4:3`。完整参数（取帧策略、`--dry-run`、`--skip-generate` 等）见 [`SKILL.md`](SKILL.md)。\n\n### 配置 ZenMux key（仅脚本模式需要）\n\n脚本调用 ZenMux（Gemini 分析 + `gpt-image-2` 生图），需要 API key。按优先级读取：\n\n1. `--api-key` 参数\n2. `ZENMUX_API_KEY` 环境变量\n3. skill 目录根的 `.zenmux_api_key` 文件（已被 `.gitignore` 忽略，**切勿提交**）\n\n### 依赖\n\n- Python 3.9+\n- `ffmpeg`（视频抽帧）\n- 一个 ZenMux 账号与 API key\n\n## 用法（Agent 自主执行）\n\n在带图像生成工具的 Agent（如 Codex）里触发，Agent 会读 [`references\u002Fagent-native-flow.md`](references\u002Fagent-native-flow.md) 自己完成选帧、分析、出图，**不需要 ZenMux key**。生图那一步在 Codex 里用其系统级 `imagegen` 的内置 `image_gen` 工具（图生图）。\n\n## 目录结构\n\n```\nSKILL.md                        技能主说明（两种模式 + 参数）\nscripts\u002Fgenerate_oil_cover.py   脚本模式实现\nreferences\u002F\n  cover-rules.md                完整视觉规范\n  agent-native-flow.md          Agent 自主执行 SOP\n  impact-tech-cover-style.md    可选的冲击型科技封面风格\n  product-assets.md             产品 Logo 资产清单\nassets\u002Fproduct-logos\u002F           内置 AI 产品 Logo\n```\n\n## 商标与第三方资产\n\n`assets\u002Fproduct-logos\u002F` 内的产品 Logo 为各自公司商标，仅作封面参考资产，**不在本项目 MIT 许可范围内**，收录于此不代表任何合作或背书。来源与归属见 [NOTICE](NOTICE)。\n\n## License\n\n[MIT](LICENSE) © 2026 oil 欧呦\n","oil-cover 是一个专为小红书 AI 工具类实操内容生成高质量视频封面的自动化技能工具。它支持脚本模式与 Agent 自主执行两种方式，核心能力包括：基于多模态模型（Gemini 或 Agent 内置视觉模块）智能选帧、遵循 Apple 风格的视觉规范（无人物构图、清晰标题、产品 Logo 自动匹配）、并行输出 3:4 竖版与 4:3 横版封面。不依赖本地贴字拼图，全程端到端生成。适用于 AI 工具教程创作者、知识类博主及需批量产出专业封面的短视频生产场景。",2,"2026-07-08 04:30:06","CREATED_QUERY"]