refactor(thumbnail): [PKG-TOOL-THUMB-04] preserve approved published defaults

This commit is contained in:
Harvey Zhao committed 2026-09-15 23:54:24 +08:00
1 parent 490e157717
commit b5f8b5e28e
37 files changed
+11172 -136

No files matched your search

+10 -7
View File
@@ -1,7 +1,10 @@
# Thumbnail 默认行为兼容决策(待用户确认)
# Thumbnail 默认行为兼容决策(已批准,已实施)
状态:proposal,尚未批准或实施。责任任务 PKG-TOOL-THUMB-04,风险 THUMB-COMPAT-01。
本文件把已有待答问题具体化;不把其他包的兼容授权推广到本工具。
状态:approved,源码、类型及本机验证完成。责任任务 PKG-TOOL-THUMB-04,风险 THUMB-COMPAT-01。
2026-09-15 用户明确批准:“接受:npm 行为默认,工作区行为显式选择(推荐)”。
下列方案现在可直接实施,无需再次询问;批准不代替源码、类型和浏览器验证。
实施结果见 [完成记录](changes/2026-09-15-PKG-TOOL-THUMB-04-approved-policy.md);
05/06、设备和发布门槛仍独立保留,Windows WebKit 能力对照不计截图提取通过。
## 已复现的冲突
@@ -23,7 +26,7 @@
变成 90 高;loadVideo 后同步注册 video 监听器在两版也会得到不同结果。
不能通过 TS 重命名或内部拆文件同时满足这两种默认值和时序。
## 推荐方案:恢复已发布行为为默认,显式选择工作区模式
## 已批准方案:恢复已发布行为为默认,显式选择工作区模式
1. 根构造器默认选择恢复的 3.5.31 行为,支持旧 delay 参数,DEFAULTS 恢复
delay: 300;配置 height 保留原钳制,video 延迟、每帧/完成延迟及 input
@@ -33,7 +36,7 @@
显式 compatibility: 'published-3.5' 可表达默认选择。
3. 类级 DEFAULTS 没有实例上下文,统一表示根默认的 3.5.31 配置。依赖工作区
DEFAULTS 精确字段集合的代码需要明确选择/保存自己的配置;不能承诺它同时
返回两套对象。这个差异也属于本次待批准范围。
返回两套对象。这个差异也属于本次已批准范围。
4. 保留已实现的 URL/监听器/定时器所有权、销毁与切源取消、错误结算、输入
清理和 emitter 修复。不会恢复旧版错绑 this、陈旧回调、资源泄漏等缺陷。
定时等待不取代真实帧就绪;修复慢解码导致错误截图的路径单独记录和验证。
@@ -51,8 +54,8 @@ const workspaceTool = new ArtplayerToolThumbnail({
})
```
另一种可选决策是保留工作区 4.4.0 为默认,并接受已发布 3.5.31 用户需要选择
兼容模式。这会把迁移成本放到已发布旧用户,不作为当前推荐。
未选择的替代方案是保留工作区 4.4.0 为默认,并要求已发布 3.5.31 用户选择
兼容模式;用户已经选择上面的 npm 默认方案。
## 批准后实施与验收