lov-media-verification

name	lov-media-verification
description	使用 ffprobe 验证已下载视频的可读性、时长、分辨率、编码、音轨、字幕和剧集完整性；适用于“检查下载是否完整”、"verify the downloaded media"，输出结构化验收报告。
license	MIT
metadata	{"author":"contributors","version":"0.4.0","tags":["ffprobe","media-validation","subtitle-audit"],"compatibility":"Python 3.9+ and ffprobe from FFmpeg; optional exact-release subtitle handoff.","dependencies":["python","ffprobe"]}

Media Verification

Confirm the local artifact, selected edition, and language coverage before declaring the request complete. A missing Simplified Chinese stream opens a subtitle handoff, while the media artifact retains its own technical verdict.

Triggers

Activate when

• 用户说“检查下载是否完整”“确认是不是导演剪辑版和中英字幕”。
• 下载客户端显示完成，需要验证实际本地文件。
• The user asks to verify the downloaded media or inspect its audio and subtitles.

Do not activate when

• 用户只想搜索候选或测速，尚无完成文件。
• 用户要重新压制、转码、剪辑或翻译字幕。
• The user asks only for a plot summary or release recommendation.

Workflow (MANDATORY)

Step 0: Resolve expected truth

Load the acquisition report, selected candidate, expected edition runtime, requested episode set, and preferred languages. Locate the exact final path; do not scan unrelated user directories broadly.

Step 1: Inspect the container

Run:

python3 "$KIT_DIR/scripts/verify_media.py" \
  --path FINAL_PATH \
  --output VERIFICATION_JSON

Require at least one readable video stream and positive duration. Capture container, resolution, video codec, HDR hints, audio codecs/languages/channels, subtitle codecs and languages, total size, and remaining partial suffixes.

Step 2: Verify edition and completeness

Compare duration with reliable edition runtime using the configured tolerance. For episodes, match the requested season/episode set rather than accepting a folder name. Record conflicts between filename claims and observed duration.

Step 3: Repair subtitle gaps

If preferred subtitle streams are absent, look for synchronized external subtitles matching the exact release or runtime. Store beside the media using player-compatible naming and inspect its declared language. Follow references/subtitle-handoff.md for UTF-8 SRT and timing preservation, then consult lov-subtitle-freedom-skill only for the requested subtitle operation. Do not label unsynchronized text as complete.

Step 4: Issue the verdict

Use passed, passed_with_warnings, or failed. Report exact local path, edition confidence, technical summary, subtitle coverage, size, and any open evidence. A client state of 100% alone is insufficient evidence.

Dependencies

Python 3.9+ and ffprobe. External subtitle repair additionally needs an available subtitle discovery path.

Runtime context (shared)

运行前读取本 Skill 包的 skill.yaml，由宿主提供 skill-runtime/v1 上下文。字段解析顺序为：当前请求、项目上下文、个人 Preferences、品牌 Profile、通用默认值。

• 只使用 Manifest 声明的字段；Profile 保存公开品牌事实，Preferences 保存个人工作偏好。
• required: true 字段缺失时，按 Manifest 的问题配置向用户提出一个聚焦问题；用户明确同意后再保存回答。
• 报错提供可复制的 context_id、字段路径与来源，诊断内容避开秘密、完整私人路径和原始配置。