docs(plans): 记录 K87.1 下拉刷新冻结位移

docs/plans/PROGRESS.md

@@ -23616,3 +23616,26 @@ $ flutter test --no-pub
 ```
 
 解读：ReelShort 静态检查零告警，514 条测试全部通过。未安装真机，等待用户验收。
+
+## 2026-10-21 ReelShort：K87.1 下拉刷新刷新期间冻结位移
+
+- 修正分支：`fix/pull-refresh-freeze`，从 ReelShort develop `01bef7f` 创建。
+- 功能提交：`35860e0 fix(ui): 下拉刷新刷新期间冻结下拉位移`。
+- develop 合并提交：`e6f3497 merge: 合并 K87.1 下拉刷新冻结位移修复`，已推送 `01bef7f..e6f3497`。
+- 经核对，K87 已将 `AppPullToRefresh.physics` 改为 `AlwaysScrollableScrollPhysics(parent: ClampingScrollPhysics())`，K87.1 保留该配置，不再依赖原生 overscroll 位移。
+- 删除 `_holdDistance` 和刷新前“当前距离 → 56px”的动画。达到阈值松手后 AnimationController 冻结在松手距离 D，刷新期间忽略滚动通知并阻止手势，`onRefresh` 完成后才从 D 执行 200ms easeOut 回 0。
+- 未达阈值松手新增 `_retracting` 状态，从当前距离执行 200ms easeOut 回 0；回弹期间忽略新手势，不触发刷新。
+- 测试红灯复现：达阈值 D=96 时旧实现会变成 56，偏差 40；未达阈值松手旧实现立即从 30 变为 0。修复后 pending 300ms 仍保持 D，重复下拉不增加调用；未达阈值 100ms 时 offset 仍介于 0 与 D 之间，最终回 0。
+
+门禁原始输出：
+
+```text
+$ dart analyze lib test
+Analyzing lib, test...
+No issues found!
+
+$ flutter test --no-pub
+01:35 +515: All tests passed!
+```
+
+解读：ReelShort 静态检查零告警，515 条测试全部通过。未安装真机，等待用户验收。