ArtPlayer/refactor/changes/2026-09-10-DOC-07-plan-review.md

DOC-07 重构计划复审与执行顺序优化

• 日期：2026-09-10。
• 分支：codex/compatible-modernization。
• 基线提交：d7b348f3。
• 提交主题：docs(refactor): [DOC-07] improve sequencing and release gates。
• 范围：任务依赖、实施与发布门槛、测试策略及维护文档；未改生产源码。

发现与处理

问题	原计划证据	处理
试点太晚	PKG-CHAPTER-04 有 32 个递归前置任务，包含 CORE-14	chapter 03/04 改为依赖现有核心与工具；新增 PILOT-01，在 CORE-01 之前完成浏览器/类型/tarball 闭环
启动基线过大	BASE-01 要求各包 npm 历史基线，ENG-01 依赖它	BASE-01 先冻结核心和试点，其余发布证据在各包 01 步补齐
外部设备间接阻塞文档和候选准备	SITE-04 和 REL-01/02 祖先包含 PKG-CAST/VAST/DPIP/MASK-05	文档交叉核对依赖源码/类型步骤；候选准备依赖核心与构建；真实验收保留在包集成和发布门槛
环境与版本矩阵尚无独立任务	文档提出范围要求，但任务中没有完整字段和负责步骤	新增 BASE-08，区分格式、浏览器能力、真实设备、未知项和证据归属
初始 CI 可能因历史问题无法推进	已观察第三方类型冲突；全部包初始严格检查没有失败分类方案	新增 ENG-10，建立有复现证据的失败台账、逐模块严格门槛和偶发测试处理
缺少明确无障碍回归步骤	原核心测试强调热键，没有独立的可访问名称、焦点和键盘导航任务	新增 CORE-23，并加入最终核心验收依赖；不预断言页面存在已复现缺陷
发布台账与回退演练太晚	REL-01 等待 SITE/EX/MOD 全部完成，REL-04 等待全部真机验证	新增 REL-08 提前登记逐包准入；版本方案与回退演练提前，正式发布仍受实际范围门槛限制
工具链步骤存在无关依赖	MOD-02 的脚本整理必须等待 Bun 试点	移除该非必要依赖，最终 MOD-05 同时收敛工具与 Bun 结论

不变的要求

全部 22 包仍在范围内。保留每包旧支持范围核心和最终核心的集成验证、真实环境证据以及每任务独立提交。没有把被阻塞的测试改成通过，也没有新增推送或发布授权。

任务 ID 均保留，新增任务而不重排旧 ID 含义。已有完成任务的事实不重写。具体更新后的依赖与状态以 tasks.json 为准；父阶段编号不代表执行先后。

验证

• 运行 plan.mjs 的生成、同步、依赖无环、22 包覆盖和本地链接检查。
• 专项检查：PILOT-01 的祖先中没有 CORE；CORE-01 必须依赖试点；SITE-04、REL-01/02 不再间接依赖 Cast 等包的设备验收任务；REL-03 仍汇集最终外部验证。
• 所有既有任务 ID 保留，新增任务 ID 唯一，只有 DOC-07 新增完成状态；没有实施任务被标完成。
• 执行 git diff --check、暂存内容检查及提交后的 Git 状态/日志核对。

本轮没有运行生产或真实浏览器测试，因为生产代码未改。计划校验不代表播放器兼容性已通过。

后续和回退

下一项仍为 BASE-01，其工作量现在限定为可启动核心和试点的最小发布基线。按任务逐项实施、验证和提交。必要时独立回退 DOC-07 计划提交，不影响生产功能。