Files
ArtPlayer/refactor/plan.md
T

139 KiB
Raw Blame History

完整重构执行计划表

由 tasks.json 生成。请修改数据后运行 node refactor/scripts/plan.mjs --write,不要手改本表。

基线:40fcda6a37d0049d42e49c1e64e70d4fd9ba5f7f。总任务 267 项,范围 22 个包及工作区/示例。

状态:todo 43 / doing 21 / blocked 0 / done 203 / deferred 0。风险 L/M/H 表示兼容风险,不表示工期。

前置依赖是启动条件;验收是完成条件。任务可以继续拆分,但不能复用或悄悄删除旧 ID。

每项实施任务同时适用全项目质量要求:清晰拆分职责和依赖,主动改善不合理设计,以有效测试证明旧接口兼容,并同步维护后续 AI 可接续的包内文档。

包覆盖索引

包 基线版本 任务
artplayer 5.4.1 CORE-01, CORE-02, CORE-03, CORE-04, CORE-05, CORE-06, CORE-07, CORE-08, CORE-09, CORE-10, CORE-11, CORE-12, CORE-13, CORE-14, CORE-15, CORE-16, CORE-17, CORE-18, CORE-19, CORE-20, CORE-21, CORE-23, CORE-22, CORE-24, SITE-BUILD-01, CORE-25, ENG-12, CORE-SUBTITLE-OFFSET-01, PKG-MULTI-SUB-09, ENG-LINT-02
artplayer-plugin-ads 2.1.0 PKG-ADS-01, PKG-ADS-02, PKG-ADS-03, PKG-ADS-04, PKG-ADS-05, PKG-ADS-06
artplayer-plugin-ambilight 1.1.0 PKG-AMBILIGHT-01, PKG-AMBILIGHT-02, PKG-AMBILIGHT-03, PKG-AMBILIGHT-04, PKG-AMBILIGHT-PROXY-01, PKG-AMBILIGHT-05, PKG-AMBILIGHT-06, PKG-FACTORY-01
artplayer-plugin-asr 2.1.0 PKG-ASR-01, PKG-ASR-02, PKG-ASR-03, PKG-ASR-04, PKG-ASR-05, PKG-ASR-06, PKG-ASR-07, PKG-ASR-08, PKG-ASR-09, PKG-ASR-10
artplayer-plugin-audio-track 1.1.0 PKG-AUDIO-01, PKG-AUDIO-02, PKG-AUDIO-03, PKG-AUDIO-04, PKG-AUDIO-05, PKG-AUDIO-06
artplayer-plugin-auto-thumbnail 1.1.0 PKG-AUTO-THUMB-01, PKG-AUTO-THUMB-02, PKG-AUTO-THUMB-03, PKG-AUTO-THUMB-04, PKG-AUTO-THUMB-05, PKG-AUTO-THUMB-06, PKG-AUTO-THUMB-07, PKG-AUTO-THUMB-08, PKG-AUTO-THUMB-09, PKG-AUTO-THUMB-10, PKG-AUTO-THUMB-11, PKG-AUTO-THUMB-12
artplayer-plugin-chapter 1.1.0 PILOT-01, PKG-CHAPTER-01, PKG-CHAPTER-02, PKG-CHAPTER-03, PKG-CHAPTER-04, PKG-CHAPTER-05, PKG-CHAPTER-06, PKG-CHAPTER-HOVER-01
artplayer-plugin-chromecast 1.1.0 PKG-CAST-01, PKG-CAST-02, PKG-CAST-03, PKG-CAST-04, PKG-CAST-05, PKG-CAST-06
artplayer-plugin-danmuku 5.3.0 PKG-DANMUKU-01, PKG-DANMUKU-02, PKG-DANMUKU-03, PKG-DANMUKU-04, PKG-DANMUKU-05, PKG-DANMUKU-06, PKG-DANMUKU-07, PKG-DANMUKU-08, PKG-DANMUKU-09, PKG-DANMUKU-10, PKG-DANMUKU-11, PKG-DANMUKU-12, PKG-DANMUKU-MASK-LOAD-01
artplayer-plugin-danmuku-mask 1.1.0 PKG-MASK-01, PKG-MASK-02, PKG-MASK-03, PKG-MASK-04, PKG-MASK-05, PKG-MASK-06, ENG-LINT-01, PKG-DANMUKU-MASK-LOAD-01
artplayer-plugin-dash-control 1.1.0 PKG-DASH-01, PKG-DASH-02, PKG-DASH-03, PKG-DASH-04, PKG-DASH-SEEK-01, PKG-DASH-MENU-01, PKG-DASH-05, PKG-DASH-06
artplayer-plugin-document-pip 1.1.0 PKG-DPIP-01, PKG-DPIP-02, PKG-DPIP-03, PKG-DPIP-04, PKG-DPIP-05, PKG-DPIP-06
artplayer-plugin-hls-control 1.1.0 PKG-HLS-01, PKG-HLS-02, PKG-HLS-03, PKG-HLS-04, PKG-HLS-SDK-01, PKG-HLS-05, PKG-HLS-06, PKG-HLS-PACK-01
artplayer-plugin-jassub 1.1.0 PKG-JASSUB-01, PKG-JASSUB-02, PKG-JASSUB-03, PKG-JASSUB-04, PKG-JASSUB-05, PKG-JASSUB-06, PKG-JASSUB-07, PKG-JASSUB-08, PKG-JASSUB-09, PKG-JASSUB-10
artplayer-plugin-multiple-subtitles 1.2.0 PKG-MULTI-SUB-01, PKG-MULTI-SUB-02, PKG-MULTI-SUB-03, PKG-MULTI-SUB-04, PKG-MULTI-SUB-07, PKG-MULTI-SUB-08, PKG-MULTI-SUB-05, PKG-MULTI-SUB-06, PKG-MULTI-SUB-09, PKG-MULTI-SUB-10, PKG-MULTI-SUB-11
artplayer-plugin-vast 1.2.0 PKG-VAST-01, PKG-VAST-02, PKG-VAST-03, PKG-VAST-04, PKG-VAST-05, PKG-VAST-06, PKG-VAST-07, ENG-LINT-02
artplayer-plugin-vtt-thumbnail 1.1.0 PKG-VTT-THUMB-01, PKG-VTT-THUMB-02, PKG-VTT-THUMB-03, PKG-VTT-THUMB-04, PKG-VTT-THUMB-05, PKG-VTT-THUMB-06
artplayer-proxy-canvas 1.1.0 PKG-AMBILIGHT-PROXY-01, PKG-CANVAS-01, PKG-CANVAS-02, PKG-CANVAS-03, PKG-CANVAS-04, PKG-CANVAS-05, PKG-CANVAS-06, PKG-FACTORY-01, PKG-CANVAS-SUBTITLE-01
artplayer-proxy-mediabunny 1.2.0 PKG-MB-01, PKG-MB-02, PKG-MB-03, PKG-MB-04, PKG-MB-05, PKG-MB-06, PKG-MB-07, PKG-MB-08, PKG-MB-09, PKG-MB-10
artplayer-tool-iframe 1.1.0 PKG-IFRAME-01, PKG-IFRAME-02, PKG-IFRAME-03, PKG-IFRAME-04, PKG-IFRAME-05, PKG-IFRAME-06
artplayer-tool-thumbnail 4.4.0 PKG-TOOL-THUMB-01, PKG-TOOL-THUMB-02, PKG-TOOL-THUMB-03, PKG-TOOL-THUMB-04, PKG-TOOL-THUMB-05, PKG-TOOL-THUMB-06
artplayer-vitepress 1.1.0 SITE-01, SITE-SMOKE-01, SITE-02, SITE-LOAD-01, SITE-AI-DOCS-01, SITE-BUILD-01, SITE-03, SITE-04, SITE-05, SITE-06, SITE-07, SITE-VCONSOLE-01, ENG-LINT-02, SITE-CONSOLE-01

0 规划

ID 范围 / 步骤 前置依赖 交付物 验收条件 风险 状态
DOC-01 workspace
创建兼容重构分支
- 独立本地分支和起点 SHA 分支由干净 master 创建,起点可追溯 L done
DOC-02 workspace
清点全部包与消费者
DOC-01 package-inventory.json 22 包及 React/Vue/demo 有明确清单 L done
DOC-03 workspace
建立计划、契约、决策和协作记录
DOC-02 refactor 文档集与任务数据 每包有独立步骤、依赖、交付物和验收条件 L done
DOC-04 workspace
验证文档完整性与生成表
DOC-03 计划生成校验工具、AGENTS 入口 依赖无环、包覆盖、生成同步、文档链接通过 L done
DOC-05 workspace
建立每任务提交规则并提交文档基线
DOC-04 根指令、质量要求、AI 流程、变更记录与初始文档提交 文档与计划检查通过,独立 DOC-05 commit 保存本次交付;提交后核实 SHA 和工作区 L done
DOC-06 workspace
记录自主安装依赖与添加脚本授权
DOC-05 根指令、工具链规范、AI 流程、决策及变更记录 授权、依赖归属、脚本文档和兼容验证要求明确,计划校验通过并独立提交 DOC-06 L done
DOC-07 workspace
复审并优化计划顺序和执行门槛
DOC-06 依赖优化、执行门槛规范、测试/发布补充和审查记录 依赖与覆盖校验、专项执行顺序断言通过;任务范围完整并独立提交 L done
DOC-08 workspace
记录 Chrome 验证及多轮 npm 发布复盘
DOC-07 浏览器分工、三轮复盘规范、发布依赖与接续文档 计划和发布依赖检查通过;独立提交 DOC-08,连接可用不冒充测试通过 L done
DOC-09 workspace
记录 docs HTML 与在线编辑器测试入口
DOC-08 页面/加载方式、状态隔离、行为断言与既有任务映射 源码清点和计划检查通过,独立提交 DOC-09;不把页面存在当作测试通过 L done
DOC-10 workspace
记录 GitHub CI/CD 增强范围与验收
DOC-09 CI/CD 规范、四项实施任务与发布依赖 现有 workflow 核对、计划检查通过并独立提交;不冒充远端执行完成 L done
DOC-11 workspace
记录全部包各自升级一个大版本
DOC-10 22 包目标版本清单、决策和发布/CI/复盘规则同步 版本表与 manifest 对照、计划检查通过并独立提交;不修改旧 API 兼容要求 L done
DOC-12 workspace
复审开发启动、验收覆盖及发布依赖
DOC-11 语义依赖修正、版本实施任务、基线/分发分类及契约映射要求、校验器保护 原范围状态保持,计划检查和故障负例通过,独立提交 DOC-12 M done
DOC-13 workspace
记录并验证内置浏览器回退规则
DOC-08 根指令、复盘和夹具文档中的浏览器回退及实际环境证据 内置浏览器打开真实页面,报告基础检查结果及未覆盖项;独立提交 L done

1 基线

ID 范围 / 步骤 前置依赖 交付物 验收条件 风险 状态
BASE-01 workspace
固定核心与试点的最小发布基线
DOC-07 核心及 chapter 的 npm tarball/integrity、源码 SHA、已知支持窗口;其他包标待核对 核心/试点来源可重跑;不虚构全生态已验证,各包 01 步负责补齐自身历史发布基线 H done
BASE-HARNESS-01 workspace
建立最小发布包浏览器采集夹具与服务
BASE-01 固定 tarball 静态服务、本地媒体 Range、公开 API 采集页面及受控报告路径 HTTP 精确内容/范围和路由隔离测试、夹具语法通过;浏览器采集仍由 BASE-02 负责 M done
BASE-02 workspace
捕获公共 API 和属性描述符
BASE-01, BASE-HARNESS-01 核心与试点的构造/默认值/静态和实例 API 快照,其余包由 01/02 步补齐;登记契约/版本/固定测试 ID/命令/报告与负责任务 真实发布包反射与旧用户调用可重跑,未验证项明确 H done
BASE-03 workspace
捕获事件、异步和生命周期
BASE-02 ready/restart/destroy、Promise、切源/插件事件 trace;登记契约/版本/固定测试 ID/命令/报告与负责任务 成功、失败、重入和多实例有断言,历史缺陷有标记;使用已发布包和最小可重跑探针启动,不等待后续 ENG 服务 H done
BASE-04 workspace
捕获 DOM、CSS 和官方 demo
BASE-02 核心模板/类名/变量、键盘/焦点/可访问名称基线及全 demo 路径映射;docs-browser-testing.md 中 HTML/编辑器的脚本来源与存储状态;登记契约/版本/固定测试 ID/命令/报告与负责任务 核心/试点用户样式和输入用法已记录,其他 demo 运行状态与未知项明确;使用已发布包和最小可重跑探针启动,不等待后续 ENG 服务 M done
BASE-05 workspace
捕获包入口、资源和类型消费
BASE-01 全包 manifest/资源路径清单;核心/试点的 UMD/AMD/ESM/CJS/legacy/i18n 和类型消费者基线;登记契约/版本/固定测试 ID/命令/报告与负责任务;区分库/npm 与站点实际分发类别,SSR import/模板/非浏览器构造错误分别捕获 核心/试点隔离消费可运行,其他包由各自契约任务验证,thumbnail tool 差异已登记 H done
BASE-06 workspace
记录性能与资源基线
BASE-03, BASE-04 固定媒体/设备测量、包体积、反复装卸资源报告 多次采样可重跑,指标和审查阈值确定,不承诺未经测量的收益;使用已发布包和最小可重跑探针启动,不等待后续 ENG 服务 M done
BASE-07 workspace
建立差异和风险台账
BASE-03, BASE-05 销毁/切源/类型差异、vendored 许可和外部 SDK 清单 已确认与待复现分开,每项有负责任务及兼容处理路线;纳入 BASE-TYPE-01/02/03/04 和 BASE-DIST-01 的发布/声明/工作区证据;纳入 BASE-PERF-01 销毁后 resize/notice 延迟工作 H done
BASE-08 workspace
建立消费者与真实环境验证矩阵
BASE-01, BASE-05 每包版本/浏览器/codec/SDK/设备/样本、证据和负责验证任务的矩阵 格式兼容与运行能力分开,未知/缺环境不算通过,明确哪些检查阻止哪些批次发布 H done

