docs(plans): 留痕 K55 目录加载诊断

docs/plans/PROGRESS.md

@@ -21918,6 +21918,36 @@ Running Gradle task 'assembleDebug'...
 
 解读：静态检查零告警，463 条测试全部通过，Android debug APK 构建成功。iOS 未执行真机构建，由用户在 Xcode 重新 Pod install 后验收 Swift 编译。
 
+## 2026-10-20 ReelShort：K55-A 目录加载诊断与前台重试
+
+- 前置状态：`shared_preferences_foundation 2.5.6` 已完成并合并，develop 合并提交 `d68734c`。
+- 分支：`fix/ios-k55-diagnostics`
+- 功能提交：`730a965 feat(flutter): 增加目录加载诊断与前台重试`
+- develop 合并提交：`eab5d3e merge: 合并 K55 目录加载诊断`，已推送。
+- 首页与剧场错误态在 debug 下增加 `catalog-debug-endpoint`、`catalog-debug-error` 两行诊断，展示当前 `AppConfig.apiBaseUrl` 与原始错误，12 号 subtle、最多 2 行省略；release 不展示。
+- `CatalogController.load/refresh` 失败输出 `[catalog] base=... error=...`；`CategoryController` 同样输出目录诊断；地址探测逐项输出 `[probe] url -> ok/fail(reason)`，全部仅 debug。
+- 首页和剧场重试统一使用 `retryCatalogLoad`，先重新探测服务地址再加载数据；App 从后台回到 `resumed` 且目录仍失败时，自动重新探测并只重载失败的数据源一次，不弹提示。
+
+测试：新增首页失败态地址/原始错误和 12 号 subtle 样式断言，以及“探测先于 load”顺序测试；剧场错误态增加两个诊断 Key 和原始异常文本断言。
+
+门禁原始输出：
+
+```text
+$ dart analyze lib test
+Analyzing lib, test...
+No issues found!
+
+$ flutter test
+00:51 +465: All tests passed!
+
+$ flutter build apk --debug
+Running Gradle task 'assembleDebug'...
+   9.0s
+✓ Built build/app/outputs/flutter-apk/app-debug.apk
+```
+
+解读：静态检查零告警，465 条测试全部通过，debug APK 构建成功。本机 Flutter 自动改写的 `pubspec.lock` 已恢复，未纳入提交。iOS 复现时可直接查看失败页服务地址与错误，或从 Xcode 日志筛选 `[probe]`、`[catalog]`。
+
 ## 2026-10-20 ReelShort：K53-A 详情页首帧直出
 
 - 前置状态：K52-A 已完成并合并，develop 合并提交 `a11ba50`。