refactor: 收口推荐流展示模型

docs/README.md

@@ -47,6 +47,8 @@ AI 文字游戏模板接入以 [AI_NATIVE_TEXT_GAME_TEMPLATE_MOKU_REFERENCE_PRD_
 
 公开作品分类、搜索、跨来源去重、今日筛选、排行排序和时间戳解析收口到 `src/components/rpg-entry/rpgEntryPublicGalleryViewModel.ts`，规则见 [【前端架构】PublicGalleryViewModel收口计划-2026-06-03.md](./technical/%E3%80%90%E5%89%8D%E7%AB%AF%E6%9E%B6%E6%9E%84%E3%80%91PublicGalleryViewModel%E6%94%B6%E5%8F%A3%E8%AE%A1%E5%88%92-2026-06-03.md)。
 
+推荐 feed 的公开作品去重、普通内容过滤、active 窗口与上一条 / 下一条回环选择也收口到 `src/components/rpg-entry/rpgEntryPublicGalleryViewModel.ts`，规则见 [【前端架构】RecommendFeedViewModel收口计划-2026-06-03.md](./technical/%E3%80%90%E5%89%8D%E7%AB%AF%E6%9E%B6%E6%9E%84%E3%80%91RecommendFeedViewModel%E6%94%B6%E5%8F%A3%E8%AE%A1%E5%88%92-2026-06-03.md)。
+
 每日任务卡片与任务中心弹窗的任务选择、进度、状态标签和按钮文案收口到 `src/components/rpg-entry/rpgEntryProfileTaskViewModel.ts`，规则见 [【前端架构】ProfileTaskViewModel收口计划-2026-06-03.md](./technical/%E3%80%90%E5%89%8D%E7%AB%AF%E6%9E%B6%E6%9E%84%E3%80%91ProfileTaskViewModel%E6%94%B6%E5%8F%A3%E8%AE%A1%E5%88%92-2026-06-03.md)。
 
 个人数据卡、钱包 chip 与“玩过”弹窗的计数、时长、作品类型和作品号展示收口到 `src/components/rpg-entry/rpgEntryProfileDashboardPresentation.ts`，规则见 [【前端架构】ProfileDashboardPresentation收口计划-2026-06-03.md](./technical/%E3%80%90%E5%89%8D%E7%AB%AF%E6%9E%B6%E6%9E%84%E3%80%91ProfileDashboardPresentation%E6%94%B6%E5%8F%A3%E8%AE%A1%E5%88%92-2026-06-03.md)。

docs/technical/【前端架构】RecommendFeedViewModel收口计划-2026-06-03.md

@@ -0,0 +1,31 @@
+# 【前端架构】Recommend Feed ViewModel 收口计划
+
+## 背景
+
+平台首页推荐 feed、发现页推荐频道、桌面推荐格和正式 runtime 的上一条 / 下一条选择共用一批展示规则：公开作品跨来源去重、过滤寓教于乐隐藏内容、按精选优先再最新兜底、active key 失效时回到首项、前后相邻条目回环且单条目不自循环。原先这些规则分别散在 `RpgEntryHomeView.tsx` 与 `PlatformEntryFlowShellImpl.tsx` 的 **Implementation** 内，导致推荐预览与正式 runtime 之间存在口径漂移风险。
+
+## 决策
+
+在 `src/components/rpg-entry/rpgEntryPublicGalleryViewModel.ts` 追加推荐 feed **Interface**：
+
+- `dedupePlatformPublicGalleryEntries(entries)`：统一公开作品按 `buildPublicGalleryCardKey` 去重，后出现来源覆盖旧值。
+- `buildPlatformRecommendFeedEntries(featuredEntries, latestEntries)`：统一推荐 feed 的精选 + 最新合并、隐藏寓教于乐内容与去重顺序。
+- `selectPlatformRecommendFeedWindow(entries, activeEntryKey)`：统一推荐页当前项、上一项、下一项和 active key 失效兜底。
+- `selectAdjacentPlatformRecommendEntry(entries, direction, baseEntryKey)`：统一正式 runtime 上一条 / 下一条回环选择，并避免单作品自循环。
+
+`RpgEntryHomeView.tsx` 不再自建 `Map` 或手写取模；`PlatformEntryFlowShellImpl.tsx` 的 runtime 推荐条目也改用同一 **Module**。推荐 feed 的 **Locality** 回到 PublicGallery ViewModel，页面与 runtime 只保留 UI、动画和启动副作用。
+
+## 约定
+
+- 推荐 feed 仍只展示普通公开作品；寓教于乐内容由独立频道控制，不进入推荐 runtime 队列。
+- 去重保留既有“后出现来源覆盖旧值、插入位置不变”的行为。
+- active key 缺失或失效时，展示窗口回到首个推荐作品；单个作品没有上一条 / 下一条预览。
+
+## 验证
+
+- `npm run test -- src/components/rpg-entry/rpgEntryPublicGalleryViewModel.test.ts`
+- `npm run test -- src/components/rpg-entry/RpgEntryHomeView.recharge.test.tsx -t "recommend|edutainment"`
+- `npm run test -- src/components/rpg-entry/RpgEntryFlowShell.agent.interaction.test.tsx -t "logged out home recommendation next starts the next puzzle work"`
+- 针对变更文件执行 ESLint
+- `npm run typecheck`
+- `npm run check:encoding`