docs(plans): 留痕 K47 搜索清空按钮

docs/plans/PROGRESS.md

@@ -21596,6 +21596,36 @@ Running Gradle task 'assembleDebug'...
 - 公共组件测试断言下拉时滚动位置为负值；discover、favorites、watch_records、ranking、new_releases、reserve 同步断言统一物理配置。
 - 门禁：`dart analyze lib test` 零告警，453 条测试全部通过，debug APK 构建成功（7.3s）。
 
+## 2026-10-20 ReelShort：K47 剧场搜索框清空按钮
+
+- 前置状态：K45-A、K46-A 与下拉跟随修正均已合并，develop 合并提交 `fb0585c`。
+- 分支：`fix/flutter-k47-search-clear`
+- 功能提交：`9870502 fix(flutter): 增加剧场搜索清空按钮`
+- develop 合并提交：`8bcd882 merge: 合并 K47 剧场搜索清空修正`，已推送。
+- 搜索框右侧预留固定 42px 尾部区域，有内容时显示 18×18 浅灰圆底、12px `close_rounded` 清空按钮；加载圈与清空按钮同时出现时，加载圈位于左侧。
+- 清空按钮调用 `controller.clear()`，手动触发 `onChanged('')`，随后重新请求焦点；内容为空时按钮隐藏，hint 与输入区宽度不因按钮出现/隐藏而跳动。
+- 现有 44 高、22 圆角、聚焦描边与 `discover-search` / `discover-search-shell` Key 保持不变。
+
+测试：新增搜索框输入后出现清空按钮、加载圈位置、18×18 尺寸、点击后空文本与空串回调、按钮隐藏及焦点保持用例。全量测试增至 454 条。
+
+门禁原始输出：
+
+```text
+$ dart analyze lib test
+Analyzing 2 items...
+No issues found! (ran in 3.1s)
+
+$ flutter test
+00:47 +454: All tests passed!
+
+$ flutter build apk --debug
+Running Gradle task 'assembleDebug'...
+   7.4s
+✓ Built build/app/outputs/flutter-apk/app-debug.apk
+```
+
+解读：静态检查零告警，454 条测试全部通过，debug APK 构建成功。真机搜索交互由用户验收。
+
 ## 2026-10-20 ReelShort：详情页顶部圆形按钮统一修正
 
 - 前置状态：K40-B 评论入口登录闸已合并，合并提交 `230f16a`。