test(dash): [PKG-DASH-02] cover released contracts and real menu interactions

refactor/changes/2026-09-12-PKG-DASH-02-tests.md

@@ -0,0 +1,22 @@
+# PKG-DASH-02：DASH 特有行为与错误测试
+
+起点 `3d4c6361`，新增源码/冻结工作区/真实 npm 三格式行为测试和三引擎真实 DOM 交互测试。
+保留原有 5 项稳定 ID 回归，补全音轨、默认参数、排序去重、ABR、原始对象/调用身份、
+同步异常、换 SDK、多实例、空拓扑、销毁后引用与历史高亮问题。
+
+维护入口及范围见 [验证说明](../dash-validation.md)，输入/报告指纹见
+[执行证据](../baselines/dash-validation.json)。本步只建立测试，不改生产源码、公开类型、
+README、demo、构建产物或依赖。测试脚本接入已有 `test:unit` 和 `test:dash-control`。
+生产模块图将在 03/04 随实际拆分交付，不能提前描述尚未实现的结构。
+
+定向 Node 74 项通过。浏览器首轮 24 通过/24 定位失败，trace 证明 SVG 换行使整行精确
+匹配失效；修正为专用文字节点，原有断言不变，最终 48 项通过、无重试/跳过。
+实际 SDK/MPD 解码不在这 48 项证据内，05 仍须验证两代固定 SDK。
+
+完整 CI 670 项通过（619 单元、14 工程、37 基线），包括严格类型、声明漂移和 lint。
+最终任务/风险校验通过，217 项任务为 72 done、3 doing、142 todo。
+本步复现的 DASH-SDK-01、DASH-LIFE-01、DASH-STATE-01
+均保持 open，明确由 03/05 接续。没有以历史缺陷观察替代候选修复断言。
+
+本任务独立本地 commit；回退本提交撤回新增测试、脚本接入和记录，生产行为不变。
+未 push/tag/publish/merge；全项目目标未完成。下一任务 PKG-DASH-03。

refactor/dash-validation.md

@@ -0,0 +1,45 @@
+# DASH Control 验证与维护入口
+
+PKG-DASH-02 保护真实 npm 1.1.0 的既有调用契约，以及重构前工作区的 SDK 5.x 稳定 ID
+修正。版本来源见 [发布契约](baselines/dash-control-contract.md)。本步没有更改生产实现。
+
+## 可重跑的测试
+
+- `yarn test:dash-control`：原有 5 项过滤/稳定 ID 回归和新增 69 项行为测试，共 74 项。
+  该脚本和 `test:unit` 都保留旧测试，完整 CI 自动执行。
+- `yarn test:browser test/browser/dash-control.spec.js --trace on`：48 项，两个核心、两个插件、
+  两类菜单、两种选择、Chromium/Firefox/WebKit。浏览器套件串行运行，避免共享端口和报告覆盖。
+- `yarn ci:check`：工具链、计划、lint、声明漂移、严格类型和 Node/基线测试。
+
+Node helper 分别加载当前源码、固定 Git 提交的旧工作区 UMD、实际 npm main/legacy/module。
+Git 内容以 LF 指纹核对，发布归档与成员以原始字节指纹核对。`ARTPLAYER_TEST_DASH` 可指定
+待测产物，以系统路径分隔符连接；未设置时不会把源码测试冒充三种候选产物验证。
+
+`test/helpers/dash-control.js` 只提供可控 SDK 方法和组件注册表，检查 this、类型参数、
+原始轨道身份、调用顺序、错误身份、ABR 配置保留、换 SDK、多实例和关闭后的引用。
+真实旧实现的缺陷观察保持冻结；03 修复时为候选实现新增正确行为断言，不把历史缺陷当作兼容要求。
+
+浏览器使用真实发布/候选 ArtPlayer DOM、真实发布/候选插件和本地原生 MP4。SDK 方法可控，
+断言真实点击触发的参数及控制栏/设置同步，再通过真实播放按钮验证视频时钟推进、无媒体错误。
+**没有加载 dash.js，没有验证 MPD、ABR 自动切换或自适应流解码。** 这些仍是 05 必须完成的
+固定 dash.js 4.5.2 / 5.2.1 集成验证。`ARTPLAYER_DASH_ARTIFACT` 可替换插件脚本；本次没有使用。
+
+## 首次失败与证据
+
+首次浏览器运行 24 通过、24 失败；全部失败位于设置选项文字定位。trace 中选项确实已渲染，
+整行文本包含图标 SVG 的换行，`^fr$`/`^720p$` 不能匹配。改为当前面板内专用
+`.art-setting-item-left-text` 的精确文本定位；保持原有调用、同步和播放断言，没有增大超时或跳过。
+补充清理前行文本诊断，最终 48 项通过；候选设置选择的截图已人工查看，文字与控制栏一致。
+
+首轮与最终报告、全部结果/trace 目录都保留在本地缓存；输入和证据指纹见
+[本步执行记录](baselines/dash-validation.json)。缓存不入 Git，永久保存的是测试、来源和结果摘要；
+换机器应按上述命令重新取得执行证据，不能声称本地 trace 已上传。
+
+## 下一步缺陷与边界
+
+- DASH-SDK-01：两代旧实现分别在另一代 SDK 方法表上失败。03 通过能力适配恢复旧用法。
+- DASH-LIFE-01：空列表/禁用后 UI 残留，旧回调仍写旧 SDK，销毁后 update 和订阅仍有效。
+- DASH-STATE-01：克隆当前轨道、重复标签、数字零 representation ID 会丢失高亮。
+
+这些受控复现仍是 open，不能以本步绿色测试关闭。03 处理结构、清理与正确当前项，04 完成公开
+类型兼容，05 完成真实 SDK/媒体/组合验证，06 完成包分发验收。物理设备和 npm 发布准入仍待完成。

