音频工作包执行清单
状态（2026-10-25）：WP01–WP19 的主仓实现与 CLI 音频命令已落地；原 WP06/WP12/WP20 已获得动画前联合验收的主要 Chromium 实机证据，但原矩阵尚未逐项全数关闭。资源、旁白和 cue 已默认开放；未覆盖的放映联调交由 feature/motion 的 A1/B4 接续，MCP 不在当前交付范围。共 20 个历史工作包，原 M0/M1/M2 出口分别为 WP06、WP12、WP20。
1. 使用方式
每个工作包应对应一个可独立评审的提交或 PR。领取工作时引用 WP 编号，完成后在卡片中回填代码版本、测试命令、结果和未运行项。
- 字段、默认值和运行行为只以统一契约为准。
- 前置表示开始实现所需输入，不表示可以跳过本包自己的测试。
- 状态按“待实施 → 实施中 → 待验收 → 完成”更新。
- 修改 OpenAPI、Runtime Kit manifest、模板包 Schema 或数据库时，由指定工作包维护唯一变更，后续包只消费。
- 单包合入不开放阶段能力；只有出口包完成并满足验收计划后才更新 capability 和用户文档。
- 实际测试选择遵循
dev-start-test，不在每张卡复制服务命令。
2. M0：音频资源基线
| 工作包 | 主责 | 前置 |
|---|---|---|
| WP01 冻结音频契约与共享样例 | Backend / 跨模块契约 | 无 |
| WP02 Backend 音频资源类型与读取链路 | Backend | WP01 |
| WP03 Editor 音频资源管理与试听 | Editor | WP01、WP02 |
WP04 Runtime Kit AssetAudio.v1 | Runtime Kit | WP01、WP02 |
| WP05 引用、artifact、构建与包往返 | Backend / Runtime 构建 | WP02、WP04 |
| WP06 M0 音频资源联调门槛 | 跨模块验证 / 发布 | WP03、WP04、WP05 |
M0 只开放手动内容音频。purpose="narration" 可以进入类型/manifest，但 capability 在 M1 出口前不得宣称可自动播放。
3. M1：页面旁白
| 工作包 | 主责 | 前置 |
|---|---|---|
| WP07 媒体用途与活动页会话 | Runtime | WP04、WP06 |
| WP08 旁白开始与页面生命周期 | Runtime | WP07 |
WP09 media_end 聚合与错误恢复 | Runtime | WP07、WP08 |
| WP10 静音、双窗口与静态隔离 | Runtime / Renderer / 导出 | WP08、WP09 |
| WP11 Editor 与 AI 旁白创作约束 | Editor / Backend AI | WP08、WP09 |
| WP12 M1 页面旁白联调门槛 | 跨模块验证 / 发布 | WP10、WP11 |
4. M2：切页与点击音效
| 工作包 | 主责 | 前置 |
|---|---|---|
| WP13 项目音频设置与 cue 绑定存储 | Backend | WP01、WP06 |
| WP14 cue 快照、构建、模板与引用 | Backend / Runtime 构建 | WP05、WP13 |
WP15 Runtime AudioCueEngine | Runtime shell | WP14 |
| WP16 切页开始事件与方向 cue | Runtime transitions | WP15 |
WP17 useAudioCue.v1 与点击 cue | Runtime Kit / Runtime shell | WP15 |
| WP18 Editor 项目音频设置 | Editor | WP13、WP14 |
| WP19 External API 与 CLI | Backend / CLI | WP13、WP14 |
| WP20 M2 音效联调与发布门槛 | 跨模块验证 / 发布 | WP16、WP17、WP18、WP19 |
5. 依赖主链
text
WP01 → WP02 ─┬→ WP03 ───────────────┐
├→ WP04 → WP05 ───────┤→ WP06
│ │
└──────────────────────┘
WP06 → WP07 → WP08 → WP09 → WP10 ─┐
└→ WP11 ────┴→ WP12
WP06 → WP13 → WP14 → WP15 ─┬→ WP16 ─┐
└→ WP17 ─┤
WP14 ───────→ WP18 ├→ WP20
WP14 ───────→ WP19 ┘WP03 与 WP04 可并行；WP10 与 WP11 在 WP09 后可并行；WP16–WP19 可在共同输入完成后并行。热点文件冲突仍应按实施计划中的顺序协调。
6. 完成定义
每包至少满足：
- 实现和测试未超出卡片提交边界。
- 新增源文件有文件功能说明，函数有中文职责/约束注释。
- 修改契约时生成物、正反例和防漂移测试同步。
- UI 改动符合
DESIGN.md，媒体行为有真实浏览器证据。 - 不覆盖用户未提交改动，不提交缓存、依赖、构建产物或无授权音频。
- 卡片状态、证据和阶段限制已回填。