2 工程保障

ID 范围 / 步骤 前置依赖 交付物 验收条件 风险 状态
ENG-01 workspace
固定 Node、包管理器与依赖
BASE-01 版本 pin、唯一锁文件、安装说明 干净环境可复现,最低 Node 与构建依赖一致,未夹带全量升级 M done
ENG-PM-01 workspace
按用户选择切换固定 Yarn 包管理器
ENG-01 Yarn 固定版本、唯一 yarn.lock、工具检查与安装维护文档 干净冻结安装、Node 测试和全部构建通过;记录解析差异和依赖用途,独立提交 M done
ENG-02 workspace
拆分只读检查并建立 PR CI
ENG-01, ENG-PM-01 lint/lint:fix、PR 与主线检查、独立部署任务;遵循 github-ci-cd.md,PR/重构分支触发、最小权限及 workflow 静态检查 仓库内检查可执行且不改源码、不发布;required checks 的外部设置状态列入发布台账,不阻塞本地框架建设 M done
ENG-03 workspace
建立公共行为与单元测试入口
ENG-02, BASE-03 保留现有 node:test,测试目录/夹具/统一入口 已有 19 项回归保留,旧版与候选可用同一夹具运行 M done
ENG-04 workspace
建立类型测试基础
ENG-02, BASE-05 根与分包 tsconfig、显式 TS 依赖、正反例测试 核心/试点与迁移模块严格检查,未迁移第三方/包历史问题独立台账;明确最低/当前 TS 和各环境类型;复用 BASE-05 的四种消费模式,不以 skipLibCheck 掩盖 BASE-TYPE-01/03 M done
ENG-05 workspace
建立真实浏览器测试服务
ENG-03, BASE-04, BASE-08 Playwright projects、本地 Range/失败媒体服务;复用 docs 页面/样本的状态隔离、错误采集与候选资源映射 Chromium/Firefox/WebKit 的基础播放 smoke 和报告可执行;以媒体状态断言判定通过,区分轻量用例与真实编辑器交互 M done
ENG-06 workspace
支持按包非交互与 JS/TS 构建
ENG-02, BASE-05 build/dev 入口解析、指定包参数、原交互保留 三种产物、Less/SVG/worker 和本地 8082 demo 正常;保持 BASE-05 的 AMD 同时写入全局行为及 i18n/legacy 入口 H done
ENG-07 workspace
建立 tarball 消费与产物检查
ENG-04, ENG-06 隔离 npm 消费 fixtures、API/声明/入口差分 不借 workspace 源码通过,能识别缺文件与默认导出变化 H done
ENG-08 workspace
增加覆盖率、资源与性能报告
ENG-03, ENG-05, BASE-06 覆盖率基线、资源清理断言、性能报告与阈值 关键生命周期分支有门槛,报告不靠无意义断言堆数量;将 BASE-06 的同环境多组配对、计时/压缩审查阈值与资源异常分开接入候选,不把历史现象冻结成正常要求 M done
ENG-AUDIT-01 workspace
核对每任务完成提交的真实Git历史
ENG-07, DOC-04 独立完成提交、初始DOC例外、父分支合并和证据共提交审计;CI完整历史与报告 真实仓库及隔离Git反例通过,done任务不允许缺独立commit,固定DOC-01~04例外可追溯;提交后验证自身 M done
ENG-IMPACT-01 workspace
建立全包依赖与共享变更影响映射
ENG-07, DOC-04 核心/构建/类型/锁文件到受影响包和必需生态检查的映射及CI接入 核心变化触发必需生态检查;新增包、未知共享文件或失配依赖不能静默漏检;解释受影响路径和测试命令 M done
ENG-COVERAGE-01 workspace
建立公开契约与版本测试证据覆盖索引
BASE-08, CORE-22, ENG-07 契约-包-支持版本-固定测试ID-命令-候选/报告-责任任务索引和文档检查 计划、已执行和缺证据状态分开,所有公开契约都有验证归属;无效路径、版本依据或报告对应不明确会被识别 M done
ENG-09 workspace
建立全包依赖影响和文档检查
ENG-07, DOC-04, ENG-AUDIT-01, ENG-IMPACT-01, ENG-COVERAGE-01 共享核心/构建影响映射、文档及每任务完成提交的 Git 审计接入;契约-支持版本-测试 ID-命令-候选/报告-任务的覆盖索引 核心变化触发必需生态检查;原有 DOC-01 至 04 基线例外明确,后续 done 任务不能缺失独立 commit;计划/已执行/缺证据分开,识别缺少验证归属的公开契约 M done
ENG-10 workspace
建立历史失败分级和测试可靠性规则
ENG-03, ENG-04, ENG-05, ENG-07, BASE-07 历史失败 ID/环境/旧版复现/负责修复任务、逐模块门槛、受控等待与 trace/retry 规则 不靠全局忽略或无理由 skip 隐藏问题,新增回归阻止交付,设备缺口和偶发失败单独可见;以 risks.json 为统一差异索引;关闭必须有 resolutionEvidence/rationale,已复现、源码事实、未验证分开,登记不等于豁免 M done
ENG-11 workspace
增加不改变产物的模块构建分析
ENG-03, ENG-08 正式构建的可选模块归因报告及源码/产物指纹 相同构建开关前后三格式字节一致,报告不进入分发包;区分 Rollup 渲染字节与压缩体积,并保留真实工作区/发布来源 L done

2.2 GitHub CI/CD

ID 范围 / 步骤 前置依赖 交付物 验收条件 风险 状态
CI-01 workspace
增强兼容矩阵、并发缓存与 CI 报告
DOC-10, ENG-08, ENG-09, ENG-10 OS/Node/TS/浏览器与影响范围矩阵、缓存、超时、汇总检查和 artifact 报告 固定安装、失败/取消不误报、核心影响全生态;检查只读,失败证据可追溯 H doing
CI-02 workspace
分离并改进 GitHub Pages 部署
DOC-10, ENG-02, SITE-03 Pages artifact 部署配置、旧路径/域名核对、预检和迁移恢复指南 部署只取受信任已验证产物;本地实现可验收,远端 source/环境和实际部署状态单独登记 H done
CI-03 workspace
建立 npm 分包候选与发布工作流
DOC-10, CI-01, REL-08, REL-04 候选准备、精确 artifact 发布配置、OIDC 评估、版本/tag/registry 预检和部分失败恢复 不自动发布;明确逐包信任前置和 dry run 限制,不能重建未验证内容或重发冲突版本;按版本清单校验各包下一 major 和预发布/正式 tag,保留旧核心支持范围 H todo
CI-04 workspace
验收 GitHub 流水线与远端发布准入
CI-01, CI-02, CI-03, SITE-06, CI-BROWSER-01 静态/干净环境检查、真实 PR 正反例、候选 dry run、required checks/Pages/npm 必需配置状态及运维指南 必要 Actions 证据和远端配置核对齐全;缺失保持未完成,真实 publish/deploy 仍在授权发布步骤执行 H todo
CI-BROWSER-01 workspace
分离源码与已安装产物浏览器验证范围
ENG-05, ENG-07 完整源码入口、明确已安装包子集、分开的报告目录与失败传播 混用输入旧红新绿;源码默认保留所有spec,已安装入口严格校验四包来源;两类报告都保留,源码失败不能误报全绿;不代表完整远端或全包验收 M done

2.1 早期试点

ID 范围 / 步骤 前置依赖 交付物 验收条件 风险 状态
PILOT-01 artplayer-plugin-chapter
在旧核心上完成小插件迁移闭环
PKG-CHAPTER-04, ENG-07, ENG-05, ENG-10 chapter 的 TS、旧核心消费、真实浏览器、tarball、包内维护地图及粒度/成本反馈 不依赖 CORE 重构即可通过整个试点;最终核心仍由 chapter 05/06 重新验收 H done

3-4 核心迁移

ID 范围 / 步骤 前置依赖 交付物 验收条件 风险 状态
CORE-01 artplayer
迁移纯工具并冻结导出
ENG-03, ENG-04, ENG-06, PILOT-01 utils/time/property/format/file/error/subtitle 的分批 TS 迁移 Artplayer.utils 导出/参数/绑定保持,纯逻辑与类型测试通过 M done
CORE-02 artplayer
迁移内部 Emitter
CORE-01, BASE-03 带类型事件映射的原 Emitter 实现 ctx、once/off、重入/异常和链式返回保持 H done
CORE-03 artplayer
建立内部资源作用域
CORE-02 监听/订阅/定时器/RAF/请求/URL 的资源登记 实例与操作作用域分离,单项清理失败不阻断其他资源 H done
CORE-04 artplayer
修复初始化与销毁生命周期
CORE-03, ENG-05, BASE-07 构造失败回收、重复/重入 destroy、instances 修复 事件顺序、removeHtml、多实例和销毁中异步有真实回归;处理 baselines/lifecycle-coverage.md 的 BASE-LIFE-04/05 并增加候选正向回归;协调 BASE-PERF-01 销毁后定时器与回调归属 H done
CORE-05 artplayer
区分输入配置和内部配置
CORE-01, ENG-04 Option/ResolvedOption、默认值与校验整理 配置合并/错误时机不变,JS 输入仍运行时校验 M done
CORE-06 artplayer
建立内部媒体与宿主类型
CORE-05 原生 video、canvas shim、UI host 类型 不更改公开 art.video 用法,不以 HTMLVideoElement 断言掩盖 shim M done
CORE-07 artplayer
逐项协调公开声明差异
CORE-02, CORE-06, BASE-07 plugins/toggle/cue/setting/static 的旧新类型对照 每项有兼容重载/扩展或待决结论,不能删除旧类型样例;处理 BASE-TYPE-01/04,分别保留旧合法声明消费并验证真实返回;协调 BASE-TYPE-05 的 Utils 导出、descriptor 和 timer 旧声明差异 H done
CORE-08 artplayer
整理插件管理器与扩展类型
CORE-03, CORE-07 注册流程、同步/异步结果、插件/事件扩展接口 旧插件同步可见性、重名与命名、销毁中异步插件保持明确语义;处理 baselines/lifecycle-coverage.md 的 BASE-LIFE-03 并增加候选正向回归;接续 CORE-07 / BASE-TYPE-04 的同步/异步注册返回声明冲突,内部返回类型精确,保留历史消费者 H done
CORE-09 artplayer
整理 URL 与切源操作
CORE-04, CORE-06, CORE-08 url/switch/customType 的操作身份及取消方案 并发切源、错误、同 URL、销毁和 Promise 结算有契约;处理 baselines/lifecycle-coverage.md 的 BASE-LIFE-01/02/06 并增加候选正向回归 H done
CORE-10 artplayer
迁移播放与时间/状态属性
CORE-09 play/pause/toggle/seek/volume/rate/duration 等模块 旧返回值、拒绝、mutex、位置恢复、属性描述符与事件通过;接续 CORE-07 / BASE-TYPE-04 的 toggle void 与实际 Promise 分支冲突,不吞拒绝 H done
CORE-11 artplayer
整理媒体事件、ready 与重连
CORE-10 媒体转发、重连、UI 响应职责分离 readiness 次数/顺序、过期重连、原错误参数有回归 H done
CORE-12 artplayer
迁移模板及公开资源入口
CORE-06, CORE-04, BASE-04 template/icons/i18n/style、SSR 与 proxy 挂载 DOM/CSS/global/样式注入、i18n 子路径及 SSR import 保持;不把 SSR import/useSSR 保持扩大为服务端构造播放器;复跑 BASE-05 的 SSR import/模板、浏览器 useSSR 节点复用和非浏览器构造错误;接续 VENDOR-01/02,核对 screenfull/hint 复制版本、修改与分发通知,保留 DOM/CSS/fullscreen 行为 H done
CORE-13 artplayer
迁移组件注册与控件
CORE-12, CORE-08 Component/control/layer/contextmenu 的资源与 TS 边界 add/update/remove、name、selector、mounted/beforeUnmount 通过;处理 BASE-DOM-02 窄容器控件裁切,保留 controls.update 的旧 undefined 返回值 H done
CORE-14 artplayer
拆分设置树、渲染和布局
CORE-13 setting model/selection/render/layout 的分批实现 不强行统一控件返回值,嵌套选择、默认高亮、更新清理通过;结合 BASE-DOM-02 验证窄容器设置定位;接续 BASE-TYPE-07 的 find null、add/update item、remove undefined 声明冲突 H done
CORE-15 artplayer
迁移字幕获取、解析和渲染
CORE-11, CORE-13 subtitle 请求/track/DOM/URL 生命周期与类型 过期结果、偏移、cue 数组、原生全屏及错误路径通过;接续 BASE-TYPE-07 的真实 cue 数组与旧隐式 scalar 回调声明兼容 H done
CORE-16 artplayer
迁移全屏、PiP、mini 与尺寸模式
CORE-11, CORE-12 显示模式服务和原公开属性门面 模式互斥/恢复位置、手势权限、移动方向和退出失败通过 H done
CORE-17 artplayer
迁移键盘、手势、焦点和全局事件
CORE-13, CORE-16 events/hotkey 的明确 document 与资源归属 跨 document 重绑、触摸/键盘、快捷键及销毁无重复响应;修复 BASE-PERF-01 pending resize debounce 销毁后执行,并验证正常 resize 不变 H done
CORE-18 artplayer
迁移内置插件和提示模块
CORE-14, CORE-16, CORE-17 autoPlayback/autoOrientation/fastForward/lock/miniProgressBar 及 info/notice/loading/mask 默认启用条件、storage 格式、定时器/动画清理通过;结合 BASE-PERF-01 防止销毁后重新安排 notice timer;接续 BASE-TYPE-07 的 notice.show boolean getter 与历史读类型冲突 M done
CORE-19 artplayer
整理进度、质量、缩略图和截图
CORE-10, CORE-13, CORE-16 相关 player/control 功能与纯计算分离 截图跨域失败、缩略图布局、quality/进度边界保持 M done
CORE-20 artplayer
收敛核心入口与依赖方向
CORE-14, CORE-15, CORE-18, CORE-19 Artplayer 门面、初始化依赖与最终目录 所有核心自有源码迁移,公开描述符/静态接口/事件差分通过 H done
CORE-21 artplayer
生成核心声明并校验包内容
CORE-20, ENG-07 由 TS 生成的既有入口声明与三种发布产物 内部类型不泄漏,旧 JS/TS 消费者与 i18n 通过;逐项完成 CORE-07 留下的 BASE-TYPE-04/05/07 声明方案,旧合法消费者与实际返回分别留证;不能以虚假的交叉返回类型或改变运行时来掩盖冲突,未决项阻止核心声明出口;处理 CORE-10 / BASE-TYPE-08 的 setter-only 属性虚构 getter 声明,并复核 PlaybackControls 精确视图与旧 toggle 声明共存策略 H done
CORE-23 artplayer
检查并补齐键盘、焦点与可访问名称
CORE-13, CORE-14, CORE-17, ENG-05, BASE-04 主要控件/设置/模式退出的键盘与焦点回归、名称和字幕可用性检查及必要兼容修正 保持旧快捷键和 DOM/CSS 钩子;真实浏览器验证,不以静态属性检查代替交互;处理 BASE-DOM-01 的主要控件 Tab 不可达,保留既有名称与快捷键 H done
CORE-22 artplayer
核心阶段完整验收
CORE-21, CORE-23, PILOT-01, ENG-08, ENG-10, ENG-11 核心与旧插件的可自动化完整回归、资源/性能及明确外部验证缺口 核心自动化和公开差异处置通过;真实环境缺口链接包集成/REL 门槛,阶段完成不代表可公开发布 H done
CORE-24 artplayer
修复连续切源的播放意图继承
CORE-22, PKG-AUDIO-04 连续切源保留原播放意图,同时尊重显式暂停与最新来源,回归旧/新 audio 真实暂停状态的受控测试、重入/取消/失败/销毁、三引擎和 main/legacy 产物验证通过;不恢复过期来源的公开副作用 H done
CORE-25 artplayer
修复无 navigator 环境读取默认选项
CORE-22, ENG-12 安全读取默认语言并保留浏览器已有默认值;实际 Node 与发布产物正反例 记录旧发布版 ReferenceError;候选在无 navigator 时可读默认选项,浏览器语言和公开类型不回归;不以补全局对象隐藏错误 M done
CORE-SUBTITLE-OFFSET-01 artplayer
修复暂停偏移后的原生活动字幕刷新
CORE-15, CORE-22 暂停字幕偏移的原生轨道一致性修复、兼容回归和维护说明 保持cue对象、顺序、媒体时间、模式和公开事件;真实浏览器正负偏移及生命周期通过,历史缺陷单列 H done

