下载视频

视频下载工具

适用/能力

• 下载整段视频（获取素材）：下载视频文件和外挂中文字幕，无字幕则仅下载视频。
• 下载播放列表：批量下载多个视频，支持指定范围或全部。
• 仅下载音频：提取音频并嵌入封面和元数据。
• 为本地视频添加字幕：从本地视频提取音频 → Whisper 转写 → 翻译成中文 → 烧录字幕到视频画面。

强制规则（先读配置再执行）

• 执行任何命令/写入任何文件前，必须先读取本技能目录 config.json，取 output_dir 作为 <输出根>（支持 ~ 展开）。
• 文档中的所有 <输出根>/... 在执行前必须替换为真实绝对路径；禁止把 <输出根> 原样带到命令里执行（否则会写到当前目录，表现为“乱保存”）。
• 若 config.json 缺失、output_dir 为空/相对路径/不可写：立即停止并提示用户在网页面板填写，或用脚本参数 --outdir <绝对路径> 覆盖。
• 默认只写 <输出根>/tmp/ 与 <输出根>/data/。例外：本地视频加字幕流程的最终输出会按下文规则询问保存位置；用户回答“默认/随便”时允许保存到原视频目录。

建议的“输出根解析”固定前置步骤（避免手打长路径导致误写目录）：

# 在本技能目录执行
OUTPUT_ROOT="$(python3 - <<'PY'
import json, os
from pathlib import Path

cfg = json.load(open("config.json", "r", encoding="utf-8"))
out = Path(os.path.expanduser(str(cfg.get("output_dir", ""))).strip())
if not out.is_absolute():
    raise SystemExit("config.json: output_dir 必须是绝对路径或以 ~ 开头")
print(str(out))
PY
)"
mkdir -p "$OUTPUT_ROOT/tmp" "$OUTPUT_ROOT/data"
echo "OUTPUT_ROOT=$OUTPUT_ROOT"

后续所有命令都必须使用 $OUTPUT_ROOT/...，不要在命令里手写/粘贴完整长路径。

通用配置

代理设置（可选）：

• 如需访问 YouTube 等受限网站，所有 yt-dlp 命令添加：--proxy http://127.0.0.1:7890

路径说明：

• 输出根目录：要求显式配置；临时目录 <输出根>/tmp/（下文用 <输出根> 指定的根路径）
• 配置方式：在本技能目录下 config.json 设置 output_dir=<绝对路径>，或命令行 --outdir <绝对路径>（命令行优先）。output_dir 为空/缺失/相对路径时，脚本会强制提示用户输入绝对路径并写回 config.json，不允许默认回落技能目录。

转写引擎（默认走脚本 scripts/transcribe_srt.py，自动下模型、零配置）：

• 默认：MLX Whisper / faster-whisper——首次运行自动下载模型，是烧字幕场景的首选（whisper-cli 没有词级时间戳，字幕会不同步，不要用于烧字幕）。
• 可选备份：whisper-cli（whisper-cpp）——仅纯转文字、或脚本不可用时才用，需自行 brew install whisper-cpp 并把模型下到 ~/.cache/whisper-cpp/：
  • 精确模式：~/.cache/whisper-cpp/ggml-large-v3-turbo.bin（默认模型）
  • 快速模式：~/.cache/whisper-cpp/ggml-medium.bin（用户没有要求不允许使用此模型）

转写模式选择逻辑：

• 精确模式（默认）：ggml-large-v3-turbo.bin，95% 精度
• 快速模式：ggml-medium.bin，90% 精度，触发条件为用户指令中包含"快速"、"快"或"快速模式"关键词

输出路径选择逻辑

默认：保存到 <输出根>/data/（临时 <输出根>/tmp/），不再询问。
用户/工作流指定路径：优先使用指定路径。
本地视频加字幕：默认询问保存位置；“随便/默认”→视频目录，“同名”→覆盖需确认。

• 避免误写到当前目录：所有 -o 示例都包含 <输出根>/...，不要使用裸 data/… 相对路径，否则会写到当前工作目录的 data/。
• 首次未配置/配置无效时：脚本会引导用户手动输入绝对路径并写入 config.json 的 output_dir（需用户确认，不自动填默认）。若已配置有效值则不再提示，如需重新指定请删除/清空 config.json 的 output_dir 后运行。