refactor/plan.md

@@ -4,7 +4,7 @@
 
 基线：`40fcda6a37d0049d42e49c1e64e70d4fd9ba5f7f`。总任务 217 项，范围 22 个包及工作区/示例。
 
-状态：todo 143 / doing 3 / blocked 0 / done 71 / deferred 0。风险 L/M/H 表示兼容风险，不表示工期。
+状态：todo 142 / doing 3 / blocked 0 / done 72 / deferred 0。风险 L/M/H 表示兼容风险，不表示工期。
 
 前置依赖是启动条件；验收是完成条件。任务可以继续拆分，但不能复用或悄悄删除旧 ID。
 
@@ -202,7 +202,7 @@
 | ID | 范围 / 步骤 | 前置依赖 | 交付物 | 验收条件 | 风险 | 状态 |
 | --- | --- | --- | --- | --- | --- | --- |
 | PKG-DASH-01 | artplayer-plugin-dash-control<br>核对包契约与历史用法 | BASE-05 | quality/audio、representation ID/Auto、getName 和 update | 源码/声明/README/demo/发布包差异已登记；公开形状和版本范围冻结 | H | done |
-| PKG-DASH-02 | artplayer-plugin-dash-control<br>建立特有行为与错误测试 | PKG-DASH-01, ENG-03, ENG-05 | 保留已有 5 项稳定 ID 回归，补发布版 SDK 4.x/当前 5.x、音轨/空列表/过滤/换源与关闭引用 | 旧版本行为可重跑，成功/失败/切源/销毁有必要断言 | H | todo |
+| PKG-DASH-02 | artplayer-plugin-dash-control<br>建立特有行为与错误测试 | PKG-DASH-01, ENG-03, ENG-05 | 保留已有 5 项稳定 ID 回归，补发布版 SDK 4.x/当前 5.x、音轨/空列表/过滤/换源与关闭引用 | 旧版本行为可重跑，成功/失败/切源/销毁有必要断言 | H | done |
 | PKG-DASH-03 | artplayer-plugin-dash-control<br>整理内部职责与资源 | PKG-DASH-02, CORE-11, CORE-14 | 能力适配保留 SDK 4.x 与 5.x，稳定 ID 映射、ABR 状态、UI 清理和生命周期职责分离 | 结构变化和缺陷修复分开记录；原 API/事件/资源生命周期通过 | H | todo |
 | PKG-DASH-04 | artplayer-plugin-dash-control<br>迁移自有源码和公开类型 | PKG-DASH-03, ENG-04, ENG-06, CORE-07 | dash.js adapter、selector 和回调类型 | 严格类型检查、旧消费样例通过；声明路径/导出和同步异步兼容 | H | todo |
 | PKG-DASH-05 | artplayer-plugin-dash-control<br>验证新旧核心和组合 | PKG-DASH-04, CORE-22 | 固定 dash.js 4.5.2/5.2.1 与本地 DASH 实际清晰度/音轨、高亮、Auto 和换源组合 | 最终核心与原支持范围核心分别通过；设备/SDK 缺证据不能标完成 | H | todo |
