Night Market 技能 — 移植自 claude-night-market/scry。如需完整体验（含 agent、hook 和命令支持），请安装 Claude Code 插件。

目录

• 概述
• 必需的 TodoWrite 项
• 流程
• 步骤 1：验证输入文件
• 步骤 2：检查 ffmpeg 安装状态
• 步骤 3：执行转换
• 基础转换（速度快，输出文件较大）
• 高画质（带调色板生成，推荐使用）
• 最高画质（启用抖动处理）
• 优化选项
• 常用预设
• 步骤 4：验证输出结果
• 退出条件
• 故障排查
• 输出文件过大
• 色彩断层（Color Banding）
• 转换速度慢

GIF 生成技能

对视频文件（webm/mp4）进行后处理，并生成可配置画质参数的优化 GIF 输出。

适用场景

• 将录屏文件转换为动画 GIF 格式
• 制作轻量级演示动画

不适用场景

• 需要高质量视频输出时 —— 请使用完整的录屏工具
• 无需动画效果的静态图像生成

概述

本技能用于将视频录制文件（通常来自浏览器自动化任务）转换为 GIF 格式。它提供多种画质预设与优化选项，可在文件体积与视觉质量之间取得平衡。

必需的 TodoWrite 项

- 验证输入视频文件是否存在
- 检查 ffmpeg 是否已安装
- 执行 GIF 转换
- 验证输出结果并报告状态

验证方式：运行命令时附加 --help 参数以确认其可用性。

流程

步骤 1：验证输入文件

确认源视频文件存在且格式受支持：

# 检查文件是否存在并获取基本信息
if [[ -f "$INPUT_FILE" ]]; then
    file "$INPUT_FILE"
    ffprobe -v quiet -show_format -show_streams "$INPUT_FILE" 2>/dev/null | head -20
else
    echo "错误：未找到输入文件：$INPUT_FILE"
    exit 1
fi

验证方式：运行命令时附加 --help 参数以确认其可用性。

支持的输入格式：.webm、.mp4、.mov、.avi

步骤 2：检查 ffmpeg 安装状态

验证 ffmpeg 是否可用：

if ! command -v ffmpeg &> /dev/null; then
    echo "错误：ffmpeg 未安装"
    echo "Linux 系统请执行：sudo apt install ffmpeg；macOS 系统请执行：brew install ffmpeg"
    exit 1
fi
ffmpeg -version | head -1

验证方式：运行命令时附加 --help 参数以确认其可用性。

步骤 3：执行转换

根据画质需求选择合适的转换命令：

基础转换（速度快，输出文件较大）

ffmpeg -i input.webm -vf "fps=10,scale=800:-1" output.gif

验证方式：运行命令时附加 --help 参数以确认其可用性。

高画质（带调色板生成，推荐使用）

ffmpeg -i input.webm -vf "fps=10,scale=800:-1:flags=lanczos,split[s0][s1];[s0]palettegen[p];[s1][p]paletteuse" output.gif

验证方式：运行命令时附加 --help 参数以确认其可用性。

最高画质（启用抖动处理）

ffmpeg -i input.webm -vf "fps=15,scale=1024:-1:flags=lanczos,split[s0][s1];[s0]palettegen=max_colors=256:stats_mode=single[p];[s1][p]paletteuse=dither=bayer:bayer_scale=5" output.gif

验证方式：运行命令时附加 --help 参数以确认其可用性。

优化选项

常用预设

# 缩略图（体积小，加载快）
ffmpeg -i input.webm -vf "fps=8,scale=480:-1:flags=lanczos,split[s0][s1];[s0]palettegen[p];[s1][p]paletteuse" thumbnail.gif

# 文档用途（均衡画质与体积）
ffmpeg -i input.webm -vf "fps=10,scale=800:-1:flags=lanczos,split[s0][s1];[s0]palettegen[p];[s1][p]paletteuse" docs.gif

# 高保真演示
ffmpeg -i input.webm -vf "fps=15,scale=1024:-1:flags=lanczos,split[s0][s1];[s0]palettegen=max_colors=256[p];[s1][p]paletteuse" demo.gif

验证方式：运行命令时附加 --help 参数以确认其可用性。

步骤 4：验证输出结果

确认转换成功并报告关键指标：

if [[ -f "$OUTPUT_FILE" ]]; then
    echo "GIF 已成功生成：$OUTPUT_FILE"

    # 报告文件大小
    SIZE=$(du -h "$OUTPUT_FILE" | cut -f1)
    echo "文件大小：$SIZE"

    # 获取分辨率与帧数
    ffprobe -v quiet -select_streams v:0 -show_entries stream=width,height,nb_frames -of csv=p=0 "$OUTPUT_FILE"
else
    echo "错误：GIF 生成失败"
    exit 1
fi

验证方式：运行命令时附加 --help 参数以确认其可用性。

退出条件

• 输入文件已验证为存在的有效视频格式
• ffmpeg 已确认可用
• GIF 文件已在指定输出路径成功创建
• 输出文件大小已向用户报告
• 转换过程中未出现 ffmpeg 错误

故障排查

输出文件过大

降低画质设置：

# 降低帧率与分辨率
ffmpeg -i input.webm -vf "fps=8,scale=640:-1:flags=lanczos,split[s0][s1];[s0]palettegen[p];[s1][p]paletteuse" smaller.gif

验证方式：运行命令时附加 --help 参数以确认其可用性。

色彩断层（Color Banding）

启用抖动处理：

ffmpeg -i input.webm -vf "fps=10,scale=800:-1:flags=lanczos,split[s0][s1];[s0]palettegen[p];[s1][p]paletteuse=dither=floyd_steinberg" smooth.gif

验证方式：运行命令时附加 --help 参数以确认其可用性。

转换速度慢

为提升速度，使用不带调色板生成的基础转换：

ffmpeg -i input.webm -vf "fps=10,scale=800:-1" quick.gif

验证方式：运行命令时附加 --help 参数以确认其可用性。