docs(plans): 记录 K87 下拉刷新完成后回弹

docs/plans/PROGRESS.md

@@ -23592,3 +23592,27 @@ $ flutter test --no-pub
 ```
 
 解读：ReelShort 静态检查零告警，514 条测试全部通过。未安装真机，等待用户验收。
+
+## 2026-10-21 ReelShort：K87 下拉刷新完成后回弹
+
+- 功能分支：`feat/pull-to-refresh-hold`，从 ReelShort develop `d39d8d4` 创建。
+- 功能提交：`45e8707 feat(ui): 下拉刷新完成后才回弹`。
+- develop 合并提交：`01bef7f merge: 合并 K87 下拉刷新完成后回弹`，已推送 `d39d8d4..01bef7f`。
+- `AppPullToRefresh.physics` 从 Bouncing 改为 Clamping，系统不再自行提供 overscroll 位移；内容下拉统一由 `AnimationController` 和 `Transform.translate` 控制，避免刷新保持与系统回弹叠加。
+- 松手达到阈值后，当前位移用 200ms easeOut 过渡到固定 hold 56px；刷新 pending 期间保持 56px，忽略滚动通知并通过 `IgnorePointer` 阻止重复手势。
+- `onRefresh` 完成后用 200ms easeOut 回弹到 0，指示器透明度随位移降低并淡出，最终状态恢复 idle；刷新中固定显示进度圈与 `refreshingLabel`。
+- 已核对 11 个使用方均传入 `AppPullToRefresh.physics`，剧场、榜单、钱包、收藏、下载、通知、新剧、观看记录等页面自动生效。
+- 测试使用挂起 Completer 覆盖：松手瞬间 offset 高于 56、200ms 后稳定在 56、pending 再等 300ms 仍保持 56、刷新中重复下拉不增加调用且不改变保持高度、完成后回 0 且指示器消失。
+
+门禁原始输出：
+
+```text
+$ dart analyze lib test
+Analyzing lib, test...
+No issues found!
+
+$ flutter test --no-pub
+00:49 +514: All tests passed!
+```
+
+解读：ReelShort 静态检查零告警，514 条测试全部通过。未安装真机，等待用户验收。