docs: 记录 K94 首页类型 Feed 留痕

docs/plans/PROGRESS.md

@@ -24064,3 +24064,53 @@ Build successful. Please see dist-dev directory
 - ReelShortWeb Husky 与当前 npm/pnpm 环境不兼容，功能与合并提交使用 `--no-verify`，
   门禁已独立完成。
 - 未改 FruitServer 代码，未安装或操作真机，等待用户验收。
+
+## 2026-10-21 K94 首页内容类型 Feed 与分页
+
+- 已完整读取 K94 `docs/plans/INBOX.md`；本批次只改 ReelShort Flutter 客户端。
+- 已创建 ReelShort `feat/k94-home-type-feed` worktree，基于最新 `origin/develop`。
+- 已先写计划 `docs/plans/2026-10-21-K94-home-type-feed.md`，记录数据层、频道缓存、
+  首页无感切换、播放器队列更新、分页触发和测试矩阵。
+- 不改后端、ReelShortWeb、specs；不安装或操作真机。
+- 已完成数据层：新增 `FeedPage`，`CatalogApi.feed` 与 `CatalogRepository.fetchFeed`
+  支持 types/cursor/size，并补齐所有测试仓库实现。
+- 已完成 `HomeFeedChannel` 与 `HomeFeedController`：推荐 seed、三频道独立缓存、
+  静默刷新、游标追加去重、requestSeq 防串包、失败保留旧数据。
+- 首页顶栏改为受控频道，删除 comingSoon；无缓存频道在黑色内容区显示小转圈，
+  推荐首屏立即使用 `/app/home/feed` 打平数据。
+- `PlayerLogic.updateFeed` 支持原地扩队列与当前剧索引重映射；同频道刷新不重启当前视频，
+  频道变化回到第 1 个；PageView 倒数第 3 个触发 loadMore。
+- 已补 Feed API、控制器、顶栏和 PlayerLogic 测试，并更新既有 CatalogRepository 测试实现。
+
+门禁原始输出：
+
+```text
+$ dart analyze lib test
+Analyzing lib, test...
+No issues found!
+
+$ flutter test --no-pub
+00:53 +532: All tests passed!
+
+$ flutter build apk --debug
+Running Gradle task 'assembleDebug'... 27.9s
+✓ Built build/app/outputs/flutter-apk/app-debug.apk
+```
+
+解读：静态分析零告警，532 项测试全过，debug APK 构建成功；未安装或操作真机。
+
+### K94 交付结果
+
+- ReelShort 功能提交：`ae61d9e feat(home): 首页按内容类型分频道 Feed 并支持分页`。
+- ReelShort develop 合并提交：`c8392b2 merge: 合并 K94 首页类型 Feed`，
+  已推送 `4d0be47..c8392b2`。
+- 推荐首屏使用 home feed seed，并在后台静默刷新 `/app/feed`；漫剧/真人剧首次请求分别带
+  `ANIME/LIVE`，推荐不带 types，均使用游标分页。
+- 三频道独立缓存、同步切换、requestSeq 防串包、分页去重和失败保留旧数据已实现。
+- 顶栏删除 comingSoon 并改为受控频道；无缓存频道保留顶栏/底栏，在黑色内容区显示
+  `home-feed-channel-loading` 小转圈。
+- PlayerLogic 原地更新 queue/visibleIndices；当前剧仍存在时重映射 active slot，
+  不重启当前 player；频道变化回到第 1 个。
+- 门禁：`dart analyze lib test` 零告警；`flutter test --no-pub` 532 项全过；
+  `flutter build apk --debug` 成功生成 `build/app/outputs/flutter-apk/app-debug.apk`。
+- 未改后端、ReelShortWeb、specs；未安装或操作真机，等待用户验收。