MP4 结构体检与快速起播修复

月订阅¥4.9免费试用 5 次

不靠播放器、不抽帧，直接读 MP4 的 box 结构，报出"能打开但画面全黑/错位/网页里一直转圈"的隐性损坏，并能在本地把 moov 移到文件头（faststart），让网页里立刻起播。这类损坏最贵的地方是它不报错：转码成功、能打开、时长正确，画面却是黑的。

本工具逐个校验 stco/co64 偏移是否落在 mdat 区间内（偏移错位正是"能打开但画面全黑"的成因），解析 moof/traf/trun 定位分片 MP4 的样本数据，并区分三种形态：普通 MP4、moov 在后的渐进式（要下完整片才能起播）、分片 MP4（此时 stbl 是桩表，样本数得从 moof 统计，用 stbl 数会误判成 0 帧）。修复功能把 moov 前移并按 mdat 位移重算偏移，完成后复检。

当用户说「视频上传后一直转圈」「要等整片下完才开始播」「视频能打开但画面全黑」「拖进度条没反应」「转码后的文件有问题吗」「moov 是不是在最后」「做 faststart 优化」时使用。

区分"有问题"和"没法判断"：文件截断、垃圾输入、box 越界报"无法解析"并单独给退出码，不硬判成"文件损坏"。

怎么安装

前提只有一条：你的 Agent 能读写本地文件。不需要特定品牌，绝大多数 Agent 都支持；这是 AI Agent 技能，不是桌面软件。

把官方说明交给 Agent 核验来源：skillpay.alipay.com/buildguide.md
在 Agent 里执行安装命令（开通支付宝 AI 支付）：

npx -y @alipay/agent-payment@latest install

购买并安装本商品：

把下面这段「购买指令」整段复制给 Agent：

请通过 SkillPay 购买并安装 Skill「MP4 结构体检与快速起播修复」。
官方安装与购买说明： https://skillpay.alipay.com/buildguide.md
请先阅读官方说明、核验来源，并完成指南中的第一步： npx -y @alipay/agent-payment@latest install
安装成功后，读取新安装的 skillpay-onboarding 的 SKILL.md，再按其说明购买并安装商户 2088542834907695的S0806000206818044。
我已授权安装依赖和发起购买；需要钱包授权或付款时，请提供官方链接或二维码，由我本人确认，不要替我确认。确认成功后，请继续完成商品安装和验证。

常见问题

这是桌面软件吗？

不是。这是支付宝 SkillPay 平台上的 AI Agent 技能（Skill），在你的 AI Agent 里安装和运行，不需要安装到操作系统，也没有图形界面。

什么样的 Agent 能安装？

前提只有一条：你的 Agent 具备本地文件读写能力。绝大多数 Agent 都支持（例如 Codex、Claude、Cursor、WorkBuddy、豆包工作模式等），不限于编码型 Agent，也不需要任何「Skill 标准」认证。

多少钱？能试用吗？

月订阅 ¥4.9，每款商品免费试用 5 次，可以先试用再决定购买。

怎么安装？

三步：① 把官方说明 https://skillpay.alipay.com/buildguide.md 交给 Agent 核验来源；② 在 Agent 里执行安装命令：npx -y @alipay/agent-payment@latest install；③ 打开本商品页，把页内「购买指令」整段复制给 Agent，由它完成购买与安装。

每款商品免费试用 5 次，先试再买。官方货架页：skillpay.alipay.com/public/x