5 包迁移:artplayer-plugin-chapter

ID 范围 / 步骤 前置依赖 交付物 验收条件 风险 状态
PKG-CHAPTER-01 artplayer-plugin-chapter
核对包契约与历史用法
BASE-05 chapters 时间区间、update、name 和进度 DOM 清单 源码/声明/README/demo/发布包差异已登记;公开形状和版本范围冻结 M done
PKG-CHAPTER-02 artplayer-plugin-chapter
建立特有行为与错误测试
PKG-CHAPTER-01, ENG-03, ENG-05 区间重叠/空列表/边界 seek、hover 标题和 update 用例 旧版本行为可重跑,成功/失败/切源/销毁有必要断言;修正 BASE-TYPE-02 的可选参数声明并补正反例 M done
PKG-CHAPTER-03 artplayer-plugin-chapter
以 TypeScript 拆分内部职责与资源
PKG-CHAPTER-02, ENG-07 以严格 TS 拆分区间计算、进度 DOM、事件生命周期与样式注入;公开声明消费在 04 闭环 不依赖新核心方法或大范围设置重构;旧 API/事件和资源通过,必要适配限包内 M done
PKG-CHAPTER-04 artplayer-plugin-chapter
迁移自有源码和公开类型
PKG-CHAPTER-03, ENG-04, ENG-06 承接 03 的自有源码 TS 化,完善公开 Chapters/Option/Result 与 update 推导,关闭声明模块解析和旧消费差异 严格类型检查、旧消费样例通过;声明路径/导出和同步异步兼容;处理 BASE-TYPE-01/03,保持运行时和新旧 TS 模块解析消费 M done
PKG-CHAPTER-05 artplayer-plugin-chapter
验证新旧核心和组合
PKG-CHAPTER-04, CORE-22 chapter + quality/thumbnail、移动和全屏进度场景 最终核心与原支持范围核心分别通过;设备/SDK 缺证据不能标完成 M doing
PKG-CHAPTER-06 artplayer-plugin-chapter
验证分发并同步文档
PKG-CHAPTER-05, ENG-07, PKG-CHAPTER-HOVER-01 chapter.js 示例、产物和变更记录 tarball 入口/资源、类型、8082 demo 和 README 一致,有回退记录 M todo
PKG-CHAPTER-HOVER-01 artplayer-plugin-chapter
定位并修复原生全屏章节悬停时序
PKG-CHAPTER-04, CI-BROWSER-01 原生全屏动态几何与指针时序复现、针对根因的修复和真实浏览器回归 解释 Chromium 旧核心+新章节的 opacity 失败;保留标题、缩略图和全屏退出断言,不以重试或扩大等待掩盖;区分测试同步与生产缺陷 M done

5 包迁移:artplayer-plugin-ambilight

ID 范围 / 步骤 前置依赖 交付物 验收条件 风险 状态
PKG-AMBILIGHT-01 artplayer-plugin-ambilight
核对包契约与历史用法
BASE-05 blur/opacity/frequency/duration、start/stop 与挂载样式 源码/声明/README/demo/发布包差异已登记;公开形状和版本范围冻结 M done
PKG-AMBILIGHT-02 artplayer-plugin-ambilight
建立特有行为与错误测试
PKG-AMBILIGHT-01, ENG-03, ENG-05 跨域 canvas 失败、零尺寸、暂停、重复 start/stop 和 destroy 旧版本行为可重跑,成功/失败/切源/销毁有必要断言 M done
PKG-AMBILIGHT-03 artplayer-plugin-ambilight
整理内部职责与资源
PKG-AMBILIGHT-02, CORE-03, CORE-12 取色计算与绘帧分离,统一 RAF 和 DOM 清理 结构变化和缺陷修复分开记录;原 API/事件/资源生命周期通过 M done
PKG-AMBILIGHT-04 artplayer-plugin-ambilight
迁移自有源码和公开类型
PKG-AMBILIGHT-03, ENG-04, ENG-06, CORE-07 canvas 上下文、参数及 start/stop 的明确类型 严格类型检查、旧消费样例通过;声明路径/导出和同步异步兼容 M done
PKG-AMBILIGHT-PROXY-01 artplayer-plugin-ambilight, artplayer-proxy-canvas
修复Canvas代理输出尺寸与取色区域
PKG-AMBILIGHT-04, CORE-22 按Canvas实际输出buffer取色,原生video保留intrinsic尺寸,明确5.1.7没有proxy配置 旧错误复现、三引擎实际代理九色区域对照及原生视频回归通过;不把本子项当作最终代理/设备验收 M done
PKG-AMBILIGHT-05 artplayer-plugin-ambilight
验证新旧核心和组合
PKG-AMBILIGHT-04, CORE-22, PKG-AMBILIGHT-PROXY-01, PKG-CANVAS-04, PKG-FACTORY-01 原生 video、canvas proxy 的能力边界及销毁无帧循环 最终核心与原支持范围核心分别通过;设备/SDK 缺证据不能标完成 M doing
PKG-AMBILIGHT-06 artplayer-plugin-ambilight
验证分发并同步文档
PKG-AMBILIGHT-05, ENG-07 ambilight.js 示例及样式/分发验证 tarball 入口/资源、类型、8082 demo 和 README 一致,有回退记录 M todo

5 包迁移:artplayer-plugin-audio-track

ID 范围 / 步骤 前置依赖 交付物 验收条件 风险 状态
PKG-AUDIO-01 artplayer-plugin-audio-track
核对包契约与历史用法
BASE-05 url/offset/sync、audio 实例暴露、update 与音量语义 源码/声明/README/demo/发布包差异已登记;公开形状和版本范围冻结 H done
PKG-AUDIO-02 artplayer-plugin-audio-track
建立特有行为与错误测试
PKG-AUDIO-01, ENG-03, ENG-05 偏移、倍率、seek、waiting/playing、加载错误和 autoplay 拒绝 旧版本行为可重跑,成功/失败/切源/销毁有必要断言 H done
PKG-AUDIO-03 artplayer-plugin-audio-track
整理内部职责与资源
PKG-AUDIO-02, CORE-10 外部 audio 的同步策略、监听与源更新生命周期 结构变化和缺陷修复分开记录;原 API/事件/资源生命周期通过 H done
PKG-AUDIO-04 artplayer-plugin-audio-track
迁移自有源码和公开类型
PKG-AUDIO-03, ENG-04, ENG-06, CORE-07 Option/Result/audio、update 输入和事件类型 严格类型检查、旧消费样例通过;声明路径/导出和同步异步兼容 H done
PKG-AUDIO-05 artplayer-plugin-audio-track
验证新旧核心和组合
PKG-AUDIO-04, CORE-22, CORE-24 主视频切源和缓冲恢复,多实例独立音频、旧核心 最终核心与原支持范围核心分别通过;设备/SDK 缺证据不能标完成 H doing
PKG-AUDIO-06 artplayer-plugin-audio-track
验证分发并同步文档
PKG-AUDIO-05, ENG-07 audio.track.js 示例与运行返回值一致的声明 tarball 入口/资源、类型、8082 demo 和 README 一致,有回退记录 H todo

5 包迁移:artplayer-plugin-auto-thumbnail

