📦 Openclaw Thumbnail Forge — OpenClaw ThumbnAIl Forge

openclaw-thumbnail-forge v0.1.0 一个实用的视频缩略图生成器。它可以生成专业级别的缩略图，类似于用Photoshop或Canva创建的效果，但它是一个本地的CLI工作流，不需要API密钥、在线服务或AI依赖。

该技能的功能： scripts/check_deps.sh — 验证ffmpeg、ffprobe、python3（以及Pillow Python包）是否已安装。 scripts/pick_frames.py — 从视频中提取候选帧，并根据清晰度（Laplacian方差）、亮度、对比度和ffmpeg场景更改评分对其进行排名。输出前N帧作为PNG文件和JSON报告。 scripts/compose_thumbnail.py — 将一帧源图像转换为完成的缩略图，带有粗体标题文本、副标题、渐变条、可选的Logo覆盖层和自动对比度增强。支持自定义字体和颜色方案。 scripts/export_sizes.py — 将完成的缩略图重新导出到所有常见平台大小，只需一个命令（YouTube、Shorts、Instagram正方形、X/Twitter、LinkedIn）。 scripts/make_variants.py — 生成四个可用于A/B测试的缩略图变体（不同的颜色方案、文本位置、对比度级别），用于分割测试。

该技能不做什么： 诚实地设定期望：它不使用AI主题检测或面部识别。帧排名是统计的，而不是语义的。它不下载字体、股票照片或任何远程资产。您需要提供自己的字体路径或使用系统默认字体。它不执行OCR、转录或生成编辑。它不在您提供的目录外写入任何内容。

所需依赖项： bash scripts/check_deps.sh 验证ffmpeg、ffprobe、python3以及PIL（Pillow）是否可导入。Pillow是唯一的Python依赖项：pip install Pillow

工作流程：

• 从视频中选取最佳候选帧

python3 scripts/pick_frames.py input.mp4 ./frames/ --top 10 --interval 2.0 提取每2秒一个帧，评分每个帧，并将前10个帧写入frames/frame_001.png至frames/frame_010.png，以及frames/report.json，包含每帧评分。 可调参数：--interval — 采样间隔（默认2.0）；--top — 保留的前N帧（默认10）；--min-brightness <0-255> 和 --max-brightness <0-255> — 拒绝太暗或过亮的帧；--min-sharpness — 拒绝模糊帧（Laplacian方差下限）

• 从帧中组装完成的缩略图

python3 scripts/compose_thumbnail.py frames/frame_003.png thumb.png --title "10 ffmpeg Tricks I Wish I Knew Sooner" --subtitle "A practical tour" --color-scheme bold-yellow --position bottom 颜色方案：bold-yellow、clean-white、red-alert、cool-blue、tech-green。每个方案定义标题颜色、轮廓颜色、阴影和渐变条不透明度。位置选项：top、bottom、center。脚本自动调整标题大小以适应可用宽度，并在文本后面添加可读的渐变条，以便缩略图在小尺寸下也可读。 可选Logo覆盖层：python3 scripts/compose_thumbnail.py frames/frame_003.png thumb.png --title "Your Title" --logo logo.png --logo-corner top-right --logo-scale 0.12

• 将缩略图导出到所有平台大小

python3 scripts/export_sizes.py thumb.png ./out/ 写入：out/youtube_1280x720.png out/shorts_1080x1920.png out/instagram_1080x1080.png out/x_1200x675.png out/linkedin_1200x627.png 每个平台使用智能调整大小：源图像适配到目标尺寸，智能裁剪以保持标题区域可见。

• 生成A/B变体

python3 scripts/make_variants.py frames/frame_003.png ./variants/ --title "10 ffmpeg Tricks" --subtitle "A practical tour" 写入4个变体：variant_a_bold_yellow_bottom.png variant_b_clean_white_top.png variant_c_red_alert_center.png variant_d_cool_blue_bottom.png 同一源帧，不同的颜色和布局选择，适合点击率分割测试。

完整的工作流示例： # 1）找到最佳候选帧 python3 scripts/pick_frames.py my_video.mp4 ./frames/ --top 5 --interval 1.5 # 2）从最高评分帧组装缩略图 python3 scripts/compose_thumbnail.py frames/frame_001.png thumb.png --title "Your Title Here" --subtitle "Optional subtitle" --color-scheme bold-yellow --position bottom # 3）导出到所有平台大小 python3 scripts/export_sizes.py thumb.png ./out/ # 4）可选：分割测试变体 python3 scripts/make_variants.py frames/frame_001.png ./variants/ --title "Your Title Here"

安全属性： 所有Python辅助工具使用subprocess.run带参数列表（从不使用shell=True），并通过严格的正则表达式允许列表拒绝包含shell元字符的输入/输出路径。该技能从不读取或写入用户提供的输入/输出路径之外的内容。没有环境变量被读取以获取凭据。没有令牌、机密或API密钥被要求。没有远程调用。该技能仅调用本地安装的ffmpeg和Python Pillow库。

已知限制：帧