docs(pilot): PILOT-01 verify chapter migration exit evidence

This commit is contained in:
Harvey Zhao committed 2026-09-10 23:36:05 +08:00
1 parent 913215885a
commit e005e5f249
5 files changed
+71 -4

No files matched your search

+26
View File
@@ -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"
}
@@ -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、全包大版本和多轮发布复盘也未由本试点替代。
本任务只增加汇总和指纹核对记录,没有源码/依赖/发布操作;回退本提交不影响已有试点实现。
+3 -2
View File
@@ -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<br>在旧核心上完成小插件迁移闭环 | PKG-CHAPTER-04, ENG-07, ENG-05, ENG-10 | chapter 的 TS、旧核心消费、真实浏览器、tarball、包内维护地图及粒度/成本反馈 | 不依赖 CORE 重构即可通过整个试点;最终核心仍由 chapter 05/06 重新验收 | H | todo |
| PILOT-01 | artplayer-plugin-chapter<br>在旧核心上完成小插件迁移闭环 | 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)
+4
View File
@@ -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。
+5 -2
View File
@@ -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": "在旧核心上完成小插件迁移闭环",