media-ops: Скилл обработки медиа и скачивания

--- name: media-ops description: 媒体处理与下载——图片编辑（缩放、裁剪、旋转、格式转换、压缩）、视频格式转换、音频提取、视频下载。当用户提到视频下载、图片处理、调整大小、裁剪、旋转、格式转换、提取音频、视频转码、"下载这个视频"、"把图片转成 PNG"、"压缩图片"、"提取背景音乐"、"这个视频转 MP4"、resize、crop、blur、convert、"图片太大了"、"转成 webp"、"视频怎么这么大" 时激活。注意：AI 图片/视频生成已迁移到画布 v3，本 skill 仅处理已有文件和网络视频下载。 --- # 媒体处理与下载 本 skill 覆盖 server agent 直接提供的三个媒体工具。AI 图片/视频**生成**已迁移到画布 v3 流程——本 skill 负责的是**已有文件的处理与网络视频下载**。 ## 决策树 ```text 用户需要媒体操作 ├── 生成全新图片/视频？ │ └── 引导到画布 v3（server agent 不直接生成） ├── 处理已有文件？ │ ├── 图片（缩放/裁剪/旋转/格式转换/模糊/锐化/灰度） → image-process │ ├── 视频格式转换 / 调整分辨率 → video-convert (action: convert) │ └── 从视频提取音频 → video-convert (action: extract-audio) ├── 查看文件信息？ │ ├── 图片元数据（宽高/格式/DPI） → image-process (action: get-info) │ └── 视频元数据（时长/分辨率/编码） → video-convert (action: get-info) └── 下载网络视频？ └── video-download ``` ## image-process — 图片处理 基于 sharp，对已有图片进行变换。 | 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`）。直接覆盖原文件有风险——用户可能需要原图作对比或回退。用户明确要求覆盖时除外。 ## video-convert — 视频/音频转换 基于 FFmpeg，处理已有文件的格式转换和音频提取。 | action | 用途 | 关键参数 | |--------|------|---------| | `get-info` | 读取时长、分辨率、编解码器、流信息 | 仅 filePath | | `convert` | 视频格式转换 | `format`、`resolution` | | `extract-audio` | 从视频提取音频 | `audioFormat`（mp3/wav/aac/flac） | **格式选择建议**： - 通用兼容：MP4（H.264）——几乎所有设备都能播放 - 高质量压缩：WebM（VP9）——文件更小但兼容性略差 - 音频提取：MP3（通用）、FLAC（无损） **大文件注意**：视频转码耗时与文件大小成正比。超过 500MB 的文件转换可能需要较长时间，提前告知用户预期等待。 ## video-download — 视频下载 通过 yt-dlp 下载公开视频 URL。 **适用**：用户给出公开视频链接，需要下载到本地继续处理（编辑、提取音频、转码）。 **不适用**： - 生成新视频 → 画布 v3 - 转换本地已有视频 → `video-convert` - 私有/需登录的视频 → 告知用户 yt-dlp 只能下载公开内容 **下载后常见后续**：下载完成后用户通常需要进一步处理——提取音频、转换格式、裁剪。主动询问是否需要后续操作，而不是等用户开口。 ## 常见工作流 ### 视频下载 → 提取音频 ``` video-download(url: "...") → 拿到 filePath video-convert(action: "extract-audio", filePath: "...", outputPath: "output.mp3") ``` ### 批量图片格式转换 对每张图片调用 `image-process(action: "convert", format: "webp")`。WebP 格式在保持画质的同时文件体积约为 JPEG 的 70%，适合 Web 使用场景。 ### 画布生成后继续处理 画布 v3 生成的图片如需后续裁剪、缩放、格式转换，用 `image-process` 处理。 ## 常见错误 **格式不支持** → 检查文件扩展名和实际编码是否匹配。用户可能把 `.mp4` 文件命名为 `.avi`，先用 `get-info` 确认真实格式。 **输出文件与输入同路径** → 部分操作不支持原地覆盖。用不同的 outputPath，完成后如需替换再通知用户。 **用户说"压缩图片"含义模糊** → 可能指：缩小尺寸（resize）、降低质量（convert 时调 quality）、或换格式（jpeg→webp）。主动澄清意图。