ID 范围 / 步骤 前置依赖 交付物 验收条件 风险 状态
PKG-AUTO-THUMB-01 artplayer-plugin-auto-thumbnail
核对包契约与历史用法
BASE-05 url/width/number/scale、异步工厂和渐进缩略图更新 源码/声明/README/demo/发布包差异已登记;公开形状和版本范围冻结 H done
PKG-AUTO-THUMB-02 artplayer-plugin-auto-thumbnail
建立特有行为与错误测试
PKG-AUTO-THUMB-01, ENG-03, ENG-05 抽帧边界、短视频、失败、连续来源和销毁中的抽帧 旧版本行为可重跑,成功/失败/切源/销毁有必要断言 H done
PKG-AUTO-THUMB-03 artplayer-plugin-auto-thumbnail
整理内部职责与资源
PKG-AUTO-THUMB-02, CORE-09, CORE-19, PKG-AUTO-THUMB-07 隐藏 video、seek 队列、canvas 编码与 Blob URL 清理 结构变化和缺陷修复分开记录;原 API/事件/资源生命周期通过 H doing
PKG-AUTO-THUMB-04 artplayer-plugin-auto-thumbnail
迁移自有源码和公开类型
PKG-AUTO-THUMB-02, CORE-09, CORE-19, PKG-AUTO-THUMB-07, PKG-AUTO-THUMB-12, ENG-04, ENG-06, CORE-07, PKG-AUTO-THUMB-08, PKG-AUTO-THUMB-09, PKG-AUTO-THUMB-10, PKG-AUTO-THUMB-11 抽帧结果和真实异步插件返回类型兼容 严格类型检查、旧消费样例通过;声明路径/导出和同步异步兼容 H done
PKG-AUTO-THUMB-05 artplayer-plugin-auto-thumbnail
验证新旧核心和组合
PKG-AUTO-THUMB-04, CORE-22, PKG-AUTO-THUMB-12, PKG-AUTO-THUMB-03 旧核心/候选核心预览、多次加载无过期缩略图覆盖 最终核心与原支持范围核心分别通过;设备/SDK 缺证据不能标完成 H todo
PKG-AUTO-THUMB-06 artplayer-plugin-auto-thumbnail
验证分发并同步文档
PKG-AUTO-THUMB-05, ENG-07 auto.thumbnail.js、三种产物和内存/URL 证据 tarball 入口/资源、类型、8082 demo 和 README 一致,有回退记录 H todo
PKG-AUTO-THUMB-07 artplayer-plugin-auto-thumbnail
终止抽帧时清空私有画布像素尺寸
PKG-AUTO-THUMB-02, CORE-09, CORE-19 将私有 canvas 尺寸归入 job 清理;完成、取消、失败及分配重入均有回归,保留已编码 JPEG 旧红新绿证明保留回调时画布归零,单项清理失败不阻断其他资源;原生取消和完成后 JPEG 仍可解码,原 API/时间公式/类型不变 M done
PKG-AUTO-THUMB-08 artplayer-plugin-auto-thumbnail
保留旧声明并提供准确异步类型入口
PKG-AUTO-THUMB-02, ENG-04, ENG-06, CORE-07 保留实际 npm 1.1.0 根声明;新增同实现 /runtime 类型、编辑器声明及隔离安装消费者 原 Parameters/ReturnType/替代函数不变;准确 Promise 类型正反例、CJS/ESM 条件入口和声明解析通过;不把像素与设备缺口计为通过 M done
PKG-AUTO-THUMB-09 artplayer-plugin-auto-thumbnail
兼容旧 CommonJS default 与直接工厂调用
PKG-AUTO-THUMB-02, PKG-AUTO-THUMB-08 同一 callable 上的 default 自别名,保留最新根声明并补准确 runtime 别名类型;旧/新实际包入口证据 旧红新绿、直接/default/ESM/legacy/global 调用一致;旧根类型提取不变,公开准确类型与实际别名匹配;不关闭抽帧像素和设备缺口 M done
PKG-AUTO-THUMB-10 artplayer-plugin-auto-thumbnail
为渐进 JPEG 编码建立取消时限与独立资源归属
PKG-AUTO-THUMB-02, PKG-AUTO-THUMB-07 拆分私有 canvas 编码模块,一次一帧的30秒编码时限,完成/失败/切源/销毁取消;迟到和重复回调无副作用 受控回调未返回的旧红新绿、正常JPEG和前一预览保持、同步重入/清理失败有回归;真实三浏览器编码/取消通过,公开时间公式与入口不变,首帧风险独立保留 M done
PKG-AUTO-THUMB-11 artplayer-plugin-auto-thumbnail
保证抽帧事件属性清理异常不截断其他资源释放
PKG-AUTO-THUMB-02, PKG-AUTO-THUMB-07, PKG-AUTO-THUMB-10 独立清除事件属性、抽帧时限和原生帧回调;首个异常保留,过期回调失效,替换任务可继续 八个故障注入用例旧红新绿,实际main/legacy抽帧与三浏览器生命周期回归通过;文档和构建同步,首帧及整体资源验收不冒充完成 M done
PKG-AUTO-THUMB-12 artplayer-plugin-auto-thumbnail
终止隐藏视频元数据永久等待并释放资源
PKG-AUTO-THUMB-02, CORE-09, CORE-19 元数据独立 30 秒期限、迟到回调失效、取消和错误清理、保留前一张可用预览;源码/重建产物及浏览器证据 旧红新绿、正常加载与阶段交接通过;实际挂起 HTTP 下销毁/切源/超时清理通过,不改变公开注册或帧时间公式,不关闭既有首帧风险 M done

5 包迁移:artplayer-plugin-vtt-thumbnail

ID 范围 / 步骤 前置依赖 交付物 验收条件 风险 状态
PKG-VTT-THUMB-01 artplayer-plugin-vtt-thumbnail
核对包契约与历史用法
BASE-05 vtt/style、异步返回、预览控件名与样式契约 源码/声明/README/demo/发布包差异已登记;公开形状和版本范围冻结 M done
PKG-VTT-THUMB-02 artplayer-plugin-vtt-thumbnail
建立特有行为与错误测试
PKG-VTT-THUMB-01, ENG-03, ENG-05 VTT 解析、xywh、相对 URL、时间边界、请求失败和定位 旧版本行为可重跑,成功/失败/切源/销毁有必要断言 M done
PKG-VTT-THUMB-03 artplayer-plugin-vtt-thumbnail
整理内部职责与资源
PKG-VTT-THUMB-02, CORE-09, CORE-19 纯解析/区间查找与 DOM、请求/定时器生命周期分离 结构变化和缺陷修复分开记录;原 API/事件/资源生命周期通过 M done
PKG-VTT-THUMB-04 artplayer-plugin-vtt-thumbnail
迁移自有源码和公开类型
PKG-VTT-THUMB-03, ENG-04, ENG-06, CORE-07 cue/rect/result 和参数可选性保持兼容 严格类型检查、旧消费样例通过;声明路径/导出和同步异步兼容 M done
PKG-VTT-THUMB-05 artplayer-plugin-vtt-thumbnail
验证新旧核心和组合
PKG-VTT-THUMB-04, CORE-22 鼠标和移动进度、全屏、切源、chapter 组合 最终核心与原支持范围核心分别通过;设备/SDK 缺证据不能标完成 M doing
PKG-VTT-THUMB-06 artplayer-plugin-vtt-thumbnail
验证分发并同步文档
PKG-VTT-THUMB-05, ENG-07 vtt.thumbnail.js、VTT/图片资源解析和产物验证 tarball 入口/资源、类型、8082 demo 和 README 一致,有回退记录 M todo

5 包迁移:artplayer-plugin-hls-control

ID 范围 / 步骤 前置依赖 交付物 验收条件 风险 状态
PKG-HLS-01 artplayer-plugin-hls-control
核对包契约与历史用法
BASE-05 quality/audio 配置、getName、update、控件名及 Hls 实例绑定 源码/声明/README/demo/发布包差异已登记;公开形状和版本范围冻结 H done
PKG-HLS-02 artplayer-plugin-hls-control
建立特有行为与错误测试
PKG-HLS-01, ENG-03, ENG-05 Auto/手动实际 level、音轨、去重/过滤和拓扑变化 旧版本行为可重跑,成功/失败/切源/销毁有必要断言 H done
PKG-HLS-03 artplayer-plugin-hls-control
整理内部职责与资源
PKG-HLS-02, CORE-11, CORE-14 映射计算与 selector 更新/删除、Hls 事件订阅分离 结构变化和缺陷修复分开记录;原 API/事件/资源生命周期通过 H done
PKG-HLS-04 artplayer-plugin-hls-control
迁移自有源码和公开类型
PKG-HLS-03, ENG-04, ENG-06, CORE-07 HLS 能力适配类型、回调上下文和旧 getName 参数 严格类型检查、旧消费样例通过;声明路径/导出和同步异步兼容 H done
PKG-HLS-SDK-01 artplayer-plugin-hls-control
验证真实 SDK worker 与分组轨道组合
PKG-HLS-04, CORE-22 固定历史及当前 SDK 归档、真实 worker/多音轨组、外部选择与重绑定浏览器证据 受支持桌面 MSE 引擎与新旧核心通过;无 worker 回退伪通过,设备缺口仍由 PKG-HLS-05 保持未完成 H doing
PKG-HLS-05 artplayer-plugin-hls-control
验证新旧核心和组合
PKG-HLS-04, CORE-22, PKG-HLS-SDK-01 本地多码率 HLS、换成无轨道来源、旧核心和最终核心 最终核心与原支持范围核心分别通过;设备/SDK 缺证据不能标完成 H todo
PKG-HLS-06 artplayer-plugin-hls-control
验证分发并同步文档
PKG-HLS-05, ENG-07, PKG-HLS-PACK-01 hls.control.js、依赖范围与回退记录 tarball 入口/资源、类型、8082 demo 和 README 一致,有回退记录 H todo
PKG-HLS-PACK-01 artplayer-plugin-hls-control
排除发布包内的实现 TypeScript 配置
PKG-HLS-04, ENG-07 修正 npm 排除规则,真实打包核验公开入口与声明不变 旧归档复现 tsconfig 泄漏,新归档排除内部配置,全部历史 dist/types 保留且 JS/声明字节相同;正常 Yarn 打包与通用包校验通过 M done

5 包迁移:artplayer-plugin-dash-control

ID 范围 / 步骤 前置依赖 交付物 验收条件 风险 状态
PKG-DASH-01 artplayer-plugin-dash-control
核对包契约与历史用法
BASE-05 quality/audio、representation ID/Auto、getName 和 update 源码/声明/README/demo/发布包差异已登记;公开形状和版本范围冻结 H done
PKG-DASH-02 artplayer-plugin-dash-control
建立特有行为与错误测试
PKG-DASH-01, ENG-03, ENG-05 保留已有 5 项稳定 ID 回归,补发布版 SDK 4.x/当前 5.x、音轨/空列表/过滤/换源与关闭引用 旧版本行为可重跑,成功/失败/切源/销毁有必要断言 H done
PKG-DASH-03 artplayer-plugin-dash-control
整理内部职责与资源
PKG-DASH-02, CORE-11, CORE-14 能力适配保留 SDK 4.x 与 5.x,稳定 ID 映射、ABR 状态、UI 清理和生命周期职责分离 结构变化和缺陷修复分开记录;原 API/事件/资源生命周期通过 H done
PKG-DASH-04 artplayer-plugin-dash-control
迁移自有源码和公开类型
PKG-DASH-03, ENG-04, ENG-06, CORE-07 dash.js adapter、selector 和回调类型 严格类型检查、旧消费样例通过;声明路径/导出和同步异步兼容 H done
PKG-DASH-SEEK-01 artplayer-plugin-dash-control
修复 SDK 4.5.2 暂停跳转后的缓冲指标停滞
PKG-DASH-04 按版本和实测空缓冲限定的指标同步、生命周期守卫及真实 SDK 旧红新绿 新插件在新旧核心及 Chromium/Firefox 原位置回归通过;不修改 SDK 方法/配置、媒体时间或删除缓冲;旧 SDK 原生缺陷与旧插件限制独立记录,不宣称第三方本体已修复 H done
PKG-DASH-MENU-01 artplayer-plugin-dash-control
定位并修复 SDK 刷新期间设置选项不可见
PKG-DASH-SEEK-01 真实 SDK 菜单点击失败根因、对应兼容修复及新旧核心回归 保留 legacy/旧核心/SDK5.2.1 的原失败;确定菜单在点击过程中不可见的原因;不靠 force 点击、扩大超时或重复运行覆盖问题;main/legacy 质量与音轨设置及 SDK 刷新组合通过 H done
PKG-DASH-05 artplayer-plugin-dash-control
验证新旧核心和组合
PKG-DASH-04, CORE-22, PKG-DASH-SEEK-01 固定 dash.js 4.5.2/5.2.1 与本地 DASH 实际清晰度/音轨、高亮、Auto 和换源组合 最终核心与原支持范围核心分别通过;设备/SDK 缺证据不能标完成 H doing
PKG-DASH-06 artplayer-plugin-dash-control
验证分发并同步文档
PKG-DASH-05, ENG-07, PKG-DASH-MENU-01 dash.control.js、支持的 dash.js 版本与产物 tarball 入口/资源、类型、8082 demo 和 README 一致,有回退记录 H todo

5 包迁移:artplayer-plugin-multiple-subtitles

ID 范围 / 步骤 前置依赖 交付物 验收条件 风险 状态
PKG-MULTI-SUB-01 artplayer-plugin-multiple-subtitles
核对包契约与历史用法
BASE-05 subtitles/onParser、multipleSubtitles 名称及实际返回方法 源码/声明/README/demo/发布包差异已登记;公开形状和版本范围冻结;接续 VENDOR-03,定位 WebVTT parser 来源/修订及 CC0 头,保留解析/序列化行为 H done
PKG-MULTI-SUB-02 artplayer-plugin-multiple-subtitles
建立特有行为与错误测试
PKG-MULTI-SUB-01, ENG-03, ENG-05 VTT/SRT/ASS、编码/重叠 cue/排序/空轨/失败与切换 旧版本行为可重跑,成功/失败/切源/销毁有必要断言 H done
PKG-MULTI-SUB-03 artplayer-plugin-multiple-subtitles
整理内部职责与资源
PKG-MULTI-SUB-02, CORE-15 解析与合并/获取/渲染分离,过期请求及对象 URL 清理 结构变化和缺陷修复分开记录;原 API/事件/资源生命周期通过 H done
PKG-MULTI-SUB-04 artplayer-plugin-multiple-subtitles
迁移自有源码和公开类型
PKG-MULTI-SUB-03, ENG-04, ENG-06, CORE-07 准确 parser/cue/tree/result 类型与真实异步形状 严格类型检查、旧消费样例通过;声明路径/导出和同步异步兼容 H done
PKG-MULTI-SUB-07 artplayer-plugin-multiple-subtitles
修复字幕内嵌时间戳序列化
PKG-MULTI-SUB-03 保留数字时间戳节点、修正无效 NaN 输出、明确旧/新字幕输出差异 旧九份实现可复现,候选有效内嵌时间戳及文字/CSS/原生字幕通过,公开工厂与选择接口不变 H done
PKG-MULTI-SUB-08 artplayer-plugin-multiple-subtitles
修复字幕实体解码与嵌套标签包装
PKG-MULTI-SUB-04, PKG-MULTI-SUB-07 使用解析器既有实体表入口修复多余分号;保护字面文本并以兄弟节点包装标签,保留CSS钩子和时间戳 冻结旧实现复现、实体/双重编码/标签/选择重置回归、新旧核心真实字幕显示通过;vendor原文与来源校验不变,类型/分发兼容 M done
PKG-MULTI-SUB-05 artplayer-plugin-multiple-subtitles
验证新旧核心和组合
PKG-MULTI-SUB-04, CORE-22, PKG-MULTI-SUB-07, PKG-MULTI-SUB-08 与核心字幕/偏移/全屏组合,旧名称调用不变 最终核心与原支持范围核心分别通过;设备/SDK 缺证据不能标完成 H doing
PKG-MULTI-SUB-06 artplayer-plugin-multiple-subtitles
验证分发并同步文档
PKG-MULTI-SUB-05, ENG-07, CORE-SUBTITLE-OFFSET-01, PKG-MULTI-SUB-09, PKG-MULTI-SUB-10, PKG-MULTI-SUB-11 multiple.subtitles.js、parser 来源许可及打包边界 tarball 入口/资源、类型、8082 demo 和 README 一致,有回退记录 H todo
PKG-MULTI-SUB-09 artplayer-plugin-multiple-subtitles, artplayer
定位旧核心切源寻址与字幕显示边界
PKG-MULTI-SUB-08, CORE-19 无插件及旧新插件对照、真实事件轨迹、原切源失败归因和组合测试顺序 保留旧核心立即寻址观察,候选首次寻址与正常字幕组合通过;不把原生时钟失败误归为字幕丢失 M done
PKG-MULTI-SUB-10 artplayer-plugin-multiple-subtitles
适配旧核心的多条活动字幕渲染
PKG-MULTI-SUB-08, PKG-MULTI-SUB-09 独立旧宿主显示适配、原生异步字幕重叠回归和兼容边界说明 旧5.1.2/5.1.7复现先红后绿;保持原生cue对象/时间、旧事件标量和方法身份;多格式显示及清理通过,保留其他组合和设备缺口 M done
PKG-MULTI-SUB-11 artplayer-plugin-multiple-subtitles
处理旧发布核心 ASS 转换器丢失换行
PKG-MULTI-SUB-10 冻结5.1.2发布/源码转换差异,兼容转换适配与真实ASS字幕回归 保持已有效转换行为,旧发布ASS缺陷有先红后绿与实际产物证据;不得将VTT替代夹具算作ASS通过 M done

