音视频信息探测 · 时长分辨率与转码命令【律令·本地零联网】

本地媒体探测：纯 Python 读文件头解析 MP4/MOV/MP3/WAV/FLAC 的视频时长、音频信息、分辨率与码率；转码剪辑只生成 ffmpeg 命令不代跑。

这个技能做什么

本地运行，零网络、免 API Key、数据不出电脑。 四项诚实承诺：① 算不出就说算不出，绝不编造数字；② 高危动作强制人工确认；③ 幂等断点，绝不重复副作用；④ 全程留痕可审计。

音视频信息探测与 ffmpeg 命令生成

子命令（全部实测通过）

probe — 读取媒体信息

MP4（真实输出，构造样本 1920x1080 avc1 + mp4a，时长 30s）：

media_tool.py probe 宣传片.mp4

文件: t.mp4 (574 B)
容器: MP4/MOV / brand=isom
时长: 00:30.00（moov/mvhd 精确值）
轨道: 视频 1920x1080 [avc1]
轨道: 音频 [mp4a]

WAV（真实输出，1 秒 44.1kHz 立体声 16bit）：

文件: t.wav (172.3 KB)
容器: WAV
时长: 00:01.00（data 块 / 字节率精确值）
采样率: 44100 Hz
声道: 2
位深: 16

MP3（真实输出，含 Xing 帧）：

文件: t.mp3 (448 B)
容器: MP3
时长: 00:26.12（Xing/Info 帧精确值）
采样率: 44100 Hz
声道: 2
码率: 128 kbps

不认识的格式（真实输出，如实说算不出）：

文件: dl.csv (112 B)
容器: 未知
时长: 算不出 —— 不识别的格式（本工具只认 MP4/MOV/MP3/WAV/FLAC 的文件头）

时长来源标注：MP4 走 moov/mvhd（精确）、MP3 有 Xing/Info 帧（精确）、MP3 无 Xing 走体积估算（会标注"VBR 会有偏差"）——绝不把估算值说成精确值。--json 输出结构化结果。

which — 检测 ffmpeg

media_tool.py which

真实输出（本机未装时）：

ffmpeg  : 未找到
ffprobe : 未找到

本机没有 ffmpeg。本工具不会代替你下载安装（零联网承诺）。
安装后再回来；所有需要转码/剪辑的动作都依赖它。

只在 PATH 里找文件，不启动任何进程。

plan — 生成 ffmpeg 命令

media_tool.py plan convert 宣传片.mp4
media_tool.py plan audio  宣传片.mp4            # 抽音轨 -> mp3
media_tool.py plan trim   宣传片.mp4 --start 00:00:10 --end 00:00:25
media_tool.py plan shot   宣传片.mp4 --start 00:00:03 --out 封面.jpg
media_tool.py plan compress 宣传片.mp4 --scale 720

真实输出（trim 模式）：

模式: trim
命令（复制执行，本工具不代跑）:
  ffmpeg -ss 00:00:10 -to 00:00:25 -i "宣传片.mp4" -c copy "宣传片_out.mp4"

提示: 输出文件 宣传片_out.mp4 若已存在会被 ffmpeg 覆盖，执行前先确认。

--save 命令清单.txt 可把命令追加落盘，方便批量核对后再统一执行。默认后缀：audio → .mp3、shot → .jpg、其余 → _out.mp4。

工作流建议

1. 先 probe 摸清素材（时长/分辨率/有无音轨）→ 再决定转码参数
2. which 确认 ffmpeg → 没有就先装，装完再 plan
3. 批量：对目录里每个文件 plan --save 清单.txt，人工过一遍命令后统一跑
4. 用户问"能不能直接帮我转" → 如实说明本包不代跑，给出命令 + 执行风险提示

自检清单

• 没有启动任何外部进程
• 时长来源标了"精确值"还是"估算"
• 不认识的格式如实说算不出

---

本 Skill 采用 BUSL-1.1 许可（源码可见，可自由使用）。

版权所有 © 2026 律令科技（深圳）有限公司（@lexord-technology）。

允许个人及企业内部免费使用、复制、修改，包括内部生产环境。 未经书面许可，不得将本 Skill 或其修改版作为商业服务对外销售、转售或提供托管服务。 各版本发布之日起 4 年后自动转为 Apache License 2.0。详见随包 LICENSE.md。

与相邻技能的关系

标签

音视频信息视频信息音频信息视频时长媒体探测

安装方式

1. 打开 SkillHub 上的技能页，点击安装；
2. 技能文件落在本机技能目录，SKILL.md 全文可在安装前预览；
3. 在你的 Agent 里直接说出使用场景即可触发，例如「视频时长是多少、分辨率多少、音频码率」。

同类技能

常见问题

按真实会被问到的顺序排。每条答案都给得出可核对的依据——触发词、文件名、路径、源码，全部来自技能包里的真实内容，不是宣传话术。