从一个文件开始。
MediaMeta 使用指南。按你现在要完成的任务,找到入口、操作和结果边界。
安装与工具准备
当前测试版本为 0.2.0 / Build 82,尚未开放公开下载。以下安装说明适用于可信来源的测试包。面向搭载 Apple 芯片(M 系列)的 Mac,系统要求为 macOS 14 或更新版本,暂不支持 Intel Mac。最低系统要求不代表已在每个系统版本上完成测试。
打开 DMG,将 MediaMeta.app 拖到 Applications,然后推出磁盘映像。只使用可信来源的构建;如果系统拒绝打开,不要关闭安全保护、移除隔离属性或绕过系统提示。
MediaInfoLib、ffprobe / ffmpeg 与 AI / OCR 模型均随当前测试包提供,无需另外安装 Python 或媒体工具。可在设置查看工具状态;高级用户仍可主动配置可信的外部工具。
工作台与文件整理
左侧是媒体资料库,中间是播放器与常驻分析区,右侧是当前文件的「参数 / 检查 / 播放与分享」。顶层「文件 / 对比 / 批量参数检查」用于切换任务;分栏可拖动调整。
点击「添加文件」或拖入文件、文件夹,支持多选与递归扫描。资料库可搜索、筛选和排序,解析队列可暂停、取消、重试。移除列表条目不删除磁盘源文件。
每个标签页是独立工作区,可新建、双击改名与关闭;模板跨标签页共享。自动保存会话,重启后恢复并重新解析文件。无法访问的文件保留在列表,可重新关联;旧检查记录会提示过期。
多窗口快速查看
从 Finder 或应用内快速查看文件,可同时保留多个独立窗口。每个窗口拥有自己的播放与分析会话,Dock 显示该文件的缩略图、标识与名称;点击预览回到对应窗口。临时查看不会自动加入工作区,明确导入后才进入资料库。
按帧号回到画面
主工作台和快速查看均显示视频帧号,可输入帧号跳转。帧索引读取实际视频样本时间戳,而不是简单用秒数乘以帧率;在索引可用时支持可变帧率、分数帧率和片段偏移。切换文件或关闭窗口会取消不再需要的索引。
音频不显示帧号。时间戳不完整、存在歧义或超出索引上限时,帧号定位不可用,仍可使用时间码与逐帧操作;不要把不可用的帧号解释为文件损坏。
查看参数与原始信息
选中文件后,在「参数」页先读「常用」,再按需切到「全部」。查看容器、视频、音频、字幕等分组,搜索参数或点击字段说明;文件名和原始数据不会被界面翻译替换。
「更多」可查看原始 JSON、使用检查参考或进入其他参数操作。复制 / 导出前确认导出种类,分享前复核文件名、标签与原始字段。
比较参数,或比较内容
在「对比」中添加至少两个本地文件,选择比较基准。按需只看差异、设置容差或忽略字段。编码别名和单位会归一化;轨道配对不明确时手动确认,缺失字段保留为未知。
「检查画面与声音…」回答的是选定内容是否变化,而不是参数是否相同。选择画面或声音、范围与模式,再主动运行;使用随包内置的 FFmpeg,线上文件须先保存到本地。
decoded 比较归一化解码输出;encoded 适合观察仅换容器或索引时的编码内容。结果只针对已检查范围、轨道与模式,不自动对齐不同剪辑,也不评价画质、听感或音画同步。
参考模板与批量参数检查
在已解析参考视频的参数页「更多」中选择「用作检查参考…」,生成独立草稿。勾选需要保持一致的字段,复核要求值、误差与轨道匹配,保存后才用于检查。
在「批量参数检查」选择清单,并确认检查当前文件、勾选文件或当前标签页。先看不符合、需复查与无法判断;符合项按文件折叠,可展开查看。模板可编辑并导入 / 导出,在工作区之间共享。
AI、OCR 与问题时刻
播放器下方切换「AI 识别 / OCR 文字识别 / 标记与波形」。分析与画面放在一起,各自状态保持;在主工作区或 Finder 快速查看中都能继续复核。
用 AI 找到目标出现的画面
- 选择本地视频或图片。视频设置时间范围与采样方式,选择 YOLO26 Nano 或 RF-DETR Nano,再启动分析;模型在本机运行,不需要云端账号。
- 人物、车辆等 COCO 80 类目标以检测框叠在画面上。视频边播边分析,按类别显示命中时间轴;点击时间轴或上一个 / 下一个,回到对应的实际命中帧。
- 筛选需要的类别,调整各类置信度阈值,或绘制矩形 / 多边形 ROI。叠框、时间轴、轨迹列表与统计一起更新;筛选不会重新关联或分配轨迹编号。命中帧、检测框与轨迹数量都不是独立人数。
- 在播放器中复核结果,设定片段起止,按需导出带检测框及可选轨迹编号的画面或视频。导出固定启动时的筛选条件;结果是定位线索,不加入参数清单的通过 / 失败判定。
沿轨迹复核,不把编号当身份
视频分析新增轨迹列表,显示类别、编号、首次 / 最后命中、观测次数与状态。点击轨迹会跳转到当前类别、阈值与 ROI 筛选下的首次实际命中帧;缓存结果保留原有的算法信息和轨迹编号。
新分析使用原生 TrackTrack 适配,不提供算法选择。该适配未包含上游完整流程中的外观重识别、全局运动补偿及轨迹后处理,不能视为完整上游实现或质量优越性证明。轨迹编号只在单次分析内有效,不用于身份识别、独立人数统计或跨视频关联。
用 OCR 定位文字与时间水印
选择文字或时间水印任务,设置范围与区域,再运行识别。文字结果可定位到对应画面;时间水印先确认时钟区域,再提取和检查疑似跳变,查看前后帧并比较画面时钟与视频经过时间。疑似跳变也可能来自剪辑、变速、设备校时或识别错误,不是篡改判定。
用标记与波形保留上下文
记录备注、范围或问题时刻,结合时间轴跳转与复核。可截帧或导出选定片段;波形观察不等于响度、听感或完整音频验收。
技术检查与结果范围
当前文件的「检查」区分别管理技术检查、画面与声音检查及参数清单。技术工具可检查 MP4 索引与分片结构、时间轴和主动解码,显示实际范围、未知与失败,不生成全文件无问题的保证。
时间轴和解码默认使用有限范围;需要全片时主动选择。工具需求和不可判断项保留为文本。检查后再根据证据定位,不把参数符合、解码完成或试播状态混成同一个“通过”。
播放、发送与剪辑建议
「播放与分享」按播放、发送、剪辑组织参数建议。本机试播观察与其他设备或浏览器的参数提示分开;成功识别文件、进度变化或到达结尾,不证明全片声音、流畅度、颜色或兼容性正确。
发送可选择当前、勾选或标签页文件,以及 AirDrop、Wi-Fi、5G / 4G 等方式。时间是可调整假设速度的估算,不是测速;未就绪文件明确排除。剪辑建议需用小片段实际确认画面、声音和同步。
分享前检查与数据流
分享前检查只读取解析器已提供的元数据和轨道结构,例如位置、设备信息、附加或隐藏轨道。它不扫描画面、人脸、声音或文件名,不删除信息,也不生成安全副本。没有发现不等于可以匿名分享。
本地媒体解析、对比、检查、AI 与 OCR 不需要上传媒体;主动启动线上链接检查会向你指定的目标发出网络请求。解析 worker 的进程隔离不是操作系统权限沙盒。
当前 App 使用 Sentry 故障诊断,有效配置下新安装默认开启,保留用户明确关闭的偏好;可以在设置中关闭。诊断开启时可能向外部服务发送事件,不能描述为完全不联网或无遥测。
问题反馈由你主动发送,确认前说明内容、可选联系方式、系统 / 硬件上下文与 US 处理区域。不会自动附加媒体、截图、日志或文件;SDK 接收提交不等于云端确认收到。
选择与导出报告
在检查页选择已有的报告类型:技术检查、画面与声音检查或参数清单。页内与工具栏的复制 / 导出跟随同一选择;未运行、仍在运行或已清除的记录不能伪装成报告。
技术报告保留已运行的诊断证据;内容报告保留范围、轨道、覆盖与有效性;参数清单保留文件、要求、参考名称与实际检查时间。参数与对比报告可按提供的格式导出,部分报告可离线打开。
「复制参数建议」只导出参数建议,不包含分享前检查、实际试播、浏览器检查或发送估算。截图与片段是单独的证据导出,不能拿其中一个报告代替所有检查。
开发者工具与自动化
可复制带版本、单位与原始分数的技术 JSON,导出 AVC 配置或只包含已运行结果的诊断包。faststart 提供生成新文件的命令,不自动修改源媒体;运行前审阅命令。
批量清单可导出 CI 命令、JUnit 和机器检查 JSON,对比可导出机器回归 JSON。需要在 macOS runner 准备可信 CLI 与工具;未知规则不能算通过。
线上链接检查必须主动启动,只对公开 HTTP(S) 地址观察一次有限 Range 响应,不携带保存的登录凭据或跟随重定向。它不认证 CORS、持续网速或播放,也不是防 DNS rebinding 的安全抓取器。离线浏览器检查由目标浏览器选择本地文件,不上传媒体。
语言、外观与快捷操作
App 设置支持跟随系统、简体中文和 English,切换不重置文件、播放、对比或模板草稿。文件名、原始字段、已保存模板和历史结果不自动翻译;重新运行检查可生成新语言的结果。
网站语言与明暗外观独立于 App。右上角切换后保留浏览器偏好、页面章节与查询参数;无 JavaScript 时仍可阅读完整中英文页面,外观跟随系统。
- ⌘O 添加媒体;⌘T 新建标签页;⌘W 关闭标签页;⌘⇧T 重新打开最近关闭的标签页。
- ⌘F 搜索参数;⌘⇧D 对比 / 检查;⌘⇧R 批量参数检查。
- ⌘Z 撤销移除;⌘⌫ 从列表移除所选条目,不删除磁盘文件。