media-ops-skill

name	media-ops-skill
description	处理本地已有的图片 / 视频 / 音频文件，或下载网络视频。图片：缩放、裁剪、旋转、格式转换（→webp/png/jpeg）、滤镜、查看尺寸；视频：格式转换、提取音频、查看元信息；下载：YouTube / B 站等公开视频。也用于 AI 生成图片后的二次处理（转格式、缩放）。**不用于**：AI 从零生成图片/视频/语音（→cloud-media-skill）、在对话里渲染图表（→visualization-ops-skill）。
tools	["ImageProcess","VideoConvert","VideoDownload"]

图片 / 视频 / 音频处理

本 skill 覆盖三个本地媒体工具，图片处理是核心能力。

⚡ 读到此处立刻行动 — 不要停下来回复用户。紧接着执行 ToolSearch(names: "ImageProcess") 激活工具 schema，然后调用 ImageProcess 完成操作。这三步必须在同一个 response 内完成。

工具清单

工具	职责
ImageProcess	图片处理：缩放 / 裁剪 / 旋转 / 翻转 / 格式转换 / 灰度 / 模糊 / 锐化 / 着色 / 查看元信息
VideoConvert	视频格式转换 / 提取音频 / 查看元信息
VideoDownload	从 YouTube / B 站等公开网址下载视频

加载：全部为 deferred 工具，调用前须先 ToolSearch(names: "ImageProcess,VideoConvert,VideoDownload") 激活 schema。

决策树

用户需要媒体操作
├── 处理图片？（缩放 / 裁剪 / 旋转 / 转格式 / 滤镜 / 查看尺寸）
│   └── ImageProcess
├── 处理视频？
│   ├── 格式转换 / 调整分辨率 → VideoConvert (action: convert)
│   └── 提取音频 → VideoConvert (action: extract-audio)
├── 查看文件信息？
│   ├── 图片（宽高 / 格式 / DPI） → ImageProcess (action: get-info)
│   └── 视频（时长 / 分辨率 / 编码） → VideoConvert (action: get-info)
└── 下载网络视频？
    └── VideoDownload

ImageProcess — 图片处理

基于 sharp，对已有图片进行变换。AI 生成的图片同样适用。

action	用途	关键参数
get-info	读取宽高、格式、DPI、文件大小	仅 filePath
resize	缩放	width/height/fit
crop	矩形裁剪	left/top/width/height
rotate	旋转	angle
flip	翻转	direction
convert	格式转换	format（png/jpeg/webp/avif/tiff）
grayscale/blur/sharpen/tint	滤镜效果	各有专属参数

处理前先 get-info：了解原始尺寸和格式，避免盲目操作——比如用户说"缩小一半"，你需要知道原始宽高才能计算目标值。

输出路径决策：默认追加后缀（如 photo_resized.jpg）。直接覆盖原文件有风险——用户可能需要原图作对比或回退。用户明确要求覆盖时除外。

VideoConvert — 视频/音频转换

基于 FFmpeg，处理已有文件的格式转换和音频提取。

action	用途	关键参数
get-info	读取时长、分辨率、编解码器、流信息	仅 filePath
convert	视频格式转换	format、resolution
extract-audio	从视频提取音频	audioFormat（mp3/wav/aac/flac）

格式选择建议：

• 通用兼容：MP4（H.264）——几乎所有设备都能播放
• 高质量压缩：WebM（VP9）——文件更小但兼容性略差
• 音频提取：MP3（通用）、FLAC（无损）

大文件注意：视频转码耗时与文件大小成正比。超过 500MB 的文件转换可能需要较长时间，提前告知用户预期等待。

VideoDownload — 视频下载

通过 yt-dlp 下载公开视频 URL。

适用：用户给出公开视频链接，需要下载到本地继续处理（编辑、提取音频、转码）。

不适用：

• 生成新视频 → cloud-media-skill
• 转换本地已有视频 → VideoConvert
• 私有/需登录的视频 → 告知用户 yt-dlp 只能下载公开内容

下载后常见后续：下载完成后用户通常需要进一步处理——提取音频、转换格式、裁剪。主动询问是否需要后续操作。

常见工作流

AI 生成图片后转格式 / 缩放

CloudImageGenerate(…) → 拿到 absolutePath
ImageProcess(action: "get-info", filePath: "…")   # 先确认原始尺寸
ImageProcess(action: "convert", filePath: "…", format: "webp", outputPath: "…")

视频下载 → 提取音频

VideoDownload(url: "...") → 拿到 filePath
VideoConvert(action: "extract-audio", filePath: "...", outputPath: "output.mp3")

批量图片格式转换

对每张图片调用 ImageProcess(action: "convert", format: "webp")。WebP 格式在保持画质的同时文件体积约为 JPEG 的 70%，适合 Web 使用场景。

常见错误

格式不支持 → 检查文件扩展名和实际编码是否匹配。用户可能把 .mp4 文件命名为 .avi，先用 get-info 确认真实格式。

输出文件与输入同路径 → 部分操作不支持原地覆盖。用不同的 outputPath，完成后如需替换再通知用户。

用户说"压缩图片"含义模糊 → 可能指：缩小尺寸（resize）、降低质量（convert 时调 quality）、或换格式（jpeg→webp）。主动澄清意图。