fix(danmuku): [PKG-DANMUKU-11] start visible lifetime after Worker placement

refactor/changes/2026-09-13-PKG-DANMUKU-11-visible-lifetime.md

@@ -0,0 +1,43 @@
+# PKG-DANMUKU-11 Worker 等待与可见寿命
+
+07稳定性审查发现独立计时问题，拆为本任务修复；07本身仍未完成。
+配置speed为1秒，Worker回复之前的隐藏等待如果超过1秒，弹幕刚触发visible就会
+在下一调度帧被回收。开始时间原先在postMessage前设置，而CSS显示在回复后才开始。
+
+## 兼容范围
+
+修复仅把成功放置的可见起点与实际放置时间对齐。保留原speed、Worker几何输入、
+同步/异步门面、事件参数/顺序、状态池、取消与错误行为；不改变公开类型或包入口。
+空轨道/取消不新增visible；暂停后的剩余寿命、播放速度与旧seek/reset行为仍回归。
+这是原来隐藏等待吞掉可见时长的缺陷修正，等待较长的弹幕会获得完整显示时间。
+历史readys的±0.1秒窗口和beforeVisible串行语义不在此任务改变。
+
+## 验证
+
+受控红测使用真实Worker算法：mode0/1/2、1秒寿命、等待3秒。三个开始时间断言
+均得到1000而非4000，明确复现本问题；修复后的绿测继续验证250ms剩余寿命和一次
+回收断言。原始日志保留在refactor/.cache/danmuku11-unit-red.log。
+
+原生测试使用实际视频与真实Worker几何，仅通过观察用Worker子类给请求传递加
+1500ms延迟，记录post/reply/visible/recycle时间。它验证人为注入延迟后的行为，
+不声称真实用户环境必然发生相同Worker延迟。
+
+完整源码253项通过，正式main/legacy各57项调度与Worker测试通过（包括共同的
+内部WorkerClient测试，不能都算独立产物案例）。构建、目标lint和分包严格TS通过。
+源码浏览器90项：原调度66项加寿命24项，覆盖两核心、新旧插件、mode0/1及三引擎；
+main/legacy各选12项候选寿命用例，总114项通过，无重试或跳过。以visible事件到
+节点回收测得生命周期，不把它称为逐帧视觉/自然Worker饥饿或长期吞吐验收。
+相同1秒配置下，旧版测得0–15ms，修复源码998–1044ms，main1004–1041ms、
+legacy1005–1027ms；原生逐帧调度有少量回收延后，受控用例精确验证时间扣减。
+具体环境、字节及时间见[机器证据](../baselines/danmuku-lifetime-validation.json)。
+
+首次浏览器运行也触发了旧版已登记的play/playing双循环，历史两次请求与单次计时
+夹具冲突。将插件安装放在原生playing之后并显式启动一次来隔离该已知缺陷，未改变
+被测时钟/队列或寿命阈值。隔离红测4个旧版缺陷观察通过、4个候选寿命断言失败，
+再修复生产。第一次失败也留档，没有把夹具故障当成本任务独立红测。
+独立只读复查确认取消/节点检查在时钟更新之前，几何与剩余寿命仍按准备时速度
+计算，setState→place→visible顺序不变；包ARCHITECTURE同步维护计时边界。
+无新依赖、公开类型、版本或分发入口变更；构建产物和docs复制保持相同字节。
+
+状态以tasks.json为准。回退本任务独立commit
+会恢复旧计时问题，不撤销06类型迁移或10热力图修复。未推送、未发布。

refactor/plan.md

@@ -2,9 +2,9 @@
 
 > 由 tasks.json 生成。请修改数据后运行 `node refactor/scripts/plan.mjs --write`，不要手改本表。
 
-基线：`40fcda6a37d0049d42e49c1e64e70d4fd9ba5f7f`。总任务 229 项，范围 22 个包及工作区/示例。
+基线：`40fcda6a37d0049d42e49c1e64e70d4fd9ba5f7f`。总任务 230 项，范围 22 个包及工作区/示例。
 
