ArtPlayer/refactor/changes/2026-09-12-PKG-DASH-01-contract.md

PKG-DASH-01：发布版与两代 SDK 兼容边界

起点 e0d47ea7，核实工作区干净。取得并校验 npm artplayer-plugin-dash-control 1.1.0 的 真实归档，保存 6 文件指纹、公开 manifest、工作区源码/demo/声明指纹和归一化函数比较。 具体清单见 契约 与 发布基线。

发现同一版本号下：已发布包依赖 dash.js 4.x 方法，当前源码仅 5.x；README 与产物不同， manifest/声明相同。根据已授权兼容目标，03 要同时适配发布版 4.x 调用和当前 5.x 稳定 ID 选择，不删除已存在的 5 项过滤回归。05 同时验证 4.5.2/5.2.1；不扩大成尚未验证的版本承诺。

新增可重跑 dash-contract 校验及两项测试，保护归档、历史源码、文件差异和函数变化。 已有 5 项 DASH Node 测试与这两项基线检查通过。这里只是受控/归档验证，不是 SDK 浏览器验收。 没有更改生产源码、公开声明、README、demo、依赖或构建产物；没有运行整套媒体测试。

SDK 适配、生命周期、UI 清理/高亮、类型和 demo 差异已登记后续负责人。任务 01 的范围是 核对兼容契约，完成不代表这些问题已修复。后续从 PKG-DASH-02 扩展测试开始。 本任务独立本地提交；不推送、不发布。回退仅撤回本次基线/文档和验证脚本，生产行为不变。

最终验证：新增两项与现有五项共 7 项通过；完整 test:baseline 37 项通过；新增脚本定向 lint、风险校验、任务 DAG/文档链接检查通过。本任务没有运行完整 CI 或真实浏览器， 因为没有生产修改；后续实现仍须执行对应完整门槛。当前 217 项：71 done、3 doing、143 todo。