@@ -480,3 +480,4 @@
 - PKG-HLS-04: [记录](changes/2026-09-12-PKG-HLS-04-types.md) [记录](baselines/hls-types-validation.json) [记录](hls-validation.md)
 - PKG-HLS-SDK-01: [记录](changes/2026-09-12-PKG-HLS-SDK-01-integration.md) [记录](baselines/hls-sdk-validation.json) [记录](baselines/hls-sdk-diagnostics.json)
 - PKG-DASH-01: [记录](changes/2026-09-12-PKG-DASH-01-contract.md) [记录](baselines/dash-control-contract.md) [记录](baselines/dash-control-release.json)
+- PKG-DASH-02: [记录](changes/2026-09-12-PKG-DASH-02-tests.md) [记录](dash-validation.md) [记录](baselines/dash-validation.json)

refactor/progress.md

@@ -1,5 +1,18 @@
 # 进度与证据
 
+## 最新完成：DASH-02 行为测试与真实 DOM 交互
+
+保留原有 5 项稳定 ID 回归，新增发布三格式/冻结工作区/候选源码契约测试，定向 74 项通过。
+完整 CI 670 项通过（619 单元、14 工程、37 基线），未修改生产源码、声明、依赖或产物。
+新旧核心/插件、控制栏/设置、质量/音轨三引擎最终 48 项通过。首轮 24 通过/24 失败的报告
+及全部 trace 已保留；失败原因是 SVG 换行使整行精确定位失效，改为专用文本节点，未放宽断言。
+
+浏览器使用真实 DOM 和原生 MP4，SDK 方法受控；不代表 dash.js/MPD/ABR 实际集成通过。
+SDK 两代不兼容、过期 UI/引用、当前项高亮问题已受控复现，仍保持 open，03/05 接续修复验证。
+当前 217 项：72 done、3 doing、142 todo。下一步 DASH-03 开始源码职责和 SDK 适配改造。
+详见 [本次变更](changes/2026-09-12-PKG-DASH-02-tests.md) 与 [验证维护入口](dash-validation.md)。
+本任务独立本地提交，不推送/发布；其他媒体和设备风险、全包发布准入仍未完成。
+
 ## 最新完成：DASH-01 发布版与 SDK 兼容契约
 
 已校验 DASH Control 1.1.0 的实际 npm 归档及 6 个成员。发现发布版使用 dash.js 4.x

refactor/risk-table.md

@@ -135,8 +135,8 @@
 | AUDIO-BUFFER-01 | open / 已复现 | Windows WebKit 原生媒体无法在受限响应下推进至真实缓冲 | PKG-AUDIO-05 |
 | CHAPTER-LAYOUT-01 | resolved / 已复现 | 长章节标题超出窄播放器进度条宽度 | PKG-CHAPTER-05 |
 | CHAPTER-TIMING-01 | open / 已复现 | Windows WebKit 清晰度切换曾在等待窗口内未见 restart，稍后状态恢复 | PKG-CHAPTER-05 |
-| DASH-SDK-01 | open / 源码/产物事实 | npm 发布版 4.x 与工作区仅 5.x 的 SDK 接口不兼容 | PKG-DASH-02, PKG-DASH-03, PKG-DASH-05 |
-| DASH-LIFE-01 | open / 源码/产物事实 | DASH 空拓扑残留 UI，监听和旧选择回调缺乏关闭守卫 | PKG-DASH-02, PKG-DASH-03 |
-| DASH-STATE-01 | open / 源码/产物事实 | DASH 当前项高亮使用真值 ID、音轨身份和标签去重，边界待核实 | PKG-DASH-02, PKG-DASH-03, PKG-DASH-05 |
+| DASH-SDK-01 | open / 已复现 | npm 发布版 4.x 与工作区仅 5.x 的 SDK 接口不兼容 | PKG-DASH-02, PKG-DASH-03, PKG-DASH-05 |
+| DASH-LIFE-01 | open / 已复现 | DASH 空拓扑残留 UI，监听和旧选择回调缺乏关闭守卫 | PKG-DASH-02, PKG-DASH-03 |
+| DASH-STATE-01 | open / 已复现 | DASH 当前项高亮使用真值 ID、音轨身份和标签去重，边界待核实 | PKG-DASH-02, PKG-DASH-03, PKG-DASH-05 |
 | DASH-TYPE-01 | open / 源码/产物事实 | DASH 类型未表达默认工厂参数、SDK 回调对象和现代模块入口 | PKG-DASH-04 |
 | DASH-DEMO-01 | open / 源码/产物事实 | DASH 示例仅新 SDK 且重复安装会累积销毁回调 | PKG-DASH-06 |

