refactor: 收口玩过作品打开意图

docs/README.md

@@ -51,6 +51,8 @@ AI 文字游戏模板接入以 [AI_NATIVE_TEXT_GAME_TEMPLATE_MOKU_REFERENCE_PRD_
 
 平台入口公开码搜索的用户 ID、陶泥号、RPG 作品号、各玩法作品号前缀和失败回退顺序收口到 `src/components/platform-entry/platformPublicCodeSearchModel.ts`，壳层只按计划执行网络读取、详情打开和错误归航副作用，规则见 [【前端架构】PlatformPublicCodeSearchModel收口计划-2026-06-04.md](./technical/【前端架构】PlatformPublicCodeSearchModel收口计划-2026-06-04.md)。
 
+个人“玩过作品”面板的玩法别名、`worldKey` 前缀兜底、RPG 公开详情 payload 和大鱼吃小鱼 gallery miss fallback 收口到 `src/components/platform-entry/platformPlayedWorkOpenModel.ts`，壳层只执行面板关闭、gallery 读取、详情打开和错误提示副作用，规则见 [【前端架构】PlatformPlayedWorkOpenModel收口计划-2026-06-04.md](./technical/【前端架构】PlatformPlayedWorkOpenModel收口计划-2026-06-04.md)。
+
 平台入口创作生成通知、pending 作品架占位、失败覆盖、拼图稳定 ID 和草稿 Tab 未读点收口到 `src/components/platform-entry/platformDraftGenerationShelfModel.ts`，规则见 [【前端架构】DraftGenerationShelfModel收口计划-2026-06-03.md](./technical/%E3%80%90%E5%89%8D%E7%AB%AF%E6%9E%B6%E6%9E%84%E3%80%91DraftGenerationShelfModel%E6%94%B6%E5%8F%A3%E8%AE%A1%E5%88%92-2026-06-03.md)。
 
 平台入口创作恢复 URL 私有 query、初始恢复判定、创作直达恢复目标解析、恢复目标身份匹配、跳一跳 / 敲木鱼恢复阶段落点、拼图 runtime query 与拼图稳定身份互推收口到 `src/components/platform-entry/platformCreationUrlStateModel.ts` 和 `src/components/platform-entry/platformPuzzleIdentityModel.ts`，规则见 [【前端架构】CreationUrlStateModel收口计划-2026-06-03.md](./technical/【前端架构】CreationUrlStateModel收口计划-2026-06-03.md)。

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

@@ -0,0 +1,39 @@
+# 【前端架构】Platform Played Work Open Model 收口计划
+
+## 背景
+
+`PlatformEntryFlowShellImpl.tsx` 的个人“玩过作品”点击回调曾在壳层内直接判断 `worldType`、`worldKey` 前缀、玩法别名、目标 ID 兜底、RPG 公开详情 payload 和大鱼吃小鱼 gallery miss fallback。壳层因此同时承载纯打开意图与异步副作用，后续新增玩法或修正玩过作品身份时缺少稳定测试面。
+
+个人“玩过作品”的点击规则属于打开意图。壳层应只关闭面板、读取 gallery、打开详情和写错误；玩法别名、目标 ID、fallback payload 应收口到纯 **Module**。
+
+## 决策
+
+新增 `src/components/platform-entry/platformPlayedWorkOpenModel.ts` 作为 Platform Played Work Open **Module**。其公开 **Interface** 为：
+
+- `resolvePlatformPlayedWorkOpenIntent(work)`：输入 `ProfilePlayedWorkSummary`，输出 `noop`、各玩法公开详情打开意图、`open-big-fish` 或 `open-rpg`。
+- `PlatformPlayedWorkOpenIntent`：描述壳层可执行的打开动作；大鱼吃小鱼意图包含 `sessionId` 和 gallery miss 时使用的 `fallbackWork`，RPG 意图包含 `CustomWorldGalleryCard` 详情 payload。
+
+`PlatformEntryFlowShellImpl.tsx` 仍作为 **Adapter**：它保留 `setIsProfilePlayStatsOpen(false)`、各玩法 `open*PublicWorkDetail`、`refreshBigFishGallery()`、大鱼 gallery 命中优先逻辑、`mapBigFishWorkToPublicWorkDetail(...)` 与错误 setter。
+
+## Interface 约束
+
+- `worldType` 只做小写归一，不 trim；`worldKey` 前缀匹配保持大小写敏感，延续旧行为。
+- `profileId` 使用 nullish 优先级：只在 `profileId` 为 `null` / `undefined` 时从 `worldKey` 前缀兜底；空字符串仍视为缺目标并返回 `noop`。
+- `puzzle` 打开时固定携带 `{ tab: 'profile' }`。
+- `match3d` / `match_3d`、`square-hole` / `square_hole`、`jump-hop` / `jump_hop`、`wooden-fish` / `wooden_fish`、`big-fish` / `big_fish` 均保持既有别名。
+- `big-fish` 缺 gallery 命中时使用 Module 生成的 `fallbackWork`，默认 `ownerUserId` 为空串、`authorDisplayName` 为 `worldSubtitle || '玩家'`、关卡和素材 ready 计数为 `0` / `false`。
+- 未识别的 `worldType` 仍按 RPG 公开详情打开；缺 `ownerUserId` 或缺 profile 目标时返回 `noop`。
+
+## Depth / Leverage / Locality
+
+- **Depth**：调用方只消费一个打开 intent；玩法别名、目标 ID 兜底和 fallback payload 藏入 Module Implementation。
+- **Leverage**：新增“玩过作品”玩法时，先在 intent union、resolver 与单测中定义，再让壳层 Adapter 绑定对应打开副作用。
+- **Locality**：RPG fallback payload 与大鱼 fallback work 不再散落在大型壳层里，维护者可在纯测试中锁定字段契约。
+
+## 验收
+
+- `npm run test -- src/components/platform-entry/platformPlayedWorkOpenModel.test.ts`
+- `npx eslint src/components/platform-entry/platformPlayedWorkOpenModel.ts src/components/platform-entry/platformPlayedWorkOpenModel.test.ts src/components/platform-entry/PlatformEntryFlowShellImpl.tsx --quiet`
+- `npm run test -- src/components/rpg-entry/RpgEntryFlowShell.agent.interaction.test.tsx -t "authenticated users can open save archives from the profile played panel"`
+- `npm run typecheck`
+- `npm run check:encoding`

docs/【玩法创作】平台入口与玩法链路-2026-05-15.md

@@ -59,6 +59,8 @@
 
 平台公开搜索的分流顺序统一由 `platformPublicCodeSearchModel.ts` 判定：`user_` / `user-` 内部用户 ID 只查用户 ID；`PZ`、`BF`、`JH`、`WF`、`BO`、`M3`、`SH`、`VN`、`BB` 前缀分别直达对应玩法公开作品；`CW` 与 1-8 位纯数字先查 RPG 公开作品再回退陶泥号；普通关键词和 `SY` 陶泥号保持先查陶泥号、再查 RPG 作品、再查汪汪声浪作品、最后陶泥号兜底的既有顺序。平台壳只按计划执行网络读取、详情打开、Bark Battle runtime 特例和缺失作品归航，不在壳层重复维护前缀布尔链。
 
+个人“玩过作品”面板点击作品时，玩法别名、`worldKey` 前缀兜底、RPG 公开详情 payload 和大鱼吃小鱼缺 gallery 命中时的 fallback work 统一由 `platformPlayedWorkOpenModel.ts` 判定。平台壳只负责关闭面板、调用对应公开详情打开函数、刷新大鱼 gallery、优先使用真实 gallery 命中项和写入错误提示；不要在壳层重新维护 `worldType` / `worldKey` 分支链。
+
 发现 Tab、创作 Tab 与草稿 Tab 的页面根内容区不再套 `platform-page-stage` 外层全局卡片壳，让列表、筛选和玩法卡获得更宽的横向空间；推荐页和我的页仍按各自页面设计保留原有全局卡片口径。移动端“我的”页仍按顶部头像 / 昵称 / 陶泥号、会员横幅、三张统计卡、每日任务、五项常用功能宫格、设置入口和法律信息组织，不保留旧的底部“填邀请码”次级入口；常用功能当前只展示四项常驻入口时必须按四列铺满整行，不保留五列网格导致左对齐空位；每日任务卡必须读取 `/api/profile/tasks` 的当前任务摘要并在领取后同步刷新卡片进度。字号必须维持平台普通 UI 档位，不能因为窄屏把卡片标题、功能 label 或法律信息撑成展示级字号；最后一屏内容必须能在底部 dock 上方完整滚动露出，不得被固定底部导航遮挡。
 
 ## RPG / 自定义世界