1

docs/design/PLATFORM_HOME_MOBILE_FEED_CARD_REDESIGN_2026-04-28.md

@@ -6,7 +6,7 @@
 
 1. 桌面端首页布局保持现有顶部栏、侧边导航、Hero、趋势区与下方网格结构，不调整桌面端区块顺序。
 2. 移动端首页改为参考图式信息流：顶部搜索框、横向频道 Tab、纵向作品列表、底部主导航。
-3. 双端公开作品卡统一结构：上方 `16:9` 封面图，下方作品名称、作品描述、标签、点赞数。
+3. 双端公开作品卡统一结构：上方 `16:9` 封面图，下方作品名称、作者信息、作品描述与玩法类型。
 4. 点赞数必须来自作品读模型字段，前端只负责展示，不把游玩数或评分临时改名成点赞。
 
 ## 2. 数据契约
@@ -16,7 +16,7 @@
 公开作品卡和创作中心复用的作品摘要都增加：
 
 ```ts
-likeCount: number
+likeCount: number;
 ```
 
 当前阶段只做只读展示，不新增点赞按钮和点击 reducer。后端对尚未接入真实点赞表的作品返回 `0`，保证接口 shape 稳定，后续可无 UI 结构迁移地接入真实互动计数。
@@ -62,12 +62,15 @@ RpgEntryHomeView
 每张公开作品卡固定为：
 
 1. 封面区域：`aspect-ratio: 16 / 9`，图片 `object-cover`；无封面时使用轻量主题底。
-2. 信息区域：
-   - 第一行：作品名称，右侧点赞数。
-   - 第二行：作品描述，两行截断。
-   - 第三行：最多三个标签。
-3. 点赞数展示在参考图评分位置，使用心形图标 + 紧凑数字，例如 `128`、`1.2万`。
-4. 不展示作品号；作品号仍只在详情页或分享路径中使用。
+2. 封面左上角不展示“推荐”标签，也不展示作者昵称标签，避免遮挡作品主视觉。
+3. 封面右下角展示三项轻量指标：游玩、改造、点赞；统一为图标 + 紧凑数字，例如 `128`、`1.2万`，不写额外说明长文案。
+4. 信息区域：
+   - 第一行：作品名称，右侧展示玩法类型。拼图玩法展示“拼图”，大鱼玩法展示“大鱼”，RPG 作品展示题材短标签。
+   - 第二行：原副标题位置展示作者头像和昵称。当前公开列表只返回作者昵称时，头像使用昵称首字生成的轻量头像；后续接入作者头像 URL 后复用同一位置。
+   - 第三行：作品描述，两行截断。
+   - 第四行：最多三个标签。
+5. 点赞数仍必须来自作品读模型字段，只是展示位置从信息区右侧迁移到封面右下角。
+6. 不展示作品号；作品号仍只在详情页或分享路径中使用。
 
 ## 5. 验收
 

docs/design/PLATFORM_WORK_DETAIL_AND_REMIX_DESIGN_2026-04-28.md

@@ -5,7 +5,7 @@
 ## 1. 本次目标
 
 1. 平台首页、公开广场、分类列表中的每个公开作品点击后，统一先进入作品详情页，不再直接启动玩法。
-2. 作品详情页结构参考 TapTap 详情页：顶部封面图、作品基础信息、右侧“作品改造”按钮、四项统计、简介内容、底部启动按钮。
+2. 作品详情页结构参考 TapTap 详情页：顶部封面图、作品基础信息、右侧“点赞”按钮、四项统计、简介内容、底部“作品改造 + 启动”同行动作。
 3. 删除参考图顶部 Tab，不接入评价和论坛功能，不展示“开发者的话”模块。
 4. 统计数据必须从数据库读模型贯穿到前端展示，禁止在前端用假字段、游玩数冒充点赞数或固定文案代替真实字段。
 5. Remix 按钮必须由后端事务复制公开作品为当前用户草稿，并同步增加原作品改造次数，成功后前端进入新草稿详情/结果页。
@@ -19,15 +19,15 @@
 3. 基础信息区：
    - 左侧作品图标使用作品封面或首图。
    - 中间展示作品名、作者头像、作者名、玩法类型；作者头像读取公开用户资料 `avatarUrl`，缺失时使用作者昵称首字占位。