refactor/risks.json

@@ -2834,7 +2834,7 @@
     {
       "id": "DASH-SDK-01",
       "title": "npm 发布版 4.x 与工作区仅 5.x 的 SDK 接口不兼容",
-      "confirmation": "source-observed",
+      "confirmation": "reproduced",
       "status": "open",
       "owners": [
         "PKG-DASH-02",
@@ -2846,7 +2846,9 @@
         "refactor/baselines/dash-control-release.json",
         "packages/artplayer-plugin-dash-control/src/index.js",
         "packages/artplayer-plugin-dash-control/types/artplayer-plugin-dash-control.d.ts",
-        "docs/assets/example/dash.control.js"
+        "docs/assets/example/dash.control.js",
+        "test/dash-contract.test.js",
+        "refactor/dash-validation.md"
       ],
       "compatibleResolution": "按方法能力适配两代已存在用法，保留 v5 稳定 ID，不能要求旧消费者改用新 SDK。",
       "closureCriteria": "归档旧用法、v4/v5 受控及实际媒体矩阵通过，清晰度键不混用。"
@@ -2854,7 +2856,7 @@
     {
       "id": "DASH-LIFE-01",
       "title": "DASH 空拓扑残留 UI，监听和旧选择回调缺乏关闭守卫",
-      "confirmation": "source-observed",
+      "confirmation": "reproduced",
       "status": "open",
       "owners": [
         "PKG-DASH-02",
@@ -2865,7 +2867,9 @@
         "refactor/baselines/dash-control-release.json",
         "packages/artplayer-plugin-dash-control/src/index.js",
         "packages/artplayer-plugin-dash-control/types/artplayer-plugin-dash-control.d.ts",
-        "docs/assets/example/dash.control.js"
+        "docs/assets/example/dash.control.js",
+        "test/dash-contract.test.js",
+        "refactor/dash-validation.md"
       ],
       "compatibleResolution": "仅释放插件自有 ready/restart/destroy 订阅和 UI，SDK 仍由调用方拥有；替换后旧回调不写旧实例。",
       "closureCriteria": "空列表、换源/SDK、销毁后引用、安装异常有回归，其他实例与 SDK 不被误释放。"
@@ -2873,7 +2877,7 @@
     {
       "id": "DASH-STATE-01",
       "title": "DASH 当前项高亮使用真值 ID、音轨身份和标签去重，边界待核实",
-      "confirmation": "source-observed",
+      "confirmation": "reproduced",
       "status": "open",
       "owners": [
         "PKG-DASH-02",
@@ -2885,7 +2889,9 @@
         "refactor/baselines/dash-control-release.json",
         "packages/artplayer-plugin-dash-control/src/index.js",
         "packages/artplayer-plugin-dash-control/types/artplayer-plugin-dash-control.d.ts",
-        "docs/assets/example/dash.control.js"
+        "docs/assets/example/dash.control.js",
+        "test/dash-contract.test.js",
+        "refactor/dash-validation.md"
       ],
       "compatibleResolution": "验证零 ID、重复标签和克隆音轨当前项，在保持原展示语义时按实际可选项定位高亮。",
       "closureCriteria": "有受控和真实 SDK 证据说明选中的 representation/track 与 UI 一致。"

refactor/tasks.json

@@ -1992,11 +1992,15 @@
         "ENG-03",
         "ENG-05"
       ],
-      "status": "todo",
+      "status": "done",
       "risk": "H",
       "deliverable": "保留已有 5 项稳定 ID 回归，补发布版 SDK 4.x/当前 5.x、音轨/空列表/过滤/换源与关闭引用",
       "acceptance": "旧版本行为可重跑，成功/失败/切源/销毁有必要断言",
-      "evidence": []
+      "evidence": [
+        "changes/2026-09-12-PKG-DASH-02-tests.md",
+        "dash-validation.md",
+        "baselines/dash-validation.json"
+      ]
     },
     {
       "id": "PKG-DASH-03",