docs(plans): 留痕 K56 服务地址编辑器

docs/plans/PROGRESS.md

@@ -21948,6 +21948,37 @@ Running Gradle task 'assembleDebug'...
 
 解读：静态检查零告警，465 条测试全部通过，debug APK 构建成功。本机 Flutter 自动改写的 `pubspec.lock` 已恢复，未纳入提交。iOS 复现时可直接查看失败页服务地址与错误，或从 Xcode 日志筛选 `[probe]`、`[catalog]`。
 
+## 2026-10-20 ReelShort：K56-A debug 服务地址编辑器
+
+- 前置状态：K55-A 已完成并合并，develop 合并提交 `eab5d3e`。
+- 分支：`feature/flutter-k56-endpoint-editor`
+- 功能提交：`c259b0b feat(flutter): 增加 debug 服务地址编辑器`
+- develop 合并提交：`ca67765 merge: 合并 K56 服务地址编辑器`，已推送。
+- 首页和剧场 debug 失败页在保留 K55 两行诊断的基础上增加 `catalog-debug-endpoint-edit` 按钮，release 不显示。
+- 对话框预填 `AppConfig.apiBaseUrl`，支持输入 `http://IP:端口`；合法地址经 `ServerEndpoint.normalize` 归一化后执行 save → probe → reload，非法地址在弹框内显示红字且不保存。
+- 对话框附带提示：手机需与电脑同一 Wi-Fi，并在 iOS 设置-隐私与安全性-本地网络 中允许本应用。
+- `ServerEndpoint.save` 成功后立即应用运行时地址，探测时显式自定义地址优先；无自定义地址时仍保持 K54 的 127 → 开发机 → 公网顺序。
+
+测试：新增 debug 入口、合法地址 save/probe/load 顺序、非法地址不保存提示、自定义运行时地址优先探测，以及剧场入口断言。
+
+门禁原始输出：
+
+```text
+$ dart analyze lib test
+Analyzing lib, test...
+No issues found!
+
+$ flutter test
+00:45 +468: All tests passed!
+
+$ flutter build apk --debug
+Running Gradle task 'assembleDebug'...
+  20.6s
+✓ Built build/app/outputs/flutter-apk/app-debug.apk
+```
+
+解读：静态检查零告警，468 条测试全部通过，debug APK 构建成功。工作区无锁文件残留。iOS 真机可打开 debug 失败页手动切换服务地址，实际连通性由用户验收。
+
 ## 2026-10-20 ReelShort：K53-A 详情页首帧直出
 
 - 前置状态：K52-A 已完成并合并，develop 合并提交 `a11ba50`。