ArtPlayer/refactor/changes/2026-09-10-DOC-12-execution-readiness-review.md

DOC-12 开发前的计划复审

• 日期：2026-09-10；分支：codex/compatible-modernization；基线：9b9739ab。
• 提交主题：docs(refactor): [DOC-12] close execution and release planning gaps。
• 范围：计划依赖、验收定义及计划校验器；没有生产代码改动。

发现与修正

问题	证据	修正
首轮复盘重新被专项环境阻塞	REVIEW-01 -> MOD-05 -> MOD-04 -> PKG-MASK-06/05	首轮仅依赖 MOD-01/02/03，第二轮继续等待完整 MOD-05 和设备验收
全包版本落实只在文字中要求未来拆任务	REL-02 仅依赖版本方案，没有显式版本修改步骤	新增 REL-09，方案后落实 manifest/锁/依赖/日志，候选构建必须依赖它
BASE 使用浏览器证据，但正式服务在后续 ENG	ENG-05 依赖 BASE-04，ENG-08 依赖 BASE-06	明确基线使用旧包与最小可重跑探针，正式 ENG 接入，不引入反向依赖
同一产物标准不适用于所有 workspace	vitepress manifest 只有站点脚本，没有核心式 main/module/types 入口	BASE-05/REL-08 记录实际发布类别及替代验收；全部版本目标保持
契约和测试缺少强制对应关系	契约表、任务表和测试规范分别存在，但没有明确索引交付	BASE 开始登记，ENG-09 收敛契约/版本/测试 ID/报告/责任映射
SSR 容易被过度理解	核心 constructor 非浏览器明确抛错	分开 import、静态模板、浏览器挂载、非浏览器构造错误，不新增服务端播放器 API
校验只保证无环，不能发现语义依赖回退	之前首轮设备依赖通过了校验	plan.mjs 增加试点、首轮/次轮设备、版本/CI/复盘发布门槛和实施任务可达性检查

验证

计划生成/同步、22 包覆盖、本地链接、语义依赖及 Git 差异检查通过。校验器以故意加入首轮设备依赖、删除版本准备前置、移除 CI 门槛、加入依赖环的负例验证应失败；负例结束恢复原任务数据。node --check 通过。

原 209 项任务 ID、范围和状态保持，新增 DOC-12 完成、REL-09 待办。现有 211 项任务：12 项规划完成、199 项待办。没有运行生产/浏览器/远端 CI，没有改变包版本或发布。

下一步和回退

建议开始 BASE-01，不再扩写假想实现细节。模块路径、工具版本、性能方案与复现缺陷随开发补充；保持任务依赖和证据同步。可整体回退本提交，同时恢复任务依赖与校验器，避免留下不匹配规则。