diff --git a/refactor/baselines/pilot-validation.json b/refactor/baselines/pilot-validation.json new file mode 100644 index 000000000..422521e92 --- /dev/null +++ b/refactor/baselines/pilot-validation.json @@ -0,0 +1,26 @@ +{ + "task": "PILOT-01", + "capturedAt": "2026-09-10T15:36:04.950Z", + "sourceFiles": [ + "chapters.ts", + "index.ts", + "progress.ts", + "style.less", + "stylesheet.ts", + "types.ts" + ], + "packageMembersChecked": 56, + "reference": "chapter-types-validation.json", + "sourceReference": "chapter-migration-validation.json", + "runtimeChecks": 23, + "browser": { + "startTime": "2026-09-10T15:21:32.399Z", + "duration": 28003.863999999998, + "expected": 54, + "skipped": 0, + "unexpected": 0, + "flaky": 0 + }, + "knownTypeBlockers": 0, + "finalCoreValidation": "PKG-CHAPTER-05/06 remains pending" +} diff --git a/refactor/changes/2026-09-10-PILOT-01-chapter.md b/refactor/changes/2026-09-10-PILOT-01-chapter.md new file mode 100644 index 000000000..9d0bd9394 --- /dev/null +++ b/refactor/changes/2026-09-10-PILOT-01-chapter.md @@ -0,0 +1,33 @@ +# PILOT-01:chapter 试点闭环 + +## 出口核对 + +本任务核对已有执行证据与当前文件指纹,并从当前源码重跑严格打包消费,不重复宣称新的浏览器运行。 + +| 要求 | 已有实现与实际证据 | +| --- | --- | +| 自有运行时 TS 与职责拆分 | src/index.ts、chapters.ts、progress.ts、stylesheet.ts 和 types.ts;[03 记录](2026-09-10-PKG-CHAPTER-03-typescript-modules.md) | +| 旧核心新插件 | chapter.spec.js 在已发布 core 5.4.0 上验证注册、同步更新、数组变更、真实 hover/seek、切源与销毁 | +| 类型/旧编译器 | [04 记录](2026-09-10-PKG-CHAPTER-04-public-types.md);TS 5.9.3 四模式及 TS 4.3.5 的 31 个场景,已知诊断为零 | +| 实际打包消费 | core/chapter 仓库外安装、成员 SHA 对照、23 项 runtime 与严格类型;运行时文件和公开路径保持 | +| 真实浏览器 | 最新安装产物 54 项 Chromium/Firefox/WebKit 通过,无重试、跳过或失败;[记录](../baselines/chapter-types-validation.json) | +| 维护地图和修复 | [包内架构](../../packages/artplayer-plugin-chapter/ARCHITECTURE.md),标题/NaN/销毁/样式有单独回归 | +| 可靠性及已知问题 | [ENG-10](2026-09-10-ENG-10-test-reliability.md);旧发布失败仍隔离重跑,不变成候选豁免 | + +核对 03 的全部源码 SHA 与当前文件相同,当前源码重新构建的 core/chapter 安装产物与 04 +通过的包内容一致,运行时 SHA 与实际浏览器资源相同。仓库中 tracked core dist 仍是此前的 +历史产物,不冒充刚验证的候选;CORE-01 修改核心时会按正常流程重新生成。此次核对结果写入 +[试点核对](../baselines/pilot-validation.json)。 + +## 对后续实施的调整 + +- 03/04 直接以 TS 整理运行时,再关闭公开类型消费问题,避免先做一遍 JS 目录迁移。 +- 构建快照必须带根 tsconfig;消费者放仓库外,禁止沿父目录解析工作区声明。 +- 默认导出需要与 ESM/CJS 实际格式一致的声明桥接,旧 TS 回退保留;不用复制 API 类。 +- 先用纯函数测试控制数据边界,再用真实浏览器验证交互与资源归属;复用同一套服务、媒体和产物映射。 +- 任务数量不能当工作量百分比。后续每个模块只补自身风险需要的证据,不重复建立通用基线; + 大任务有必要时再分子任务,简单文件保留直接实现。仍遵守一任务一提交。 + +试点出口已满足,可进入 CORE-01。chapter 05/06 仍需在最终重构核心上重新验证,不能提前完成; +完整编辑器、真机/SDK、远端 CI、全包大版本和多轮发布复盘也未由本试点替代。 +本任务只增加汇总和指纹核对记录,没有源码/依赖/发布操作;回退本提交不影响已有试点实现。 diff --git a/refactor/plan.md b/refactor/plan.md index 73fd8eb2d..3a65204bd 100644 --- a/refactor/plan.md +++ b/refactor/plan.md @@ -4,7 +4,7 @@ 基线:`40fcda6a37d0049d42e49c1e64e70d4fd9ba5f7f`。总任务 214 项,范围 22 个包及工作区/示例。 -状态:todo 179 / doing 0 / blocked 0 / done 35 / deferred 0。风险 L/M/H 表示兼容风险,不表示工期。 +状态:todo 178 / doing 0 / blocked 0 / done 36 / deferred 0。风险 L/M/H 表示兼容风险,不表示工期。 前置依赖是启动条件;验收是完成条件。任务可以继续拆分,但不能复用或悄悄删除旧 ID。 @@ -98,7 +98,7 @@ | ID | 范围 / 步骤 | 前置依赖 | 交付物 | 验收条件 | 风险 | 状态 | | --- | --- | --- | --- | --- | --- | --- | -| PILOT-01 | artplayer-plugin-chapter
在旧核心上完成小插件迁移闭环 | PKG-CHAPTER-04, ENG-07, ENG-05, ENG-10 | chapter 的 TS、旧核心消费、真实浏览器、tarball、包内维护地图及粒度/成本反馈 | 不依赖 CORE 重构即可通过整个试点;最终核心仍由 chapter 05/06 重新验收 | H | todo | +| 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 核心迁移 @@ -434,6 +434,7 @@ - ENG-06: [记录](changes/2026-09-10-ENG-06-build-development.md) [记录](build-development.md) [记录](baselines/build-validation.json) - ENG-07: [记录](changes/2026-09-10-ENG-07-package-consumers.md) [记录](baselines/package-validation.json) - ENG-10: [记录](changes/2026-09-10-ENG-10-test-reliability.md) [记录](test-reliability.md) +- PILOT-01: [记录](changes/2026-09-10-PILOT-01-chapter.md) [记录](baselines/pilot-validation.json) - PKG-CHAPTER-01: [记录](changes/2026-09-10-PKG-CHAPTER-01-contract.md) [记录](baselines/chapter-contract.md) - PKG-CHAPTER-02: [记录](changes/2026-09-10-PKG-CHAPTER-02-tests.md) [记录](baselines/chapter-validation.json) - PKG-CHAPTER-03: [记录](changes/2026-09-10-PKG-CHAPTER-03-typescript-modules.md) [记录](baselines/chapter-migration-validation.json) diff --git a/refactor/progress.md b/refactor/progress.md index 3c1628a7c..e13e5ff11 100644 --- a/refactor/progress.md +++ b/refactor/progress.md @@ -1,5 +1,9 @@ # 进度与证据 +## 当前实施:PILOT-01 试点出口通过 + +当前源码和包内文件指纹与既有通过证据一致;chapter 的 TS、旧核心、三浏览器、打包、类型和维护地图闭环,见 [汇总](changes/2026-09-10-PILOT-01-chapter.md)。当前 214 项,36 完成、178 待办。接下来 CORE-01 开始核心纯工具 TS 迁移,不再建立重复基线;chapter 05/06 和完整发布验收仍待执行。 + ## 当前实施:ENG-10 测试可靠性规则完成 核对并整合现有风险分类、候选零诊断、旧发布隔离、精确媒体取消和无重试/跳过验收规则,见 [记录](changes/2026-09-10-ENG-10-test-reliability.md)。不新增测试框架或重复基线。当前 214 项,35 完成、179 待办;chapter TS 已完成,核心源码尚未开始。下一项 PILOT-01 核对现有产物/源码证据并汇总,再进入 CORE-01。 diff --git a/refactor/tasks.json b/refactor/tasks.json index 215868368..40ea6b1d7 100644 --- a/refactor/tasks.json +++ b/refactor/tasks.json @@ -719,9 +719,12 @@ "scope": [ "artplayer-plugin-chapter" ], - "status": "todo", + "status": "done", "risk": "H", - "evidence": [], + "evidence": [ + "changes/2026-09-10-PILOT-01-chapter.md", + "baselines/pilot-validation.json" + ], "id": "PILOT-01", "phase": "2.1 早期试点", "title": "在旧核心上完成小插件迁移闭环",