5 包迁移:artplayer-plugin-jassub

ID 范围 / 步骤 前置依赖 交付物 验收条件 风险 状态
PKG-JASSUB-01 artplayer-plugin-jassub
核对包契约与历史用法
BASE-05 选项透传、result.instance、vendor 来源、worker/WASM/font 路径 源码/声明/README/demo/发布包差异已登记;公开形状和版本范围冻结;接续 VENDOR-04/05,核对 wrapper/worker/WASM/font 的独立来源与通知,保持资源路径和选项透传 H done
PKG-JASSUB-02 artplayer-plugin-jassub
建立特有行为与错误测试
PKG-JASSUB-01, ENG-03, ENG-05 ASS 字体、时钟/seek/倍率/resize、加载失败和销毁 旧版本行为可重跑,成功/失败/切源/销毁有必要断言 H done
PKG-JASSUB-03 artplayer-plugin-jassub
整理内部职责与资源
PKG-JASSUB-02, CORE-15, CORE-16 仅整理自有 adapter/销毁;保留第三方文件及来源 结构变化和缺陷修复分开记录;原 API/事件/资源生命周期通过 H done
PKG-JASSUB-04 artplayer-plugin-jassub
迁移自有源码和公开类型
PKG-JASSUB-03, ENG-04, ENG-06, CORE-07 JASSUB option/instance 的兼容类型包装,vendor JS 例外记录 严格类型检查、旧消费样例通过;声明路径/导出和同步异步兼容 H done
PKG-JASSUB-05 artplayer-plugin-jassub
验证新旧核心和组合
PKG-JASSUB-04, CORE-22, PKG-JASSUB-07, PKG-JASSUB-08, PKG-JASSUB-09, PKG-JASSUB-10 真实 worker/WASM 字幕渲染与全屏、旧核心测试 最终核心与原支持范围核心分别通过;设备/SDK 缺证据不能标完成 H todo
PKG-JASSUB-06 artplayer-plugin-jassub
验证分发并同步文档
PKG-JASSUB-05, ENG-07 jassub.js、外部资源路径、许可和离线失败记录;接续 VENDOR-04/05 完整组件/字体通知、LGPL 源码分发核对及六份未明确字体的分发处置 tarball 入口/资源、类型、8082 demo 和 README 一致,有回退记录;来源身份已由01冻结,完整通知和未明确字体的发布处理必须闭环,不能以来源相同替代许可结论 H todo
PKG-JASSUB-07 artplayer-plugin-jassub
修复 vendor 生命周期与字幕时钟
PKG-JASSUB-03, PKG-JASSUB-02 独立记录 vendor 适配差异;幂等销毁、跨容器 setVideo、构造回滚、逐帧归属和倍率/能力边界;查询 timeout/Worker error 的缺失数据回调及每请求监听器/定时器清理(JASSUB-QUERY-01) 保持公开真实 instance、同步方法与资源路径;保留原 vendor 来源指纹并记录每项实际补丁;候选修复正例和真实字幕/失败/时钟验证通过,未证实设备不得冒充通过 H done
PKG-JASSUB-08 artplayer-plugin-jassub
修复默认 offscreen 初始化消息顺序
PKG-JASSUB-07 在释放排队绘制消息前转移初始画布;独立 vendor 补丁、默认模式原生回归和维护文档 保留默认能力选择、Worker/资源和公开同步 API;旧红新绿消息顺序测试及真实默认 offscreen 播放/seek/全屏通过,主线程绘制保持 H done
PKG-JASSUB-09 artplayer-plugin-jassub
修复 hybrid 迟到绘制与销毁后画布重建
PKG-JASSUB-08 释放旧混合绘制 bitmap,不改变新模式的画布/时钟;销毁后切字幕不重新分配画布;来源补丁、原生排队消息及维护记录 旧红新绿验证旧帧不能重建画布/解除新绘制等待;正常 hybrid 绘制保持;真实 Worker/ImageBitmap 交错、主线程及默认模式回归通过,能力缺口明确 H doing
PKG-JASSUB-10 artplayer-plugin-jassub
释放绘制异常后的整批 ImageBitmap
PKG-JASSUB-08 主线程异步绘制异常时释放整批位图;同步路径保持;原生异常/恢复测试和可逆vendor补丁记录 旧红新绿验证清屏、尺寸和首/后续绘制异常的释放及原异常传播;真实Worker位图和原生Canvas异常后恢复字幕;源码/main/legacy回归、类型、来源及构建通过 M done

5 包迁移:artplayer-plugin-danmuku-mask

ID 范围 / 步骤 前置依赖 交付物 验收条件 风险 状态
PKG-MASK-01 artplayer-plugin-danmuku-mask
核对包契约与历史用法
BASE-05 模型参数、start/stop、默认下载路径及 mask 样式 源码/声明/README/demo/发布包差异已登记;公开形状和版本范围冻结;接续 SDK-08,分别核实 Yarn 解析版本、未固定版本的模型 solutionPath 和资源来源 H done
PKG-MASK-02 artplayer-plugin-danmuku-mask
建立特有行为与错误测试
PKG-MASK-01, ENG-03, ENG-05 加载期间停止/销毁、重复启动、推理失败、WebGL/CPU 边界 旧版本行为可重跑,成功/失败/切源/销毁有必要断言 H done
PKG-MASK-03 artplayer-plugin-danmuku-mask
整理内部职责与资源
PKG-MASK-02, CORE-18, PKG-DANMUKU-07 模型加载/推理/画布输出分离,阻止重叠推理与过期写入 结构变化和缺陷修复分开记录;原 API/事件/资源生命周期通过 H done
PKG-MASK-04 artplayer-plugin-danmuku-mask
迁移自有源码和公开类型
PKG-MASK-03, ENG-04, ENG-06, CORE-07 模型 adapter、canvas 和选项的精确类型 严格类型检查、旧消费样例通过;声明路径/导出和同步异步兼容 H done
PKG-MASK-05 artplayer-plugin-danmuku-mask
验证新旧核心和组合
PKG-MASK-04, CORE-22 真实模型和 danmuku/seek/全屏组合,GPU 资源释放 最终核心与原支持范围核心分别通过;设备/SDK 缺证据不能标完成 H doing
PKG-MASK-06 artplayer-plugin-danmuku-mask
验证分发并同步文档
PKG-MASK-05, ENG-07, PKG-DANMUKU-MASK-LOAD-01 danmuku.mask.js、资源版本/许可、CPU fallback 和包体积证据 tarball 入口/资源、类型、8082 demo 和 README 一致,有回退记录 H todo

5 包迁移:artplayer-plugin-asr

ID 范围 / 步骤 前置依赖 交付物 验收条件 风险 状态
PKG-ASR-01 artplayer-plugin-asr
核对包契约与历史用法
BASE-05 length/interval/sampleRate/onAudioChunk、append/hide/stop 的真实能力 源码/声明/README/demo/发布包差异已登记;公开形状和版本范围冻结 H done
PKG-ASR-02 artplayer-plugin-asr
建立特有行为与错误测试
PKG-ASR-01, ENG-03, ENG-05 PCM/WAV、chunk 时序、回调慢/拒绝、重复初始化与停止 旧版本行为可重跑,成功/失败/切源/销毁有必要断言 H done
PKG-ASR-03 artplayer-plugin-asr
整理内部职责与资源
PKG-ASR-02, CORE-10, CORE-18 AudioContext/Worklet/Stream 生命周期和背压分离 结构变化和缺陷修复分开记录;原 API/事件/资源生命周期通过 H done
PKG-ASR-04 artplayer-plugin-asr
迁移自有源码和公开类型
PKG-ASR-03, ENG-04, ENG-06, CORE-07 主线程/Worklet/音频 buffer 与异步回调类型 严格类型检查、旧消费样例通过;声明路径/导出和同步异步兼容 H done
PKG-ASR-05 artplayer-plugin-asr
验证新旧核心和组合
PKG-ASR-04, CORE-22, PKG-ASR-07, PKG-ASR-08, PKG-ASR-09, PKG-ASR-10 真实 WebAudio 分块、播放暂停/切源/销毁,不引入网络 ASR 最终核心与原支持范围核心分别通过;设备/SDK 缺证据不能标完成 H doing
PKG-ASR-06 artplayer-plugin-asr
验证分发并同步文档
PKG-ASR-05, ENG-07 asr.js、Worklet 资源、输出格式与声明证据 tarball 入口/资源、类型、8082 demo 和 README 一致,有回退记录 H todo
PKG-ASR-07 artplayer-plugin-asr
修复原生播放音量二次衰减
PKG-ASR-04 移除重复音量应用;保留新旧原生音频振幅对照及正式产物验收 Chromium/Firefox 两核心和 source/main/legacy 输出音量线性、静音和 stop/restart 正确;旧版平方衰减单独保留;单元/类型/真实安装通过,不代替设备验收 H done
PKG-ASR-08 artplayer-plugin-asr
修复捕获回退重复播放与静音漏声
PKG-ASR-07 捕获回退静音输出图、非零PCM与外部播放归属;真实红绿证据及产物验证 已进入回退后不产生额外输出、静音不漏声、外部播放图不被关闭、stop/restart/换源清理正确;明确Firefox受控拒绝不代表自然选择回退 H done
PKG-ASR-09 artplayer-plugin-asr
提供显式捕获归属并取消过期切源重启
PKG-ASR-04, PKG-ASR-08 保留默认API的capture模式、精确runtime类型、可取消重启和原生外部归属/CORS证据 显式模式零直接绑定、不增加输出、拥有资源正确清理;Firefox不强制异常,CORS无绕过;旧工厂类型保持;延迟关闭期间pause/stop取消旧重启 H done
PKG-ASR-10 artplayer-plugin-asr
媒体错误取消过期识别并释放捕获资源
PKG-ASR-09 原生媒体错误取消、延迟加载/关闭回归、安装产物恢复与维护文档 旧红新绿证明错误后旧识别不显示、无新采集;捕获图释放,直接图保留合法回放归属;新旧核心实际错误与恢复通过,销毁移除监听 H done

5 包迁移:artplayer-plugin-ads

ID 范围 / 步骤 前置依赖 交付物 验收条件 风险 状态
PKG-ADS-01 artplayer-plugin-ads
核对包契约与历史用法
BASE-05 核对 npm 1.0.0~1.0.6 与未发布工作区 2.1.0 的真实参数、类型、结果、倒计时、分发和旧核心来源 源码/声明/README/demo/发布包差异已登记;公开形状和版本范围冻结 H done
PKG-ADS-02 artplayer-plugin-ads
建立特有行为与错误测试
PKG-ADS-01, ENG-03, ENG-05 固定 npm 1.0.6 与工作区契约;HTML/视频/图片 HTML、跳过阈值、计时链、工厂复用、多实例、过早/重复方法、播放拒绝与销毁 旧版本行为可重跑,成功/失败/切源/销毁有必要断言 H done
PKG-ADS-03 artplayer-plugin-ads
整理内部职责与资源
PKG-ADS-02, CORE-10, CORE-13 配置/广告状态/计时/视图/主视频恢复分离,保留产品规则;资源与版本检查改用经验证的旧核心能力边界 结构变化和缺陷修复分开记录;原 API/事件/资源生命周期通过 H done
PKG-ADS-04 artplayer-plugin-ads
迁移自有源码和公开类型
PKG-ADS-03, ENG-04, ENG-06, CORE-07 兼容真实 html/video/url/i18n、旧 export= 与工作区 source/type 类型接受面;时长 string/number 漂移与未实现别名单独处置 严格类型检查、旧消费样例通过;声明路径/导出和同步异步兼容 H done
PKG-ADS-05 artplayer-plugin-ads
验证新旧核心和组合
PKG-ADS-04, CORE-22 本地广告 fixture、多实例、正常结束/跳过/销毁;核验历史关联核心 4.5.5、发布 5.4.1 与候选核心的实际归档/能力/媒体组合 最终核心与原支持范围核心分别通过;设备/SDK 缺证据不能标完成 H doing
PKG-ADS-06 artplayer-plugin-ads
验证分发并同步文档
PKG-ADS-05, ENG-07 ads.js/README/声明一致;旧 require(pkg).default、原 dist 路径、当前 callable/ESM/legacy 的隔离 tarball 及浏览器验收 tarball 入口/资源、类型、8082 demo 和 README 一致,有回退记录 H todo

