用途:诊断用户提供的单个媒体文件或URL的播放与推流问题,只读检查,不修改、删除、转码文件,也不推流。
主要能力:先由 scripts/triage.py 做分类与快速探查,再按类别调用对应脚本。VOD文件与TS分片用 scripts/media_analyze.py,检查moov atom位置、编解码兼容性、容器结构、TS完整性(连续计数器、PAT/PMT、188字节对齐)、码率与帧率异常、B帧/GOP、音视频同步;HLS用 scripts/hls_check.py 解析m3u8(master/media)、抽样检查分片可达性、时长一致性与TS结构;直播流用 media_analyze.py --live,检查B帧、RTMP/FLV音频编码(需AAC)、关键帧间隔与延迟因素。
使用方式:先运行 cd $SKILL_DIR && python3 scripts/triage.py "$INPUT",按输出category路由执行相应脚本;必须从triage入口开始,不得直接调用ffprobe/mediainfo下结论;不得安装任何软件;仅探测用户明确给出的目标,不得搜索或列举其他文件;修复命令仅在报告中建议,未经用户新指令不得执行。依赖ffprobe(缺失则输出降级报告)、可选mediainfo、Python 3.8+。
适用场景:视频无法播放、黑屏花屏、moov位置异常、HLS分片损坏、直播延迟卡顿、TS分片分析、编解码兼容性等。
限制:triage置信度低时需结合用户描述;远程URL受网络与签名时效影响;内容级问题(如重复分片)无法自动检测;不调用云API。缺失的收费、价格等信息暂未提供。