1

docs/design/PLATFORM_HOME_MOBILE_FEED_CARD_REDESIGN_2026-04-28.md

@@ -28,6 +28,24 @@ likeCount: number
 3. 大鱼公开广场：`BigFishWorkSummary` 返回 `likeCount`，当前由 Rust facade 返回 `0`，`playCount` 继续仅表示游玩次数。
 4. 前端聚合类型 `PlatformPublicGalleryCard` 透传 `likeCount`，`WorldCard` 不再依赖 `badge/metaLabel` 决定主要信息结构。
 
+### 2.3 首页读链路核对
+
+首页公开作品流的读取链路固定为：
+
+```text
+RpgEntryHomeView
+→ platformPublicGalleryClient / puzzleGalleryClient / bigFishGalleryClient
+→ Rust api-server
+→ spacetime-client 生成绑定
+→ spacetime-module procedure
+→ SpacetimeDB 表
+```
+
+1. 公开读取必须匿名可用，前端 `GET` 列表与详情统一传 `skipAuth: true`、`skipRefresh: true`，避免未登录首页被刷新 token 链路阻断。
+2. 拼图公开广场走 `list_puzzle_gallery` / `get_puzzle_gallery_detail`，返回 `coverImageSrc`、`summary`、`themeTags`、`playCount`、`remixCount`、`likeCount`。
+3. 大鱼公开广场走 `list_big_fish_works(published_only=true)`；由于部分已部署模块会在公开列表分支前仍校验 `owner_user_id` 非空，客户端与模块内部公共列表输入都使用 `public-big-fish-gallery` 占位 owner。该字段在 `published_only` 分支不参与筛选，只用于兼容旧校验。
+4. 自定义世界公开广场走 `list_custom_world_gallery_entries`，当前主云数据为空时应返回成功空列表，而不是错误态。
+
 ## 3. 移动端布局
 
 1. 移动端首页只在 `RpgEntryHomeView` 的 mobile content 内重排。
@@ -57,3 +75,7 @@ likeCount: number
 2. 桌面端首页布局区块顺序不变，只替换公开作品卡内部结构。
 3. RPG、拼图、大鱼三类公开作品卡都有 `likeCount` 字段，前端聚合后能统一展示。
 4. 运行编码检查、前端定向测试和必要的 Rust 检查。
+5. HTTP 验收需覆盖：
+   - `GET /api/runtime/custom-world-gallery` 成功返回 `entries`。
+   - `GET /api/runtime/puzzle/gallery` 成功返回 `items` 且包含 `likeCount`。
+   - `GET /api/runtime/big-fish/gallery` 成功返回 `items`，旧部署模块不再因 `big_fish.owner_user_id 不能为空` 阻断首页。