-状态：todo 68 / doing 15 / blocked 0 / done 146 / deferred 0。风险 L/M/H 表示兼容风险，不表示工期。
+状态：todo 68 / doing 15 / blocked 0 / done 147 / deferred 0。风险 L/M/H 表示兼容风险，不表示工期。
 
 前置依赖是启动条件；验收是完成条件。任务可以继续拆分，但不能复用或悄悄删除旧 ID。
 
@@ -22,7 +22,7 @@
 | artplayer-plugin-auto-thumbnail | 1.1.0 | PKG-AUTO-THUMB-01, PKG-AUTO-THUMB-02, PKG-AUTO-THUMB-03, PKG-AUTO-THUMB-04, PKG-AUTO-THUMB-05, PKG-AUTO-THUMB-06 |
 | artplayer-plugin-chapter | 1.1.0 | PILOT-01, PKG-CHAPTER-01, PKG-CHAPTER-02, PKG-CHAPTER-03, PKG-CHAPTER-04, PKG-CHAPTER-05, PKG-CHAPTER-06 |
 | artplayer-plugin-chromecast | 1.1.0 | PKG-CAST-01, PKG-CAST-02, PKG-CAST-03, PKG-CAST-04, PKG-CAST-05, PKG-CAST-06 |
-| artplayer-plugin-danmuku | 5.3.0 | PKG-DANMUKU-01, PKG-DANMUKU-02, PKG-DANMUKU-03, PKG-DANMUKU-04, PKG-DANMUKU-05, PKG-DANMUKU-06, PKG-DANMUKU-07, PKG-DANMUKU-08, PKG-DANMUKU-09, PKG-DANMUKU-10 |
+| artplayer-plugin-danmuku | 5.3.0 | PKG-DANMUKU-01, PKG-DANMUKU-02, PKG-DANMUKU-03, PKG-DANMUKU-04, PKG-DANMUKU-05, PKG-DANMUKU-06, PKG-DANMUKU-07, PKG-DANMUKU-08, PKG-DANMUKU-09, PKG-DANMUKU-10, PKG-DANMUKU-11 |
 | artplayer-plugin-danmuku-mask | 1.1.0 | PKG-MASK-01, PKG-MASK-02, PKG-MASK-03, PKG-MASK-04, PKG-MASK-05, PKG-MASK-06 |
 | artplayer-plugin-dash-control | 1.1.0 | PKG-DASH-01, PKG-DASH-02, PKG-DASH-03, PKG-DASH-04, PKG-DASH-05, PKG-DASH-06 |
 | artplayer-plugin-document-pip | 1.1.0 | PKG-DPIP-01, PKG-DPIP-02, PKG-DPIP-03, PKG-DPIP-04, PKG-DPIP-05, PKG-DPIP-06 |
@@ -315,10 +315,11 @@
 | PKG-DANMUKU-04 | artplayer-plugin-danmuku<br>整理时钟、队列与轨道调度 | PKG-DANMUKU-03, CORE-10 | danmuku 调度器和确定性时钟测试 | seek/暂停/倍率/长时间运行无顺序和碰撞回归 | H | done |
 | PKG-DANMUKU-05 | artplayer-plugin-danmuku<br>整理 DOM 渲染、设置、热力图与 worker | PKG-DANMUKU-04, CORE-14, CORE-18 | renderer/setting/heatmap/worker 职责及资源归属 | mount/icons/设置和 worker 协议保持，销毁无后台工作 | H | done |
 | PKG-DANMUKU-06 | artplayer-plugin-danmuku<br>迁移 TS 与公开声明 | PKG-DANMUKU-05, ENG-04, ENG-06 | 自有模块、worker 消息、option/item/result 类型 | 旧参数、扩展字段和事件消费通过，vendored 边界清楚 | H | done |