-   - 右侧原 TapTap 评分位置替换为 `作品改造` 按钮。
+   - 右侧原 TapTap 评分位置替换为 `点赞` 按钮；点击后调用后端点赞接口，由后端记录当前登录用户对该公开作品的点赞关系并返回更新后的真实 `likeCount` 读模型，前端不伪造点赞增长。
 4. 统计区固定四项：
-   - 改造：`remixCount`，显示为“数字 + 次”，单位放在数字后方。
    - 游玩：`playCount`，显示为“数字 + 次”，单位放在数字后方。
+   - 改造：`remixCount`，显示为“数字 + 次”，单位放在数字后方。
    - 点赞：`likeCount`，显示为“数字 + 赞”，单位放在数字后方。
-   - 最近更新：优先展示 `updatedAt`，缺失时回退 `publishedAt`；前端只负责格式化显示，必须兼容后端当前 `seconds.microsZ` 与 ISO 字符串两种真实时间文本，显示为完整 `YYYY-MM-DD`，使用更小字号并保持单行不换行。
+   - 日期：优先展示 `updatedAt`，缺失时回退 `publishedAt`；前端只负责格式化显示，必须兼容后端当前 `seconds.microsZ` 与 ISO 字符串两种真实时间文本，显示为完整 `YYYY-MM-DD`，使用更小字号并保持单行不换行。
    - 四项统计需要使用浅色图标底强化识别，但不得追加规则说明类文案。
 5. 简介区：展示玩法标签和作品简介；不追加说明类文案。
-6. 底部动作：主按钮为“启动”，点击后进入对应玩法运行态并记录游玩次数。
+6. 底部动作：左侧按钮为“作品改造”，右侧主按钮为“启动”；两个按钮必须位于同一行，点击“启动”后进入对应玩法运行态并记录游玩次数。
 7. 页面配色必须跟随平台明暗主题变量；亮色主题使用平台浅色底、深色文字和主按钮渐变，暗色主题使用平台暗色底、亮色文字和对应主按钮渐变，不在详情页写死独立黑色皮肤。
 8. 字号规范跟随平台页面既有节奏：标题/主按钮使用 `1rem` 级别，作品名使用卡片标题同级 `1rem`，辅助信息与简介使用 `0.8125rem` / `0.875rem`，标签与统计标签使用 `0.75rem`，避免在详情页使用随视口放大的独立大字号。
 
@@ -38,7 +38,8 @@
 1. `custom_world_profile` 增加 `play_count`、`remix_count`、`like_count`。
 2. `custom_world_gallery_entry` 同步这三项统计，作为公开详情和首页卡片读模型。
 3. `record_custom_world_profile_play` 负责在公开作品启动前递增 `play_count`，只更新已发布且未删除作品。
-4. `remix_custom_world_profile` 在同一事务内：
+4. `record_custom_world_profile_like` 负责记录当前用户对公开作品的点赞；同一用户对同一公开作品只计入一次，首次点赞时递增 `like_count` 并同步刷新 `custom_world_gallery_entry`。
+5. `remix_custom_world_profile` 在同一事务内：
    - 校验源作品已发布、未删除。
    - 递增源作品 `remix_count` 并刷新源作品 gallery。
    - 复制源 profile payload 为当前用户草稿，清空公开编号、发布时间与统计。
@@ -48,7 +49,8 @@
 
 1. `puzzle_work_profile` 保留既有 `play_count`，新增 `remix_count`、`like_count`。
 2. `start_puzzle_run` 继续作为游玩次数递增入口。
-3. `remix_puzzle_work` 在同一事务内：
+3. `record_puzzle_work_like` 负责记录当前用户对公开拼图作品的点赞；同一用户对同一公开作品只计入一次，首次点赞时递增 `like_count`。
+4. `remix_puzzle_work` 在同一事务内：
    - 校验源 profile 为已发布作品。
    - 递增源作品 `remix_count`。
    - 新建当前用户拼图 Agent session，并把源作品锚点、封面、简介复制为草稿。
@@ -60,7 +62,8 @@
 1. `big_fish_creation_session` 现有 `play_count` 继续作为游玩统计，新增 `remix_count`、`like_count`、`published_at`。
 2. `publish_big_fish_game` 写入 `published_at` 与 `updated_at`，公开列表和详情优先用 `updated_at` 展示最近更新。
 3. `record_big_fish_play` 继续作为游玩次数递增入口。
