Plan Video – 视频任务规划

概述

为批量视频处理创建结构化任务清单。提取 URLs → 生成 VideoIds → 创建 todolist.md 追踪文件。

使用时机

• 用户提供视频 URLs 需要批量处理
• 在下载/处理前需要规划任务结构

工作流程

1. 提取视频 URLs

从用户输入（消息/文件）中提取所有视频链接。

from scripts.extract_video_id import extract_urls
urls = extract_urls(user_input_text)

支持平台：小红书、抖音、TikTok、B站、YouTube、快手等

2. 提取 VideoId

为每个 URL 提取唯一标识符。

from scripts.extract_video_id import extract_video_id
video_id = extract_video_id(url)
# 'http://xhslink.com/o/6VbNVltFQRX' → '6VbNVltFQRX'

3. 生成 todolist.md

在输出目录创建任务清单，列出所有待生成文件。

格式：

# Video Processing Tasks

## {VideoId} ({原始短链接URL})

- [ ] orgin/{VideoId}/{VideoId}.json          # 元数据，通过 skill `parse-video` 获得
- [ ] orgin/{VideoId}/{VideoId}.mp4           # 视频，通过 skill `parse-video` 获得
- [ ] orgin/{VideoId}/{VideoId}_cover.jpg     # 封面，通过 skill `rip-video` 获得
- [ ] orgin/{VideoId}/{VideoId}.mp3           # 音频，通过 skill `rip-video` 获得
- [ ] orgin/{VideoId}/{VideoId}.srt           # 字幕，通过 skill `rip-video` 获得

示例：

## 6VbNVltFQRX (http://xhslink.com/o/6VbNVltFQRX)

- [ ] orgin/6VbNVltFQRX/6VbNVltFQRX.json
- [ ] orgin/6VbNVltFQRX/6VbNVltFQRX.mp4
- [ ] orgin/6VbNVltFQRX/6VbNVltFQRX_cover.jpg
- [ ] orgin/6VbNVltFQRX/6VbNVltFQRX.mp3
- [ ] orgin/6VbNVltFQRX/6VbNVltFQRX.srt

4. 输出报告

============================================================
视频处理计划已创建！
============================================================
找到视频: {total} 个
输出目录: {outputDir}/orgin/
任务列表: {outputDir}/todolist.md

可以继续使用 parse-video 和 rip-video 进行下载和处理。
============================================================

错误处理

• 未找到 URLs：提示用户未检测到有效视频链接
• VideoId 提取失败：跳过该 URL，在报告中说明
• 输出目录不存在：自动创建目录结构
• todolist.md 已存在：询问用户是否覆盖或追加

资源文件

scripts/extract_video_id.py

VideoId 提取工具。

函数：

• extract_video_id(url: str) -> str：提取单个 URL 的 VideoId
• extract_urls(text: str) -> list[str]：从文本提取所有视频 URLs

集成说明

此 skill 为后续处理准备基础：

1. parse-video：使用 todolist.md 中的 VideoIds 和 URLs 解析元数据、下载视频
2. rip-video：使用 todolist.md 中的 MP4 路径提取音频和字幕

todolist.md 是整个视频处理流程的中心追踪文档。