5 包迁移:artplayer-plugin-vast

ID 范围 / 步骤 前置依赖 交付物 验收条件 风险 状态
PKG-VAST-01 artplayer-plugin-vast
核对包契约与历史用法
BASE-05 异步工厂、callback context、playUrl/playRes/init 与 SDK 版本;实际 npm 1.0.0 与未发布 1.2.0、SDK 1.21.0/1.21.2 的60成员归档和发布关联核心5.1.7 源码/声明/README/demo/发布包差异已登记;公开形状和版本范围冻结 H done
PKG-VAST-02 artplayer-plugin-vast
建立特有行为与错误测试
PKG-VAST-01, ENG-03, ENG-05 SDK 失败、重复初始化、广告事件、内容恢复和销毁竞态;发布 id/$container/eager 与工作区 lazy/config 覆盖、callback拒绝、加载中销毁、同毫秒多实例与晚到事件 旧版本行为可重跑,成功/失败/切源/销毁有必要断言 H done
PKG-VAST-03 artplayer-plugin-vast
整理内部职责与资源
PKG-VAST-02, CORE-10, CORE-13 SDK loader、IMA adapter、广告状态和 DOM 清理分离;保持发布 callback 别名,明确初始化冲突;核心终止与显式 destroy 后重建区分 结构变化和缺陷修复分开记录;原 API/事件/资源生命周期通过 H done
PKG-VAST-04 artplayer-plugin-vast
迁移自有源码和公开类型
PKG-VAST-03, ENG-04, ENG-06, CORE-07, PKG-VAST-07 IMA/context/Promise 真实类型,外部 SDK 动态对象限定边界;修复 @alugha/ima 声明依赖链,保留 export= 和 require.default 消费;同步错误声明的兼容决策单列 严格类型检查、旧消费样例通过;声明路径/导出和同步异步兼容 H done
PKG-VAST-05 artplayer-plugin-vast
验证新旧核心和组合
PKG-VAST-04, CORE-22 真实IMA广告播放、错误后主视频恢复、会话重建与销毁;核验npm5.1.7/npm5.4.0/候选5.4.1核心,VAST VPN外部脚本例外逐项记录,不将受控SDK当作实际IMA验收 最终核心与原支持范围核心分别通过;设备/SDK 缺证据不能标完成 H doing
PKG-VAST-06 artplayer-plugin-vast
验证分发并同步文档
PKG-VAST-05, ENG-07 vast.js、SDK 资源、声明消费和独立版本记录;核验实际发布 namespace default、历史深路径、ESM和准确声明,版本按政策2.0.0由REL-09统一处理 tarball 入口/资源、类型、8082 demo 和 README 一致,有回退记录 H todo
PKG-VAST-07 artplayer-plugin-vast
恢复旧发布VAST工厂default调用入口
PKG-VAST-01, PKG-VAST-02 保留当前直接工厂并增加default自身别名,验证四类分发调用及异步注册,初始化决策独立保留 旧产物default用例失败,新源码/实际main/legacy/ESM通过;真实核心三浏览器控制SDK注册验证、模块文档/构建/测试入口同步;不冒充namespace反射、声明和IMA验收 M done

5 包迁移:artplayer-plugin-chromecast

ID 范围 / 步骤 前置依赖 交付物 验收条件 风险 状态
PKG-CAST-01 artplayer-plugin-chromecast
核对包契约与历史用法
BASE-05 url/sdk/icon/mimeType、loader、会话、全局 SDK 与结果 源码/声明/README/demo/发布包差异已登记;公开形状和版本范围冻结 H done
PKG-CAST-02 artplayer-plugin-chromecast
建立特有行为与错误测试
PKG-CAST-01, ENG-03, ENG-05 SDK 脚本加载失败/重入、无设备/拒绝、重复实例与销毁 旧版本行为可重跑,成功/失败/切源/销毁有必要断言 H done
PKG-CAST-03 artplayer-plugin-chromecast
整理内部职责与资源
PKG-CAST-02, CORE-11, CORE-13 SDK singleton/实例订阅/会话与控件职责分离 结构变化和缺陷修复分开记录;原 API/事件/资源生命周期通过 H done
PKG-CAST-04 artplayer-plugin-chromecast
迁移自有源码和公开类型
PKG-CAST-03, ENG-04, ENG-06, CORE-07 Cast 能力 adapter、全局对象和元数据类型 严格类型检查、旧消费样例通过;声明路径/导出和同步异步兼容 H done
PKG-CAST-05 artplayer-plugin-chromecast
验证新旧核心和组合
PKG-CAST-04, CORE-22 stub 测试之外记录实际 Cast 设备会话、源更新和断开 最终核心与原支持范围核心分别通过;设备/SDK 缺证据不能标完成 H todo
PKG-CAST-06 artplayer-plugin-chromecast
验证分发并同步文档
PKG-CAST-05, ENG-07 chromecast.js、SDK URL/权限能力及待支持环境说明 tarball 入口/资源、类型、8082 demo 和 README 一致,有回退记录 H todo

5 包迁移:artplayer-plugin-document-pip

ID 范围 / 步骤 前置依赖 交付物 验收条件 风险 状态
PKG-DPIP-01 artplayer-plugin-document-pip
核对包契约与历史用法
BASE-05 width/height/placeholder/fallbackToVideoPiP、open/close/toggle 返回 源码/声明/README/demo/发布包差异已登记;公开形状和版本范围冻结 H done
PKG-DPIP-02 artplayer-plugin-document-pip
建立特有行为与错误测试
PKG-DPIP-01, ENG-03, ENG-05 不支持/拒绝、重复打开、pagehide、核心销毁和视频 PiP fallback 旧版本行为可重跑,成功/失败/切源/销毁有必要断言 H done
PKG-DPIP-03 artplayer-plugin-document-pip
整理内部职责与资源
PKG-DPIP-02, CORE-16, CORE-17 窗口生命周期、DOM 迁移、样式与事件 document 重绑分离 结构变化和缺陷修复分开记录;原 API/事件/资源生命周期通过 H done
PKG-DPIP-04 artplayer-plugin-document-pip
迁移自有源码和公开类型
PKG-DPIP-03, ENG-04, ENG-06, CORE-07 Document PiP 可选能力和真实状态/返回类型 严格类型检查、旧消费样例通过;声明路径/导出和同步异步兼容 H done
PKG-DPIP-05 artplayer-plugin-document-pip
验证新旧核心和组合
PKG-DPIP-04, CORE-22, PKG-CANVAS-04, PKG-MB-04 原生视频及两个 proxy、键盘/焦点/全屏与关闭还原 最终核心与原支持范围核心分别通过;设备/SDK 缺证据不能标完成 H doing
PKG-DPIP-06 artplayer-plugin-document-pip
验证分发并同步文档
PKG-DPIP-05, ENG-07 document.pip.js、浏览器能力矩阵、旧接口与恢复证据 tarball 入口/资源、类型、8082 demo 和 README 一致,有回退记录 H todo

5 包迁移:artplayer-plugin-danmuku

ID 范围 / 步骤 前置依赖 交付物 验收条件 风险 状态
PKG-DANMUKU-01 artplayer-plugin-danmuku
核对弹幕全部公开契约
BASE-05 emit/load/config/hide/show/reset/mount、option/isHide/isStop/icons 与事件清单 源码、声明、发布包、Bilibili 输入和设置入口对照 H done
PKG-DANMUKU-02 artplayer-plugin-danmuku
建立弹幕算法与浏览器基线
PKG-DANMUKU-01, ENG-05, ENG-08 密集/稀疏弹幕、过滤/异步输入、seek/倍率/重载测试 轨道选择、发射顺序、事件、内存和可视结果可重跑 H done
PKG-DANMUKU-03 artplayer-plugin-danmuku
整理加载、解析与配置
PKG-DANMUKU-02, CORE-08 bilibili/input/parser/config 的分层与取消 旧格式、回调、过滤、追加/替换语义保持 M done
PKG-DANMUKU-04 artplayer-plugin-danmuku
整理时钟、队列与轨道调度
PKG-DANMUKU-03, CORE-10 danmuku 调度器和确定性时钟测试 seek/暂停/倍率/长时间运行无顺序和碰撞回归 H done
PKG-DANMUKU-05 artplayer-plugin-danmuku
整理 DOM 渲染、设置、热力图与 worker
PKG-DANMUKU-04, CORE-14, CORE-18 renderer/setting/heatmap/worker 职责及资源归属 mount/icons/设置和 worker 协议保持,销毁无后台工作 H done
PKG-DANMUKU-06 artplayer-plugin-danmuku
迁移 TS 与公开声明
PKG-DANMUKU-05, ENG-04, ENG-06 自有模块、worker 消息、option/item/result 类型 旧参数、扩展字段和事件消费通过,vendored 边界清楚 H done
PKG-DANMUKU-07 artplayer-plugin-danmuku
弹幕能力稳定性验收
PKG-DANMUKU-06, PKG-DANMUKU-10, PKG-DANMUKU-11, PKG-DANMUKU-12 负载/渲染/资源对比及 mask 可依赖的稳定边界 在试点核心中旧插件 API 与关键帧路径通过 H done
PKG-DANMUKU-08 artplayer-plugin-danmuku
完成新旧核心与组合验收
PKG-DANMUKU-07, CORE-22 最终核心/旧核心、mask/fullscreen/PiP 组合报告 性能无未解释退化,反复装卸无累计资源 H doing
PKG-DANMUKU-09 artplayer-plugin-danmuku
完成分发、示例与文档
PKG-DANMUKU-08, ENG-07, PKG-DANMUKU-MASK-LOAD-01 danmuku.js、README、声明、worker 与产物 tarball 和静态 icons 等旧调用通过,有独立回退版本 H todo
PKG-DANMUKU-10 artplayer-plugin-danmuku
修复 issue958 密集热力图过高与曲线裁平
PKG-DANMUKU-05 自动密度缩放与曲线边界、历史自定义坐标兼容及真实浏览器红绿证据 16000条三种分布在两核心三引擎和source/main/legacy不遮挡;显式轴和自定义points保持旧解释,有单独commit M done
PKG-DANMUKU-11 artplayer-plugin-danmuku
修复 Worker 隐藏等待吞掉可见寿命
PKG-DANMUKU-06 成功放置时的可见计时与延迟回复回归 真实 Worker 延迟下完整显示寿命;保留暂停/回收/取消和公开契约 M done
PKG-DANMUKU-12 artplayer-plugin-danmuku
保持异步放置期间的原生帧采样与寿命维护
PKG-DANMUKU-11 每帧采样与串行dispatcher、代际buffer及回归 异步等待不丢已到时采样、不延迟既有寿命维护;保留顺序、取消与公开readys窗口 H done

5 包迁移:artplayer-proxy-canvas

ID 范围 / 步骤 前置依赖 交付物 验收条件 风险 状态
PKG-CANVAS-01 artplayer-proxy-canvas
核对包契约与历史用法
BASE-05 callback、canvas 原方法、转发 media 属性/方法/事件 源码/声明/README/demo/发布包差异已登记;公开形状和版本范围冻结 H done
PKG-CANVAS-02 artplayer-proxy-canvas
建立特有行为与错误测试
PKG-CANVAS-01, ENG-03, ENG-05 ready/loadeddata/canplay、play/seek、回调、resize 与销毁 旧版本行为可重跑,成功/失败/切源/销毁有必要断言 H done
PKG-CANVAS-03 artplayer-proxy-canvas
整理内部职责与资源
PKG-CANVAS-02, CORE-06, CORE-11, CORE-16 video adapter/原 canvas 方法/RAF 绘制/事件订阅分离 结构变化和缺陷修复分开记录;原 API/事件/资源生命周期通过 H done
PKG-CANVAS-04 artplayer-proxy-canvas
迁移自有源码和公开类型
PKG-CANVAS-03, ENG-04, ENG-06, CORE-07 canvas 与媒体能力的精确组合类型,保持 Result 严格类型检查、旧消费样例通过;声明路径/导出和同步异步兼容 H done
PKG-CANVAS-05 artplayer-proxy-canvas
验证新旧核心和组合
PKG-CANVAS-04, CORE-22, PKG-DPIP-04, PKG-FACTORY-01, PKG-CANVAS-SUBTITLE-01 真实 video/canvas 绘制、字幕和 document PiP 恢复 最终核心与原支持范围核心分别通过;设备/SDK 缺证据不能标完成 H doing
PKG-CANVAS-06 artplayer-proxy-canvas
验证分发并同步文档
PKG-CANVAS-05, ENG-07 canvas.js、三种产物、调用兼容与资源证据 tarball 入口/资源、类型、8082 demo 和 README 一致,有回退记录 H todo
PKG-CANVAS-SUBTITLE-01 artplayer-proxy-canvas
修复 Canvas 代理原生字幕轨道挂载
PKG-CANVAS-04 初始字幕能力、原生轨道挂载与资源生命周期适配及新旧核心回归 复现旧字幕 cues 为空;新旧核心加载、寻址、切换、销毁通过;普通 Canvas 节点行为和分发入口保持兼容 M done

5 包迁移:artplayer-proxy-mediabunny