-4. `remix_big_fish_work` 在同一事务内：
+4. `record_big_fish_like` 负责记录当前用户对公开大鱼作品的点赞；同一用户对同一公开作品只计入一次，首次点赞时递增 `like_count`。
+5. `remix_big_fish_work` 在同一事务内：
    - 校验源 session 为已发布作品。
    - 递增源作品 `remix_count`。
    - 新建当前用户创作 session，复制锚点、草稿和资源槽，阶段回到可编辑草稿态。
@@ -74,14 +77,19 @@
    - RPG：`POST /api/runtime/custom-world-gallery/{owner_user_id}/{profile_id}/remix`
    - 拼图：`POST /api/runtime/puzzle/gallery/{profile_id}/remix`
    - 大鱼：`POST /api/runtime/big-fish/gallery/{session_id}/remix`
-3. 前端统一详情页只消费读模型字段，不自行派生统计。
-4. 首页卡片点击只设置统一详情状态；启动与 Remix 只能在详情页触发。
-5. Remix 成功后的跳转：
+3. 点赞 API：
+   - RPG：`POST /api/runtime/custom-world-gallery/{owner_user_id}/{profile_id}/like`
+   - 拼图：`POST /api/runtime/puzzle/gallery/{profile_id}/like`
+   - 大鱼：`POST /api/runtime/big-fish/gallery/{session_id}/like`
+   - 三个接口都必须走登录态鉴权，后端使用当前登录用户身份写入点赞关系；重复点击返回当前最新读模型，不重复增加 `likeCount`。
+4. 前端统一详情页只消费读模型字段，不自行派生统计。
+5. 首页卡片点击只设置统一详情状态；启动、点赞与 Remix 只能在详情页触发。
+6. Remix 成功后的跳转：
    - RPG：进入复制出的草稿详情。
    - 拼图：进入复制出的拼图结果页草稿。
    - 大鱼：进入复制出的大鱼结果页草稿。
-6. 拼图作品详情页启动时复用当前详情页已经展示的公开作品读模型，直接调用 `POST /api/runtime/puzzle/runs` 记录游玩并进入运行态；不得在启动前额外依赖 `GET /api/runtime/puzzle/gallery/{profile_id}`，避免开发代理或详情读取短断点阻塞启动链路。
-7. 本地开发时 `localhost:3000` 是 Vite 前端端口，`/api/**` 默认代理到 Rust `api-server:3100`；若 3100 未监听，点击启动或作品改造会在浏览器显示 `/api/... 500`，此时真实断点是 Rust 后端未启动，不允许用前端假数据替代后端事务。
+7. 拼图作品详情页启动时复用当前详情页已经展示的公开作品读模型，直接调用 `POST /api/runtime/puzzle/runs` 记录游玩并进入运行态；不得在启动前额外依赖 `GET /api/runtime/puzzle/gallery/{profile_id}`，避免开发代理或详情读取短断点阻塞启动链路。
+8. 本地开发时 `localhost:3000` 是 Vite 前端端口，`/api/**` 默认代理到 Rust `api-server:3100`；若 3100 未监听，点击启动、点赞或作品改造会在浏览器显示 `/api/... 500`，此时真实断点是 Rust 后端未启动，不允许用前端假数据替代后端事务。
 
 ## 5. 验收点
 
@@ -89,5 +97,6 @@
 2. 详情页无评价、论坛 Tab，无开发者的话模块。
 3. 四项统计在前端、共享契约、API facade、SpacetimeDB 表之间字段一致。
 4. Remix 后原作品改造次数增加，新草稿归当前用户所有，且不会继承源作品统计。
-5. 启动公开作品会走对应后端记录入口，刷新后仍能看到递增后的游玩次数。
-6. 修改后运行编码检查、SpacetimeDB 绑定生成、Rust 检查和必要前端测试。
+5. 点赞公开作品会走对应后端记录入口，首次点赞后刷新仍能看到递增后的点赞次数，重复点赞不会继续增加。
+6. 启动公开作品会走对应后端记录入口，刷新后仍能看到递增后的游玩次数。
+7. 修改后运行编码检查、SpacetimeDB 绑定生成、Rust 检查和必要前端测试。