-| PKG-DANMUKU-07 | artplayer-plugin-danmuku<br>弹幕能力稳定性验收 | PKG-DANMUKU-06, PKG-DANMUKU-10 | 负载/渲染/资源对比及 mask 可依赖的稳定边界 | 在试点核心中旧插件 API 与关键帧路径通过 | H | doing |
+| PKG-DANMUKU-07 | artplayer-plugin-danmuku<br>弹幕能力稳定性验收 | PKG-DANMUKU-06, PKG-DANMUKU-10, PKG-DANMUKU-11 | 负载/渲染/资源对比及 mask 可依赖的稳定边界 | 在试点核心中旧插件 API 与关键帧路径通过 | H | doing |
 | PKG-DANMUKU-08 | artplayer-plugin-danmuku<br>完成新旧核心与组合验收 | PKG-DANMUKU-07, CORE-22 | 最终核心/旧核心、mask/fullscreen/PiP 组合报告 | 性能无未解释退化，反复装卸无累计资源 | H | todo |
 | PKG-DANMUKU-09 | artplayer-plugin-danmuku<br>完成分发、示例与文档 | PKG-DANMUKU-08, ENG-07 | danmuku.js、README、声明、worker 与产物 | tarball 和静态 icons 等旧调用通过，有独立回退版本 | H | todo |
 | PKG-DANMUKU-10 | artplayer-plugin-danmuku<br>修复 issue958 密集热力图过高与曲线裁平 | PKG-DANMUKU-05 | 自动密度缩放与曲线边界、历史自定义坐标兼容及真实浏览器红绿证据 | 16000条三种分布在两核心三引擎和source/main/legacy不遮挡；显式轴和自定义points保持旧解释，有单独commit | M | done |
+| PKG-DANMUKU-11 | artplayer-plugin-danmuku<br>修复 Worker 隐藏等待吞掉可见寿命 | PKG-DANMUKU-06 | 成功放置时的可见计时与延迟回复回归 | 真实 Worker 延迟下完整显示寿命；保留暂停/回收/取消和公开契约 | M | done |
 
 ## 5 包迁移：artplayer-proxy-canvas
 
@@ -589,3 +590,4 @@
 - PKG-ASR-08: [记录](changes/2026-09-13-PKG-ASR-08-capture-output.md) [记录](baselines/asr-fallback-validation.json)
 - PKG-ASR-09: [记录](changes/2026-09-13-PKG-ASR-09-explicit-capture.md) [记录](baselines/asr-explicit-capture-validation.json)
 - PKG-DANMUKU-10: [记录](changes/2026-09-13-PKG-DANMUKU-10-heatmap-density.md) [记录](baselines/danmuku-heatmap-density-validation.json)
+- PKG-DANMUKU-11: [记录](changes/2026-09-13-PKG-DANMUKU-11-visible-lifetime.md) [记录](baselines/danmuku-lifetime-validation.json)

refactor/progress.md

@@ -1,5 +1,17 @@
 # 进度与证据
 
+## PKG-DANMUKU-11 Worker 等待寿命修复
+
+07负载审查独立发现并复现：隐藏Worker等待超过speed时，刚显示的弹幕下一帧就被
+回收。成功放置时重置可见起点，保留准备时速度、几何、取消检查与事件顺序。
+三模式受控红/绿、两核心与三引擎真实延迟Worker验证通过；完整源码253项、
+main/legacy各57项单测，源码90及两个产物各12共114项浏览器通过。构建/lint/严格
+分包TS通过，见[变更](changes/2026-09-13-PKG-DANMUKU-11-visible-lifetime.md)和
+[机器证据](baselines/danmuku-lifetime-validation.json)。
+这是实际视频/Worker加受控请求延迟，不声称自然饥饿或持续高负载通过。
+230项：147 done、15 doing、68 todo；07继续，DANMUKU-LOAD-01仍开放。
+新增11是独立缺陷任务和本地commit；不推送或发布。
+
 ## PKG-DANMUKU-06 自有 TS 与公开声明完成
 
 20个自有运行模块完成严格TS，新增内部状态/Worker/parser/UI类型边界；公开运行

