docs(plans): 记录 K6 导航与观看历史修复

docs/plans/PROGRESS.md

@@ -1937,3 +1937,94 @@ fix(ios): 刷新 Flutter SPM 包后再准备框架
 ```
 
 解读：scheme 修复已合并推送；author/committer 均为 Zhou Weidong。
+
+### 20.8 K6 导航白线与观看历史缺陷修复
+
+### 导航白线
+
+首次红灯：
+
+```
+Expected: a value less than <0.2>
+  Actual: <1.0>
+```
+
+解读：当前深色 ColorScheme 默认 `outlineVariant` 实为白色，确认了白线根因。
+
+修复：新增 light/dark outline token，两个 ColorScheme 显式设置
+`outline/outlineVariant`；导航边框继续使用主题 token。
+
+### 观看历史真实诊断
+
+后端日志：
+
+```
+2026-10-17T16:35:22.816+08:00 POST /app/auth/register 耗时 242ms
+2026-10-17T16:35:37.123+08:00 POST /app/watch/progress 耗时 51ms
+```
+
+数据库只读查询：
+
+```
+uid       | drama_id | episode_id | position_ms | duration_ms
+UKZBA9IBE | 1        | 1          | 1522        | 91326
+UKZBA9IBE | 5        | 7          | 0           | 227880
+```
+
+真实 recent 响应：
+
+```
+{"code":0,"message":"ok","data":[
+  {"dramaId":"5","episodeId":"7",...},
+  {"dramaId":"1","episodeId":"1",...}
+]}
+```
+
+临时直连 controller 诊断：
+
+```
+watch-records-diagnostic error=null records=2
+record drama=5 episode=7 detail=闪婚后，傅先生每天都在撒糖 loading=false failed=false
+record drama=1 episode=1 detail=替嫁新娘：总裁的掌心宠 loading=false failed=false
+```
+
+解读：真实用户同类数据在 API、JSON 解析、controller 和详情补取链路均正常，
+未复现设备侧 401/100000、解析异常或详情失败。后端日志中的 429 仍属于
+其他联调设备，用户 watch 请求没有该错误。
+
+确认的客户端缺陷是 controller 吞掉真实异常：
+
+```
+Expected: '账号不存在，请先注册'
+  Actual: 'progressError'
+```
+
+修复：debug 打印异常类型、原文与堆栈；ApiException message 透传页面错误态。
+
+### 定向与全量门禁
+
+```
+$ flutter test test/theme test/home/home_nav_ui_test.dart test/watch/watch_records_controller_test.dart test/watch/watch_records_page_test.dart
+00:01 +21: All tests passed!
+
+$ dart analyze lib test
+Analyzing lib, test...
+No issues found!
+
+$ flutter test
+00:13 +266 ~1: All tests passed!
+
+$ flutter build apk --debug
+✓ Built build/app/outputs/flutter-apk/app-debug.apk
+```
+
+### Git
+
+```
+732483465ced2b28438585a4b2f1573e9a0529cb
+fix(flutter): 修复导航白线与观看记录错误透传
+
+ac706a4..b7b1c50  develop -> develop
+```
+
+解读：修复已合并推送；用户设备特定 error 仍需设备日志确认。