ID 范围 / 步骤 前置依赖 交付物 验收条件 风险 状态
PKG-MB-01 artplayer-proxy-mediabunny
核对 shim 与媒体契约
BASE-05 全部 option、art.mediabunny、canvas/shim 属性及事件表 公开暴露成员和实际发布依赖/资源范围明确;核实 third-party.json 所记录依赖 MPL-2.0 元数据与实际 bundle 的许可/通知范围,不从根 MIT 推断 H done
PKG-MB-02 artplayer-proxy-mediabunny
建立真实媒体与事件基线
PKG-MB-01, ENG-05, ENG-08 MP4/WebM/HLS/Blob/Stream、seek/错误/轨道切换样本 ready 事件顺序、音画同步、超时和释放可重跑 H done
PKG-MB-03 artplayer-proxy-mediabunny
整理 input 与加载取消
PKG-MB-02, CORE-09 input.js 源检测、输入资源、Range 与取消 HLS 检测在 input 边界,旧来源类型和超时保持 H done
PKG-MB-04 artplayer-proxy-mediabunny
整理 VideoShim/EventTarget/Engine 协调
PKG-MB-03, CORE-06, CORE-11 shim 描述符、事件桥、加载状态和操作隔离 公开属性/同步异步返回与事件重入顺序保持 H done
PKG-MB-05 artplayer-proxy-mediabunny
整理视频解码、seek 和帧释放
PKG-MB-04 VideoEngine 调度、队列、晚帧处理和资源释放 暂停/seek/切源无旧帧覆盖,默认丢帧策略不变 H done
PKG-MB-06 artplayer-proxy-mediabunny
整理音频解码、时钟与同步
PKG-MB-04 AudioEngine 时钟、缓冲和 AudioContext 归属 AV sync、倍速、无音轨、静音/音量和暂停恢复通过 H done
PKG-MB-07 artplayer-proxy-mediabunny
整理 HLS 配对轨道与 selector
PKG-MB-05, PKG-MB-06, CORE-14 m3u8 配对、质量/音频选择及拓扑清理 实际选择高亮、切到无轨道来源清理、无重复 readiness H done
PKG-MB-08 artplayer-proxy-mediabunny
完成 TS 与媒体能力声明
PKG-MB-07, ENG-04, ENG-06 8 个自有 JS 模块迁移与 Result/shim 类型 解码器/Stream/DOM 类型清楚,旧 Option 和 art.mediabunny 使用保持 H done
PKG-MB-09 artplayer-proxy-mediabunny
完成新旧核心和真实媒体组合
PKG-MB-08, CORE-22 跨浏览器能力、长播放、DPiP、HLS 音轨/质量报告 资源释放、事件顺序、AV sync 与支持范围满足基线 H doing
PKG-MB-10 artplayer-proxy-mediabunny
完成分发和文档
PKG-MB-09, ENG-07 mediabunny.js、README、依赖版本、三产物和许可; 拆分media声明后的独立编辑器生成/辅助文件过滤与语义检查(IFRAME-04全量生成时暴露) tarball 可消费、无意外依赖升级、旧调用与回退可用 H todo

5 包迁移:artplayer-tool-iframe

ID 范围 / 步骤 前置依赖 交付物 验收条件 风险 状态
PKG-IFRAME-01 artplayer-tool-iframe
核对包契约与历史用法
BASE-05 constructor/commit/message/inject、postMessage 协议与历史公开拼写 源码/声明/README/demo/发布包差异已登记;公开形状和版本范围冻结 H done
PKG-IFRAME-02 artplayer-tool-iframe
建立特有行为与错误测试
PKG-IFRAME-01, ENG-03, ENG-05 跨窗口消息、ID 匹配、请求失败、重复 inject、销毁中请求 旧版本行为可重跑,成功/失败/切源/销毁有必要断言 H done
PKG-IFRAME-03 artplayer-tool-iframe
整理内部职责与资源
PKG-IFRAME-02, CORE-02, BASE-07 请求注册/响应匹配/监听清理分离;origin/source 安全边界独立决策 结构变化和缺陷修复分开记录;原 API/事件/资源生命周期通过 H done
PKG-IFRAME-04 artplayer-tool-iframe
迁移自有源码和公开类型
PKG-IFRAME-03, ENG-04, ENG-06, CORE-07 消息联合类型、回调/Promise 推导、旧公开字段兼容;旧npm export=与实际namespace、额外helper协议分别核验 严格类型检查、旧消费样例通过;声明路径/导出和同步异步兼容 H done
PKG-IFRAME-05 artplayer-tool-iframe
验证新旧核心和组合
PKG-IFRAME-04, CORE-22 真实同源/跨源 iframe、既有 commit 协议;安全变化有独立结论;新旧核心/demo、实际 BFCache/设备和外部中断导航验收,旧端无文档标记的限制明确 最终核心与原支持范围核心分别通过;设备/SDK 缺证据不能标完成 H doing
PKG-IFRAME-06 artplayer-tool-iframe
验证分发并同步文档
PKG-IFRAME-05, ENG-07 iframe.js、示例集成和原 script/class 导出验证;旧包名/额外helper深入口与新工具名的迁移结论; 保留旧npm Function回调及namespace/helper与工具类的区别,核验实际编译后消费而非仅声明通过 tarball 入口/资源、类型、8082 demo 和 README 一致,有回退记录 H todo

5 包迁移:artplayer-tool-thumbnail

ID 范围 / 步骤 前置依赖 交付物 验收条件 风险 状态
PKG-TOOL-THUMB-01 artplayer-tool-thumbnail
核对包契约与历史用法
BASE-05 构造/defaults/事件/方法/历史拼写、.esm.js 入口和缺失 types 源码/声明/README/demo/可恢复发布内容差异已登记;公开形状和版本范围冻结;区分旧 npm 的 main/CSS 与当前工作区无 main、.esm.js/类型缺失,不把工作区状态冒称旧 npm 发布事实 H done
PKG-TOOL-THUMB-02 artplayer-tool-thumbnail
建立特有行为与错误测试
PKG-TOOL-THUMB-01, ENG-03, ENG-05 文件输入/拖放、抽帧网格、begin/end、进度/失败/重复任务 旧版本行为可重跑,成功/失败/切源/销毁有必要断言 H done
PKG-TOOL-THUMB-03 artplayer-tool-thumbnail
整理内部职责与资源
PKG-TOOL-THUMB-02, CORE-01 输入、抽帧队列、网格导出、URL/监听清理分离 结构变化和缺陷修复分开记录;原 API/事件/资源生命周期通过 H done
PKG-TOOL-THUMB-04 artplayer-tool-thumbnail
迁移自有源码和公开类型
PKG-TOOL-THUMB-03, ENG-04, ENG-06, CORE-07 补齐真实 API 声明,自有 emitter/utils TS 化 严格类型检查、旧消费样例通过;声明路径/导出和同步异步兼容;为 BASE-DIST-01 提供兼容入口/声明及消费者验证 H doing
PKG-TOOL-THUMB-05 artplayer-tool-thumbnail
验证新旧核心和组合
PKG-TOOL-THUMB-04, CORE-22 工具独立浏览器使用,生成缩略图在核心中显示 最终核心与原支持范围核心分别通过;设备/SDK 缺证据不能标完成 H todo
PKG-TOOL-THUMB-06 artplayer-tool-thumbnail
验证分发并同步文档
PKG-TOOL-THUMB-05, ENG-07 tool.thumbnail.js、历史 ESM 兼容文件、types 路径和 tarball tarball 入口/资源、类型、8082 demo 和 README 一致,有回退记录 H todo

6 文档与消费者

ID 范围 / 步骤 前置依赖 交付物 验收条件 风险 状态
SITE-01 artplayer-vitepress, workspace
清点文档/示例/生成链
BASE-04, BASE-05 中英文文档、插件页面、demo URL、编辑器声明与生成目录清单;六类 HTML 入口、prod/libs/code/example 加载行为及移动重定向 所有公开 API/插件有对应页面或明确补充任务;核实 BASE-DEMO-01 的历史 thumbnail 插件来源及 29 示例/36 HTML 路径;明确 BASE-05 所记录站点实际分发与未设 private 的 manifest 意图;接续 VENDOR-05/06/07/08 和 BASE-SITE-01/BASE-MEDIA-01,核对字体、Monaco、vConsole、console bundle 与样本来源及分发范围 M done
SITE-SMOKE-01 artplayer-vitepress, workspace
迁移示例生成器并验证真实就绪与清理
SITE-01 TS Markdown 解析/生成与浏览器运行模块;旧命令和 URL、稳定实例就绪 smoke、错误与资源清理 复现旧 malformed 死循环并保证有限失败;保留全部既有示例内容、生成确定且 check 只读;不再以 100ms 作为成功,验证原生就绪、异常、取消与清理;三浏览器检查,明确延迟交互与全部 233 示例仍需 EX-03 M done
SITE-02 artplayer-vitepress
整理声明与示例生成器
SITE-01, ENG-04, ENG-06, SITE-SMOKE-01 build-ts/build-test 生成链的可验证 TS 脚本 不靠字符串拼接掩盖声明错误,生成示例有真实断言或仅标 smoke;替换固定 100ms 成功判定,明确异步错误、清理和生成覆盖限制;坏代码块解析必须终止,覆盖 malformed 分支不推进 regexp 的回归 M done
SITE-LOAD-01 artplayer-vitepress, workspace
修复文档示例加载顺序与导航边界
SITE-02 共享 TS loader、移动入口与 Run Code/语言路由,保留 URL 和使用方式 旧版复现 define 丢失和依赖乱序;真实浏览器验证成功/失败恢复、顺序、去重、编码/优先级及 localhost/127 路由和语言跳转;不以此替代 SITE-03 构建/翻译流程 M done
SITE-AI-DOCS-01 artplayer-vitepress, workspace
重构可复现 LLM 文档与安全翻译草稿流程
SITE-LOAD-01, SITE-02 TS 离线文档聚合、显式远程翻译、草稿校验和可回退应用,保留命令与目标路径 默认不读密钥/调用网络;LLM 内容可复现并保留来源;旧翻译破坏性行为有复现;错误/限流/超时/结构损坏/过期/路径越界拒绝且英文文档不丢失;未执行付费翻译不计服务验收 M done
SITE-BUILD-01 artplayer, artplayer-vitepress, workspace
重构 i18n 与文档构建的暂存、替换和 Yarn 编排
SITE-AI-DOCS-01 严格 TS 构建模块、编译后替换产物与失败回退,固定 Yarn 子进程和旧构建入口 旧 i18n 删除后失败有复现;失败不改变既有产物;语言集合、UMD/ESM/历史别名兼容;文档子进程退出码准确并完成真实 VitePress 构建;不隐式翻译、不修改播放器 API M done
SITE-03 artplayer-vitepress
整理 i18n/文档/LLM 生成流程
SITE-02, SITE-LOAD-01, SITE-AI-DOCS-01, SITE-BUILD-01 build-i18n/build-docs/build-llm/trans-docs 的任务边界和错误处理;桌面 common.js 自有 UI 的 TS 迁移与模块拆分 原命令兼容、生成可复现,翻译步骤不隐式运行远程服务;覆盖移动 loader 失败恢复 define、脚本依赖顺序、localhost/127.0.0.1 Run Code 目标和语言重定向;桌面剩余 UI 完成 TS 职责拆分并回归运行、导入与持久设置 M done
SITE-04 artplayer-vitepress
交叉核对逐包持续维护的文档
CORE-21, SITE-03, PKG-CHAPTER-04, PKG-AMBILIGHT-04, PKG-AUDIO-04, PKG-AUTO-THUMB-04, PKG-VTT-THUMB-04, PKG-HLS-04, PKG-DASH-04, PKG-MULTI-SUB-04, PKG-JASSUB-04, PKG-MASK-04, PKG-ASR-04, PKG-ADS-04, PKG-VAST-04, PKG-CAST-04, PKG-DPIP-04, PKG-CANVAS-04, PKG-IFRAME-04, PKG-TOOL-THUMB-04, PKG-DANMUKU-06, PKG-MB-08 已随实现更新的中文/英文 API、包内实现地图、旧 JS 示例及已知能力限制的全包核对 未把缺环境的能力写成已验证,静态核对不等待设备任务;最终 demo 仍由 EX-03 验收;按 SITE-01 声明成员/候选标题清单逐项语义核对,补齐缺失的双语插件说明和 Danmuku 英文入口 M todo
SITE-05 artplayer-vitepress
构建文档站和验证链接/示例
SITE-04, EX-01, EX-02, SITE-07, SITE-VCONSOLE-01, SITE-CONSOLE-01 VitePress 构建、链接与嵌入 demo 检查 文档构建、链接、嵌入路径与声明注入通过;真实完整 demo 保留 EX-03 独立门槛;核对 ENG-PM-01 登记的搜索 peer 范围和真实搜索行为 M todo
SITE-06 artplayer-vitepress
文档站交付验收
SITE-05 维护指南和站点变更记录 未手改 generated 目录,旧 URL 可用、部署与检查分离 M todo
SITE-07 artplayer-vitepress, workspace
整理站点第三方资产与来源说明
SITE-01 Monaco/vConsole/console bundle/字体和样本的冻结来源、可复现构建或替代与站点 notices 接续 SITE-01 的字节与换行差异证据;完整许可随实际分发,consoleLog/global/CSS/worker 与旧 URL 兼容;缺字体/媒体使用依据明确处置;资产变更后执行编辑器/移动/字幕/示例回归,不以来源指纹替代授权或运行证据 H doing
EX-01 example/react.js, workspace
验证 React 消费者与 TS
CORE-22, ENG-07 React 挂载/卸载/重挂载、引用和插件样例 真实 tarball + TS 消费通过,保留既有 React 集成 API M done
EX-02 example/vue.js, workspace
验证 Vue 消费者与更新卸载
CORE-22, ENG-07 Vue 实例/ref、参数更新、卸载及插件样例 旧 JS 组件用法无需修改,重复挂载不泄漏 M done
EX-03 workspace
验证全部原生 demo 与外部播放集成
EX-01, EX-02, PKG-CHAPTER-06, PKG-AMBILIGHT-06, PKG-AUDIO-06, PKG-AUTO-THUMB-06, PKG-VTT-THUMB-06, PKG-HLS-06, PKG-DASH-06, PKG-MULTI-SUB-06, PKG-JASSUB-06, PKG-MASK-06, PKG-ASR-06, PKG-ADS-06, PKG-VAST-06, PKG-CAST-06, PKG-DPIP-06, PKG-DANMUKU-09, PKG-CANVAS-06, PKG-MB-10, PKG-IFRAME-06, PKG-TOOL-THUMB-06 8082 全 demo、HLS/DASH/FLV/MPEGTS/WebTorrent 集成记录 旧 URL/参数/脚本加载保持;网络/SDK 限制明确,不静默跳过;覆盖编辑器重复 Run 和 ESM/i18n/mobile/iframe,记录实际候选脚本及状态隔离证据;依据 BASE-04 路径台账逐项消除 not-run,处理 BASE-DEMO-01 H todo
SITE-VCONSOLE-01 artplayer-vitepress, workspace
修复 vConsole 日志帧与延迟面板销毁竞态
SITE-01 冻结上游 bundle 的可复现 TS 生命周期补丁、旧红新绿回归、来源及生成检查;销毁后虚拟列表布局续段停止 最后日志插件移除后取消 RAF 并隔离旧队列;延迟面板不得写入已销毁或替换插件;三引擎移动页与 UMD 入口通过,维护声明与原有许可缺口分别记录;原生 ResizeObserver 布局与挂起 timer 旧红新绿 M done
SITE-CONSOLE-01 artplayer-vitepress, workspace
迁移控制台自有 TS 源码并修复日志生命周期
SITE-03 从冻结 console.js 恢复自有入口/视图的 TS 模块、受控第三方边界与可验证构建;修复滚动回调、多容器 hook 所有权和原生 Error 消息丢失 保留 consoleLog 返回组件、React/ReactDOM/Parcel 全局及 DOM/CSS/日志对象语义;旧版复现与候选正确行为分开验证;多容器、卸载/重挂、外部 hook、错误/滚动及真实编辑器组合通过;架构与生成文档同批更新,不以冻结 vendor 代替 SITE-07 许可闭环 H done