refactor/risk-table.md

@@ -239,3 +239,4 @@
 | DANMUKU-INPUT-02 | resolved / 已复现 | Intermediate explicit-zero correction regressed accepted NaN timestamp fallback | PKG-DANMUKU-04 |
 | DANMUKU-LOAD-01 | open / 待取证 | Native lifecycle fixtures sometimes miss timestamp eligibility during concurrent workload; real frame/window behavior needs load evidence | PKG-DANMUKU-07 |
 | DANMUKU-HEATMAP-02 | resolved / 已复现 | Issue958 dense automatic heatmaps exceed the fixed Y domain and flatten across video | PKG-DANMUKU-10 |
+| DANMUKU-TIMING-01 | resolved / 已复现 | Hidden Worker wait is deducted from visible lifetime and can recycle a comment immediately after visible | PKG-DANMUKU-11 |

refactor/risks.json

@@ -5324,6 +5324,28 @@
         "refactor/baselines/danmuku-heatmap-density-validation.json"
       ],
       "resolutionRationale": "250 unit tests and 102 native browser cases passed, including source/main/legacy density matrices and main resource regression. No claim of full load or macOS device acceptance."
+    },
+    {
+      "id": "DANMUKU-TIMING-01",
+      "title": "Hidden Worker wait is deducted from visible lifetime and can recycle a comment immediately after visible",
+      "confirmation": "reproduced",
+      "status": "resolved",
+      "owners": [
+        "PKG-DANMUKU-11"
+      ],
+      "evidence": [
+        "refactor/changes/2026-09-13-PKG-DANMUKU-11-visible-lifetime.md",
+        "test/danmuku-scheduler.test.js",
+        "test/browser/danmuku-lifetime.spec.js",
+        "refactor/baselines/danmuku-lifetime-validation.json"
+      ],
+      "compatibleResolution": "Anchor the lifetime clock to successful placement while preserving speed, Worker geometry, queue ordering and lifecycle cancellation.",
+      "closureCriteria": "Controlled three-mode regression and native delayed Worker runs distinguish historical immediate recycling from full candidate visible lifetime; ordinary scheduling regressions remain green.",
+      "resolutionEvidence": [
+        "refactor/baselines/danmuku-lifetime-validation.json",
+        "refactor/changes/2026-09-13-PKG-DANMUKU-11-visible-lifetime.md"
+      ],
+      "resolutionRationale": "Three exact controlled modes and real delayed Worker/native video regression establish full visible lifetime, with the unchanged published defect retained and existing scheduling/pause/cancellation checks green."
     }
   ]
 }

refactor/tasks.json

@@ -3380,7 +3380,8 @@
       ],
       "dependsOn": [
         "PKG-DANMUKU-06",
-        "PKG-DANMUKU-10"
+        "PKG-DANMUKU-10",
+        "PKG-DANMUKU-11"
       ],
       "status": "doing",
       "risk": "H",
@@ -4681,6 +4682,25 @@
         "changes/2026-09-13-PKG-DANMUKU-10-heatmap-density.md",
         "baselines/danmuku-heatmap-density-validation.json"
       ]
+    },
+    {
+      "id": "PKG-DANMUKU-11",
+      "phase": "5 包迁移：artplayer-plugin-danmuku",
+      "title": "修复 Worker 隐藏等待吞掉可见寿命",
+      "scope": [
+        "artplayer-plugin-danmuku"
+      ],
+      "dependsOn": [
+        "PKG-DANMUKU-06"
+      ],
+      "status": "done",
+      "risk": "M",
+      "deliverable": "成功放置时的可见计时与延迟回复回归",
+      "acceptance": "真实 Worker 延迟下完整显示寿命；保留暂停/回收/取消和公开契约",
+      "evidence": [
+        "changes/2026-09-13-PKG-DANMUKU-11-visible-lifetime.md",
+        "baselines/danmuku-lifetime-validation.json"
+      ]
     }
   ]
 }