docs(plans): 留痕 K40 播放占位与评论登录

docs/plans/PROGRESS.md

@@ -21324,3 +21324,63 @@ Running Gradle task 'assembleDebug'...
 ```
 
 解读：静态检查零告警，440 条测试全部通过，debug APK 构建成功。工作区原有 `pubspec.lock` 变更未纳入本批提交。真机验收由用户执行。
+
+## 2026-10-20 ReelShort：K40-A 播放 loading 主题色与封面占位
+
+- 前置状态：K39-A 已合并，功能提交 `1c6c921`，合并提交 `9864c8e`。
+- 分支：`fix/flutter-k40-player-loading`
+- 功能提交：`fa5fd12 fix(flutter): 优化播放加载占位与主题色`
+- develop 合并提交：`1eea9fa merge: 合并 K40-A 播放加载修复`，已推送。
+- 播放未就绪时 `player-fallback-background` 改为剧集封面 `RemoteImage` + `0x66000000` 遮罩；封面为空时仍回落纯黑。
+- 票据 loading 与播放会话 loading 的颜色统一改为 `AppColors.blue`，并增加稳定测试 Key。
+
+测试：更新播放器 fallback 覆盖断言，新增空封面回落黑色用例；播放器专项 27 条全部通过。
+
+门禁原始输出：
+
+```text
+$ dart analyze lib test
+Analyzing lib, test...
+No issues found!
+
+$ flutter test
+00:44 +441: All tests passed!
+
+$ flutter build apk --debug
+Running Gradle task 'assembleDebug'...
+   7.4s
+✓ Built build/app/outputs/flutter-apk/app-debug.apk
+```
+
+解读：静态检查零告警，441 条测试全部通过，debug APK 构建成功。工作区原有 `pubspec.lock` 变更未纳入本批提交。真机验收由用户执行。
+
+## 2026-10-20 ReelShort：K40-B 评论输入登录闸
+
+- 前置状态：K40-A 已合并，功能提交 `fa5fd12`，合并提交 `1eea9fa`。
+- 分支：`fix/flutter-k40-comment-auth`
+- 功能提交：`d0c1a5f fix(flutter): 评论输入增加登录闸`
+- develop 合并提交：`457d2fa merge: 合并 K40-B 评论登录闸`，已推送。
+- 未登录时评论输入框 `readOnly + canRequestFocus=false`，点击只触发 `ensureSignedIn`，不会先聚焦或弹键盘；取消保持失焦，登录成功返回后自动聚焦。
+- 未登录点击发送时先走登录闸，再判断空内容；不再先走空内容短路。已登录空内容与提交行为保持原样。
+- 未登录 hint 使用新增 `commentLoginHint`（登录后参与评论 / Sign in to comment / Masuk untuk berkomentar），已登录仍使用 `writeComment`。
+- 评论列表匿名可读，回复、点赞、删除、举报既有登录闸不变。
+
+测试：新增未登录点击输入框不聚焦、取消后保持失焦、登录成功返回后聚焦、未登录发送不产生评论；评论面板专项 16 条全部通过，既有评论用例保持通过。
+
+门禁原始输出：
+
+```text
+$ dart analyze lib test
+Analyzing lib, test...
+No issues found!
+
+$ flutter test
+00:43 +444: All tests passed!
+
+$ flutter build apk --debug
+Running Gradle task 'assembleDebug'...
+   7.8s
+✓ Built build/app/outputs/flutter-apk/app-debug.apk
+```
+
+解读：静态检查零告警，444 条测试全部通过，debug APK 构建成功。工作区原有 `pubspec.lock` 变更未纳入本批提交。真机验收由用户执行。