7 工具链与性能

ID 范围 / 步骤 前置依赖 交付物 验收条件 风险 状态
MOD-01 workspace
Bun 固定版本干净安装试点
ENG-09 独立目录的 Bun 安装与 Yarn 冻结基线对比,默认仍为用户选定的 Yarn Node 测试仍通过;安装与资源一致才决定采用;不改 bundler;不自动替换默认 packageManager 或维护锁文件 H done
MOD-PLUGIN-01 workspace
迁移插件生成器与类型化模板
ENG-06, SITE-03 保留 create:plugin CLI;纯渲染/文件发布边界、TS 工厂/声明/测试/示例及维护指南 防止覆盖现有包或示例;失败回退;生成包可构建并通过严格类型、旧模块消费及测试;不自动修改既有包或运行安装发布 M done
MOD-02 workspace
整理剩余开发/构建脚本与插件模板
ENG-06, SITE-03, MOD-PLUGIN-01 dev/build/utils/create-plugin 的 TS 与可测 CLI,模板同时提供旧 API 旧脚本入口保留、新插件类型/测试/示例齐全,Lerna 改动单独取证 M done
MOD-DEV-01 workspace
修复开发服务器失败状态并明确资源生命周期
MOD-02 修复 Servor 占用端口却退出 0 的已复现问题;明确 HTTP/监听/热刷新连接与定时器的启动、失败和关闭责任 保持默认 8082、docs 页面、自动刷新和旧 dev 命令;端口冲突退出非零且不终止其他服务,连续启动/停止及编译错误恢复有实际验证;跨平台监听差异单独留证 M done
MOD-03 workspace
测量并优化核心热路径
CORE-22, ENG-08 DOM 读写、进度更新、持久化、初始化的测量与改进 相同设备媒体多次比较,契约不变,收益及无效尝试记录;复用 BASE-06 的原始样本与测量限制,至少三组同环境旧新配对,不以单次变快宣称收益 M done
MOD-04 workspace
测量并优化重型插件/proxy
PKG-DANMUKU-09, PKG-MASK-06, PKG-MB-10, ENG-08 帧/队列/推理/音画同步与资源长期运行比较 不改默认算法/阈值,性能改善有证据;无收益则保留旧实现 M todo
MOD-05 workspace
完成工具链与性能采用决策
MOD-01, MOD-02, MOD-03, MOD-04, MOD-DEV-01 最终 runtime/packageManager/构建配置及性能台账 干净安装和全包检查通过;Bun 未采用有理由,不为状态强行切换 M todo

8 发布验收

ID 范围 / 步骤 前置依赖 交付物 验收条件 风险 状态
REL-08 workspace
提前建立逐包发布准入台账
BASE-08, ENG-07 每批包/版本/源码/锁文件/工具/tarball integrity、必需测试/设备证据、限制和回退映射 受影响能力缺证据明确阻止对应批次;无关批次可独立准备,旧证据在候选内容变化后失效;站点采用真实构建/URL/资源验收,npm 分发依据历史核实,不从版本清单推断新增发布范围;关联 risks.json 和 third-party.json;受影响 bundle/worker/WASM/font/模型的来源与许可通知缺口必须有审查结论,未决项阻止对应批次 H done
REL-01 workspace
提前确定分包版本与差异方案
REL-08, CORE-21, SITE-03, PKG-CHAPTER-04, PKG-AMBILIGHT-04, PKG-AUDIO-04, PKG-AUTO-THUMB-04, PKG-VTT-THUMB-04, PKG-HLS-04, PKG-DASH-04, PKG-MULTI-SUB-04, PKG-JASSUB-04, PKG-MASK-04, PKG-ASR-04, PKG-ADS-04, PKG-VAST-04, PKG-CAST-04, PKG-DPIP-04, PKG-CANVAS-04, PKG-IFRAME-04, PKG-TOOL-THUMB-04, PKG-DANMUKU-06, PKG-MB-08, PKG-FACTORY-01 每包版本/变更日志/依赖/类型差异方案和独立准入状态;按 version-policy.md 冻结各包下一 major(minor/patch 归零)并核实 registry 占用 所有包有方案和剩余门槛,未决项明确阻止相应发布;本步骤不声称已经可发布;全部包有 major 目标,版本冲突明确处理,独立准备任务同步 manifest/锁/依赖/日志;按 BASE-05 区分 21 库与文档站分发,不机械把文档站当库上传 npm H todo
REL-09 workspace
落实全包下一 major 版本及依赖元数据
REL-01, DOC-11 22 包版本目标落实、适用锁文件/依赖范围/示例/变更日志同步,核实 registry 版本占用 版本与 policy 一致,旧核心支持保留;必要拆子任务各自提交,候选构建前完成,不执行 publish H todo
REL-02 workspace
生成候选 tarball 并验证新旧组合
REL-01, CORE-22, ENG-07, REL-09, REL-04 各候选本地 tarball/integrity 与新旧核心/插件消费者验证报告,外部门槛单独标注 隔离安装和可自动化组合通过;设备结论不伪造,最终发布绑定同一候选内容;在目标 major 版本确定后构建 pack,不在测试后改版本;逐包核验完整回退产物、实际候选版本/integrity、应用导入与冻结锁,重跑对应回退并保留报告;缺失历史分发不准入 H todo
REL-03 workspace
完成真机、外部 SDK 与压力验收
REL-02, EX-03, SITE-06, MOD-05 Safari/移动/PiP/Cast/IMA/模型/长播放完整报告 包集成与全项目真机/SDK/压力结论齐全才完成本汇总;独立批次先建立自己的完整门槛子任务 H todo
REL-04 workspace
提前演练回退与主线修复同步
REL-08, ENG-07 分包旧版本/tag/依赖回退方案与 master 差异 隔离包演练可回退,主线修复同步流程可执行;正式每批再核对其实际回退产物 H done
REL-05 workspace
经授权发布候选并收集反馈
REL-03, REL-04, REVIEW-03 候选 tag、完整产物 integrity、反馈与复现记录 实际发布授权/操作/版本可追溯;本计划不自动执行发布 H todo
REL-06 workspace
经授权分批正式发布
REL-05 正式分包版本/tag/站点文档及兼容公告 候选验收通过,安装/浏览器复核和回退入口就绪;候选反馈修复须独立建任务并复验三轮受影响结论,正式内容与最终验证产物一致 H todo
REL-07 workspace
关闭重构里程碑并维护后续队列
REL-06, ENG-LINT-01, ENG-LINT-02 最终任务/设计/证据归档和维护指南 全范围任务有结论、无未解释兼容缺口;遗留项有明确后续责任 L todo

8.1 多轮复盘

ID 范围 / 步骤 前置依赖 交付物 验收条件 风险 状态
REVIEW-01 workspace
第一轮全项目架构与兼容性复盘
REL-02, CORE-22, SITE-04, DOC-08, MOD-01, MOD-02, MOD-03, CORE-25, ENG-13 22 包结构、类型、旧 API/路径、测试盲区和维护文档的逐包报告 本轮阻断项由独立修复任务关闭并复测;环境缺口转交下一轮,不宣称已发布就绪 H todo
REVIEW-02 workspace
第二轮真实浏览器与生态集成复盘
REVIEW-01, REL-03 Chrome 交互、自动浏览器、新旧组合、真机/SDK/性能/资源的全范围报告 所需环境证据齐全,前轮修复再次核对;本轮阻断项关闭,无关 mock 不替代真实验收 H todo
REVIEW-03 workspace
第三轮 npm 候选内容与发布准备复盘
REVIEW-02, REL-04, CI-04 实际候选 integrity、干净安装构建/消费者、入口/许可/版本/tag/回退及前轮证据汇总 最终候选完整检查通过,发布阻断项为零;准备可审阅的批次报告,不自动执行 publish;逐包核对 major 目标,不能用大版本豁免旧 API 兼容 H todo

5 工厂类型兼容补审

ID 范围 / 步骤 前置依赖 交付物 验收条件 风险 状态
PKG-FACTORY-01 artplayer-proxy-canvas, artplayer-plugin-ambilight
修复已迁移工厂的反向赋值兼容
PKG-CANVAS-04, PKG-AMBILIGHT-04, PKG-DPIP-04 复现两包旧typeof工厂替换与新.default/可选重载冲突,修复公开类型并补安装消费者、产物和文档 默认工厂的历史合法反向赋值继续通过;既有类型/运行时导出逐版本核对,不能只验证Parameters或直接调用 H done

2 测试与工程基础

ID 范围 / 步骤 前置依赖 交付物 验收条件 风险 状态
ENG-12 workspace, artplayer
隔离库构建的 public 源码与分发内容
ENG-03, CORE-21 禁用库的隐式 public 复制,拒绝误入包内的 TS 源码,清理生成污染并验证真实构建 三格式真实构建和严格 tarball 检查通过;已有声明和所有剩余成员字节不变;文档站使用独立构建 M done

2 工程基础

ID 范围 / 步骤 前置依赖 交付物 验收条件 风险 状态
ENG-LINT-01 artplayer-plugin-danmuku-mask, workspace
修复 Mask manifest 排序并恢复全仓 lint
PKG-MASK-04 仅调整 manifest 字段顺序,独立验证全仓只读 lint 与元数据语义不变 根 lint 通过;解析后的 manifest 深度相等;不改包版本、依赖或公开入口 L done
ENG-13 workspace
保证性能资源探针的最小观察时长
ENG-08 性能页面按实测时钟补足既有350ms观察窗口,保留冻结基线和原校验门槛;时钟边界测试和实际安装包配对证据 349ms仍被拒绝;早到定时器补足观察、正常超时保留实际值;冻结计时样本逻辑未变,三浏览器实际350ms观察及资源校验通过 M done
ENG-LINT-02 artplayer-plugin-vast, artplayer, artplayer-vitepress, workspace
修复 VAST 清单与生成声明的 lint 遗留
PKG-VAST-04, SITE-02 仅整理 VAST 顶层元数据键顺序,并从声明生成源移除无效 lint 禁用项;保留入口与类型语义 全仓只读 lint 零错误零警告;VAST 元数据和嵌套条件键顺序不变;生成声明除注释外逐字一致,生成/只读检查通过 L done

5 包组合:Danmuku / Mask

ID 范围 / 步骤 前置依赖 交付物 验收条件 风险 状态
PKG-DANMUKU-MASK-LOAD-01 artplayer-plugin-danmuku, artplayer-plugin-danmuku-mask
修复真实Mask组合下的弹幕未采样与放置积压
PKG-DANMUKU-12, PKG-MASK-04, CORE-22 分阶段性能/采样诊断、兼容实现修复及新旧核心/产物回归 关闭真实模型组合5项密集负载失败和1项负载前漏显,保持回调顺序、显示寿命与生命周期取消;不能以降低负载或关闭模型制造通过 H done

完成证据与阻塞