feat(pkgs): add public ffmpeg module package 0.0.1 (Form A) + house compat.ffmpeg pipeline

[Sunrisepeak]

概要

登记公开 ffmpeg 模块包 0.0.1(Form A,linux-only),并把 compat.ffmpeg 描述符生成流水线收编进本仓。

[dependencies]
ffmpeg = "0.0.1"

import ffmpeg.av;   // C API 原名原样,仅告别头文件

内容

• pkgs/f/ffmpeg.lua(Form A,同 imgui 形态):指向 mcpplibs/ffmpeg-m v0.0.1 tag tarball;FFmpeg 源码经其 compat.ffmpeg = "8.1.2" 依赖到达消费者(feat(pkg): compat.ffmpeg 8.1.2 — 全源码直编形态(config 快照 + 源列表) #74 的全源码直编形态)。linux-only(compat.ffmpeg 目前仅 linux-x86_64 快照;macOS 阻塞于 [bug] 依赖包的 [target.'cfg(...)'.build].sources 在被消费时不展开(root 构建正常) mcpp-community/mcpp#229)。
• CN 镜像:gitcode mcpp-res/ffmpeg release v0.0.1,资产与 GLOBAL tarball 逐字节一致(sha256 e47dc968…49fb 双端核验)。
• tests/smoke_ffmpeg_module.sh + ffmpeg-module job:沿用 imgui-module 例外通道(默认命名空间包暂不能做 workspace 成员),重播默认 index 后以真实消费者姿态 build+run;smoke 内先 mcpp index update(nasm 自举,mcpp#232 规避,置于重播之前防覆盖)。非 Linux 直接 SKIP。
• tools/compat-ffmpeg/:fetch_upstream.sh / gen_config.sh / gen_descriptor.py 自 ffmpeg-m 迁入,生成器与其生成的描述符同仓。迁移回归:重跑流水线,pkgs/c/compat.ffmpeg.lua 除 2 行 regenerate 指向注释外逐字节复现(本次一并更新该注释)。
• README 两处登记 + 设计文档 .agents/docs/2026-07-18-add-ffmpeg-module-plan.md(含 FFmpeg 版本升级 SOP)。

本地验证

• lint(语法/必填字段/无前导 v/镜像表)+ mcpp xpkg parse ✓
• tests/smoke_ffmpeg_module.sh(mcpp 0.0.96,真实已发布 tarball):下载 → Form A 查找 → compat.ffmpeg 直编 → import ffmpeg.av; 运行 ✓(libavutil 60.26,4 解码器,358 demuxers)

备注

• tools/* 路径变更会按 selector 规则触发全量 workspace run——对描述符再生成正合适。
• ffmpeg-m 侧已精简为纯模块层并发布 v0.0.1(feat: FFmpeg n8.1.2 as C++ modules — full-feature source build via mcpp (v0.0.1) ffmpeg-m#1,CI 绿)。