docs(refactor): [DOC-08] require browser evidence and release reviews

AGENTS.md

@@ -21,6 +21,11 @@ The user also authorizes installing needed dependencies and adding or improving
 project scripts for the refactor without asking again for routine tooling choices.
 Record their purpose and versions, use the appropriate workspace/dependency category, update
 the lockfile when applicable, and verify compatibility and reproducible execution.
+After implementation, follow [refactor/release-reviews.md](refactor/release-reviews.md):
+complete the three review rounds and close blocking findings before candidate publication.
+Connected Chrome interaction checks complement committed automated browser tests; neither
+connection availability nor mocks replace actual playback or required device evidence.
+Each review fix remains a separate task and commit. Revalidate changed candidate contents.
 
 ## Project Summary
 

refactor/README.md

@@ -23,6 +23,7 @@
 | [核心设计](core-design.md) | 核心各模块的目标职责、迁移方式和生命周期设计 |
 | [包迁移规范](packages.md) | 全生态统一流程、组合矩阵及包特有风险 |
 | [测试与验收](testing.md) | 测试层次、浏览器/消费者矩阵、证据和回归门槛 |
+| [多轮复盘与 npm 准入](release-reviews.md) | Chrome 验证分工、三轮全局复盘、问题闭环和候选发布门槛 |
 | [工具链与发布](toolchain-release.md) | TypeScript、Bun、构建、版本管理和发布回退 |
 | [AI 协作流程](ai-workflow.md) | AI 接续工作、任务边界、验证、记录和交接模板 |
 | [架构决策](decisions.md) | 已选方向、待验证方案及被拒绝方案 |

refactor/ai-workflow.md

@@ -48,6 +48,8 @@ AI 用于源码分析、任务拆分、实现、测试和差异审查。现代
 
 ## 后续任务提示模板
 
