Media Inspector 📺 🎵

本地音视频文件分析工具，可扫描、提取元数据、转录、摘要和导出报告。

支持格式

视频: mp4, mov, mkv, avi, webm, m4v, ts, mpg, mpeg
音频: mp3, wav, m4a, aac, flac, ogg, opus, aiff, wma

快速开始

1. 扫描媒体文件

bash
python scripts/scanmedia.py /path/to/media --out-dir ./mediascan

输出文件：

• - scanresults.json - JSON格式
• scanresults.csv - CSV格式
• scan_results.md - Markdown格式

2. 深度分析

bash
python scripts/analyzemedia.py /path/to/file.mp4 --out-dir ./mediaanalysis

分析内容：

1. 1. 元数据提取（ffprobe）
2. 语音转文字（Whisper，可选）
3. 内容摘要
4. 关键片段提取（带时间戳）
5. 报告导出（JSON/CSV/Markdown）

依赖安装

bash

必需：ffmpeg (包含 ffprobe)

可选：Whisper 语音转文字

或

使用规则

• - ✅ 优先使用转录文本进行分析，不要仅凭文件名猜测
• ⚠️ Whisper 不可用时，明确告知用户并仅返回元数据
• ❌ 不要虚构内容摘要
• 📝 关键片段必须包含时间戳
• 📊 批量分析时，每个文件单独报告

输出示例

扫描报告

Media Scan Report

Summary

• - scanned path: /path/to/media
• files found: 10
• audio files: 3
• video files: 7

Candidates

filename	duration	type	file size
video.mp4	01:30:00	video	500.2 MB
audio.mp3

00:05:30 | audio | 5.2 MB |

分析报告

Media Analysis Report

File

• - path: /path/to/video.mp4
• type: video
• duration: 01:30:00

Transcript

• - available: yes
• whisper used: yes

Summary

Key excerpts

1. 1. [00:01:30 - 00:02:15] 关键片段内容...
2. [00:15:00 - 00:16:30] 另一个关键片段...