+重构实现完成后继续执行 [多轮复盘与 npm 准入](release-reviews.md)。用户计划分多次任务复盘，后续 AI 从 REVIEW 任务与持久报告接续；不以迁移完成或 Chrome 已连接宣称发布就绪。每项复盘发现的修复仍独立建任务、验证和提交。
+
 ```text
 执行 refactor/tasks.json 中的 <任务ID>。
 先读取 AGENTS.md、refactor/README.md、progress.md 和关联契约。

refactor/changes/2026-09-10-DOC-08-browser-and-release-reviews.md

@@ -0,0 +1,23 @@
+# DOC-08 浏览器验证与多轮发布复盘
+
+- 日期：2026-09-10。
+- 基线提交：`1fa0a578`；分支：`codex/compatible-modernization`。
+- 提交主题：`docs(refactor): [DOC-08] require browser evidence and release reviews`。
+- 用户要求：记录 Chrome 验证方案，重构完成后通过多次全局复盘达到 npm 发布条件。
+
+## 交付
+
+新增 release-reviews.md，记录 Chrome 交互与自动化/真机的分工、三轮检查、问题分类、逐项修复提交、复验及候选内容绑定。同步根指令、文档入口、测试、发布、路线和 AI 接续要求。
+
+新增 REVIEW-01/02/03 待办；REL-05 必须依赖 REVIEW-03。保留原真机、回退和正式发布门槛。共 202 任务，其中 8 个规划任务完成、194 项待办，生产重构仍未开始。连接 Chrome 的事实只证明工具发现了该环境；未执行播放器测试。
+
+## 验证与限制
+
+- 计划生成、依赖无环、22 包覆盖、文档链接与生成同步检查。
+- 专项依赖检查：REL-05 和 REL-06 包含三轮复盘、REL-03 真机和 REL-04 回退前置；既有 198 项任务的 ID、范围、状态保留。
+- git diff --check 和暂存范围检查，提交后核实 Git 状态和日志。
+- 本任务仅修改维护文档及任务数据，没有运行生产/浏览器测试、安装依赖、推送或发布 npm。
+
+## 后续与回退
+
+下一项仍是 BASE-01，复盘在对应候选和验证前置完成后执行。可独立回退本 DOC-08 提交，不影响生产代码；不得将文档完成计作复盘通过。

refactor/execution-gates.md

@@ -34,6 +34,8 @@ BASE-08 的环境矩阵至少包含：包/能力、支持版本依据、样本
 
 ## 5. 发布按实际批次核定
 
+每个实际发布批次还须满足 [三轮复盘](release-reviews.md) 的架构/兼容、真实环境和 npm 产物检查。全项目 REVIEW-01/02/03 保留完整范围；分批子任务遵守同等标准，未测能力不能通过。
+
 REL-08 提前建立分包准入台账；REL-01 是版本和差异方案，REL-02 是本地候选内容与消费者验证。公开发布仍需后续授权。
 
 每批冻结：包名与版本、源码提交、依赖锁/工具版本、构建配置、tarball integrity、支持组合、所需测试及真实环境证据、兼容例外、回退产物。测试的 tarball 必须就是准备发布的内容；源码、依赖或构建改变后，原证据失效并重跑受影响检查。

refactor/plan.md

@@ -2,9 +2,9 @@
 
 > 由 tasks.json 生成。请修改数据后运行 `node refactor/scripts/plan.mjs --write`，不要手改本表。
 
-基线：`40fcda6a37d0049d42e49c1e64e70d4fd9ba5f7f`。总任务 198 项，范围 22 个包及工作区/示例。
+基线：`40fcda6a37d0049d42e49c1e64e70d4fd9ba5f7f`。总任务 202 项，范围 22 个包及工作区/示例。
 
-状态：todo 191 / doing 0 / blocked 0 / done 7 / deferred 0。风险 L/M/H 表示兼容风险，不表示工期。
+状态：todo 194 / doing 0 / blocked 0 / done 8 / deferred 0。风险 L/M/H 表示兼容风险，不表示工期。
 
 前置依赖是启动条件；验收是完成条件。任务可以继续拆分，但不能复用或悄悄删除旧 ID。
 
@@ -48,6 +48,7 @@
 | DOC-05 | workspace<br>建立每任务提交规则并提交文档基线 | DOC-04 | 根指令、质量要求、AI 流程、变更记录与初始文档提交 | 文档与计划检查通过，独立 DOC-05 commit 保存本次交付；提交后核实 SHA 和工作区 | L | done |
 | DOC-06 | workspace<br>记录自主安装依赖与添加脚本授权 | DOC-05 | 根指令、工具链规范、AI 流程、决策及变更记录 | 授权、依赖归属、脚本文档和兼容验证要求明确，计划校验通过并独立提交 DOC-06 | L | done |
 | DOC-07 | workspace<br>复审并优化计划顺序和执行门槛 | DOC-06 | 依赖优化、执行门槛规范、测试/发布补充和审查记录 | 依赖与覆盖校验、专项执行顺序断言通过；任务范围完整并独立提交 | L | done |
+| DOC-08 | workspace<br>记录 Chrome 验证及多轮 npm 发布复盘 | DOC-07 | 浏览器分工、三轮复盘规范、发布依赖与接续文档 | 计划和发布依赖检查通过；独立提交 DOC-08，连接可用不冒充测试通过 | L | done |
 
 ## 1 基线
 
@@ -371,10 +372,18 @@
 | REL-02 | workspace<br>生成候选 tarball 并验证新旧组合 | REL-01, CORE-22, ENG-07 | 各候选本地 tarball/integrity 与新旧核心/插件消费者验证报告，外部门槛单独标注 | 隔离安装和可自动化组合通过；设备结论不伪造，最终发布绑定同一候选内容 | H | todo |
 | REL-03 | workspace<br>完成真机、外部 SDK 与压力验收 | REL-02, EX-03, SITE-06, MOD-05 | Safari/移动/PiP/Cast/IMA/模型/长播放完整报告 | 包集成与全项目真机/SDK/压力结论齐全才完成本汇总；独立批次先建立自己的完整门槛子任务 | H | todo |
 | REL-04 | workspace<br>提前演练回退与主线修复同步 | REL-08, ENG-07 | 分包旧版本/tag/依赖回退方案与 master 差异 | 隔离包演练可回退，主线修复同步流程可执行；正式每批再核对其实际回退产物 | H | todo |
-| REL-05 | workspace<br>经授权发布候选并收集反馈 | REL-03, REL-04 | 候选 tag、完整产物 integrity、反馈与复现记录 | 实际发布授权/操作/版本可追溯；本计划不自动执行发布 | H | todo |
-| REL-06 | workspace<br>经授权分批正式发布 | REL-05 | 正式分包版本/tag/站点文档及兼容公告 | 候选验收通过，安装/浏览器复核和回退入口就绪 | H | todo |
+| REL-05 | workspace<br>经授权发布候选并收集反馈 | REL-03, REL-04, REVIEW-03 | 候选 tag、完整产物 integrity、反馈与复现记录 | 实际发布授权/操作/版本可追溯；本计划不自动执行发布 | H | todo |
+| REL-06 | workspace<br>经授权分批正式发布 | REL-05 | 正式分包版本/tag/站点文档及兼容公告 | 候选验收通过，安装/浏览器复核和回退入口就绪；候选反馈修复须独立建任务并复验三轮受影响结论，正式内容与最终验证产物一致 | H | todo |
 | REL-07 | workspace<br>关闭重构里程碑并维护后续队列 | REL-06 | 最终任务/设计/证据归档和维护指南 | 全范围任务有结论、无未解释兼容缺口；遗留项有明确后续责任 | L | todo |
 
+## 8.1 多轮复盘
+
+| ID | 范围 / 步骤 | 前置依赖 | 交付物 | 验收条件 | 风险 | 状态 |
+| --- | --- | --- | --- | --- | --- | --- |
+| REVIEW-01 | workspace<br>第一轮全项目架构与兼容性复盘 | REL-02, CORE-22, SITE-04, MOD-05, DOC-08 | 22 包结构、类型、旧 API/路径、测试盲区和维护文档的逐包报告 | 本轮阻断项由独立修复任务关闭并复测；环境缺口转交下一轮，不宣称已发布就绪 | H | todo |
+| REVIEW-02 | workspace<br>第二轮真实浏览器与生态集成复盘 | REVIEW-01, REL-03 | Chrome 交互、自动浏览器、新旧组合、真机/SDK/性能/资源的全范围报告 | 所需环境证据齐全，前轮修复再次核对；本轮阻断项关闭，无关 mock 不替代真实验收 | H | todo |
+| REVIEW-03 | workspace<br>第三轮 npm 候选内容与发布准备复盘 | REVIEW-02, REL-04 | 实际候选 integrity、干净安装构建/消费者、入口/许可/版本/tag/回退及前轮证据汇总 | 最终候选完整检查通过，发布阻断项为零；准备可审阅的批次报告，不自动执行 publish | H | todo |
+
 ## 完成证据与阻塞
 
 - DOC-01: [记录](progress.md)
@@ -384,3 +393,4 @@
 - DOC-05: [记录](changes/2026-09-10-DOC-05-task-commits.md)
 - DOC-06: [记录](changes/2026-09-10-DOC-06-dependencies-and-scripts.md)
 - DOC-07: [记录](changes/2026-09-10-DOC-07-plan-review.md)
+- DOC-08: [记录](changes/2026-09-10-DOC-08-browser-and-release-reviews.md)

refactor/progress.md

@@ -1,6 +1,14 @@
 # 进度与证据
 
-## 当前阶段：DOC-07 计划复审
+## 当前阶段：DOC-08 浏览器与发布复盘规范
+
+2026-09-10，记录用户要求的 Chrome 验证方案和重构后的多轮复盘。新增 REVIEW-01/02/03 三项待办并接入候选发布依赖。现有 202 项任务：8 项规划完成，194 项待办；生产重构与三轮复盘均未开始。
+
+本轮仅更新文档及任务数据，计划生成/校验、专项发布依赖断言与 Git 差异检查通过。Chrome 扩展连接已在工具清单确认，但未执行播放器测试；其余设备可用性未核实。DOC-07 提交为 `1fa0a578`；本轮按 `[DOC-08]` 独立提交，无推送或发布。
+
+详情见 [浏览器与复盘规范](release-reviews.md) 和 [DOC-08 记录](changes/2026-09-10-DOC-08-browser-and-release-reviews.md)。下一任务仍为 BASE-01。
+
+## 2026-09-10：DOC-07 计划复审
 
 2026-09-10，针对实际依赖图审查并调整计划。现为 198 项任务：7 项规划任务、191 项待实施/验收任务；生产代码重构完成数仍为 0。DOC-06 已提交为 `d7b348f3`，本次审查按 `[DOC-07]` 主题独立提交。
 

refactor/release-reviews.md

@@ -0,0 +1,49 @@
+# 重构后的多轮复盘与 npm 准入
+
+2026-09-10 用户要求：实现完成后继续进行多次全局复盘，以达到可以发布到 npm 的质量。复盘是必须完成的验收工作；规划完成、源码迁移完成、发布就绪和实际发布分别报告。
+
+## 浏览器验证的分工
+
+| 方式 | 负责内容 | 证据和边界 |
+| --- | --- | --- |
+| API/类型/产物自动测试 | 旧调用、返回值、事件语义、声明、入口及新旧核心/插件组合 | 对固定旧 tarball 和候选 tarball 使用相同用例；不以编译成功代替运行验证 |
+| 用户连接的 @Chrome | 本地 demo 的实际点击、拖动、键盘、播放、切源、字幕、控件、销毁重建及故障排查 | 记录 Chrome/系统版本、操作步骤、状态断言、错误和截图；一次交互验收不能代替持续回归 |
+| 仓库浏览器自动化 | 将稳定回归用例保存为测试，运行 Chromium/Firefox/WebKit 及所需正式 Chrome 组合 | 固定样本、环境和版本，CI 保存报告及失败证据；Playwright 的 WebKit 不等于真实 Safari |
+| 设备和外部资源 | iPhone/iPad Safari、Cast 接收端、相关 PiP/codec/SDK/广告/模型路径 | 按 BASE-08 的支持矩阵验证；模拟尺寸、mock 和其他浏览器的通过不能代替真机结论 |
+
+@Chrome 用于本地演示和候选产物验收，稳定场景同步沉淀为仓库测试。发布验收应加载与待发布内容一致的候选包；仅测试 docs/uncompiled 的源码开发构建不足以批准发布。
+
+播放验证至少检查媒体时间确实推进、暂停后停止、seek 到达预期位置、切源后旧异步结果不覆盖新状态、事件次数/顺序符合契约、插件 UI 与实际轨道一致、销毁后资源被回收。不能只凭页面加载、截图或播放按钮变化判断成功。事件比较允许有依据的浏览器差异，遵循 testing.md 的语义断言规范。
+
+环境事实：2026-09-10 已通过浏览器工具清单确认 Chrome 扩展连接可用；当时未运行播放器用例、未确认 Chrome 版本，也未核实真机或接收设备可用性。此事实会过期，每次验收重新检查，不填写为测试通过。
+
+技术依据：[Playwright 浏览器支持](https://playwright.dev/docs/browsers)、[设备模拟范围](https://playwright.dev/docs/emulation)。实际建设测试框架时再次核对选定版本。
+
+## 三轮完整复盘
+
+默认至少三轮，各有独立任务、报告和完成提交。首轮可在本地候选形成后先审查代码，待验证的设备能力必须继续留在后续门槛；不能借首轮完成宣称整个项目发布就绪。
+
+| 任务 | 范围 | 通过条件 |
+| --- | --- | --- |
+| REVIEW-01 架构与兼容性 | 全部 22 包、模块边界、依赖方向、生命周期、TS 推断、公开契约、历史路径、测试盲区和 AI 维护文档 | 逐包有审查结论和旧版对照；本轮阻断项修复并复测，环境缺口明确转交 REVIEW-02 |
+| REVIEW-02 浏览器与生态集成 | 全项目 demo/消费者、旧插件+新核心、新插件+支持的旧核心、媒体故障/并发/销毁、真实设备、性能及资源 | REL-03 的全范围环境验收通过；本轮问题闭环，必要组合没有未知或缺失证据 |
+| REVIEW-03 npm 候选包与发布准备 | 干净安装/构建、隔离消费者、文件与入口、声明/资源/许可、独立版本及依赖范围、变更日志、发布目标/tag、回退和前两轮证据时效 | 准备发布的包完整性与已测内容一致；阻断项为零，报告足以让用户审阅具体发布批次，不执行发布 |
+
+复盘覆盖全范围，改变检查重点而非仅重复同一条测试命令。可在后续用户任务中分轮执行；本规范不自动创建新对话或代理。若需要更多轮次，新增 REVIEW-04 等任务及发布依赖，保留已有 ID 和历史。
+
+## 发现、修复和重新验收
+
+- 每项发现记录固定 ID、范围、严重程度、源码/候选标识、旧版复现、预期/实际行为、最小复现、修复任务和复测证据。报告必须列出已检查范围、未覆盖范围及其原因。
+- 兼容破坏、关键功能失败、未解决的发布相关安全问题、缺失必要环境证据、错误包内容及不可复现构建均阻断相应发布。低风险非阻断项仍需理由、影响和后续任务，不因测试多次通过就自动豁免。
+- 问题修复拆成独立任务，例如 REVIEW-FIX-01；每完成一项立即提交。复盘任务在阻断项关闭后单独提交报告和状态，不能将多项已完成修复累计在一个复盘提交中。
+- 修复后重跑复现用例及受影响回归；修改核心或共享构建时扩展到生态组合。下一轮再次检查前轮修复，防止修复引入回归。
+- 新提交、依赖锁、版本或构建配置改变时，重新生成候选并核对内容，更新受影响证据。REVIEW-03 最终需要对实际候选完整执行发布检查；不能直接沿用不同 tarball 的绿灯。
+- 每轮报告保存起止源码标识、逐包候选 integrity、工具/浏览器/系统版本、样本、命令、通过/失败/跳过/重试数、持久报告链接和未决项。旧报告保留历史事实；证据过期时新增复验任务和发布依赖，不把历史 done 当作当前准入。
+
+## 发布关系
+
+REVIEW-01 -> REVIEW-02 -> REVIEW-03 -> REL-05（经授权候选发布）-> REL-06（经授权正式发布）。REL-03 的真机验收与 REL-04 的回退演练继续保留；复盘不替代它们。代码迁移完成后仍需完成这些门槛。
+
+用户在复盘后审阅具体发布批次：包/版本、目标 registry/tag、兼容结论、候选 integrity、剩余非阻断项和回退方法。表达将来发布到 npm 的目标不等同当前执行 publish；可以自主完成本地准备与复盘。
+
+候选反馈导致修复时，先创建修复和复验任务，重新核对前三轮受影响结论及最终候选内容，再进入正式发布。即使前三轮任务历史已 done，发生变化后也不能直接发布。分批交付遵循 execution-gates.md，每批具备同等三轮审查和必要环境证据，不以分批绕过全项目要求。

refactor/roadmap.md

@@ -30,7 +30,7 @@
 - M1：固定旧契约、历史版本矩阵和已知缺陷，CI 能在 PR 上执行。
 - M2：chapter 在旧核心上的 TS/类型/浏览器/tarball 试点通过，任务粒度和成本得到校准；之后再推进核心。
 - M3：核心和全部生态包完成 TS/边界整理，源码与产物测试通过。
-- M4：候选包完成新旧组合、真机、文档和性能验证，准备分包灰度发布。
+- M4：候选包完成新旧组合、真机、文档和性能验证，再通过 REVIEW-01/02/03 三轮复盘，准备分包灰度发布。
 - M5：灰度结论通过并完成正式发布记录；旧版本继续可安装、可回退。
 
 ## 范围限制

refactor/tasks.json

@@ -129,6 +129,24 @@
       "deliverable": "依赖优化、执行门槛规范、测试/发布补充和审查记录",
       "acceptance": "依赖与覆盖校验、专项执行顺序断言通过；任务范围完整并独立提交"
     },
+    {
+      "id": "DOC-08",
+      "phase": "0 规划",
+      "title": "记录 Chrome 验证及多轮 npm 发布复盘",
+      "scope": [
+        "workspace"
+      ],
+      "dependsOn": [
+        "DOC-07"
+      ],
+      "status": "done",
+      "risk": "L",
+      "deliverable": "浏览器分工、三轮复盘规范、发布依赖与接续文档",
+      "acceptance": "计划和发布依赖检查通过；独立提交 DOC-08，连接可用不冒充测试通过",
+      "evidence": [
+        "changes/2026-09-10-DOC-08-browser-and-release-reviews.md"
+      ]
+    },
     {
       "id": "BASE-01",
       "phase": "1 基线",
@@ -3455,6 +3473,60 @@
       "acceptance": "隔离包演练可回退，主线修复同步流程可执行；正式每批再核对其实际回退产物",
       "evidence": []
     },
+    {
+      "id": "REVIEW-01",
+      "phase": "8.1 多轮复盘",
+      "title": "第一轮全项目架构与兼容性复盘",
+      "scope": [
+        "workspace"
+      ],
+      "dependsOn": [
+        "REL-02",
+        "CORE-22",
+        "SITE-04",
+        "MOD-05",
+        "DOC-08"
+      ],
+      "status": "todo",
+      "risk": "H",
+      "deliverable": "22 包结构、类型、旧 API/路径、测试盲区和维护文档的逐包报告",
+      "acceptance": "本轮阻断项由独立修复任务关闭并复测；环境缺口转交下一轮，不宣称已发布就绪",
+      "evidence": []
+    },
+    {
+      "id": "REVIEW-02",
+      "phase": "8.1 多轮复盘",
+      "title": "第二轮真实浏览器与生态集成复盘",
+      "scope": [
+        "workspace"
+      ],
+      "dependsOn": [
+        "REVIEW-01",
+        "REL-03"
+      ],
+      "status": "todo",
+      "risk": "H",
+      "deliverable": "Chrome 交互、自动浏览器、新旧组合、真机/SDK/性能/资源的全范围报告",
+      "acceptance": "所需环境证据齐全，前轮修复再次核对；本轮阻断项关闭，无关 mock 不替代真实验收",
+      "evidence": []
+    },
+    {
+      "id": "REVIEW-03",
+      "phase": "8.1 多轮复盘",
+      "title": "第三轮 npm 候选内容与发布准备复盘",
+      "scope": [
+        "workspace"
+      ],
+      "dependsOn": [
+        "REVIEW-02",
+        "REL-04"
+      ],
+      "status": "todo",
+      "risk": "H",
+      "deliverable": "实际候选 integrity、干净安装构建/消费者、入口/许可/版本/tag/回退及前轮证据汇总",
+      "acceptance": "最终候选完整检查通过，发布阻断项为零；准备可审阅的批次报告，不自动执行 publish",
+      "evidence": []
+    },
     {
       "id": "REL-05",
       "phase": "8 发布验收",
@@ -3464,7 +3536,8 @@
       ],
       "dependsOn": [
         "REL-03",
-        "REL-04"
+        "REL-04",
+        "REVIEW-03"
       ],
       "status": "todo",
       "risk": "H",
@@ -3485,7 +3558,7 @@
       "status": "todo",
       "risk": "H",
       "deliverable": "正式分包版本/tag/站点文档及兼容公告",
-      "acceptance": "候选验收通过，安装/浏览器复核和回退入口就绪",
+      "acceptance": "候选验收通过，安装/浏览器复核和回退入口就绪；候选反馈修复须独立建任务并复验三轮受影响结论，正式内容与最终验证产物一致",
       "evidence": []
     },
     {

refactor/testing.md

@@ -2,6 +2,8 @@
 
 ## 测试层次
 
+浏览器验收采用连接的 @Chrome 交互检查与仓库自动回归相结合；具体操作断言、证据范围和真机边界见 [多轮复盘与 npm 准入](release-reviews.md)。浏览器已连接不代表播放器用例已通过。
+
 | 层 | 内容 | 运行位置 |
 | --- | --- | --- |
 | 单元 | Emitter、配置、转换、索引、排序、选择状态、消息解析、时钟算法 | 保留 node:test；新工具需单独决策 |

refactor/toolchain-release.md

@@ -54,6 +54,8 @@ TypeScript 用于自有源码、检查与声明生成；Vite/Rollup 保留现有
 
 ## 发布流程
 
+实现完成后必须执行 [三轮全局复盘](release-reviews.md)（REVIEW-01/02/03），分别核对架构兼容、真实环境和最终 npm 候选内容。REL-05 依赖三轮通过；候选反馈修复后的正式发布重新核对受影响证据，不能直接复用旧候选的验收结果。
+
 1. BASE-01 确定旧核心和插件的支持矩阵，登记 npm tarball integrity。起点 SHA 不能代替消费者产物基线。
 2. REL 阶段为每个发生变化的包生成候选 tarball，用隔离消费者验证，无需先公开发布。
 3. 决定独立版本号、变更日志和包依赖；纯内部兼容重构不自动提升全部包 major，也不自动把所有包改成同一版本。